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.