Transfer funds between Stablecoin Account and Global Account

Stablecoin Account API Publisher Disclaimer Transfers move fiat between the two UQPAY account systems: a transfer out sends funds from your Stablecoin Account to your Global Account, and a transfer in pulls funds from your Global Account into your Stablecoin Account. Together with deposits, conversions, and payouts, this closes the loop: crypto in → convert → transfer out → pay out from the Global Account (and the reverse for on-ramping customers).

Create a transfer

Call Create Transfer with the currency, amount, and direction:

curl -X POST https://api-sandbox.uqpaytech.com/api/v1/ramp/transfer \
  -H "x-auth-token: YOUR_API_TOKEN" \
  -H "x-idempotency-key: $(uuidgen | tr '[:upper:]' '[:lower:]')" \
  -H "Content-Type: application/json" \
  -d '{
    "currency": "USD",
    "amount": "100.50",
    "type": 4001,
    "reason": "Business transfer"
  }'

Field	Required	Description
`currency`	Yes	Fiat currency of the transfer, for example `USD`
`amount`	Yes	Amount, as a decimal string
`type`	Yes	Direction: `4001` = transfer out (Stablecoin Account → Global Account); `4000` = transfer in (Global Account → Stablecoin Account)
`reason`	No	Transaction remark

Response:

{
  "code": 200,
  "message": "Success",
  "data": {
    "order_id": "3c9e22ba-7b5e-4b7c-b92e-197d0406b86b",
    "short_order_id": "TO260123-JZBHC9IA",
    "order_status": "Pending",
    "order_type": "Transfer Out",
    "amount": 100,
    "currency": "USD",
    "processing_fee": 0,
    "reason": "testAPI",
    "create_time": "2026-01-23 13:12:27 +08:00",
    "complete_time": ""
  }
}

If the order fails at submission, the response’s message field inside data carries the failure reason.

Track the transfer

Transfer status flows through Submitted / Pending to Success, Failed, or Submit Failed. Updates arrive on the Transfer webhook:

Event type	Meaning
`ramp.transfer.submitted`	Transfer request submitted
`ramp.transfer.pending`	Transfer in progress
`ramp.transfer.success`	Transfer completed
`ramp.transfer.failed`	Transfer failed
`ramp.transfer.submitted.failed`	Transfer submission failed

Query a single order with Retrieve Transfer using the long order_id. Transfers also appear in the unified ledger as Transfer In / Transfer Out — see Manage asset balances.

After a transfer out completes, the funds are available in your Global Account — see the Global Account guide for what you can do with them there.

Create Transfer API
Retrieve Transfer API
Transfer webhook
Convert currencies — convert crypto to fiat before transferring out

Getting Started

Assets & Balances

Deposits

Withdrawals

Conversions & Transfers

Reference

Transfer funds between Stablecoin Account and Global Account

Create a transfer

Track the transfer

​Create a transfer

​Track the transfer

​Related

Create a transfer

Track the transfer

Related