Superchat BD
Developer Docs
v1.0
Developer Platform v1

Superchat BD Developer Platform

Integrate secure payment acceptance into your websites, mobile apps, SaaS platforms, and e-commerce stores with hosted checkouts, instant bKash/Nagad/Upay processing, and automated webhooks.

5.00% Platform Fee

Developers enjoy a lower 5% flat platform fee on checkout payments, compared to 10% EPS / 20% Stripe for creator streaming tips.

Hosted Checkout

No PCI compliance headaches. Simply request a checkout session and redirect your customers to a secure, branded checkout page.

Cryptographic Webhooks

Every event is cryptographically signed with HMAC-SHA256 (`t=...,v1=...`) to verify origin and prevent tampering or replay attacks.

Built-in Idempotency

Send an `Idempotency-Key` header with charge requests to safely retry network timeouts without risking duplicate customer charges.

Official TypeScript SDK

`npm install @superchatbd/sdk` wraps every endpoint with typed requests, automatic idempotency keys, retries and webhook signature helpers.

Read the SDK reference →
Rate Limited & Audited

120 requests per minute per key, reported through `X-RateLimit-*` headers, and every request is written to your Developer Dashboard request log.

Acceptable Use Policy

Strict prohibitions on gambling, adult content, adult toys, SMM panels, and unauthorized goods.

Read prohibited categories →

How Integration Works

1

Generate Secret API Key

In your Developer Dashboard, create a secret API key (`sk_live_...` or `sk_test_...`).

2

Create a Payment Session

From your backend server, send `POST /api/v1/payments` with the charge amount, currency, and return URLs. Receive a hosted `checkoutUrl`.

3

Redirect Customer & Receive Webhook

Customer completes payment via bKash/Nagad/Cards. Superchat signs and dispatches a `payment.completed` event to your webhook endpoint.

Base API URLs

# Production API Server
REST

https://api.superchatbd.com/api/v1

# OpenAPI Spec Endpoint

https://api.superchatbd.com/openapi.json