CartModules: Lyra / PayZen Payment Gateway

Accept Payments in France, Brazil, and Latin America with Your CS-Cart Store

Integrate Lyra Collect / PayZen — one of Europe and Latin America's leading payment platforms — directly into your CS-Cart or Multi-Vendor store. Customers pay using cards, local payment methods, Apple Pay, and Google Pay through a secure checkout flow.

Key Features

• Dual Checkout Modes — Choose between redirect (hosted page) or inline (embedded SmartForm) checkout
• On-Site Payment — Inline mode keeps customers on your store during payment
• Apple Pay & Google Pay — Accept wallet payments in inline mode on supported devices
• Multi-Regional Support — France, Brazil, Chile, Colombia, Peru, Argentina
• 300+ Payment Methods — Cards (Visa, MC, AMEX), Boleto, PIX, Webpay, PSE, PagoEfectivo, and more
• Redirect or Inline Flow — Choose hosted page or embedded SmartForm checkout
• Multi-Currency — EUR, USD, BRL, CLP, COP, PEN, ARS
• REST API v4 — Modern RESTful API with HTTP Basic Auth
• IPN Notifications — Server-to-server updates with HMAC-SHA256 signature verification
• Automatic Order Updates — Payment verified via API on customer return and via IPN
• Sandbox/Production Toggle — Switch between test and live environments
• Configurable Order Statuses — Map Lyra statuses (PAID, REFUSED, PENDING) to any CS-Cart order status
• Idempotent Callbacks — Duplicate callbacks and IPNs are safely ignored

Supported Countries & Payment Methods

• France — CB, Visa, Mastercard, AMEX, Apple Pay, Google Pay
• Brazil — Boleto, PIX, Visa, Mastercard, Elo
• Chile — Webpay, Visa, Mastercard
• Colombia — PSE, Visa, Mastercard
• Peru — PagoEfectivo, Visa, Mastercard
• Argentina — Visa, Mastercard, local cards

Requirements

• CS-Cart or Multi-Vendor 4.x
• PHP 7.1 or higher
• Lyra Collect or PayZen merchant account with REST API credentials

How It Works

1. Customer selects Lyra/PayZen at checkout and clicks "Place Order"
2. The addon creates a payment via Lyra's REST API v4
3. Customer is redirected to Lyra's hosted payment page (or embedded SmartForm in inline mode)
4. Customer selects their preferred method and completes payment
5. Customer is redirected back to your store
6. The addon verifies the payment via API and updates the order status
7. For async methods (boleto, PIX), an IPN updates the order when payment is confirmed

Checkout Modes

• Redirect (Default) — Customer is redirected to Lyra's secure hosted payment page
• Inline (Embedded) — Lyra SmartForm JS SDK renders an embedded payment form directly on your checkout page, with support for Apple Pay and Google Pay

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 "Lyra / PayZen Payment Gateway" as the processor
5. Select your API endpoint (Lyra or PayZen)
6. Enter your Shop ID, REST API keys, and HMAC keys from the Lyra/PayZen back office
7. Configure order status mappings as desired
8. Save and test with test mode before going live

Security

• PCI SAQ A compliant — redirect/inline flow, no card data on your server
• HTTP Basic Auth with REST API keys
• IPN verification via HMAC-SHA256 cryptographic signatures
• Sensitive credentials masked in all log entries
• Idempotent processing prevents duplicate charges
• SSL verification enabled on all API requests