Nigerian Transfers

The transfer api allows merchants to transfer funds to any Nigerian bank account.

1. Submit your KYC documents and get approved by the compliance team.
   
   

2. Switch to live mode to get a live key for live transactions.
   
   

3. Ensure you have enough funds in your wallet to initiate a transfer 

The request body requires a currency which defaults to NGN and the bank code which can be found in the Get Banks endpoint to retrieve a list of banks. The amount must be greater than zero. 

Ensure you provide a valid account number for the transfer. The account number would be resolved internally.

The request body contains an array of data that holds accounts of different customers.

Verify that all the account numbers are valid because the account number will be resolved internally.

Note: If you want to transfer to multiple accounts, prefer bulk transfer over single transfer to avoid rate limiting issues.

After sending the request, the response returns a batchId and the date the transfer was created.

Merchant can also query the Fetch Bulk Transfer by batchId endpoint that returns the total successful and failed count and the transfer data in an array. 

The preferred choice for confirming the transfer is by providing a webhook URL to receive payment notifications. When a transfer is successful, a webhook call is sent to the merchant webhook URL if provided on the dashboard.

The merchant can decide to do anything with the notification they receive. A successful transfer has a statusCode of “000”, so anything that is not “000” should be considered as not successful. 

Another option, but not best practice, is to pool at a specific interval to see if the transfer is successful by inspecting the Status of the transfer in the GetAll Transfer endpoint.

Note: Be careful when pooling to avoid 429 responses due to rate limiting features.