PayBondhu Payment Gateway enables merchants to receive payments from customers by redirecting them to PayBondhu. After payment, the customer returns to your website with transaction details.
All API requests require your Brand Key as the API-KEY header. Find it in Dashboard → Settings → Brands.
Create a payment session and redirect the customer to the payment page.
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| cus_name | String | Required | Customer full name | John Doe |
| cus_email | String | Required | Customer email | john@gmail.com |
| amount | String | Required | Payment amount | 500 or 99.50 |
| success_url | String | Required | Redirect URL on successful payment | https://yoursite.com/success |
| cancel_url | String | Required | Redirect URL if cancelled | https://yoursite.com/cancel |
| meta_data | JSON | Optional | Custom data (order ID, phone, etc.) | {"order_id":"123"} |
{ "status": true, "message": "Payment session created", "payment_url": "https://paybondhu.com/pay/abc123..." }{ "status": false, "message": "Error description" }<?php$curl = curl_init();$data = json_encode([ 'cus_name' => 'John Doe', 'cus_email' => 'john@gmail.com', 'amount' => '500', 'success_url' => 'https://yoursite.com/success', 'cancel_url' => 'https://yoursite.com/cancel', 'meta_data' => json_encode(['order_id' => '12345']),]);curl_setopt_array($curl, [ CURLOPT_URL => 'https://pay.paybondhu.com/api/payment/create', CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_POSTFIELDS => $data, CURLOPT_HTTPHEADER => [ 'Content-Type: application/json', 'API-KEY: YOUR_BRAND_KEY', ],]);$response = curl_exec($curl);curl_close($curl);$result = json_decode($response, true);if (!empty($result['payment_url'])) { header('Location: ' . $result['payment_url']); exit;}echo $result['message'] ?? 'Payment creation failed';?>use Illuminate\Support\Facades\Http;$response = Http::withHeaders([ 'API-KEY' => env('PAYBONDHU_BRAND_KEY'),])->post('https://pay.paybondhu.com/api/payment/create', [ 'cus_name' => $request->name, 'cus_email' => $request->email, 'amount' => $order->total, 'success_url' => route('payment.success', $order->id), 'cancel_url' => route('payment.cancel', $order->id), 'meta_data' => json_encode(['order_id' => $order->id]),]);$data = $response->json();if (!empty($data['payment_url'])) { return redirect($data['payment_url']);}return back()->with('error', $data['message'] ?? 'Payment failed');const axios = require('axios');const { data } = await axios.post('https://pay.paybondhu.com/api/payment/create', { cus_name: 'John Doe', cus_email: 'john@gmail.com', amount: '500', success_url: 'https://yoursite.com/success', cancel_url: 'https://yoursite.com/cancel', meta_data: JSON.stringify({ order_id: '12345' }),}, { headers: { 'Content-Type': 'application/json', 'API-KEY': 'YOUR_BRAND_KEY', }});if (data.payment_url) { res.redirect(data.payment_url);} else { console.error(data.message);}import requests, jsonresponse = requests.post( 'https://pay.paybondhu.com/api/payment/create', headers={ 'Content-Type': 'application/json', 'API-KEY': 'YOUR_BRAND_KEY', }, json={ 'cus_name': 'John Doe', 'cus_email': 'john@gmail.com', 'amount': '500', 'success_url': 'https://yoursite.com/success', 'cancel_url': 'https://yoursite.com/cancel', 'meta_data': json.dumps({'order_id': '12345'}), })data = response.json()if data.get('payment_url'): print('Redirect to:', data['payment_url'])else: print('Error:', data.get('message'))curl -X POST https://pay.paybondhu.com/api/payment/create \ -H "Content-Type: application/json" \ -H "API-KEY: YOUR_BRAND_KEY" \ -d '{ "cus_name": "John Doe", "cus_email": "john@gmail.com", "amount": "500", "success_url": "https://yoursite.com/success", "cancel_url": "https://yoursite.com/cancel" }'After payment, the customer is redirected to your success_url or cancel_url with these query parameters:
| Parameter | Type | Description |
|---|---|---|
| transactionId | String | Unique transaction ID — use this to verify payment |
| paymentMethod | String | Method used (bkash, nagad, rocket, etc.) |
| paymentAmount | String | Amount paid |
| paymentFee | String | Processing fee (if any) |
| status | String | success, pending, or failed |
Verify transaction status server-side using the transaction ID from the callback.
| Parameter | Type | Required | Description |
|---|---|---|---|
| transaction_id | String | Required | The transactionId from callback URL |
<?php$transactionId = $_GET['transactionId'] ?? '';$curl = curl_init();curl_setopt_array($curl, [ CURLOPT_URL => 'https://pay.paybondhu.com/api/payment/verify', CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_POSTFIELDS => json_encode(['transaction_id' => $transactionId]), CURLOPT_HTTPHEADER => [ 'Content-Type: application/json', 'API-KEY: YOUR_BRAND_KEY', ],]);$response = curl_exec($curl);curl_close($curl);$result = json_decode($response, true);if ($result['status'] === 'COMPLETED') { // ✅ Payment successful — update your order echo "Verified! Amount: " . $result['amount'];} else { echo "Status: " . $result['status'];}?>$response = Http::withHeaders([ 'API-KEY' => env('PAYBONDHU_BRAND_KEY'),])->post('https://pay.paybondhu.com/api/payment/verify', [ 'transaction_id' => $request->query('transactionId'),]);$data = $response->json();if ($data['status'] === 'COMPLETED') { $order->update(['payment_status' => 'paid']); return view('payment.success');}return view('payment.failed');const { data } = await axios.post('https://pay.paybondhu.com/api/payment/verify', { transaction_id: req.query.transactionId,}, { headers: { 'Content-Type': 'application/json', 'API-KEY': 'YOUR_BRAND_KEY', }});if (data.status === 'COMPLETED') { await Order.update({ payment_status: 'paid' }, { where: { id: orderId }}); res.send('Payment verified!');}response = requests.post( 'https://pay.paybondhu.com/api/payment/verify', headers={'Content-Type': 'application/json', 'API-KEY': 'YOUR_BRAND_KEY'}, json={'transaction_id': request.args.get('transactionId')})data = response.json()if data.get('status') == 'COMPLETED': order.update(payment_status='paid'){ "status": "COMPLETED", "cus_name": "John Doe", "cus_email": "john@gmail.com", "amount": "500.000", "transaction_id": "OVKPXW165414", "payment_method": "bkash", "metadata": { "order_id": "12345" }}| Field | Type | Values |
|---|---|---|
| status | String | COMPLETED — Success PENDING — Waiting ERROR — Failed |
| transaction_id | String | Unique transaction identifier |
| payment_method | String | bkash, nagad, rocket, etc. |
| amount | String | Payment amount |
| metadata | JSON | Custom data sent during creation |