3.3.1 平台商户收款人账户报备
接口说明
收款币种（currCode）仅当支付方式（payType）为结汇付款（Fxpay）时才支持CNY，其他情况不支持CNY。
请求URL
请求参数
| 参数名 | 参数描述 | 类型 | 约束 | 说明 |
|---|---|---|---|---|
| payeeId | 收款账户 ID | String(32) | C | |
| subMchNo | 子商户编号 | String(32) | C | 子商户收款人必填 |
| mchSeqNo | 商户请求号 | String(32) | C | 申请时必填 |
| ownAcc | 是否本公司账户 | String(1) | M | Y:本公司N:第三方公司 |
| payeeProp | 收款方属性 | String(1) | M | ownAcc=Y，默认 1 |
| payeeCountryCode | 收款方国家代码 | String(2) | C | ownAcc=N 必填currCode=CNY，默认CN |
| payeeName | 收款方名称 | String(200) | C | ownAcc=N 必填 |
| payeeRegAddress | 收款方注册地址 | String(200) | O | |
| payeeProvince | 收款人省/州 | String(50) | C | payType=SWIFT payeeCountryCode=US或CA时,必填 |
| payeeCity | 收款人城市 | String(50) | C | payType=SWIFT payeeCountryCode=US或CA时,必填 |
| payeePostcode | 收款人邮编 | String(50)) | C | payType=SWIFT payeeCountryCode=US或CA时,必填 |
| nickname | 收款方昵称 | String(200) | O | |
| licenseNo | 营业执照/商业注册证书 | String(50) | C | ownAcc=N，bankAccProp=1，currCode= CNY 必填 |
| legalName | 法人/董事 | String(50) | C | ownAcc=N，bankAccProp=1，currCode= CNY |
| legalIdType | 法人/董事证件类型 | String(1) | C | ownAcc=N，bankAccProp=1，currCode= CNY 0:身份证 |
| legalIdCardNo | 法人/董事证件号码 | String(20) | C | ownAcc=N，bankAccProp=1，currCode= CNY 必填 |
| bankCountryCode | 银行国家代码 | String(2) | M | ISO 两位字母代码 |
| currCode | 银行账户币种 | String(3) | M | ISO 三位字母代码BankCountryCode=CN,payType= Local或payType= FxPay才支持CNY |
| bankAccProp | 银行账户属性 | String(1) | M | ownAcc =N,payeeProp=0 仅支持私户ownAcc =N,payeeProp=1 仅支持公户 |
| idType | 个人证件类型 | String(1) | C | ownAcc=N，bankAccProp=0，currCode= CNY 必填0:身份证 |
| idCardNo | 个人证件号码 | String(20) | C | ownAcc=N，bankAccProp=0，currCode= CNY 必填 |
| phone | 手机号码 | String(11) | C | currCode=CNY 必填 |
| payType | 支付方式 | String(10) | M | Local-本地付款FxPay-结汇付款SWIFT-国际付款bankCountryCode=CN,必填，支持FxPay或SWIFTbankCountryCode=HK ,支持Local 或SWIFTbankCountryCode=其他,仅支持SWIFT |
| bankAddress | 银行地址 | String(200) | C | CNY币种时必填 |
| bankName | 银行名称 | String(200) | M | CNY币种：CNY币种使用附件中银行编码 |
| bankNo | 银行编码 | String(20) | C | payType=Local bankCountryCode=HK currCode=CNH/HKD时 必填 HK 3位银行编码 |
| bankBranchCode | 支行代码/联行号 | String(20) | C | currCode=CNY,payeeProp=1 必填 |
| bankAccNo | 银行账号 | String(100) | M | |
| bankAccName | 银行账户名 | String(200) | M | CNY币种时().,- |
| bankAccAddress | 开户地址 | String(200) | M | CNY币种时必填/-?: ().,' |
| swiftCode | SWIFT | String(20) | C | CNY币种时必填 |
| proxyBankName | 代理银行名称 | String(200) | O | 仅允许录入英文字符及合规符号().,- |
| proxyBankAddress | 代理银行地址 | String(200) | O | 仅允许录入英文字符及合规符号/-?: ().,' |
| proxyBankSwiftCode | 代理银行 SWIFT | String(20) | O | 8 或 11 位，第五和第六位字母应与银行国家代码匹配 |
| attachments | 附件 | Array<File> | C | JPG, JPEG, PNG, PDF, ZIP |
| 邮箱 | String(200) | O | ||
| clearingCode | 清算号 | String(50) | O |
响应参数
| 参数名 | 参数描述 | 类型 | 约束 | 说明 |
|---|---|---|---|---|
| subMchNo | 子商户编号 | String | ||
| mchSeqNo | 商户请求号 | String | ||
| ownAcc | 是否本公司账户 | String | ||
| payeeProp | 收款方属性 | String | 个人/公司 | |
| payeeCountryCode | 收款方国家代码 | String | CN/非 CN | |
| payeeName | 收款方名称 | String | ||
| payeeRegAddress | 收款方注册地址 | String | ||
| payeeProvince | 收款人省/州 | String | ||
| payeeCity | 收款人城市 | String | ||
| payeePostcode | 收款人邮编 | String | ||
| nickname | 收款方昵称 | String | ||
| licenseNo | 营业执照/商业注册证书 | String | ||
| legalName | 法人/董事 | String | ||
| legalIdType | 法人/董事证件类型 | String | ||
| legalIdCardNo | 法人/董事证件号码 | String | ||
| bankCountryCode | 银行国家代码 | String | ||
| currCode | 银行账户币种 | String | CNY/非 CNY | |
| bankAccProp | 银行账户属性 | String | 私户/公户 | |
| idType | 个人证件类型 | String | ||
| idCardNo | 个人证件号码 | String | ||
| phone | 个人手机号码 | String | ||
| payType | 支付方式 | String | ||
| bankAddress | 银行地址 | String | ||
| bankNo | 银行编码 | String | ||
| bankName | 银行名称 | String | ||
| bankAccNo | 银行账号 | String | ||
| bankAccName | 银行账户名 | String | ||
| bankAccAddress | 开户地址 | String | ||
| swiftCode | SWIFT | String | ||
| proxyBankName | 代理银行名称 | String | ||
| proxyBankAddress | 代理银行地址 | String | ||
| proxyBankSwiftCode | 代理银行 SWIFT | String | ||
| attachments | 附件 | Array<File> | ||
| payeeId | 收款账户 ID | String | 收款账户平台唯一 ID | |
| status | 收款账户状态 | String | 1:有效2:待审核3:审核中4:审核驳回5:审核拒绝6:无效7:待确认8:命中风控规则 | |
| poboStatus | Pobo 状态 | C | 境外账户，SWIFT 类型Y-开通N-未开通P-开通中 | |
| remark | 备注 | String |
请求示例
{
"attachments": [
{
"fileId": "444995b9-0a32-4489-886f-681332d4b47f",
"fileType": "relationProof"
}
],
"bankAccAddress": "sddf3the.sggg.sgsgs.234s",
"bankAccName": "FAN ZHEN DONG",
"bankAccNo": "6225757524130254",
"bankAccProp": "1",
"bankAddress": "sddf3the.sggg.sgsgs.234s",
"bankCountryCode": "HK",
"bankName": "ZHAO SHANG BANK",
"currCode": "HKD",
"mchSeqNo": "ULThoGEDIKPFH6uk",
"ownAcc": "N",
"payType": "Local",
"payeeCountryCode": "HK",
"payeeName": "FAN ZHEN DONG",
"payeeProp": "1",
"subMchNo": "52353252352352",
"swiftCode": "SCBLHKHH"
}响应示例
{
"code": "0000",
"data": {
"attachments": [
{
"fileType": "relationProof",
"fileId": "444995b9-0a32-4489-886f-681332d4b47f"
}
],
"currCode": "HKD",
"payeeProp": "1",
"swiftCode": "SCBLHKHH",
"bankName": "ZHAO SHANG BANK",
"bankAccProp": "1",
"bankAccNo": "6225757524130254",
"mchSeqNo": "ULThoGEDIKPFH6uk",
"bankAddress": "sddf3the.sggg.sgsgs.234s",
"payeeName": "FAN ZHEN DONG",
"bankAccName": "FAN ZHEN DONG",
"ownAcc": "N",
"payType": "Local",
"bankCountryCode": "HK",
"payeeCountryCode": "HK",
"subMchNo": "52353252352352",
"bankAccAddress": "sddf3the.sggg.sgsgs.234s",
"payeeId": "P000009321274",
"status": "2"
},
"error": false,
"msg": "操作成功",
"success": true
}修改于 2026-06-09 03:03:41