You can initiate a withdrawal request and our payouts API will validate your request before processing. Once it has been verified, a status report will be sent to you. The recipient will be notified of an awaiting payment.
Integrating Payout
To create payouts with code, copy the following and modify it:
curl -v -X POST https://api.chapa.dev/v1/payments/payouts \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <Access-Token>" \
-d '{
"sender_batch_header": {
"sender_batch_id": "2014021801",
"recipient_type": "EMAIL",
"email_subject": "You have money!",
"email_message": "You received a payment. Thanks for using our service!"
},
"items": [
{
"amount": {
"value": "90.87",
"currency": "USD"
},
"sender_item_id": "201403140001",
"receiver": "<receiver@example.com>"
},
{
"amount": {
"value": "112.34",
"currency": "Birr"
},
"sender_item_id": "201403140002",
"receiver": "<receiver2@example.com>"
},
{
"recipient_type": "PHONE",
"amount": {
"value": "95.32",
"currency": "Birr"
}
]
}'
This sample creates a payout for two recipients using their email or phone number. A successful request returns a status code of HTTP 201 created.
