bKash is Bangladesh's most widely used mobile financial service (MFS), with over 60 million registered users. WP SmartPay Pro integrates bKash's Payment Gateway API, allowing you to accept bKash payments directly on your WordPress site.

Prerequisites

  • A bKash Merchant account — apply at bkash.com/business.
  • Your bKash API credentials from the bKash Merchant Portal.
  • WP SmartPay Pro with a valid license.
  • HTTPS on your site.

Country Availability

bKash is only available to businesses registered in Bangladesh. Customers must have a bKash account (personal or merchant) to pay.

Finding Your bKash API Credentials

  1. Log in to the bKash Merchant Portal.
  2. Navigate to API Credentials.
  3. Copy your App Key, App Secret, Username, and Password.
  4. bKash provides separate credentials for sandbox (test) and production (live) — copy both sets.

Connecting bKash in SmartPay

  1. Go to SmartPay → Settings → Payment Gateways.
  2. Find bKash and tick Enable.
  3. Enter your Live App Key, App Secret, Username, and Password.
  4. Enter the same fields for your Sandbox credentials.
  5. Click Save Settings.
Screenshot of WP SmartPay bKash settings showing App Key, App Secret, Username and Password fields
bKash settings — enter your App Key, App Secret, Username, and Password for both live and sandbox environments.

Test Mode Configuration

Toggle Test Mode on in SmartPay. Use bKash's sandbox credentials and the test phone numbers provided in the bKash developer documentation to simulate payments.

How bKash Checkout Works

When a customer chooses bKash at checkout:

  1. SmartPay creates a bKash payment token via the API.
  2. The customer is redirected to bKash's hosted payment page (or a PIN entry screen on mobile).
  3. After approval on the bKash app, the customer is returned to your site.
  4. SmartPay receives the payment callback and confirms the status.

Supported Currencies

Bangladeshi Taka (BDT) only.

Common Errors & Fixes

  • "Invalid credentials" — App Key, App Secret, Username, or Password is incorrect. Copy credentials again from the bKash Merchant Portal carefully — some fields are case-sensitive.
  • Sandbox payments not completing — Use only the test phone numbers provided in bKash's sandbox documentation; real bKash numbers will not work in sandbox mode.
  • Payment expired — bKash tokens expire after a short period (typically 60 seconds). If the customer takes too long to enter their PIN, the transaction expires and must be retried.