跳转到主要内容
POST
/
v1
/
simulation
/
deposit
Simulate Deposit Creation
curl --request POST \
  --url https://api-sandbox.uqpaytech.com/api/v1/simulation/deposit \
  --header 'Content-Type: application/json' \
  --header 'x-auth-token: <api-key>' \
  --header 'x-idempotency-key: <x-idempotency-key>' \
  --data '
{
  "amount": 1000,
  "currency": "USD",
  "sender_swift_code": "WELGBE22",
  "receiver_account_number": "SG123456789012345678",
  "sender_account_number": "GB41TCCL12345634178496",
  "sender_country": "<unknown>",
  "sender_name": "UQPAY SG"
}
'
{
  "deposit_id": "72970a7c-7921-431c-b95f-3438724ba16f",
  "short_reference_id": "P220406-LLCVLRM",
  "amount": "10000",
  "currency": "USD",
  "deposit_status": "PENDING",
  "complete_time": "2024-03-21T17:17:32+08:00",
  "receiver_account_number": "12345678",
  "sender": {
    "sender_name": "UQPAY SG",
    "sender_country": "<unknown>",
    "sender_account_number": "12345678",
    "sender_swift_code": "WELGBE22"
  },
  "create_time": "2024-03-21T17:17:32+08:00"
}

Documentation Index

Fetch the complete documentation index at: https://developers-sandbox.uqpaytech.com/llms.txt

Use this file to discover all available pages before exploring further.

授权

​
x-auth-token
string
header
必填

The API token for login provided by UQPay.

请求头

​
x-on-behalf-of
string

Specifies the sub-account on whose behalf the request is made. This should be set to the account_id, which can be retrieved via the List Connected Accounts. If omitted or empty, the request is executed using the master account. More information at Connected Accounts.

​
x-idempotency-key
string<uuid>
必填

A unique identifier (UUID) used to maintain operation idempotency, ensuring that repeated executions of the same operation do not result in unintended effects or duplication. It helps preserve data consistency in the face of network errors, retries, or failures.

请求体

application/json
​
amount
number
必填

The amount to deposit.

示例:

1000

​
currency
string
必填

Currency in which money is held in the beneficiary's bank account. Three-letter ISO 4217 currency code.

Required string length: 3
示例:

"USD"

​
sender_swift_code
string
必填

Swift code of the beneficiary’s bank account.

Maximum string length: 30
示例:

"WELGBE22"

​
receiver_account_number
string

The receiver's account number.

示例:

"SG123456789012345678"

​
sender_account_number
string

The sender's account number.

示例:

"GB41TCCL12345634178496"

​
sender_country
any
​
sender_name
string

The customer-facing business name.

示例:

"UQPAY SG"

响应

200 - application/json

Deposit simulated successfully.

​
deposit_id
string
必填

The deposit id.

示例:

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

​
short_reference_id
string
必填

The reference generated by the system to identify the entity.

示例:

"P220406-LLCVLRM"

​
amount
string
必填

The amount of the deposit.

示例:

"10000"

​
currency
string
必填

Currency in which money is held in the beneficiary's bank account. Three-letter ISO 4217 currency code.

Required string length: 3
示例:

"USD"

​
deposit_status
enum<string>
必填

The status of the deposit.

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

"PENDING"

​
complete_time
string
必填

Completed time at which the object was created.

示例:

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

​
receiver_account_number
string
必填

Account number, mostly for non-european countries, either account_number or iban should be filled.

Only English letters (uppercase and lowercase) and digits are allowed; dashes or other special characters are not permitted.

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

"12345678"

​
sender
object
必填

Details of the sender who initiated the deposit.

​
create_time
string

Create time at which the object was created.

示例:

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