请求URL

POST {域名}/api/user/payee-account/v2/add-user-payees

请求参数

👉说明：

加密数据dataContent

SWIFT参数

字段名称 描述 是否必填 备注 验证规则
paymentChannelType 付款方式 是 SWIFT
accType 收款人类型 是 1-企业，2-个人
countryCode 银行国家/地区 是 3位国家代码
accountCcy 账户币种 是 3位币种代码
accountName 账户名称 是 正则:^[a-zA-Z0-9\s!#$%&’()*+,\-./:;‘=?@\[\]^_`{|}~]+$
cardNo 银行账号/IBAN 是 仅允许数字和字母
swiftCode SWIFTCODE 是 正则:^[a-zA-Z]{6}[a-zA-Z0-9]{2}([a-zA-Z0-9]{3})?$,且和国家对应
middleSwiftCode 中间行SWIFTCODE 否 正则:^[a-zA-Z]{6}[a-zA-Z0-9]{2}([a-zA-Z0-9]{3})?$,且和国家对应
city 城市 否 正则:^[\p{L}\p{M}\s\-‘.]+$
payeeAddress 收款人地址 是 正则:^[a-zA-Z0-9\s!#$%&’()*+,\-./:;‘=?@\[\]^_`{|}~]+$
bankName 银行名称 是

LOCAL参数

由于每个国家支持的可能不一样，参数需使用通用参数+每个国家的不同参数

通用参数
字段名称 描述 是否必填 备注 验证规则
accType 收款人类型 是 1-企业，2-个人
countryCode 银行国家/地区 是 LOCAL的国家和币种正确对应（参考local国家币种关系） 3位国家代码
accountCcy 账户币种 是 LOCAL的国家和币种正确对应（参考local国家币种关系） 3位币种代码
paymentChannelType 付款方式 是 此处固定为LOCAL
accountName 账户名称 是 除中国非中文
bankName 银行名称 是 除中国非中文
澳大利亚
字段名称 描述 是否必填 备注 验证规则
cardNo 银行账号 是 5-12位数字
clearingCode BSB-收款银行代码 是 6位数字
province 省/州 是 支持的省州有：
AustralianCapitalTerritory
NewSouthWales
NorthernTerritory
Queensland
SouthAustralia
Tasmania
Victoria
WesternAustralia
city 城市 是 非中文，非数字
payeeAddress 收款人地址 是 不支持PO或GPOBox类型的地址 不支持中文和一些非常见符号
zipCode 邮编 是 4-6位数字
firstName 名 是 收款人类型为个人时需传 不支持一些重音符号、空格符、非常见符号
lastName 姓 是 收款人类型为个人时需传 不支持一些非常见符号
波兰|德国|法国|芬兰|卢森堡|瑞士|西班牙|瑞典
字段名称 描述 是否必填 备注 验证规则
cardNo 银行账号/IBAN 是 波兰：PL+26位数字
德国：DE+20位数字
法国：FR+25位字母或数字
芬兰：FI+16位数字
卢森堡：LU+18位数字
瑞士：CH+19位数字
西班牙：ES+22位数字
瑞典:SE+22位数字
swiftCode BICCODE 是 瑞典时无需填写 正则:^[a-zA-Z]{6}[a-zA-Z0-9]{2}([a-zA-Z0-9]{3})?$,且和国家对应
payeeAddress 收款人地址 是 不支持中文和一些非常见符号
city 城市 是 卢森堡和西班牙需填写
firstName 名 是 收款人类型为个人时需传 不支持一些重音符号、空格符、非常见符号
lastName 姓 是 收款人类型为个人时需传 不支持一些非常见符号
菲律宾|马来西亚|泰国|新加坡
字段名称 描述 是否必填 备注 验证规则
cardNo 银行账号 是 5到16位数字
payeeAddress 收款人地址 是 不支持中文和一些非常见符号
韩国
字段名称 描述 是否必填 备注 验证规则
cardNo 银行账号 是 数字和字母
payeeAddress 收款人地址 是 不支持中文和一些非常见符号
firstName 名 是 收款人类型为个人时需传 不支持一些重音符号、空格符、非常见符号
lastName 姓 是 收款人类型为个人时需传 不支持一些非常见符号
加拿大
字段名称 描述 是否必填 备注 验证规则
cardNo 银行账号 是 5-35位数字
clearingCode RoutingCode 是 8位数字
province 省/州 是 - Alberta
- British Columbia
- Manitoba
- New Brunswick
- Newfoundland and Labrador
- Nova Scotia
- Northwest Territories
- Nunavut
- Ontario
- Prince Edward Island
- Quebec
- Saskatchewan
- Yukon
city 城市 是 非中文，非数字
payeeAddress 收款人地址 是 不支持中文和一些非常见符号
zipCode 邮编 是 6-7位,135字母246数字组成
firstName 名 是 收款人类型为个人时需传 不支持一些重音符号、空格符、非常见符号
lastName 姓 是 收款人类型为个人时需传 不支持一些非常见符号
美国
字段名称 描述 是否必填 备注 验证规则
cardNo 银行账号 是
cardType 账户类型 是 10-DEPOSIT,11-SAVINGS,12-CHECKING
clearingCode RoutingCode 是 9位数字
payeeAddress 收款人地址 是 不支持中文和一些非常见符号
province 省/州 是
city 城市 是 不支持数字和非城市常见符号
zipCode 邮编 是 5位数字或者+连字符+4位数字
firstName 名 是 收款人类型为个人时需传 不支持一些重音符号、空格符、非常见符号
lastName 姓 是 收款人类型为个人时需传 不支持一些非常见符号
日本
字段名称 描述 是否必填 备注 验证规则
cardNo 银行账号 是
cardType 账户类型 是 10-DEPOSIT,11-SAVINGS,12-CHECKING
clearingCode 银行代码 是 3位数字
branchCode 银行分行代码 是 3位数字
phoneNum 手机号 是 81-开头
payeeAddress 收款人地址 是 不支持中文和一些非常见符号
印度
字段名称 描述 是否必填 备注 验证规则
cardNo 银行账号 是 5-20位数字
clearingCode IFSC 是 11位字母+数字
payeeAddress 收款人地址 是 不支持中文和一些非常见符号
city 城市 是 不支持数字和非城市常见符号
firstName 名 是 收款人类型为个人时需传 不支持一些重音符号、空格符、非常见符号
lastName 姓 是 收款人类型为个人时需传 不支持一些非常见符号
印度尼西亚
字段名称 描述 是否必填 备注 验证规则
cardNo 银行账号 是 5到16位数字
payeeAddress 收款人地址 是 不支持中文和一些非常见符号
firstName 名 是 收款人类型为个人时需传 不支持一些重音符号、空格符、非常见符号
lastName 姓 是 收款人类型为个人时需传 不支持一些非常见符号
英国
字段名称 描述 是否必填 备注 验证规则
cardNo 银行账号 是
clearingCode SortCode 是 6位数字
payeeAddress 收款人地址 是 不支持中文和一些非常见符号
city 城市 是 正则:^[a-zA-Z!#$%&‘()*+,\-./:;=?@\[\]^_`{|}~\s]{1,64}$
firstName 名 是 收款人类型为个人时需传 不支持一些重音符号、空格符、非常见符号
lastName 姓 是 收款人类型为个人时需传 不支持一些非常见符号
越南
字段名称 描述 是否必填 备注 验证规则
cardNo 银行账号 是 5到19位数字
payeeAddress 收款人地址 是 不支持中文和一些非常见符号
city 城市 否 使用城市列表
swiftCode SWIFTCODE 否 这里参考银行列表如果对应银行需要则需要
firstName 名 是 收款人类型为个人时需传 不支持一些重音符号、空格符、非常见符号
lastName 姓 是 收款人类型为个人时需传 不支持一些非常见符号
中国
  • 企业
字段名称 描述 是否必填 备注 验证规则
cardNo 银行账号 是
bankBranchName 支行名称 是
province 支行省 是
city 支行市 是
orgExpand.orgName 企业名称 是
orgExpand.legalName 法人名称 是
orgExpand.legalNo 法人身份证号 是
orgExpand.legalCountryCode 法人国籍 是
orgExpand.isTaxFree 是否特殊经济区客户 是 0是，1否
orgExpand.taxFreeCode 特殊经济类型 否 是特殊经济区客户时参考《特殊经济类型》填写
  • 个人
字段名称 描述 是否必填 备注 验证规则
idNo 身份证号 是
payeeAddress 居住地址 是
payeeProvince 居住省 是
payeeCity 居住市 是
payeeArea 居住区 是
cardNo 银行账号 是 仅支持数字
中国香港
  • USD
字段名称 描述 是否必填 备注 验证规则
cardNo 银行账号 是
swiftCode SWIFTCODE 是 正则:^[a-zA-Z]{6}[a-zA-Z0-9]{2}([a-zA-Z0-9]{3})?$,且和国家对应
payeeAddress 收款人地址 是 不支持中文和一些非常见符号
firstName 名 是 收款人类型为个人时需传 不支持一些重音符号、空格符、非常见符号
lastName 姓 是 收款人类型为个人时需传 不支持一些非常见符号
  • HKD/CNH
字段名称 描述 是否必填 备注 验证规则
cardNo 银行账号 是
clearingCode 银行代码 是 3位数字
payeeAddress 收款人地址 是 不支持中文和一些非常见符号

BPAY参数

暂只支持 澳大利亚-企业

字段名称 描述 是否必填 备注 验证规则
accType 收款人类型 是 1-企业，不支持个人
countryCode 银行国家/地区 是 固定AUS 3位国家代码
accountCcy 账户币种 是 固定AUD 3位币种代码
paymentChannelType 付款方式 是 此处固定为BPAY
accountName BillerName 是 非中文
payeeAddress 收款人地址 是 不支持中文和一些非常见符号
cardNo BillerCode(银行账号) 是

dataContent示例

{
    "accType": "1",
    "accountCcy": "USD",
    "accountName": "GEP Testing Co., Ltd",
    "bankName": "DBS Bank (Hong Kong) Limited",
    "cardNo": "169999999",
    "countryCode": "HKG",
    "payeeAddress": "DBS Bank (Hong Kong) Limited",
    "paymentChannelType": "SWIFT",
    "swiftCode": "DHBKHKHH"
}

响应参数

👉说明：

结果信息result

字段名称 描述 是否必填 备注
recordNo 记录编号 是

result示例

{
  "recordNo": 2408151605000005600
}
作者：陈花枪  创建时间：2025-05-29 17:17
最后编辑：陈花枪  更新时间：2025-05-29 17:23