VA收款银行

概述

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

Endpoint

Sandbox

POST https://preapi.futurepay-develop.com/api/v1/reference/va-support-bank-list

Production

POST https://api.futurepay.global/api/v1/reference/va-support-bank-list

Request Parameters

Parameter	Required	Type	Description
businessTypeId	Yes	string	Business type ID
currency	Yes	string	Collection currency
countryCode	Yes	string	ISO 3166-1 Alpha-2 country code
paymentType	Yes	string	Collection method (`LOCAL`、`SWIFT`)

Request Example

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

Response

Field	Type	Description
bankId	string	Bank ID
bankName	string	Bank name
bankCountry	string	Bank country
currencies	array	Supported collection currencies

Response Example

{
  "code": "0",
  "msg": "succeeded",
  "serverTime": 1761803559948,
  "success": true,
  "data": [
    {
      "bankId": "10",
      "bankName": "Paga",
      "bankCountry": "NG",
      "currencies": [
        "NGN"
      ]
    },
    {
      "bankId": "12",
      "bankName": "Bank of Nigeria",
      "bankCountry": "NG",
      "currencies": [
        "NGN"
      ]
    }
  ]
}