---
agentTools:
  projectIndex: https://docs.blinqpay.io/llms.txt
---

# 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.

[block:code]
{
  "codes": [
    {
      "code": "https://api.blinqpay.io/api/v1/wallet/generate-blinqpay-wallet",
      "language": "http"
    }
  ]
}
[/block]

[block:code]
{
  "codes": [
    {
      "code": "{\n   \"customerName\":\"John Doe\",\n   \"customerEmail\":\"doe@john.com\",\n   \"currencyCode\":\"NGN\",\n   \"accountName\":\"John Test Acount\",\n   \"accountReference\":\"MST-1234T405\",\n   \"bankCode\":\"023\",\n   \"walletAddress\":\"65342456789\",\n   \"bvn\":\"22222222222\"\n}",
      "language": "json",
      "name": "Sample payload"
    }
  ]
}
[/block]

[block:parameters]
{
  "data": {
    "h-0": "Field",
    "h-2": "Description",
    "h-1": "Required",
    "0-0": "customerName",
    "1-0": "customerEmail",
    "2-0": "currencyCode",
    "3-0": "accountName",
    "4-0": "accountReference",
    "5-0": "bankCode",
    "6-0": "walletAddress",
    "7-0": "bvn",
    "0-1": "true",
    "1-1": "true",
    "2-1": "false",
    "3-1": "true",
    "4-1": "true",
    "5-1": "true",
    "6-1": "true",
    "7-1": "true",
    "0-2": "Customer's full name",
    "1-2": "Customer's email",
    "2-2": "Currency for the transaction. Value should be **NGN** defaults to NGN",
    "3-2": "The name you want to be attached to the wallet/virtual account. This will be displayed during name enquiry",
    "4-2": "Your unique reference used to identify this wallet/virtual account",
    "7-2": "BVN of the customer the wallet/virtual account is being created for.",
    "6-2": "Your unique address used to identify this wallet/virtual account",
    "5-2": "This is the bank code of the bank providing the virtual bank account. supply 023 for Providus bank"
  },
  "cols": 3,
  "rows": 8
}
[/block]

[block:code]
{
  "codes": [
    {
      "code": "{\n    \"status\": true,\n    \"message\": \"success\",\n    \"data\": {\n        \"id\": 52,\n        \"subAccountId\": \"1vdNJK7Y4zxubIykEsBnjlVqw025hL56\",\n        \"walletAddress\": \"Loslwjjeiodimmdskjs\",\n        \"bankName\": \"Providus\",\n        \"accountRefence\": \"MST-1234533\",\n        \"virtualAccountName\": \"BLINQPAY(Amake Sade)\",\n        \"virtualAccountNumber\": \"9989133833\",\n        \"balance\": 0\n    }\n}",
      "language": "json",
      "name": "Sample response"
    }
  ]
}
[/block]

## Fetching wallet details

Wallet details can be fetched using either **accountReference** or **walletAddress**

[block:code]
{
  "codes": [
    {
      "code": "https://api.blinqpay.io/api/v1/wallet/get-wallet-details?walletAddress={walletAddress}",
      "language": "http"
    }
  ]
}
[/block]

[block:parameters]
{
  "data": {
    "h-0": "Params",
    "0-2": "Your unique address used to identify this wallet/virtual account",
    "1-2": "Your unique reference used to identify this wallet/virtual account",
    "0-0": "walletAddress",
    "1-0": "accountReference",
    "h-2": "Description",
    "0-1": "Your unique address used to identify this wallet/virtual account",
    "1-1": "Your unique reference used to identify this wallet/virtual account",
    "h-1": "Description"
  },
  "cols": 2,
  "rows": 1
}
[/block]

[block:code]
{
  "codes": [
    {
      "code": "{\n    \"status\": true,\n    \"message\": \"success\",\n    \"data\": {\n        \"walletAddress\": \"797a9cdcdac9589554529efe0fd3f050\",\n        \"bankName\": \"Providus Bank\",\n        \"virtualAccountNumber\": \"9978793482\",\n        \"virtualAccountName\": \"BLINQPAY(Akinpelu Taofik)\",\n        \"currencyCode\": \"NGN\",\n        \"balance\": \"575.0000\"\n    }\n}",
      "language": "http",
      "name": "Sample Response"
    }
  ]
}
[/block]