SeoulCommerce KG INICIS Pro for WooCommerce

Description

This plugin adds a payment gateway to WooCommerce to accept payments through KG INICIS Pro. It triggers the INIPayPro payment window at checkout, then verifies and approves the payment via the INICIS REST approval endpoint before completing the order in WooCommerce.

Features:

• Supports KG INICIS Pro (CARD) payment flow (Classic + Checkout Blocks)
• Server-side approval after auth callback
• Full and partial refunds via INIAPI v2
• Test mode support
• Debug logging via WooCommerce logger

Testing

Use the following test credentials to run end-to-end payments immediately:

• MID (Merchant ID): INIpayTest
• Mobile HashKey: 3CB8183A4BE283555ACC8363C0360223

Notes for INICIS test environment:

• Test transactions are real authorizations and are automatically canceled before 24:00 (same day).
• For virtual account (vbank) deposits, refunds must be initiated via the merchant admin or refund API (not auto-canceled).
• Some cards (e.g., KB/Kookmin, KakaoBank) may not be available for testing due to issuer policy; please try a different card if you encounter an error.
• IDC Center Code values returned by INICIS include fc, ks, stg and are handled automatically by the gateway.

How to test:

1. Create a simple product and add it to the cart.
2. Go to Checkout and select “KG INICIS Pro”.
3. The INIPayPro payment window will open. Complete the payment.
4. You will be redirected back; the order should be marked as paid.

Troubleshooting:

• If you see “No payment methods available”, ensure the gateway is enabled and both MID and Mobile HashKey are set.
• If the payment window does not open, ensure jQuery is not removed by your theme and that no CSP blocks third-party scripts.
• If approval fails with DNS errors, your host must allow outbound HTTPS to paypro.inicis.com and subdomains like kspaypro.inicis.com.
• Enable “Debug logging” in the gateway settings and check WooCommerce > Status > Logs (source: inicis-pro).

Refunds (Full & Partial)

This plugin supports refunds via INICIS v2 API directly from the WooCommerce order screen.

Setup:

• INIAPI Key: required for refunds. For the INIpayTest MID, use ItEQKi3rY7uvDS8l (from INICIS test docs).
• Client IP: optional. Set a fixed IP if your INIAPI profile requires whitelisting; otherwise it will use the server IP.

Usage:

• Full refund: create a refund for the full order amount; the plugin calls v2/pg/refund.
• Partial refund: enter a partial amount; the plugin calls v2/pg/partialRefund with the appropriate remaining amount.
• Results and any errors are logged when Debug logging is enabled.

External Services

This plugin connects to external services provided by KG INICIS and SeoulCommerce to process payments:

KG INICIS Payment Services:
– Service: KG INICIS Pro payment gateway for processing credit card transactions
– Data sent: Payment information including order amount, merchant ID, customer details, and transaction data
– When: Every time a customer makes a payment using this gateway
– Purpose: To authenticate and process credit card payments securely
– INICIS Terms of Service: https://www.inicis.com/terms
– INICIS Privacy Policy: https://www.inicis.com/privacy

SeoulCommerce API Key Validation:
– Service: API key validation service for live mode activation
– Data sent: Website URL, API key, plugin version, and timestamp
– When: When validating API keys in admin settings or during live mode operation
– Purpose: To verify authorized usage of the plugin in live mode
– SeoulCommerce Terms: https://seoulcommerce.com/terms
– SeoulCommerce Privacy: https://seoulcommerce.com/privacy