> For the complete documentation index, see [llms.txt](https://developer.redstonepgs.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.redstonepgs.com/api-documentation/payments/payout.md).

# Payout

This endpoint is used to initiate a payout process. It allows users to specify the amount to be paid out, the country for the transaction, and a narration for reference. Additionally, the momo\_phone\_number parameter is optional; if it is not provided, the payment will reflect in the merchant's momo account.

<mark style="color:green;">POST</mark>  /v1/payment/payouts/process

#### Headers

| Name       | Type   | Description               |
| ---------- | ------ | ------------------------- |
| secret-key | string | Your Redstone  secret key |
| public-key | String | Your Redstone  public key |

#### Request body

* amount (integer): The amount of money to be processed for the payout. This value must be a positive integer.
* countryId (string): A unique identifier for the country where the payout is being processed. This should correspond to a valid country ID.
* momo\_phone\_number (string, optional): The mobile money phone number to which the payout will be sent. If this is not provided, the payment will be credited to the merchant's momo account.
* narration (string: optional): A brief description or note regarding the payout. This helps in identifying the purpose of the transaction.

#### Request

For example, you can make a post request to the endpoint above and pass in the **raw json data** below.

```
{
    
    "amount":123,
    "countryId": "{{zambia_country_id}}",
    "momo_phone_number": "260********",
    "webhook_url": "https://webhook.site/99a3cf82-d235-465a-8c39-8a0105c63df4",
    "narration":"testing" //optional
}
```

#### Response

```
{
    "status": "success",
    "code": 200,
    "message": "payout queued successfully",
    "data": {
        "amount": 26,
        "message": "Payout is being processed by the provider",
        "reference": "PY_6c663231b92a4bbabdff4bcc1",
        "status": "processing"
    }
}
```