Skip to main content
This endpoint allows you to send payouts in Nigerian Naira (NGN) to recipients in Nigeria. The request must include the recipient’s details, payment method, and a valid quoteId.

Endpoint

POST: https://sandboxapi.me-cash.com/v2/payout

Request Details

Headers

Include these headers in your request:

Request Examples

Note: Recipient’s name and Bank name must match the details in the Bank list endpoint and Account enquiry endpoint.

Request Body

The following fields are required when making an NGN payout request:

Success Response (200 OK)

If the payout is successfully created, the API returns the following response:
copy

Response Breakdown


Error Handling


Best Practices

✅ Ensure quoteId is valid and linked to an existing quote.
✅ Confirm that the recipient’s bank account number and bank code are correct.
✅ Use a valid API key in the headers.
✅ Handle error responses correctly in your integration.
Testing Failed Payouts: In the sandbox environment, you can simulate a failed payout by setting "remark": "fail" in your request. This triggers a payout.failed webhook, allowing you to test your error handling.