VA收款银行

概述

关于VA开户银行的重要性与作用

VA开户银行是为受益人提供账户服务、接收并入账付款资金的银行机构，是资金最终入账的核心节点，承担资金接收、清算入账及合规审查等关键职能，会直接影响交易的安全性、合规性和到账效率。

请求地址：POST /api/v1/reference/va-support-bank-list

字段说明

输入参数

字段名称	必填	类型	描述
`businessTypeId`	M	string	业务类型id(MCC代码参考)
`currency`	M	string	收款币种
`countryCode`	M	string	收款国家的国际标准化组织（ISO）国家代码（如US代表美国，CN代表中国 ISO 3166-1 标准）
`paymentType`	M	string	收款方式(LOCAL 、SWIFT)

响应参数

字段名称	类型	说明
`bankId`	string	开户银行id
`address`	string	银行地址
`bankName`	string	银行名称
`bankCountry`	String	银行所在国家/地区
`bankImage`	String	银行图标
`currencies`	Array	支持收款币种

集成

查询VA开户银行信息调用输入

{
    "businessTypeId":"184",
    "currency":"NGN",
    "countryCode":"NG",
    "paymentType":"LOCAL"
}

查询VA开户银行信息调用输出

{
    "code": "0",
    "msg": "succeeded",
    "serverTime": 1761803559948,
    "data": [
        {
            "bankId": "10",
            "address": "176 Herbert Macaulay Way 3rd Floor, Yaba, Lagos, Nigeria",
            "bankName": "Paga",
            "bankCountry": "NG",
            "bankImage": "https://futurebank-public.oss-ap-southeast-1.aliyuncs.com/bank/icon/paga.png",
            "currencies": [
                "NGN"
            ]
        },
        {
            "bankId": "12",
            "address": "",
            "bankName": "Bank of Nigeria",
            "bankCountry": "NG",
            "bankImage": "https://futurebank-oss-dev.oss-ap-southeast-1.aliyuncs.com/country/1/d6fffb2e9e8648c28052d092879b32f0/ng.png?Expires=1761807159&OSSAccessKeyId=LTAI5t8WygUaJCd46Wk7fcKt&Signature=BftyG2r%2BbY%2FznvPxsveONsmXAEc%3D",
            "currencies": [
                "NGN"
            ]
        }
    ],
    "success": true
}