代付银行查询接口

概述

代付银行查询接口用于查询商户可用的代付银行列表。商户可以通过此接口获取支持代付的银行信息，包括银行 ID、银行编码、银行名称和账户类型等。

接口信息

• 接口地址：GET /api/bank
• 请求方式：GET
• Content-Type：application/json

请求头

所有 API 请求都需要在请求头中包含以下参数，详见 API签名规范：

参数名	类型	必选	说明
Content-Type	string	Y	application/json，固定值
MerchantId	string	Y	商户 ID，由 Veloraya 提供
Timestamp	string	Y	当前时间戳（毫秒），防止重放攻击
Nonce	string	Y	随机字符串，防重放攻击，每次请求唯一
Signature	string	Y	请求签名（RSA签名），Base64编码

请求参数

本接口无需请求参数，商户 ID 通过请求头传入。

响应格式

所有接口的响应都采用统一的 JSON 格式，包含以下字段：

参数名	类型	说明
code	int	响应码，200 表示成功，非 200 表示失败
msg	string	响应消息
data	array	响应数据，成功时包含银行列表

响应参数（data 字段）

data 为数组，每个元素包含以下字段：

参数名	类型	说明
accountType	string	账户类型
bankId	string	银行 ID
bankCode	string	银行编码
bankName	string	银行名称

账户类型枚举

值	说明
BANK	银行

注意事项

• 请求头：必须在请求头中传入所有必需的参数（Content-Type、MerchantId、Timestamp、Nonce、Signature），详见 API签名规范。
• 签名验证：所有请求必须包含正确的签名。