SeoulCommerce KG INICIS Pro for WooCommerce

Description

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.

Two gateways in one plugin:

1. KG INICIS Pro — 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.

2. INICIS Standard Pay — 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). Supports full and partial refunds via INIAPI v2.

Both gateways appear in WooCommerce > Settings > Payments. Enable Pro, Standard, or both.

Features:

• Two INICIS payment gateways: Pro and Standard Pay
• Credit card payments on PC and mobile
• WooCommerce Classic Checkout and Checkout Blocks support
• Server-side approval after authentication callback
• Full and partial refunds via INIAPI v2 (Pro and Standard Pay)
• Test mode with INIpayTest MID
• Debug logging via WooCommerce logger
• Korean (한국어) translation included

Testing

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

• MID (Merchant ID): INIpayTest
• SignKey (PC, Standard Pay): SU5JTElURV9UUklQTEVERVNfS0VZU1RS
• 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 KG INICIS Pro:

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.

How to test INICIS Standard Pay:

1. Create a simple product and add it to the cart.
2. Go to Checkout and select “Credit card (INICIS Standard)” (or your custom title).
3. On PC, the INICIS Standard payment overlay will open. On mobile, you will be redirected to the INICIS mobile payment page.
4. Complete the payment. You will be redirected to the order success page.

Troubleshooting:

