请求URL

POST {域名}/api/user/pobo/addPoboPayee

请求参数

加密数据dataContent

序号 域名 变量名 必填 长度 备注
01. 商户号 userNo M Long GEP提供给商户的唯一编号
02. 付款人类型 payerType M Number 1-个人，2-境内企业，3-非境内企业
03. 付款人姓名 payerName M String(125)
04. 付款人英文名 payerEnName C String(125) 付款人类型是个人无需填写，其他必填
05. 付款人国家 payerCountry M String(3) 填三位国家编码 默认CHN
06. 付款人证件类型 payerIdType M Integer 1-身份证，4-营业执照，5-企业注册号
07. 付款人证件号码 payerIdNo M String(128) 根据证件类型（payerIdType）填写
08. 证件签发日期 idExpirationBegin O String 格式 YYYY-dd-mm 2023-04-16
09. 证件有效期 idExpiration C String(20) 格式 YYYY-dd-mm 2023-04-16,付款人是个人必填，企业不需要
10. 付款人地址 payerAddress M String(255) 付款人地址必填
11. 付款人地址(州) province C String(64) 当付款人国家是 USA 时，必填,参考州列表
如果付款人类型是个人或者企业，则格式填写code_name如110000_北京
非境内企业不限制
12. 付款人城市 city M String(64) 付款人城市必填，如果付款人类型是个人或者企业，则格式填写code_name如110100_北京市，
非境内企业不限制
13. 手机号 phone C String(64) 手机号
付款人为个人的时候，以LOCAL付KRW到韩国必须填写手机号
14. 手机号区号 zoneCode C String(64) 手机号区号，不填默认为86
15. 付款人英文名 firstName C String(64) 付款人是个人，必须填写
16. 付款人英文姓 lastName C String(64) 付款人是个人，必须填写
17. 收款人名称 payeeName O String(128)
18. 收款人地址 payeeAddress O String(255)
19 法人证件号 legalIdNo C String(128) 如果付款人类型是境内企业，必填
20 法人证件名称 legalName C String(128) 如果付款人类型是境内企业，必填
21 董事证件号 managementIdNo C String(128) 如果付款人类型是非境内企业，必填
22 董事名称 managementName C String(128) 如果付款人类型是非境内企业，必填
23 受益人 receiptList O List List对象，对象内容包含:receiptName(受益人名称)、receiptIdNo(受益人证件号)
├─受益人名称 receiptName M String(20) 名称
└─受益人证件号 receiptIdNo M String(20) 证件号
24 附件材料 materialList M list对象(对象里是如下dfsId、materialType、fileName三个参数) 附件材料集合（可见明文示例）
如果付款人类型是个人，材料类型必须传：合作材料
如果付款人类型是境内企业，材料类型必须传：合作材料
如果付款人类型是非境内企业，材料类型必须传：合作材料、股权证明文件(股权证明文件如果是香港非必传，其他国家必传)
├─文件ID dfsId M Long 证件附件ID （调用文件上传接口返回的fileId）
├─材料类型 materialType M Integer 材料类型：1-个人证件正面、2-个人证件反面、3-营业执照、4-法人正面、5-法人反面、9-受益人正面、10-受益人反面、11-董事正面、12-董事反面、13-证明材料、14-合作材料 15-股权证明文件
└─文件名称 fileName O String(10) 文件名称
25 回调地址 callBackUrl O String(120) 处理结果回调地址
26 请求单号 userReqNo O String(32) 用户请求单号 如为空 则GEP自动赋值UUID
27 系统订单号 orderId O Long 如果传值会获取宝付相关数据

dataContent示例

{
  "callBackUrl": "http://10.254.120.19:8080/notify/receiveNotify/6222020918563479052",
  "idExpiration": "2024-04-16",
  "idExpirationBegin": "2024-04-16",
  "materialList": [
    {
      "dfsId": 13249259,
      "fileName": "身份证正面",
      "materialType": 1
    },
    {
      "dfsId": 13249259,
      "fileName": "身份证反面",
      "materialType": 2
    },
    {
      "dfsId": 13249259,
      "fileName": "合作材料",
      "materialType": 14
    }
  ],
  "payeeAddress": "我来自哪里",
  "payeeName": "好的汪",
  "payerAddress": "上海市居里路99",
  "payerCountry": "CHN",
  "payerEnName": "haohao1",
  "payerIdNo": "110101202404153576",
  "payerIdType": 1,
  "payerName": "张大华",
  "payerType": 1,
  "userNo": "5181230731000027228"
}

响应参数

结果信息result

序号 域名 变量名 必填 长度 备注
01. pobo记录编号 poboRecordId M Long GEP生成的唯一编号(对应查询接口的recordId)

result示例

{
  "poboRecordId": 2211101444000021566
}