Welcome To DurontoPayBD Docs (Last updated: 2024-06-06)

DurontoPayBD is a simple and Secure payment automation tool which is designed to use personal account as a payment gateway so that you can accept payments from your customer through your website where you will find a complete overview on how DurontoPayBD works and how you can integrate DurontoPayBD API in your website.


API Introduction

DurontoPayBD Payment Gateway enables Merchants to receive money from their customers by temporarily redirecting them to www.durontopaybd.cyou. The gateway is connecting multiple payment terminals including card systems, mobile financial systems, local and International wallets. After the payment is complete, the customer is returned to the merchant's site and seconds later the Merchant receives notification about the payment along with the details of the transaction. Working knowledge of HTML forms or cURL is required.

API Operation

REST APIs are supported in two environments. Use the Sandbox environment for testing purposes, then move to the live environment for production processing. When testing, generate an order url with your test credentials to make calls to the Sandbox URIs.

Live API End Point (For Create Payment URL):

https://pay.durontopaybd.cyou/api/payment/create

Payment Verify API:

https://pay.durontopaybd.cyou/api/payment/verify

Parameter Details

Variables Need to POST to Initialize Payment Process in gateway URL
Field Name Description Required Example Values
cus_name Customer Full Name Yes John Doe
cus_email Email address of the customer Yes [email protected]
amount The total amount payable. Please note that you should skip the trailing zeros. Yes 10 or 10.50
success_url URL to which the customer will be returned when the payment is made successfully. Yes https://yourdomain.com/success.php
cancel_url URL to return customer to your product page or home page. Yes https://yourdomain.com/cancel.php
webhook_url IPN callback URL No https://yourdomain.com/webhook.php
meta_data Extra data formatted as JSON No Json Formatted
Variables Needs For Payment Verify
Field Name Description Required Example Values
transaction_id Transaction id received as a query parameter from the success URL. Yes OVKPXW165414

Headers Details

Header Name Value
Content-Type application/json
API-KEY App key From Brands

Integration

You can integrate our payment gateway into your PHP Laravel WordPress WooCommerce sites.

Sample Request

<?php$curl = curl_init();curl_setopt_array($curl, array( CURLOPT_URL => 'https://pay.durontopaybd.cyou/api/payment/create', CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => '', CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 0, CURLOPT_FOLLOWLOCATION => true, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_POSTFIELDS =>'{"success_url":"yourdomain.com/success","cancel_url":"yourdomain.com/cancel","webhook_url":"yourdomain.com/webhook","metadata":{"phone":"016****"},"amount":"10"}', CURLOPT_HTTPHEADER => array( 'API-KEY: gnXi7etgWNhFyFGZFrOMYyrmnF4A1eGU5SC2QRmUvILOlNc2Ef', 'Content-Type: application/json' ),));$response = curl_exec($curl);curl_close($curl);echo $response;?> 
<?php$client = new Client();$headers = [ 'API-KEY' => 'gnXi7etgWNhFyFGZFrOMYyrmnF4A1eGU5SC2QRmUvILOlNc2Ef', 'Content-Type' => 'application/json'];$body = '{ "success_url": "yourdomain.com/success", "cancel_url": "yourdomain.com/cancel", "webhook_url": "yourdomain.com/webhook", "metadata": { "phone": "016****" }, "amount": "10"}';$request = new Request('POST', 'https://pay.durontopaybd.cyou/api/payment/create', $headers, $body);$res = $client->sendAsync($request)->wait();echo $res->getBody();?> 
const axios = require('axios');let data = JSON.stringify({ "success_url": "yourdomain.com/success", "cancel_url": "yourdomain.com/cancel", "webhook_url": "yourdomain.com/webhook", "metadata": { "phone": "016****" }, "amount": "10"});let config = { method: 'post', maxBodyLength: Infinity, url: 'https://pay.durontopaybd.cyou/api/payment/create', headers: { 'API-KEY': 'gnXi7etgWNhFyFGZFrOMYyrmnF4A1eGU5SC2QRmUvILOlNc2Ef', 'Content-Type': 'application/json' }, data : data};axios.request(config).then((response) => { console.log(JSON.stringify(response.data));}).catch((error) => { console.log(error);}); 
import requestsimport jsonurl = "https://pay.durontopaybd.cyou/api/payment/create"payload = json.dumps({ "success_url": "yourdomain.com/success", "cancel_url": "yourdomain.com/cancel", "webhook_url": "yourdomain.com/webhook", "metadata": { "phone": "016****" }, "amount": "10"})headers = { 'API-KEY': 'gnXi7etgWNhFyFGZFrOMYyrmnF4A1eGU5SC2QRmUvILOlNc2Ef', 'Content-Type': 'application/json'}response = requests.request("POST", url, headers=headers, data=payload)print(response.text) 
package mainimport ( "fmt" "strings" "net/http" "io/ioutil")func main() { url := "https://pay.durontopaybd.cyou/api/payment/create" method := "POST" payload := strings.NewReader(`{"success_url":"yourdomain.com/success","cancel_url":"yourdomain.com/cancel","webhook_url":"yourdomain.com/webhook","metadata":{"phone":"01521412457"},"amount":"10"}`) client := &http.Client { } req, err := http.NewRequest(method, url, payload) if err != nil { fmt.Println(err) return } req.Header.Add("API-KEY", "gnXi7etgWNhFyFGZFrOMYyrmnF4A1eGU5SC2QRmUvILOlNc2Ef") req.Header.Add("Content-Type", "application/json") res, err := client.Do(req) if err != nil { fmt.Println(err) return } defer res.Body.Close() body, err := ioutil.ReadAll(res.Body) if err != nil { fmt.Println(err) return } fmt.Println(string(body))} 

