Loading...
Initiates a money transfer from the authenticated user's account to an external bank account. This endpoint handles transaction validation, fee calculation, balance verification, and creates a transaction history record upon successful transfer. Required Fields: nameEnquiryReference: Reference obtained from account validation amount: Amount to transfer (in NGN) bankCode: Code of the recipient's bank accountNumber: Recipient's account number narration: Description of the transaction transactionPin: User's transaction PIN for authorization
KEY | VALUE | DESCRIPTION |
---|---|---|
X-API-Key | X-API-Key | - |
X-API-Secret | X-API-Secret | - |
// Using fetch API
const response = await fetch("http://localhost:5000/api/v1/developer/transactions/transfer", {
method: "POST",
headers: {
"X-API-Key": "X-API-Key",
"X-API-Secret": "X-API-Secret"
},
body: JSON.stringify({
"nameEnquiryReference": null,
"amount": null,
"bankCode": null,
"accountNumber": null,
"narration": null,
"transactionPin": null
})
});
const data = await response.json();
console.log(data);
Parameter | Type | Required | Description |
---|---|---|---|
nameEnquiryReference | No | ||
amount | No | ||
bankCode | No | ||
accountNumber | No | ||
narration | No | ||
transactionPin | No |
{
"nameEnquiryReference": null
"amount": null
"bankCode": null
"accountNumber": null
"narration": null
"transactionPin": null
}
Success response
{
"statusCode": 200
"message": "Transfer successful"
"data" {
"sessionId": "SES123456789"
"amount": 5000
"fee": 50
"paymentReference": "PAY987654321"
"bankCode": "044"
"bankName": "Access Bank"
"status": "Completed"
"date": "2024-03-18T14:23:45.000Z"
}
}