> ## Documentation Index
> Fetch the complete documentation index at: https://developers.uqpay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Transfer funds between Stablecoin Account and Global Account

> Move fiat between your Stablecoin Account and your UQPAY Global Account in either direction.

[Stablecoin Account API Publisher Disclaimer](/stablecoin-account/v1.6/guide/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](/stablecoin-account/v1.6/api-reference/create-transfer) with the currency, amount, and direction:

```bash theme={null}
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:**

```json theme={null}
{
  "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](/stablecoin-account/v1.6/webhooks/transfer):

| 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](/stablecoin-account/v1.6/api-reference/retrieve-transfer) using the long `order_id`. Transfers also appear in the unified ledger as `Transfer In` / `Transfer Out` — see [Manage asset balances](/stablecoin-account/v1.6/guide/manage-asset-balances).

<Tip>
  After a transfer out completes, the funds are available in your Global Account — see the [Global Account guide](/global-account/v1.6/guide/overview) for what you can do with them there.
</Tip>

## Related

* [Create Transfer API](/stablecoin-account/v1.6/api-reference/create-transfer)
* [Retrieve Transfer API](/stablecoin-account/v1.6/api-reference/retrieve-transfer)
* [Transfer webhook](/stablecoin-account/v1.6/webhooks/transfer)
* [Convert currencies](/stablecoin-account/v1.6/guide/convert-currencies) — convert crypto to fiat before transferring out