CartModules: Billplz Payment Gateway
Accept Malaysian Payments via Billplz in Your CS-Cart Store
Integrate Billplz -- Malaysia's popular payment collection platform -- directly into your CS-Cart or Multi-Vendor store. Accept payments via FPX online banking, credit/debit cards, and e-wallets including Boost, GrabPay, Touch 'n Go, ShopeePay, MAE, and DuitNow QR through a secure hosted payment page.
Key Features
- Multiple Payment Methods -- FPX (all major Malaysian banks), Visa/Mastercard, Boost, GrabPay, TNG, ShopeePay, MAE, DuitNow QR
- Redirect-Based Flow -- No sensitive data touches your server (PCI SAQ A compliant)
- Automatic Order Updates -- Payment verified via API on customer return and server-to-server webhook
- Webhook with XSignature -- HMAC-SHA256 signature verification for secure server-to-server callbacks
- Sandbox/Production Toggle -- Switch between test and live environments from the admin panel
- Configurable Order Statuses -- Map Billplz payment results to any CS-Cart order status
- Basic Auth API Security -- Secure API communication using Billplz's official authentication
- Idempotent Callbacks -- Duplicate callbacks are safely ignored
- MYR Currency -- Native Malaysian Ringgit support with automatic cents conversion
Requirements
- CS-Cart or Multi-Vendor 4.x
- PHP 7.1 or higher
- Billplz merchant account with API credentials
- Store currency set to MYR (Malaysian Ringgit)
How It Works
- Customer selects Billplz at checkout and clicks "Place Order"
- The addon creates a bill via Billplz API v3 and redirects the customer
- Customer selects their preferred payment method (FPX, card, or e-wallet)
- After payment, customer is redirected back to your store
- The addon verifies the payment status via API and updates the order
- A server-to-server webhook provides additional reliability
Supported Payment Methods
- FPX Online Banking -- Maybank, CIMB, Public Bank, RHB, Hong Leong, AmBank, Bank Islam, Bank Rakyat, and more
- Credit/Debit Cards -- Visa, Mastercard
- E-Wallets -- Boost, GrabPay, Touch 'n Go eWallet, ShopeePay, MAE by Maybank
- DuitNow QR -- Scan and pay via any DuitNow-enabled banking app
Installation
- Go to Add-ons > Manage add-ons, click Manual installation, and upload the addon zip
- Activate the addon and enter the license key
- Go to Administration > Payment methods and create a new payment method
- Select "Billplz Payment Gateway" as the processor
- Enter your API Secret Key and Collection ID from the Billplz dashboard
- Optionally enter the XSignature Key for webhook signature verification
- Configure order status mappings as desired
- Save and test with sandbox mode before going live
Country & Currency
This addon is designed for merchants selling in Malaysia. Billplz exclusively supports MYR (Malaysian Ringgit). Ensure your store's primary currency is MYR.
