跳转到主要内容
POST
Simulate Deposit Creation

授权

x-auth-token
string
header
必填

由 UQPay 提供的登录 API Token。

请求头

x-on-behalf-of
string

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

x-idempotency-key
string<uuid>
必填

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

请求体

application/json
amount
number
必填

待充值的金额。

示例:

1000

currency
string
必填

受益人银行账户中持有资金的币种。三位字母 ISO 4217 币种代码。

Required string length: 3
示例:

"USD"

sender_swift_code
string
必填

受益人银行账户的 SWIFT 代码。

Maximum string length: 30
示例:

"WELGBE22"

receiver_account_number
string

收款方的账号。

示例:

"SG123456789012345678"

sender_account_number
string

汇款方的账号。

示例:

"GB41TCCL12345634178496"

sender_country
any
sender_name
string

面向客户展示的商户名称。

示例:

"UQPAY SG"

响应

200 - application/json

充值模拟成功。

deposit_id
string
必填

充值 ID。

示例:

"72970a7c-7921-431c-b95f-3438724ba16f"

short_reference_id
string
必填

系统生成的用于标识该实体的编号。

示例:

"P220406-LLCVLRM"

amount
string
必填

充值的金额。

示例:

"10000"

currency
string
必填

受益人银行账户中持有资金的币种。三位字母 ISO 4217 币种代码。

Required string length: 3
示例:

"USD"

deposit_status
enum<string>
必填

充值的状态。

可用选项:
PENDING,
COMPLETED,
FAILED
示例:

"PENDING"

complete_time
string
必填

对象创建的完成时间。

示例:

"2024-03-21T17:17:32+08:00"

receiver_account_number
string
必填

账号,多用于非欧洲国家/地区,account_number 与 iban 须填写其一。

仅允许英文字母(大小写)和数字;不允许使用短横线或其他特殊字符。

Maximum string length: 60
Pattern: ^[a-zA-Z0-9]*$
示例:

"12345678"

sender
object
必填

发起该充值的汇款方信息。

create_time
string

对象创建的创建时间。

示例:

"2024-03-21T17:17:32+08:00"