API Documentation

Integrate BohudurPay payment gateway into your application

Authentication

All API requests require your brand API key in the Authorization header.

Authorization: Bearer YOUR_API_KEY

Create Payment

POST/api/payment/create

Request Body

{
  "amount": 500,
  "cus_name": "John Doe",
  "cus_email": "[email protected]",
  "success_url": "https://yoursite.com/success",
  "cancel_url": "https://yoursite.com/cancel",
  "webhook_url": "https://yoursite.com/webhook",
  "metadata": { "order_id": "123" }
}

Response

{
  "status": 1,
  "payment_url": "https://secure-payment.bohudurpay.com/pay/abc123...",
  "transaction_id": "NP..."
}

Verify Payment

POST/api/payment/verify

Request Body

{
  "transaction_id": "NP..."
}

Response

{
  "status": "COMPLETED",
  "transaction_id": "NP...",
  "amount": 500,
  "payment_method": "bkash",
  "customer": { "name": "John Doe", "email": "[email protected]" }
}

Device SMS Forwarding

POST/api/device/sms

Forward SMS from Android device for auto-verification.

Headers

X-Device-Key: YOUR_DEVICE_KEY

Request Body

{
  "address": "bKash",
  "message": "You have received Tk 500.00 from 01XXXXXXXXX..."
}

Webhook Payload

When a payment status changes, we send a POST request to your webhook URL.

{
  "paymentMethod": "bkash",
  "transactionId": "NP...",
  "paymentAmount": "500.00",
  "status": "COMPLETED"
}

Supported Payment Methods

bKash
Nagad
Rocket
Upay
Cellfin
Tap
iPay
OK Wallet
mCash
SureCash
EasyPaisa
MyCash