Response Details

Field Name Type Description
Success Response
status bool TRUE
message String Message for Status
payment_url String Payment Link (where customers will complete their payment)
Error Response
status bool FALSE
message String Message associated with the error response
Completing Payment Page task you will be redirected to success or cancel page based on transaction status with the following Query Parameters: yourdomain.com/(success/cancel)?transactionId=******&paymentMethod=***&paymentAmount=**.**&paymentFee=**.**&status=pending or success or failed

Verify Request

<?php$curl = curl_init();curl_setopt_array($curl, array( CURLOPT_URL => 'https://pay.durontopaybd.cyou/api/payment/verify', CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => '', CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 0, CURLOPT_FOLLOWLOCATION => true, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_POSTFIELDS =>'{"transaction_id":"ABCDEFH"}', CURLOPT_HTTPHEADER => array( 'API-KEY: gnXi7etgWNhFyFGZFrOMYyrmnF4A1eGU5SC2QRmUvILOlNc2Ef', 'Content-Type: application/json' ),));$response = curl_exec($curl);curl_close($curl);echo $response;?> 
<?php$client = new Client();$headers = [ 'API-KEY' => 'gnXi7etgWNhFyFGZFrOMYyrmnF4A1eGU5SC2QRmUvILOlNc2Ef', 'Content-Type' => 'application/json'];$body = '{ "transaction_id": "ABCDEFH"}';$request = new Request('POST', 'https://pay.durontopaybd.cyou/api/payment/verify', $headers, $body);$res = $client->sendAsync($request)->wait();echo $res->getBody();?> 
const axios = require('axios');let data = JSON.stringify({ "transaction_id": "ABCDEFH"});let config = { method: 'post', maxBodyLength: Infinity, url: 'https://pay.durontopaybd.cyou/api/payment/verify', headers: { 'API-KEY': 'gnXi7etgWNhFyFGZFrOMYyrmnF4A1eGU5SC2QRmUvILOlNc2Ef', 'Content-Type': 'application/json' }, data : data};axios.request(config).then((response) => { console.log(JSON.stringify(response.data));}).catch((error) => { console.log(error);}); 
import http.clientimport jsonconn = http.client.HTTPSConnection("local.pay.expensivepay.com")payload = json.dumps({ "transaction_id": "ABCDEFH"})headers = { 'API-KEY': 'gnXi7etgWNhFyFGZFrOMYyrmnF4A1eGU5SC2QRmUvILOlNc2Ef', 'Content-Type': 'application/json'}conn.request("POST", "/api/payment/verify", payload, headers)res = conn.getresponse()data = res.read()print(data.decode("utf-8")) 
package mainimport ( "fmt" "strings" "net/http" "io/ioutil")func main() { url := "https://pay.durontopaybd.cyou/api/payment/verify" method := "POST" payload := strings.NewReader(`{"transaction_id":"ABCDEFH"}`) client := &http.Client { } req, err := http.NewRequest(method, url, payload) if err != nil { fmt.Println(err) return } req.Header.Add("API-KEY", "gnXi7etgWNhFyFGZFrOMYyrmnF4A1eGU5SC2QRmUvILOlNc2Ef") req.Header.Add("Content-Type", "application/json") res, err := client.Do(req) if err != nil { fmt.Println(err) return } defer res.Body.Close() body, err := ioutil.ReadAll(res.Body) if err != nil { fmt.Println(err) return } fmt.Println(string(body))} 
Sample Response
{ "cus_name": "John Doe", "cus_email": "[email protected]", "amount": "900.000", "transaction_id": "OVKPXW165414", "metadata": { "phone": "015****" }, "payment_method": "bkash", "status": "COMPLETED"} 

Response Details

Field Name Type Description
Success Response
status string COMPLETED or PENDING or ERROR
cus_name String Customer Name
cus_email String Customer Email
amount String Amount
transaction_id String Transaction id Generated by System
metadata json Metadata used for Payment creation
Error Response
status bool FALSE
message String Message associated with the error response

Wordpress Woocommerce Plugin Version

See Setup Video: YouTube Video

WHMCS Module

See Setup Video: How To Setup Video here

Modified SMM Panel Module

See Setup Video: Video here

Android Device Pairing & Sync API (v1)

DurontoPayBD's official Android companion app (com.durontopaybd.app) connects via HTTPS using two-way hashed device keys and periodic heartbeats — never direct database connections.

  • POST /api/v1/device/auth — Authenticate with email/password or Firebase ID token to obtain a short-lived user bearer token.
  • POST /api/v1/device/pair — Pair device using authenticated bearer token + one-time Device Key generated in Android App → Manage Device Keys. Returns revocable device_session_token.
  • POST /api/v1/device/heartbeat — Send periodic 30-second authenticated heartbeat with X-Device-ID header to report real-time Online/Offline status and permission health.
  • POST /api/v1/device/payment-event — Submit normalized bKash, Nagad, Rocket, or Upay payment notification events with idempotency keys (OTPs/personal SMS rejected; wallets are credited only after independent server verification).
  • POST /api/v1/device/disconnect — Disconnect device cleanly and invalidate its session credential.