API
  • Introduction
  • Authentication
  • Error Handling
  • API ENDPOINTS
    • Payment
    • Invoices
      • Create Invoice
      • Re-send Invoice
      • Get Invoice - customerEmail
      • Get Invoice - invoiceNo
      • Get Invoice - orderNo
    • Payment Link
      • Create Link
      • Get Link
      • Update Link
      • Delete Link
    • Charge Token
      • Create Token
      • Get Token
      • Charge Token
      • Bulk Charge
      • Query Bulk Charge with BacthId
    • Subscriptions
      • Create Subscription
      • Charge Subscription
      • Get Customer Subscription
      • Update Customer Subscription
      • Get Merchant Subscription
    • Virtual Account
      • Create Virtual Account
      • Get Virtual Account
      • Delete Virtual Account
      • Get Payment
    • Pay with Transfer
    • Pay with USSD
    • Mobile Money Payments
    • Bank Account Payments
    • Card Payment
      • Initializing a Card Payment
      • Scenario 1 (Verve Card Type)
      • Scenario 2 (Master Card and Visa Card Type)
      • Scenario 3
Powered by GitBook
On this page
  1. API ENDPOINTS
  2. Virtual Account

Create Virtual Account

Create a virtual accounts your customers to make payments

/vitrual-accounts

POST https://seerbitapi.com/api/v2/virtual-accounts

This endpoint allows you to create virtual account numbers

Headers

Name
Type
Description

authorization*

String

Bearer token

Request Body

Name
Type
Description

publicKey*

String

merchant public key

fullName*

String

name to be on the account number

bankVerificationNumber

String

owners BVN to match fullName

currency*

String

currency to be set to NGN

reference*

String

unique reference to identify the virtual account

email

String

owners email

curl --location 'https://seerbitapi.com/api/v2/virtual-accounts' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ENCRYPTED_KEY' \
--data-raw '{
    "publicKey": "YOUR_PUBLIC_KEY",
    "fullName": "Jane Smith",
    "bankVerificationNumber":"",
    "currency": "NGN",
    "country": "NG",
    "reference": "FIRST_VIRTUAl_17",
    "email": "js@emaildomain.com"
}'
{
    "status": "SUCCESS",
    "data": {
        "code": "S20",
        "payments": {
            "reference": "FIRST_VIRTUAl_7",
            "walletName": "SEERBIT(Business Name)",
            "bankName": " 9PAYMENT SERVICE BANK",
            "accountNumber": "Account Number"
        },
        "message": "Account created "
    }
}
PreviousVirtual AccountNextGet Virtual Account

Last updated 8 months ago