Payouts

This document goes over how you have the option to send money to multiple recipients using their email address or phone number.

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.com/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.


Invoice
Split Payments
Next →