查询收款卡

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

接口描述

查询添加的收款卡信息

请求头

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)	O	卡编号，添加卡返回的唯一编号
pay_type	string(64)	O	绑卡使用场景 WITHDRAW(提现), PAY(付款)

返回响应

Parameter	Type	Required	Description
client_id	string(64)	M	客户号
card_info_list	array	O	持有的收款卡信息

card_info_list

Parameter	Type	Required	Description
card_id	string(64)	M	添加收款卡时返回的卡编号
pay_type	enum	M	卡使用场景类型, WITHDRAW(提现), PAY(付款)
supplier_type	enum	C	贸易场景类型,点击见附录
id_number	string(64)	M	银行卡对应的证件号
holder_type	enum	M	账户持有者类型：对私 PERSON（个人）, 对公 ENTERPRISE （企业）
account_name	string(255)	M	银行账户名称（对私账户需与个人姓名⼀致，对公账户需与公司名称⼀致）。
account_type	enum	M	银行账户类型, 境内：CREDIT(贷记卡), DEBIT(借记卡) 境外：SAVING(储蓄账户), CURRENT(现金账户)
bank_code	string(64)	C	银行编码
bank_name	string(128)	M	银行名称（国内银行使用中文）
branch_code	string(64)	O	国内支行代码/联行号
branch_name	string(128)	O	银行支行名称
bank_area	string(2)	M	银行卡地区,例如US、HK、CN等
bank_address	string(512)	O	银行地址
account_no	string(64)	M	银行账户号，欧洲可使用iban
currency	string(3)	M	银行账户币种
swift_code	string(11)	C	收款行SWIFT代码【国际支付必填，该字段仅支持8位或11位】
routing_no	string(16)	C	本地银行编码或路由号【如US地区的ABA Code，GB的sort code,HK地区的bank code + branch code等】，外币卡，当无swift code时，必填
receiver_address	string(255)	M	收款人地址
phone_no	string(11)	O	客户手机号码,选填
calling_prefix	string(10)	O	国际电话区号,选填 示例：+86
status	enum	M	审核状态, PENDING:审核中 APPROVED:审核通过 RETURNED:打回(需要补充材料更新) , REJECTED:拒绝(不允许再次提交审核)
fail_reason	string(512)	C	审核失败原因，中文汇总原因描述，审核失败时返回
fail_reason_en	string(512)	C	审核失败原因，英文汇总原因描述，审核失败时返回
fail_reason_data	array	C	审核拒绝原因明细，审核失败时返回，分为基础参数错误和附加证明材料提示

fail_reason_data

Parameter	Type	Required	Description
extra_code	enum	M	附加材料code或基础信息错误code, bankStatement,accountStatement,bankBaseInfo,supplierFileInfo
extra_name	string(64)	M	附加材料名称, bankStatement:银行证明文件，accountStatement：风险证明文件,bankBaseInfo:基础信息错误,supplierFileInfo：合同材料
extra_value_file_id	string(512)	O	附加材料附件(上传文件接口返回的file_id)，若是多个以英文逗号拼接
fail_reason	string(255)	M	失败原因 (中文描述)
fail_reason_en	string(512)	M	失败原因 （英文描述）

返回示例

成功

{
    "code":200,
    "message":"SUCCESS",
    "data":{
        "client_id":"IT8623110602506418328",
        "card_info_list":[
            {
                "accountName":"张三",
                "card_id":"BANK8623110711353432749",
                "pay_type":"WITHDRAW",
                "supplier_type":null,
                "id_number":"320123111001120",
                "holder_type":"ENTERPRISE",
                "account_type":"SAVINGS",
                "bank_name":"中国工商银行",
                "branch_name":"滨江西兴第一分行",
                "bank_area":null,
                "bank_address":"杭州市滨江区西兴街道滨安路002",
                "account_no":"62223110239812385736",
                "currency":"CNY",
                "swift_code":"SGBQVNUSXXX",
                "routing_no":"",
                "receiver_address":"杭州市滨江区西兴街道滨安路002"
                "phone_no":null,
                "calling_prefix":null,
                "status":"APPROVED",
                "fail_reason_data":null
            }
        ]
    }
}

失败

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

错误码

返回码	描述	建议
900000	system error	系统错误，请联系PingPong人员核查
900001	repeated request	订单已存在，请勿当作失败处理！
900002	illegal param	参数错误，请根据提示更正信息

更新日志

2024-04-01 支持付款绑卡

1. 查询参数和结果返回新增pay_type字段。
2. 查询返回新增supplier_type字段。
3. 查询返回新增receiver_address收款人地址字段。
4. 新增查询返回fail_reason和fail_reason_en字段，代表审核失败汇总的中文和英文原因描述
5. status枚举值更新，移除DECLINED，新增RETURNED:打回(需要补充材料更新) , REJECTED:拒绝(不允许再次提交审核)