v1

latestOpenAPI 3.1.02026-07-24620123.6 KB

Bank Transfer

This endpoint allows you to create temporary virtual bank accounts for accepting payments.

post/api/b2b/fiat/deposit/bank-transfer

Request body

amountinteger required

The amount to be paid to the virtual account

emailstring required

The email belonging to the user being charged

externalReferencestring required

A unique ID of your liking to reconcile transactions internally.

currencystring required

e.g KES, NGN

Response

200

successboolean

messagestring

Example response

{
  "success": true,
  "message": "Account created successfully.",
  "data": {
    "transactionId": "BFiR6ISntYyii9h1GUe6",
    "virtualAccount": {
      "accountNumber": "1250837235",
      "bankName": "78 Finance Company limited (Bank78)",
      "createdAt": "2025-09-05T20:35:21+00:00",
      "expiresAt": "2025-09-05T22:35:21.205979Z",
      "note": "Please make a bank transfer to 78 Finance Company limited (Bank78)",
      "amount": "150",
      "bankLogo": "https://test.com"
    }
  }
}