修改接口接收参数

src/main/java/com/lyxh/api/docking/model/ftapi/PaymentProfileRequest.java

@@ -1,5 +1,6 @@
 package com.lyxh.api.docking.model.ftapi;
 
+import com.fasterxml.jackson.annotation.JsonProperty;
 import jakarta.validation.constraints.NotBlank;
 import lombok.Data;
 
@@ -11,7 +12,8 @@ public class PaymentProfileRequest {
     private String name;
 
     /** 身份证号（支持明文，密文） */
-    @NotBlank(message = "idCard is required")
+    @JsonProperty("id_card")
+    @NotBlank(message = "id_card is required")
     private String idCard;
 
     /** 国标+手机号（支持明文，密文） */
@@ -19,5 +21,6 @@ public class PaymentProfileRequest {
     private String mobile;
 
     /** 身份证号和手机号的加密算法 */
+    @JsonProperty("encrypt_algo")
     private String encryptAlgo;
 }

对接接口文档.md

@@ -28,32 +28,32 @@
 | 字段 | 类型 | 必填 | 说明 |
 |---|---|---|---|
 | name | String | Y | 用户姓名 |
-| idCard | String | Y | 身份证号，支持明文或 MD5 密文 |
+| id_card | String | Y | 身份证号，支持明文或 MD5 密文 |
 | mobile | String | Y | 手机号（带国家码），支持明文或 MD5 密文 |
-| encryptAlgo | String | N | 加密算法。**不传**表示明文，服务端原样透传给三方；传入 `MD5` 表示已加密，直接透传 |
+| encrypt_algo | String | N | 加密算法。**不传**表示明文，服务端原样透传给三方；传入 `MD5` 表示已加密，直接透传 |
 
 ### 请求示例
 
 ```json
 {
   "name": "ABCXYZ",
-  "idCard": "3201190108990002",
+  "id_card": "3201190108990002",
   "mobile": "6285887456612"
 }
 ```
 
-> idCard、mobile 传明文时无需传 encryptAlgo，服务端原样透传给三方。
+> id_card、mobile 传明文时无需传 encrypt_algo，服务端原样透传给三方。
 
 ```json
 {
   "name": "ABCXYZ",
-  "idCard": "cf0ab15098ab149e5273dd82f2c737e6",
+  "id_card": "cf0ab15098ab149e5273dd82f2c737e6",
   "mobile": "bd82af6340240c43175a80aedf7e6eef",
-  "encryptAlgo": "MD5"
+  "encrypt_algo": "MD5"
 }
 ```
 
-> idCard、mobile 传密文时必须传 encryptAlgo="MD5"。
+> id_card、mobile 传密文时必须传 encrypt_algo="MD5"。
 
 ## 响应体
 
@@ -131,7 +131,7 @@ curl -X POST http://{host}:{port}/api/v1/fortispay/payment-feature \
   -H "X-Language: en" \
   -d '{
     "name": "ABCXYZ",
-    "idCard": "3201190108990002",
+    "id_card": "3201190108990002",
     "mobile": "6285887456612"
   }'
 ```