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.

POST /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"
    }
}