Virtual Accounts

Virtual accounts contain unique account information (account number and bank) that allow Fincra merchants to receive payments from customers via bank transfer. With our virtual accounts, you can accept payments from Africa, Europe, the US, the UK, and anywhere in the world.

๐Ÿšง

Note

  • It is important to note that Virtual Bank Accounts do not store monetary value like regular bank accounts; they only provide a means for your customers to pay you and the funds get settled in your account balance, to check your account balance please see the balance API

Available Currencies

Virtual accounts are currently available in the following currencies :

Currency NameCurrency CodePayment SchemesAvailability
NairaNGNNIBBSYes
EUROEURSEPA, SEPA InstantYes
British PoundsGBPFPS, CHAPSNo

Types of Virtual Accounts

We can divide virtual account into two categories: Temporary virtual accounts and Permanent virtual accounts.

Temporary Virtual Accounts

Temporary virtual accounts are useful for receiving one-off payments. A use case for the temporary accounts is when a customer is at the check-out point, a temporary virtual account with an expiry time can be generated and provided to the customer to complete the checkout process.

To learn how to create temporary virtual accounts, please read this page

๐Ÿ“˜

Temporary Virtual Account Flow

  • You create a temporary virtual account with our API and provide your customer with the details of the account
  • The customer transfers funds to the account
  • A webhook is sent notifying you that payment has been received.

Permanent Virtual Accounts

Permanent virtual accounts are useful when creating an application where each user has a bank account number that can be used for funding their wallets on your platform. These accounts are static and can be used to receive payments subsequently.

To learn how to create permanent virtual accounts, please read this page

๐Ÿ“˜

Permanent Virtual Account Flow

  • You create a virtual account for the customer with our API and provide your customer with the details of the account.
  • The customer transfers funds to the virtual account created.
  • A webhook is sent notifying you that payment has been received.
  • You provide the product or service that you received payment for to the customer.

Technical Classification Of Virtual Accounts

By Funding

Our Virtual Accounts can be classified into two based on how they can be funded:

  • Main virtual accounts are corporate virtual accounts that belong to a registered merchant on Fincra and are the first corporate virtual accounts created by the merchant. Funds that come into the main virtual account can be fetched by the wallet top-up API.
  • After creating a main virtual account, a merchant may create any other virtual account. Payins made to these accounts can be retrieved using the payin API.

Note: All main accounts are corporate, however, additional accounts can be either corporate or individual.

By Entity

Our virtual accounts can also be classified according to whether they are used by an individual or a corporate entity.

S/NAccount TypeDescriptionAPI value
1IndividualThis virtual account is named and owned by an individual.individual
2CorporateThis virtual account is owned and can be used by a company or organization.corporate

{
    "dateOfBirth": "10-12-1993",
    "accountType": "individual",
    "currency": "NGN",
    "KYCInformation": {"firstName": "rita", "lastName": "general", "bvn": "090909909"}
}

Note: In the preceding examples, we specified the accountType as individual. Please include the 'accountType' field in your calls to the virtual account API.

Get Virtual Accounts Balance

It is important to note that Virtual Bank Accounts do not store monetary value like regular bank accounts. They only provide a means for your customers to pay you and the funds get settled in your account balance, to check your account balance please see the balance API