收款账户类型
响应参数
参数说明
| 字段名称 | 字段类型 | 是否必填 | 字段说明 |
|---|---|---|---|
| payerPaymentType | String(100) | 是 | 收款方式，枚举类型，BANK-银行，ALIPAY-支付宝，CASH-现金 OTHER-其他 |
| accountType | String(100) | 是 | 账户类型，CORP-企业，PERSONAL-个人 |
| bankBranchName | String(300) | 否 | 分支行名称 |
| bankAcctName | String(300) | 否 | 收款的银行卡户名，支付宝或者现金时为空 |
| bankAcctNumber | String(150) | 否 | 收款方账户，为银行时，是银行卡，支付宝时为支付宝账户，现金时为空 |
| bankCode | String(200) | 否 | 银行编码 |
| bankName | String(300) | 否 | 开户银行 |
| bankBranchNo | String(300) | 否 | 分支行编码（联行号） |
| bankLocation | String(300) | 否 | 开户行地址（地址编码，具体编码请咨询每刻研发） |
| bankProvincePlaceCode | String(150) | 否 | 银行省份placeCode编码 |
| bankCityPlaceCode | String(150) | 否 | 银行城市placeCode编码 |
| bankCityName | String(100) | 否 | 银行城市 |
| bankProvinceName | String(100) | 否 | 银行省份 |
| bankCodeEN | String(100) | 否 | 一些国外银行会有的BANK Code参数 |
| payeeBsbNumber | String(150) | 否 | 澳大利亚各银行区域代码 |
| abaNumber | String(150) | 否 | 海外银行abaNumber |
| ibanNumber | String(150) | 否 | ibanNumber |
| bankCountry | String(50) | 否 | 国家与地区 |
| countryCode | String(2) | 否 | 收款账户国家/地区的 ISO 3166-1 Alpha-2 两位标准码，如中国为 CN、加拿大为 CA；根据 bankCountry 映射，原国家缺失或无法映射时为空 |
| abroadExpand | Object | 否 | 海外个人银行账户扩展信息，字段结构见下表；中国账户或无扩展信息时为空 |
| abroadBankAddress | String(512) | 否 | 开户银行地址 |
| swiftCode | String(100) | 否 | swiftCode |
| bankNameEn | String(100) | 否 | 银行名称（英文） |
| bankCardType | String | 否 | 银行卡性质，仅当中国银行账号时生效，可选枚举值： OFFICIAL_CARD：公务卡 DEBIT_CARD：储蓄卡 OTHER_CREDIT_CARD：信用卡 不传则默认无银行卡性质标注 |
| persoanal | boolean | 否 | 账户性质，默认为false，表示对公账户。true表示对私账户。 |
| customObject | CustomObject | 否 | 自定义字段， 不填时视为维持原数据 填写空对象时视为清除原数据 |
abroadExpand 参数说明
| 字段名称 | 字段类型 | 是否必有 | 字段说明 |
|---|---|---|---|
| abroadPayeeCity | String(35) | 否 | 收款人所在城市/城镇名称，仅非中国个人银行账户有值 |
| abroadPayeeProvinceCode | String | 否 | 省/州代码，仅加拿大个人银行账户有值 |
| abroadPayeePostalCode | String | 否 | 邮编，仅加拿大个人银行账户有值 |
| mxAbmCode | String | 否 | MX ABM Code，仅墨西哥个人银行账户有值 |
参数样例
{
"accountType": "PERSONAL",
"payerPaymentType": "BANK",
"bankBranchName": "每刻银行杭州支行",
"bankAcctName": "张三",
"bankAcctNumber": "123412341234123",
"bankCode": "mkb",
"bankName": "每刻银行",
"bankLocation": "domestic-ZH32-ZH32_1",
"bankCityName": "杭州市",
"bankBranchNo": "123456",
"bankProvinceName": "浙江",
"bankCountry": "CANADA",
"countryCode": "CA",
"abroadExpand": {
"abroadPayeeCity": "Toronto",
"abroadPayeeProvinceCode": "ON",
"abroadPayeePostalCode": "M5V 3A8"
},
"abroadBankAddress": "自定义收款银行地址",
"swiftCode": "11qc",
"bankNameEn": "11qb",
"customObject": {
"CF39": 444
}
}
修改记录
2023-02-08 新增收款账户类型文档
2025-12-09 新增bankNameEn字段
2025-01-15 新增bankCardType银行卡性质、persoanal账户性质字段
2026-07-15 新增customObject自定义字段
2026-09-21 新增countryCode及abroadExpand中的abroadPayeeCity、abroadPayeeProvinceCode、abroadPayeePostalCode、mxAbmCode字段