🇰🇪Collection Kenya

This endpoint allows you to initiate a collection to Kenya with YoguPay . Collections are done via Mobile Money

Create a Collection to Kenya

POST /directdebit

Headers

Name	Value
Content-Type	application/json
Token	token

Body

Name	Type	Description
route_name	string	Payment route to use (e.g., TRANSFER_KE)
debitor_name	string	Debitor/customer full name.
debitor_account	string	Debitor account identifier (often MSISDN or account number depending on route)
debitor_mobile	string	Debitor mobile number (MSISDN)
debitor_currency_code	string	Currency code (e.g., KES).
debitor_country_code	string	Country code (e.g., KE).
reference_number	string	Unique reference for idempotency/reconciliation
amount	number	Amount to debit/collect.
callback_url	string	URL the system will call asynchronously with status updates

Keep reference_number unique to avoid duplicates.

callback_url should be publicly reachable if callbacks originate outside your network.

Request & Response

Request

{
  "route_name": "TRANSFER_KE",
  "debitor_name": "John Doe",
  "debitor_account": "XV34387",
  "debitor_mobile": "2547######",
  "debitor_currency_code": "KES",
  "debitor_country_code": "KE",
  "reference_number": "43434343N",
  "amount": 1001,
  "callback_url":"https://sandbox.yogupay.io/webhook-example"
}

Successful Response

Failed Response