Bank Transfer

Send money to a Nigerian bank account.

POST {{ BASE_URL }}/v1/corporate/transfer

Body Parameters

Property	Data Type	Description	Example	Required
type	string	The type of transfer you want to initiate. The value here will be account	"account"	Yes
amount	number	The amount you want to transfer	2000	Yes
bank	object	The bank details object. This should contain the accountNo and bankCode	N/A	Yes
bank.accountNo	string	The recipient account number	"0252872742"	Yes
bank.bankCode	string	The sort code of the recipient bank. You can get list of banks using the List Banks endpoint.	"058"	Yes
pin	string	Your 4-digit transaction PIN	"0000"	Yes
reference	string	Your preferred transaction reference	"txref_09376384GH"	No
saveBank	boolean	Specify if you want to add bank to your list of beneficiaries.	true	No

Node.js

import Axios from 'axios';

// set the api url
const API_URL = `${BASE_URL}/v1/corporate/transfer`;

// define request data
const data = {
    type: "account",
    amount: 2000,
    bank: {
        accountNo: "0252872742",
        bankCode: "058"
    },
    pin: "0000",
    reference: "txref_09376384GH",
    saveBank: false
}

// make request using axios
Axios({
    method: "POST",
    url: `${API_URL}`,
    headers: {
        lg: 'en',
        ch: 'web'
        Authorization: `Bearer ${API_KEY}`,
        'Content-Type': 'application/json',
    },
    data: data
}).then((resp) => {
    console.log(resp)
}).catch((err) => {
    console.log(err)
})

Response

{
    "error": false,
    "errors": [],
    "data": {
        "reference": "TSXb9d80447540c41f9",
        "accountName": "AGBELEYE OLUWATOBI EMMANUEL",
        "accountNo": "0252872742",
        "bankCode": "058",
        "amount": 2000
    },
    "message": "successful",
    "status": 200
}