---
title: "Create Issuing Transfer"
method: POST
path: "/v1/issuing/transfers"
tags: ["Transfers"]
---

# Create Issuing Transfer

`POST /v1/issuing/transfers`

Create a new issuing transfer by specifying the source account ID, destination account ID, currency, and other relevant information.

This API is specifically designed for fund transfers between the master account and its sub-accounts, and does not apply to cross-business-line or external transfers.

## 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 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)