查询虚拟银行卡信息

查询消费者级或商户级虚拟银行信息(VA)。消费者级账户在首次下单后申请开立。

请求地址(POST)

实时API:https://api.futurepay.global/payin/getBankInfo

沙盒API:https://api.futurepay-develop.com/payin/getBankInfo

请求参数

Request Body

参数名类型是否必填描述
customerIdString条件必填客户id。查询消费者级账户时必填;subType 传 MERCHANT 时无需传
subTypeString否传 MERCHANT 查询商户级账户
currencyString否币种,例如 GBP、EUR、AED;不传则不按币种过滤

查询商户级账户时,返回当前收单账户(由请求头 subAccountNo 指定,不传为默认账户)已开通币种的账户,结果中 customerId 为空。

查询消费者级账户时,customerId 必须属于当前商户。不传 currency 返回该客户可查询的各币种账户;尚无可返回账户时,data 为 []。本接口只查询账户,不触发开户。

请求示例:

消费者级账户:

{
    "customerId": "FPeb01fb2a448143c1b1d944062c9d9153"
}

消费者级 AED 账户:

{
    "customerId": "FPeda1770136ff446292f75fe762e027d9",
    "currency": "AED"
}

商户级账户:

{
    "subType": "MERCHANT",
    "currency": "GBP"
}

响应示例

参数类型描述
codeString返回代码,"0" 表示请求成功
msgString返回信息
serverTimeLong服务器时间戳
dataArray账户对象数组,无可返回账户时为 []
├──customerIdString客户id(商户级账户为空)
├──currencyString币种
├──accountHolderNameString账户持卡人
├──ibanStringIBAN
├──accountNumberStringGBP 本地账户号码
├──sortCodeStringGBP 本地账户 Sort Code,AED 不返回
├──bicStringBIC / SWIFT
├──bankString银行名称
├──bankAddressString银行地址
├──countryString国家
├──statusStringVA开户状态
successBoolean请求是否成功,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
}

Did this page help you?