Nagorikpay is a simple and Secure payment automation tool which is designed to use personal account as a payment gateway so that you can accept payments from your customer through your website where you will find a complete overview on how Nagorikpay works and how you can integrate Nagorikpay API in your website
Nagorikpay Payment Gateway enables Merchants to receive money from their customers by temporarily redirecting them to www.Nagorikpay.com. The gateway is connecting multiple payment terminal including card system, mobile financial system, local and International wallet. After the payment is complete, the customer is returned to the merchant's site and seconds later the Merchant receives notification about the payment along with the details of the transaction. This document is intended to be utilized by technical personnel supporting the online Merchant's website. Working knowledge of HTML forms or cURL is required. You will probably require test accounts for which you need to open accounts via contact with Nagorikpay.com or already provided to you.
REST APIs are supported in two environments. Use the Sandbox environment for testing purposes, then move to the live environment for production processing. When testing, generate an order url with your test credentials to make calls to the Sandbox URIs. When you're set to go live, use the live credentials assigned to your new signature key to generate a live order url to be used with the live URIs. Your server has to support cURL system. For HTML Form submit please review after cURL part we provide HTML Post method URL also
Live API End Point (For Create Payment URL):
POSThttps://secure-pay.nagorikpay.com/api/payment/create
Payment Verify API:
POSThttps://secure-pay.nagorikpay.com/api/payment/verify
Variables Need to POST to Initialize Payment Process in gateway URL
| Field Name | Description | Required | Example Values |
|---|---|---|---|
| cus_name | Customer Full Name | Yes | John Doe |
| cus_email | Email address of the customer | Yes | [email protected] |
| amount | The total amount payable. Please note that you should skip the the trailing zeros in case the amount is a natural number. | Yes | 10 or 10.50 or 10.6 |
| success_url | URL to which the customer will be returned when the payment is made successfully. The customer will be returned to the last page on the Merchant's website where he should be notify the payment successful. | Yes | https://yourdomain.com/sucess.php |
| cancel_url | URL to return customer to your product page or home page. | Yes | https://yourdomain.com/cancel.php |
| webhook_url | IPN callback URL | No | https://yourdomain.com/webhook.php |
| metadata | Optional extra data (JSON) to attach to the payment — for example your internal order or invoice reference. | No | {"order_id":"AB-123"} |
Variables Needs For Payment Verify
| Field Name | Description | Required | Example Values |
|---|---|---|---|
| transaction_id | Transaction id received as a query parameter from the success URL provided during payment creation. | Yes | OVKPXW165414 |
| Header Name | Value |
|---|---|
| Content-Type | application/json |
| API-KEY | App key From Brands |
You can integrate our payment gateway into your PHP Laravel WordPress WooCommerce sites.
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://secure-pay.nagorikpay.com/api/payment/create',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS =>'{"success_url":"yourdomain.com/success","cancel_url":"yourdomain.com/cancel","webhook_url":"yourdomain.com/webhook","metadata":{"phone":"016****"},"amount":"10"}',
CURLOPT_HTTPHEADER => array(
'API-KEY: gnXi7etgWNhFyFGZFrOMYyrmnF4A1eGU5SC2QRmUvILOlNc2Ef',
'Content-Type: application/json'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>
<?php
$client = new Client();
$headers = [
'API-KEY' => 'gnXi7etgWNhFyFGZFrOMYyrmnF4A1eGU5SC2QRmUvILOlNc2Ef',
'Content-Type' => 'application/json'
];
$body = '{
"success_url": "yourdomain.com/success",
"cancel_url": "yourdomain.com/cancel",
"webhook_url": "yourdomain.com/webhook",
"metadata": {
"phone": "016****"
},
"amount": "10"
}';
$request = new Request('POST', 'https://secure-pay.nagorikpay.com/api/payment/create', $headers, $body);
$res = $client->sendAsync($request)->wait();
echo $res->getBody();
?>
const axios = require('axios');
let data = JSON.stringify({
"success_url": "yourdomain.com/success",
"cancel_url": "yourdomain.com/cancel",
"webhook_url": "yourdomain.com/webhook",
"metadata": {
"phone": "016****"
},
"amount": "10"
});
let config = {
method: 'post',
maxBodyLength: Infinity,
url: 'https://secure-pay.nagorikpay.com/api/payment/create',
headers: {
'API-KEY': 'gnXi7etgWNhFyFGZFrOMYyrmnF4A1eGU5SC2QRmUvILOlNc2Ef',
'Content-Type': 'application/json'
},
data : data
};
axios.request(config)
.then((response) => {
console.log(JSON.stringify(response.data));
})
.catch((error) => {
console.log(error);
});
import requests
import json
url = "https://secure-pay.nagorikpay.com/api/payment/create"
payload = json.dumps({
"success_url": "yourdomain.com/success",
"cancel_url": "yourdomain.com/cancel",
"webhook_url": "yourdomain.com/webhook",
"metadata": {
"phone": "016****"
},
"amount": "10"
})
headers = {
'API-KEY': 'gnXi7etgWNhFyFGZFrOMYyrmnF4A1eGU5SC2QRmUvILOlNc2Ef',
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
package main
import (
"fmt"
"strings"
"net/http"
"io/ioutil"
)
func main() {
url := "https://secure-pay.nagorikpay.com/api/payment/create"
method := "POST"
payload := strings.NewReader(`{"success_url":"yourdomain.com/success","cancel_url":"yourdomain.com/cancel","webhook_url":"yourdomain.com/webhook","metadata":{"phone":"01521412457"},"amount":"10"}`)
client := &http.Client {
}
req, err := http.NewRequest(method, url, payload)
if err != nil {
fmt.Println(err)
return
}
req.Header.Add("API-KEY", "gnXi7etgWNhFyFGZFrOMYyrmnF4A1eGU5SC2QRmUvILOlNc2Ef")
req.Header.Add("Content-Type", "application/json")
res, err := client.Do(req)
if err != nil {
fmt.Println(err)
return
}
defer res.Body.Close()
body, err := ioutil.ReadAll(res.Body)
if err != nil {
fmt.Println(err)
return
}
fmt.Println(string(body))
}
| Field Name | Type | Description |
|---|---|---|
| Success Response | ||
| status | bool | TRUE |
| message | String | Message for Status |
| payment_url | String | Payment Link (where customers will complete their payment) |
| Error Response | ||
| status | bool | FALSE |
| message | String | Message associated with the error response |
| Completing Payment Page task you will be redirected to success or cancel page based on transaction status with the following Query Parameters: yourdomain.com/(success/cancel)?transactionId=******&paymentMethod=***&paymentAmount=**.**&paymentFee=**.**&status=pending or success or failed | ||
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://secure-pay.nagorikpay.com/api/payment/verify',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS =>'{"transaction_id":"ABCDEFH"}',
CURLOPT_HTTPHEADER => array(
'API-KEY: gnXi7etgWNhFyFGZFrOMYyrmnF4A1eGU5SC2QRmUvILOlNc2Ef',
'Content-Type: application/json'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>
<?php
$client = new Client();
$headers = [
'API-KEY' => 'gnXi7etgWNhFyFGZFrOMYyrmnF4A1eGU5SC2QRmUvILOlNc2Ef',
'Content-Type' => 'application/json'
];
$body = '{
"transaction_id": "ABCDEFH"
}';
$request = new Request('POST', 'https://secure-pay.nagorikpay.com/api/payment/verify', $headers, $body);
$res = $client->sendAsync($request)->wait();
echo $res->getBody();
?>
const axios = require('axios');
let data = JSON.stringify({
"transaction_id": "ABCDEFH"
});
let config = {
method: 'post',
maxBodyLength: Infinity,
url: 'https://secure-pay.nagorikpay.com/api/payment/verify',
headers: {
'API-KEY': 'gnXi7etgWNhFyFGZFrOMYyrmnF4A1eGU5SC2QRmUvILOlNc2Ef',
'Content-Type': 'application/json'
},
data : data
};
axios.request(config)
.then((response) => {
console.log(JSON.stringify(response.data));
})
.catch((error) => {
console.log(error);
});
import http.client
import json
conn = http.client.HTTPSConnection("local.pay.expensivepay.com")
payload = json.dumps({
"transaction_id": "ABCDEFH"
})
headers = {
'API-KEY': 'gnXi7etgWNhFyFGZFrOMYyrmnF4A1eGU5SC2QRmUvILOlNc2Ef',
'Content-Type': 'application/json'
}
conn.request("POST", "/api/payment/verify", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
package main
import (
"fmt"
"strings"
"net/http"
"io/ioutil"
)
func main() {
url := "https://secure-pay.nagorikpay.com/api/payment/verify"
method := "POST"
payload := strings.NewReader(`{"transaction_id":"ABCDEFH"}`)
client := &http.Client {
}
req, err := http.NewRequest(method, url, payload)
if err != nil {
fmt.Println(err)
return
}
req.Header.Add("API-KEY", "gnXi7etgWNhFyFGZFrOMYyrmnF4A1eGU5SC2QRmUvILOlNc2Ef")
req.Header.Add("Content-Type", "application/json")
res, err := client.Do(req)
if err != nil {
fmt.Println(err)
return
}
defer res.Body.Close()
body, err := ioutil.ReadAll(res.Body)
if err != nil {
fmt.Println(err)
return
}
fmt.Println(string(body))
}
{
"cus_name": "John Doe",
"cus_email": "[email protected]",
"amount": "900.000",
"transaction_id": "OVKPXW165414",
"metadata": {
"phone": "015****",
},
"payment_method": "bkash",
"status": "COMPLETED"
}
| Field Name | Type | Description |
|---|---|---|
| Success Response | ||
| status | string | COMPLETED or PENDING or ERROR |
| cus_name | String | Customer Name |
| cus_email | String | Customer Email |
| amount | String | Amount |
| transaction_id | String | Transaction id Generated by System |
| metadata | json | Metadata used for Payment creation |
| Error Response | ||
| status | bool | FALSE |
| message | String | Message associated with the error response |
When you create a payment you may pass a webhook_url. Nagorikpay then POSTs the outcome of that payment to your URL automatically — you never have to poll for it. Every delivery is recorded in your merchant panel → Webhook Logs, where you can inspect the exact request your server received (or missed) and resend it at any time.
status = completed. Methods that need manual review (bank transfer / QR) send status = pending first and the money is confirmed later.status = completed.cancel_url.Nagorikpay sends a form-urlencoded POST to your webhook_url. The same fields are also appended to the redirect back to your success_url, so the two always agree.
| Field | Description |
|---|---|
| paymentMethod | The payment method used (e.g. bkash, nagad, card). |
| transactionId | Unique Nagorikpay transaction id for this payment. |
| method_transaction_id | The payment-provider reference the customer entered (e.g. the bKash/Nagad TrxID), when the method captured one. Empty for methods without one. |
| paymentAmount | The amount the customer paid. |
| paymentFee | Fee deducted for this payment. |
| status | Outcome: completed | pending | failed. |
Reply to the webhook as fast as possible with any HTTP 2xx — Nagorikpay treats a 2xx response as delivered. Do the heavy work afterwards. Before fulfilling an order it is safest to confirm the payment with our verify endpoint (see Verify Request above). A minimal PHP receiver looks like:
<?php
// 1) Acknowledge fast — Nagorikpay treats any 2xx as delivered.
http_response_code(200);
// 2) Capture what was POSTed.
$paymentMethod = $_POST['paymentMethod'] ?? '';
$transactionId = $_POST['transactionId'] ?? '';
$methodTransactionId = $_POST['method_transaction_id'] ?? '';
$paymentAmount = $_POST['paymentAmount'] ?? '';
$status = $_POST['status'] ?? '';
// 3) Confirm via api/payment/verify before fulfilling (see "Verify Request").
// Then mark the order as paid in your own database.
Ready-made modules and plugins to drop Nagorikpay into your favourite platform. Download, configure your API keys and start accepting payments.
See Setup Video: YouTube Video
See Setup Video: How To Setup Video here
Enhance your App with our payment gateway integration module.
See Setup Video: Video here
See Setup Video: Video here
See Setup Video: How To Setup App Video here
Seamlessly connect nagorikPay to Active CMS websites for managing payments with ease. Perfect for businesses using Active CMS to run their online services. Video here
Enhance Market BOB platforms by integrating our secure payment solution. Accept payments instantly and automate your order management workflow. Video here
Nagorikpay provides a ready-made Laravel module for developers. Easily integrate payment gateway APIs into your Laravel projects with minimal coding effort. Video here