Create Transfer Recipients

This functionality enables you to create a virtual account on behalf of your customers. The assigned account number is unique to each customer.

In a nutshell

To send money from your integration, you need to collect the customer’s details to create a beneficiary.

A transfer recipient is a beneficiary created on your integration in order to allow you send money. Before sending money from your integration, you need to collect the customer’s details and use their details to create a transfer recipient.

Create Dedicated Account

POST {{ BASE }}/validate-recipient

--header 'Accept: application/json'
--header 'Authorization: Bearer {{  access_token }}'

Request Body

Below are the request body parameters 🎉

Name	Type	Description
bank_code	String	You can get the list of Bank Codes by calling the List Banks endpoint.
account_number	Number	Nigerian Uniform Bank Account Number. It represents bank accounts in Nigeria.

Response Body

{
	"status": true,
	"message": "Transfer recipient created successfully",
	"data": {
		"active": true,
		"createdAt": "2022-02-21T11:35:59.302Z",
		"currency": "NGN",
		"domain": "live",
		"email": "[e-mail]",
		"name": "Oluwasen Olajuwon",
		"recipient_code": "55356",
		"details": {
			"account_number": null,
			"account_name": null,
			"bank_code": "057",
			"bank_name": "Wema Bank"
		}
	}
}