跳转到主要内容
POST
Create Virtual Account

授权

x-auth-token
string
header
必填

由 UQPay 提供的登录 API Token。

请求头

x-on-behalf-of
string

指定代表哪个子账户发起请求。应设为 account_id,可通过查询关联账户列表获取。如果省略或留空,请求将使用主账户执行。 更多信息参见关联账户

x-idempotency-key
string<uuid>
必填

用于保持操作幂等性的唯一标识符(UUID),确保同一操作的重复执行不会产生意外影响或重复。它有助于在网络错误、重试或失败时保持数据一致性。

x-request-id
string

请求的自定义标识符,最多 64 个字符。如果提供,该值将在关联的 webhook 事件中以 request_id 返回。

Maximum string length: 64

请求体

application/json
currency
string
必填

多个币种以逗号连接。币种代码遵循 ISO_4217

示例:

"USD,SGD"

payment_method
enum<string>

需要指定支付方式,以确保针对该支付方式采集并校验准确的银行信息。

  • LOCAL:通过本地清算系统的境内支付网络处理的付款。
  • SWIFT:通过 SWIFT 网络处理的跨境国际付款。
可用选项:
LOCAL,
SWIFT
示例:

"LOCAL"

响应

200 - application/json

VA 账户创建成功。

message
string
示例:

"SUCCESS"