Skip to main content
POST
NGN Disbursement Application
All example requests on this page are based on the sandbox (test) environment. Please be careful to distinguish it from the production environment.

Secret Key & Private Key (Generate Signature)

Body

application/json
appId
integer<int64>
required

Business ID obtained from the backend; it must match the URL currency

orderId
string
required

Unique merchant order ID, up to 48 characters

Maximum string length: 48
amount
string
required

Transaction amount in NGN, up to 2 decimal places; subject to the merchant backend business configuration

Pattern: ^((([1-9]\d*)(\.\d{1,4})?)|(0\.(?!0+$)\d{1,4}))$
accountType
string
required

Account type supported by the merchant backend configuration

bankCode
string
required

Bank code supported by the merchant backend payment-code configuration

accountNo
string
required

Recipient bank account number, exactly 10 digits

Pattern: ^\d{10}$
name
string
required

Recipient name in English, containing at least a first and last name separated by a space; digits and special characters are not supported

Pattern: ^[A-Za-z ]+$
sign
string
required

Signature

phone
string

Recipient phone number

email
string<email>

Recipient email

notifyUrl
string<uri>

Asynchronous notification URL

subject
string

Transaction title, product name, or payment reason

body
string

Detailed remark

partnerUserId
string

Unique user identifier

Maximum string length: 64
Pattern: ^[a-zA-Z0-9\-~!@#$%&*()_]+$

Response

200 - application/json

Success

status
string

API status: 1 normal, 0 exception

error
string

Error code

msg
string

Message

data
object
Last modified on October 13, 2026