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 on our platform.
{
"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"
}
}
Updated 4 months ago