更新收款卡

POST /v1/mid-open-api/merchant/beneficiary-card/update
需要验证签名

针对文档说明对请求参数做核验（非空、长度以及合法性校验），验证失败同步响应失败（详情参考错误码说明），验证通过同步响应受理成功。受理请求后，异步执行卡信息验证，审核结果以异步方式回调通知（建议长时间未接收到收款卡审核结果通知时通过收款卡查询接口获取结果信息）。

提示

Parameter	Type	Required	Description
Authorization	string	M	access_token
Content-Type	string	M	application/json

Parameter	Type	Required	Description
client_id	string(64)	M	客户号
card_id	string(64)	M	添加收款卡时返回的卡编号
supplier_type	enum	O	贸易场景类型,点击见附录
id_number	string(64)	O	银行卡对应的证件号
holder_type	enum	O	账户持有者类型：对私 PERSON（个人）, 对公 ENTERPRISE （企业）
account_name	string(255)	O	银行账户名称（对私账户需与个人姓名⼀致，对公账户需与公司名称⼀致）。
account_type	enum	O	银行账户类型, 境内：CREDIT(贷记卡), DEBIT(借记卡) 境外：SAVING(储蓄账户), CURRENT(现金账户)
bank_code	string(64)	O	国内银行代码
bank_name	string(128)	O	银行名称（国内银行使用中文）
branch_code	string(64)	O	国内支行代码/联行号
branch_name	string(128)	O	银行支行名称
bank_area	string(2)	O	银行卡地区,例如US、HK、CN等
bank_address	string(512)	O	银行地址
account_no	string(64)	O	银行账户号，欧洲可使用iban
currency	string(3)	O	银行账户币种
swift_code	string(11)	O	收款行SWIFT代码【该字段仅支持8位或11位】
routing_no	string(16)	O	本地银行编码或路由号【如US地区的ABA Code，GB的sort code,HK地区的bank code + branch code等】
receiver_address	string(255)	O	收款人地址
phone_no	string(11)	O	客户手机号码,选填
calling_prefix	string(10)	O	国际电话区号,选填示例：+86
extra_materials	array	O	材料

Parameter	Type	Required	Description
extra_code	enum	M	附加材料code, bankStatement:银行证明文件，accountStatement：风险证明文件，supplierFileInfo：合同材料文件
extra_value_file_id	string(512)	M	附加材料附件(上传文件接口返回的file_id)，若是多个以英文逗号拼接

Parameter	Type	Required	Description
card_id	string	M	绑定卡后返回的唯一编号，幂等。可用于后期查询绑定结果和接收回调通知使用

{
    "code": 200,
    "data": {
        "card_id": "20220620151628"
    },
    "message": "SUCCESS"
}

{
    "code": 900002,
    "data": null,
    "message": "参数不合法"
}

返回码	描述	建议
900000	system error	系统错误，请联系PingPong人员核查
900001	card has already bind	卡已提交，不能再次提交
900002	illegal param	参数错误，请根据提示更正信息
900005	card status not support this action	收款卡正在审核中，不允许修改

2024-04-01 支持付款绑卡更新