🇳🇬Collection Nigeria

This endpoint allows you to initiate a collection to Nigeria with YoguPay . Collections are done via Bank Transfer.

For Nigeria, our API responds with a redirect url where a mechant can redirect a customer. We also return the bank account details incase the merchant wishes to create a custom checkout page.

Create a Collection to Nigeria

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_NG)
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., NGN).
debitor_country_code	string	Country code (e.g., NG).
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_NG",
  "debitor_name": "John Doe",
  "debitor_account": "XV34387",
  "debitor_mobile": "233540000000",
  "debitor_currency_code": "NGN",
  "debitor_country_code": "NG",
  "reference_number": "43434343N",
  "amount": 20,
  "callback_url":"https://sandbox.yogupay.io/webhook-example"
}

Successful Response

Failed Response