CartModules: PayU Latam Payment Gateway

Accept Payments Across Latin America in Your CS-Cart Store

Integrate PayU Latam -- Latin America's leading payment gateway -- directly into your CS-Cart or Multi-Vendor store. Accept credit/debit cards, bank transfers, cash payments, and local payment methods from customers in Colombia, Mexico, Argentina, Brazil, Chile, Peru, and Panama.

Key Features

• PayU Webcheckout Integration -- Customers pay on PayU's secure hosted page
• Redirect-Based Flow -- No sensitive data touches your server (PCI SAQ A compliant)
• 7 Latin American Countries -- Colombia, Mexico, Argentina, Brazil, Chile, Peru, Panama
• 7 Currencies Supported -- COP, MXN, ARS, BRL, CLP, PEN, USD
• Multiple Payment Methods -- Visa, Mastercard, AMEX, Diners, PSE, OXXO, Baloto, bank references, cash
• MD5 Signature Verification -- Secure request and response validation
• Server-to-Server Confirmation -- Reliable order updates via PayU's confirmation callback
• Sandbox/Production Toggle -- Switch between test and live environments from the admin panel
• Configurable Order Statuses -- Map PayU states (Approved, Pending, Declined) to any CS-Cart order status
• Idempotent Callbacks -- Duplicate confirmations are safely ignored
• COP Decimal Handling -- Correct 1-decimal formatting for Colombian Peso

Supported Payment Methods by Country

• Colombia (COP) -- Visa, MC, AMEX, Diners, PSE, Baloto, BancoOccidente, cash
• Mexico (MXN) -- Visa, MC, AMEX, OXXO, bank references
• Argentina (ARS) -- Visa, MC, AMEX, Diners
• Brazil (BRL) -- Visa, MC, AMEX, Boleto Bancario
• Chile (CLP) -- Visa, MC, AMEX, Diners
• Peru (PEN) -- Visa, MC, AMEX, Diners
• Panama (USD) -- Visa, MC, AMEX

Requirements

• CS-Cart or Multi-Vendor 4.x
• PHP 7.1 or higher
• PayU Latam merchant account with API credentials (Merchant ID, Account ID, API Key)

How It Works

1. Customer selects PayU Latam at checkout and clicks "Place Order"
2. The addon builds a signed form and redirects to PayU's Webcheckout page
3. Customer selects a payment method (card, PSE, OXXO, etc.) and completes the payment
4. PayU sends a server-to-server confirmation with the transaction result
5. Customer is redirected back to your store with 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 "PayU Latam Payment Gateway" as the processor
5. Enter your Merchant ID, Account ID, and API Key from the PayU Latam dashboard
6. Select the appropriate currency for your target country
7. Configure order status mappings as desired
8. Save and test with sandbox mode before going live

Countries & Currencies

This addon is designed for merchants selling in Latin America. PayU Latam supports COP, MXN, ARS, BRL, CLP, PEN, and USD. Each PayU Account ID is country-specific -- use the correct Account ID for your target market.