Wallet/Virtual Bank Account

Create wallet/VIrtual Bank Account

Virtual Bank Accounts (or Virtual Accounts) are a special type of bank account that you can use to receive payments from your customers. Customers only need to make transfers from their preferred bank app into the virtual account assigned to them. Because this account is dedicated to a single customer, every payment made to that account will be associated with the customer's wallet....

Please note that this endpoint automatically generates a wallet with a Naira virtual account Attached to it.

https://api.blinqpay.io/api/v1/wallet/generate-blinqpay-wallet

{
   "customerName":"John Doe",
   "customerEmail":"[email protected]",
   "currencyCode":"NGN",
   "accountName":"John Test Acount",
   "accountReference":"MST-1234T405",
   "bankCode":"023",
   "walletAddress":"65342456789",
   "bvn":"22222222222"
}

Field	Required	Description
customerName	true	Customer's full name
customerEmail	true	Customer's email
currencyCode	false	Currency for the transaction. Value should be NGN defaults to NGN
accountName	true	The name you want to be attached to the wallet/virtual account. This will be displayed during name enquiry
accountReference	true	Your unique reference used to identify this wallet/virtual account
bankCode	true	This is the bank code of the bank providing the virtual bank account. supply 023 for Providus bank
walletAddress	true	Your unique address used to identify this wallet/virtual account
bvn	true	BVN of the customer the wallet/virtual account is being created for.

{
    "status": true,
    "message": "success",
    "data": {
        "id": 52,
        "subAccountId": "1vdNJK7Y4zxubIykEsBnjlVqw025hL56",
        "walletAddress": "Loslwjjeiodimmdskjs",
        "bankName": "Providus",
        "accountRefence": "MST-1234533",
        "virtualAccountName": "BLINQPAY(Amake Sade)",
        "virtualAccountNumber": "9989133833",
        "balance": 0
    }
}

Fetching wallet details

Wallet details can be fetched using either accountReference or walletAddress

https://api.blinqpay.io/api/v1/wallet/get-wallet-details?walletAddress={walletAddress}

Params	Description
walletAddress	Your unique address used to identify this wallet/virtual account

{
    "status": true,
    "message": "success",
    "data": {
        "walletAddress": "797a9cdcdac9589554529efe0fd3f050",
        "bankName": "Providus Bank",
        "virtualAccountNumber": "9978793482",
        "virtualAccountName": "BLINQPAY(Akinpelu Taofik)",
        "currencyCode": "NGN",
        "balance": "575.0000"
    }
}