curl --request POST \
--url https://uat-interface.haipay.asia/ngn/collect/apply \
--header 'Content-Type: application/json' \
--data '
{
"appId": 1054,
"orderId": "NGNCOLLECT001",
"amount": "25000.00",
"email": "emeka.okafor@gmail.com",
"callBackUrl": "https://shop.merchant.com/payment/success",
"notifyUrl": "https://api.merchant.com/webhooks/haipay",
"sign": "signature"
}
'import requests
url = "https://uat-interface.haipay.asia/ngn/collect/apply"
payload = {
"appId": 1054,
"orderId": "NGNCOLLECT001",
"amount": "25000.00",
"email": "emeka.okafor@gmail.com",
"callBackUrl": "https://shop.merchant.com/payment/success",
"notifyUrl": "https://api.merchant.com/webhooks/haipay",
"sign": "signature"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const url = 'https://uat-interface.haipay.asia/ngn/collect/apply';
const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
appId: 1054,
orderId: 'NGNCOLLECT001',
amount: '25000.00',
email: 'emeka.okafor@gmail.com',
callBackUrl: 'https://shop.merchant.com/payment/success',
notifyUrl: 'https://api.merchant.com/webhooks/haipay',
sign: 'signature'
})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://uat-interface.haipay.asia/ngn/collect/apply",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'appId' => 1054,
'orderId' => 'NGNCOLLECT001',
'amount' => '25000.00',
'email' => 'emeka.okafor@gmail.com',
'callBackUrl' => 'https://shop.merchant.com/payment/success',
'notifyUrl' => 'https://api.merchant.com/webhooks/haipay',
'sign' => 'signature'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}HttpResponse<String> response = Unirest.post("https://uat-interface.haipay.asia/ngn/collect/apply")
.header("Content-Type", "application/json")
.body("{\n \"appId\": 1054,\n \"orderId\": \"NGNCOLLECT001\",\n \"amount\": \"25000.00\",\n \"email\": \"emeka.okafor@gmail.com\",\n \"callBackUrl\": \"https://shop.merchant.com/payment/success\",\n \"notifyUrl\": \"https://api.merchant.com/webhooks/haipay\",\n \"sign\": \"signature\"\n}")
.asString();{
"status": "1",
"error": "00000000",
"msg": "",
"data": {
"orderId": "NGNCOLLECT001",
"orderNo": "6023071013539074",
"amount": "25000.00",
"exchangeRate": "1",
"orderAmount": "25000.00",
"payUrl": "https://pay.haipay.asia/cashier/1L9zQS2",
"description": "",
"expiryPeriod": 15,
"sign": "signature"
}
}Nigeria — NGN Collection Application
Nigeria — NGN Collection Application endpoint (POST /ngn/collect/apply) with request parameters including orderId, amount, signature verification, and response status.
curl --request POST \
--url https://uat-interface.haipay.asia/ngn/collect/apply \
--header 'Content-Type: application/json' \
--data '
{
"appId": 1054,
"orderId": "NGNCOLLECT001",
"amount": "25000.00",
"email": "emeka.okafor@gmail.com",
"callBackUrl": "https://shop.merchant.com/payment/success",
"notifyUrl": "https://api.merchant.com/webhooks/haipay",
"sign": "signature"
}
'import requests
url = "https://uat-interface.haipay.asia/ngn/collect/apply"
payload = {
"appId": 1054,
"orderId": "NGNCOLLECT001",
"amount": "25000.00",
"email": "emeka.okafor@gmail.com",
"callBackUrl": "https://shop.merchant.com/payment/success",
"notifyUrl": "https://api.merchant.com/webhooks/haipay",
"sign": "signature"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const url = 'https://uat-interface.haipay.asia/ngn/collect/apply';
const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
appId: 1054,
orderId: 'NGNCOLLECT001',
amount: '25000.00',
email: 'emeka.okafor@gmail.com',
callBackUrl: 'https://shop.merchant.com/payment/success',
notifyUrl: 'https://api.merchant.com/webhooks/haipay',
sign: 'signature'
})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://uat-interface.haipay.asia/ngn/collect/apply",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'appId' => 1054,
'orderId' => 'NGNCOLLECT001',
'amount' => '25000.00',
'email' => 'emeka.okafor@gmail.com',
'callBackUrl' => 'https://shop.merchant.com/payment/success',
'notifyUrl' => 'https://api.merchant.com/webhooks/haipay',
'sign' => 'signature'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}HttpResponse<String> response = Unirest.post("https://uat-interface.haipay.asia/ngn/collect/apply")
.header("Content-Type", "application/json")
.body("{\n \"appId\": 1054,\n \"orderId\": \"NGNCOLLECT001\",\n \"amount\": \"25000.00\",\n \"email\": \"emeka.okafor@gmail.com\",\n \"callBackUrl\": \"https://shop.merchant.com/payment/success\",\n \"notifyUrl\": \"https://api.merchant.com/webhooks/haipay\",\n \"sign\": \"signature\"\n}")
.asString();{
"status": "1",
"error": "00000000",
"msg": "",
"data": {
"orderId": "NGNCOLLECT001",
"orderNo": "6023071013539074",
"amount": "25000.00",
"exchangeRate": "1",
"orderAmount": "25000.00",
"payUrl": "https://pay.haipay.asia/cashier/1L9zQS2",
"description": "",
"expiryPeriod": 15,
"sign": "signature"
}
}Secret Key & Private Key (Generate Signature)
Related Topics
- Nigeria Payment API
- HaiPay API Reference Overview
- HaiPay Configuration and Signature Guide
- Nigeria — NGN Collection Query (POST /ngn/collect/query)
- Handle Asynchronous Notifications and Verify Signatures
- Look Up Collection Payment Types and Codes (payType)
Body
Business ID obtained from the backend; it must match the URL currency
Unique merchant order ID, up to 48 characters
48Transaction amount in NGN; subject to the merchant backend business configuration. The common request format accepts up to 4 decimal places; amounts are processed with 2 decimal places
^((([1-9]\d*)(\.\d{1,4})?)|(0\.(?!0+$)\d{1,4}))$Signature
Payment type configured in the merchant backend
Collection payment code configured in the merchant backend
Payer name
Payer phone number
20Payer email; a default email is used when omitted
Redirect URL after successful payment
Redirect URL after failed payment
Asynchronous notification URL
Transaction title, product name, or payment reason
Detailed remark
Unique user identifier
64^[a-zA-Z0-9\-~!@#$%&*()_]+$
