bKash Payment Gateway API (Node.js)

This repository contains two separate backend projects:

• CHECKOUT (URL BASED) → bKash Checkout (URL Based)
• TOKENIZED CHECKOUT → bKash Tokenized Checkout

Postman demo collection: Bkash-Payment-Gateway-API.postman_collection.json

Repository: https://github.com/developer-sujon/bkash-payment-gateway

Requirements

• Node.js >= 18
• bKash sandbox/production credentials

Run (Checkout - URL Based)

cd "CHECKOUT (URL BASED)"
cp example.env .env
npm install
npm run server

Default URL:

• http://localhost:8080

Details: CHECKOUT (URL BASED)/README.md

Run (Tokenized Checkout)

cd "TOKENIZED CHECKOUT"
cp example.env .env
npm install
npm run server

Default URL:

• http://localhost:8080

Details: TOKENIZED CHECKOUT/README.md

Postman Demo

1. Postman → Import → import this file:
   • Bkash-Payment-Gateway-API.postman_collection.json
2. Set BASE_URL in Postman variables (Collection/Environment):
   • BASE_URL=http://localhost:8080/api/v1
3. Then run: createPayment → executePayment/callback → queryPayment → searchTransaction → refundTransaction/refundStatus.

Notes

• Both projects default to the same port (8080). If you want to run both at the same time, change PORT in one project’s .env.
• If sandbox credentials are public, do not use them in production. Rotate/regenerate credentials from the bKash portal.

Author

• Muhammad Sujon
• muhammad.sujon.cse@gmail.com