CartModules: ZaloPay Payment Gateway

Accept ZaloPay Payments in Your CS-Cart Store

Integrate ZaloPay — Vietnam's leading e-wallet and payment gateway by VNG Corporation — directly into your CS-Cart or Multi-Vendor store. Customers complete payment using their ZaloPay wallet, bank cards, or ATM transfers through a secure hosted checkout flow.

Key Features

• ZaloPay Hosted Checkout — Customers pay via ZaloPay wallet, Visa/Mastercard, or ATM
• Redirect-Based Flow — No sensitive data touches your server (PCI SAQ A compliant)
• Server-to-Server Callbacks — Reliable payment confirmation via HMAC-SHA256 verified notifications
• Automatic Order Updates — Orders are finalized on callback with query verification on return
• Sandbox/Production Toggle — Switch between test and live environments from the admin panel
• Configurable Order Statuses — Map ZaloPay results (Success, Failed) to any CS-Cart order status
• HMAC-SHA256 Authentication — Secure request signing (Key 1) and callback verification (Key 2)
• Idempotent Callbacks — Duplicate callbacks are safely ignored
• VND Currency — Native Vietnamese Dong support with integer amounts

Requirements

• CS-Cart or Multi-Vendor 4.x
• PHP 7.1 or higher
• ZaloPay merchant account with API credentials (App ID, Key 1, Key 2)
• Store currency set to VND (Vietnamese Dong)

How It Works

1. Customer selects ZaloPay at checkout and clicks "Place Order"
2. The addon creates an order via ZaloPay API with HMAC-SHA256 signature
3. Customer is redirected to the ZaloPay payment page to complete the payment
4. ZaloPay sends a server callback to confirm payment (verified with Key 2)
5. Customer is redirected back to your store and sees the order confirmation

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 "ZaloPay Payment Gateway" as the processor
5. Enter your App ID, Key 1, and Key 2 from the ZaloPay 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 Vietnam. ZaloPay exclusively supports VND (Vietnamese Dong). Ensure your store's primary currency is VND. All amounts are sent as integers (no decimal places).