CartModules: EBANX Payment Gateway

Accept Payments Across Latin America

Expand your CS-Cart or Multi-Vendor store into Latin America with EBANX, the leading cross-border payment platform for the region. This addon integrates EBANX's redirect-based payment flow, allowing your customers to pay with the local methods they know and trust — no PCI compliance headaches for you.

Supported Payment Methods

• PIX — Brazil's instant payment system (real-time settlement)
• Boleto Bancario — Brazil's most popular offline payment voucher
• OXXO — Mexico's largest convenience store cash payment network
• Local Credit & Debit Cards — Visa, Mastercard, Elo, Hipercard, and more
• Bank Transfers — Direct bank-to-bank transfers across LatAm countries
• Digital Wallets — Region-specific digital wallet options

Supported Countries & Currencies

• Brazil (BRL)
• Mexico (MXN)
• Colombia (COP)
• Argentina (ARS)
• Chile (CLP)
• Peru (PEN)
• Uruguay (UYU)
• Ecuador

Key Features

• Redirect-based flow — Customers are redirected to EBANX's hosted payment page. Your store never handles raw card data (PCI SAQ A compliant).
• Sandbox / Live toggle — Switch between EBANX sandbox and production environments directly from the admin panel.
• Webhook support — Automatic order status updates via EBANX server-to-server notifications.
• Status mapping — Map EBANX payment statuses (Confirmed, Cancelled, Pending) to your preferred CS-Cart order statuses.
• Multi-currency — Configure the settlement currency per payment method (BRL, MXN, COP, ARS, CLP, PEN, UYU).
• Idempotent callbacks — Safe handling of duplicate webhook notifications and browser returns.
• Secure logging — All API communication is logged with sensitive data (integration keys) automatically stripped.

Requirements

• CS-Cart or Multi-Vendor 4.x
• An active EBANX merchant account (https://www.ebanx.com/en/business)
• PHP 7.0 or later
• SSL certificate on your store (HTTPS)

Installation

1. Upload the addon ZIP via Add-ons > Manage add-ons > Upload add-on.
2. Activate CartModules: EBANX Payment Gateway.
3. Go to Administration > Payment methods and create a new payment method.
4. Select EBANX Payment Gateway as the processor.
5. Enter your EBANX integration key, select your currency, and configure status mappings.
6. Set Payment mode to Test (Sandbox) to verify, then switch to Live when ready.