Example Curl

curl --location 'https://api.korapay.com/merchant/api/v1/transactions/disburse' \
--header 'Content-Type: application/json' \
--data-raw '{
	"reference": "your-unique-transaction-reference-001",
	"destination": {
		"type": "bank_account",
		"amount": "100",
		"currency": "NGN",
		"narration": "Test Transfer Payment",
		"bank_account": {
			"bank": "033",
			"account": "0000000000"
		},
		"customer": {
			"name": "John Doe",
			"email": "johndoe@email.com"
		}
	}
}'

Example Response

{
  "status": true,
  "message": "transfer initiated successfully",
  "data": {
    "amount": "100.00",
    "fee": "2.50",
    "currency": "NGN",
    "status": "processing",
    "reference": "your-unique-transaction-reference-001",
    "narration": "Test Transfer Payment",
    "customer": {
      "name": "John Doe",
      "email": "johndoe@email.com",
      "phone": null
    }
  }
}


AUTHORIZATION (Bearer Token)
Token   sk_******


Mobile Money Payout API Integration

Example curl

curl --location 'https://api.korapay.com/merchant/api/v1/transactions/disburse' \
--header 'Content-Type: application/json' \
--data-raw '{
	"reference": "your-unique-transaction-reference-002",
	"destination": {
		"type": "mobile_money",
		"amount": "100",
		"currency": "KES",
		"narration": "Test Transfer Payment",
		"mobile_money": {
			"operator": "safaricom-ke",
            "mobile_number": "256700000000"
		},
		"customer": {
			"name": "John Doe",
			"email": "johndoe@email.com"
		}
	}
}'


Example Response

{
  "status": true,
  "message": "transfer initiated successfully",
  "data": {
    "amount": "100.00",
    "fee": "2.50",
    "currency": "KES",
    "status": "processing",
    "reference": "your-unique-transaction-reference-001",
    "narration": "Test Transfer Payment",
    "customer": {
      "name": "John Doe",
      "email": "johndoe@email.com",
      "phone": null
    }
  }
}