CartModules: Transbank Webpay Plus

Accept Webpay Plus Payments in Your CS-Cart Store

Integrate Transbank Webpay Plus -- Chile's national payment system -- directly into your CS-Cart or Multi-Vendor store. Accept payments via credit cards (Visa, Mastercard), debit cards (Redcompra), and prepaid cards through a secure hosted checkout flow.

Key Features

• Webpay Plus REST API -- Modern v1.2 REST integration with Transbank
• Redirect-Based Flow -- No card data touches your server (PCI SAQ A compliant)
• Automatic Confirmation -- Transaction is confirmed (PUT) on customer return, ensuring payment completion
• Multiple Payment Methods -- Credit cards (Visa, Mastercard), debit cards (Redcompra), and prepaid cards
• Sandbox/Production Toggle -- Switch between test and live environments from the admin panel
• Configurable Order Statuses -- Map Transbank response codes (Approved, Rejected) to any CS-Cart order status
• Secure Authentication -- Commerce Code + API Key sent via custom HTTP headers
• Idempotent Callbacks -- Duplicate callbacks are safely ignored
• CLP Currency -- Native Chilean Peso support with integer amounts (no decimals)

Requirements

• CS-Cart or Multi-Vendor 4.x
• PHP 7.1 or higher
• Transbank merchant account with Webpay Plus REST API credentials
• Store currency set to CLP (Chilean Peso)

How It Works

1. Customer selects Webpay Plus at checkout and clicks "Place Order"
2. The addon creates a transaction via the Transbank REST API
3. Customer is redirected to the Webpay Plus payment page
4. Customer enters their card details and authorizes the payment
5. Transbank redirects back to your store with a transaction token
6. The addon confirms (commits) the transaction and updates the order status

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 "Transbank Webpay Plus" as the processor
5. Enter your Commerce Code and API Key from the Transbank developer 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 Chile. Transbank Webpay Plus exclusively supports CLP (Chilean Peso). CLP has no decimal places -- amounts are sent as integers. Ensure your store's primary currency is CLP.

Sandbox Testing

Transbank provides sandbox credentials for testing:

• Commerce Code: 597055555532
• API Key: 579B532A7440BB0C9079DED94D31EA1615BACEB56610332264630D42D0A36B1C

Set the payment mode to "Test (Sandbox)" and use these credentials to place test orders before going live.