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

1. Customer selects Billplz at checkout and clicks "Place Order"
2. The addon creates a bill via Billplz API v3 and redirects the customer
3. Customer selects their preferred payment method (FPX, card, or e-wallet)
4. After payment, customer is redirected back to your store
5. The addon verifies the payment status via API and updates the order
6. 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

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 "Billplz Payment Gateway" as the processor
5. Enter your API Secret Key and Collection ID from the Billplz dashboard
6. Optionally enter the XSignature Key for webhook signature verification
7. Configure order status mappings as desired
8. 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.