🏛️ Create Virtual Static Account

To begin integrating with HeedPay, you'll first need to create an account. Click here to sign up and get started! Once you've signed up, you'll need to complete the authentication process to ensure the security of your account. After authentication, you’ll gain full access to the platform layout options.

How the Customer Reserved Account Works

A Reserved Account is a specialized dynamic ledger layer within HeedPay that enables merchants to hold and manage customer funds in a secure, structured manner. This structure is useful for merchants needing isolated allocation contexts for operations like processing deposits, tracking upfront balances, or reconciling transactions tied directly to an identity profiles matrix.

1. Account Provisioning

To deploy a dynamic balance block context for a user profile, your server handles a single secure transmission targeting our provisioning system. This instantly registers the dynamic layer target securely assigned on your platform routing configuration profile.

2. Accepting Inbound Settlement Transfers

Once provisions complete successfully, users handle manual deposits natively using localized mechanisms (direct wire clearings, bank gateways, mobile channels, alternative instruments) straight through to target destination layers separated from base platform structural funds context safely.

Integration Endpoint

The dynamic core parameters required to route an asset pool assignment request.

POST https://heedpay.com.ng/api/create-virtual-account

Required Request Headers

Header Key Value Example
Authorization heedpay9g4efbt45hg0d553f297b703fb510dd46e3e5cc
Content-Type application/json
Accept application/json

JSON Request Body

CONTENT-TYPE: APPLICATION/JSON
{ "refId": "2026327372bGDYE3GD7YHDRESERVED", // Must start with YYYYMMDD and be 12-30 characters (Required) "email": "Heedpay@gmail.com", // Customer email identifier (Required) "account_name": "Heedtech Mr-Account", // Target ledger naming structure (Required) "phone_number": "08160070009", // Customer contact hook (Required) "identityType": "bvn", // Supported values: "bvn" or "nin" (Required) "identityNumber": "12345678900", // Valid matching identity data sequence (Required) "account_type": "STATIC", // Supported structural type: "STATIC" (Required) "bankCode": "palmpay", // Specified target clearing institute routing code (Required) "businessId": "3AB2B22345EF407" // Global structural corporate identity hash }

JSON Response Body

HTTP STATUS: 200 OK
{ "status": "success", "message": "Customer account created successfully. Bank account(s) processed and ready for use.", "event_type": "RESERVED_VIRTUAL_ACCOUNT", "datetime": "20260623", "bussinessId": "TD56G5HU6", "refId": "2026327372bGDYE3GD7YHDRESERVED", "data": { "virtualName": "Heedtech sahe(HeedPay)", "virtualNumber": "36332838449", "bankName": "Heedpay Bank", "customer_phone_number": "07075282016" }, "customer": { "name": "Heedtech Universal", "email": "customer@gmail.com", "phone": "07018209812" }, "errors": [] }

Documentation last updated 1 year ago