Fund Your Virtual Account

You can fund your virtual account with bank transfers, and the inflows will reflect in your balance. A web notification is sent when your virtual account is funded through bank transfers.

How to receive payments with Fincra virtual accounts

The following steps need to be taken in order to receive payments in your account:

1 - Virtual Account Creation

You can create a virtual account by using our create virtual account endpoints.

👍

Endpoints:

  • /profile/virtual-accounts/requests/: This endpoint lets you create a virtual account without the need for creating a sub-account on our platform.
  • /profile/virtual-accounts/business/{businessId}/sub-accounts/{subAccountId}/requests: This endpoint lets you create a virtual account for your sub-account.
{
     "currency": "NGN",
     "accountType": "individual",
     "KYCInformation": {
         "firstName": "john",
         "lastName": "doe"
     }
}
{
    "success": true,
    "message": "Thank you,  Billionaire. A NGN virtual account has been created for you",
    "data": {
        "status": "approved",
        "isActive": true,
        "accountNumber": "4231242764",
        "KYCInformation": {
            "firstName": "john",
            "lastName": "doe"
        },
        "accountInformation": {
            "accountNumber": "4231242764",
            "accountName": "john doe",
            "bankName": "WEMA BANK",
            "reference": "08baefab-4d53-4c81-a002-b81ac5d7488d"
        },
        "accountOpeningFee": 0,
        "pendingAdditionalInfoCount": 0,
        "isPermanent": false,
        "expiresAt": "2022-05-03T07:43:17.339Z",
        "reason": null,
        "monthlyVolume": null,
        "entityName": null,
        "paymentFlowDescription": null,
        "attachments": [],
        "meansOfId": [],
        "utilityBill": [],
        "virtualAccountType": "additional",
        "_id": "6249501511f92862ae12db02",
        "business": "61aa4e72cc67b6f04d97f874",
        "currency": "NGN",
        "accountType": "individual",
        "entityType": "main_account",
        "currencyType": "fiat",
        "createdAt": "2022-04-03T07:43:17.341Z",
        "updatedAt": "2022-04-03T07:43:17.341Z"
    }
}

2 - Topup

You provide your customer with the account details of the virtual account that you created. Then your customer will initiate a deposit to your account.

"accountInformation": {
            "accountNumber": "4231242764",
            "accountName": "john doe",
            "bankName": "WEMA BANK",
            "reference": "08baefab-4d53-4c81-a002-b81ac5d7488d"
  },

3 - Webhook notification

Listen for webhook events. We will send a notification to your webhook URL that indicates the status of the collection or payment received. Read our guide on securing and validating the webhook notification on your end.

{
  "event": "collection.successful",
  "data": {
    "business": "61602d2950139ad72e619a91",
    "virtualAccount": "61dc08222d2cc64836c5a591",
    "sourceCurrency": "NGN",
    "destinationCurrency": "NGN",
    "sourceAmount": 200000,
    "destinationAmount": 200000,
    "amountReceived": 199900,
    "fee": 100,
    "customerName": "Ultimate Global Ventures",
    "settlementDestination": "wallet",
    "status": "successful",
    "initiatedAt": "2022-03-28T07:15:19.402Z",
    "createdAt": "2022-03-28T07:15:19.403Z",
    "updatedAt": "2022-03-28T07:15:19.403Z",
    "reference": "f9121b33-7e15-409e-b588-36c6146d5823"
  }
}