API Introduction
Welcome to the BD Pay Developer API engine. Our high-performance REST API nodes allow you to route, process, and auto-verify automated Crypto payments (BEP20 / TRC20 / Binance Pay) and local payment methods safely inside your custom applications or automated billing setups.
Production API Base Endpoint Node: https://bdpay.co/api/v1
Authentication Loop
All outbound network security handshake queries require explicit verification layers passed directly inside your custom HTTP Request Headers arrays.
// đ°ī¸ Internal Security Header Authentication Structure
GET /api/v1/balance
HTTP Headers:
X-API-KEY: your_merchant_api_key_string
X-API-SECRET: your_merchant_secret_key_hashCreate Payment Request Node
Use this specific route endpoint to dynamically declare a new system transactional record object and retrieve a secure checkout payment link session window for the target payee.
/payment/create
| Parameter | Type | Description |
|---|---|---|
| amount | float / numeric | The expected transaction value in standard USD currency equivalent (Min 1.00). |
| order_id | string | Your unique alphanumeric internal order billing or reference ID (e.g. INV-1002). |
| method | string | Optional pre-set filter. Pass bep20, trc20, or binance to pre-select gateway mode. |
PHP cURL Native Integration Example:
<?php
$api_target = "https://bdpay.co/api/v1/payment/create";
$post_payload = [
'amount' => 25.50,
'order_id' => 'BDP-ORDER-' . time(),
'method' => 'bep20'
];
$ch = curl_init($api_target);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => http_build_query($post_payload),
CURLOPT_HTTPHEADER => [
'X-API-KEY: your_merchant_api_key_string',
'X-API-SECRET: your_merchant_secret_key_hash'
]
]);
$server_response = curl_exec($ch);
curl_close($ch);
$json_data = json_decode($server_response, true);
if (isset($json_data['success']) && $json_data['success'] === true) {
header("Location: " . $json_data['checkout_url']);
exit;
}
?>Supported Crypto Ledger Protocols
The runtime engine natively monitors real-time transaction handshakes via distributed RPC endpoints across these specific chain protocol configurations:
BNB Smart Chain (BEP20)
Tracks ledger deposits automatically inside your designated BSC recipient address configuration using verified BscScan RPC nodes with block timestamp lock.
TRON Network (TRC20)
Synchronizes inbound token adjustments directly through persistent internal server cron jobs tied directly to TronGrid RPC infrastructure loops.
Instant Payment Notification (IPN / Callback)
Once blockchain metadata sync settles successfully, our engine issues an automated secure asynchronous POST hook back to your designated listener hook route containing signature data.
// đ°ī¸ Sample Server-to-Server IPN Outbound Callback JSON Format
{
"status": "success",
"invoice_id": "API8F41A2D",
"order_id": "INV-1002",
"amount_received": "25.50",
"crypto_method": "bep20",
"signature_hash": "62e5b7c7b120f269c3a36237..."
}GSM Theme Integration Guide
GSM Theme (Laravel Platform) āĻ BD Pay āĻā§āĻāĻāĻ¯āĻŧā§ āĻ¯ā§āĻā§āĻ¤ āĻāĻ°āĻžāĻ° āĻ¸āĻŽā§āĻĒā§āĻ°ā§āĻŖ āĻĒā§āĻ°āĻā§āĻ°āĻŋāĻ¯āĻŧāĻž āĻ¨āĻŋāĻā§ āĻ§āĻžāĻĒā§ āĻ§āĻžāĻĒā§ āĻĻā§āĻāĻ¯āĻŧāĻž āĻšāĻ˛ā§:
1 āĻā§āĻāĻāĻ¯āĻŧā§ āĻā§āĻ˛āĻžāĻ¸ āĻĢāĻžāĻāĻ˛ āĻāĻĒāĻ˛ā§āĻĄ āĻāĻ°ā§āĻ¨
āĻāĻĒāĻ¨āĻžāĻ° GSM Theme āĻ¸āĻžāĻ°ā§āĻāĻžāĻ°ā§āĻ° āĻĢāĻžāĻāĻ˛ āĻŽā§āĻ¯āĻžāĻ¨ā§āĻāĻžāĻ°ā§ āĻ¯āĻžāĻ¨ āĻāĻŦāĻ āĻ¨āĻŋāĻā§āĻ° āĻ˛ā§āĻā§āĻļāĻ¨ā§ Bdpay.php āĻĢāĻžāĻāĻ˛āĻāĻŋ āĻ¤ā§āĻ°āĻŋ āĻāĻ°ā§āĻ¨:
2 āĻ˛ā§āĻā§ āĻāĻĒāĻ˛ā§āĻĄ āĻāĻ°ā§āĻ¨
BD Pay āĻāĻ° āĻ˛ā§āĻā§āĻāĻŋ āĻĄāĻžāĻāĻ¨āĻ˛ā§āĻĄ āĻāĻ°ā§ āĻāĻĒāĻ¨āĻžāĻ° GSM Theme āĻāĻ° āĻĒāĻžāĻŦāĻ˛āĻŋāĻ āĻĢā§āĻ˛ā§āĻĄāĻžāĻ°ā§ āĻāĻĒāĻ˛ā§āĻĄ āĻāĻ°ā§āĻ¨:
3 āĻ ā§āĻ¯āĻžāĻĄāĻŽāĻŋāĻ¨ āĻĒā§āĻ¯āĻžāĻ¨ā§āĻ˛ āĻāĻ¨āĻĢāĻŋāĻāĻžāĻ°ā§āĻļāĻ¨
- GSM Theme āĻāĻ° Admin Panel > Payment Gateways āĻ āĻĒā§āĻ°āĻŦā§āĻļ āĻāĻ°ā§āĻ¨āĨ¤
- BD PAY āĻā§āĻāĻāĻ¯āĻŧā§āĻāĻŋ āĻā§āĻāĻā§ āĻĒā§ā§ā§ Edit āĻŦāĻžāĻāĻ¨ā§ āĻā§āĻ˛āĻŋāĻ āĻāĻ°ā§āĻ¨āĨ¤
- āĻāĻĒāĻ¨āĻžāĻ° BD Pay āĻŽāĻžāĻ°ā§āĻā§āĻ¨ā§āĻ āĻĄā§āĻ¯āĻžāĻļāĻŦā§āĻ°ā§āĻĄ āĻĨā§āĻā§ āĻĒā§āĻ°āĻžāĻĒā§āĻ¤ API Key āĻāĻŦāĻ API Secret āĻŦāĻ¸āĻŋā§ā§ āĻĻāĻŋāĻ¨āĨ¤
- Settlement Currency āĻĄā§āĻ°āĻĒāĻĄāĻžāĻāĻ¨ āĻĨā§āĻā§ āĻāĻĒāĻ¨āĻžāĻ° āĻĒāĻāĻ¨ā§āĻĻ āĻ āĻ¨ā§āĻ¯āĻžā§ā§ USD ($) āĻŦāĻž BDT (ā§ŗ) āĻ¸āĻŋāĻ˛ā§āĻā§āĻ āĻāĻ°ā§ Save āĻāĻ°ā§āĻ¨āĨ¤
Dhru Fusion Integration Guide
Dhru Fusion GSM āĻ¸āĻžāĻ°ā§āĻāĻžāĻ° āĻ¸āĻĢāĻāĻāĻ¯āĻŧā§āĻ¯āĻžāĻ°ā§ BD Pay āĻĒā§āĻ˛āĻžāĻāĻāĻ¨ āĻāĻ¨āĻ¸ā§āĻāĻ˛ āĻāĻ°āĻžāĻ° āĻ¨āĻŋāĻ¯āĻŧāĻŽ:
1 āĻŽāĻĄāĻŋāĻāĻ˛ āĻĢāĻžāĻāĻ˛āĻā§āĻ˛ā§ āĻāĻĒāĻ˛ā§āĻĄ āĻāĻ°ā§āĻ¨
āĻāĻĒāĻ¨āĻžāĻ° Dhru Fusion āĻ°ā§āĻ āĻĢā§āĻ˛ā§āĻĄāĻžāĻ°ā§ āĻ¨āĻŋāĻā§āĻ° āĻĄāĻŋāĻ°ā§āĻā§āĻāĻ°āĻŋ āĻ āĻ¨ā§āĻ¯āĻžā§ā§ āĻĢāĻžāĻāĻ˛āĻā§āĻ˛ā§ āĻāĻā§āĻ¸āĻā§āĻ°ā§āĻ¯āĻžāĻā§āĻ āĻāĻ°ā§ āĻĻāĻŋāĻ¨:
đ modules/gateways/bdpay/bdpay_process.php
đ modules/gateways/bdpay/logo.png
2 Dhru Fusion āĻ ā§āĻ¯āĻžāĻĄāĻŽāĻŋāĻ¨ āĻĒā§āĻ¯āĻžāĻ¨ā§āĻ˛ āĻ¸āĻā§āĻ°āĻŋāĻ¯āĻŧāĻāĻ°āĻŖ
- Dhru Fusion āĻāĻ° āĻ ā§āĻ¯āĻžāĻĄāĻŽāĻŋāĻ¨ā§ āĻ˛āĻāĻāĻ¨ āĻāĻ°ā§ Settings > Payment Gateways āĻ āĻ¯āĻžāĻ¨āĨ¤
- All Gateways āĻā§āĻ¯āĻžāĻŦ āĻĨā§āĻā§ BD PAY āĻā§āĻāĻā§ā§āĻāĻŋ āĻā§āĻāĻā§ āĻŦā§āĻ° āĻāĻ°ā§ Activate āĻŦāĻžāĻāĻ¨ā§ āĻā§āĻ˛āĻŋāĻ āĻāĻ°ā§āĻ¨āĨ¤
- āĻā§āĻāĻā§ā§ āĻ¸ā§āĻāĻŋāĻāĻ¸ā§ āĻāĻŋā§ā§ āĻāĻĒāĻ¨āĻžāĻ° BD Pay API Key āĻ API Secret āĻĻāĻŋāĻ¨āĨ¤
- Exchange Rate āĻ āĻŋāĻ āĻāĻ°ā§āĻ¨ (āĻ¯ā§āĻŽāĻ¨: 1 USD = āĻāĻ¤ BDT āĻšāĻŦā§) āĻāĻŦāĻ Save Changes āĻĻāĻŋāĻ¨āĨ¤
đĄ āĻĒā§āĻ°ā§ āĻāĻŋāĻĒ: Dhru Fusion āĻ āĻā§āĻ¸ā§āĻ āĻĒā§āĻŽā§āĻ¨ā§āĻ āĻ¸āĻĢāĻ˛ āĻšāĻā§āĻžāĻ° āĻĒāĻ° āĻāĻ¨āĻā§ā§āĻ¸ āĻ āĻā§āĻŽā§āĻāĻŋāĻ āĻĒā§āĻāĻĄ āĻšā§ā§ āĻā§āĻ˛āĻžāĻ¯āĻŧā§āĻ¨ā§āĻā§āĻ° āĻŦā§āĻ¯āĻžāĻ˛ā§āĻ¨ā§āĻ¸ āĻĢāĻžāĻ¨ā§āĻĄ āĻ ā§āĻ¯āĻžāĻāĻžāĻāĻ¨ā§āĻā§ āĻ¸ā§āĻŦā§āĻāĻā§āĻ°āĻŋā§āĻāĻžāĻŦā§ āĻā§āĻ°ā§āĻĄāĻŋāĻ āĻšā§ā§ āĻ¯āĻžāĻŦā§āĨ¤
System Exception & Error Declarations
Inbound request processing failure routes return specific standard JSON failure payloads:
{"success": false, "error_code": "IP_RESTRICTED", "message": "API Request source IP does not match the protected host locker routing node configuration."}