> For the complete documentation index, see [llms.txt](https://docs-card.musepay.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-card.musepay.io/reference/api-reference/fiat-payout-api/create-payout.md).

# Create Fiat Payout

{% hint style="warning" %}
Every request must contain [common parameters](/reference/api-reference/common-parameters.md).
{% endhint %}

Confirms a valid payout quote and starts payout processing.

<mark style="color:green;">`POST`</mark> `/v1/fiatpayout/payouts/create`

## Request Body

| Name          | Type   | Required | Description                                                                                                       |
| ------------- | ------ | -------- | ----------------------------------------------------------------------------------------------------------------- |
| order\_no     | String | Yes      | Quote `order_no` returned by the [Payout Quote](/reference/api-reference/fiat-payout-api/quotations.md) endpoint. |
| purpose\_code | String | Yes      | Remittance purpose code. Preserve leading zeroes.                                                                 |
| description   | String | No       | Payout description or reference. Do not include sensitive information.                                            |

The quote must belong to the requesting `partner_id`, must not be expired, and must still be in its initial state. A quote can be confirmed only once; repeated confirmation is rejected.

## Request Example

```json
{
  "order_no": "ORDER-1",
  "purpose_code": "02",
  "description": "monthly support"
}
```

## Response Body

| Name              | Type   | Description                                                                                   |
| ----------------- | ------ | --------------------------------------------------------------------------------------------- |
| order\_no         | String | Payout order number generated by MusePay.                                                     |
| request\_id       | String | Identifier supplied when the quote was created.                                               |
| pay\_amount       | String | Amount deducted from the source balance.                                                      |
| pay\_currency     | String | Source asset code.                                                                            |
| receive\_currency | String | Fiat currency received by the beneficiary.                                                    |
| receive\_amount   | String | Fiat amount received by the beneficiary.                                                      |
| fee\_amount       | String | Payout fee.                                                                                   |
| fee\_currency     | String | Currency in which the fee is charged.                                                         |
| exchange\_rate    | String | Exchange rate applied to the payout.                                                          |
| status            | Number | Current [order status](/reference/enums/order-status.md).                                     |
| failure\_reason   | String | Failure reason, when available.                                                               |
| create\_time      | Number | Order creation time, as a 13-digit Unix timestamp in milliseconds.                            |
| finish\_time      | Number | Order completion time, as a 13-digit Unix timestamp in milliseconds. Returned when available. |

```json
{
  "code": "200",
  "message": "success",
  "data": {
    "order_no": "ORDER-1",
    "request_id": "request-1",
    "pay_amount": "100.00",
    "pay_currency": "USDT",
    "receive_currency": "USD",
    "receive_amount": "98.75",
    "fee_amount": "1.25",
    "fee_currency": "USDT",
    "exchange_rate": "0.99",
    "status": 12,
    "failure_reason": null,
    "create_time": 1700000000000,
    "finish_time": null
  }
}
```
