---
title: "Create a payout order"
method: POST
path: "/open-api/v3/scan2pay/orders/payout"
tags: ["Orders"]
---

# Create a payout order

`POST /open-api/v3/scan2pay/orders/payout`

Creates a payout order by submitting the customer, amount, currency,
and either QR data or structured recipient information. Returns the
Interlace order number and the current order status.

## Request body

- CreatePayoutOrderReqDTO
  - `customerId` string, required — Numeric string representing a 64-bit Interlace customer identifier
  - `clientTradeNo` string, required — Client-generated order number, unique for idempotency
  - `fiatAmount` string, required — Payout amount in decimal string format, up to 6 decimal places
  - `fiatCurrency` string, required — Payout currency (ISO 4217)
  - `country` string, required — Payout country code (ISO 3166-1 alpha-2)
  - `qrMode` 'RAW' | 'DATA' | 'TOKEN' — QR input mode. RAW = raw QR payload, DATA = structured QR or recipient data, TOKEN = QR parse token returned by the QR parse API
  - `qrToken` string — QR parse token returned by the QR parse API. Required when qrMode is TOKEN
  - `qrInfo` SellerOrderQrInfoRequest — QR data supplied with the order
    - `content` string — Raw QR payload, used when qrMode is RAW
    - `qrType` string — QR type identifier, for example ph.ppmi.p2m
    - `qrData` object — Structured QR data, including country- or channel-specific fields
  - `recipient` SellerOrderRecipientInfoRequest — Structured recipient data
    - `recipientName` string — Recipient name, typically the merchant or beneficiary name extracted from the QR
    - `bankCode` string — Recipient bank or payment institution code
    - `bankName` string — Recipient bank or payment institution name
    - `bankAccountNumber` string — Recipient bank account number or wallet identifier
  - `extendInfo` object — Client-defined metadata echoed in subsequent order queries; not used for payment routing

## Response `200`

Successful operation

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.dev/interlace/apis/core-resource.md) · [All operations](https://skmtc.dev/interlace/apis/core-resource/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/interlace/core-resource/revisions/29c08a4da357/schema)