查询可用代付银行列表

接口地址（POST）

实时 API: https://api.futurepay.global/api/v1/payout/queryByBankCode

沙盒 API: https://api.futurepay-develop.com/api/v1/payout/queryByBankCode

认证方式：Bearer Token（需在Header中携带Authorization）

请求参数

参数名	类型	是否必填	描述
countryCode	String	是	国家代码，必须为 ISO 3166-1 alpha-2（2位）标准，如 "TZ" 表示坦桑尼亚。传入 "Global" 表示查询所有国家的银行。
codeType	String	否	支持的代付方式，可选值为（BankTransfer，MobileMoney）
clientIp	String	是	客户端 IP，记录用

示例请求体（JSON）

{
  "countryCode": "TZ",
  "clientIp": "123131"
}

响应参数

字段名	类型	描述
code	String	返回码，"0" 表示成功
msg	String	返回信息说明
serverTime	Long	服务端响应时间（时间戳）
data	List<Object>	业务数据（代付余额信息）
success	Boolean	是否成功（true / false）

data字段结构

字段名	类型	说明
standardCode	String	标准银行编码（唯一标识）
bankName	String	银行/钱包名称（本地语言）
countryCode	String	国家代码（如支持多个国家，则用逗号分割）
codeType	String	支持的代付方式（BankTransfer，MobileMoney）
isBranch	Boolean	是否支行

{
    "code": "0",
    "msg": "succeeded",
    "serverTime": 1750748554640,
    "data": [
        {
            "standardCode": "TIGTZA",
            "bankName": "TIGO",
            "countryCode": "TZ,UG",
            "codeType": "BankTransfer,MobileMoney",
            "isBranch": true
        },
        {
            "standardCode": "0012",
            "bankName": "National Bank of kenya",
            "countryCode": "KE",
            "codeType": "BankTransfer",
            "isBranch": false
        }
    ],
    "success": true
}

备注

1.standardCode 可用于后续创建代付订单时指定银行或钱包渠道。

2.返回的银行/钱包数据可能会动态变更，请定期调用接口以获取最新数据。

3.serverTime 可用于请求响应时差分析或日志记录。