SeoulCommerce KG INICIS Pro for WooCommerce

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

한국어 설명 (Korean Description)

이 플러그인은 WooCommerce에 KG INICIS Pro 결제 게이트웨이를 추가합니다. 체크아웃 시 INIPayPro 결제 창을 호출하고, INICIS REST 승인 엔드포인트를 통해 결제를 검증 및 승인한 후 WooCommerce에서 주문을 완료합니다.

기능:

• KG INICIS Pro (카드) 결제 플로우 지원 (클래식 + 체크아웃 블록)
• 인증 콜백 후 서버 측 승인
• INIAPI v2를 통한 전체 및 부분 환불
• 테스트 모드 지원
• WooCommerce 로거를 통한 디버그 로깅

설치 방법 (Installation)

1. 플러그인 폴더를 /wp-content/plugins/에 업로드하거나 WordPress 플러그인 화면을 통해 설치하세요.
2. WordPress의 ‘플러그인’ 화면에서 플러그인을 활성화하세요.
3. WooCommerce > 설정 > 결제로 이동하여 «KG INICIS Pro»를 활성화하고 가맹점 ID와 모바일 HashKey를 입력하세요.
4. 한국어 번역을 사용하려면 사이트 언어를 한국어(ko_KR)로 설정하세요. 이 플러그인은 languages/seoulcommerce-kg-inicis-pro-for-woocommerce-ko_KR.po 파일에 번역 파일을 포함하고 있습니다.

테스트 (Testing)

다음 테스트 자격 증명을 사용하여 즉시 종단 간 결제를 실행할 수 있습니다:

• MID (가맹점 ID): INIpayTest
• 모바일 HashKey: 3CB8183A4BE283555ACC8363C0360223

INICIS 테스트 환경 참고사항:

• 테스트 거래는 실제 승인이며 당일 24:00 이전에 자동 취소됩니다.
• 가상계좌(가상계좌) 입금의 경우, 가맹점 관리자 또는 환불 API를 통해 환불을 시작해야 합니다 (자동 취소되지 않음).
• 일부 카드(예: KB/국민, 카카오뱅크)는 발급사 정책으로 인해 테스트에 사용할 수 없을 수 있습니다. 오류가 발생하면 다른 카드를 시도해 보세요.
• INICIS에서 반환하는 IDC 센터 코드 값에는 fc, ks, stg가 포함되며 게이트웨이가 자동으로 처리합니다.

테스트 방법:

1. 간단한 상품을 만들고 장바구니에 추가하세요.
2. 체크아웃으로 이동하여 «KG INICIS Pro»를 선택하세요.
3. INIPayPro 결제 창이 열립니다. 결제를 완료하세요.
4. 다시 리디렉션되며 주문이 결제 완료로 표시되어야 합니다.

문제 해결:

• «사용 가능한 결제 방법이 없습니다»가 표시되면 게이트웨이가 활성화되어 있고 MID와 모바일 HashKey가 모두 설정되어 있는지 확인하세요.
• 결제 창이 열리지 않으면 테마가 jQuery를 제거하지 않았는지, CSP가 타사 스크립트를 차단하지 않는지 확인하세요.
• DNS 오류로 승인에 실패하면 호스트가 paypro.inicis.com 및 kspaypro.inicis.com과 같은 하위 도메인에 대한 아웃바운드 HTTPS를 허용해야 합니다.
• 게이트웨이 설정에서 «디버그 로깅»을 활성화하고 WooCommerce > 상태 > 로그(소스: inicis-pro)를 확인하세요.

환불 (전체 및 부분)

이 플러그인은 WooCommerce 주문 화면에서 직접 INICIS v2 API를 통해 환불을 지원합니다.

설정:

• INIAPI 키: 환불에 필요합니다. INIpayTest MID의 경우 ItEQKi3rY7uvDS8l을 사용하세요 (INICIS 테스트 문서에서).
• 클라이언트 IP: 선택 사항입니다. INIAPI 프로필에 화이트리스트가 필요한 경우 고정 IP를 설정하고, 그렇지 않으면 서버 IP가 사용됩니다.

사용법:

• 전체 환불: 전체 주문 금액에 대한 환불을 생성합니다. 플러그인은 v2/pg/refund를 호출합니다.
• 부분 환불: 부분 금액을 입력합니다. 플러그인은 적절한 잔액으로 v2/pg/partialRefund를 호출합니다.
• 디버그 로깅이 활성화되면 결과 및 모든 오류가 로그에 기록됩니다.

자주 묻는 질문

가상계좌(가상계좌) 또는 계좌이체를 지원합니까?

이 버전은 카드 결제에 중점을 둡니다. 추가 방법은 향후 버전에서 추가될 수 있습니다.

새로운 WooCommerce 체크아웃(블록)과 작동합니까?

예, 게이트웨이는 WooCommerce 블록에 등록되어 블록 기반 체크아웃에 표시됩니다.

어떤 데이터를 구성해야 합니까?

• 결제: MID 및 모바일 HashKey.
• 환불: INIAPI 키(선택적으로 클라이언트 IP).

스크린샷

1. WooCommerce의 결제 설정
2. KG INICIS 결제 화면

변경 이력

1.0.0

• 초기 릴리스

외부 서비스

이 플러그인은 결제를 처리하기 위해 KG INICIS 및 SeoulCommerce에서 제공하는 외부 서비스에 연결됩니다:

KG INICIS 결제 서비스: — 서비스: 신용카드 거래를 처리하기 위한 KG INICIS Pro 결제 게이트웨이 — 전송되는 데이터: 주문 금액, 가맹점 ID, 고객 세부 정보 및 거래 데이터를 포함한 결제 정보 — 시기: 고객이 이 게이트웨이를 사용하여 결제할 때마다 — 목적: 신용카드 결제를 안전하게 인증 및 처리 — INICIS 서비스 약관: https://www.inicis.com/terms — INICIS 개인정보 보호정책: https://www.inicis.com/privacy

SeoulCommerce API 키 검증: — 서비스: 실서버 모드 활성화를 위한 API 키 검증 서비스 — 전송되는 데이터: 웹사이트 URL, API 키, 플러그인 버전 및 타임스탬프 — 시기: 관리자 설정에서 API 키를 검증하거나 실서버 모드 작동 중일 때 — 목적: 실서버 모드에서 플러그인의 승인된 사용을 확인 — SeoulCommerce 약관: https://seoulcommerce.com/terms — SeoulCommerce 개인정보 보호: https://seoulcommerce.com/privacy

업그레이드 안내

해당 없음