PIS API v1.0
HomeCreate AccountLogin
  • Getting Started
  • Recommendations
  • Collections
    • Virtual Bank Account
      • Create Account
      • Get Account
      • Fetch Accounts
      • Webhooks
    • Sub-accounts
    • Installments
  • Payouts
    • Bank Transfer
      • Initiate Transaction
      • Verify Transaction
      • Fetch Transactions
  • Misc
    • Get Balance
    • Get Account Details
    • Resolve Account
    • Get Bank List
Powered by GitBook
On this page

Was this helpful?

  1. Collections
  2. Virtual Bank Account

Create Account

POST https://api.pis.ng/v1.0/collections/vba/create

Headers

Name
Type
Description

Secret-Key*

string

Your PIS Secret Key.

Content-Type*

string

application/json

Request Body

Name
Type
Description

reference*

string

A unique reference (100 chars max). This would be used to access your account.

firstName*

string

The customer's first name.

lastName*

string

The customer's last name.

email*

string

The customer's email.

phone*

int

The customer's phone number.

accountName

string

The customer's account name (30 chars max). If empty, we would use the customer's first and last name as the account name.

bvn*

int

The customer's BVN

callbackUrl

string

Your callback URL. We'll notify you here if provided.

{
    "code": 200,
    "status": "success",
    "message": "Successful",
    "data": {
        "accountNumber": "2057488657",
        "accountName": "PIS - ISIMPLIFY SERVICES",
        "bankName": "KUDA MICROFINANCE BANK"
    }
}
{
    "code": 401,
    "status": "error",
    "message": "Authorization required!",
    "data": null
}
{
    "code": 400,
    "status": "error",
    "message": "Bad Request",
    "data": null
}
{
    "code": 404,
    "status": "error",
    "message": "The endpoint you are trying to access does not exist.",
    "data": null
}
PreviousVirtual Bank AccountNextGet Account

Last updated 1 year ago

Was this helpful?