CartModules: bKash Payment Gateway

Accept bKash Mobile Payments in Your CS-Cart Store

Integrate bKash — Bangladesh's largest mobile financial service with over 70 million registered users — directly into your CS-Cart or Multi-Vendor store. Customers complete payment using their bKash wallet through a secure hosted checkout flow.

Key Features

• bKash Tokenized Checkout — Customers pay via the bKash app or web interface
• Redirect-Based Flow — No sensitive data touches your server (PCI SAQ A compliant)
• Automatic Order Updates — Payment is executed and verified on customer return
• Sandbox/Production Toggle — Switch between test and live environments from the admin panel
• Configurable Order Statuses — Map bKash statuses (Completed, Failed) to any CS-Cart order status
• Bearer Token Authentication — Secure API communication using bKash's official auth flow
• Idempotent Callbacks — Duplicate callbacks are safely ignored
• BDT Currency — Native Bangladeshi Taka support

Requirements

• CS-Cart or Multi-Vendor 4.x
• PHP 7.1 or higher
• bKash merchant account with Tokenized Checkout API credentials
• Store currency set to BDT (Bangladeshi Taka)

How It Works

1. Customer selects bKash at checkout and clicks "Place Order"
2. The addon authenticates with bKash and creates a payment session
3. Customer is redirected to the bKash checkout page to approve the payment
4. After approval, customer is redirected back to your store
5. The addon executes and verifies the payment, then updates the order status

Installation

1. Go to Add-ons > Manage add-ons, click Manual installation, and upload the addon zip
2. Activate the addon and enter the license key
3. Go to Administration > Payment methods and create a new payment method
4. Select "bKash Payment Gateway" as the processor
5. Enter your App Key, App Secret, Username, and Password from the bKash merchant portal
6. Configure order status mappings as desired
7. Save and test with sandbox mode before going live

Country & Currency

This addon is designed for merchants selling in Bangladesh. bKash exclusively supports BDT (Bangladeshi Taka). Ensure your store's primary currency is BDT.