Skip to main content
POST

授权

x-auth-token
string
header
必填

由 UQPAY 提供的登录 API Token。

请求头

x-on-behalf-of
string

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

x-idempotency-key
string
必填

本次申请的唯一键。仅在为同一账户重试相同请求时复用该键。输入规范化后,使用同一键提交不同的请求数据会返回错误。

Maximum string length: 64

请求体

application/json
country
enum<string>
必填

虚拟账户开户国家的两位国家代码。请使用接入指南列出的组合。系统会去除首尾空格,并接受小写输入。

可用选项:
SG,
DK,
GB,
DE,
AU,
LU,
BH
currency
enum<string>
必填

虚拟账户需要接收的三位币种代码。每次只能传一个值。系统会去除首尾空格,并接受小写输入。

可用选项:
SGD,
USD,
AUD,
CNH,
EUR,
GBP,
HKD,
JPY,
NOK,
AED,
NZD,
CHF,
CAD,
KWD,
MXN
payment_method
enum<string> | null

要评估的收款方式。传 LOCALSWIFT 时只评估一种;省略,或传 null、空字符串、仅空白字符时,分别评估两种方式。不要传 ALLAUTO

可用选项:
LOCAL,
SWIFT,
nickname
string | null

用于标记请求的可选名称。省略、为 null、为空或仅包含空白字符时按相同方式处理。申请接口和 Webhook 均不返回该值。

Maximum string length: 255
示例:

"Operating account"

响应

OK —— 虚拟账户申请已受理并进入异步处理。

data
object
必填