批量导入支付账户
说明
该接口用于批量导入支付账户。
接口限制
1. 10次/秒;
2. 一个批次导入的条数不能超过100条。
接口地址
/api/openapi/enterprise/account/import
请求类型
POST
请求参数
参数说明
| 参数名称 | 类型 | 是否必填 | 参数说明 |
|---|---|---|---|
| payerPaymentType | String | 必填 | 账户类型。 可选“银行账户”、“支付宝”、“现金”、“其他”。 |
| bankAcctName | String | 必填 | 户名。 账户类型为“银行账户”填写户名，账户类型为“支付宝”、“现金”填写姓名。 |
| bankAcctNumber | String | 部分必填 | 账号。 “银行账户”填写银行卡号；“支付宝”填写“支付宝账号”；“现金”无需填写；“其他”填写其他类型的账号。账户类型为“银行”“支付宝”时必填。 |
| bankName | String | 部分必填 | 开户银行。 “银行账户”填写开户银行；“支付宝”“现金”“其他”无需填写，若填写了联行号，则系统会按照联行号直接匹配系统内的开户银行。请填写每刻系统中已存在的开户银行并保证名称一致。 |
| bankLocation | String | 非必填 | 开户省市。 “银行账户”可以非必填开户省市,跨行支付可能需要用到；“支付宝”“现金”“其他”无需填写。请填写每刻系统中已存在的开户省市并保证名称一致。 |
| bankBranchName | String | 非必填 | 分支行。 “银行账户”可以非必填分支行，跨行支付可能需要用到，若填写了联行号，则系统会按照联行号直接匹配系统内的分支行，若分支行及联行号填写，则系统直接为您创建该分支行（不能复用）；“支付宝”“现金”“其他”无需填写。 |
| bankBranchNo | String | 部分必填 | 联行号。 “银行账户”可以非必填联行号，跨行支付可能需要用到，若填写了联行号，系统会按照联行号直接匹配系统内的分支行，若分支行及联行号填写，则系统直接为您创建该分支行（不能复用）；“支付宝”“现金”“其他”无需填写。填写分支行时，联行号必填 |
| certificateTypeName | String | 非必填 | 证件类型。 可选“居民身份证”、“临时身份证”、“护照”、“户口簿”、“军人身份证”、“武装警察身份证”、“外交人员身份证”、“外国人居留许可证”、“边民出入境通行证”、“对私其它”、“企业法人营业执照”、“企业营业执照”、“驻华机构登记证”、“个体工商户营业执照”、“组织机构代码证”、“港澳居民来往内地通行证（香港）”、“港澳居民来往内地通行证（澳门）”、“台湾居民来往大陆通行证”。 |
| certificateCode | String | 非必填 | 证件号。 填写所选证件类型的证件号。 |
| accountBizCode | String | 非必填 | 账户编码。 填写支付账户的编码，建议和财务系统保持一致，方便进行统一核算。 |
| bankCountry | String | 部分必填 | 国家和地区（中文，如中国）。 账户类型为银行账户时，必须要填写国家或地区。 |
| swiftCode | String | 非必填 | SWIFT Code。 部分国家需要填写。 |
| remark | String | 非必填 | 备注。 用于备注相应账户的特殊信息。 |
| legalEntityAuthzs | String | 非必填 | 适用的公司抬头。 填写适用公司抬头的业务编码，如有多个需用中文逗号隔开，不填默认不限制。 |
| affiliatedEnterpriseAuthz | String | 非必填 | 开户公司/主体。 填写开户公司/主体（公司抬头）的业务编码，只支持单个。 |
参数样例
[
{
"payerPaymentType": "银行账户",
"bankAcctName": "每刻1",
"bankAcctNumber": "22179811213",
"bankName": "工商银行",
"bankLocation": "杭州市/浙江",
"bankBranchName": "",
"bankBranchNo": "102331000217",
"certificateTypeName": "居民身份证",
"certificateCode": "123456",
"accountBizCode": "123456",
"bankCountry": "中国",
"swiftCode": "",
"remark": "测试备注",
"legalEntityAuthzs": "111，222，333",
"affiliatedEnterpriseAuthz": "222"
},
{
"payerPaymentType": "银行账户",
"bankAcctName": "每刻2",
"bankAcctNumber": "987654321000",
"bankName": "工商银行",
"bankLocation": "杭州市/浙江",
"bankBranchName": "",
"bankBranchNo": "102331000241",
"certificateTypeName": "居民身份证",
"certificateCode": "331100",
"accountBizCode": "222222",
"bankCountry": "中国",
"swiftCode": "",
"remark": "测试备注",
"legalEntityAuthzs": "444，555，666",
"affiliatedEnterpriseAuthz": "222"
},
{
"payerPaymentType": "支付宝",
"bankAcctName": "每刻3",
"bankAcctNumber": "123456789",
"bankName": "",
"bankLocation": "",
"bankBranchName": "",
"bankBranchNo": "",
"certificateTypeName": "居民身份证",
"certificateCode": "123456",
"accountBizCode": "333333",
"bankCountry": "中国",
"swiftCode": "",
"remark": "测试备注",
"legalEntityAuthzs": "777，888，999",
"affiliatedEnterpriseAuthz": "222"
}
]
响应参数
参数说明
| 参数名称 | 类型 | 是否必填 | 参数说明 |
|---|---|---|---|
| code | String | 是 | 是否成功。某一条记录是否成功结果。0--成功；1--失败 |
| errMsg | String | 是 | 错误信息。导入成功则返回空；导入失败则返回错误信息，多个错误信息使用【；】连接。 |
| payerPaymentType | String | 是 | 账户类型入参原路返回 |
| bankAcctName | String | 是 | 户名入参原路返回 |
| bankAcctNumber | String | 是 | 账号入参原路返回 |
| bankName | String | 是 | 开户银行入参原路返回 |
| bankLocation | String | 是 | 开户省市入参原路返回 |
| bankBranchName | String | 是 | 分支行入参原路返回 |
| bankBranchNo | String | 是 | 联行号入参原路返回 |
| certificateTypeName | String | 是 | 证件类型入参原路返回 |
| certificateCode | String | 是 | 证件号入参原路返回 |
| accountBizCode | String | 是 | 账户编码入参原路返回 |
| bankCountry | String | 是 | 国家和地区入参原路返回 |
| swiftCode | String | 是 | SWIFT Code入参原路返回 |
| remark | String | 是 | 备注入参原路返回 |
| legalEntityAuthzs | String | 是 | 适用的公司抬头入参原路返回 |
| affiliatedEnterpriseAuthz | String | 非必填 | 开户公司/主体业务编码入参原路返回 |
参数样例
{
"code": "ACK",
"message": "操作成功！",
"data": [
{
"payerPaymentType": "银行账户",
"bankBranchName": "",
"bankAcctName": "每刻1",
"bankAcctNumber": "22179811213",
"bankCode": null,
"bankName": "工商银行",
"bankLocation": "杭州市/浙江",
"bankBranchNo": "102331000217",
"accountBizCode": "123456",
"swiftCode": "",
"remark": "测试备注",
"certificateTypeName": "居民身份证",
"certificateCode": "332528",
"bankCountry": "中国",
"legalEntityAuthzs": "1223",
"affiliatedEnterpriseAuthz": "222",
"code": "0",
"errMsg": ""
},
{
"payerPaymentType": "银行账户",
"bankBranchName": "",
"bankAcctName": "每刻2",
"bankAcctNumber": "987654321000",
"bankCode": null,
"bankName": "工商银行",
"bankLocation": "杭州市/浙江",
"bankBranchNo": "102331000241",
"accountBizCode": "222222",
"swiftCode": "",
"remark": "测试备注",
"certificateTypeName": "居民身份证",
"certificateCode": "331100",
"bankCountry": "中国",
"legalEntityAuthzs": "1223",
"affiliatedEnterpriseAuthz": "222",
"code": "0",
"errMsg": ""
},
{
"payerPaymentType": "支付宝",
"bankBranchName": "",
"bankAcctName": "",
"bankAcctNumber": "123456789",
"bankCode": null,
"bankName": "",
"bankLocation": "",
"bankBranchNo": "",
"accountBizCode": "333333",
"swiftCode": "",
"remark": "测试备注",
"certificateTypeName": "居民身份证",
"certificateCode": "123456",
"bankCountry": "中国",
"legalEntityAuthzs": "1223",
"affiliatedEnterpriseAuthz": "222",
"code": "1",
"errMsg": "账户名不能为空;"
}
],
"bizCode": null,
"args": null,
"linkDetail": false,
"nonBizError": false,
"success": true
}