KG INICIS credit card payment gateway for WooCommerce — supports both INICIS Pro and INICIS Standard Pay (PC and mobile).

Stevie Dean

<p>This plugin adds two KG INICIS credit card payment gateways to WooCommerce. Merchants can enable one or both depending on their INICIS contract and integration needs.</p>
<p><strong>Two gateways in one plugin:</strong></p>
<ol>
<li>
<p><strong>KG INICIS Pro</strong> — Uses the INIPayPro payment window (paypro.inicis.com). Requires MID and Mobile HashKey. Supports full and partial refunds via INIAPI v2. Optional SeoulCommerce API key for live mode.</p>
</li>
<li>
<p><strong>INICIS Standard Pay</strong> — Uses the INICIS Web Standard (웹표준) payment flow. PC payments use SignKey with INIStdPay.js (stdpay.inicis.com); mobile payments use HashKey with a form POST to mobile.inicis.com. Card only. Requires MID, SignKey (PC), and HashKey (mobile).</p>
</li>
</ol>
<p>Both gateways appear in WooCommerce > Settings > Payments. Enable Pro, Standard, or both.</p>
<p>Features:</p>
<ul>
<li>Two INICIS payment gateways: Pro and Standard Pay</li>
<li>Credit card payments on PC and mobile</li>
<li>WooCommerce Classic Checkout and Checkout Blocks support</li>
<li>Server-side approval after authentication callback</li>
<li>Full and partial refunds via INIAPI v2 (Pro gateway)</li>
<li>Test mode with INIpayTest MID</li>
<li>Debug logging via WooCommerce logger</li>
<li>Korean (한국어) translation included</li>
</ul>
<h3>Testing</h3>
<p>Use the following test credentials to run end-to-end payments immediately:</p>
<ul>
<li>MID (Merchant ID): <code>INIpayTest</code></li>
<li>SignKey (PC, Standard Pay): <code>SU5JTElURV9UUklQTEVERVNfS0VZU1RS</code></li>
<li>Mobile HashKey: <code>3CB8183A4BE283555ACC8363C0360223</code></li>
</ul>
<p>Notes for INICIS test environment:</p>
<ul>
<li>Test transactions are real authorizations and are automatically canceled before 24:00 (same day).</li>
<li>For virtual account (vbank) deposits, refunds must be initiated via the merchant admin or refund API (not auto-canceled).</li>
<li>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.</li>
<li>IDC Center Code values returned by INICIS include <code>fc</code>, <code>ks</code>, <code>stg</code> and are handled automatically by the gateway.</li>
</ul>
<p>How to test KG INICIS Pro:</p>
<ol>
<li>Create a simple product and add it to the cart.</li>
<li>Go to Checkout and select “KG INICIS Pro”.</li>
<li>The INIPayPro payment window will open. Complete the payment.</li>
<li>You will be redirected back; the order should be marked as paid.</li>
</ol>
<p>How to test INICIS Standard Pay:</p>
<ol>
<li>Create a simple product and add it to the cart.</li>
<li>Go to Checkout and select “Credit card (INICIS Standard)” (or your custom title).</li>
<li>On PC, the INICIS Standard payment overlay will open. On mobile, you will be redirected to the INICIS mobile payment page.</li>
<li>Complete the payment. You will be redirected to the order success page.</li>
</ol>
<p>Troubleshooting:</p>
<ul>
<li>If you see “No payment methods available”, ensure the gateway is enabled and the required keys (MID, SignKey/HashKey) are set.</li>
<li>If the payment window does not open, ensure jQuery is not removed by your theme and that no CSP blocks third-party scripts.</li>
<li>If approval fails with DNS errors, your host must allow outbound HTTPS to <code>paypro.inicis.com</code>, <code>stdpay.inicis.com</code>, <code>mobile.inicis.com</code>, and their subdomains.</li>
<li>Enable “Debug logging” in the gateway settings and check WooCommerce > Status > Logs (source: <code>inicis-pro</code> for Pro, <code>inicis-std</code> for Standard).</li>
</ul>
<h3>Refunds (Full & Partial)</h3>
<p>This plugin supports refunds via INICIS v2 API directly from the WooCommerce order screen (Pro gateway only).</p>
<p>Setup:</p>
<ul>
<li>INIAPI Key: required for refunds. For the <code>INIpayTest</code> MID, use <code>ItEQKi3rY7uvDS8l</code> (from INICIS test docs).</li>
<li>Client IP: optional. Set a fixed IP if your INIAPI profile requires whitelisting; otherwise it will use the server IP.</li>
</ul>
<p>Usage:</p>
<ul>
<li>Full refund: create a refund for the full order amount; the plugin calls <code>v2/pg/refund</code>.</li>
<li>Partial refund: enter a partial amount; the plugin calls <code>v2/pg/partialRefund</code> with the appropriate remaining amount.</li>
<li>Results and any errors are logged when Debug logging is enabled.</li>
</ul>
<h3>External Services</h3>
<p>This plugin connects to external services provided by KG INICIS and SeoulCommerce to process payments:</p>
<p><strong>KG INICIS Payment Services:</strong><br />
– Service: KG INICIS payment gateway for processing credit card transactions (Pro and Standard Pay)<br />
– Data sent: Payment information including order amount, merchant ID, customer details, and transaction data<br />
– When: Every time a customer makes a payment using either gateway<br />
– Purpose: To authenticate and process credit card payments securely<br />
– Endpoints: paypro.inicis.com (Pro), stdpay.inicis.com (Standard PC), mobile.inicis.com (Standard mobile)<br />
– INICIS Terms of Service: https://www.inicis.com/terms<br />
– INICIS Privacy Policy: https://www.inicis.com/privacy</p>
<p><strong>SeoulCommerce API Key Validation:</strong><br />
– Service: API key validation service for live mode activation (Pro gateway only)<br />
– Data sent: Website URL, API key, plugin version, and timestamp<br />
– When: When validating API keys in admin settings or during live mode operation<br />
– Purpose: To verify authorized usage of the plugin in live mode<br />
– SeoulCommerce Terms: https://seoulcommerce.com/terms<br />
– SeoulCommerce Privacy: https://seoulcommerce.com/privacy</p>
<h3>한국어 설명 (Korean Description)</h3>
<p>이 플러그인은 WooCommerce에 두 가지 KG INICIS 신용카드 결제 게이트웨이를 추가합니다. 가맹점의 INICIS 계약 및 연동 요구사항에 따라 하나 또는 둘 다 활성화할 수 있습니다.</p>
<p><strong>하나의 플러그인에 두 가지 게이트웨이:</strong></p>
<ol>
<li>
<p><strong>KG INICIS Pro</strong> — INIPayPro 결제창 (paypro.inicis.com) 사용. 가맹점 ID와 모바일 HashKey 필요. INIAPI v2를 통한 전체 및 부분 환불 지원. 실서버 모드에는 SeoulCommerce API 키 선택 사용.</p>
</li>
<li>
<p><strong>INICIS 웹표준 결제 (Standard Pay)</strong> — INICIS 웹표준 결제 플로우 사용. PC 결제는 SignKey와 INIStdPay.js (stdpay.inicis.com); 모바일 결제는 HashKey와 mobile.inicis.com으로 form POST. 카드 결제 전용. 가맹점 ID, SignKey (PC), HashKey (모바일) 필요.</p>
</li>
</ol>
<p>두 게이트웨이 모두 WooCommerce > 설정 > 결제에서 표시됩니다. Pro, 웹표준, 또는 둘 다 활성화할 수 있습니다.</p>
<p>기능:</p>
<ul>
<li>두 가지 INICIS 결제 게이트웨이: Pro 및 웹표준(Standard Pay)</li>
<li>PC 및 모바일에서 신용카드 결제</li>
<li>WooCommerce 클래식 체크아웃 및 체크아웃 블록 지원</li>
<li>인증 콜백 후 서버 측 승인</li>
<li>INIAPI v2를 통한 전체 및 부분 환불 (Pro 게이트웨이)</li>
<li>INIpayTest MID로 테스트 모드 지원</li>
<li>WooCommerce 로거를 통한 디버그 로깅</li>
<li>한국어 번역 포함</li>
</ul>
<h3>설치 방법 (Installation)</h3>
<ol>
<li>플러그인 폴더를 <code>/wp-content/plugins/</code>에 업로드하거나 WordPress 플러그인 화면을 통해 설치하세요.</li>
<li>WordPress의 ‘플러그인’ 화면에서 플러그인을 활성화하세요.</li>
<li>WooCommerce > 설정 > 결제로 이동하세요:
<ul>
<li><strong>KG INICIS Pro</strong>를 활성화하고 가맹점 ID와 모바일 HashKey를 입력하세요. 환불 기능을 사용하려면 INIAPI 키도 입력하세요.</li>
<li><strong>INICIS 웹표준 결제</strong>를 활성화하고 가맹점 ID, SignKey (PC), HashKey (모바일)를 입력하세요.</li>
<li>하나 또는 둘 다 활성화할 수 있습니다.</li>
</ul>
</li>
<li>한국어 번역을 사용하려면 사이트 언어를 한국어(ko_KR)로 설정하세요.</li>
</ol>
<h3>테스트 (Testing)</h3>
<p>다음 테스트 자격 증명을 사용하여 즉시 종단 간 결제를 실행할 수 있습니다:</p>
<ul>
<li>MID (가맹점 ID): <code>INIpayTest</code></li>
<li>SignKey (PC, 웹표준 결제): <code>SU5JTElURV9UUklQTEVERVNfS0VZU1RS</code></li>
<li>모바일 HashKey: <code>3CB8183A4BE283555ACC8363C0360223</code></li>
</ul>
<p>INICIS 테스트 환경 참고사항:</p>
<ul>
<li>테스트 거래는 실제 승인이며 당일 24:00 이전에 자동 취소됩니다.</li>
<li>가상계좌 입금의 경우, 가맹점 관리자 또는 환불 API를 통해 환불을 시작해야 합니다 (자동 취소되지 않음).</li>
<li>일부 카드(예: KB/국민, 카카오뱅크)는 발급사 정책으로 인해 테스트에 사용할 수 없을 수 있습니다. 오류가 발생하면 다른 카드를 시도해 보세요.</li>
<li>INICIS에서 반환하는 IDC 센터 코드 값에는 <code>fc</code>, <code>ks</code>, <code>stg</code>가 포함되며 게이트웨이가 자동으로 처리합니다.</li>
</ul>
<p>KG INICIS Pro 테스트 방법:</p>
<ol>
<li>간단한 상품을 만들고 장바구니에 추가하세요.</li>
<li>체크아웃으로 이동하여 “KG INICIS Pro”를 선택하세요.</li>
<li>INIPayPro 결제 창이 열립니다. 결제를 완료하세요.</li>
<li>다시 리디렉션되며 주문이 결제 완료로 표시되어야 합니다.</li>
</ol>
<p>INICIS 웹표준 결제 테스트 방법:</p>
<ol>
<li>간단한 상품을 만들고 장바구니에 추가하세요.</li>
<li>체크아웃으로 이동하여 “신용카드 (INICIS 웹표준)” (또는 설정한 제목)을 선택하세요.</li>
<li>PC에서는 INICIS 웹표준 결제 오버레이가 열립니다. 모바일에서는 INICIS 모바일 결제 페이지로 리디렉션됩니다.</li>
<li>결제를 완료하세요. 주문 완료 페이지로 리디렉션됩니다.</li>
</ol>
<p>문제 해결:</p>
<ul>
<li>“사용 가능한 결제 방법이 없습니다”가 표시되면 게이트웨이가 활성화되어 있고 필요한 키(MID, SignKey/HashKey)가 모두 설정되어 있는지 확인하세요.</li>
<li>결제 창이 열리지 않으면 테마가 jQuery를 제거하지 않았는지, CSP가 타사 스크립트를 차단하지 않는지 확인하세요.</li>
<li>DNS 오류로 승인에 실패하면 호스트가 <code>paypro.inicis.com</code>, <code>stdpay.inicis.com</code>, <code>mobile.inicis.com</code> 및 하위 도메인에 대한 아웃바운드 HTTPS를 허용해야 합니다.</li>
<li>게이트웨이 설정에서 “디버그 로깅”을 활성화하고 WooCommerce > 상태 > 로그를 확인하세요 (소스: Pro는 <code>inicis-pro</code>, 웹표준은 <code>inicis-std</code>).</li>
</ul>
<h3>환불 (전체 및 부분)</h3>
<p>이 플러그인은 WooCommerce 주문 화면에서 직접 INICIS v2 API를 통해 환불을 지원합니다 (Pro 게이트웨이 전용).</p>
<p>설정:</p>
<ul>
<li>INIAPI 키: 환불에 필요합니다. <code>INIpayTest</code> MID의 경우 <code>ItEQKi3rY7uvDS8l</code>을 사용하세요 (INICIS 테스트 문서에서).</li>
<li>클라이언트 IP: 선택 사항입니다. INIAPI 프로필에 화이트리스트가 필요한 경우 고정 IP를 설정하고, 그렇지 않으면 서버 IP가 사용됩니다.</li>
</ul>
<p>사용법:</p>
<ul>
<li>전체 환불: 전체 주문 금액에 대한 환불을 생성합니다. 플러그인은 <code>v2/pg/refund</code>를 호출합니다.</li>
<li>부분 환불: 부분 금액을 입력합니다. 플러그인은 적절한 잔액으로 <code>v2/pg/partialRefund</code>를 호출합니다.</li>
<li>디버그 로깅이 활성화되면 결과 및 모든 오류가 로그에 기록됩니다.</li>
</ul>
<h3>자주 묻는 질문</h3>
<h4>가상계좌 또는 계좌이체를 지원합니까?</h4>
<p>이 버전은 카드 결제에 중점을 둡니다. 추가 결제 수단은 향후 버전에서 추가될 수 있습니다.</p>
<h4>Pro와 웹표준 결제의 차이점은 무엇인가요?</h4>
<p><strong>KG INICIS Pro</strong>는 INIPayPro 연동(paypro.inicis.com)을 사용하며 INIAPI v2를 통한 환불을 지원합니다. <strong>INICIS 웹표준 결제</strong>는 INICIS 웹표준 연동(PC: stdpay.inicis.com, 모바일: mobile.inicis.com)을 사용합니다. 둘 다 PC와 모바일에서 신용카드 결제를 지원합니다. INICIS 계약에 맞는 게이트웨이를 선택하거나 둘 다 활성화할 수 있습니다.</p>
<h4>새로운 WooCommerce 체크아웃(블록)과 작동합니까?</h4>
<p>예, 두 게이트웨이 모두 WooCommerce 블록에 등록되어 블록 기반 체크아웃에 표시됩니다.</p>
<h4>어떤 데이터를 구성해야 합니까?</h4>
<ul>
<li><strong>KG INICIS Pro</strong>: 가맹점 ID 및 모바일 HashKey. 환불: INIAPI 키 (선택적으로 클라이언트 IP).</li>
<li><strong>INICIS 웹표준 결제</strong>: 가맹점 ID, SignKey (PC), HashKey (모바일). 카드 결제 전용.</li>
</ul>
<h3>스크린샷</h3>
<ol>
<li>WooCommerce의 결제 설정</li>
<li>KG INICIS 결제 화면</li>
</ol>
<h3>변경 이력</h3>
<h4>1.0.4</h4>
<ul>
<li>INICIS 웹표준 PC 승인 수정: php://input에서 원시 POST 본문으로 authToken 읽기 (sanitize_text_field에 의한 토큰 손상 방지)</li>
<li>INICIS 웹표준 PC 승인 수정: 공식 INICIS HttpClient.php와 동일하게 cURL + http_build_query + PHP_QUERY_RFC3986 사용</li>
<li>INICIS 웹표준 모바일 승인 수정: mobile.inicis.com 호스트를 승인 URL 허용 목록에 추가</li>
<li>INICIS 웹표준 모바일 승인 수정: P_TID에서 P_MID 추출, 공식 INICIS 모바일 샘플과 동일하게 cURL 직접 사용</li>
<li>PC 및 모바일 웹표준 결제 플로우에 대한 포괄적인 디버그 로깅 추가</li>
<li>readme.txt를 영어 및 한국어로 Pro와 웹표준 결제 게이트웨이 설명 업데이트</li>
</ul>
<h4>1.0.3</h4>
<ul>
<li>두 번째 결제 게이트웨이로 INICIS 웹표준 결제 추가 (카드 전용)</li>
<li>웹표준 결제는 PC (SignKey, INIStdPay.js) 및 모바일 (HashKey, mobile.inicis.com으로 form POST) 지원</li>
<li>두 게이트웨이 모두 WooCommerce > 설정 > 결제에 표시; 가맹점은 Pro, 웹표준, 또는 둘 다 활성화 가능</li>
</ul>
<h4>1.0.2</h4>
<ul>
<li>치명적 오류 수정: 정의되지 않은 상수 SEOULCOMMERCE_SEOULCOMMERCE_KG_INICIS_PRO_VERSION</li>
</ul>
<h4>1.0.1</h4>
<ul>
<li>전체 한국어 언어 지원 추가</li>
<li>모든 플러그인 문자열에 대한 한국어 번역 추가</li>
<li>WordPress 디렉토리 목록을 위한 한국어 섹션으로 readme.txt 업데이트</li>
</ul>
<h4>1.0.0</h4>
<ul>
<li>초기 릴리스</li>
</ul>
<h3>외부 서비스</h3>
<p>이 플러그인은 결제를 처리하기 위해 KG INICIS 및 SeoulCommerce에서 제공하는 외부 서비스에 연결됩니다:</p>
<p><strong>KG INICIS 결제 서비스:</strong><br />
– 서비스: 신용카드 거래를 처리하기 위한 KG INICIS 결제 게이트웨이 (Pro 및 웹표준)<br />
– 전송되는 데이터: 주문 금액, 가맹점 ID, 고객 세부 정보 및 거래 데이터를 포함한 결제 정보<br />
– 시기: 고객이 이 게이트웨이를 사용하여 결제할 때마다<br />
– 목적: 신용카드 결제를 안전하게 인증 및 처리<br />
– 엔드포인트: paypro.inicis.com (Pro), stdpay.inicis.com (웹표준 PC), mobile.inicis.com (웹표준 모바일)<br />
– INICIS 서비스 약관: https://www.inicis.com/terms<br />
– INICIS 개인정보 보호정책: https://www.inicis.com/privacy</p>
<p><strong>SeoulCommerce API 키 검증:</strong><br />
– 서비스: 실서버 모드 활성화를 위한 API 키 검증 서비스 (Pro 게이트웨이 전용)<br />
– 전송되는 데이터: 웹사이트 URL, API 키, 플러그인 버전 및 타임스탬프<br />
– 시기: 관리자 설정에서 API 키를 검증하거나 실서버 모드 작동 중일 때<br />
– 목적: 실서버 모드에서 플러그인의 승인된 사용을 확인<br />
– SeoulCommerce 약관: https://seoulcommerce.com/terms<br />
– SeoulCommerce 개인정보 보호: https://seoulcommerce.com/privacy</p>
<h3>업그레이드 안내</h3>
<p>해당 없음</p>


Alternatives to SeoulCommerce KG INICIS Pro for WooCommerce

Top alternatives