wangxiu
/
api
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

修改接口接收参数

This commit is contained in:
wangxiu 2026-07-10 22:30:21 +08:00
parent d89bae0bd0
commit 7ffb4366b4
2 changed files with 12 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

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

16
对接接口文档.md
View File

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