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 বন্ধ করুন।