diff --git a/src/main/java/com/lyxh/api/docking/model/ftapi/PaymentProfileRequest.java b/src/main/java/com/lyxh/api/docking/model/ftapi/PaymentProfileRequest.java index 1b09811..d96707c 100644 --- a/src/main/java/com/lyxh/api/docking/model/ftapi/PaymentProfileRequest.java +++ b/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; } diff --git a/对接接口文档.md b/对接接口文档.md index 838746b..50060d5 100644 --- a/对接接口文档.md +++ b/对接接口文档.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" }' ```