Developer Documentation

API Base URL: https://bangla-qr.boishakhipay.com/api/v1. প্রতিটি request এ header X-API-KEY: your_key।

1. Create payment

POST https://bangla-qr.boishakhipay.com/api/v1/create (JSON)। redirect_url অবশ্যই brand এর domain এর হতে হবে।

{"amount":500,"full_name":"Rahim","email":"rahim@mail.com","redirect_url":"https://shop.com/thanks","cancel_url":"https://shop.com/cart","webhook_url":"https://shop.com/webhook.php","metadata":{"order_id":1001}}

Response:

{"status":true,"invoice_id":"A1B2C3D4E5F60718","payment_url":"https://pay.yourdomain.com/?id=A1B2C3D4E5F60718"}

Customer কে payment_url এ redirect করুন। পেমেন্ট শেষে redirect_url?invoice_id=... এ ফিরে আসবে।

2. Verify payment

Redirect বা webhook এর পর সবসময় server থেকে verify করুন। POST https://bangla-qr.boishakhipay.com/api/v1/verify

{"invoice_id":"A1B2C3D4E5F60718"}

→ {"status":true,"payment_status":"COMPLETED","amount":"500.00","transaction_id":"9AB3C4D5EF",...}

3. Webhook

পেমেন্ট complete হলে আপনার webhook_url এ JSON POST যাবে, header এ X-API-KEY থাকবে — সেটা আপনার key এর সাথে মিলিয়ে নিন।

4. PHP module

sdk/PayBridge.php ফাইলটি আপনার সাইটে কপি করুন:

require "PayBridge.php";
$pb = new PayBridge("https://bangla-qr.boishakhipay.com/api/v1", "YOUR_API_KEY");
$url = $pb->createPayment(500, "Rahim", "rahim@mail.com", "https://shop.com/thanks", "https://shop.com/webhook.php", ["order_id"=>1001]);
header("Location: ".$url);

// thanks.php
$r = $pb->verify($_GET["invoice_id"]);
if (($r["payment_status"] ?? "") === "COMPLETED") { /* order paid */ }

5. Android verifier app

Dashboard → Devices এ device key নিন। App এ আপনার account email + device key দিয়ে login করুন। App SMS permission নিয়ে incoming bKash/Nagad/Rocket SMS server এ পাঠায়। App চালু রাখুন এবং battery optimization বন্ধ করুন।