• English
  • Virtual Account

    Product introduction

    Virtual Account(VA) is a comprehensive account service. It helps the same merchant to open multiple virtual accounts which will help them manage funds for different customers or business needs. Each virtual account has a unique externally identified account number, which supports related capital transactions with major bank accounts in Nigeria.

    The virtual account does not have the balance function. Collections made through the virtual account will be automatically settled in the balance of your merchant's main account. Virtual account information will also be included in all transaction histories. This makes it easier for you to centrally manage funds and improve the efficiency of reconciliation.

    Note: Businesses that requires virtual account service need to validate the personal BVN information of their customers before a virtual account can be generated.\

    Necessary preparations before access

    Follow the following procedure to complete the registration and product application of the merchant account, obtain and upload the corresponding key for subsequent development and access.

    Guidelines For Merchant Access

    Product logic description

    Description of program interaction time series Logic

    Product examples

    Virtual account management

    Query the status and information of the created virtual account, and enable and disable it.

    Path:Web Business -> Pay-In -> Virtual Account -> Management.

    Pay in order notification Notify URL configuration

    Configured the Notify URL to receive the pay in order notification.

    Path:Web Business -> Pay-In -> Virtual Account -> Webhook

    API product list

    The Basics of Access

    interface namedescription
    Create Virtual AccountCreate a virtual account
    Update Virtual Account's StatusUpdate the status of a virtual account
    Delete Virtual AccountDelete a virtual account, which cannot be used permanently after deletion.
    Query Virtual AccountQuery the status and information of a virtual account
    Single Query Pay In OrderAccording to the order no,query the status of a single Pay-in order and related parameters, including transfers to the virtual account and to the merchant's balance.
    Bulk Query Pay In OrderAccording to the time range,query the status of Pay-In orders and related parameters in batches, including transfers to the virtual account and to the merchant's balance.
    Pay In Order NotificationPalmPay system notifies merchants of pay in order results, including transfers to the virtual account and to the merchant's balance.