CartModules: Toss Payments Gateway

Overview

Accept payments from South Korean customers using Toss Payments, one of the most popular payment gateways in South Korea. This addon integrates Toss Payments with your CS-Cart or Multi-Vendor store, enabling a seamless checkout experience with a wide range of local payment methods.

Supported Payment Methods

• Credit/Debit Cards — Visa, Mastercard, local Korean cards (Samsung, Shinhan, Hyundai, etc.)
• Samsung Pay — Mobile payments via Samsung devices
• Naver Pay — One of Korea's most used digital wallets
• Kakao Pay — Pay with KakaoTalk messenger wallet
• Bank Transfer — Direct bank account transfers

Key Features

• Redirect-based checkout — PCI DSS SAQ A compliant (no card data handled by your server)
• Supports KRW (Korean Won) and USD currencies
• Webhook support for real-time payment status updates (PAYMENT_STATUS_CHANGED)
• Configurable order status mapping for approved, declined, and failed payments
• Test mode with Toss sandbox keys (test_sk_ / test_ck_ prefixed keys)
• Secure API communication with HTTP Basic Auth
• Amount verification to prevent tampering
• Idempotent callback processing — duplicate notifications handled safely
• Detailed payment logging with sensitive data stripped

Compatibility

• CS-Cart 4.x
• Multi-Vendor 4.x
• CS-Cart Ultimate
• PHP 7.2+

Target Market

South Korea — Ideal for stores targeting Korean consumers who prefer local payment methods such as Samsung Pay, Naver Pay, Kakao Pay, and domestic bank transfers.

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 Toss Payments Gateway as the processor.
5. Enter your Toss Payments Secret key and Client key from the Toss developer dashboard.
6. Select your preferred currency (KRW or USD).
7. Configure order status mappings as desired.
8. Save and test with sandbox keys before going live.