CartModules: PortOne Payment Gateway

Accept Korean Payments in Your CS-Cart Store via PortOne

Integrate PortOne (formerly I'mport / 아임포트) — Korea's leading payment aggregator — directly into your CS-Cart or Multi-Vendor store. PortOne connects you to all major Korean payment methods including credit cards, KakaoPay, NaverPay, Toss Pay, Samsung Pay, virtual accounts, and more through a single, secure hosted checkout integration.

Key Features

• All Korean Payment Methods — Credit/debit cards, KakaoPay, NaverPay, Toss Pay, Samsung Pay, virtual accounts, phone billing
• Hosted Checkout Flow — No sensitive data touches your server (PCI SAQ A compliant)
• Server-Side Verification — Every payment is verified via the PortOne V2 API before updating order status
• Amount Validation — Pre-registers expected amount and validates paid amount to prevent tampering
• Multi-Currency Support — KRW (primary), JPY, USD, and more
• Test/Live Toggle — Switch between test and live channel keys from the admin panel
• Configurable Order Statuses — Map PortOne statuses (PAID, FAILED, PENDING) to any CS-Cart order status
• Webhook Support — Server-to-server notifications for reliable order updates
• Idempotent Callbacks — Duplicate callbacks are safely ignored
• KRW Integer Amounts — Correctly handles Korean Won (no decimals)

Supported Payment Methods

• Korean credit & debit cards (Samsung, Lotte, Hyundai, Shinhan, KB, etc.)
• KakaoPay
• NaverPay
• Toss Pay
• Samsung Pay
• Virtual accounts (bank transfer)
• Phone billing
• Convenience store payments

Requirements

• CS-Cart or Multi-Vendor 4.x
• PHP 7.1 or higher
• PortOne merchant account with V2 API credentials
• Store currency set to KRW (Korean Won) for Korean market, or JPY/USD as needed

How It Works

1. Customer selects PortOne at checkout and clicks "Place Order"
2. The addon pre-registers the expected amount with PortOne for validation
3. Customer is redirected to the PortOne hosted checkout page
4. Customer selects their preferred payment method and completes payment
5. Customer is redirected back to your store
6. The addon verifies the payment via the PortOne V2 API and validates the amount
7. Order status is updated automatically

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 "PortOne Payment Gateway" as the processor
5. Enter your Store ID, Channel Key, and API Secret from the PortOne admin console
6. Configure order status mappings as desired
7. Save and test with a test channel key before going live

Countries & Currencies

This addon is designed primarily for merchants selling in South Korea with KRW (Korean Won). PortOne also supports Japan (JPY) and global payments (USD). KRW and JPY amounts are handled as integers (no decimal places).

About PortOne

PortOne (formerly I'mport / 아임포트) is South Korea's leading payment aggregator, connecting merchants to all major Korean PGs (Payment Gateways) through a single integration. It supports the full spectrum of Korean payment methods and is trusted by thousands of Korean e-commerce businesses.