이 플러그인은 WooCommerce에 KG INICIS 신용카드 결제 게이트웨이 2개를 추가합니다. 상점은 INICIS 계약 및 통합 필요에 따라 하나 또는 둘 모두를 활성화할 수 있습니다.
한 플러그인에 두 개의 게이트웨이:
-
KG INICIS Pro — INIPayPro 결제창(paypro.inicis.com)을 사용합니다. MID와 Mobile HashKey가 필요합니다. INIAPI v2를 통한 전액 및 부분 환불을 지원합니다. 실거래 모드용으로 선택적 SeoulCommerce API 키를 설정할 수 있습니다.
-
INICIS Standard Pay — INICIS 웹 표준(웹표준) 결제 흐름을 사용합니다. PC 결제는 INIStdPay.js(stdpay.inicis.com)와 SignKey를 사용하고, 모바일 결제는 mobile.inicis.com으로의 폼 POST와 HashKey를 사용합니다. 카드 결제 전용입니다. MID, SignKey(PC용) 및 HashKey(모바일용)가 필요합니다.
두 게이트웨이는 WooCommerce > 설정 > 결제에 표시됩니다. Pro, Standard 또는 둘 다 활성화하세요.
기능:
- 두 가지 이니시스 결제 게이트웨이: Pro 및 Standard Pay
- PC 및 모바일에서의 신용카드 결제
- WooCommerce 클래식 결제 및 결제 블록 지원
- 인증 콜백 후 서버 측 승인
- INIAPI v2를 통한 전체 및 부분 환불 (Pro 결제 게이트웨이)
- INIpayTest MID로 테스트 모드
- WooCommerce 로거를 통한 디버그 로깅
- Korean (한국어) translation included” -> “한국어(한국어) 번역 포함
테스트
다음 테스트 자격증명을 사용하여 즉시 결제 종단 간 테스트를 실행하세요:
- MID(가맹점 ID):
INIpayTest - SignKey(PC, Standard Pay):
SU5JTElURV9UUklQTEVERVNfS0VZU1RS - 모바일 해시키:
3CB8183A4BE283555ACC8363C0360223
INICIS 테스트 환경을 위한 참고 사항:
- 테스트 거래는 실제 승인이며 동일한 날 24:00 이전에 자동으로 취소됩니다.
- 가상계좌(vbank) 입금의 경우 환불은 자동취소가 아닌 가맹점 관리자 또는 환불 API를 통해 직접 처리해야 합니다.
- 일부 카드(예: KB/국민, 카카오뱅크)는 발급사 정책으로 테스트 불가일 수 있습니다. 오류가 발생하면 다른 카드를 시도해 주세요.
- INICIS에서 반환하는 IDC 센터 코드 값에는
fc,ks,stg가 포함되며 게이트웨이에서 자동으로 처리됩니다.
KG INICIS Pro 테스트 방법:
- 간단한 상품을 생성하고 장바구니에 추가하세요.
- 결제로 이동하여 “KG INICIS Pro”를 선택하세요.
- INIPayPro 결제 창이 열립니다. 결제를 완료해주세요.
- 사용자는 리다이렉트되어 돌아오며; 주문은 결제 완료로 표시되어야 합니다.
INICIS 스탠다드 결제 테스트 방법:
- 간단한 상품을 생성하고 장바구니에 추가하세요.
- 결제로 이동하여 “신용카드(INICIS 표준)”(또는 사용자 지정 제목)를 선택하세요.
- PC에서는 INICIS 스탠다드 결제 오버레이가 열립니다. 모바일에서는 INICIS 모바일 결제 페이지로 리다이렉트됩니다.
- 결제를 완료하세요. 주문 성공 페이지로 리다이렉트됩니다.
문제 해결:
- 결제 수단 없음”이 표시되면 게이트웨이가 활성화되어 있고 필수 키(MID, SignKey/HashKey)가 설정되어 있는지 확인하세요.
- 결제 창이 열리지 않으면 테마가 jQuery를 제거하지 않았는지 확인하고 CSP가 타사 스크립트를 차단하지 않는지 확인하세요.
- DNS 오류로 승인에 실패하는 경우, 호스팅 제공업체는
paypro.inicis.com,stdpay.inicis.com,mobile.inicis.com및 해당 하위 도메인으로의 아웃바운드 HTTPS를 허용해야 합니다. - 게이트웨이 설정에서 “Debug logging”을 활성화하고 WooCommerce > 상태 > 로그를 확인하세요(소스: Pro는
inicis-pro, Standard는inicis-std).
환불(전액 및 부분)
이 플러그인은 WooCommerce 주문 화면에서 INICIS v2 API를 통해 환불을 지원합니다(프로 게이트웨이 전용).
설정:
- INIAPI 키: 환불 시 필수입니다.
INIpayTestMID의 경우 INICIS 테스트 문서에 따른ItEQKi3rY7uvDS8l을 사용하세요. - 클라이언트 IP: 옵션. INIAPI 프로필에서 화이트리스트 등록이 필요하면 고정 IP를 설정하세요. 그렇지 않으면 서버 IP를 사용합니다.
사용 방법:
- 전체 환불: 전체 주문 금액에 대해 환불을 생성합니다; 플러그인이
v2/pg/refund를 호출합니다. - 부분 환불: 부분 금액을 입력하세요; 플러그인은 적절한 남은 금액으로
v2/pg/partialRefund를 호출합니다. - 디버그 로깅이 활성화되면 결과와 모든 오류가 기록됩니다.
외부 서비스
이 플러그인은 결제 처리를 위해 KG이니시스(KG INICIS)와 서울커머스(SeoulCommerce)가 제공하는 외부 서비스에 연결합니다:
KG INICIS 결제 서비스: – 서비스: 신용카드 거래 처리를 위한 KG INICIS 결제 게이트웨이(Pro 및 Standard Pay) – 전송되는 데이터: 주문 금액, 가맹점 ID, 고객 정보 및 거래 데이터를 포함한 결제 정보 – 시점: 고객이 두 게이트웨이 중 어느 쪽으로 결제할 때마다 – 목적: 신용카드 결제를 안전하게 인증하고 처리하기 위함 – 엔드포인트: paypro.inicis.com (Pro), stdpay.inicis.com (Standard PC), mobile.inicis.com (Standard mobile) – 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
한국어 설명 (Korean Description)” –> “한국어 설명 (Korean Description)
이 플러그인은 WooCommerce에 두 가지 KG INICIS 신용카드 결제 게이트웨이를 추가합니다. 가맹점의 INICIS 계약 및 연동 요구사항에 따라 하나 또는 둘 중 하나를 활성화할 수 있습니다.
한 플러그인에 두 가지 결제 게이트웨이:
-
KG INICIS Pro — INIPayPro 결제창(paypro.inicis.com) 사용. 가맹점 ID와 모바일 HashKey 필요. INIAPI v2를 통한 전체 및 부분 환불 지원. 실서버 모드에서는 SeoulCommerce API 키 선택 사용.
-
INICIS 웹표준 결제 (Standard Pay) — INICIS 웹표준 결제 플로우 사용. PC 결제는 SignKey와 INIStdPay.js (stdpay.inicis.com); 모바일 결제는 HashKey와 mobile.inicis.com으로 form POST. 카드 결제 전용. 가맹점 ID, SignKey (PC), HashKey (모바일) 필요.
Both gateways appear under WooCommerce > 설정 > 결제. Pro, 웹표준 또는 둘 다 활성화할 수 있습니다.
기능:
- 두 가지 INICIS 결제 게이트웨이: Pro 및 웹표준(Standard Pay)
- PC 및 모바일에서 신용카드 결제
- WooCommerce 클래식 체크아웃 및 체크아웃 블록 지원
- 인증 콜백 후 서버 측 승인
- INIAPI v2를 통한 전체 및 부분 환불 (Pro 게이트웨이)
- INIpayTest MID로 테스트 모드 지원
- WooCommerce 로거를 통한 디버그 로깅
- 한국어 번역 포함
설치 방법 (Installation)
- 플러그인 폴더를
/wp-content/plugins/에 업로드하거나 WordPress 플러그인 화면을 통해 설치하세요. - WordPress의 ‘플러그인’ 화면에서 플러그인을 활성화하세요.
- WooCommerce > 설정 > 결제로 이동하세요:
- KG INICIS Pro를 활성화하고 가맹점 ID와 모바일 HashKey를 입력하세요. 환불 기능을 사용하려면 INIAPI 키도 입력하세요.
- INICIS 웹표준 결제를 활성화하고 가맹점 ID, SignKey (PC), HashKey (모바일)를 입력하세요.
- 하나 또는 둘 다 활성화할 수 있습니다.
- 한국어 번역을 사용하려면 사이트 언어를 한국어(ko_KR)로 설정하세요.
테스트 (테스팅)
다음 테스트 자격 증명을 사용하여 즉시 종단 간 결제를 실행할 수 있습니다:
- MID (가맹점 ID):
INIpayTest - SignKey (PC, 웹표준 결제):
SU5JTElURV9UUklQTEVERVNfS0VZU1RS - 모바일 HashKey:
3CB8183A4BE283555ACC8363C0360223
INICIS 테스트 환경 참고사항:
- 테스트 거래는 실제 승인이며 당일 24:00 이전에 자동 취소됩니다.
- 가상계좌 입금의 경우, 가맹점 관리자 또는 환불 API를 통해 환불을 시작해야 합니다 (자동 취소되지 않음).
- 일부 카드(예: KB/국민, 카카오뱅크)는 발급사 정책으로 인해 테스트에 사용할 수 없을 수 있습니다. 오류가 발생하면 다른 카드를 시도해 보세요.
- INICIS에서 반환하는 IDC 센터 코드 값에는
fc,ks,stg가 포함되며 게이트웨이가 자동으로 처리합니다.
KG INICIS Pro 테스트 방법:” in Korean is: “KG이니시스 Pro 테스트 방법:
- 간단한 상품을 만들고 장바구니에 추가하세요.
- 체크아웃으로 이동하여 “KG INICIS Pro”를 선택하세요.
- INIPayPro 결제 창이 열립니다. 결제를 완료하세요.
- 다시 리디렉션되며 주문이 결제 완료로 표시되어야 합니다.
INICIS 웹표준 결제 테스트 방법:
- 간단한 상품을 만들고 장바구니에 추가하세요.
- 체크아웃으로 이동하여 “신용카드 (INICIS 웹표준)” (또는 설정한 제목)을 선택하세요.
- PC에서는 INICIS 웹표준 결제 오버레이가 열립니다. 모바일에서는 INICIS 모바일 결제 페이지로 리디렉션됩니다.
- 결제를 완료하세요. 주문 완료 페이지로 리디렉션됩니다.
문제 해결:
- “사용 가능한 결제 방법이 없습니다”가 표시되면 게이트웨이가 활성화되어 있고 필요한 키(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를 통해 환불을 지원합니다(Pro 게이트웨이에만 해당).
설정:
- INIAPI 키: 환불에 필요합니다.
INIpayTestMID의 경우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)을 사용합니다. 둘 다 PC와 모바일에서 신용카드 결제를 지원합니다. INICIS 계약에 맞는 게이트웨이를 선택하거나 둘 다 활성화할 수 있습니다.
Does it work with the new WooCommerce Checkout (Block)?”의 한국어 번역: “새로운 WooCommerce 체크아웃(블록)과 호환되나요?
예, 두 게이트웨이 모두 WooCommerce 블록에 등록되어 블록 기반 체크아웃에 표시됩니다.
어떤 데이터를 구성해야 합니까?
- KG INICIS Pro: 가맹점 ID 및 모바일 HashKey. 환불: INIAPI 키 (선택적으로 클라이언트 IP).
- INICIS 웹표준 결제: 가맹점 ID, SignKey (PC), HashKey (모바일). 카드 결제 전용.
스크린샷
- WooCommerce의 결제 설정
- KG INICIS 결제 화면
변경 이력
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
- 전체 한국어 언어 지원 추가
- Add Korean translations for all plugin strings
- Update readme.txt for the Korean section of the WordPress directory listing”의 한국어 번역은 다음과 같습니다:
“워드프레스 디렉토리 목록을 위한 한국어 섹션에 대한 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
업그레이드 안내
해당 없음