Developer API Documentation

API Integration Workflow

Create Session

আপনার ওয়েবসাইট থেকে API Call করে payment_url জেনারেট করুন।

User Payment

ইউজার গেটওয়ে পেজে গিয়ে TrxID ভেরিফাই করে পেমেন্ট কমপ্লিট করবে।

Callback & Verify

ইউজার আপনার সাইটে রিডাইরেক্ট হবে এবং S2S API দিয়ে পেমেন্ট ভেরিফাই হবে।

Gateway Host Base URL https://pay.yourpaymentdomain.com

Create Payment Session

POST

পেমেন্ট ইনিশিয়েট করার জন্য আপনার সার্ভার থেকে গেটওয়ের নিচের এন্ট্রপয়েন্টে একটি POST Request পাঠাতে হবে।

Endpoint:

POST https://pay.yourpaymentdomain.com/teamnano/payment/create

Request Payload Parameters:

Field	Type	Required	Description
amount	Numeric	Yes	পেমেন্টের টাকার পরিমাণ (must be > 0)
callback	URL	Yes	পেমেন্ট শেষে ইউজারকে ফেরত পাঠানোর সাকসেস লিঙ্ক

PHP Request Example (cURL):

PHP (cURL)

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://pay.yourpaymentdomain.com/teamnano/payment/create',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => array(
    'amount' => '100.00',
    'callback' => 'https://yourwebsite.com/payment/callback'
  ),
));

$response = curl_exec($curl);
curl_close($curl);

$resData = json_decode($response, true);

if (isset($resData['status']) && $resData['status'] === 'success') {
    // Redirect user to payment URL
    header("Location: " . $resData['payment_url']);
    exit();
}

Success Response (HTTP 200):

JSON

{
  "status": "success",
  "payment_url": "https://pay.yourpaymentdomain.com/teamnano/payment/PAY-bd42c206bef205a9",
  "token": "PAY-bd42c206bef205a9"
}

Error Response (HTTP 500/422):

JSON

{
  "status": "error",
  "message": "The amount field is required."
}

Payment Redirect & Callback

GET Redirect

ইউজার সফলভাবে পেমেন্ট কমপ্লিট করলে ৩ সেকেন্ড অ্যানিমেশন শেষে গেটওয়ে সিস্টেম স্বয়ংক্রিয়ভাবে তাকে আপনার প্রদানকৃত callback URL এ Redirect করবে।

Sample Redirected URL Structure:

https://yourwebsite.com/payment/callback?status=success&trxid=8HD1234567&amount=100&method=bkash&token=PAY-bd42c206bef205a9

Query Parameters Received in Callback:

Parameter	Type	Value/Description
status	String	পেমেন্ট সফল হলে ভ্যালু থাকবে `success`
trxid	String	ইউজারের দেওয়া সফল bKash/Nagad Transaction ID
amount	Numeric	SMS থেকে পঠিত প্রকৃত পেমেন্টকৃত অ্যামাউন্ট
method	String	যে মেথডে পেমেন্ট করা হয়েছে (e.g. bkash, nagad)
token	String	আপনার ইনিশিয়েট করা ইউনিক সেশন টোকেন

Server-to-Server Verification

(Optional Security Anti-Fraud Verification)

POST

ইউজার যেন ব্রাউজারের URL এডিট করে ফ্রড (Spoofing) করতে না পারে, সেজন্য Callback পেজে আপনার ব্যাকএন্ড থেকে সরাসরি গেটওয়ে API-কে কল করে পেমেন্ট তথ্য ভেরিফাই করে নেওয়া বুদ্ধিমানের কাজ।

Verify Endpoint:

POST https://pay.yourpaymentdomain.com/api/verify-payment

PHP Verification Integration Code:

PHP Callback Handler

// Callback URL পেজে এই ভেরিফিকেশন হ্যান্ডেল করবেন
$token  = $_GET['token'] ?? '';
$amount = $_GET['amount'] ?? '';

$curl = curl_init();
curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://pay.yourpaymentdomain.com/api/verify-payment',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => array(
    'token'  => $token,
    'amount' => $amount
  ),
));

$response = curl_exec($curl);
curl_close($curl);

$result = json_decode($response, true);

if (isset($result['is_verified']) && $result['is_verified'] === true) {
    // 100% Verified Payment! Safe to deliver order / add balance.
    $verifiedAmount = $result['data']['amount'];
    // Update your database here...
} else {
    // Fraud Detected or Payment Invalid!
    die("Security Verification Failed: " . $result['message']);
}

Verified Response (HTTP 200):

JSON

{
  "status": "success",
  "is_verified": true,
  "message": "Payment securely verified.",
  "data": {
    "token": "PAY-bd42c206bef205a9",
    "amount": 100.00,
    "status": "completed",
    "created_at": "2026-08-24 21:40:00"
  }
}

Fraud / Mismatch Response (HTTP 400):

JSON

{
  "status": "error",
  "is_verified": false,
  "message": "Amount mismatch! Claimed: ৳500, Actual: ৳100."
}

Response Status Codes

Code	Status	Description
200 OK	Success	রিকুয়েস্ট সফল হয়েছে এবং সঠিক ডাটা রিটার্ন করেছে।
400 Bad Request	Validation / Fraud Error	টাকার পরিমাণ মেলেনি, পেমেন্ট পেন্ডিং অথবা ভ্যালিডেশন ফেল করেছে।
404 Not Found	Invalid Token	প্রদানকৃত পেমেন্ট সেশন টোকেনটি ডাটাবেজে পাওয়া যায়নি।
500 Server Error	Internal Error	গেটওয়ে সার্ভারে কোনো টেকনিক্যাল বা ডাটাবেজ এরর ঘটেছে।

Ready-Made Scripts & Modules

Downloads & Quick Integration

কোডিং ঝামেলা ছাড়াই আপনার ওয়েবসাইটে Nano Pay Integration এর জন্য প্রয়োজনীয় Script এবং Ready Module ডাউনলোড করুন।

Custom Payment Page Script

যেকোনো কাস্টম PHP ওয়েবসাইট বা ল্যান্ডিং পেজে সরাসরি পেমেন্ট গেটওয়ে যুক্ত করার তৈরি করা Standalone Script।

Payment Page Script (.ZIP)

Topup Website Payment Module

FreeFire/PUBG টপআপ সাইটের জন্য রেডি পেমেন্ট Redirect মডিউল।

Download Module (.ZIP)