Funds Transfer API

The Funds Transfer API allows authorized clients to transfer funds from a source account to a beneficiary account.

Endpoint

POST /api/transfer

Base URL: https://banking.finserv.com.ng

Authentication

This endpoint requires an API key.

Header	Value
x-api-key	Your assigned API key

Request

Headers

Key	Value
Content-Type	application/json
x-api-key	YOUR_SECURE_API_KEY

Body (JSON)

{
  "fromAccountNo": "1234567890",
  "toAccountNo": "9876543210",
  "amount": 10000,
  "description": "Payment for services"
}

Response

Success (200 OK)

{
  "transactionId": "TXN555888",
  "fromAccountNo": "1234567890",
  "toAccountNo": "9876543210",
  "amount": 10000,
  "description": "Payment for services",
  "status": "completed",
  "fromBalance": 240000.75,
  "toBalance": 60000.0
}

Error Responses

• 400 Bad Request → {"error": "From account, To account, and valid amount are required"}
• 404 Not Found → {"error": "Source or beneficiary account not found"}
• 401 Unauthorized → {"error": "API Key is missing"}
• 403 Forbidden → {"error": "Invalid API Key"}
• 400 Bad Request → {"error": "Insufficient funds"}

Example Usage

JavaScript (Client Side)

fetch("https://banking.finserv.com.ng/api/transfer", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": "YOUR_SECURE_API_KEY"
  },
  body: JSON.stringify({
    fromAccountNo: "1234567890",
    toAccountNo: "9876543210",
    amount: 10000,
    description: "Payment for services"
  })
})
.then(response => response.json())
.then(data => {
  console.log("Transaction ID:", data.transactionId);
  console.log("From Account:", data.fromAccountNo, "New Balance:", data.fromBalance);
  console.log("To Account:", data.toAccountNo, "New Balance:", data.toBalance);
  console.log("Amount:", data.amount);
  console.log("Description:", data.description);
  console.log("Status:", data.status);
})
.catch(error => console.error("Error:", error));

Postman

Set method to POST, URL to https://banking.finserv.com.ng/api/transfer, add headers, and body as shown above.