---
title: "Create Transfer"
method: POST
path: "/v1/transfer"
tags: ["Transfers"]
---

# Create Transfer

`POST /v1/transfer`

Creates a new internal transfer between accounts, typically used for moving funds between a master account and its sub-accounts under the **Banking** system.  
Please note: this API is **only applicable to Banking-related accounts**, and does **not** apply to internal transfers within the **Issuing** system

## Headers

- `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 creation 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)