Developer API & SDKs

Built For Developers

BDGate provides a simple, modern JSON REST API that abstract the complexities of various mobile financial services. Instead of integrating separate, outdated SOAP or REST APIs for bKash, Nagad, and Rocket, developers only need to write a single implementation linking their system to BDGate's secure endpoint.

Endpoint Structure

All API requests are authenticated using a combination of your merchant client ID and API secret keys. Standard rate limits prevent system abuse while offering high throughput for transactional scaling.

Sample Request Payload

Initiating a payment transaction takes a simple POST request with the following structure:

{
  "amount": 1250.00,
  "currency": "BDT",
  "order_id": "ORD-2026-9812",
  "customer_name": "Rahim Uddin",
  "customer_email": "rahim@example.com",
  "customer_phone": "01712345678",
  "callback_url": "https://yourwebsite.com/payment/callback",
  "success_url": "https://yourwebsite.com/payment/success",
  "fail_url": "https://yourwebsite.com/payment/fail"
}
    

Real-Time Webhooks

Once a payment transaction is completed by the customer (whether verified automatically via MFS SMS Relay or settled via official gateways), BDGate posts a signed webhook payload to your registered listener URL. Each payload is signed with a cryptographic signature check signature in the headers (X-BDGate-Signature) to ensure it originated from BDGate.

Client SDKs

We provide official client libraries to simplify your integration process. Download and install them in your projects with standard package managers:

• Laravel (PHP): Install via Composer to leverage native package service providers and helpers.
• Node.js (npm): Fast implementation with Promise-based classes for payment initialization and webhook verification.

Full technical references, error code dictionaries, and testing sandbox keys are documented in detail at docs.bdgate.net.