CartModules: KG Inicis Payment Gateway

Accept payments from South Korean customers through KG Inicis, the country's largest and most trusted payment gateway. This addon integrates the Inicis Standard Payment API (Web Standard) with your CS-Cart or Multi-Vendor store, providing a secure redirect-based checkout experience.

Key Features

• KG Inicis Standard Payment — Uses the official Web Standard (INIpay) integration, trusted by thousands of Korean e-commerce stores.
• Redirect-Based Checkout — Customers are redirected to the secure INIpay hosted payment page. No card data touches your server (PCI SAQ A compliant).
• SHA-256 Signed Requests — Every payment request is cryptographically signed to prevent tampering.
• Two-Step Payment Flow — Auth + Approval model ensures reliable payment capture with full server-side verification.
• Sandbox & Live Modes — Test your integration with the Inicis sandbox before going live. One-click switching in the admin panel.
• KRW Currency Support — Optimized for Korean Won with correct zero-decimal handling.
• Idempotent Callbacks — Duplicate notifications are safely ignored, preventing double-processing of orders.
• Server-to-Server Notifications — Supports background notification mode for reliable order updates even if the customer's browser disconnects.
• Order Status Mapping — Configure which CS-Cart order status to assign for approved and failed payments.
• Comprehensive Logging — All payment events are logged with sensitive data automatically stripped for security.

How It Works

1. Customer clicks "Place Order" in your CS-Cart checkout.
2. The addon generates a SHA-256 signed payment request.
3. Customer is redirected to the INIpay hosted checkout page.
4. Customer selects their payment method (credit card, bank transfer, etc.) and completes the payment.
5. Inicis sends the auth result back to your store.
6. The addon verifies and requests payment approval from Inicis.
7. Order status is updated automatically and the customer sees the confirmation page.

Configuration

Setup takes just a few minutes. Enter your KG Inicis credentials in the payment method settings:

• Merchant ID (MID) — Your KG Inicis merchant identifier.
• Sign Key — Used for SHA-256 signature generation.
• API Key — Used for payment approval requests.
• Payment Mode — Switch between Test (Sandbox) and Live (Production).

Requirements

• CS-Cart or Multi-Vendor 4.x
• PHP 7.1 or higher
• SSL certificate (HTTPS required for callbacks)
• KG Inicis merchant account

Compatibility

• CS-Cart 4.x (all editions)
• Multi-Vendor 4.x
• Multi-Vendor Plus 4.x
• CS-Cart Ultimate

Security

• SHA-256 cryptographic signatures on all payment requests
• SSL/TLS verification enforced on all HTTP communications
• No credit card data stored or processed on your server
• Parameterized database queries prevent SQL injection
• Sensitive credentials automatically stripped from log files
• Idempotent callback handling prevents duplicate order processing

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 with the KG Inicis processor.
4. Enter your MID, Sign Key, and API Key.
5. Select Test mode, place a test order, then switch to Live when ready.