跳转到主要内容
POST
Simulate Authorization

授权

x-auth-token
string
header
必填

由 UQPay 提供的登录 API Token。

请求头

x-on-behalf-of
string

指定代表哪个子账户发起请求。应设置为 account_id,该值可通过 List Connected Accounts 接口获取。若省略或为空,则请求以主账户身份执行。 更多信息参见 关联账户

x-idempotency-key
string<uuid>
必填

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

请求体

application/json
card_id
string
必填

卡片的唯一标识符。

示例:

"c0cef051-29c5-4796-b86a-cd5b684bfad7"

transaction_amount
number
必填

要模拟的交易金额。

示例:

10

transaction_currency
string
必填

交易币种。

示例:

"USD"

merchant_name
string
必填

商户名称

示例:

"Orchard Central"

merchant_category_code
string
必填

商户经营的商户类别代码(MCC)。只能为 5734

示例:

"5734"

响应

200 - application/json

成功模拟授权。

card_id
string
必填

卡片的唯一标识符。

示例:

"c0cef051-29c5-4796-b86a-cd5b684bfad7"

card_number
string
必填

脱敏卡号

示例:

"************5668"

cardholder_id
string<uuid>
必填

持卡人的唯一标识符。

示例:

"7c4ff2cd-1bf6-4aaa-bf16-266771425011"

transaction_id
string<uuid>
必填

交易的唯一标识符。

示例:

"5135e6cc-28b6-4889-81dc-3b86a09e1395"

transaction_type
enum<string>
必填

被模拟的交易类型。

可用选项:
AUTHORIZATION,
REFUND,
REVERSAL
示例:

"AUTHORIZATION"

card_available_balance
number
必填

卡片可用余额。

示例:

2506.26

authorization_code
string
必填

授权码

示例:

"856268"

billing_amount
number
必填

账单金额

示例:

70.25

billing_currency
string
必填

账单币种

示例:

"SGD"

transaction_amount
number
必填

交易金额

示例:

100.25

transaction_currency
string
必填

交易币种

示例:

"USD"

transaction_time
string
必填

交易发生时间

示例:

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

failure_reason
string
必填

交易失败原因。

示例:

"1107 - Invalid CVV2"

transaction_status
enum<string>
必填

表示交易生命周期所处阶段的高层状态。

可用选项:
APPROVED,
DECLINED
示例:

"APPROVED"

posted_time
string

交易入账时间

示例:

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

merchant_data
object

本次交易涉及的商户详情(如杂货店、电商网站等)。