结汇收款人需人工审核，但不做单独审核，会再提交结汇付款申请后同交易一起审核并异步通知，所以此接口新增成功就可以在结汇付款申请接口中使用
请求URL
POST {域名}/api/agent/payee/addPayee
请求参数
👉说明：
- 请求参数详见：请求报文
加密数据dataContent
| 序号 | 域名 | 变量名 | 必填 | 长度 | 备注 |
|---|---|---|---|---|---|
| 01. | 用户编号 | userNo | M | Long | GEP分配的用户号 |
| 02. | 收款人类型 | partnerType | M | Number | 合作收款人类型 2-本企业 5-第三方个人 6-第三方企业 |
| 03. | 干系人类型 | nameType | C | String | 当收款人类型为本企业时，必填，选择的干系人类型 1-本企业 2-本企业的法人 3-本企业的受益人 |
| 04. | 收款人名称 | name | M | String(64) | 结汇出款到银行账户或卡号的名称 |
| 05. | 组织机构号 | orgCode | C | String(16) | 当收款人类型为第三方企业时，必填 |
| 06. | 行业属性 | industryId | C | String(4) | 当收款人类型为第三方企业时，必填 详见附件 |
| 07. | 经济属性 | economyId | C | String(4) | 当收款人类型为第三方企业时，必填 详见附件 |
| 08. | 经济特区 | taxfreeCode | C | String(2) | 当收款人类型为第三方企业时，是特殊经济区必填 详见附件 |
| 09. | 联系人 | linkMan | C | String(20) | 当收款人类型为第三方企业时，必填 企业联系人 |
| 10. | 联系人电话 | linkMobile | C | String(15) | 当收款人类型为第三方企业时，必填 |
| 11. | 邮编 | postCode | C | String(6) | 当收款人类型为第三方企业时，必填 企业所在地 |
| 12. | 法人名称 | legalName | C | String(20) | 当收款人类型为第三方企业时，必填 企业的法人 |
| 13. | 证件号码 | legalIdNo | C | String(20) | 当收款人类型为第三方个人、第三方企业时，必填 第三方个人时为收款人的身份证证件号码 第三方企业时为法人的身份证证件号码 |
| 14. | 省份代码 | province | C | String(30) | 当收款人类型为第三方企业时，必填 企业经营场所所在省份 格式必须是code_name 如：210000_辽宁省 省市区编码详见附件 |
| 15. | 城市代码 | city | C | String(30) | 当收款人类型为第三方企业时，必填 企业经营场所所在城市 格式必须是code_name 如：210200_大连市 省市区编码详见附件 |
| 16. | 区县代码 | area | C | String(30) | 当收款人类型为第三方企业时，必填 企业经营场所所在区县 格式必须是code_name 如：210202_中山区 省市区编码详见附件 |
| 17. | 详细地址 | address | C | String(100) | 当收款人类型为第三方企业时，必填 企业经营场所详细地址 |
| 18. | 银行名称 | bankName | M | String(64) | 结汇出款到账的银行名称 |
| 19. | 账号或卡号 | cardNo | M | String(20) | 结汇出款到账的境内银行账号（对公）或卡号（对私） |
| 20. | 支行名称 | bankBranchName | M | String(80) | 收款人开户行的支行名称 |
| 21. | 省份代码 | bankProvince | M | String(30) | 收款人开户行的省份，格式必须是code_name 如：210000_辽宁省 省市区编码详见附件 |
| 22. | 城市代码 | bankCity | M | String(30) | 收款人 开户行的城市，格式必须是code_name 如：210200_大连市 省市区编码详见附件 |
| 23. | 开户行地址 | bankAddress | M | String(100) | 收款人开户行的详细地址 |
| 24. | 银行名称 | bankNameOfLegal | C | String(20) | 当收款人类型为第三方企业时，此参数是添加法人到账银行名称 可为空 |
| 25. | 银行卡号 | cardNoOfLegal | C | String(20) | 当收款人类型为第三方企业时，此参数是添加法人境内到账银行卡号 可为空 |
| 26. | 省份代码 | bankLegalProvince | C | String(30) | 当收款人类型为第三方企业时，如果法人到账银行名称不为空 此参数必填 开户行的省份，格式必须是code_name 如：210000_辽宁省 省市区编码详见附件 |
| 27. | 城市代码 | bankLegalCity | C | String(30) | 当收款人类型为第三方企业时，如果法人到账银行名称不为空 此参数必填 开户行的城市，格式必须是code_name 如：210200_大连市 省市区编码详见附件 |
| 28. | 证明文件id | accountDocument | C | Long | 当收款人类型为第三方企业、第三方个人时，必填 上传文件接口返回的id（上传文件接口的fileType：B2B_OPEN_ACC_FILE） |
| 29. | 回调地址 | callBackUrl | O | String(100) | 处理结果回调地址,回调参数见结汇收款人结果通知 |
| 30. | 请求单号 | userReqNo | O | String(32) | 用户请求单号 如为空 则GEP自动赋值UUID |
dataContent示例
{
"bankAddress": "浦东",
"bankBranchName": "张江支行",
"bankCity": "310115_浦东新区",
"bankName": "工商银行",
"bankProvince": "310000_上海市",
"callBackUrl": "http://10.0.60.55:8083/GepDemoJava/notify/agent",
"cardNo": "1688888",
"name": "全球有限互联公司",
"nameType": "1",
"partnerType": 2,
"userNo": "5181240322000274308",
"userReqNo": "202409230919533792883741"
}响应参数
👉说明：
- 响应参数详见：响应报文
结果信息result
| 序号 | 域名 | 变量名 | 必填 | 长度 | 备注 |
|---|---|---|---|---|---|
| 01. | 收款人编号 | partnerNo | M | Long | GEP生成的唯一编号 |
| 02. | 银行账户编号 | recordNo | C | String | 收款人银行账户编号 |
result示例
{
"partnerNo": 2407151124000033545,
"recordNo": 2407151124000044555
}