---
title: "Create Transfer"
method: POST
path: "/v1/ramp/transfer"
tags: ["Transfer (Out/In)"]
---

# Create Transfer

`POST /v1/ramp/transfer`

Initiate an XUSD fund transfer from the Stablecoin Account to the Issuing account (Type: transfer-out: 4001). Fiat transfers between the Stablecoin Account and Global Account are no longer supported. [  *Stablecoin Account API Publisher Disclaimer*](/stablecoin-account/v1.6/guide/stablecoin-account-api-publisher-disclaimer)

## Headers

- `x-on-behalf-of` string
- `x-idempotency-key` string, uuid

## Request body

- TransferCreateRequest
  - `currency` string, required — Wallet currency for this transfer. Only `XUSD` is supported.
  - `amount` string, required — Amount for this transfer
  - `type` 4001, required — Transfer type. Only `4001` (transfer out to the Issuing account) is supported.
  - `reason` string — Transaction remark

## Response `200`

Transfer created successfully

- TransferCreateResponse
  - `code` integer, required
  - `message` string, required
  - `data` TransferCreateData, required — Create Transfer response (section 4.2.1)
    - `order_id` string, required — Order ID (long format)
    - `short_order_id` string, required — Order ID (short format)
    - `order_status` 'Submitted' | 'Pending' | 'Failed' | 'Success' | 'Submit Failed', required — Order status
    - `order_type` string, required — Order type
    - `amount` number, required — Amount
    - `currency` string, required — Currency
    - `processing_fee` number, required — Processing fee
    - `reason` string — Remark
    - `create_time` string, required — Creation time
    - `complete_time` string — Completion time
    - `message` string — Failure reason if request failed

---

[API](https://skmtc.dev/uqpay/apis/authentication-api.md) · [All operations](https://skmtc.dev/uqpay/apis/authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/uqpay/authentication-api/revisions/cef532a10777/schema)