Domestic Banks Payouts

Good to know: The minimum payout amount to a domestic bank is KES. 100

Initiate domestic bank payout

POST https://api.chpter.co/v1/payout/domestic-bank

Headers

Name	Type	Description
Api-Key*	String	Your chpter Public Key
Content-Type	String	application/json

400: Bad Request invalid payload

{
    "message": "invalid payload",
    "success": false,
    "status": 400
}

200: OK payout initiated

{
    "message": "payout initiated",
    "success": false,
    "status": 200
}

401: Unauthorized merchant not activated

{
    "message": "merchant not activated. please contact [e-mail] ",
    "success": false,
    "status": 401
}

Good to know: This API uses webhooks to notify you of the payout status through the callback url.

Quick view

API Body

{
	"client_details": {
		"full_name": "John Doe",
		"phone_number": "254700123123",
		"email": "[e-mail]"
	},
	"destination_details": {
		"country_code": "KE",
		"bank_code": "1234",
		"bank_name": "Example Bank",
		"bank_account_name": "John Doe",
		"bank_account_number": "0123456789"
	},
	"transfer_details": {
		"currency_code": "KES",
		"amount": 200.5
	},
	"callback_details": {
		 "notify_customer": true,
		"payout_reference": "ABC123",
		"callback_url": "https://eozdpom307nca3.m.pipedream.net"
	}
}

Successfull Callback Response

{
    "message": "Success",
    "success": true,
    "status": 200,
    "amount": 100,
    "currency": "KES",
    "payout_reference": "ABCD123",
}

Failed Callback Response

{
    "message": "Payout failed contact [e-mail]",
    "success": false,
    "status": 200,
    "payout_reference": "ABCD123",
}