> For the complete documentation index, see [llms.txt](https://docs.calypso.money/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.calypso.money/payouts/how-to-create-a-single-payout-via-api.md).
# How to create a single payout via API
## **Process description**
{% stepper %}
{% step %}
Check account balance and ensure enough funds for payouts are available by using the method - [**\[POST\] account**](https://docs.calypso.money/api-reference/account-api)
{% endstep %}
{% step %}
You can pre-calculate commissions using a special feature - [**Commission pre-calculation**](https://docs.calypso.money/payouts/commission-pre-calculation)
{% endstep %}
{% step %}
Create the payout by using the method - [**\[POST\] payout/create**](https://docs.calypso.money/api-reference/payout-api#post-api-v1-payout-create)
* After creating a payout request, you will receive a webhook - PAYOUT\_CHANGE\_STATUS (state: CREATED)
{% endstep %}
{% step %}
If you have payout verification enabled, you will receive a webhook - PAYOUT\_CHANGE\_STATUS (state: PENDING\_CONFIRMATION)
* Once the payout is confirmed, you will receive a webhook - PAYOUT\_CONFIRMED
* If your payout was declined, you will receive a webhook - PAYOUT\_CHANGE\_STATUS (state: CANCELED)
{% endstep %}
{% step %}
Once your payout request is processed, you will receive a webhook - PAYOUT\_CHANGE\_STATUS (state: IN\_PROGRESS)
* If these payout are not validated before being created on the network, you will receive a webhook - PAYOUT\_VALIDATION\_ERROR
* If there are any issues with the payout and it is not processed, you will receive a webhook - PAYOUT\_CHANGE\_STATUS (state: FAILED)
{% endstep %}
{% step %}
**(Optional)** When the payout will receive a hash, you will receive a webhook - PAYOUT\_HASH\_RECEIVED
{% endstep %}
{% step %}
After a successful payment, you will receive a webhook - PAYOUT\_CHANGE\_STATUS (state: COMPLETED)
{% endstep %}
{% step %}
Get the data on the payout and its status by using the method - [**\[POST\] payout**](https://docs.calypso.money/api-reference/payout-api#post-api-v1-payout)
{% endstep %}
{% endstepper %}
### Sequence
Names of requests on the scheme indicate certain payout API methods.
### **Payout statuses**
Diagram nodes indicate payout statuses, arrows indicate processes a successful completion of which transfers a payout from one status to another.
| Status | Description |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| CREATED | A payout is created. |
| PENDING\_CONFIRMATION | A payout is created via UI and is awaiting confirmation from other process participants. |
| CONFIRMED | • A payout is created via UI and confirmed by other process participants.
• A payout created via API is automatically created with this status.
|
| CANCELED | A payout has been canceled by merchant. |
| IN\_PROGRESS | • Transaction for a payout is created and is awaiting to be sent to the network.
•Transaction for a payout is sent to the network to be sent to a block and is awaiting confirmation from nodes.
|
| FAILED | An error occurred when sending funds. There can be many reasons of the error. You may follow these remediation steps:
1. Wait a while and create a new similar payout.
2. Contact our technical support.
|
| COMPLETED | Funds are successfully credited to destination wallet. |
### **Request examples**
#### New Payout - [**\[POST\] payout/create**](https://docs.calypso.money/api-reference/payout-api#post-api-v1-payout-create)
**Request:**
```
{
"account": "text",
"timestamp": 1,
"payload": {
"depositAddress": "text",
"amount": 1,
"currency": "text",
"comment": "text",
"executionDate": "2025-10-29T11:20:32.438Z",
"idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
"externalId": "text"
}
}
```
\
**Response ****200 OK****:**
```
{
"id": "string",
"account": "string",
"depositAddress": "string",
"amount": 0,
"currency": "string",
"fee": 0,
"feePercentage": 0,
"state": "CREATION_IN_PROGRESS",
"createdDate": "2025-12-16T10:51:48.429Z",
"transactionHash": "string",
"comment": "string",
"executionDate": "2025-12-16T10:51:48.429Z",
"idempotencyKey": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"errors": {
"withdrawalErrors": [
{
"withdrawalId": "string",
"errors": [
{
"id": 0,
"status": "SUCCESS",
"errorResolved": true,
"errorMessage": "string"
}
]
}
]
},
"cancellation": {
"canceledByUserId": "string",
"canceledByFirstname": "string",
"canceledByLastname": "string",
"cancelMessage": "string"
},
"belongingType": "INTERNAL",
"externalId": "string"
}
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.calypso.money/payouts/how-to-create-a-single-payout-via-api.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.