NGN Disbursement Application

curl --request POST \ --url https://uat-interface.haipay.asia/ngn/pay/apply \ --header 'Content-Type: application/json' \ --data ' { "appId": 123, "orderId": "<string>", "amount": "<string>", "bankCode": "<string>", "accountNo": "<string>", "name": "<string>", "phone": "<string>", "email": "jsmith@example.com", "partnerUserId": "<string>", "sign": "<string>", "notifyUrl": "<string>", "subject": "<string>", "body": "<string>" } '

Body

application/json

appId

integer

required

Business ID (obtained from backend, must match the currency in the URL)

orderId

string

required

Merchant order ID

Maximum string length: 48

amount

string

required

Transaction amount (unit: ₦) Range: 500–3,000,000

accountType

enum<string>

required

Account type: BANK_ACCOUNT

Available options:

BANK_ACCOUNT

bankCode

string

required

Bank code

accountNo

string

required

User bank account number

name

string

required

Recipient name (Format: English or Vietnamese, case-insensitive, spaces allowed, 1–30 characters, "firstName middleName lastName" (The middleNamefield is optional and does not support special characters or numbers.))

Required string length: 1 - 30

phone

string

required

Real phone number

string<email>

required

Real email address

partnerUserId

string

required

User unique identifier (e.g., userId). Used by risk control, must be valid. Format: numbers, letters, or common symbols -~!@#$%&*()_.

Pattern: ^[A-Za-z0-9\-~!@#$%&*()_]+$

sign

string

required

Signature

notifyUrl

string<uri>

Callback URL

subject

string

Payment note (transaction title, product name, payment reason)

body

string

Detailed note

Response

200 - application/json

status

string

1: Normal, 0: Exception

error

string

Error code

msg

string

Error description

data

object

Show child attributes

​Secret Key & Private Key (Generate Signature)

​Related Topics

Body

Response

Secret Key & Private Key (Generate Signature)

Related Topics