查询虚拟银行卡信息
查询消费者级或商户级虚拟银行信息(VA)。消费者级账户在首次下单后申请开立。
请求地址(POST)
实时API:https://api.futurepay.global/payin/getBankInfo
沙盒API:https://api.futurepay-develop.com/payin/getBankInfo
请求参数
Request Body
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
customerId | String | 条件必填 | 客户id。查询消费者级账户时必填;subType 传 MERCHANT 时无需传 |
subType | String | 否 | 传 MERCHANT 查询商户级账户 |
currency | String | 否 | 币种,例如 GBP、EUR、AED;不传则不按币种过滤 |
查询商户级账户时,返回当前收单账户(由请求头 subAccountNo 指定,不传为默认账户)已开通币种的账户,结果中 customerId 为空。
查询消费者级账户时,customerId 必须属于当前商户。不传 currency 返回该客户可查询的各币种账户;尚无可返回账户时,data 为 []。本接口只查询账户,不触发开户。
请求示例:
消费者级账户:
{
"customerId": "FPeb01fb2a448143c1b1d944062c9d9153"
}消费者级 AED 账户:
{
"customerId": "FPeda1770136ff446292f75fe762e027d9",
"currency": "AED"
}商户级账户:
{
"subType": "MERCHANT",
"currency": "GBP"
}响应示例
| 参数 | 类型 | 描述 |
|---|---|---|
| code | String | 返回代码,"0" 表示请求成功 |
| msg | String | 返回信息 |
| serverTime | Long | 服务器时间戳 |
| data | Array | 账户对象数组,无可返回账户时为 [] |
├──customerId | String | 客户id(商户级账户为空) |
├──currency | String | 币种 |
├──accountHolderName | String | 账户持卡人 |
├──iban | String | IBAN |
├──accountNumber | String | GBP 本地账户号码 |
├──sortCode | String | GBP 本地账户 Sort Code,AED 不返回 |
├──bic | String | BIC / SWIFT |
├──bank | String | 银行名称 |
├──bankAddress | String | 银行地址 |
├──country | String | 国家 |
├──status | String | VA开户状态 |
| success | Boolean | 请求是否成功,true 表示成功 |
消费者级 AED 账户:
{
"code": "0",
"msg": "success",
"serverTime": 1792981072858,
"data": [
{
"customerId": "FPeda1770136ff446292f75fe762e027d9",
"currency": "AED",
"bank": "Zand Bank PJSC",
"accountHolderName": "Oliver Bennett",
"bankAddress": "1st floor, Emaar square, Building 6, Dubai, United Arab Emirates",
"bic": "ZANDAEAAXXX",
"iban": "AE426406718620474656659",
"country": "AE",
"status": "SUCCESS"
}
],
"success": true
}Updated about 9 hours ago
Did this page help you?