HOhoneycoin

Bank Transfer

Changed on

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

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

Request

  • Base URL
    https://api-v2.honeycoin.app
  • URL
    https://api-v2.honeycoin.app/api/b2b/fiat/deposit/bank-transfer
  • Auth
    API key in header Authorization

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

accountNamestring

Optional. Does not customize the virtual account name.

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"
    }
  }
}

Changes