账号信息查询

POST /v1/mid-open-api/va/hold/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	注册PingPong返回的客户ID
account_no	string(32)	O	收款账号

返回响应

Parameter	Type	Required	Description
client_id	string(64)	M	注册PingPong返回的客户ID
va_account_info_list	array	O	客户持有的收款账号信息列表

va_account_info_list

Parameter	Type	Required	Description
bank_name	string(255)	M	银行名称
account_no	string(32)	M	账号，order_status为SUCCESS返回
iban	string(32)	O	欧盟国际银行帐号
bank_code	string(32)	O	国内银行代码
branch_number	string(32)	O	国内支行代码/联行号
bank_account_type	enum	M	银行账号类型, CHECKING,CURRENT,DEPOSIT,SAVINGS,order_status为SUCCESS返回
currency	enum	M	币种，支持的币种见附录。支持多个币种时以英文逗号分隔，例如USD,EUR,GBP
account_status	enum	M	账号状态 AVAILABLE,CLOSED
bank_location	enum	M	银行所在地区,见附录
routing_number	string(32)	O	本地银行代码
swift_code	string(32)	O	银行国际代码
sort_code	string(32)	O	英国银行代码
address	string(255)	M	银行详细地址
holder_name	string(255)	M	账户持有主体名称

返回示例

成功

{
    "code":200,
    "message":"SUCCESS",
    "data":{
        "client_id":"IT8623081809128663724",
        "va_account_info_list":[
            {
                "bank_name":"Citibank",
                "bank_code":null,
                "branch_number":null,
                "account_no":"73381000000310651",
                "iban":"",
                "currency":"USD",
                "account_status":"AVAILABLE",
                "bank_account_type":"Checking",
                "bank_location":"US",
                "routing_number":"031100209",
                "sort_code":null,
                "swift_code":"GEOORUMMXXX",
                "holder_name":"PingPong",
                "address":"111 Wall Street, New York, New York 10043, United States",
                "collection_type":"Virtual_Account"
            }
        ]
    }
}

失败

{
    "code": 900002,
    "data": null,
    "message": "client_id is empty"
}

错误码

返回码	描述	解决方案
900000	system error	系统错误，请联系PingPong技术人员核查
900002	illegal param	参数有误，请根据提示更正信息