Overview

This API empowers your business to efficiently send money and process payouts for business operations, including employee salary disbursements, vendor payments, and other financial transactions.

• Purpose: Disburse funds to mobile money wallets for payroll, vendor payments, and other financial operations.
• Target Audience: Merchants, fintechs, and developers integrating mobile money payout functionality.

Quickstart: MoMo Payout

1. Obtain your Bearer Token and generate the required signature and X-Hash.
2. Send a POST request to the payout endpoint with the required parameters.
3. Parse the response to get the transaction status and details.

Endpoint Reference

Request Body

Channel Codes

Request Headers

Example Request

curl --location --request POST 'https://base-url-here.com/api/v2/payment/' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Signature: xxx' \
--header 'x-hash: xxxxxx' # Generated X-Hash header \
--data-raw '{
    "wallet_no": "xxxxxxx",
    "reference": "TRXXXX79",
    "acc_name": "JOHN DOE",
    "acc_no": "2547XXXXXXXX",
    "currency": "KES",
    "amount": 10,
    "channel": 100003,
    "email": "johndoe@gmail.com",
    "description": "Pay for order #23243222",
    "result_url": "https://webhook.site/947e8f48-c03a-4717-a2dd-8cdb2f64e897"
}'

Success Response

{
    "success": true,
    "message": "Successfully initiated",
    "data": {
        "transaction_id": "056341150381",
        "status": "PENDING",
        "status_description": "Transaction Initiated successfully",
        "date": "2024-02-17 13:34:02 PM"
    }
}

Security Best Practices

• Always use HTTPS for all API requests.
• Keep your private key secure and never share it.
• Verify the signature and X-Hash on the server side for every request.

Terms of Use & Legal

By using this API, you agree to our Terms of Service and Privacy Policy. Do not share sensitive data or credentials.