Create Static Accounts (NGN, USD, GBP, EUR)
Creates a LedgerBlock static account for receiving collections on behalf of a user.
A static account is linked to an account reference and wallet ID, with a real static bank account assigned to it. When a static account is created, a KYC fee is charged to the merchant's wallet balance.
Request
Method: POST
Endpoint:
{{base_url}}/api/v1/static/account
Authentication & Headers
| Header | Type | Required | Description |
|---|---|---|---|
Authorization | String | Yes | Bearer ${api_key} — your activated merchant API key. |
x-merchant-ref | String | Yes | Your unique merchant reference. |
Content-Type | String | Yes | Must be set to application/json. |
Request Body
{
"user_name": "John E",
"account_reference": "A12345",
"email": "[email protected]",
"currency": "NGN",
"user_kyc": {
"nin": "1234",
"bvn": "12345"
}
}Request Fields
| Field | Type | Required | Description |
|---|---|---|---|
user_name | String | Yes | Name of the user the static account will be assigned to. |
account_reference | String | Yes | Unique reference used to identify the static account. |
email | String | Yes | Email address associated with the user. |
currency | String | Yes | Currency in which the static account will operate. |
user_kyc | Object | Yes | KYC information required to create the static account. |
user_kyc.nin | String | Yes | User's National Identification Number. |
user_kyc.bvn | String | Yes | User's Bank Verification Number. |
How It Works
When the request is successfully processed, LedgerBlock creates a static account for the specified user and assigns a real bank account to it. The account can then be used to receive collection payments.
A KYC fee is charged to the merchant wallet balance when the static account is created. Therefore, the merchant must have sufficient wallet balance to cover the applicable KYC fee.
Updated 25 days ago
Did this page help you?