Step-by-Step Instructions
Step 1: Access Integrations
Navigate to Dashboard → Integrations section.
Step 2: Initiate Connection
Find the bKash option in the Payment integrations and select “Connect” beneath it.
Step 3: Get Your bKash Merchant API Credentials
Sign in to the bKash Merchant portal and request Tokenized Checkout (Merchant Checkout) credentials. From the merchant dashboard, copy the four values bKash issues for your account: the API Username, the API Password, the App Key, and the App Secret. Sandbox credentials are issued for testing; production credentials are issued once your merchant account is approved for live transactions.
Step 4: Enter Your Credentials
In the connection modal, paste your Username, Password, App Key, and App Secret into the corresponding fields, then click “Connect”. Timetics AI stores these credentials securely against your workspace.
Step 5: Verify Connection
After the connection succeeds, select “Details” to confirm bKash is properly connected. You will see a status badge and a masked preview of your App Key and App Secret. Test the integration by creating a paid booking and completing payment through the bKash checkout flow.
Step 6: Disconnect (Optional)
To remove the integration, open the Details view and click “Disconnect”. The credentials will be removed from Timetics AI and bKash will no longer be available as a payment option for new bookings.
Key Functionality
Once integrated, bKash becomes available as a payment method for paid bookings in Timetics AI. When a customer books a paid appointment, Timetics AI uses your credentials to obtain a bKash id_token, creates a Tokenized Checkout payment with the booking’s amount and currency, and redirects the customer to the bKash checkout page. After the customer authorises payment, bKash redirects back to Timetics AI’s callback endpoint, which executes the payment, verifies the transaction status, and marks the booking as paid. Failed or cancelled payments redirect the customer to a failure page and mark the transaction as failed. Authorisation tokens are cached per integration and automatically refreshed before expiry, so no manual token management is required. The environment (sandbox or live) is selected automatically based on your Timetics AI deployment configuration, so no manual toggle is needed.
Prerequisites
- Active Timetics AI account on a plan that includes bKash
- bKash Merchant account with Tokenized Checkout enabled
- Tokenized Checkout API credentials from bKash: Username, Password, App Key, and App Secret
Notes
All four credentials — Username, Password, App Key, and App Secret — are required. bKash integration is gated by workspace plan, so if your plan does not include bKash, you will be prompted to upgrade before the connection modal opens. Currency for each transaction is taken from the booking; bKash Tokenized Checkout primarily processes BDT, so ensure your event pricing uses a currency supported by your merchant account. Customers are redirected away from Timetics AI to complete payment on bKash, and a callback completes the transaction — do not close the browser tab during checkout, or the payment may need to be re-verified before the booking is confirmed.