• If you see “No payment methods available”, ensure the gateway is enabled and the required keys (MID, SignKey/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, stdpay.inicis.com, mobile.inicis.com, and their subdomains.
• Enable “Debug logging” in the gateway settings and check WooCommerce > Status > Logs (source: inicis-pro for Pro, inicis-std for Standard).

Refunds (Full & Partial)

This plugin supports refunds via INICIS v2 API directly from the WooCommerce order screen (KG INICIS Pro and INICIS Standard Pay).

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 payment gateway for processing credit card transactions (Pro and Standard Pay)
– Data sent: Payment information including order amount, merchant ID, customer details, and transaction data
– When: Every time a customer makes a payment using either gateway
– Purpose: To authenticate and process credit card payments securely
– Endpoints: paypro.inicis.com (Pro), stdpay.inicis.com (Standard PC), mobile.inicis.com (Standard mobile)
– 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 (Pro gateway only)
– 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 신용카드 결제 게이트웨이를 추가합니다. 가맹점의 INICIS 계약 및 연동 요구사항에 따라 하나 또는 둘 다 활성화할 수 있습니다.

하나의 플러그인에 두 가지 게이트웨이:

1. KG INICIS Pro — INIPayPro 결제창 (paypro.inicis.com) 사용. 가맹점 ID와 모바일 HashKey 필요. INIAPI v2를 통한 전체 및 부분 환불 지원. 실서버 모드에는 SeoulCommerce API 키 선택 사용.

2. INICIS 웹표준 결제 (Standard Pay) — INICIS 웹표준 결제 플로우 사용. PC 결제는 SignKey와 INIStdPay.js (stdpay.inicis.com); 모바일 결제는 HashKey와 mobile.inicis.com으로 form POST. 카드 결제 전용. 가맹점 ID, SignKey (PC), HashKey (모바일) 필요. INIAPI v2를 통한 전체 및 부분 환불 지원.

두 게이트웨이 모두 WooCommerce > 설정 > 결제에서 표시됩니다. Pro, 웹표준, 또는 둘 다 활성화할 수 있습니다.

기능:

• 두 가지 INICIS 결제 게이트웨이: Pro 및 웹표준(Standard Pay)
• PC 및 모바일에서 신용카드 결제
• WooCommerce 클래식 체크아웃 및 체크아웃 블록 지원
• 인증 콜백 후 서버 측 승인
• INIAPI v2를 통한 전체 및 부분 환불 (Pro 및 웹표준 게이트웨이)
• INIpayTest MID로 테스트 모드 지원
• WooCommerce 로거를 통한 디버그 로깅
• 한국어 번역 포함

설치 방법 (Installation)

1. 플러그인 폴더를 /wp-content/plugins/에 업로드하거나 WordPress 플러그인 화면을 통해 설치하세요.
2. WordPress의 ‘플러그인’ 화면에서 플러그인을 활성화하세요.
3. WooCommerce > 설정 > 결제로 이동하세요:
   • KG INICIS Pro를 활성화하고 가맹점 ID와 모바일 HashKey를 입력하세요. 환불 기능을 사용하려면 INIAPI 키도 입력하세요.
   • INICIS 웹표준 결제를 활성화하고 가맹점 ID, SignKey (PC), HashKey (모바일)를 입력하세요. 환불 기능을 사용하려면 INIAPI 키도 입력하세요.
   • 하나 또는 둘 다 활성화할 수 있습니다.
4. 한국어 번역을 사용하려면 사이트 언어를 한국어(ko_KR)로 설정하세요.

테스트 (Testing)

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

• MID (가맹점 ID): INIpayTest
• SignKey (PC, 웹표준 결제): SU5JTElURV9UUklQTEVERVNfS0VZU1RS
• 모바일 HashKey: 3CB8183A4BE283555ACC8363C0360223

INICIS 테스트 환경 참고사항:

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

KG INICIS Pro 테스트 방법:

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

INICIS 웹표준 결제 테스트 방법:

1. 간단한 상품을 만들고 장바구니에 추가하세요.
2. 체크아웃으로 이동하여 “신용카드 (INICIS 웹표준)” (또는 설정한 제목)을 선택하세요.
3. PC에서는 INICIS 웹표준 결제 오버레이가 열립니다. 모바일에서는 INICIS 모바일 결제 페이지로 리디렉션됩니다.
4. 결제를 완료하세요. 주문 완료 페이지로 리디렉션됩니다.

문제 해결:

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

환불 (전체 및 부분)

이 플러그인은 WooCommerce 주문 화면에서 직접 INICIS v2 API를 통해 환불을 지원합니다 (KG INICIS Pro 및 INICIS 웹표준 결제).

설정:

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

사용법:

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

자주 묻는 질문

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

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

Pro와 웹표준 결제의 차이점은 무엇인가요?

KG INICIS Pro는 INIPayPro 연동(paypro.inicis.com)을 사용하며 INIAPI v2를 통한 환불을 지원합니다. INICIS 웹표준 결제는 INICIS 웹표준 연동(PC: stdpay.inicis.com, 모바일: mobile.inicis.com)을 사용하며 INIAPI v2를 통한 환불을 지원합니다. 둘 다 PC와 모바일에서 신용카드 결제를 지원합니다. INICIS 계약에 맞는 게이트웨이를 선택하거나 둘 다 활성화할 수 있습니다.

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

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

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

• KG INICIS Pro: 가맹점 ID 및 모바일 HashKey. 환불: INIAPI 키 (선택적으로 클라이언트 IP).
• INICIS 웹표준 결제: 가맹점 ID, SignKey (PC), HashKey (모바일). 환불: INIAPI 키 (선택적으로 클라이언트 IP). 카드 결제 전용.

스크린샷

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

변경 이력

1.0.10

• 주문 금액의 절반 이상 환불 시 INICIS에 전체 취소로 전송되던 문제 수정

1.0.9

• INICIS 웹표준 결제에 INIAPI v2 전체 및 부분 환불 지원 추가

1.0.8

• 보안 업데이트: KG INICIS Pro 및 INICIS 웹표준(PC) 결제 리턴 처리 강화

1.0.7

• Magento 구현과 동일한 2trs ISP 및 앱 실행 옵션을 추가하여 INICIS 웹표준 모바일 앱카드 복귀 처리 개선
• 정상 동작하는 Magento 구현과 맞추기 위해 Chrome 모바일 앱 복귀 스킴을 googlechromes://로 업데이트

1.0.6

• INICIS 문서에서 확인된 Chrome 앱 복귀 스킴 googlechrome:// 값을 사용하도록 웹표준 모바일 Chrome 복귀 처리 수정

1.0.5

• 모바일 브라우저 결제 후 복귀를 개선하기 위해 INICIS 문서에 따른 app_scheme 값을 필요한 경우 자동 추가
• INICIS IDC 승인 URL과 P_REQ_URL을 정확히 비교하도록 웹표준 모바일 승인 URL 검증 강화
• WooCommerce 주문을 결제 완료로 처리하기 전에 모바일 승인 응답의 주문번호 및 금액 검증 추가
• 웹표준 모바일 return_token을 1회성으로 처리하고 모바일 승인 요청의 TLS 인증서 검증 활성화

1.0.4

• INICIS 웹표준 PC 승인 수정: php://input에서 원시 POST 본문으로 authToken 읽기 (sanitize_text_field에 의한 토큰 손상 방지)
• INICIS 웹표준 PC 승인 수정: 공식 INICIS HttpClient.php와 동일하게 cURL + http_build_query + PHP_QUERY_RFC3986 사용
• INICIS 웹표준 모바일 승인 수정: mobile.inicis.com 호스트를 승인 URL 허용 목록에 추가
• INICIS 웹표준 모바일 승인 수정: P_TID에서 P_MID 추출, 공식 INICIS 모바일 샘플과 동일하게 cURL 직접 사용
• PC 및 모바일 웹표준 결제 플로우에 대한 포괄적인 디버그 로깅 추가
• readme.txt를 영어 및 한국어로 Pro와 웹표준 결제 게이트웨이 설명 업데이트

1.0.3

• 두 번째 결제 게이트웨이로 INICIS 웹표준 결제 추가 (카드 전용)
• 웹표준 결제는 PC (SignKey, INIStdPay.js) 및 모바일 (HashKey, mobile.inicis.com으로 form POST) 지원
• 두 게이트웨이 모두 WooCommerce > 설정 > 결제에 표시; 가맹점은 Pro, 웹표준, 또는 둘 다 활성화 가능

1.0.2

• 치명적 오류 수정: 정의되지 않은 상수 SEOULCOMMERCE_SEOULCOMMERCE_KG_INICIS_PRO_VERSION

1.0.1

• 전체 한국어 언어 지원 추가
• 모든 플러그인 문자열에 대한 한국어 번역 추가
• WordPress 디렉토리 목록을 위한 한국어 섹션으로 readme.txt 업데이트

1.0.0

• 초기 릴리스

외부 서비스

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

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

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

업그레이드 안내

해당 없음