Skip to main content
POST
Payout

Overview

This endpoint allows you to initiate a payout to a beneficiary account by providing the necessary details such as amount, source account, and beneficiary information.
Before creating a payout, you must validate the beneficiary bank account using the Resolve Account endpoint to ensure the account details are correct.
The minimum payout amount is ₦200.

Request

Method: POST
URL: /v1/payouts

Parameters

Request Body

The reference field must be unique for each new payout request. Using a duplicate reference will result in an error.
Example Reference Formats:
  • PAYOUT_USER123_20260119
  • PAY_INV_456789
  • SALARY_EMP001_JAN26

Response

Status Code: 200 OK
Content-Type: application/json

Example Response

Authorizations

apikey
string
header
required

Provide your API key in the 'apikey' header.

Headers

x-carbon-key
string
required

Body

application/json

Provide the required values for the request body.

amount
number
required

Provide amount

source
object
required
beneficiary
object
required
reference
string
required

Provide reference

meta_data
object
required
remark
string
required

Provide remark

Response

200 - application/json

OK

The response is of type object.