diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/CHANGELOG.md b/plugins/_bundled/sirsoft-pay_nhnkcp/CHANGELOG.md
new file mode 100644
index 00000000..9931ac07
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/CHANGELOG.md
@@ -0,0 +1,113 @@
+# Changelog
+
+이 프로젝트의 모든 주요 변경사항을 기록합니다.
+형식은 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/)를 따르며,
+[Semantic Versioning](https://semver.org/lang/ko/)을 준수합니다.
+
+## [Unreleased]
+
+### Fixed
+
+- 비회원 NHN KCP 주문완료/주문상세에서 매출전표 조회가 인증 사용자 전용 라우트에 막히지 않도록 게스트 주문 토큰과 결제 성공 후 임시 영수증 쿠키 접근을 지원했습니다.
+- 관리자 주문상세의 NHN KCP 결제 정보 패널이 원승인 정보와 현재 취소/환불 상태를 함께 표시하도록 보강했습니다.
+- PC 결제창 close-report와 승인 콜백이 경쟁할 때 결제 성공 주문이 실패 처리로 덮이지 않도록 주문번호 단위 콜백 락과 최신 결제 상태 가드를 적용했습니다.
+- NHN KCP 부분취소 요청에서 `rem_mny`를 취소 후 잔액이 아닌 현재 부분취소 가능 금액으로 전달해 큰 금액 부분취소가 거절될 수 있던 문제를 수정했습니다.
+- 이커머스 주문설정 화면에서 NHN KCP 플러그인이 테스트 모드일 때 운영 전환 경고와 설정 이동 버튼을 표시하도록 보강했습니다.
+
+## [1.0.0-beta.5] - 2026-06-23
+
+### Fixed
+
+- 간편결제 주문의 원 결제수단이 사용자 주문완료/주문상세, 관리자 주문목록/주문상세에서 신용카드로만 보이지 않도록 표시 라벨과 관리자 목록 표시 맵을 보강했습니다.
+- 동일 주문의 NHN KCP 승인/가상계좌 콜백이 동시에 도착해도 결제완료 훅과 주문 부작용이 중복 실행되지 않도록 주문번호 단위 콜백 락을 추가했습니다.
+- 다통화 주문의 환율 스냅샷이 누락되거나 0인 경우 close-report, 재시도 API, 모바일 승인키, 승인 콜백에서 500 오류로 이어지지 않고 결제 통화 설정 오류로 명시 처리되도록 보강했습니다.
+- 결제창 닫힘, 인증 취소, 승인 실패, 금액 불일치 등 NHN KCP 실패 경로에서 주문 실패 상태와 결제 레코드의 PG별 실패 메타가 함께 기록되도록 보강했습니다.
+- 결제 실패/취소 후 같은 주문번호로 결제창을 다시 열 때 안전한 실패 주문만 `pending_order` / `ready` 상태로 복구하는 재시도 준비 API를 추가했습니다.
+- PC/모바일 결제창 호출 직전에 재시도 준비 API를 호출해 사용자가 결제 실패 후 동일 주문 결제를 다시 시도할 수 있도록 보강했습니다.
+
+## [1.0.0-beta.4] - 2026-06-03
+
+### Added
+
+- 이커머스 주문설정 결제수단 목록에 PAYCO, 네이버페이, 네이버페이 포인트, 카카오페이, Apple Pay 간편결제를 추가했습니다.
+- 레이아웃 편집기에서 이 플러그인의 설정 화면을 테스트 모드/운영 모드 상태로 전환해 미리볼 수 있도록 했습니다.
+- 레이아웃 편집기 데이터 소스 목록에서 이 확장이 제공하는 데이터 소스가 친화 명칭으로 표시되고, 어느 확장이 제공했는지 출처가 함께 표시됩니다.
+
+### Security
+
+- 가상계좌 입금통보와 에스크로 공통통보가 주문번호만으로 처리되지 않도록 저장된 KCP 거래번호, site_cd, 계좌번호, 금액을 교차 검증하도록 보강했습니다.
+- 모바일 승인키 발급 시 주문 소유자와 결제금액을 검증해 타인 주문번호 또는 변조 금액으로 승인키가 발급되지 않도록 차단했습니다.
+- 무서명 브라우저 실패 콜백만으로 진행 중 주문이 취소/실패 상태로 바뀌지 않도록 차단했습니다.
+- NHN KCP가 지원하지 않는 비-KRW 주문이 결제창/승인 콜백으로 진행되지 않도록 서버와 프론트 가드를 추가했습니다.
+- KCP CLI 디버그 로그와 에스크로 배송등록 PG 응답 저장에서 비밀키, 카드번호, 수령자 개인정보 등 원문 민감값이 남지 않도록 축소했습니다.
+- 에스크로 공통통보 replay 시 동일 payload가 내부 hook을 중복 발행하지 않도록 보강했습니다.
+
+### Fixed
+
+- NHN KCP 간편결제 성공 시 원 결제수단이 주문 결제 메타와 간편결제 PG 필드에 보존되도록 보강했습니다.
+- 이미 결제 완료된 주문의 카드 승인 콜백이 중복 도착하면 KCP 승인 API를 다시 호출하지 않고 멱등 성공 응답으로 처리하도록 보강했습니다.
+- 플러그인 설정 화면에 NHN KCP 상점관리자의 결제취소 서버 IP 등록 필요 안내와 서버 IP 복사 기능을 추가해 운영 모드 결제취소 실패 원인을 사전에 확인할 수 있도록 했습니다.
+- 관리자 주문목록과 주문상세 레이아웃이 리뉴얼되거나 플러그인 업데이트 과정에서 NHN KCP 테스트결제 배지, 테스트 모드 안내, 결제 조회/결제 정보 패널이 누락될 수 있던 문제를 수정했습니다.
+- 복합과세 모바일/PC 결제 필드의 공급가액, 부가세, 비과세 합계가 할인/마일리지 반영 후 실결제액과 일치하도록 재배분했습니다.
+- 에스크로 테스트 site_cd가 비어 있으면 빈 값이 아닌 일반 테스트 site_cd로 fallback되도록 보정했습니다.
+- 환불 처리 시 결제 당시 KCP site_cd와 테스트/운영 모드를 복원하도록 보강했습니다.
+- KCP webhook IP 가드가 설정 누락 시 테스트 모드로 우회되지 않고 차단되도록 변경했습니다.
+- 이커머스 관리자 주문설정 결제수단 목록에서 NHN KCP 간편결제 항목이 브랜드 텍스트 배지로 표시되도록 보강했습니다.
+- 체크아웃에서 주문설정으로 활성화한 NHN KCP 간편결제가 숨겨지거나 KG 이니시스 브랜드 문구로 잘못 보정되는 문제를 수정했습니다.
+- 결제 취소/부분취소 시 KCP CLI 내부 필드 구분자가 안전성 검사에 막혀 취소 요청이 실패할 수 있던 문제를 수정했습니다.
+- 활성 관리자 테마에 최신 시맨틱 CSS가 없어도 플러그인 설정 화면의 여백, 카드 경계, 하단 저장 영역이 깨지지 않도록 보강했습니다.
+- NHN KCP PC 결제창을 사용자가 닫거나 취소 콜백이 들어온 경우 임시 주문이 `pending_order` / `ready` 상태로 남지 않고 결제실패/취소 상태로 기록되도록 보강했습니다.
+- KCP PC 결제창 내부 취소 버튼이 외부 iframe을 제거하는 흐름에서도 `close-report`가 호출되도록 감시 로직을 추가했습니다.
+
+### Changed
+
+- 환경설정 / 주문 화면 결제 영역 외형을 sirsoft-admin_basic 표준 시맨틱과 정합 — 다른 화면과 같은 결로 통일.
+- 관리자 화면 좌우 정렬 컨테이너(섹션 헤더 · 액션바 · 카드 상단부 등) 외형을 표준 시맨틱(.flex-between)으로 정리 — 시각 변경 없음, 향후 톤 조정이 한 곳에서 가능.
+- 플러그인 환경설정 화면의 하단 저장 버튼이 스크롤 중에도 화면에 고정되도록 개선.
+- 환경설정 화면의 가상계좌 입금 통보 URL · 에스크로 통보 URL 표시 입력의 외형을 관리자 표준 외형으로 정렬 — 글자가 옅은 회색으로 표시되어 "참조용 잠긴 정보" 임을 한눈에 구분.
+- 플러그인 환경설정 화면의 폼 라벨 / 보조 설명 / 에러 메시지 시각 시맨틱을 sirsoft-admin_basic 표준 시맨틱과 정합 — 다른 관리자 화면과 같은 결로 통일.
+- 플러그인 환경설정 화면 곳곳의 텍스트 톤 (보조 설명 · 라벨 · 본문 · 강조 · 작은 보조) 시각 시맨틱을 관리자 표준 시맨틱과 정합 — 같은 결의 글자 톤이 한 곳에서 일괄 조정 가능.
+- 플러그인 환경설정 화면의 세로 정렬 컨테이너 / 입력 박스를 sirsoft-admin_basic 표준 시맨틱 (.row-stack / .input) 과 정합 — 입력 행 사이에 옅은 회색 구분선(1px) 이 자동 적용되어 행 묶음 가독성이 개선되고, 입력 박스 외형이 일관 표시되도록 정리.
+
+## [1.0.0-beta.3] - 2026-05-20
+
+### Fixed
+
+- 결제창 종료 등으로 KCP 콜백의 `res_cd` 가 빈 값으로 들어온 경우 validation 오류가 아닌 사용자 취소 흐름으로 조용히 복귀하도록 수정했습니다.
+
+### Security
+
+- 결제 승인/가상계좌 통보 응답 원문 저장을 필요한 필드만 남기는 방식으로 축소 — PG 응답에 섞일 수 있는 카드번호, 구매자 연락처, 계좌 관련 민감 정보의 메타 저장 위험을 줄였습니다.
+
+## [1.0.0-beta.2] - 2026-05-20
+
+### Added
+
+- PG 측 결제 취소가 확인된 시점에 활동 로그가 별도로 기록되도록 보강 — 운영자가 PG 응답 시각 / 취소 거래번호 등 사후 추적에 활용 가능.
+
+### Fixed
+
+- PC 결제 승인 시 간헐적으로 발생하던 "연동 모듈 호출 오류" 가 결제 직전 자동으로 자가 복구되도록 개선 — 플러그인 업데이트 직후 실행 권한 회귀로 인한 결제 실패를 차단합니다. 자동 복구가 불가능한 환경에서는 권한 조치 안내가 포함된 명확한 오류 메시지로 즉시 중단되어 운영자가 빠르게 대응할 수 있습니다.
+- KCP CLI 바이너리가 저장소에 실행 가능 권한으로 기록되도록 정정 — 신규 설치 또는 플러그인 업데이트 직후에도 별도 권한 조치 없이 PC 결제가 바로 동작합니다. (Windows 환경은 영향 없음)
+- 부분취소 시 PG 가 전액취소로 잘못 처리되어 거부될 수 있던 문제 수정 — 부분취소 금액과 원래 결제금액이 올바르게 전달되도록 정정.
+
+### Security
+
+- KCP CLI 호출 시 결제 메타가 평문으로 디스크에 누적되던 문제 차단 — 카드번호 등 민감 정보가 플러그인 내부 로그 파일에 더 이상 저장되지 않습니다. (PCI DSS 평문 저장 우려 해소 + 비표준 서버 배치에서의 직접 다운로드 위험 차단)
+- 결제 콜백 중복 처리 방어 추가 — 동일 거래번호로 콜백이 두 번 도착해도 결제완료/마일리지 적립 등이 중복 실행되지 않도록 멱등 응답 처리
+- 결제 처리 중 오류 발생 시 결제 자동 취소 추가 — 카드 승인 후 후속 처리(금액 검증 등) 실패 시 PG 측 결제도 자동 취소하여 사용자 환불 누락 방지
+- Windows 환경의 결제 모듈 호출 시 입력값 안전성 강화 — 위험 문자 사전 거부로 잠재적 명령 주입 차단
+
+## [1.0.0-beta.1] - 2026-04-22
+
+### Changed
+
+- 플러그인 식별자를 `sirsoft-pay-nhnkcp`에서 `sirsoft-pay_nhnkcp`로 변경 — G7 코어가 권장하는 `vendor-name` 2-part 명명 규칙에 맞추기 위함
+- 환불 메시지를 한국어/영어 다국어로 분리 — 운영 언어에 따라 자동 노출
+- PG 프로바이더 표시명을 다국어 키로 분리 — 활성 언어팩으로 자동 보강되어 다른 PG 플러그인과 동일한 컨벤션으로 정렬
+
+### Added
+
+- 오픈 베타 릴리즈
+- `sirsoft-pay_nhnkcp.payment.before_cancel` / `after_cancel` 액션 훅 — 외부 소비자가 결제 취소 지점에 본인인증 등 확장 로직을 붙일 수 있도록 확장점 제공
+- PG 도메인 전용 예외 도입 — 외부 소비자가 NHN KCP 도메인 오류만 선택적으로 처리할 수 있도록 개선
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/LICENSE b/plugins/_bundled/sirsoft-pay_nhnkcp/LICENSE
new file mode 100644
index 00000000..9c330b41
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/LICENSE
@@ -0,0 +1,47 @@
+프로그램 명칭 : 그누보드7용 NHN KCP 플러그인 (sirsoft-pay-nhnkcp)
+
+저작자 : (주)에스아이알소프트
+
+----- MIT 라이선스 (한국어 번역) --------------------------------------------------------
+
+MIT 라이선스
+
+Copyright (c) 2026 (주)에스아이알소프트
+
+이 소프트웨어와 관련 문서 파일(이하 "소프트웨어")의 복사본을 취득하는 모든 사람에게
+소프트웨어를 제한 없이 사용, 복사, 수정, 병합, 출판, 배포, 서브라이선스 허여 및/또는
+판매할 수 있는 권리를 무상으로 부여합니다. 다만, 소프트웨어를 제공받은 사람은 다음
+조건을 따라야 합니다:
+
+위 저작권 고지와 본 허가 고지는 소프트웨어의 모든 복사본 또는 상당 부분에 포함되어야
+합니다.
+
+소프트웨어는 "있는 그대로" 제공되며, 명시적이든 묵시적이든 어떠한 종류의 보증도 하지
+않습니다. 여기에는 상품성, 특정 목적에의 적합성 및 비침해에 대한 보증이 포함되나 이에
+국한되지 않습니다. 어떠한 경우에도 저작자 또는 저작권자는 소프트웨어나 소프트웨어의
+사용 또는 기타 거래로 인해 발생하는 계약, 불법행위 또는 기타 청구, 손해 또는 기타
+책임에 대해 책임을 지지 않습니다.
+
+----- MIT License (English Original) --------------------------------------------------------
+
+The MIT License (MIT)
+
+Copyright (c) 2026 SIRSOFT
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/README.md b/plugins/_bundled/sirsoft-pay_nhnkcp/README.md
new file mode 100644
index 00000000..e71edf19
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/README.md
@@ -0,0 +1,249 @@
+# NHN KCP Plugin for G7
+
+NHN KCP Standard Pay 결제를 G7 `sirsoft-ecommerce` 모듈에 연결하는 결제 플러그인입니다.
+
+PC 결제는 KCP `payplus_web.jsp` 결제창과 KCP CLI 승인 모듈을 사용하고, 모바일 결제는 SmartPhone Pay SOAP 승인키를 받은 뒤 KCP 모바일 결제창으로 이동합니다.
+
+## 주요 기능
+
+- 신용카드, 계좌이체, 가상계좌, 휴대폰결제 지원
+- PC Standard Pay 결제창 연동
+- 모바일 SmartPhone Pay 승인키 발급 및 모바일 결제창 연동
+- PAYCO, 네이버페이, 네이버페이 포인트, 카카오페이, Apple Pay 간편결제 버튼 주입
+- 가상계좌 발급, 입금통보, 테스트 모드 모의입금 처리
+- 에스크로 결제, 에스크로 배송 등록, 공통통보 처리
+- 결제 취소 및 부분취소 연동
+- PG 측 결제 취소 확인 시점의 활동 로그 별도 기록 (PG 응답 시각·취소 거래번호 사후 추적)
+- 주문 완료/마이페이지 영수증, 현금영수증 조회 버튼 주입
+- 관리자 주문 상세의 KCP 거래 정보 표시
+- 관리자 설정 화면의 KCP 실행 환경 점검
+
+## 요구 사항
+
+| 항목 | 내용 |
+|------|------|
+| G7 | `>= 7.0.0-beta.2` |
+| 의존 모듈 | `sirsoft-ecommerce >= 1.0.0-beta.5` |
+| PHP | `^8.2` |
+| PC 결제 | PHP `exec()` 사용 가능, KCP CLI 바이너리, `pub.key` |
+| 모바일 결제 | PHP SOAP 확장, KCP WSDL 파일 |
+| 운영 환경 | HTTPS 도메인, 올바른 `APP_URL`, KCP 가맹점 계약 정보 |
+
+`bin/` 디렉토리에는 아래 파일이 필요합니다.
+
+```text
+bin/pp_cli
+bin/pp_cli_x64
+bin/pp_cli_exe.exe
+bin/pub.key
+bin/KCPPaymentService.wsdl
+bin/real_KCPPaymentService.wsdl
+```
+
+Linux 서버에서는 현재 OS 아키텍처에 맞는 CLI 파일에 실행 권한이 필요합니다.
+
+```bash
+chmod 755 plugins/sirsoft-pay_nhnkcp/bin/pp_cli
+chmod 755 plugins/sirsoft-pay_nhnkcp/bin/pp_cli_x64
+```
+
+관리자 설정 화면의 시스템 점검 API가 실행 권한을 자동 복구할 수 있지만, 서버 권한 정책에 따라 직접 조치가 필요할 수 있습니다.
+
+## 설치
+
+플러그인을 G7 프로젝트의 플러그인 디렉토리에 배치합니다.
+
+```text
+plugins/sirsoft-pay_nhnkcp
+```
+
+프론트엔드 에셋을 수정한 경우 플러그인 디렉토리에서 빌드합니다.
+
+```bash
+npm install
+npm run build
+```
+
+그다음 G7 관리자에서 플러그인을 활성화하고, 이커머스 결제 설정에서 PG 제공자를 `NHN KCP`로 선택합니다.
+
+## 관리자 설정
+
+관리자 플러그인 설정 화면에서 KCP 계약 정보를 입력합니다.
+
+| 설정 | 설명 |
+|------|------|
+| 테스트 모드 | 활성화 시 KCP 테스트 환경을 사용합니다. |
+| 테스트 사이트 코드 | 기본값은 `T0000`입니다. |
+| 테스트 사이트 키 | KCP 테스트 site key입니다. |
+| 라이브 사이트 코드 | 운영 site code입니다. `SR` prefix 없이 입력해도 플러그인이 자동 보정합니다. |
+| 라이브 사이트 키 | 운영 site key입니다. 외부에 노출하지 마세요. |
+| 결제 성공 URL | 기본값은 `/shop/orders/{orderId}/complete`입니다. |
+| 결제 실패 URL | 기본값은 `/shop/checkout`입니다. |
+| 가상계좌 입금 만료일 | 가상계좌 발급 후 입금 가능 기간입니다. |
+| 에스크로 결제 사용 | 활성화 시 KCP 에스크로 결제 파라미터를 함께 전달합니다. |
+| 에스크로 테스트 사이트 코드 | 테스트 에스크로 site code입니다. 기본 fallback은 `T0007`입니다. |
+| 간편결제 | KCP 계약이 완료된 간편결제만 활성화하세요. |
+| 타 PG와 사용가능함 | 다른 PG가 기본값이어도 KCP 간편결제 버튼을 체크아웃 화면에 표시합니다. |
+
+PAYCO 테스트 결제는 내부 기본값으로 간편결제 테스트 site code `S6729`를 사용합니다.
+
+## 콜백 및 통보 URL
+
+KCP 가맹점 관리자에 아래 URL을 등록합니다. 도메인은 실제 운영 도메인으로 바꿔 입력하세요.
+
+| 용도 | URL |
+|------|-----|
+| 결제 결과 Return URL | `https://your-domain.com/plugins/sirsoft-pay_nhnkcp/payment/callback` |
+| 가상계좌 입금통보 URL | `https://your-domain.com/plugins/sirsoft-pay_nhnkcp/payment/vbank-notify` |
+| 에스크로 공통통보 URL | `https://your-domain.com/plugins/sirsoft-pay_nhnkcp/payment/escrow-common-notify` |
+
+결제 결과 Return URL은 브라우저가 POST하는 경로이므로 IP 제한을 적용하지 않습니다. 가상계좌 입금통보와 에스크로 공통통보는 KCP 서버가 직접 호출하므로 운영 모드에서 IP 화이트리스트를 적용합니다.
+
+## IP 화이트리스트
+
+운영 모드에서는 아래 IP에서 들어온 KCP 서버 통보만 허용합니다. 테스트 모드에서는 개발과 KCP testadmin 모의입금을 위해 IP 제한을 우회합니다.
+
+| IP |
+|----|
+| `203.238.36.58` |
+| `203.238.36.160` |
+| `203.238.36.161` |
+| `203.238.36.173` |
+| `203.238.36.178` |
+| `103.215.144.173` |
+| `103.215.144.174` |
+| `103.215.145.30` |
+| `210.122.72.173` |
+
+운영 전 KCP 가맹점 관리자와 최신 연동 가이드의 통보 서버 IP를 다시 확인하세요.
+
+## 결제 흐름
+
+### PC 결제
+
+```text
+체크아웃 주문 생성
+→ 프론트엔드 핸들러가 payplus_web.jsp 결제창 실행
+→ KCP가 /payment/callback 으로 enc_data, enc_info POST
+→ 서버가 KCP CLI로 승인 확인
+→ 주문 결제 완료 처리
+→ 성공 URL로 리다이렉트
+```
+
+### 모바일 결제
+
+```text
+체크아웃 주문 생성
+→ /api/plugins/sirsoft-pay_nhnkcp/mobile/approval-key 호출
+→ 서버가 KCP SOAP approve 로 approval_key, pay_url 획득
+→ 브라우저가 pay_url 로 form POST
+→ KCP가 /payment/callback 으로 결과 POST
+→ 주문 결제 완료 처리
+→ 성공 URL로 리다이렉트
+```
+
+### 가상계좌
+
+```text
+결제창에서 가상계좌 발급
+→ 주문 결제 정보에 은행, 계좌번호, 예금주, 만료일 저장
+→ 주문은 입금대기 상태 유지
+→ KCP가 /payment/vbank-notify 로 입금통보 POST
+→ 입금 금액 검증 후 주문 결제 완료 처리
+```
+
+테스트 모드에서는 마이페이지 주문 상세에 KCP testadmin 모의입금 폼이 표시될 수 있습니다.
+
+### 에스크로
+
+에스크로를 활성화하면 결제 요청에 `escw_used=Y`, `pay_mod=O`를 전달합니다. 에스크로 결제 완료 후 관리자 주문 상세에서 운송장번호와 택배사를 입력해 KCP 배송 등록을 호출할 수 있습니다.
+
+KCP 공통통보는 아래 이벤트를 처리합니다.
+
+| tx_cd | 조건 | 처리 |
+|-------|------|------|
+| `TX02` | `cl_status=2` | 구매확인 훅 실행 |
+| `TX02` | `cl_status=8` | 구매취소 훅 실행 |
+| `TX02` | `cl_status=3` | 구매취소 확인 훅 실행 |
+| `TX03` | - | 배송시작 훅 실행 |
+
+### 결제 취소 / 부분취소
+
+```text
+관리자 주문 취소 요청 (cancel_pg=true)
+→ 코어가 sirsoft-ecommerce.payment.refund 필터 훅 발화
+→ PaymentRefundListener 가 KCP cancelPayment API 호출
+   · 전액취소: isPartial=false
+   · 부분취소: isPartial=true, totalAmt=원래 결제금액
+→ 코어가 환불 레코드 생성 + 쿠폰 / 마일리지 / 재고 복원
+→ CancelActivityLogListener 가 PG 응답 시각·취소 거래번호를 활동 로그에 기록
+```
+
+배송비가 포함된 주문은 전체취소 시 배송비도 함께 환불 레코드에 반영되고, 쿠폰이 적용된 주문은 실결제금액(쿠폰 차감 후) 이 PG cancelAmt 로 전달됩니다. 부분취소 시 쿠폰 최소 주문금액 조건을 더 이상 충족하지 못하면 코어가 취소 자체를 거부 (422) 하여 PG 호출이 발생하지 않습니다. KCP API 호출이 실패하면 주문 상태 변경이 롤백됩니다.
+
+## API
+
+### 사용자 API
+
+| Method | Path | 설명 |
+|--------|------|------|
+| `GET` | `/api/plugins/sirsoft-pay_nhnkcp/user/orders/{orderNumber}/receipt` | KCP 영수증, 현금영수증 URL 조회 |
+| `GET` | `/api/plugins/sirsoft-pay_nhnkcp/user/orders/{orderNumber}/vbank-mock-deposit-info` | 테스트 모드 가상계좌 모의입금 정보 조회 |
+| `POST` | `/api/plugins/sirsoft-pay_nhnkcp/mobile/approval-key` | 모바일 결제 승인키 발급 |
+
+### 관리자 API
+
+| Method | Path | 설명 |
+|--------|------|------|
+| `GET` | `/api/plugins/sirsoft-pay_nhnkcp/admin/vbank-notify-url` | 가상계좌/에스크로 통보 URL 조회 |
+| `GET` | `/api/plugins/sirsoft-pay_nhnkcp/admin/orders/test-mode-map` | 주문목록 테스트 모드 배지용 맵 조회 |
+| `GET` | `/api/plugins/sirsoft-pay_nhnkcp/admin/orders/{orderNumber}/transaction-status` | 저장된 KCP 거래 정보 조회 |
+| `GET` | `/api/plugins/sirsoft-pay_nhnkcp/admin/orders/{orderNumber}/escrow-delivery` | 에스크로 배송 등록 폼 데이터 조회 |
+| `POST` | `/api/plugins/sirsoft-pay_nhnkcp/admin/orders/{orderNumber}/escrow-delivery` | KCP 에스크로 배송 등록 |
+| `GET` | `/api/plugins/sirsoft-pay_nhnkcp/admin/health` | KCP 실행 환경 점검 |
+
+## 훅
+
+다른 모듈이나 플러그인에서 아래 훅에 연결해 결제 흐름을 확장할 수 있습니다.
+
+| 훅 | 타입 | 시점 |
+|----|------|------|
+| `sirsoft-pay_nhnkcp.payment.before_confirm` | action | KCP CLI 승인 확인 전 |
+| `sirsoft-pay_nhnkcp.payment.after_confirm` | action | KCP CLI 승인 확인 후 |
+| `sirsoft-pay_nhnkcp.payment.before_cancel` | action | KCP 취소 API 호출 전 |
+| `sirsoft-pay_nhnkcp.payment.after_cancel` | action | KCP 취소 API 호출 후 |
+| `sirsoft-pay_nhnkcp.escrow.purchase_confirmed` | action | 에스크로 구매확인 통보 수신 |
+| `sirsoft-pay_nhnkcp.escrow.purchase_cancelled` | action | 에스크로 구매취소 통보 수신 |
+| `sirsoft-pay_nhnkcp.escrow.denial_confirmed` | action | 에스크로 구매취소 확인 통보 수신 |
+| `sirsoft-pay_nhnkcp.escrow.delivery_started` | action | 에스크로 배송시작 통보 수신 |
+
+## 보안 및 운영 참고
+
+- 운영 도메인의 `APP_URL`을 HTTPS 절대 URL로 정확히 설정하세요.
+- 운영 site key는 외부에 노출하지 마세요.
+- 운영 모드에서는 KCP 서버 통보 IP 화이트리스트가 적용됩니다.
+- 결제 승인 후 서버 후속 처리에 실패하면 PG 잔존 승인을 자동 취소합니다.
+- 동일 거래번호 콜백은 중복 처리하지 않도록 방어합니다.
+- KCP CLI 호출 인자는 위험 문자와 제어문자를 사전에 거부합니다.
+- 가상계좌와 에스크로 통보 URL은 KCP 가맹점 관리자에 반드시 등록해야 합니다.
+- KCP 계약이 없는 결제수단이나 간편결제를 활성화하면 KCP 오류가 발생할 수 있습니다.
+
+## 테스트
+
+플러그인을 G7 프로젝트에 배치한 뒤 G7 루트에서 PHP 테스트를 실행합니다.
+
+```bash
+php artisan test plugins/sirsoft-pay_nhnkcp/tests
+```
+
+프론트엔드 테스트와 빌드는 플러그인 디렉토리에서 실행합니다.
+
+```bash
+npm install
+npm run test:run
+npm run build
+```
+
+## 라이선스
+
+MIT
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/bin/KCPPaymentService.wsdl b/plugins/_bundled/sirsoft-pay_nhnkcp/bin/KCPPaymentService.wsdl
new file mode 100644
index 00000000..c950ca53
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/bin/KCPPaymentService.wsdl
@@ -0,0 +1,142 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<wsdl:definitions xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/" xmlns:http="http://schemas.xmlsoap.org/wsdl/http/" xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/" xmlns:ns1="http://org.apache.axis2/xsd" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl" xmlns:ax21="http://payment.domain.webpay.service.kcp.kr/xsd" xmlns:ns="http://webservice.act.webpay.service.kcp.kr" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:ax22="http://domain.webpay.service.kcp.kr/xsd" targetNamespace="http://webservice.act.webpay.service.kcp.kr">
+    <wsdl:types>
+        <xs:schema xmlns:ax23="http://domain.webpay.service.kcp.kr/xsd" attributeFormDefault="qualified" elementFormDefault="qualified" targetNamespace="http://payment.domain.webpay.service.kcp.kr/xsd">
+            <xs:import namespace="http://domain.webpay.service.kcp.kr/xsd"/>
+            <xs:complexType name="ApproveReq">
+                <xs:sequence>
+                    <xs:element minOccurs="0" name="accessCredentialType" nillable="true" type="ax22:AccessCredentialType"/>
+                    <xs:element minOccurs="0" name="baseRequestType" nillable="true" type="ax22:BaseRequestType"/>
+                    <xs:element minOccurs="0" name="escrow" type="xs:boolean"/>
+                    <xs:element minOccurs="0" name="orderID" nillable="true" type="xs:string"/>
+                    <xs:element minOccurs="0" name="paymentAmount" nillable="true" type="xs:string"/>
+                    <xs:element minOccurs="0" name="paymentMethod" nillable="true" type="xs:string"/>
+                    <xs:element minOccurs="0" name="productName" nillable="true" type="xs:string"/>
+                    <xs:element minOccurs="0" name="returnUrl" nillable="true" type="xs:string"/>
+                    <xs:element minOccurs="0" name="siteCode" nillable="true" type="xs:string"/>
+                </xs:sequence>
+            </xs:complexType>
+            <xs:complexType name="ApproveRes">
+                <xs:sequence>
+                    <xs:element minOccurs="0" name="approvalKey" nillable="true" type="xs:string"/>
+                    <xs:element minOccurs="0" name="baseResponseType" nillable="true" type="ax22:BaseResponseType"/>
+                    <xs:element minOccurs="0" name="payUrl" nillable="true" type="xs:string"/>
+                </xs:sequence>
+            </xs:complexType>
+        </xs:schema>
+        <xs:schema xmlns:ax24="http://payment.domain.webpay.service.kcp.kr/xsd" attributeFormDefault="qualified" elementFormDefault="qualified" targetNamespace="http://webservice.act.webpay.service.kcp.kr">
+            <xs:import namespace="http://payment.domain.webpay.service.kcp.kr/xsd"/>
+            <xs:element name="approve">
+                <xs:complexType>
+                    <xs:sequence>
+                        <xs:element minOccurs="0" name="req" nillable="true" type="ax24:ApproveReq"/>
+                    </xs:sequence>
+                </xs:complexType>
+            </xs:element>
+            <xs:element name="approveResponse">
+                <xs:complexType>
+                    <xs:sequence>
+                        <xs:element minOccurs="0" name="return" nillable="true" type="ax24:ApproveRes"/>
+                    </xs:sequence>
+                </xs:complexType>
+            </xs:element>
+        </xs:schema>
+        <xs:schema attributeFormDefault="qualified" elementFormDefault="qualified" targetNamespace="http://domain.webpay.service.kcp.kr/xsd">
+            <xs:complexType name="AccessCredentialType">
+                <xs:sequence>
+                    <xs:element minOccurs="0" name="accessLicense" nillable="true" type="xs:string"/>
+                    <xs:element minOccurs="0" name="signature" nillable="true" type="xs:string"/>
+                    <xs:element minOccurs="0" name="timestamp" nillable="true" type="xs:string"/>
+                </xs:sequence>
+            </xs:complexType>
+            <xs:complexType name="BaseRequestType">
+                <xs:sequence>
+                    <xs:element minOccurs="0" name="detailLevel" nillable="true" type="xs:string"/>
+                    <xs:element minOccurs="0" name="requestApp" nillable="true" type="xs:string"/>
+                    <xs:element minOccurs="0" name="requestID" nillable="true" type="xs:string"/>
+                    <xs:element minOccurs="0" name="userAgent" nillable="true" type="xs:string"/>
+                    <xs:element minOccurs="0" name="version" nillable="true" type="xs:string"/>
+                </xs:sequence>
+            </xs:complexType>
+            <xs:complexType name="BaseResponseType">
+                <xs:sequence>
+                    <xs:element minOccurs="0" name="detailLevel" nillable="true" type="xs:string"/>
+                    <xs:element minOccurs="0" name="error" nillable="true" type="ax22:ErrorType"/>
+                    <xs:element minOccurs="0" name="messageID" nillable="true" type="xs:string"/>
+                    <xs:element minOccurs="0" name="release" nillable="true" type="xs:string"/>
+                    <xs:element minOccurs="0" name="requestID" nillable="true" type="xs:string"/>
+                    <xs:element minOccurs="0" name="responseType" nillable="true" type="xs:string"/>
+                    <xs:element minOccurs="0" name="timestamp" nillable="true" type="xs:string"/>
+                    <xs:element minOccurs="0" name="version" nillable="true" type="xs:string"/>
+                    <xs:element maxOccurs="unbounded" minOccurs="0" name="warningList" nillable="true" type="ax22:ErrorType"/>
+                </xs:sequence>
+            </xs:complexType>
+            <xs:complexType name="ErrorType">
+                <xs:sequence>
+                    <xs:element minOccurs="0" name="code" nillable="true" type="xs:string"/>
+                    <xs:element minOccurs="0" name="detail" nillable="true" type="xs:string"/>
+                    <xs:element minOccurs="0" name="message" nillable="true" type="xs:string"/>
+                </xs:sequence>
+            </xs:complexType>
+        </xs:schema>
+    </wsdl:types>
+    <wsdl:message name="approveRequest">
+        <wsdl:part name="parameters" element="ns:approve"/>
+    </wsdl:message>
+    <wsdl:message name="approveResponse">
+        <wsdl:part name="parameters" element="ns:approveResponse"/>
+    </wsdl:message>
+    <wsdl:portType name="PayServicePortType">
+        <wsdl:operation name="approve">
+            <wsdl:input message="ns:approveRequest" wsaw:Action="urn:approve"/>
+            <wsdl:output message="ns:approveResponse" wsaw:Action="urn:approveResponse"/>
+        </wsdl:operation>
+    </wsdl:portType>
+    <wsdl:binding name="PayServiceSoap11Binding" type="ns:PayServicePortType">
+        <soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="document"/>
+        <wsdl:operation name="approve">
+            <soap:operation soapAction="urn:approve" style="document"/>
+            <wsdl:input>
+                <soap:body use="literal"/>
+            </wsdl:input>
+            <wsdl:output>
+                <soap:body use="literal"/>
+            </wsdl:output>
+        </wsdl:operation>
+    </wsdl:binding>
+    <wsdl:binding name="PayServiceSoap12Binding" type="ns:PayServicePortType">
+        <soap12:binding transport="http://schemas.xmlsoap.org/soap/http" style="document"/>
+        <wsdl:operation name="approve">
+            <soap12:operation soapAction="urn:approve" style="document"/>
+            <wsdl:input>
+                <soap12:body use="literal"/>
+            </wsdl:input>
+            <wsdl:output>
+                <soap12:body use="literal"/>
+            </wsdl:output>
+        </wsdl:operation>
+    </wsdl:binding>
+    <wsdl:binding name="PayServiceHttpBinding" type="ns:PayServicePortType">
+        <http:binding verb="POST"/>
+        <wsdl:operation name="approve">
+            <http:operation location="PayService/approve"/>
+            <wsdl:input>
+                <mime:content type="text/xml" part="approve"/>
+            </wsdl:input>
+            <wsdl:output>
+                <mime:content type="text/xml" part="approve"/>
+            </wsdl:output>
+        </wsdl:operation>
+    </wsdl:binding>
+    <wsdl:service name="PayService">
+        <wsdl:port name="PayServiceHttpSoap11Endpoint" binding="ns:PayServiceSoap11Binding">
+            <soap:address location="https://testsmpay.kcp.co.kr/services/KCPPaymentService"/>
+        </wsdl:port>
+        <wsdl:port name="PayServiceHttpSoap12Endpoint" binding="ns:PayServiceSoap12Binding">
+            <soap12:address location="https://testsmpay.kcp.co.kr/services/KCPPaymentService"/>
+        </wsdl:port>
+        <wsdl:port name="PayServiceHttpEndpoint" binding="ns:PayServiceHttpBinding">
+            <http:address location="https://testsmpay.kcp.co.kr/services/KCPPaymentService"/>
+        </wsdl:port>
+    </wsdl:service>
+</wsdl:definitions>
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/bin/pp_cli b/plugins/_bundled/sirsoft-pay_nhnkcp/bin/pp_cli
new file mode 100755
index 00000000..1d74a66a
Binary files /dev/null and b/plugins/_bundled/sirsoft-pay_nhnkcp/bin/pp_cli differ
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/bin/pp_cli_exe.exe b/plugins/_bundled/sirsoft-pay_nhnkcp/bin/pp_cli_exe.exe
new file mode 100644
index 00000000..cb05cd57
Binary files /dev/null and b/plugins/_bundled/sirsoft-pay_nhnkcp/bin/pp_cli_exe.exe differ
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/bin/pp_cli_x64 b/plugins/_bundled/sirsoft-pay_nhnkcp/bin/pp_cli_x64
new file mode 100755
index 00000000..4707f2c1
Binary files /dev/null and b/plugins/_bundled/sirsoft-pay_nhnkcp/bin/pp_cli_x64 differ
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/bin/pub.key b/plugins/_bundled/sirsoft-pay_nhnkcp/bin/pub.key
new file mode 100644
index 00000000..8b0c51e4
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/bin/pub.key
@@ -0,0 +1,5 @@
+-----BEGIN RSA PUBLIC KEY-----
+MIGJAoGBAMEn9niy+ZB7GGn9JOA9csyJo2vTpd3/ieHW8nCfiDf77YJvEtUmudCU
+JXMNQ1uBuHq7+IzajoJhhvGXyOHVr9w+Oq/d8XZPPe7X2agh1WAMDV4mjQNaAncr
+DU1qxlTFuAdKRkK7qkqyWSHHtq0HaW/zmBmcIoGn4RwY9y7oKFBpAgMBAAE=
+-----END RSA PUBLIC KEY-----
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/bin/real_KCPPaymentService.wsdl b/plugins/_bundled/sirsoft-pay_nhnkcp/bin/real_KCPPaymentService.wsdl
new file mode 100644
index 00000000..21c74fab
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/bin/real_KCPPaymentService.wsdl
@@ -0,0 +1,145 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<wsdl:definitions xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/" xmlns:http="http://schemas.xmlsoap.org/wsdl/http/" xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/" xmlns:ns1="http://org.apache.axis2/xsd" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl" xmlns:ax21="http://payment.domain.webpay.service.kcp.kr/xsd" xmlns:ns="http://webservice.act.webpay.service.kcp.kr" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:ax22="http://domain.webpay.service.kcp.kr/xsd" targetNamespace="http://webservice.act.webpay.service.kcp.kr">
+    <wsdl:documentation>
+		KCP Payment Service
+	</wsdl:documentation>
+    <wsdl:types>
+        <xs:schema xmlns:ax23="http://domain.webpay.service.kcp.kr/xsd" targetNamespace="http://payment.domain.webpay.service.kcp.kr/xsd" attributeFormDefault="qualified" elementFormDefault="qualified">
+            <xs:import namespace="http://domain.webpay.service.kcp.kr/xsd"/>
+            <xs:complexType name="ApproveReq">
+                <xs:sequence>
+                    <xs:element name="accessCredentialType" minOccurs="0" type="ax22:AccessCredentialType" nillable="true"/>
+                    <xs:element name="baseRequestType" minOccurs="0" type="ax22:BaseRequestType" nillable="true"/>
+                    <xs:element name="escrow" minOccurs="0" type="xs:boolean"/>
+                    <xs:element name="orderID" minOccurs="0" type="xs:string" nillable="true"/>
+                    <xs:element name="paymentAmount" minOccurs="0" type="xs:string" nillable="true"/>
+                    <xs:element name="paymentMethod" minOccurs="0" type="xs:string" nillable="true"/>
+                    <xs:element name="productName" minOccurs="0" type="xs:string" nillable="true"/>
+                    <xs:element name="returnUrl" minOccurs="0" type="xs:string" nillable="true"/>
+                    <xs:element name="siteCode" minOccurs="0" type="xs:string" nillable="true"/>
+                </xs:sequence>
+            </xs:complexType>
+            <xs:complexType name="ApproveRes">
+                <xs:sequence>
+                    <xs:element name="approvalKey" minOccurs="0" type="xs:string" nillable="true"/>
+                    <xs:element name="baseResponseType" minOccurs="0" type="ax22:BaseResponseType" nillable="true"/>
+                    <xs:element name="payUrl" minOccurs="0" type="xs:string" nillable="true"/>
+                </xs:sequence>
+            </xs:complexType>
+        </xs:schema>
+        <xs:schema xmlns:ax24="http://payment.domain.webpay.service.kcp.kr/xsd" targetNamespace="http://webservice.act.webpay.service.kcp.kr" attributeFormDefault="qualified" elementFormDefault="qualified">
+            <xs:import namespace="http://payment.domain.webpay.service.kcp.kr/xsd"/>
+            <xs:element name="approve">
+                <xs:complexType>
+                    <xs:sequence>
+                        <xs:element name="req" minOccurs="0" type="ax24:ApproveReq" nillable="true"/>
+                    </xs:sequence>
+                </xs:complexType>
+            </xs:element>
+            <xs:element name="approveResponse">
+                <xs:complexType>
+                    <xs:sequence>
+                        <xs:element name="return" minOccurs="0" type="ax24:ApproveRes" nillable="true"/>
+                    </xs:sequence>
+                </xs:complexType>
+            </xs:element>
+        </xs:schema>
+        <xs:schema targetNamespace="http://domain.webpay.service.kcp.kr/xsd" attributeFormDefault="qualified" elementFormDefault="qualified">
+            <xs:complexType name="AccessCredentialType">
+                <xs:sequence>
+                    <xs:element name="accessLicense" minOccurs="0" type="xs:string" nillable="true"/>
+                    <xs:element name="signature" minOccurs="0" type="xs:string" nillable="true"/>
+                    <xs:element name="timestamp" minOccurs="0" type="xs:string" nillable="true"/>
+                </xs:sequence>
+            </xs:complexType>
+            <xs:complexType name="BaseRequestType">
+                <xs:sequence>
+                    <xs:element name="detailLevel" minOccurs="0" type="xs:string" nillable="true"/>
+                    <xs:element name="requestApp" minOccurs="0" type="xs:string" nillable="true"/>
+                    <xs:element name="requestID" minOccurs="0" type="xs:string" nillable="true"/>
+                    <xs:element name="userAgent" minOccurs="0" type="xs:string" nillable="true"/>
+                    <xs:element name="version" minOccurs="0" type="xs:string" nillable="true"/>
+                </xs:sequence>
+            </xs:complexType>
+            <xs:complexType name="BaseResponseType">
+                <xs:sequence>
+                    <xs:element name="detailLevel" minOccurs="0" type="xs:string" nillable="true"/>
+                    <xs:element name="error" minOccurs="0" type="ax22:ErrorType" nillable="true"/>
+                    <xs:element name="messageID" minOccurs="0" type="xs:string" nillable="true"/>
+                    <xs:element name="release" minOccurs="0" type="xs:string" nillable="true"/>
+                    <xs:element name="requestID" minOccurs="0" type="xs:string" nillable="true"/>
+                    <xs:element name="responseType" minOccurs="0" type="xs:string" nillable="true"/>
+                    <xs:element name="timestamp" minOccurs="0" type="xs:string" nillable="true"/>
+                    <xs:element name="version" minOccurs="0" type="xs:string" nillable="true"/>
+                    <xs:element name="warningList" maxOccurs="unbounded" minOccurs="0" type="ax22:ErrorType" nillable="true"/>
+                </xs:sequence>
+            </xs:complexType>
+            <xs:complexType name="ErrorType">
+                <xs:sequence>
+                    <xs:element name="code" minOccurs="0" type="xs:string" nillable="true"/>
+                    <xs:element name="detail" minOccurs="0" type="xs:string" nillable="true"/>
+                    <xs:element name="message" minOccurs="0" type="xs:string" nillable="true"/>
+                </xs:sequence>
+            </xs:complexType>
+        </xs:schema>
+    </wsdl:types>
+    <wsdl:message name="approveRequest">
+        <wsdl:part name="parameters" element="ns:approve"/>
+    </wsdl:message>
+    <wsdl:message name="approveResponse">
+        <wsdl:part name="parameters" element="ns:approveResponse"/>
+    </wsdl:message>
+    <wsdl:portType name="KCPPaymentServicePortType">
+        <wsdl:operation name="approve">
+            <wsdl:input message="ns:approveRequest" wsaw:Action="urn:approve"/>
+            <wsdl:output message="ns:approveResponse" wsaw:Action="urn:approveResponse"/>
+        </wsdl:operation>
+    </wsdl:portType>
+    <wsdl:binding name="KCPPaymentServiceSoap11Binding" type="ns:KCPPaymentServicePortType">
+        <soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="document"/>
+        <wsdl:operation name="approve">
+            <soap:operation soapAction="urn:approve" style="document"/>
+            <wsdl:input>
+                <soap:body use="literal"/>
+            </wsdl:input>
+            <wsdl:output>
+                <soap:body use="literal"/>
+            </wsdl:output>
+        </wsdl:operation>
+    </wsdl:binding>
+    <wsdl:binding name="KCPPaymentServiceSoap12Binding" type="ns:KCPPaymentServicePortType">
+        <soap12:binding transport="http://schemas.xmlsoap.org/soap/http" style="document"/>
+        <wsdl:operation name="approve">
+            <soap12:operation soapAction="urn:approve" style="document"/>
+            <wsdl:input>
+                <soap12:body use="literal"/>
+            </wsdl:input>
+            <wsdl:output>
+                <soap12:body use="literal"/>
+            </wsdl:output>
+        </wsdl:operation>
+    </wsdl:binding>
+    <wsdl:binding name="KCPPaymentServiceHttpBinding" type="ns:KCPPaymentServicePortType">
+        <http:binding verb="POST"/>
+        <wsdl:operation name="approve">
+            <http:operation location="KCPPaymentService/approve"/>
+            <wsdl:input>
+                <mime:content type="text/xml" part="approve"/>
+            </wsdl:input>
+            <wsdl:output>
+                <mime:content type="text/xml" part="approve"/>
+            </wsdl:output>
+        </wsdl:operation>
+    </wsdl:binding>
+    <wsdl:service name="KCPPaymentService">
+        <wsdl:port name="KCPPaymentServiceHttpSoap11Endpoint" binding="ns:KCPPaymentServiceSoap11Binding">
+            <soap:address location="https://smpay.kcp.co.kr/services/KCPPaymentService.KCPPaymentServiceHttpSoap11Endpoint/"/>
+        </wsdl:port>
+        <wsdl:port name="KCPPaymentServiceHttpSoap12Endpoint" binding="ns:KCPPaymentServiceSoap12Binding">
+            <soap12:address location="https://smpay.kcp.co.kr/services/KCPPaymentService.KCPPaymentServiceHttpSoap12Endpoint/"/>
+        </wsdl:port>
+        <wsdl:port name="KCPPaymentServiceHttpEndpoint" binding="ns:KCPPaymentServiceHttpBinding">
+            <http:address location="https://smpay.kcp.co.kr/services/KCPPaymentService.KCPPaymentServiceHttpEndpoint/"/>
+        </wsdl:port>
+    </wsdl:service>
+</wsdl:definitions>
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/composer.json b/plugins/_bundled/sirsoft-pay_nhnkcp/composer.json
new file mode 100644
index 00000000..0a909f1f
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/composer.json
@@ -0,0 +1,20 @@
+{
+    "name": "plugins/sirsoft-pay_nhnkcp",
+    "description": "NHN KCP PG Plugin for G7 platform",
+    "version": "1.0.0-beta.4",
+    "type": "library",
+    "authors": [
+        {
+            "name": "sirsoft",
+            "email": "contact@sirsoft.com"
+        }
+    ],
+    "require": {
+        "php": "^8.2"
+    },
+    "autoload": {
+        "psr-4": {
+            "Plugins\\Sirsoft\\PayNhnkcp\\": ["src/", "./"]
+        }
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/composer.lock b/plugins/_bundled/sirsoft-pay_nhnkcp/composer.lock
new file mode 100644
index 00000000..8ba2f579
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/composer.lock
@@ -0,0 +1,20 @@
+{
+    "_readme": [
+        "This file locks the dependencies of your project to a known state",
+        "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
+        "This file is @generated automatically"
+    ],
+    "content-hash": "88988d859f2433db8b07b8700f481c2d",
+    "packages": [],
+    "packages-dev": [],
+    "aliases": [],
+    "minimum-stability": "stable",
+    "stability-flags": {},
+    "prefer-stable": false,
+    "prefer-lowest": false,
+    "platform": {
+        "php": "^8.2"
+    },
+    "platform-dev": {},
+    "plugin-api-version": "2.6.0"
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/config/settings/defaults.json b/plugins/_bundled/sirsoft-pay_nhnkcp/config/settings/defaults.json
new file mode 100644
index 00000000..34c629e5
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/config/settings/defaults.json
@@ -0,0 +1,24 @@
+{
+    "_meta": {
+        "version": "1.0.0",
+        "description": "NHN KCP PG 플러그인 환경설정"
+    },
+    "defaults": {
+        "is_test_mode": true,
+        "test_site_cd": "T0000",
+        "test_site_key": "",
+        "live_site_cd": "",
+        "live_site_key": "",
+        "redirect_success_url": "/shop/orders/{orderId}/complete",
+        "redirect_fail_url": "/shop/checkout"
+    },
+    "frontend_schema": {
+        "is_test_mode": { "expose": false },
+        "test_site_cd": { "expose": false },
+        "test_site_key": { "expose": false },
+        "live_site_cd": { "expose": false },
+        "live_site_key": { "expose": false },
+        "redirect_success_url": { "expose": false },
+        "redirect_fail_url": { "expose": false }
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/dist/js/plugin.iife.js b/plugins/_bundled/sirsoft-pay_nhnkcp/dist/js/plugin.iife.js
new file mode 100644
index 00000000..1e0b6a5e
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/dist/js/plugin.iife.js
@@ -0,0 +1,18 @@
+(function(){"use strict";function tt(e){return/^https?:\/\//i.test(e)||e.startsWith("/api/")?e:e.startsWith("/plugins/")?`/api${e}`:e.startsWith("plugins/")?`/api/${e}`:e}function nt(e){return e.trim().slice(0,160)}function rt(e){if(e)return e.replace(/\/payment\/close-report$/,"/payment/retry")}async function ce(e,t,n=!1){const r=window.G7Core?.api;if(typeof r?.post=="function"){await r.post(e,t);return}const a=await fetch(tt(e),{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(t),keepalive:n});if(!a.ok){let o=`NHN KCP payment request failed (${a.status})`;try{const i=await a.json(),s=Array.isArray(i?.errors?.message)?i.errors.message[0]:i?.error??i?.message;typeof s=="string"&&s.trim()!==""&&(o=s)}catch{}throw new Error(o)}}async function at(e){const t=rt(e.closeReportUrl);t&&await ce(t,{oid:e.oid,price:Number(e.price),buyer_email:e.buyer_email??"",buyer_phone:e.buyer_phone??"",payment_method:e.payment_method??""})}async function ot(e,t="kcp-window-closed"){if(!e.closeReportUrl)return;const n={oid:e.oid,price:Number(e.price),buyer_email:e.buyer_email??"",buyer_phone:e.buyer_phone??"",payment_method:e.payment_method??"",reason:nt(t)||"kcp-window-closed"};try{await ce(e.closeReportUrl,n,!0)}catch(r){console.warn("[sirsoft-pay_nhnkcp] failed to report payment window close",r)}}const it="nhnkcp_applepay";function M(e){return e===it}function S(){if(typeof navigator>"u")return!1;const e=navigator,t=(e.userAgent||"").toLowerCase(),n=((e.userAgentData?.platform??e.platform)||"").toLowerCase(),r=e.maxTouchPoints??0;return/iphone|ipad|ipod/.test(t)||/iphone|ipad|ipod|ios/.test(n)?!0:/macintosh|mac os x/.test(t)&&r>1}function H(){return((typeof document<"u"?document.documentElement.lang:"")||"").toLowerCase().startsWith("ko")?"애플페이는 IOS 기기에 모바일결제만 가능합니다.":"Apple Pay is available only for mobile payments on iOS devices."}function B(e){return(e??"KRW").trim().toUpperCase()||"KRW"}function st(e){return B(e)==="KRW"}function ct(e){const t=B(e);return((typeof document<"u"?document.documentElement.lang:"")||"").toLowerCase().startsWith("ko")?`NHN KCP는 KRW 결제만 지원합니다. (${t})`:`NHN KCP supports KRW payments only. (${t})`}function dt(e){const t=Math.max(0,Math.round(Number(e.amount??0))),n=Math.min(Math.max(0,Math.round(Number(e.tax_free_amount??0))),t);if(n<=0)return{};const r=Math.max(0,Math.round(Number(e.tax_amount??0))),a=Math.max(0,Math.round(Number(e.vat_amount??0))),o=Math.max(0,t-n),i=o>0&&r>0&&a>0?Math.min(o,Math.round(o*(a/r))):0,s=o-i;return{tax_flag:"TG03",comm_tax_mny:String(s),comm_vat_mny:String(i),comm_free_mny:String(n)}}class D extends Error{constructor(t){super(t??"결제가 취소되었습니다."),this.name="KcpCancelledError"}}const lt={card:"100000000000",bank_transfer:"010000000000",virtual_account:"001000000000",mobile:"000010000000",bank:"010000000000",vbank:"001000000000",phone:"000010000000"},de={nhnkcp_payco:{payco_direct:"Y"},nhnkcp_naverpay:{naverpay_direct:"Y"},nhnkcp_naverpay_point:{naverpay_direct:"Y",naverpay_point_direct:"Y"},nhnkcp_kakaopay:{kakaopay_direct:"Y"},nhnkcp_applepay:{applepay_direct:"Y"}};function ut(e,t){const n=e.toLowerCase();return!t||!Object.prototype.hasOwnProperty.call(de,n)?{}:{param_opt_1:n,nhnkcp_easy_pay_method:n}}function pt(e){if(!e.isConnected)return!0;const t=window.getComputedStyle(e);if(t.display==="none"||t.visibility==="hidden")return!0;const n=e.getBoundingClientRect();return n.width<=0||n.height<=0}function mt(e,t){let n=!1,r,a;const o=()=>{n=!0,a&&(a.disconnect(),a=void 0),r!==void 0&&(window.clearInterval(r),r=void 0)},i=()=>{n||!pt(e)||(o(),t())},s=document.body??document.documentElement;return s&&typeof MutationObserver<"u"&&(a=new MutationObserver(i),a.observe(s,{attributes:!0,attributeFilter:["class","hidden","style"],childList:!0,subtree:!0})),r=window.setInterval(i,300),o}function yt(){if(typeof navigator>"u")return!1;if(S())return!0;const e=navigator;if(e.userAgentData?.mobile!==void 0)return e.userAgentData.mobile;const t=(navigator.userAgent||"").toLowerCase();return!!(/android|iphone|ipod|windows phone|iemobile|blackberry|opera mini|mobile safari/.test(t)||(navigator.maxTouchPoints??0)>1&&!t.includes("windows")&&!t.includes("macintosh"))}async function le(e,t){const{pgPaymentData:n,paymentMethod:r}=e.params||{};if(!n){console.error("[sirsoft-pay_nhnkcp] pgPaymentData is required");return}const a=r??n.pay_method??"card",o=typeof a=="string"&&a.startsWith("nhnkcp_"),i=window.G7Core;let s=null;try{if(!st(n.currency)){const u=ct(n.currency);i?.state?.setLocal?.({paymentErrorMessage:u,isSubmittingOrder:!1,paymentMethod:a}),i?.modal?.open?.("nhnkcp_payment_error_modal");return}if(M(a)&&!S()){const u=H();i?.state?.setLocal?.({paymentErrorMessage:u,isSubmittingOrder:!1,paymentMethod:a}),i?.modal?.open?.("nhnkcp_payment_error_modal");return}const c=await i.api.get("/modules/sirsoft-ecommerce/payments/client-config/nhnkcp");if(!c.data){console.error("[sirsoft-pay_nhnkcp] Failed to fetch client config",c);return}const d=c.data;s={closeReportUrl:d.callback_urls.close_report,oid:n.order_number,price:Number(n.amount),buyer_email:n.customer_email??"",buyer_phone:n.customer_phone??"",payment_method:a};const l=window.location.origin+d.callback_urls.callback;await at(s),yt()?await ft(i,n,a,o,l):await ht(d,n,a,o,l)}catch(c){if(c instanceof D){s&&await ot(s,c.message||"kcp-window-closed"),i?.state?.setLocal?.({isSubmittingOrder:!1,paymentMethod:a});return}console.error("[sirsoft-pay_nhnkcp] requestPayment error",c);const l=c?.response?.data,u=l?.errors?Object.values(l.errors)[0]?.[0]:void 0,m=l?.error??l?.message??u??(c instanceof Error?c.message:"Unknown error");i?.state?.setLocal?.({paymentErrorMessage:m,isSubmittingOrder:!1,paymentMethod:a}),i?.modal?.open?.("nhnkcp_payment_error_modal")}}async function ft(e,t,n,r,a){const o=await e.api.post("/plugins/sirsoft-pay_nhnkcp/mobile/approval-key",{order_number:t.order_number,amount:t.amount,good_name:t.order_name,pay_method:n,buyr_name:t.customer_name??"",buyr_mail:t.customer_email??"",buyr_tel1:t.customer_phone??"",ret_url:a,currency:B(t.currency)});if(!o.success||!o.data){const d=o.errors,l=d?Object.values(d)[0]?.[0]:void 0;throw new Error(o.error??o.message??l??"KCP 모바일 승인키 획득 실패")}const{pay_url:i,fields:s}=o.data,c=document.createElement("form");c.method="POST",c.action=i,c.acceptCharset="euc-kr",c.style.display="none";for(const[d,l]of Object.entries(s)){const u=document.createElement("input");u.type="hidden",u.name=d,u.value=String(l),c.appendChild(u)}document.body.appendChild(c),c.submit(),await new Promise(()=>{})}async function ht(e,t,n,r,a){const o=r?"100000000000":lt[t.pay_method??"card"]??"100000000000",s={site_cd:n==="nhnkcp_payco"?e.easy_pay_client_id??e.client_id:e.use_escrow&&!r?e.escrow_client_id??e.client_id:e.client_id,ordr_idxx:t.order_number,good_name:t.order_name,good_mny:String(t.amount),buyr_name:t.customer_name??"",buyr_mail:t.customer_email??"",buyr_tel1:t.customer_phone??"",pay_method:o,Ret_URL:a};if(Object.assign(s,dt(t)),Object.assign(s,ut(n,r)),o==="001000000000"&&(s.vcnt_expire_term=String(e.vbank_expire_days??3),s.disp_tax_yn="N"),e.use_escrow&&!r&&(s.escw_used="Y",s.pay_mod="O"),r){s.payco_direct="",s.naverpay_direct="A",s.kakaopay_direct="A",s.applepay_direct="A";const d=de[n];d&&Object.assign(s,d)}const c=Object.entries(s).map(([d,l])=>`<input type="hidden" name="${d}" value="${l.replace(/"/g,"&quot;")}">`).join("");await new Promise((d,l)=>{document.getElementById("kcp-sdk-iframe")?.remove(),document.getElementById("kcp-dim-overlay")?.remove();const u=document.createElement("div");u.id="kcp-dim-overlay",u.style.cssText="position:fixed;top:0;left:0;width:100%;height:100%;background:rgba(0,0,0,0.6);z-index:99998;",document.body.appendChild(u);const m=document.createElement("iframe");m.id="kcp-sdk-iframe",m.setAttribute("allowtransparency","true"),m.style.cssText="position:fixed;top:0;left:0;width:100%;height:100%;border:0;z-index:99999;background:transparent;",document.body.appendChild(m);const y=m.contentWindow;let x=!1,h,f;const se=()=>{f?.(),f=void 0,h!==void 0&&(clearTimeout(h),h=void 0),m.remove(),u.remove()},v=_=>{x||(x=!0,se(),l(_))},w=()=>{x=!0,f?.(),f=void 0,h!==void 0&&(clearTimeout(h),h=void 0)};f=mt(m,()=>{v(new D("kcp-payment-frame-closed"))}),y.m_Completepayment=function(_){const E=_.elements.res_cd?.value??"",p=_.elements.res_msg?.value??"";if(E==="0000"){w();const g=y.document.forms.namedItem("order_info"),k=g&&g!==_?g:_;if(g&&g!==_)for(let I=0;I<_.elements.length;I++){const L=_.elements[I];if(!L.name)continue;let A=g.elements.namedItem(L.name);A||(A=y.document.createElement("input"),A.type="hidden",A.name=L.name,g.appendChild(A)),A.value=L.value}k.action=a,k.method="POST",k.target="_top",y.document.body.appendChild(k),k.submit()}else{const g=E===""||E==="7777"||p.includes("취소");v(g?new D(p):new Error(`KCP 오류 [${E}]: ${p}`))}},y.__kcpFail=_=>{v(_)};const C=m.contentDocument||y.document;C.open(),C.write(`<!DOCTYPE html><html><head>
+<script src="${e.sdk_url}"><\/script>
+</head><body style="margin:0;padding:0;background:transparent;">
+<form name="order_info">${c}</form>
+<script>
+try {
+  if (typeof KCP_Pay_Execute === 'function') {
+    KCP_Pay_Execute(document.forms['order_info']);
+    window.__kcpReady && window.__kcpReady();
+  } else {
+    window.__kcpFail && window.__kcpFail(new Error('KCP_Pay_Execute not defined'));
+  }
+} catch(e) {
+  window.__kcpFail && window.__kcpFail(e);
+}
+<\/script>
+</body></html>`),C.close(),h=window.setTimeout(()=>{v(new Error("KCP SDK load timeout"))},15e3),y.__kcpReady=()=>{h!==void 0&&(clearTimeout(h),h=void 0)}})}const _t={nhnkcp_payco:"PAYCO",nhnkcp_naverpay:"네이버페이",nhnkcp_naverpay_point:"네이버페이 포인트",nhnkcp_kakaopay:"카카오페이",nhnkcp_applepay:"Apple Pay"},gt="0 0 0 2px #ffffff, 0 0 0 5px rgba(0,0,0,0.55)";function ue(){return document.querySelector(".nhnkcp-easy-pay-btns")??null}function pe(){const e=ue();e&&e.querySelectorAll("button").forEach(t=>{t.style.boxShadow="",t.style.outline=""})}function wt(e){const t=ue();if(!t)return;const n=_t[e];t.querySelectorAll("button").forEach(r=>{r.textContent?.trim()===n?(r.style.boxShadow=gt,r.style.outline="none"):(r.style.boxShadow="",r.style.outline="")})}function Pt(e){const t=e.params?.paymentMethod;if(!t)return;const n=window.G7Core;if(M(t)&&!S()){const a=H();n?.state?.setLocal?.({paymentErrorMessage:a,isSubmittingOrder:!1}),n?.modal?.open?.("nhnkcp_payment_error_modal"),pe();return}const r=typeof t=="string"&&t.startsWith("nhnkcp_");n?.state?.setLocal?.({paymentMethod:t,serverPaymentMethod:r?"card":t}),r?wt(t):pe()}function kt(e){const t=document.createElement("textarea");t.value=e,t.setAttribute("readonly","readonly"),t.style.position="fixed",t.style.left="-9999px",t.style.top="0",document.body.appendChild(t),t.select();try{document.execCommand("copy")}finally{t.remove()}}async function bt(e){const t=String(e.params?.text??"");if(t!==""){if(navigator.clipboard&&typeof navigator.clipboard.writeText=="function"){await navigator.clipboard.writeText(t);return}kt(t)}}const me={requestPayment:le,setPaymentMethod:Pt,copyToClipboard:bt},ye="/api/modules/sirsoft-ecommerce/user/orders",Ct="sirsoft-nhnkcp",j="sirsoft-pay_nhnkcp",fe="nhnkcp_",b={info:(...e)=>console.info(`[${j}]`,...e),warn:(...e)=>console.warn(`[${j}]`,...e),error:(...e)=>console.error(`[${j}]`,...e)};function Nt(e){return typeof e=="string"?e:e instanceof URL?e.toString():typeof Request<"u"&&e instanceof Request?e.url:String(e)}function xt(e,t){return t?.method?t.method.toUpperCase():typeof Request<"u"&&e instanceof Request?e.method.toUpperCase():"GET"}function vt(e,t){if(t!=="POST")return!1;const n=e.split("?")[0].split("#")[0];return n===ye||n.endsWith(ye)}function Et(){return window.location.pathname+window.location.search+window.location.hash}function At(e,t){const n=JSON.stringify(t);return new Response(n,{status:e.status,statusText:e.statusText,headers:e.headers})}function St(e){return new Response(JSON.stringify({success:!1,message:e,error:e,errors:{payment_method:[e]}}),{status:422,statusText:"Unprocessable Content",headers:{"Content-Type":"application/json"}})}function he(e){try{return JSON.parse(e).payment_method}catch{return}}function Kt(e,t){try{const n=JSON.parse(e);return n.payment_method=t,JSON.stringify(n)}catch{return e}}function It(){if(typeof window>"u"||typeof window.fetch!="function")return;const e="__sirsoftNhnkcpInterceptorInstalled",t=window;if(t[e])return;t[e]=!0;const n="__sirsoftPgOriginalFetch";t[n]||(t[n]=window.fetch.bind(window));const r=t[n],a=window.fetch.bind(window);window.fetch=async function(i,s){const c=Nt(i),d=xt(i,s);if(!vt(c,d))return a(i,s);let l,u=s;if(s?.body&&typeof s.body=="string"){const p=he(s.body);typeof p=="string"&&p.startsWith(fe)&&(l=p,u={...s,body:Kt(s.body,"card")},b.info(`easy pay detected: replacing payment_method '${p}' → 'card'`))}if(!l)try{const p=window.G7Core?.state?.getLocal?.()?.paymentMethod;typeof p=="string"&&p.startsWith(fe)&&(l=p,b.info(`easy pay detected from local state: '${p}'`))}catch{}if(M(l)&&!S()){const p=H();return b.warn(p),St(p)}const y=await(l?r:a)(i,u);let x;try{x=y.clone()}catch{return y}let h=null;try{h=await x.json()}catch{return y}const f=h?.data;if(!f)return y;const se=f.requires_pg_payment===!0,v=f.pg_provider===Ct;if(!l&&(!se||!v)||l&&!f.order&&!f.pg_payment_data)return y;let w=f.pg_payment_data;if(!w&&l&&f.order){const p=f.order,g=p.options,k=g?.[0]?.product_name??String(p.order_number??""),I=(g?.length??0)>1?`${k} 외 ${(g?.length??0)-1}건`:k;w={order_number:p.order_number,order_name:I,amount:Math.floor(Number(p.total_due_amount??p.total_amount??0)),currency:"KRW",customer_name:p.orderer_name??null,customer_email:p.orderer_email??null,customer_phone:String(p.orderer_phone??"").replace(/[^0-9]/g,"")},b.info("pg_payment_data constructed from order (기본 PG가 타 PG)",{order_number:w.order_number,amount:w.amount})}if(!w)return b.warn("nhnkcp order detected but pg_payment_data missing"),y;b.info("intercepted order create response — opening PG popup");const C=f.order?{tax_amount:f.order.total_tax_amount??0,vat_amount:f.order.total_vat_amount??0,tax_free_amount:f.order.total_tax_free_amount??0}:{},_=!l&&u?.body&&typeof u.body=="string"?(()=>{const p=he(u.body);return p?{...w,pay_method:p,...C}:{...w,...C}})():{...w,...C};le({params:{pgPaymentData:_,paymentMethod:l}});const E={...h,data:{...f,requires_pg_payment:!1,redirect_url:Et()}};return At(y,E)},b.info("order response interceptor installed")}const Y="sirsoft-pay_nhnkcp",_e="__kcpOcReceiptInjectorInstalled",ge="kcp-oc-receipt-btn",Mt=/^\/shop\/orders\/([^/]+)\/complete$/;function we(){return localStorage.getItem("auth_token")}async function Tt(e){const t=we();if(!t)return null;try{const n=await fetch(`/api/modules/sirsoft-ecommerce/user/orders/${e}`,{headers:{Authorization:`Bearer ${t}`,Accept:"application/json"}});return n.ok?(await n.json())?.data?.payment??null:null}catch{return null}}async function q(e){const t=we();if(!t)return null;try{const n=await fetch(`/api/plugins/${Y}/user/orders/${e}/receipt`,{headers:{Authorization:`Bearer ${t}`,Accept:"application/json"}});return n.ok?await n.json():null}catch{return null}}function Pe(e,t,n){const r=document.createElement("button");return r.type="button",r.className=t,r.textContent=e,r.addEventListener("click",()=>n(r)),r}function $t(e){if(!e)return!1;const t=Array.from(document.querySelectorAll("div"));for(const n of t){const r=Array.from(n.children).filter(i=>i instanceof HTMLElement&&i.tagName==="SPAN");if(r.length<2)continue;const a=r[0].textContent?.trim();if(a!=="결제 방법"&&a!=="결제수단"&&a!=="결제 방식")continue;const o=r[r.length-1];return o.textContent?.trim()===e?(n.dataset.nhnkcpPaymentMethodRow="true",!0):(o.textContent=e,o.dataset.nhnkcpPaymentMethodPatched="true",n.dataset.nhnkcpPaymentMethodRow="true",!0)}return!1}async function Rt(e){if(document.getElementById(ge))return;const t=await Tt(e);if(!t||t.pg_provider!=="nhnkcp"||!t.transaction_id||!t.paid_at)return;const n=Array.from(document.querySelectorAll('button[type="button"]')).find(c=>c.className.includes("bg-blue-600"));if(!n?.parentElement)return;const r=await q(e);$t(r?.payment_method_display_label);const a=n.parentElement,o=Pe("영수증 조회",n.className.replace(/bg-blue-\d+/g,"bg-green-600").replace(/hover:bg-blue-\d+/g,"hover:bg-green-700"),async c=>{c.disabled=!0,c.textContent="로딩 중...";const d=await q(e);if(c.disabled=!1,c.textContent="영수증 조회",d){const l=window.KcpReceiptPopup;l&&new l({url:d.receipt_url??void 0})}});o.id=ge;const i=a.lastElementChild;a.insertBefore(o,i);const s="kcp-oc-cash-receipt-btn";if(!document.getElementById(s)&&(t.payment_method==="vbank"||t.payment_method==="bank_transfer")){const c=Pe("현금영수증 조회",o.className.replace(/bg-green-\d+/g,"bg-teal-600").replace(/hover:bg-green-\d+/g,"hover:bg-teal-700"),async d=>{d.disabled=!0,d.textContent="로딩 중...";const l=await q(e);if(d.disabled=!1,d.textContent="현금영수증 조회",l){const u=window.KcpReceiptPopup;u&&new u({cash_url:l.cash_receipt_url??void 0})}});c.id=s,a.insertBefore(c,i)}console.info(`[${Y}] receipt button injected on order complete page`)}function Ot(){const t=location.pathname.match(Mt);t&&Rt(t[1])}function Lt(){if(typeof window>"u")return;const e=window;if(e[_e])return;e[_e]=!0,console.info(`[${Y}] order complete receipt injector installed`);const t=(r=1200)=>setTimeout(Ot,r);document.readyState==="loading"?document.addEventListener("DOMContentLoaded",()=>t()):t();const n=history.pushState.bind(history);history.pushState=(...r)=>{n(...r),t()},window.addEventListener("popstate",()=>t(500))}const P="sirsoft-pay_nhnkcp",ke="__kcpMpShowInjectorInstalled",F="kcp-mp-vbank-row",G="kcp-mp-receipt-row",T="kcp-mp-mock-deposit",Ht=/^\/mypage\/orders\/([^/]+)$/;function Bt(e){try{const n=window.G7Core?.getState,o=n?.()?.currentDataContext?.order?.data;return!o||o.order_number!==e?null:o}catch{return null}}function be(){return localStorage.getItem("auth_token")}async function Ce(e){const t=be();if(!t)return null;try{const n=await fetch(`/api/plugins/${P}/user/orders/${e}/receipt`,{headers:{Authorization:`Bearer ${t}`,Accept:"application/json"}});return n.ok?await n.json():null}catch{return null}}async function Ne(e){const t=be();if(!t)return null;try{const n=await fetch(`/api/plugins/${P}/user/orders/${e}/vbank-mock-deposit-info`,{headers:{Authorization:`Bearer ${t}`,Accept:"application/json"}});return n.ok?await n.json():null}catch{return null}}function xe(e){const t=document.createElement("div");t.id=T,t.className="pt-4 mt-2 border-t border-dashed border-orange-300 dark:border-orange-700";const n=document.createElement("div");n.className="flex items-center gap-2 mb-3";const r=document.createElement("span");r.className="inline-flex items-center px-2 py-0.5 rounded text-xs font-bold bg-orange-100 text-orange-700 dark:bg-orange-900/40 dark:text-orange-300 border border-orange-300 dark:border-orange-700",r.textContent="TEST";const a=document.createElement("p");a.className="text-sm font-semibold text-orange-700 dark:text-orange-300",a.textContent="모의입금처리",n.appendChild(r),n.appendChild(a);const o=document.createElement("form");o.method="POST",o.action=e.mock_url??"",o.target="_blank",o.className="space-y-2";const i=[{label:"KCP 거래번호",name:"e_trade_no",value:e.trade_no??""},{label:"입금계좌",name:"deposit_no",value:e.account_no??""},{label:"입금자명",name:"req_name",value:"NHN KCP",editable:!0},{label:"입금통보 URL",name:"noti_url",value:e.notify_url??""}];for(const d of i){const l=document.createElement("div");l.className="flex items-center gap-2 text-sm";const u=document.createElement("span");u.className="w-28 flex-shrink-0 text-gray-500 dark:text-gray-400 text-xs",u.textContent=d.label;const m=document.createElement("input");m.type="text",m.name=d.name,m.value=d.value,m.readOnly=!d.editable,m.className=d.editable?"flex-1 px-2 py-1 text-xs border border-gray-300 dark:border-gray-600 rounded bg-white dark:bg-gray-700 text-gray-900 dark:text-white font-mono":"flex-1 px-2 py-1 text-xs border border-gray-200 dark:border-gray-700 rounded bg-gray-50 dark:bg-gray-800 text-gray-700 dark:text-gray-300 font-mono",l.appendChild(u),l.appendChild(m),o.appendChild(l)}const s=document.createElement("div");s.className="pt-1";const c=document.createElement("button");if(c.type="submit",c.className="w-full py-1.5 text-xs font-semibold rounded border border-orange-400 dark:border-orange-600 bg-orange-50 dark:bg-orange-900/30 text-orange-700 dark:text-orange-300 hover:bg-orange-100 dark:hover:bg-orange-900/50 transition-colors",c.textContent="입금통보 테스트",s.appendChild(c),o.appendChild(s),t.appendChild(n),t.appendChild(o),e.is_admin_view){const d=document.createElement("p");d.className="mt-2 text-xs text-center text-orange-500 dark:text-orange-400 font-medium",d.textContent="관리자에게만 출력되는 내용",t.appendChild(d)}return t}function ve(){const e=document.getElementById("order_payment_info_panel");if(e)return Array.from(e.children).find(o=>o.className?.includes("space-y"))??e;const t=Array.from(document.querySelectorAll("h3")).find(a=>a.textContent?.includes("결제 정보"));if(!t)return null;const n=t.parentElement?.parentElement;return n?Array.from(n.children).find(a=>a.className?.includes("space-y"))??n:null}function K(e,t,n="font-medium text-gray-900 dark:text-white"){const r=document.createElement("div");r.className="flex items-center justify-between text-sm";const a=document.createElement("span");a.className="text-gray-500 dark:text-gray-400",a.textContent=e;const o=document.createElement("span");return o.className=n,o.textContent=t,r.appendChild(a),r.appendChild(o),r}function Dt(e,t){if(!t)return!1;const n=Array.from(e.querySelectorAll("div"));for(const r of n){const a=Array.from(r.children).filter(s=>s instanceof HTMLElement&&s.tagName==="SPAN");if(a.length<2)continue;const o=a[0].textContent?.trim();if(o!=="결제 방법"&&o!=="결제수단"&&o!=="Payment Method")continue;const i=a[a.length-1];return i.textContent?.trim()===t?(r.dataset.nhnkcpPaymentMethodRow="true",!0):(i.textContent=t,i.dataset.nhnkcpPaymentMethodPatched="true",r.dataset.nhnkcpPaymentMethodRow="true",!0)}return!1}function jt(e,t){const n=document.createElement("div");n.id=F,n.className="pt-4 mt-2 border-t border-gray-200 dark:border-gray-700 space-y-3";const r=document.createElement("p");r.className="text-sm font-semibold text-gray-800 dark:text-gray-200",r.textContent="가상계좌 입금 안내";const a=document.createElement("div");a.className="space-y-1.5",a.appendChild(K("은행",e.vbank_name??"")),a.appendChild(K("계좌번호",e.vbank_number??"","font-medium text-gray-900 dark:text-white font-mono tracking-wide")),a.appendChild(K("예금주",e.vbank_holder??"")),a.appendChild(K("입금 금액",t)),e.due_date_formatted&&a.appendChild(K("입금 기한",e.due_date_formatted));const o=document.createElement("p");return o.className="text-xs text-amber-600 dark:text-amber-400",o.textContent="입금 기한 내에 입금하지 않으시면 주문이 자동 취소됩니다.",n.appendChild(r),n.appendChild(a),n.appendChild(o),n}function Yt(e){const t=document.createElement("div");t.id=G,t.className="pt-4 mt-2 border-t border-gray-200 dark:border-gray-700";const n=document.createElement("div");n.className="flex items-center justify-between";const r=document.createElement("span");r.className="text-gray-500 dark:text-gray-400 text-sm",r.textContent="영수증";const a=document.createElement("button");return a.type="button",a.className="inline-flex items-center gap-1 text-sm text-blue-600 dark:text-blue-400 hover:underline disabled:opacity-50",a.textContent="영수증 조회",a.addEventListener("click",async()=>{a.disabled=!0,a.textContent="로딩 중...";const o=await Ce(e);if(a.disabled=!1,a.textContent="영수증 조회",o){const i=window.KcpReceiptPopup;i&&new i({url:o.receipt_url,cash_url:o.cash_receipt_url})}}),n.appendChild(r),n.appendChild(a),t.appendChild(n),t}async function qt(e){const t=Bt(e);if(!t){if(!document.getElementById(T)){const m=ve();if(!m)return!1;const y=await Ne(e);y?.available&&(m.appendChild(xe(y)),console.info(`[${P}] mock deposit form injected on mypage order show`))}return!0}const{payment:n}=t;if(!n||n.pg_provider!=="nhnkcp")return!0;const r=n.payment_method==="vbank"&&!!n.vbank_name,a=!!n.transaction_id&&!!n.paid_at,o=n.payment_method==="vbank"&&!!n.vbank_number,i=!r||!!document.getElementById(F),s=!a||!!document.getElementById(G),c=!o||!!document.getElementById(T);if(i&&s&&c)return!0;const d=ve();if(!d)return!1;const l=a?await Ce(e):null,u=Dt(d,l?.payment_method_display_label);if(!document.getElementById(F)&&r)return d.appendChild(jt(n,t.total_amount_formatted??"")),console.info(`[${P}] vbank info injected on mypage order show`),!1;if(!document.getElementById(G)&&a)return d.appendChild(Yt(e)),console.info(`[${P}] receipt button injected on mypage order show`),!1;if(u&&console.info(`[${P}] payment method display patched on mypage order show`),!document.getElementById(T)&&o){const m=await Ne(e);if(m?.available)d.appendChild(xe(m)),console.info(`[${P}] mock deposit form injected on mypage order show`);else return!0}return!0}function Ft(e){let t=0;const n=setInterval(()=>{t++,qt(e).then(r=>{(r||t>=30)&&clearInterval(n)})},400)}function Gt(){const e=location.pathname.match(Ht);e&&Ft(e[1])}function Wt(){if(typeof window>"u")return;const e=window;if(e[ke])return;e[ke]=!0,console.info(`[${P}] mypage order show injector installed`);const t=(r=1500)=>setTimeout(Gt,r);document.readyState==="loading"?document.addEventListener("DOMContentLoaded",()=>t()):t();const n=history.pushState.bind(history);history.pushState=(...r)=>{n(...r),t(600)},window.addEventListener("popstate",()=>t(500))}const Ut="sirsoft-pay_nhnkcp",Ee="__kcpCheckoutEasyPayInjectorInstalled",zt=/^\/shop\/checkout\/?$/,Ae="__kcpCheckoutEasyPaySyncListenerAttached",Vt=200,Jt=120,Se=[{id:"nhnkcp_payco",configKey:"PAYCO",labels:["PAYCO (NHN KCP)","PAYCO NHN KCP 간편결제","PAYCO로 결제 (NHN KCP)","Pay with PAYCO (NHN KCP)"],ko:{heading:"PAYCO",description:"PAYCO로 결제 (NHN KCP)",title:"PAYCO로 결제 (NHN KCP)"},en:{heading:"PAYCO",description:"Pay with PAYCO (NHN KCP)",title:"Pay with PAYCO (NHN KCP)"},markText:"P",markClassName:"bg-red-500 text-white"},{id:"nhnkcp_naverpay",configKey:"NAVERPAY",labels:["네이버페이 (NHN KCP)","네이버페이 신용카드로 결제 (NHN KCP)","NaverPay NHN KCP 간편결제","Naver Pay (NHN KCP)","NaverPay (NHN KCP)","Pay by Naver Pay credit card (NHN KCP)"],ko:{heading:"네이버페이 (카드)",description:"네이버페이 신용카드로 결제 (NHN KCP)",title:"네이버페이 신용카드로 결제 (NHN KCP)"},en:{heading:"Naver Pay (Card)",description:"Pay by Naver Pay credit card (NHN KCP)",title:"Pay by Naver Pay credit card (NHN KCP)"},markText:"N",markClassName:"bg-green-500 text-white"},{id:"nhnkcp_naverpay_point",configKey:"NAVERPAY POINT",labels:["네이버페이 포인트 (NHN KCP)","네이버페이 머니/포인트로 결제 (NHN KCP)","NaverPay 포인트 NHN KCP 포인트 간편결제","Naver Pay Point (NHN KCP)","NaverPay Point (NHN KCP)","Pay with Naver Pay Money/Points (NHN KCP)"],ko:{heading:"네이버페이 (포인트)",description:"네이버페이 머니/포인트로 결제 (NHN KCP)",title:"네이버페이 머니/포인트로 결제 (NHN KCP)"},en:{heading:"Naver Pay (Point)",description:"Pay with Naver Pay Money/Points (NHN KCP)",title:"Pay with Naver Pay Money/Points (NHN KCP)"},markText:"NP",markClassName:"bg-green-600 text-white"},{id:"nhnkcp_kakaopay",configKey:"KAKAOPAY",labels:["카카오페이 (NHN KCP)","카카오페이로 결제 (NHN KCP)","KakaoPay NHN KCP 간편결제","Kakao Pay (NHN KCP)","KakaoPay (NHN KCP)","Pay with Kakao Pay (NHN KCP)"],ko:{heading:"카카오페이",description:"카카오페이로 결제 (NHN KCP)",title:"카카오페이로 결제 (NHN KCP)"},en:{heading:"Kakao Pay",description:"Pay with Kakao Pay (NHN KCP)",title:"Pay with Kakao Pay (NHN KCP)"},markText:"K",markClassName:"bg-yellow-400 text-gray-950"},{id:"nhnkcp_applepay",configKey:"APPLEPAY",labels:["애플페이 (NHN KCP)","애플페이로 결제 (NHN KCP)","Apple Pay NHN KCP 간편결제","Apple Pay (NHN KCP)","Pay with Apple Pay (NHN KCP)"],ko:{heading:"애플페이",description:"애플페이로 결제 (NHN KCP)",title:"애플페이로 결제 (NHN KCP)"},en:{heading:"Apple Pay",description:"Pay with Apple Pay (NHN KCP)",title:"Pay with Apple Pay (NHN KCP)"},markText:"A",markClassName:"bg-gray-900 text-white"}];let Ke=null,$=null,W=!1;function Qt(){return window}function U(){return zt.test(window.location.pathname)}function Xt(e){return(e??"").replace(/\s+/g," ").trim()}function Zt(){return(document.documentElement.lang||navigator.language||"").toLowerCase().startsWith("ko")}function en(e){return Zt()?e.ko:e.en}function Ie(e){return e.replaceAll("네이버페이","네이​버페이").replaceAll("카카오페이","카카​오페이").replaceAll("Naver Pay","Naver​ Pay").replaceAll("Kakao Pay","Kakao​ Pay")}function Me(e){return Se.find(t=>t.id===e)??null}function tn(e){const t=Me(e.dataset.nhnkcpEasyPayMethod);if(t)return t;const n=Xt(e.textContent);return Se.find(r=>r.labels.some(a=>n.includes(a)))??null}function Te(e){return e.querySelector(".flex.items-center.gap-2, .flex.items-center.gap-3")??e.querySelector(".flex.items-center")}function nn(e,t,n){e.style.textAlign="left";const r=Te(e);r&&(r.style.justifyContent="flex-start",r.style.textAlign="left",r.style.width="100%");const a=t?.parentElement??n?.parentElement;a instanceof HTMLElement&&(a.style.textAlign="left",a.style.minWidth="0")}function rn(e){const t=document.createElement("span");return t.dataset.nhnkcpEasyPayMark="true",t.dataset.nhnkcpEasyPayMethod=e.id,t.setAttribute("aria-hidden","true"),t.className=`inline-flex items-center justify-center rounded-lg text-xs font-bold ${e.markClassName}`,t.style.width="32px",t.style.height="32px",t.style.flex="0 0 32px",t.textContent=e.markText,t}function an(e){delete e.dataset.kginicisBrandPaymentButton,delete e.dataset.kginicisBrandPaymentMethod,delete e.dataset.kginicisNaverpayBrandButton,e.querySelectorAll('[data-kginicis-brand-payment-mark="true"], [data-kginicis-naverpay-mark="true"]').forEach(t=>{t.remove()}),e.querySelectorAll("[data-kginicis-brand-payment-heading], [data-kginicis-brand-payment-description], [data-kginicis-naverpay-heading], [data-kginicis-naverpay-description]").forEach(t=>{delete t.dataset.kginicisBrandPaymentHeading,delete t.dataset.kginicisBrandPaymentDescription,delete t.dataset.kginicisNaverpayHeading,delete t.dataset.kginicisNaverpayDescription})}function on(e){return e.querySelector('[data-kginicis-brand-payment-mark="true"], [data-kginicis-naverpay-mark="true"]')??e.querySelector('[data-nhnkcp-easy-pay-mark="true"]')??e.querySelector("svg")??e.querySelector('i[class*="fa-"], i[role="img"], i')}function sn(e,t){const n=e.querySelector('[data-nhnkcp-easy-pay-mark="true"]');if(n){n.dataset.nhnkcpEasyPayMethod=t.id,n.className=`inline-flex items-center justify-center rounded-lg text-xs font-bold ${t.markClassName}`,n.textContent=t.markText;return}const r=rn(t),a=on(e);if(a&&a.parentElement){a.replaceWith(r);return}Te(e)?.prepend(r)}function cn(e,t){const n=Array.from(e.querySelectorAll("p")),r=en(t),a=Ie(r.heading),o=Ie(r.description),i=n[0],s=n[1];i&&i.textContent!==a&&(i.textContent=a),i&&(i.setAttribute("aria-label",r.heading),i.style.textAlign="left",i.style.whiteSpace="normal",i.style.wordBreak="keep-all",i.style.overflowWrap="anywhere"),s&&s.textContent!==o&&(s.textContent=o),s&&(s.style.textAlign="left",s.style.fontSize="12px",s.style.lineHeight="1rem",s.style.whiteSpace="normal",s.style.wordBreak="keep-all",s.style.overflowWrap="anywhere"),nn(e,i,s),e.title=r.title}function $e(e,t){if(M(t.id)&&!S()){e.hidden=!0,e.disabled=!0,e.style.display="none",e.setAttribute("aria-hidden","true"),e.dataset.nhnkcpEasyPayMethod=t.id,e.dataset.nhnkcpEasyPayHidden="true",delete e.dataset.nhnkcpEasyPayVisible;return}e.hidden&&(e.hidden=!1),e.disabled&&(e.disabled=!1),e.style.display==="none"&&e.style.removeProperty("display"),e.removeAttribute("aria-hidden"),e.dataset.nhnkcpEasyPayMethod=t.id,e.dataset.nhnkcpEasyPayVisible="true",delete e.dataset.nhnkcpEasyPayHidden,an(e),sn(e,t),cn(e,t)}function dn(e){const t={kginicis_naverpay:["nhnkcp_naverpay","nhnkcp_naverpay_point"],kginicis_kakaopay:["nhnkcp_kakaopay"]};let n=!1;return Object.entries(t).forEach(([r,a])=>{Array.from(e.querySelectorAll(`button[data-kginicis-brand-payment-method="${r}"]`)).filter(i=>!i.dataset.nhnkcpEasyPayMethod).slice(1).forEach((i,s)=>{const c=Me(a[s]);c&&($e(i,c),n=!0)})}),n}async function z(e=document){if(typeof window>"u"||typeof document>"u"||!U())return!1;let t=!1;return e.querySelectorAll("button").forEach(n=>{const r=tn(n);r&&($e(n,r),t=!0)}),dn(e)&&(t=!0),t}function ln(){W||(W=!0,window.setTimeout(()=>{W=!1,z()},0))}function Re(){$!==null&&(window.clearInterval($),$=null)}function V(){if(!U())return;Re(),z();let e=0;$=window.setInterval(()=>{e+=1,z(),e>=Jt&&Re()},Vt);const t=document.body;t[Ae]||(t[Ae]=!0,Ke=new MutationObserver(()=>ln()),Ke.observe(document.body,{childList:!0,subtree:!0,characterData:!0}))}function Oe(){U()&&V()}function un(){if(typeof window>"u"||typeof document>"u")return;const e=Qt();if(e[Ee])return;e[Ee]=!0,console.info(`[${Ut}] checkout easy pay method sync installed`),document.readyState==="loading"?document.addEventListener("DOMContentLoaded",()=>V()):V();const t=history.pushState.bind(history);history.pushState=(...n)=>{t(...n),window.setTimeout(()=>Oe(),200)},window.addEventListener("popstate",()=>window.setTimeout(()=>Oe(),200))}const pn="sirsoft-pay_nhnkcp",Le="__kcpAdminApplePayNoticeInjectorInstalled",mn=/^\/admin\/ecommerce\/settings\/?$/,He="__kcpAdminApplePayNoticeListenerAttached",yn="애플페이는 IOS 기기에 모바일결제만 가능합니다.",fn="Apple Pay is available only for mobile payments on iOS devices.";let Be=null,R=null,J=!1;function hn(){return window}function Q(){if(!mn.test(window.location.pathname))return!1;const e=new URLSearchParams(window.location.search).get("tab");return e===null||e==="order_settings"}function De(){return(document.documentElement.lang||navigator.language||"").toLowerCase().startsWith("ko")?yn:fn}function je(e){return(e??"").replace(/\s+/g," ").trim()}function _n(e){const t=je(e.textContent);return t==="애플페이"||t==="Apple Pay"}function gn(){const e=document.createElement("span");return e.dataset.nhnkcpAdminApplePayNotice="true",e.className="text-label-subtle",e.style.display="block",e.style.width="100%",e.style.flexBasis="100%",e.style.marginTop="2px",e.style.fontSize="12px",e.style.lineHeight="1rem",e.textContent=De(),e}function X(e=document){if(typeof window>"u"||typeof document>"u"||!Q()||je(document.body?.innerText??document.body?.textContent).includes(De()))return!1;const n=Array.from(e.querySelectorAll("span, p, div")).find(_n);return n?(n.insertAdjacentElement("afterend",gn()),!0):!1}function wn(){J||(J=!0,window.setTimeout(()=>{J=!1,X()},0))}function Ye(){R!==null&&(window.clearInterval(R),R=null)}function Z(){if(!Q())return;Ye(),X();let e=0;R=window.setInterval(()=>{e+=1,(X()||e>=50)&&Ye()},200);const t=document.body;t[He]||(t[He]=!0,Be=new MutationObserver(()=>wn()),Be.observe(document.body,{childList:!0,subtree:!0,characterData:!0}))}function qe(){Q()&&Z()}function Pn(){if(typeof window>"u"||typeof document>"u")return;const e=hn();if(e[Le])return;e[Le]=!0,console.info(`[${pn}] admin Apple Pay notice injector installed`),document.readyState==="loading"?document.addEventListener("DOMContentLoaded",()=>Z()):Z();const t=history.pushState.bind(history);history.pushState=(...n)=>{t(...n),window.setTimeout(()=>qe(),200)},window.addEventListener("popstate",()=>window.setTimeout(()=>qe(),200))}const kn="sirsoft-pay_nhnkcp",Fe="__nhnkcpAdminPaymentMethodBrandInjectorInstalled",Ge="__nhnkcpAdminPaymentMethodBrandSyncListenerAttached",bn=/^\/admin\/ecommerce\/settings\/?$/,We='[data-nhnkcp-admin-payment-brand-mark="true"]',Cn=200,Nn=120,xn=[{id:"nhnkcp_payco",labels:["PAYCO (NHN KCP)","PAYCO로 결제 (NHN KCP)","Pay with PAYCO (NHN KCP)"],shortLabels:["PAYCO"],markLines:["P"],markClassName:"bg-red-500 text-white"},{id:"nhnkcp_naverpay",labels:["네이버페이 (NHN KCP)","네이버페이 신용카드로 결제 (NHN KCP)","Naver Pay (NHN KCP)","Pay by Naver Pay credit card (NHN KCP)"],shortLabels:["네이버페이 (카드)","Naver Pay (Card)"],markLines:["N"],markClassName:"bg-green-500 text-white"},{id:"nhnkcp_naverpay_point",labels:["네이버페이 포인트 (NHN KCP)","네이버페이 머니/포인트로 결제 (NHN KCP)","Naver Pay Point (NHN KCP)","Pay with Naver Pay Money/Points (NHN KCP)"],shortLabels:["네이버페이 (포인트)","Naver Pay (Point)"],markLines:["NP"],markClassName:"bg-green-600 text-white"},{id:"nhnkcp_kakaopay",labels:["카카오페이 (NHN KCP)","카카오페이로 결제 (NHN KCP)","Kakao Pay (NHN KCP)","Pay with Kakao Pay (NHN KCP)"],shortLabels:["카카오페이","Kakao Pay"],markLines:["K"],markClassName:"bg-yellow-400 text-gray-950"},{id:"nhnkcp_applepay",labels:["애플페이 (NHN KCP)","애플페이로 결제 (NHN KCP)","Apple Pay (NHN KCP)","Pay with Apple Pay (NHN KCP)"],shortLabels:["애플페이","Apple Pay"],markLines:["A"],markClassName:"bg-gray-900 text-white"}];let Ue=null,O=null,ee=!1;function vn(){return window}function te(){if(!bn.test(window.location.pathname))return!1;const e=new URLSearchParams(window.location.search).get("tab");return e===null||e===""||e==="order_settings"}function En(e){return e instanceof HTMLElement?e.className:""}function ze(e){return(e??"").replace(/\u200B/g,"").replace(/\s+/g," ").trim()}function An(e){const t=En(e);return t.includes("excel-card")||t.includes("flex-center")&&t.includes("border")&&t.includes("gap-4")}function Ve(e){return e.querySelector(".font-medium")}function Sn(e){const t=ze(Ve(e)?.textContent),n=ze(e.textContent);return xn.find(r=>r.shortLabels.some(a=>t===a)||r.labels.some(a=>n.includes(a)))??null}function Kn(e){return Array.from(e.querySelectorAll("div")).filter(An)}function In(e){return Array.from(e.querySelectorAll("svg, [data-icon], i")).find(n=>!n.closest("[data-drag-handle]")&&!n.closest(We)&&!n.closest('.row-stack, .excel-card-body, button, select, [role="switch"]'))??null}function Je(e,t){e.dataset.nhnkcpAdminPaymentBrandMark="true",e.dataset.nhnkcpAdminPaymentMethod=t.id,e.setAttribute("aria-hidden","true"),e.className=`inline-flex items-center justify-center rounded-lg font-bold ${t.markClassName}`,e.style.width="32px",e.style.height="32px",e.style.flex="0 0 32px",e.style.lineHeight="1",e.style.fontSize=t.markLines.join("").length>2?"9px":"12px";const n=t.markLines.join("");e.textContent!==n&&(e.replaceChildren(),t.markLines.length>1?(e.style.flexDirection="column",t.markLines.forEach(r=>{const a=document.createElement("span");a.style.lineHeight="1",a.textContent=r,e.appendChild(a)})):(e.style.removeProperty("flex-direction"),e.textContent=t.markLines[0]??""))}function Mn(e){const t=document.createElement("span");return Je(t,e),t}function Tn(e,t){const n=e.querySelector(We);if(n instanceof HTMLSpanElement)return e.dataset.nhnkcpAdminPaymentMethod=t.id,Je(n,t),!0;const r=Mn(t),a=In(e);if(a&&a.parentElement)return e.dataset.nhnkcpAdminPaymentMethod=t.id,a.replaceWith(r),!0;const o=Ve(e);return o&&o.parentElement?(e.dataset.nhnkcpAdminPaymentMethod=t.id,o.parentElement.insertBefore(r,o),!0):!1}function ne(e=document){if(typeof window>"u"||typeof document>"u"||!te())return!1;let t=!1;return Kn(e).forEach(n=>{const r=Sn(n);r&&Tn(n,r)&&(t=!0)}),t}function $n(){ee||(ee=!0,window.setTimeout(()=>{ee=!1,ne()},0))}function re(){O!==null&&(window.clearInterval(O),O=null)}function ae(){if(!te())return;re(),ne();let e=0;O=window.setInterval(()=>{e+=1,ne(),e>=Nn&&re()},Cn);const t=document.body;t[Ge]||(t[Ge]=!0,Ue=new MutationObserver(()=>$n()),Ue.observe(document.body,{childList:!0,subtree:!0,characterData:!0}))}function Qe(){if(te()){ae();return}re()}function Rn(){if(typeof window>"u"||typeof document>"u")return;const e=vn();if(e[Fe])return;e[Fe]=!0,console.info(`[${kn}] admin payment method brand sync installed`),document.readyState==="loading"?document.addEventListener("DOMContentLoaded",()=>ae()):ae();const t=history.pushState.bind(history);history.pushState=(...n)=>{t(...n),window.setTimeout(()=>Qe(),200)},window.addEventListener("popstate",()=>window.setTimeout(()=>Qe(),200))}const oe="sirsoft-pay_nhnkcp",Xe="__nhnkcpAdminPaymentDisplayInjectorInstalled",On=/^\/admin\/ecommerce\/orders\/([^/]+)$/;function Ln(){return localStorage.getItem("auth_token")}async function Hn(e){const t=Ln();if(!t)return null;try{const n=await fetch(`/api/plugins/${oe}/admin/orders/${e}/transaction-status`,{headers:{Authorization:`Bearer ${t}`,Accept:"application/json"}});if(!n.ok)return null;const r=await n.json();return("data"in r?r.data:r)??null}catch{return null}}function Bn(e){return Array.from(e.children).filter(t=>t instanceof HTMLElement)}function Dn(e,t){let n=!1;const r=Array.from(e.querySelectorAll("div"));for(const a of r){const o=Bn(a),i=o.findIndex(u=>u.textContent?.trim()==="결제수단");if(i<0)continue;const s=o.slice(i+1).find(u=>u.textContent?.trim()&&u.textContent.trim()!=="결제수단");if(!s)continue;const c=o.slice(i+2).find(u=>/^\(.+\)$/.test(u.textContent?.trim()??"")),d=c?.textContent?.trim().replace(/^\(|\)$/g,"")??"",l=d&&t.endsWith(")")?t.replace(/\)$/,`, ${d})`):t;s.textContent?.trim()!==l&&(s.textContent=l,s.dataset.nhnkcpPaymentMethodPatched="true"),a.dataset.nhnkcpPaymentMethodRow="admin-order",c&&d&&(c.textContent="",c.style.display="none",c.dataset.nhnkcpPaymentInstallmentHidden="true"),n=!0}return n}function jn(e,t,n){const a=Array.from(e.querySelectorAll("span")).filter(o=>o.textContent?.trim()===t).find(o=>{const i=typeof o.className=="string"?o.className:"";return i.includes("rounded-full")||i.includes("font-medium")});return a?(a.textContent=n,a.dataset.nhnkcpPaymentMethodPatched="true",a.dataset.nhnkcpPaymentMethodBadge="admin-order",!0):!1}function Yn(e,t){const n=t?._pay_method_label,r=t?._embedded_pg_provider_label,a=t?._base_pay_method_label;if(!n||!r)return!1;const o=Dn(e,n),i=a?jn(e,a,r):!1;return o||i}async function qn(e){const t=document.getElementById("section_payment_info")??document.getElementById("payment_info_card");if(!t)return!1;const n=await Hn(e);return n&&Yn(t,n)&&console.info(`[${oe}] payment method display patched on admin order detail`),!0}function Fn(e){let t=0;const n=setInterval(()=>{t++,qn(e).then(r=>{(r||t>=30)&&clearInterval(n)})},400)}function Gn(){const e=location.pathname.match(On);e&&Fn(e[1])}function Wn(){if(typeof window>"u")return;const e=window;if(e[Xe])return;e[Xe]=!0,console.info(`[${oe}] admin order payment display injector installed`);const t=(r=1500)=>setTimeout(Gn,r);document.readyState==="loading"?document.addEventListener("DOMContentLoaded",()=>t()):t();const n=history.pushState.bind(history);history.pushState=(...r)=>{n(...r),t(600)},window.addEventListener("popstate",()=>t(500))}class Un{constructor(t){const n="width=800,height=600,scrollbars=yes,resizable=yes,toolbar=no,menubar=no";t.url&&window.open(t.url,"kcp_receipt",n),t.cash_url&&window.open(t.cash_url,"kcp_cash_receipt",n)}}window.KcpReceiptPopup=Un;const N="sirsoft-pay_nhnkcp",ie={info:(...e)=>console.info(`[${N}]`,...e),warn:(...e)=>console.warn(`[${N}]`,...e),error:(...e)=>console.error(`[${N}]`,...e)};function Ze(){const e=window.G7Core;if(!e)return 0;const t=e.getActionDispatcher;if(typeof t!="function")return 0;const n=t();if(!n||typeof n.registerHandler!="function")return 0;let r=0;for(const[a,o]of Object.entries(me)){const i=`${N}.${a}`;n.registerHandler(i,o,{category:"plugin",source:N}),r++}return r}function et(){const e=()=>{const t=Ze();if(t>0){ie.info(`${t} handler(s) registered`);return}let n=0;const r=50,a=setInterval(()=>{n++;const o=Ze();if(o>0){clearInterval(a),ie.info(`${o} handler(s) registered (after ${n} retries)`);return}n>=r&&(clearInterval(a),ie.warn("ActionDispatcher not available after timeout"))},100)};document.readyState==="loading"?document.addEventListener("DOMContentLoaded",e):e()}It(),Lt(),Wt(),un(),Pn(),Rn(),Wn(),et(),window.__SirsoftNhnkcp={identifier:N,handlers:Object.keys(me),initPlugin:et}})();
+//# sourceMappingURL=plugin.iife.js.map
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/dist/js/plugin.iife.js.map b/plugins/_bundled/sirsoft-pay_nhnkcp/dist/js/plugin.iife.js.map
new file mode 100644
index 00000000..93c51cbd
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/dist/js/plugin.iife.js.map
@@ -0,0 +1 @@
+{"version":3,"file":"plugin.iife.js","sources":["../../resources/js/paymentCloseReport.ts","../../resources/js/support/applePayDevice.ts","../../resources/js/handlers/requestPayment.ts","../../resources/js/handlers/setPaymentMethod.ts","../../resources/js/handlers/copyToClipboard.ts","../../resources/js/handlers/index.ts","../../resources/js/orderResponseInterceptor.ts","../../resources/js/orderCompleteReceiptInjector.ts","../../resources/js/mypageOrderShowInjector.ts","../../resources/js/checkoutEasyPayInjector.ts","../../resources/js/adminApplePayNoticeInjector.ts","../../resources/js/adminPaymentMethodBrandInjector.ts","../../resources/js/adminOrderPaymentDisplayInjector.ts","../../resources/js/index.ts"],"sourcesContent":["export interface PaymentCloseReportContext {\n    closeReportUrl?: string;\n    oid: string;\n    price: number;\n    buyer_email?: string;\n    buyer_phone?: string;\n    payment_method?: string;\n}\n\nfunction resolveApiUrl(url: string): string {\n    if (/^https?:\\/\\//i.test(url) || url.startsWith('/api/')) {\n        return url;\n    }\n\n    if (url.startsWith('/plugins/')) {\n        return `/api${url}`;\n    }\n\n    if (url.startsWith('plugins/')) {\n        return `/api/${url}`;\n    }\n\n    return url;\n}\n\nfunction trimReason(reason: string): string {\n    return reason.trim().slice(0, 160);\n}\n\nfunction resolveRetryUrl(closeReportUrl?: string): string | undefined {\n    if (!closeReportUrl) {\n        return undefined;\n    }\n\n    return closeReportUrl.replace(/\\/payment\\/close-report$/, '/payment/retry');\n}\n\nasync function postPaymentContext(url: string, payload: Record<string, unknown>, keepalive = false): Promise<void> {\n    const apiClient = ((window as any).G7Core)?.api;\n    if (typeof apiClient?.post === 'function') {\n        await apiClient.post(url, payload);\n        return;\n    }\n\n    const response = await fetch(resolveApiUrl(url), {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify(payload),\n        keepalive,\n    });\n\n    if (!response.ok) {\n        let message = `NHN KCP payment request failed (${response.status})`;\n        try {\n            const data = await response.json();\n            const responseMessage = Array.isArray(data?.errors?.message)\n                ? data.errors.message[0]\n                : data?.error ?? data?.message;\n            if (typeof responseMessage === 'string' && responseMessage.trim() !== '') {\n                message = responseMessage;\n            }\n        } catch {\n            // JSON 응답이 아니면 HTTP 상태 메시지를 사용한다.\n        }\n        throw new Error(message);\n    }\n}\n\nexport async function preparePaymentRetry(context: PaymentCloseReportContext): Promise<void> {\n    const retryUrl = resolveRetryUrl(context.closeReportUrl);\n    if (!retryUrl) {\n        return;\n    }\n\n    await postPaymentContext(retryUrl, {\n        oid: context.oid,\n        price: Number(context.price),\n        buyer_email: context.buyer_email ?? '',\n        buyer_phone: context.buyer_phone ?? '',\n        payment_method: context.payment_method ?? '',\n    });\n}\n\nexport async function reportPaymentWindowClosed(\n    context: PaymentCloseReportContext,\n    reason = 'kcp-window-closed',\n): Promise<void> {\n    if (!context.closeReportUrl) {\n        return;\n    }\n\n    const payload = {\n        oid: context.oid,\n        price: Number(context.price),\n        buyer_email: context.buyer_email ?? '',\n        buyer_phone: context.buyer_phone ?? '',\n        payment_method: context.payment_method ?? '',\n        reason: trimReason(reason) || 'kcp-window-closed',\n    };\n\n    try {\n        await postPaymentContext(context.closeReportUrl, payload, true);\n    } catch (error) {\n        console.warn('[sirsoft-pay_nhnkcp] failed to report payment window close', error);\n    }\n}\n","export const NHNKCP_APPLEPAY_METHOD = 'nhnkcp_applepay';\n\nexport function isNhnKcpApplePayMethod(paymentMethod: unknown): boolean {\n    return paymentMethod === NHNKCP_APPLEPAY_METHOD;\n}\n\nexport function isIosMobileDevice(): boolean {\n    if (typeof navigator === 'undefined') return false;\n\n    const nav = navigator as Navigator & {\n        userAgentData?: {\n            mobile?: boolean;\n            platform?: string;\n        };\n        maxTouchPoints?: number;\n    };\n    const ua = (nav.userAgent || '').toLowerCase();\n    const platform = ((nav.userAgentData?.platform ?? nav.platform) || '').toLowerCase();\n    const touchPoints = nav.maxTouchPoints ?? 0;\n\n    if (/iphone|ipad|ipod/.test(ua) || /iphone|ipad|ipod|ios/.test(platform)) {\n        return true;\n    }\n\n    return /macintosh|mac os x/.test(ua) && touchPoints > 1;\n}\n\nexport function applePayUnsupportedMessage(): string {\n    const lang = typeof document !== 'undefined'\n        ? document.documentElement.lang\n        : '';\n\n    if ((lang || '').toLowerCase().startsWith('ko')) {\n        return '애플페이는 IOS 기기에 모바일결제만 가능합니다.';\n    }\n\n    return 'Apple Pay is available only for mobile payments on iOS devices.';\n}\n","/* eslint-disable @typescript-eslint/no-explicit-any */\n\nimport {\n    PaymentCloseReportContext,\n    preparePaymentRetry,\n    reportPaymentWindowClosed,\n} from '../paymentCloseReport';\nimport {\n    applePayUnsupportedMessage,\n    isIosMobileDevice,\n    isNhnKcpApplePayMethod,\n} from '../support/applePayDevice';\n\ninterface PgPaymentData {\n    order_number: string;\n    order_name: string;\n    amount: number;\n    currency?: string;\n    pay_method?: string;\n    customer_name?: string;\n    customer_email?: string;\n    customer_phone?: string;\n    /** 복합과세 분할용 — orderResponseInterceptor가 data.order 에서 주입 */\n    tax_amount?: number;\n    vat_amount?: number;\n    tax_free_amount?: number;\n}\n\ninterface RequestPaymentParams {\n    pgPaymentData: PgPaymentData;\n    paymentMethod?: string;\n}\n\nfunction normalizeCurrency(currency?: string): string {\n    const normalized = (currency ?? 'KRW').trim().toUpperCase();\n\n    return normalized || 'KRW';\n}\n\nexport function isSupportedKcpCurrency(currency?: string): boolean {\n    return normalizeCurrency(currency) === 'KRW';\n}\n\nfunction unsupportedCurrencyMessage(currency?: string): string {\n    const normalized = normalizeCurrency(currency);\n    const isKo = ((typeof document !== 'undefined' ? document.documentElement.lang : '') || '')\n        .toLowerCase()\n        .startsWith('ko');\n\n    return isKo\n        ? `NHN KCP는 KRW 결제만 지원합니다. (${normalized})`\n        : `NHN KCP supports KRW payments only. (${normalized})`;\n}\n\nexport function buildKcpTaxFields(pgPaymentData: PgPaymentData): Record<string, string> {\n    const paymentAmount = Math.max(0, Math.round(Number(pgPaymentData.amount ?? 0)));\n    const taxFreeAmt = Math.min(\n        Math.max(0, Math.round(Number(pgPaymentData.tax_free_amount ?? 0))),\n        paymentAmount,\n    );\n\n    if (taxFreeAmt <= 0) {\n        return {};\n    }\n\n    const taxTotalAmt = Math.max(0, Math.round(Number(pgPaymentData.tax_amount ?? 0)));\n    const originalVatAmt = Math.max(0, Math.round(Number(pgPaymentData.vat_amount ?? 0)));\n    const taxablePaymentAmt = Math.max(0, paymentAmount - taxFreeAmt);\n    const vatAmt = taxablePaymentAmt > 0 && taxTotalAmt > 0 && originalVatAmt > 0\n        ? Math.min(taxablePaymentAmt, Math.round(taxablePaymentAmt * (originalVatAmt / taxTotalAmt)))\n        : 0;\n    const supplyAmt = taxablePaymentAmt - vatAmt;\n\n    return {\n        tax_flag: 'TG03',\n        comm_tax_mny: String(supplyAmt),\n        comm_vat_mny: String(vatAmt),\n        comm_free_mny: String(taxFreeAmt),\n    };\n}\n\ninterface ClientConfig {\n    client_id: string;\n    easy_pay_client_id?: string;\n    sdk_url: string;\n    callback_urls: {\n        callback: string;\n        close_report?: string;\n    };\n    vbank_expire_days?: number;\n    use_escrow?: boolean;\n    escrow_client_id?: string;\n}\n\n// 사용자가 결제창을 직접 닫은 경우 - 에러 모달 없이 조용히 처리\nclass KcpCancelledError extends Error {\n    constructor(msg?: string) {\n        super(msg ?? '결제가 취소되었습니다.');\n        this.name = 'KcpCancelledError';\n    }\n}\n\n// KCP pay_method 비트마스크 변환 (PC: payplus_web.jsp 규격)\nconst KCP_PAY_METHOD: Record<string, string> = {\n    card:            '100000000000', // 신용카드\n    bank_transfer:   '010000000000', // 계좌이체\n    virtual_account: '001000000000', // 가상계좌\n    mobile:          '000010000000', // 휴대폰결제\n    bank:            '010000000000',\n    vbank:           '001000000000',\n    phone:           '000010000000',\n};\n\n// KCP 간편결제 direct 파라미터 (PC/모바일 공통)\nconst KCP_EASY_PAY_DIRECT: Record<string, Record<string, string>> = {\n    nhnkcp_payco:          { payco_direct: 'Y' },\n    nhnkcp_naverpay:       { naverpay_direct: 'Y' },\n    nhnkcp_naverpay_point: { naverpay_direct: 'Y', naverpay_point_direct: 'Y' },\n    nhnkcp_kakaopay:       { kakaopay_direct: 'Y' },\n    nhnkcp_applepay:       { applepay_direct: 'Y' },\n};\n\nexport function buildKcpEasyPayReturnFields(paymentMethod: string, isEasyPay: boolean): Record<string, string> {\n    const methodKey = paymentMethod.toLowerCase();\n    if (!isEasyPay || !Object.prototype.hasOwnProperty.call(KCP_EASY_PAY_DIRECT, methodKey)) {\n        return {};\n    }\n\n    return {\n        param_opt_1: methodKey,\n        nhnkcp_easy_pay_method: methodKey,\n    };\n}\n\nfunction isKcpPaymentFrameClosed(iframe: HTMLIFrameElement): boolean {\n    if (!iframe.isConnected) {\n        return true;\n    }\n\n    const style = window.getComputedStyle(iframe);\n    if (style.display === 'none' || style.visibility === 'hidden') {\n        return true;\n    }\n\n    const rect = iframe.getBoundingClientRect();\n    return rect.width <= 0 || rect.height <= 0;\n}\n\nexport function watchKcpPaymentFrameClosure(\n    iframe: HTMLIFrameElement,\n    onClose: () => void,\n): () => void {\n    let stopped = false;\n    let intervalId: number | undefined;\n    let observer: MutationObserver | undefined;\n\n    const stop = () => {\n        stopped = true;\n        if (observer) {\n            observer.disconnect();\n            observer = undefined;\n        }\n        if (intervalId !== undefined) {\n            window.clearInterval(intervalId);\n            intervalId = undefined;\n        }\n    };\n\n    const checkClosed = () => {\n        if (stopped || !isKcpPaymentFrameClosed(iframe)) {\n            return;\n        }\n\n        stop();\n        onClose();\n    };\n\n    const observeTarget = document.body ?? document.documentElement;\n    if (observeTarget && typeof MutationObserver !== 'undefined') {\n        observer = new MutationObserver(checkClosed);\n        observer.observe(observeTarget, {\n            attributes: true,\n            attributeFilter: ['class', 'hidden', 'style'],\n            childList: true,\n            subtree: true,\n        });\n    }\n\n    intervalId = window.setInterval(checkClosed, 300);\n\n    return stop;\n}\n\n/**\n * 모바일 기기 여부 판별 (3단계 fallback)\n *\n * 1) User Agent Client Hints — 브라우저가 직접 판단 (Chrome/Edge 90+)\n * 2) UA 문자열 파싱\n * 3) iPadOS 등 데스크탑 UA를 보내는 터치 기기 판별 (maxTouchPoints > 1)\n */\nfunction isMobileDevice(): boolean {\n    if (typeof navigator === 'undefined') return false;\n    if (isIosMobileDevice()) return true;\n\n    const nav = navigator as Navigator & { userAgentData?: { mobile: boolean } };\n    if (nav.userAgentData?.mobile !== undefined) {\n        return nav.userAgentData.mobile;\n    }\n\n    const ua = (navigator.userAgent || '').toLowerCase();\n    if (/android|iphone|ipod|windows phone|iemobile|blackberry|opera mini|mobile safari/.test(ua)) {\n        return true;\n    }\n\n    // iPadOS, Android 태블릿 등 — 터치스크린 노트북은 maxTouchPoints=1이므로 >1 조건 필요\n    const touchPoints = (navigator as Navigator & { maxTouchPoints?: number }).maxTouchPoints ?? 0;\n    if (touchPoints > 1 && !ua.includes('windows') && !ua.includes('macintosh')) {\n        return true;\n    }\n\n    return false;\n}\n\n/**\n * NHN KCP 결제창 호출 핸들러\n *\n * - 모바일: SOAP approval_key 획득 → form POST(페이지 전환) → 기존 authCallback 처리\n * - PC: payplus_web.jsp SDK를 iframe 내 동기 로드 → KCP_Pay_Execute() → 콜백\n */\nexport async function requestPaymentHandler(action: any, _context?: any): Promise<void> {\n    const { pgPaymentData, paymentMethod: paramPaymentMethod } = (action.params || {}) as RequestPaymentParams;\n\n    if (!pgPaymentData) {\n        console.error('[sirsoft-pay_nhnkcp] pgPaymentData is required');\n        return;\n    }\n\n    const paymentMethod = paramPaymentMethod ?? pgPaymentData.pay_method ?? 'card';\n    const isEasyPay = typeof paymentMethod === 'string' && paymentMethod.startsWith('nhnkcp_');\n\n    const G7Core = (window as any).G7Core;\n    let closeReportContext: PaymentCloseReportContext | null = null;\n\n    try {\n        if (!isSupportedKcpCurrency(pgPaymentData.currency)) {\n            const message = unsupportedCurrencyMessage(pgPaymentData.currency);\n            G7Core?.state?.setLocal?.({ paymentErrorMessage: message, isSubmittingOrder: false, paymentMethod });\n            G7Core?.modal?.open?.('nhnkcp_payment_error_modal');\n            return;\n        }\n\n        if (isNhnKcpApplePayMethod(paymentMethod) && !isIosMobileDevice()) {\n            const message = applePayUnsupportedMessage();\n            G7Core?.state?.setLocal?.({\n                paymentErrorMessage: message,\n                isSubmittingOrder: false,\n                paymentMethod,\n            });\n            G7Core?.modal?.open?.('nhnkcp_payment_error_modal');\n            return;\n        }\n\n        // 1. Client Config API 호출\n        const configJson = await G7Core.api.get('/modules/sirsoft-ecommerce/payments/client-config/nhnkcp');\n\n        if (!configJson.data) {\n            console.error('[sirsoft-pay_nhnkcp] Failed to fetch client config', configJson);\n            return;\n        }\n\n        const config: ClientConfig = configJson.data;\n        closeReportContext = {\n            closeReportUrl: config.callback_urls.close_report,\n            oid: pgPaymentData.order_number,\n            price: Number(pgPaymentData.amount),\n            buyer_email: pgPaymentData.customer_email ?? '',\n            buyer_phone: pgPaymentData.customer_phone ?? '',\n            payment_method: paymentMethod,\n        };\n        const callbackUrl = window.location.origin + config.callback_urls.callback;\n\n        await preparePaymentRetry(closeReportContext);\n\n        if (isMobileDevice()) {\n            await handleMobilePayment(G7Core, pgPaymentData, paymentMethod, isEasyPay, callbackUrl);\n        } else {\n            await handlePcPayment(config, pgPaymentData, paymentMethod, isEasyPay, callbackUrl);\n        }\n\n    } catch (error: unknown) {\n        if (error instanceof KcpCancelledError) {\n            if (closeReportContext) {\n                await reportPaymentWindowClosed(closeReportContext, error.message || 'kcp-window-closed');\n            }\n            G7Core?.state?.setLocal?.({ isSubmittingOrder: false, paymentMethod });\n            return;\n        }\n\n        console.error('[sirsoft-pay_nhnkcp] requestPayment error', error);\n\n        // axios error 의 response.data 에서 사용자 친화적 메시지 추출.\n        // G7Core.api 는 axios 기반이라 4xx/5xx 응답은 자동 reject 됨 — generic\n        // \"Request failed with status code 422\" 가 아니라 Laravel ValidationException\n        // 의 message / errors 필드를 우선 사용.\n        const anyErr = error as { response?: { data?: { message?: string; error?: string; errors?: Record<string, string[]> } }; message?: string };\n        const responseData = anyErr?.response?.data;\n        const firstFieldError = responseData?.errors\n            ? Object.values(responseData.errors)[0]?.[0]\n            : undefined;\n        const errorMessage =\n            responseData?.error\n            ?? responseData?.message\n            ?? firstFieldError\n            ?? (error instanceof Error ? error.message : 'Unknown error');\n\n        G7Core?.state?.setLocal?.({ paymentErrorMessage: errorMessage, isSubmittingOrder: false, paymentMethod });\n        G7Core?.modal?.open?.('nhnkcp_payment_error_modal');\n    }\n}\n\n/**\n * 모바일 결제 흐름\n *\n * 1) 서버에서 SOAP으로 approval_key + pay_url 획득\n * 2) 전체 form fields를 받아 브라우저가 pay_url 로 POST 전환 (페이지 이동)\n * 3) KCP가 결제 완료 후 Ret_URL(authCallback)로 redirect → 기존 서버 처리\n */\nasync function handleMobilePayment(\n    G7Core: any,\n    pgPaymentData: PgPaymentData,\n    paymentMethod: string,\n    isEasyPay: boolean,\n    callbackUrl: string,\n): Promise<void> {\n    const approvalJson = await G7Core.api.post('/plugins/sirsoft-pay_nhnkcp/mobile/approval-key', {\n        order_number: pgPaymentData.order_number,\n        amount: pgPaymentData.amount,\n        good_name: pgPaymentData.order_name,\n        pay_method: paymentMethod,\n        buyr_name: pgPaymentData.customer_name ?? '',\n        buyr_mail: pgPaymentData.customer_email ?? '',\n        buyr_tel1: pgPaymentData.customer_phone ?? '',\n        ret_url: callbackUrl,\n        currency: normalizeCurrency(pgPaymentData.currency),\n    });\n\n    if (!approvalJson.success || !approvalJson.data) {\n        // 서버 응답의 에러 메시지 우선순위:\n        //   1. ResponseHelper::error 의 'error' 필드 (커스텀)\n        //   2. Laravel ValidationException 의 'message' 필드 (422 응답 표준)\n        //   3. 'errors' 객체의 첫 번째 메시지 (필드별 validation 메시지)\n        //   4. fallback\n        const errors = approvalJson.errors as Record<string, string[]> | undefined;\n        const firstFieldError = errors ? Object.values(errors)[0]?.[0] : undefined;\n        throw new Error(\n            approvalJson.error\n                ?? approvalJson.message\n                ?? firstFieldError\n                ?? 'KCP 모바일 승인키 획득 실패',\n        );\n    }\n\n    const { pay_url, fields } = approvalJson.data as { pay_url: string; fields: Record<string, string> };\n\n    // 페이지 전환 form 생성 및 제출\n    const form = document.createElement('form');\n    form.method = 'POST';\n    form.action = pay_url;\n    form.acceptCharset = 'euc-kr'; // KCP 모바일은 EUC-KR 인코딩 필요\n    form.style.display = 'none';\n\n    for (const [name, value] of Object.entries(fields)) {\n        const input = document.createElement('input');\n        input.type = 'hidden';\n        input.name = name;\n        input.value = String(value);\n        form.appendChild(input);\n    }\n\n    document.body.appendChild(form);\n    form.submit();\n\n    // 페이지가 pay_url 로 이동하므로 Promise는 자연스럽게 중단됨\n    await new Promise<never>(() => {});\n}\n\n/**\n * PC 결제 흐름\n *\n * Chrome 비동기 document.write() 차단을 우회하기 위해 iframe 내에서\n * document.open/write/close 로 SDK를 동기 로드한 뒤 KCP_Pay_Execute() 호출.\n */\nasync function handlePcPayment(\n    config: ClientConfig,\n    pgPaymentData: PgPaymentData,\n    paymentMethod: string,\n    isEasyPay: boolean,\n    callbackUrl: string,\n): Promise<void> {\n    // 간편결제는 pay_method 항상 \"100000000000\" (카드 비트마스크), direct 파라미터로 수단 지정\n    const payMethod = isEasyPay\n        ? '100000000000'\n        : (KCP_PAY_METHOD[pgPaymentData.pay_method ?? 'card'] ?? '100000000000');\n\n    // PAYCO 전용 테스트 site_cd (S6729), 그 외 간편결제·에스크로·일반은 각자 site_cd 사용\n    const siteCd = paymentMethod === 'nhnkcp_payco'\n        ? (config.easy_pay_client_id ?? config.client_id)\n        : (config.use_escrow && !isEasyPay ? (config.escrow_client_id ?? config.client_id) : config.client_id);\n\n    const fields: Record<string, string> = {\n        site_cd: siteCd,\n        ordr_idxx: pgPaymentData.order_number,\n        good_name: pgPaymentData.order_name,\n        good_mny: String(pgPaymentData.amount),\n        buyr_name: pgPaymentData.customer_name ?? '',\n        buyr_mail: pgPaymentData.customer_email ?? '',\n        buyr_tel1: pgPaymentData.customer_phone ?? '',\n        pay_method: payMethod,\n        Ret_URL: callbackUrl,\n    };\n\n    Object.assign(fields, buildKcpTaxFields(pgPaymentData));\n    Object.assign(fields, buildKcpEasyPayReturnFields(paymentMethod, isEasyPay));\n\n    // 가상계좌 전용 파라미터\n    if (payMethod === '001000000000') {\n        fields['vcnt_expire_term'] = String(config.vbank_expire_days ?? 3);\n        fields['disp_tax_yn'] = 'N';\n    }\n\n    // 에스크로 결제 파라미터 (간편결제 제외)\n    if (config.use_escrow && !isEasyPay) {\n        fields['escw_used'] = 'Y';\n        fields['pay_mod'] = 'O';\n    }\n\n    // 간편결제: GNU5 규격과 동일하게 모든 direct 파라미터를 기본값(\"\" 또는 \"A\")으로 초기화한 뒤\n    // 선택된 수단만 \"Y\"로 덮어씀 — 초기값이 없으면 KCP가 이전 요청값을 재사용할 수 있음\n    if (isEasyPay) {\n        // GNU5 규격: 모든 direct 파라미터를 기본값으로 초기화 후 선택된 수단만 Y로 덮어씀\n        fields['payco_direct']    = '';\n        fields['naverpay_direct'] = 'A';\n        fields['kakaopay_direct'] = 'A';\n        fields['applepay_direct'] = 'A';\n        const directOverride = KCP_EASY_PAY_DIRECT[paymentMethod];\n        if (directOverride) {\n            Object.assign(fields, directOverride);\n        }\n    }\n\n    const hiddenInputs = Object.entries(fields)\n        .map(([n, v]) => `<input type=\"hidden\" name=\"${n}\" value=\"${v.replace(/\"/g, '&quot;')}\">`)\n        .join('');\n\n    await new Promise<void>((resolve, reject) => {\n        // 기존 요소 정리\n        document.getElementById('kcp-sdk-iframe')?.remove();\n        document.getElementById('kcp-dim-overlay')?.remove();\n\n        // 메인 창에 반투명 dim 오버레이 (결제창 뒤 배경)\n        const overlay = document.createElement('div');\n        overlay.id = 'kcp-dim-overlay';\n        overlay.style.cssText = 'position:fixed;top:0;left:0;width:100%;height:100%;background:rgba(0,0,0,0.6);z-index:99998;';\n        document.body.appendChild(overlay);\n\n        // 투명 iframe - KCP 결제창이 내부에 렌더링됨\n        const iframe = document.createElement('iframe');\n        iframe.id = 'kcp-sdk-iframe';\n        iframe.setAttribute('allowtransparency', 'true');\n        iframe.style.cssText = 'position:fixed;top:0;left:0;width:100%;height:100%;border:0;z-index:99999;background:transparent;';\n        document.body.appendChild(iframe);\n\n        const iframeWin = iframe.contentWindow as any;\n        let settled = false;\n        let sdkLoadTimer: number | undefined;\n        let stopCloseWatcher: (() => void) | undefined;\n\n        const cleanup = () => {\n            stopCloseWatcher?.();\n            stopCloseWatcher = undefined;\n            if (sdkLoadTimer !== undefined) {\n                clearTimeout(sdkLoadTimer);\n                sdkLoadTimer = undefined;\n            }\n            iframe.remove();\n            overlay.remove();\n        };\n\n        const rejectOnce = (error: Error) => {\n            if (settled) {\n                return;\n            }\n\n            settled = true;\n            cleanup();\n            reject(error);\n        };\n\n        const markCompletingPayment = () => {\n            settled = true;\n            stopCloseWatcher?.();\n            stopCloseWatcher = undefined;\n            if (sdkLoadTimer !== undefined) {\n                clearTimeout(sdkLoadTimer);\n                sdkLoadTimer = undefined;\n            }\n        };\n\n        stopCloseWatcher = watchKcpPaymentFrameClosure(iframe, () => {\n            rejectOnce(new KcpCancelledError('kcp-payment-frame-closed'));\n        });\n\n        // 결제 완료 콜백 - KCP가 결제 후 호출\n        iframeWin.m_Completepayment = function (form: HTMLFormElement) {\n            const resCode = (form.elements as any)['res_cd']?.value ?? '';\n            const resMsg  = (form.elements as any)['res_msg']?.value ?? '';\n\n            if (resCode === '0000') {\n                markCompletingPayment();\n\n                // GNU5 패턴(GetField): KCP 결과를 order_info에 병합 후 order_info를 POST.\n                // KakaoPay 등 direct 결제에서 KCP가 ordr_idxx 없는 새 폼을 전달하므로\n                // form을 그대로 제출하면 서버 검증 실패(invalid_params).\n                // order_info(우리 주문 필드 포함)를 기준으로 병합해야 한다.\n                const orderForm = iframeWin.document.forms.namedItem('order_info') as HTMLFormElement | null;\n                const targetForm = (orderForm && orderForm !== form) ? orderForm : form;\n\n                if (orderForm && orderForm !== form) {\n                    for (let i = 0; i < form.elements.length; i++) {\n                        const el = form.elements[i] as HTMLInputElement;\n                        if (!el.name) continue;\n                        let dest = orderForm.elements.namedItem(el.name) as HTMLInputElement | null;\n                        if (!dest) {\n                            dest = iframeWin.document.createElement('input') as HTMLInputElement;\n                            dest.type = 'hidden';\n                            dest.name = el.name;\n                            orderForm.appendChild(dest);\n                        }\n                        dest.value = el.value;\n                    }\n                }\n\n                targetForm.action = callbackUrl;\n                targetForm.method = 'POST';\n                targetForm.target = '_top';\n                iframeWin.document.body.appendChild(targetForm);\n                targetForm.submit();\n            } else {\n                // 취소 또는 오류\n                const isCancelled = resCode === '' || resCode === '7777' || resMsg.includes('취소');\n                rejectOnce(isCancelled ? new KcpCancelledError(resMsg) : new Error(`KCP 오류 [${resCode}]: ${resMsg}`));\n            }\n        };\n\n        iframeWin.__kcpFail = (err: Error) => {\n            rejectOnce(err);\n        };\n\n        // SDK 동기 로드 + KCP_Pay_Execute 호출\n        const iframeDoc = (iframe.contentDocument || iframeWin.document) as Document;\n        iframeDoc.open();\n        iframeDoc.write(`<!DOCTYPE html><html><head>\n<script src=\"${config.sdk_url}\"><\\/script>\n</head><body style=\"margin:0;padding:0;background:transparent;\">\n<form name=\"order_info\">${hiddenInputs}</form>\n<script>\ntry {\n  if (typeof KCP_Pay_Execute === 'function') {\n    KCP_Pay_Execute(document.forms['order_info']);\n    window.__kcpReady && window.__kcpReady();\n  } else {\n    window.__kcpFail && window.__kcpFail(new Error('KCP_Pay_Execute not defined'));\n  }\n} catch(e) {\n  window.__kcpFail && window.__kcpFail(e);\n}\n<\\/script>\n</body></html>`);\n        iframeDoc.close();\n\n        // SDK 로드 실패 대비 타임아웃 — 결제창이 열리면(__kcpReady) 즉시 해제됨\n        sdkLoadTimer = window.setTimeout(() => {\n            rejectOnce(new Error('KCP SDK load timeout'));\n        }, 15000);\n\n        iframeWin.__kcpReady = () => {\n            if (sdkLoadTimer !== undefined) {\n                clearTimeout(sdkLoadTimer);\n                sdkLoadTimer = undefined;\n            }\n        };\n    });\n}\n","/* eslint-disable @typescript-eslint/no-explicit-any */\n\nimport {\n    applePayUnsupportedMessage,\n    isIosMobileDevice,\n    isNhnKcpApplePayMethod,\n} from '../support/applePayDevice';\n\nconst METHOD_TO_TEXT: Record<string, string> = {\n    nhnkcp_payco:          'PAYCO',\n    nhnkcp_naverpay:       '네이버페이',\n    nhnkcp_naverpay_point: '네이버페이 포인트',\n    nhnkcp_kakaopay:       '카카오페이',\n    nhnkcp_applepay:       'Apple Pay',\n};\n\nconst SELECTED_SHADOW = '0 0 0 2px #ffffff, 0 0 0 5px rgba(0,0,0,0.55)';\n\nfunction getEasyPayButtonContainer(): Element | null {\n    const section = document.querySelector('.nhnkcp-easy-pay-btns');\n    return section ?? null;\n}\n\nfunction clearEasyPayButtonStyles(): void {\n    const container = getEasyPayButtonContainer();\n    if (!container) return;\n    container.querySelectorAll<HTMLButtonElement>('button').forEach(btn => {\n        btn.style.boxShadow = '';\n        btn.style.outline = '';\n    });\n}\n\nfunction updateEasyPayButtonStyles(selectedMethod: string): void {\n    const container = getEasyPayButtonContainer();\n    if (!container) return;\n\n    const selectedText = METHOD_TO_TEXT[selectedMethod];\n    container.querySelectorAll<HTMLButtonElement>('button').forEach(btn => {\n        if (btn.textContent?.trim() === selectedText) {\n            btn.style.boxShadow = SELECTED_SHADOW;\n            btn.style.outline = 'none';\n        } else {\n            btn.style.boxShadow = '';\n            btn.style.outline = '';\n        }\n    });\n}\n\nexport function setPaymentMethodHandler(action: any): void {\n    const paymentMethod = action.params?.paymentMethod;\n    if (!paymentMethod) return;\n\n    const G7Core = (window as any).G7Core;\n    if (isNhnKcpApplePayMethod(paymentMethod) && !isIosMobileDevice()) {\n        const message = applePayUnsupportedMessage();\n        G7Core?.state?.setLocal?.({\n            paymentErrorMessage: message,\n            isSubmittingOrder: false,\n        });\n        G7Core?.modal?.open?.('nhnkcp_payment_error_modal');\n        clearEasyPayButtonStyles();\n        return;\n    }\n\n    const isEasyPay = typeof paymentMethod === 'string' && paymentMethod.startsWith('nhnkcp_');\n    G7Core?.state?.setLocal?.({\n        paymentMethod,\n        serverPaymentMethod: isEasyPay ? 'card' : paymentMethod,\n    });\n\n    if (isEasyPay) {\n        updateEasyPayButtonStyles(paymentMethod);\n    } else {\n        clearEasyPayButtonStyles();\n    }\n}\n","/* eslint-disable @typescript-eslint/no-explicit-any */\n\nfunction fallbackCopy(text: string): void {\n    const textarea = document.createElement('textarea');\n    textarea.value = text;\n    textarea.setAttribute('readonly', 'readonly');\n    textarea.style.position = 'fixed';\n    textarea.style.left = '-9999px';\n    textarea.style.top = '0';\n\n    document.body.appendChild(textarea);\n    textarea.select();\n\n    try {\n        document.execCommand('copy');\n    } finally {\n        textarea.remove();\n    }\n}\n\nexport async function copyToClipboardHandler(action: any): Promise<void> {\n    const text = String(action.params?.text ?? '');\n\n    if (text === '') {\n        return;\n    }\n\n    if (navigator.clipboard && typeof navigator.clipboard.writeText === 'function') {\n        await navigator.clipboard.writeText(text);\n        return;\n    }\n\n    fallbackCopy(text);\n}\n","import { requestPaymentHandler } from './requestPayment';\nimport { setPaymentMethodHandler } from './setPaymentMethod';\nimport { copyToClipboardHandler } from './copyToClipboard';\n\nexport const handlerMap: Record<string, (...args: unknown[]) => unknown> = {\n    requestPayment: requestPaymentHandler,\n    setPaymentMethod: setPaymentMethodHandler,\n    copyToClipboard: copyToClipboardHandler,\n} as const;\n","/**\n * 주문 생성 API 응답 인터셉터\n *\n * 체크아웃 템플릿(_checkout_summary.json)에는 'sirsoft-tosspayments' 분기만\n * 정의되어 있어서, 'sirsoft-nhnkcp' PG는 navigate 기본 분기로 떨어져\n * /shop/orders/{order_number}/complete 로 이동해버림 (결제창 미노출).\n *\n * 코어/템플릿 수정 없이 이 문제를 우회하기 위해 plugin loading 시점에\n * window.fetch 를 래핑해 다음을 수행:\n *\n *   1. POST /api/modules/sirsoft-ecommerce/user/orders 요청 body에서\n *      nhnkcp_* 간편결제 수단을 'card'로 교체 후 서버 전송\n *   2. 응답에서 data.pg_provider === 'sirsoft-nhnkcp' 이면\n *      requestPayment 핸들러를 직접 호출하여 결제창 띄움\n *   3. data.redirect_url 을 현재 URL로 교체하고 requires_pg_payment를 false로 변경\n *      → 템플릿 fallback 분기의 navigate 가 navigate-to-self 가 되어 실질적 이동 없음\n *\n * 결과: 체크아웃 페이지에 머문 채 PG 팝업이 뜨고, PG 콜백이 정식 complete 페이지로 redirect.\n */\n\nimport { requestPaymentHandler } from './handlers/requestPayment';\nimport {\n    applePayUnsupportedMessage,\n    isIosMobileDevice,\n    isNhnKcpApplePayMethod,\n} from './support/applePayDevice';\n\nconst ORDER_CREATE_PATH = '/api/modules/sirsoft-ecommerce/user/orders';\nconst TARGET_PG_PROVIDER = 'sirsoft-nhnkcp';\nconst PLUGIN_IDENTIFIER = 'sirsoft-pay_nhnkcp';\nconst EASY_PAY_PREFIX = 'nhnkcp_';\n\nconst logger = {\n    info: (...args: unknown[]) => console.info(`[${PLUGIN_IDENTIFIER}]`, ...args),\n    warn: (...args: unknown[]) => console.warn(`[${PLUGIN_IDENTIFIER}]`, ...args),\n    error: (...args: unknown[]) => console.error(`[${PLUGIN_IDENTIFIER}]`, ...args),\n};\n\ninterface OrderCreateResponseBody {\n    success?: boolean;\n    message?: string;\n    data?: {\n        order?: {\n            order_number?: string;\n            total_tax_amount?: number;\n            total_vat_amount?: number;\n            total_tax_free_amount?: number;\n        };\n        redirect_url?: string;\n        requires_pg_payment?: boolean;\n        pg_provider?: string;\n        pg_payment_data?: Record<string, unknown>;\n    };\n}\n\nfunction extractUrl(input: RequestInfo | URL): string {\n    if (typeof input === 'string') return input;\n    if (input instanceof URL) return input.toString();\n    if (typeof Request !== 'undefined' && input instanceof Request) return input.url;\n    return String(input);\n}\n\nfunction extractMethod(input: RequestInfo | URL, init?: RequestInit): string {\n    if (init?.method) return init.method.toUpperCase();\n    if (typeof Request !== 'undefined' && input instanceof Request) return input.method.toUpperCase();\n    return 'GET';\n}\n\nfunction isTargetEndpoint(url: string, method: string): boolean {\n    if (method !== 'POST') return false;\n    const path = url.split('?')[0].split('#')[0];\n    return path === ORDER_CREATE_PATH || path.endsWith(ORDER_CREATE_PATH);\n}\n\nfunction buildNoOpRedirectUrl(): string {\n    return window.location.pathname + window.location.search + window.location.hash;\n}\n\nfunction mutateResponse(originalResponse: Response, mutatedBody: OrderCreateResponseBody): Response {\n    const json = JSON.stringify(mutatedBody);\n    return new Response(json, {\n        status: originalResponse.status,\n        statusText: originalResponse.statusText,\n        headers: originalResponse.headers,\n    });\n}\n\nfunction buildPaymentMethodBlockedResponse(message: string): Response {\n    return new Response(JSON.stringify({\n        success: false,\n        message,\n        error: message,\n        errors: {\n            payment_method: [message],\n        },\n    }), {\n        status: 422,\n        statusText: 'Unprocessable Content',\n        headers: {\n            'Content-Type': 'application/json',\n        },\n    });\n}\n\nfunction extractPaymentMethodFromBody(body: string): string | undefined {\n    try {\n        const parsed = JSON.parse(body) as Record<string, unknown>;\n        return parsed['payment_method'] as string | undefined;\n    } catch {\n        return undefined;\n    }\n}\n\nfunction replacePaymentMethodInBody(body: string, replacement: string): string {\n    try {\n        const parsed = JSON.parse(body) as Record<string, unknown>;\n        parsed['payment_method'] = replacement;\n        return JSON.stringify(parsed);\n    } catch {\n        return body;\n    }\n}\n\nexport function installOrderResponseInterceptor(): void {\n    if (typeof window === 'undefined' || typeof window.fetch !== 'function') {\n        return;\n    }\n\n    const flag = '__sirsoftNhnkcpInterceptorInstalled' as const;\n    const w = window as unknown as Record<string, unknown>;\n    if (w[flag]) {\n        return;\n    }\n    w[flag] = true;\n\n    // 최초 설치 플러그인이 원본 브라우저 fetch를 보존 (다른 PG 인터셉터가 쌓이기 전)\n    const ORIGINAL_FETCH_KEY = '__sirsoftPgOriginalFetch';\n    if (!w[ORIGINAL_FETCH_KEY]) {\n        w[ORIGINAL_FETCH_KEY] = window.fetch.bind(window);\n    }\n    // easy pay 요청 시 다른 PG 인터셉터(KG 이니시스 등)를 완전히 우회하는 원본 fetch\n    const browserFetch = w[ORIGINAL_FETCH_KEY] as typeof fetch;\n\n    const originalFetch = window.fetch.bind(window);\n\n    window.fetch = async function patchedFetch(\n        input: RequestInfo | URL,\n        init?: RequestInit\n    ): Promise<Response> {\n        const url = extractUrl(input);\n        const method = extractMethod(input, init);\n\n        // 주문 생성 엔드포인트가 아니면 바로 통과\n        if (!isTargetEndpoint(url, method)) {\n            return originalFetch(input, init);\n        }\n\n        // 요청 body에서 payment_method 추출 (nhnkcp_* 간편결제 감지)\n        let originalPaymentMethod: string | undefined;\n        let modifiedInit = init;\n\n        if (init?.body && typeof init.body === 'string') {\n            const pm = extractPaymentMethodFromBody(init.body);\n            if (typeof pm === 'string' && pm.startsWith(EASY_PAY_PREFIX)) {\n                originalPaymentMethod = pm;\n                // nhnkcp_* → 'card'로 교체해 서버 전송 (서버 ValidationEnum에 없는 값 방지)\n                modifiedInit = { ...init, body: replacePaymentMethodInBody(init.body, 'card') };\n                logger.info(`easy pay detected: replacing payment_method '${pm}' → 'card'`);\n            }\n        }\n\n        // G7Core 로컬 상태 fallback — 간편결제 버튼 클릭 시 serverPaymentMethod='card'로\n        // 서버에 전달되어 요청 body에서 감지 불가인 경우 대비\n        if (!originalPaymentMethod) {\n            try {\n                // eslint-disable-next-line @typescript-eslint/no-explicit-any\n                const localPm = ((window as any).G7Core)?.state?.getLocal?.()?.paymentMethod;\n                if (typeof localPm === 'string' && localPm.startsWith(EASY_PAY_PREFIX)) {\n                    originalPaymentMethod = localPm;\n                    logger.info(`easy pay detected from local state: '${localPm}'`);\n                }\n            } catch { /* ignore */ }\n        }\n\n        if (isNhnKcpApplePayMethod(originalPaymentMethod) && !isIosMobileDevice()) {\n            const message = applePayUnsupportedMessage();\n            logger.warn(message);\n            return buildPaymentMethodBlockedResponse(message);\n        }\n\n        // easy pay일 때 browserFetch(원본)를 사용해 KG 이니시스 등 다른 PG 인터셉터 우회\n        // 기본 PG가 KG 이니시스여도 NHN KCP 결제창이 열리도록 함\n        const fetchFn = originalPaymentMethod ? browserFetch : originalFetch;\n        const response = await fetchFn(input, modifiedInit);\n\n        let cloned: Response;\n        try {\n            cloned = response.clone();\n        } catch {\n            return response;\n        }\n\n        let body: OrderCreateResponseBody | null = null;\n        try {\n            body = (await cloned.json()) as OrderCreateResponseBody;\n        } catch {\n            return response;\n        }\n\n        const data = body?.data;\n        if (!data) return response;\n\n        const requiresPg = data.requires_pg_payment === true;\n        const isNhnkcp = data.pg_provider === TARGET_PG_PROVIDER;\n\n        // 일반 결제: pg_provider가 nhnkcp이고 requires_pg_payment=true인 경우에만 처리\n        // 간편결제: pg_provider 무관하게 NHN KCP 처리 (기본 PG가 KG 이니시스여도 KCP 결제창 띄움)\n        if (!originalPaymentMethod && (!requiresPg || !isNhnkcp)) {\n            return response;\n        }\n        if (originalPaymentMethod && !data.order && !data.pg_payment_data) {\n            return response;\n        }\n\n        // pg_payment_data: 서버 응답에 포함되거나,\n        // 간편결제 + 기본 PG가 타 PG인 경우 data.order에서 직접 구성\n        let pgPaymentData = data.pg_payment_data;\n        if (!pgPaymentData && originalPaymentMethod && data.order) {\n            const orderData = data.order as Record<string, unknown>;\n            const options = orderData.options as Array<Record<string, unknown>> | undefined;\n            const firstName = (options?.[0]?.product_name as string | undefined) ?? String(orderData.order_number ?? '');\n            const orderName = (options?.length ?? 0) > 1\n                ? `${firstName} 외 ${(options?.length ?? 0) - 1}건`\n                : firstName;\n            pgPaymentData = {\n                order_number: orderData.order_number,\n                order_name: orderName,\n                amount: Math.floor(Number(orderData.total_due_amount ?? orderData.total_amount ?? 0)),\n                currency: 'KRW',\n                customer_name: orderData.orderer_name ?? null,\n                customer_email: orderData.orderer_email ?? null,\n                customer_phone: String(orderData.orderer_phone ?? '').replace(/[^0-9]/g, ''),\n            };\n            logger.info('pg_payment_data constructed from order (기본 PG가 타 PG)', {\n                order_number: pgPaymentData.order_number,\n                amount: pgPaymentData.amount,\n            });\n        }\n\n        if (!pgPaymentData) {\n            logger.warn('nhnkcp order detected but pg_payment_data missing');\n            return response;\n        }\n\n        logger.info('intercepted order create response — opening PG popup');\n\n        // 주문 세금 정보 추출 — PC 결제창의 복합과세 분할 필드 전달용\n        const orderTax = data.order\n            ? {\n                tax_amount: data.order.total_tax_amount ?? 0,\n                vat_amount: data.order.total_vat_amount ?? 0,\n                tax_free_amount: data.order.total_tax_free_amount ?? 0,\n            }\n            : {};\n\n        // 간편결제가 아닌 경우 요청 body의 pay_method를 pgPaymentData에 주입\n        const enrichedPgPaymentData = (!originalPaymentMethod && modifiedInit?.body && typeof modifiedInit.body === 'string')\n            ? (() => {\n                const pm = extractPaymentMethodFromBody(modifiedInit!.body as string);\n                return pm ? { ...pgPaymentData, pay_method: pm, ...orderTax } : { ...pgPaymentData, ...orderTax };\n            })()\n            : { ...pgPaymentData, ...orderTax };\n\n        void requestPaymentHandler({\n            // eslint-disable-next-line @typescript-eslint/no-explicit-any\n            params: {\n                pgPaymentData: enrichedPgPaymentData as any,\n                paymentMethod: originalPaymentMethod,\n            },\n        });\n\n        const mutatedBody: OrderCreateResponseBody = {\n            ...body,\n            data: {\n                ...data,\n                requires_pg_payment: false,\n                redirect_url: buildNoOpRedirectUrl(),\n            },\n        };\n\n        return mutateResponse(response, mutatedBody);\n    };\n\n    logger.info('order response interceptor installed');\n}\n","const PLUGIN_ID = 'sirsoft-pay_nhnkcp';\nconst FLAG = '__kcpOcReceiptInjectorInstalled';\nconst BTN_ID = 'kcp-oc-receipt-btn';\n\nconst ORDER_COMPLETE_RE = /^\\/shop\\/orders\\/([^/]+)\\/complete$/;\n\ntype Payment = {\n    pg_provider: string;\n    transaction_id: string | null;\n    paid_at: string | null;\n    [key: string]: unknown;\n};\n\nfunction getToken(): string | null {\n    return localStorage.getItem('auth_token');\n}\n\nasync function fetchPayment(orderNumber: string): Promise<Payment | null> {\n    const token = getToken();\n    if (!token) return null;\n\n    try {\n        const res = await fetch(`/api/modules/sirsoft-ecommerce/user/orders/${orderNumber}`, {\n            headers: { Authorization: `Bearer ${token}`, Accept: 'application/json' },\n        });\n        if (!res.ok) return null;\n        const data = (await res.json()) as { data?: { payment?: Payment } };\n        return data?.data?.payment ?? null;\n    } catch {\n        return null;\n    }\n}\n\ninterface ReceiptInfo {\n    receipt_url: string;\n    cash_receipt_url: string | null;\n    payment_method_display_label?: string | null;\n}\n\nasync function fetchReceiptUrl(orderNumber: string): Promise<ReceiptInfo | null> {\n    const token = getToken();\n    if (!token) return null;\n\n    try {\n        const res = await fetch(`/api/plugins/${PLUGIN_ID}/user/orders/${orderNumber}/receipt`, {\n            headers: { Authorization: `Bearer ${token}`, Accept: 'application/json' },\n        });\n        if (!res.ok) return null;\n        return (await res.json()) as ReceiptInfo;\n    } catch {\n        return null;\n    }\n}\n\nfunction makeBtn(text: string, classes: string, onClick: (btn: HTMLButtonElement) => void): HTMLButtonElement {\n    const btn = document.createElement('button');\n    btn.type = 'button';\n    btn.className = classes;\n    btn.textContent = text;\n    btn.addEventListener('click', () => onClick(btn));\n    return btn;\n}\n\nfunction patchPaymentMethodDisplay(displayLabel: string | null | undefined): boolean {\n    if (!displayLabel) return false;\n\n    const rows = Array.from(document.querySelectorAll<HTMLElement>('div'));\n    for (const row of rows) {\n        const spans = Array.from(row.children).filter(\n            (child): child is HTMLElement => child instanceof HTMLElement && child.tagName === 'SPAN',\n        );\n        if (spans.length < 2) continue;\n\n        const label = spans[0].textContent?.trim();\n        if (label !== '결제 방법' && label !== '결제수단' && label !== '결제 방식') continue;\n\n        const value = spans[spans.length - 1];\n        if (value.textContent?.trim() === displayLabel) {\n            row.dataset.nhnkcpPaymentMethodRow = 'true';\n            return true;\n        }\n\n        value.textContent = displayLabel;\n        value.dataset.nhnkcpPaymentMethodPatched = 'true';\n        row.dataset.nhnkcpPaymentMethodRow = 'true';\n        return true;\n    }\n\n    return false;\n}\n\n// 주문완료 페이지 버튼 영역에 영수증 버튼 주입\nasync function injectOnOrderComplete(orderNumber: string): Promise<void> {\n    if (document.getElementById(BTN_ID)) return;\n\n    const payment = await fetchPayment(orderNumber);\n    // 입금완료(paid_at 채워짐) 시점에만 영수증 버튼 표시.\n    // 가상계좌 발급 시 transaction_id 는 채워지지만 paid_at 은 null 이므로 입금대기 상태에선 미노출.\n    if (!payment || payment.pg_provider !== 'nhnkcp' || !payment.transaction_id || !payment.paid_at) return;\n\n    // \"주문 상세 보기\" 버튼 찾기 (bg-blue-600)\n    const blueBtn = Array.from(document.querySelectorAll<HTMLButtonElement>('button[type=\"button\"]'))\n        .find(b => b.className.includes('bg-blue-600'));\n\n    if (!blueBtn?.parentElement) return;\n\n    const receiptInfo = await fetchReceiptUrl(orderNumber);\n    patchPaymentMethodDisplay(receiptInfo?.payment_method_display_label);\n\n    const container = blueBtn.parentElement;\n\n    const receiptBtn = makeBtn('영수증 조회', blueBtn.className.replace(/bg-blue-\\d+/g, 'bg-green-600').replace(/hover:bg-blue-\\d+/g, 'hover:bg-green-700'), async (btn) => {\n        btn.disabled = true;\n        btn.textContent = '로딩 중...';\n        const data = await fetchReceiptUrl(orderNumber);\n        btn.disabled = false;\n        btn.textContent = '영수증 조회';\n        if (data) {\n            const KcpPopup = (window as unknown as Record<string, unknown>).KcpReceiptPopup as\n                (new (p: { url?: string; cash_url?: string }) => unknown) | undefined;\n            if (KcpPopup) new KcpPopup({ url: data.receipt_url ?? undefined });\n        }\n    });\n    receiptBtn.id = BTN_ID;\n\n    // \"쇼핑 계속하기\" 버튼 앞에 삽입\n    const lastBtn = container.lastElementChild;\n    container.insertBefore(receiptBtn, lastBtn);\n\n    // 현금영수증 버튼 (가상계좌/계좌이체)\n    const cashBtnId = 'kcp-oc-cash-receipt-btn';\n    if (!document.getElementById(cashBtnId) && (payment.payment_method === 'vbank' || payment.payment_method === 'bank_transfer')) {\n        const cashBtn = makeBtn('현금영수증 조회', receiptBtn.className.replace(/bg-green-\\d+/g, 'bg-teal-600').replace(/hover:bg-green-\\d+/g, 'hover:bg-teal-700'), async (btn) => {\n            btn.disabled = true;\n            btn.textContent = '로딩 중...';\n            const data = await fetchReceiptUrl(orderNumber);\n            btn.disabled = false;\n            btn.textContent = '현금영수증 조회';\n            if (data) {\n                const KcpPopup = (window as unknown as Record<string, unknown>).KcpReceiptPopup as\n                    (new (p: { url?: string; cash_url?: string }) => unknown) | undefined;\n                if (KcpPopup) new KcpPopup({ cash_url: data.cash_receipt_url ?? undefined });\n            }\n        });\n        cashBtn.id = cashBtnId;\n        container.insertBefore(cashBtn, lastBtn);\n    }\n\n    console.info(`[${PLUGIN_ID}] receipt button injected on order complete page`);\n}\n\nfunction tryInject(): void {\n    const path = location.pathname;\n    const ocMatch = path.match(ORDER_COMPLETE_RE);\n    if (ocMatch) {\n        void injectOnOrderComplete(ocMatch[1]);\n    }\n    // 마이페이지 주문상세는 mypageOrderShowInjector가 처리\n}\n\nexport function installOrderCompleteReceiptInjector(): void {\n    if (typeof window === 'undefined') return;\n    const w = window as Record<string, unknown>;\n    if (w[FLAG]) return;\n    w[FLAG] = true;\n\n    console.info(`[${PLUGIN_ID}] order complete receipt injector installed`);\n\n    const schedule = (delay = 1200) => setTimeout(tryInject, delay);\n\n    // 현재 페이지 즉시 처리\n    if (document.readyState === 'loading') {\n        document.addEventListener('DOMContentLoaded', () => schedule());\n    } else {\n        schedule();\n    }\n\n    // SPA 네비게이션 감지\n    const origPush = history.pushState.bind(history);\n    history.pushState = (...args: Parameters<typeof history.pushState>) => {\n        origPush(...args);\n        schedule();\n    };\n    window.addEventListener('popstate', () => schedule(500));\n}\n","const PLUGIN_ID = 'sirsoft-pay_nhnkcp';\nconst FLAG = '__kcpMpShowInjectorInstalled';\nconst VBANK_ID = 'kcp-mp-vbank-row';\nconst ROW_ID = 'kcp-mp-receipt-row';\nconst MOCK_DEPOSIT_ID = 'kcp-mp-mock-deposit';\n\nconst ORDER_SHOW_RE = /^\\/mypage\\/orders\\/([^/]+)$/;\n\ninterface Payment {\n    pg_provider?: string;\n    payment_method?: string;\n    transaction_id?: string | null;\n    paid_at?: string | null;\n    vbank_name?: string;\n    vbank_number?: string;\n    vbank_holder?: string;\n    due_date_formatted?: string;\n    [key: string]: unknown;\n}\n\ninterface OrderData {\n    order_number?: string;\n    total_amount_formatted?: string;\n    payment?: Payment;\n}\n\nfunction getOrderFromState(orderNumber: string): OrderData | null {\n    try {\n        const g7 = (window as unknown as Record<string, unknown>).G7Core as Record<string, unknown> | undefined;\n        const getState = g7?.getState as (() => Record<string, unknown>) | undefined;\n        const ctx = getState?.()?.currentDataContext as Record<string, unknown> | undefined;\n        const order = ctx?.order as { data?: OrderData } | undefined;\n        const data = order?.data;\n        if (!data || data.order_number !== orderNumber) return null;\n        return data;\n    } catch {\n        return null;\n    }\n}\n\nfunction getToken(): string | null {\n    return localStorage.getItem('auth_token');\n}\n\ninterface ReceiptInfo {\n    receipt_url?: string;\n    cash_receipt_url?: string | null;\n    payment_method_display_label?: string | null;\n}\n\nasync function fetchReceiptUrls(orderNumber: string): Promise<ReceiptInfo | null> {\n    const token = getToken();\n    if (!token) return null;\n    try {\n        const res = await fetch(`/api/plugins/${PLUGIN_ID}/user/orders/${orderNumber}/receipt`, {\n            headers: { Authorization: `Bearer ${token}`, Accept: 'application/json' },\n        });\n        if (!res.ok) return null;\n        return (await res.json()) as ReceiptInfo;\n    } catch {\n        return null;\n    }\n}\n\ninterface MockDepositInfo {\n    available: boolean;\n    trade_no?: string;\n    account_no?: string;\n    notify_url?: string;\n    mock_url?: string;\n    is_admin_view?: boolean;\n}\n\nasync function fetchMockDepositInfo(orderNumber: string): Promise<MockDepositInfo | null> {\n    const token = getToken();\n    if (!token) return null;\n    try {\n        const res = await fetch(`/api/plugins/${PLUGIN_ID}/user/orders/${orderNumber}/vbank-mock-deposit-info`, {\n            headers: { Authorization: `Bearer ${token}`, Accept: 'application/json' },\n        });\n        if (!res.ok) return null;\n        return (await res.json()) as MockDepositInfo;\n    } catch {\n        return null;\n    }\n}\n\nfunction buildMockDepositBlock(info: MockDepositInfo): HTMLElement {\n    const wrap = document.createElement('div');\n    wrap.id = MOCK_DEPOSIT_ID;\n    wrap.className = 'pt-4 mt-2 border-t border-dashed border-orange-300 dark:border-orange-700';\n\n    const header = document.createElement('div');\n    header.className = 'flex items-center gap-2 mb-3';\n\n    const badge = document.createElement('span');\n    badge.className = 'inline-flex items-center px-2 py-0.5 rounded text-xs font-bold bg-orange-100 text-orange-700 dark:bg-orange-900/40 dark:text-orange-300 border border-orange-300 dark:border-orange-700';\n    badge.textContent = 'TEST';\n\n    const title = document.createElement('p');\n    title.className = 'text-sm font-semibold text-orange-700 dark:text-orange-300';\n    title.textContent = '모의입금처리';\n\n    header.appendChild(badge);\n    header.appendChild(title);\n\n    const form = document.createElement('form');\n    form.method = 'POST';\n    form.action = info.mock_url ?? '';\n    form.target = '_blank';\n    form.className = 'space-y-2';\n\n    const fields: Array<{ label: string; name: string; value: string; editable?: boolean }> = [\n        { label: 'KCP 거래번호', name: 'e_trade_no', value: info.trade_no ?? '' },\n        { label: '입금계좌',    name: 'deposit_no',  value: info.account_no ?? '' },\n        { label: '입금자명',    name: 'req_name',    value: 'NHN KCP', editable: true },\n        { label: '입금통보 URL', name: 'noti_url',   value: info.notify_url ?? '' },\n    ];\n\n    for (const f of fields) {\n        const row = document.createElement('div');\n        row.className = 'flex items-center gap-2 text-sm';\n\n        const lbl = document.createElement('span');\n        lbl.className = 'w-28 flex-shrink-0 text-gray-500 dark:text-gray-400 text-xs';\n        lbl.textContent = f.label;\n\n        const input = document.createElement('input');\n        input.type = 'text';\n        input.name = f.name;\n        input.value = f.value;\n        input.readOnly = !f.editable;\n        input.className = f.editable\n            ? 'flex-1 px-2 py-1 text-xs border border-gray-300 dark:border-gray-600 rounded bg-white dark:bg-gray-700 text-gray-900 dark:text-white font-mono'\n            : 'flex-1 px-2 py-1 text-xs border border-gray-200 dark:border-gray-700 rounded bg-gray-50 dark:bg-gray-800 text-gray-700 dark:text-gray-300 font-mono';\n\n        row.appendChild(lbl);\n        row.appendChild(input);\n        form.appendChild(row);\n    }\n\n    const submitRow = document.createElement('div');\n    submitRow.className = 'pt-1';\n\n    const btn = document.createElement('button');\n    btn.type = 'submit';\n    btn.className = 'w-full py-1.5 text-xs font-semibold rounded border border-orange-400 dark:border-orange-600 bg-orange-50 dark:bg-orange-900/30 text-orange-700 dark:text-orange-300 hover:bg-orange-100 dark:hover:bg-orange-900/50 transition-colors';\n    btn.textContent = '입금통보 테스트';\n\n    submitRow.appendChild(btn);\n    form.appendChild(submitRow);\n\n    wrap.appendChild(header);\n    wrap.appendChild(form);\n\n    if (info.is_admin_view) {\n        const adminNotice = document.createElement('p');\n        adminNotice.className = 'mt-2 text-xs text-center text-orange-500 dark:text-orange-400 font-medium';\n        adminNotice.textContent = '관리자에게만 출력되는 내용';\n        wrap.appendChild(adminNotice);\n    }\n\n    return wrap;\n}\n\nfunction findPaymentRowsContainer(): Element | null {\n    const panel = document.getElementById('order_payment_info_panel');\n    if (panel) {\n        const spaceY = Array.from(panel.children).find(el => el.className?.includes('space-y'));\n        return spaceY ?? panel;\n    }\n\n    // \"결제 정보\" 헤딩 탐색\n    const h3 = Array.from(document.querySelectorAll<HTMLElement>('h3')).find(\n        el => el.textContent?.includes('결제 정보'),\n    );\n    if (!h3) return null;\n\n    const panelDiv = h3.parentElement?.parentElement;\n    if (!panelDiv) return null;\n\n    const spaceY = Array.from(panelDiv.children).find(el => el.className?.includes('space-y'));\n    return spaceY ?? panelDiv;\n}\n\n// 라벨 + 값 행 생성 헬퍼\nfunction makeInfoRow(label: string, value: string, valueClass = 'font-medium text-gray-900 dark:text-white'): HTMLElement {\n    const row = document.createElement('div');\n    row.className = 'flex items-center justify-between text-sm';\n\n    const lbl = document.createElement('span');\n    lbl.className = 'text-gray-500 dark:text-gray-400';\n    lbl.textContent = label;\n\n    const val = document.createElement('span');\n    val.className = valueClass;\n    val.textContent = value;\n\n    row.appendChild(lbl);\n    row.appendChild(val);\n    return row;\n}\n\nexport function patchMypagePaymentMethodDisplay(container: Element, displayLabel: string | null | undefined): boolean {\n    if (!displayLabel) return false;\n\n    const rows = Array.from(container.querySelectorAll<HTMLElement>('div'));\n    for (const row of rows) {\n        const spans = Array.from(row.children).filter(\n            (child): child is HTMLElement => child instanceof HTMLElement && child.tagName === 'SPAN',\n        );\n        if (spans.length < 2) continue;\n\n        const label = spans[0].textContent?.trim();\n        if (label !== '결제 방법' && label !== '결제수단' && label !== 'Payment Method') continue;\n\n        const value = spans[spans.length - 1];\n        if (value.textContent?.trim() === displayLabel) {\n            row.dataset.nhnkcpPaymentMethodRow = 'true';\n            return true;\n        }\n\n        value.textContent = displayLabel;\n        value.dataset.nhnkcpPaymentMethodPatched = 'true';\n        row.dataset.nhnkcpPaymentMethodRow = 'true';\n        return true;\n    }\n\n    return false;\n}\n\nfunction buildVbankInfoBlock(payment: Payment, totalAmountFormatted: string): HTMLElement {\n    const wrap = document.createElement('div');\n    wrap.id = VBANK_ID;\n    wrap.className = 'pt-4 mt-2 border-t border-gray-200 dark:border-gray-700 space-y-3';\n\n    const title = document.createElement('p');\n    title.className = 'text-sm font-semibold text-gray-800 dark:text-gray-200';\n    title.textContent = '가상계좌 입금 안내';\n\n    const rows = document.createElement('div');\n    rows.className = 'space-y-1.5';\n    rows.appendChild(makeInfoRow('은행', payment.vbank_name ?? ''));\n    rows.appendChild(makeInfoRow('계좌번호', payment.vbank_number ?? '', 'font-medium text-gray-900 dark:text-white font-mono tracking-wide'));\n    rows.appendChild(makeInfoRow('예금주', payment.vbank_holder ?? ''));\n    rows.appendChild(makeInfoRow('입금 금액', totalAmountFormatted));\n    if (payment.due_date_formatted) {\n        rows.appendChild(makeInfoRow('입금 기한', payment.due_date_formatted));\n    }\n\n    const notice = document.createElement('p');\n    notice.className = 'text-xs text-amber-600 dark:text-amber-400';\n    notice.textContent = '입금 기한 내에 입금하지 않으시면 주문이 자동 취소됩니다.';\n\n    wrap.appendChild(title);\n    wrap.appendChild(rows);\n    wrap.appendChild(notice);\n    return wrap;\n}\n\nfunction buildReceiptRow(orderNumber: string): HTMLElement {\n    const row = document.createElement('div');\n    row.id = ROW_ID;\n    row.className = 'pt-4 mt-2 border-t border-gray-200 dark:border-gray-700';\n\n    const inner = document.createElement('div');\n    inner.className = 'flex items-center justify-between';\n\n    const label = document.createElement('span');\n    label.className = 'text-gray-500 dark:text-gray-400 text-sm';\n    label.textContent = '영수증';\n\n    const btn = document.createElement('button');\n    btn.type = 'button';\n    btn.className = 'inline-flex items-center gap-1 text-sm text-blue-600 dark:text-blue-400 hover:underline disabled:opacity-50';\n    btn.textContent = '영수증 조회';\n\n    btn.addEventListener('click', async () => {\n        btn.disabled = true;\n        btn.textContent = '로딩 중...';\n        const data = await fetchReceiptUrls(orderNumber);\n        btn.disabled = false;\n        btn.textContent = '영수증 조회';\n        if (data) {\n            const KcpPopup = (window as unknown as Record<string, unknown>).KcpReceiptPopup as\n                (new (p: { url?: string; cash_url?: string }) => unknown) | undefined;\n            if (KcpPopup) {\n                new KcpPopup({ url: data.receipt_url, cash_url: data.cash_receipt_url });\n            }\n        }\n    });\n\n    inner.appendChild(label);\n    inner.appendChild(btn);\n    row.appendChild(inner);\n    return row;\n}\n\nasync function tryInject(orderNumber: string): Promise<boolean> {\n    const orderData = getOrderFromState(orderNumber);\n\n    if (!orderData) {\n        // ctx.order가 null — 관리자가 타인 주문 열람 시 mypage API 404로 상태 없음.\n        // 컨테이너가 렌더링됐으면 모의입금 API만 직접 시도 후 종료.\n        if (!document.getElementById(MOCK_DEPOSIT_ID)) {\n            const container = findPaymentRowsContainer();\n            if (!container) return false; // 컨테이너 미렌더링 → 재시도\n            const info = await fetchMockDepositInfo(orderNumber);\n            if (info?.available) {\n                container.appendChild(buildMockDepositBlock(info));\n                console.info(`[${PLUGIN_ID}] mock deposit form injected on mypage order show`);\n            }\n        }\n        return true;\n    }\n\n    const { payment } = orderData;\n    if (!payment || payment.pg_provider !== 'nhnkcp') return true; // nhnkcp 아님\n\n    const needsVbank = payment.payment_method === 'vbank' && !!payment.vbank_name;\n    // 영수증 버튼은 결제완료(paid_at 채워짐) 시점에만 표시 — 가상계좌 입금대기 상태 차단\n    const needsReceipt = !!payment.transaction_id && !!payment.paid_at;\n    // 가상계좌 계좌번호가 발급된 경우 API로 모의입금 가능 여부 확인 (tno는 서버에서 fallback)\n    const mightNeedMock = payment.payment_method === 'vbank' && !!payment.vbank_number;\n\n    const vbankDone    = !needsVbank    || !!document.getElementById(VBANK_ID);\n    const receiptDone  = !needsReceipt  || !!document.getElementById(ROW_ID);\n    // 모의입금은 API 결과에 따라 달라지므로 DOM에 없으면 매번 체크\n    const mockDone     = !mightNeedMock || !!document.getElementById(MOCK_DEPOSIT_ID);\n\n    if (vbankDone && receiptDone && mockDone) return true;\n\n    const container = findPaymentRowsContainer();\n    if (!container) return false; // DOM 미렌더링 → 재시도\n\n    const receiptInfo = needsReceipt ? await fetchReceiptUrls(orderNumber) : null;\n    const displayPatched = patchMypagePaymentMethodDisplay(\n        container,\n        receiptInfo?.payment_method_display_label,\n    );\n\n    if (!document.getElementById(VBANK_ID) && needsVbank) {\n        container.appendChild(buildVbankInfoBlock(payment, orderData.total_amount_formatted ?? ''));\n        console.info(`[${PLUGIN_ID}] vbank info injected on mypage order show`);\n        return false;\n    }\n\n    if (!document.getElementById(ROW_ID) && needsReceipt) {\n        container.appendChild(buildReceiptRow(orderNumber));\n        console.info(`[${PLUGIN_ID}] receipt button injected on mypage order show`);\n        return false;\n    }\n\n    if (displayPatched) {\n        console.info(`[${PLUGIN_ID}] payment method display patched on mypage order show`);\n    }\n\n    if (!document.getElementById(MOCK_DEPOSIT_ID) && mightNeedMock) {\n        const info = await fetchMockDepositInfo(orderNumber);\n        if (info?.available) {\n            container.appendChild(buildMockDepositBlock(info));\n            console.info(`[${PLUGIN_ID}] mock deposit form injected on mypage order show`);\n        } else {\n            // 테스트 모드 아님 or 조건 불충족 — 더 이상 시도 불필요\n            return true;\n        }\n    }\n\n    return true;\n}\n\nfunction startPolling(orderNumber: string): void {\n    let attempts = 0;\n    const id = setInterval(() => {\n        attempts++;\n        void tryInject(orderNumber).then(done => {\n            if (done || attempts >= 30) clearInterval(id);\n        });\n    }, 400);\n}\n\nfunction onRouteChange(): void {\n    const match = location.pathname.match(ORDER_SHOW_RE);\n    if (match) startPolling(match[1]);\n}\n\nexport function installMypageOrderShowInjector(): void {\n    if (typeof window === 'undefined') return;\n    const w = window as unknown as Record<string, unknown>;\n    if (w[FLAG]) return;\n    w[FLAG] = true;\n\n    console.info(`[${PLUGIN_ID}] mypage order show injector installed`);\n\n    const schedule = (delay = 1500) => setTimeout(onRouteChange, delay);\n\n    if (document.readyState === 'loading') {\n        document.addEventListener('DOMContentLoaded', () => schedule());\n    } else {\n        schedule();\n    }\n\n    const origPush = history.pushState.bind(history);\n    history.pushState = (...args: Parameters<typeof history.pushState>) => {\n        origPush(...args);\n        schedule(600);\n    };\n    window.addEventListener('popstate', () => schedule(500));\n}\n","import {\n    isIosMobileDevice,\n    isNhnKcpApplePayMethod,\n} from './support/applePayDevice';\n\nconst PLUGIN_ID = 'sirsoft-pay_nhnkcp';\nconst FLAG = '__kcpCheckoutEasyPayInjectorInstalled';\nconst CHECKOUT_RE = /^\\/shop\\/checkout\\/?$/;\nconst LISTENER_FLAG = '__kcpCheckoutEasyPaySyncListenerAttached';\nconst SYNC_RETRY_INTERVAL_MS = 200;\nconst SYNC_RETRY_ATTEMPTS = 120;\n\ninterface EasyPayCopy {\n    heading: string;\n    description: string;\n    title: string;\n}\n\ninterface EasyPayDefinition {\n    id: string;\n    configKey: string;\n    labels: string[];\n    ko: EasyPayCopy;\n    en: EasyPayCopy;\n    markText: string;\n    markClassName: string;\n}\n\nconst EASY_PAY_DEFINITIONS: EasyPayDefinition[] = [\n    {\n        id: 'nhnkcp_payco',\n        configKey: 'PAYCO',\n        labels: ['PAYCO (NHN KCP)', 'PAYCO NHN KCP 간편결제', 'PAYCO로 결제 (NHN KCP)', 'Pay with PAYCO (NHN KCP)'],\n        ko: {\n            heading: 'PAYCO',\n            description: 'PAYCO로 결제 (NHN KCP)',\n            title: 'PAYCO로 결제 (NHN KCP)',\n        },\n        en: {\n            heading: 'PAYCO',\n            description: 'Pay with PAYCO (NHN KCP)',\n            title: 'Pay with PAYCO (NHN KCP)',\n        },\n        markText: 'P',\n        markClassName: 'bg-red-500 text-white',\n    },\n    {\n        id: 'nhnkcp_naverpay',\n        configKey: 'NAVERPAY',\n        labels: ['네이버페이 (NHN KCP)', '네이버페이 신용카드로 결제 (NHN KCP)', 'NaverPay NHN KCP 간편결제', 'Naver Pay (NHN KCP)', 'NaverPay (NHN KCP)', 'Pay by Naver Pay credit card (NHN KCP)'],\n        ko: {\n            heading: '네이버페이 (카드)',\n            description: '네이버페이 신용카드로 결제 (NHN KCP)',\n            title: '네이버페이 신용카드로 결제 (NHN KCP)',\n        },\n        en: {\n            heading: 'Naver Pay (Card)',\n            description: 'Pay by Naver Pay credit card (NHN KCP)',\n            title: 'Pay by Naver Pay credit card (NHN KCP)',\n        },\n        markText: 'N',\n        markClassName: 'bg-green-500 text-white',\n    },\n    {\n        id: 'nhnkcp_naverpay_point',\n        configKey: 'NAVERPAY POINT',\n        labels: ['네이버페이 포인트 (NHN KCP)', '네이버페이 머니/포인트로 결제 (NHN KCP)', 'NaverPay 포인트 NHN KCP 포인트 간편결제', 'Naver Pay Point (NHN KCP)', 'NaverPay Point (NHN KCP)', 'Pay with Naver Pay Money/Points (NHN KCP)'],\n        ko: {\n            heading: '네이버페이 (포인트)',\n            description: '네이버페이 머니/포인트로 결제 (NHN KCP)',\n            title: '네이버페이 머니/포인트로 결제 (NHN KCP)',\n        },\n        en: {\n            heading: 'Naver Pay (Point)',\n            description: 'Pay with Naver Pay Money/Points (NHN KCP)',\n            title: 'Pay with Naver Pay Money/Points (NHN KCP)',\n        },\n        markText: 'NP',\n        markClassName: 'bg-green-600 text-white',\n    },\n    {\n        id: 'nhnkcp_kakaopay',\n        configKey: 'KAKAOPAY',\n        labels: ['카카오페이 (NHN KCP)', '카카오페이로 결제 (NHN KCP)', 'KakaoPay NHN KCP 간편결제', 'Kakao Pay (NHN KCP)', 'KakaoPay (NHN KCP)', 'Pay with Kakao Pay (NHN KCP)'],\n        ko: {\n            heading: '카카오페이',\n            description: '카카오페이로 결제 (NHN KCP)',\n            title: '카카오페이로 결제 (NHN KCP)',\n        },\n        en: {\n            heading: 'Kakao Pay',\n            description: 'Pay with Kakao Pay (NHN KCP)',\n            title: 'Pay with Kakao Pay (NHN KCP)',\n        },\n        markText: 'K',\n        markClassName: 'bg-yellow-400 text-gray-950',\n    },\n    {\n        id: 'nhnkcp_applepay',\n        configKey: 'APPLEPAY',\n        labels: ['애플페이 (NHN KCP)', '애플페이로 결제 (NHN KCP)', 'Apple Pay NHN KCP 간편결제', 'Apple Pay (NHN KCP)', 'Pay with Apple Pay (NHN KCP)'],\n        ko: {\n            heading: '애플페이',\n            description: '애플페이로 결제 (NHN KCP)',\n            title: '애플페이로 결제 (NHN KCP)',\n        },\n        en: {\n            heading: 'Apple Pay',\n            description: 'Pay with Apple Pay (NHN KCP)',\n            title: 'Pay with Apple Pay (NHN KCP)',\n        },\n        markText: 'A',\n        markClassName: 'bg-gray-900 text-white',\n    },\n];\n\nlet observer: MutationObserver | null = null;\nlet retryTimer: number | null = null;\nlet syncQueued = false;\n\nfunction windowRecord(): Record<string, unknown> {\n    return window as unknown as Record<string, unknown>;\n}\n\nfunction isCheckoutPage(): boolean {\n    return CHECKOUT_RE.test(window.location.pathname);\n}\n\nfunction normalizedText(value: string | null | undefined): string {\n    return (value ?? '').replace(/\\s+/g, ' ').trim();\n}\n\nfunction isKoreanPage(): boolean {\n    const lang = document.documentElement.lang || navigator.language || '';\n\n    return lang.toLowerCase().startsWith('ko');\n}\n\nfunction copyFor(definition: EasyPayDefinition): EasyPayCopy {\n    return isKoreanPage() ? definition.ko : definition.en;\n}\n\nfunction displayText(value: string): string {\n    return value\n        .replaceAll('네이버페이', '네이\\u200B버페이')\n        .replaceAll('카카오페이', '카카\\u200B오페이')\n        .replaceAll('Naver Pay', 'Naver\\u200B Pay')\n        .replaceAll('Kakao Pay', 'Kakao\\u200B Pay');\n}\n\nfunction findDefinitionById(id: string | undefined): EasyPayDefinition | null {\n    return EASY_PAY_DEFINITIONS.find((definition) => definition.id === id) ?? null;\n}\n\nfunction findDefinitionForButton(button: HTMLButtonElement): EasyPayDefinition | null {\n    const markedDefinition = findDefinitionById(button.dataset.nhnkcpEasyPayMethod);\n    if (markedDefinition) return markedDefinition;\n\n    const text = normalizedText(button.textContent);\n\n    return EASY_PAY_DEFINITIONS.find((definition) => (\n        definition.labels.some((label) => text.includes(label))\n    )) ?? null;\n}\n\nfunction findPaymentRow(button: HTMLButtonElement): HTMLElement | null {\n    return button.querySelector<HTMLElement>('.flex.items-center.gap-2, .flex.items-center.gap-3')\n        ?? button.querySelector<HTMLElement>('.flex.items-center');\n}\n\nfunction alignPaymentTextLeft(button: HTMLButtonElement, heading?: HTMLElement, description?: HTMLElement): void {\n    button.style.textAlign = 'left';\n\n    const row = findPaymentRow(button);\n    if (row) {\n        row.style.justifyContent = 'flex-start';\n        row.style.textAlign = 'left';\n        row.style.width = '100%';\n    }\n\n    const textContainer = heading?.parentElement ?? description?.parentElement;\n    if (textContainer instanceof HTMLElement) {\n        textContainer.style.textAlign = 'left';\n        textContainer.style.minWidth = '0';\n    }\n}\n\nfunction createMark(definition: EasyPayDefinition): HTMLSpanElement {\n    const mark = document.createElement('span');\n    mark.dataset.nhnkcpEasyPayMark = 'true';\n    mark.dataset.nhnkcpEasyPayMethod = definition.id;\n    mark.setAttribute('aria-hidden', 'true');\n    mark.className = `inline-flex items-center justify-center rounded-lg text-xs font-bold ${definition.markClassName}`;\n    mark.style.width = '32px';\n    mark.style.height = '32px';\n    mark.style.flex = '0 0 32px';\n    mark.textContent = definition.markText;\n\n    return mark;\n}\n\nfunction removeKginicisBrandArtifacts(button: HTMLButtonElement): void {\n    delete button.dataset.kginicisBrandPaymentButton;\n    delete button.dataset.kginicisBrandPaymentMethod;\n    delete button.dataset.kginicisNaverpayBrandButton;\n\n    button.querySelectorAll<HTMLElement>('[data-kginicis-brand-payment-mark=\"true\"], [data-kginicis-naverpay-mark=\"true\"]').forEach((element) => {\n        element.remove();\n    });\n\n    button.querySelectorAll<HTMLElement>('[data-kginicis-brand-payment-heading], [data-kginicis-brand-payment-description], [data-kginicis-naverpay-heading], [data-kginicis-naverpay-description]').forEach((element) => {\n        delete element.dataset.kginicisBrandPaymentHeading;\n        delete element.dataset.kginicisBrandPaymentDescription;\n        delete element.dataset.kginicisNaverpayHeading;\n        delete element.dataset.kginicisNaverpayDescription;\n    });\n}\n\nfunction findPaymentIcon(button: HTMLButtonElement): Element | null {\n    return button.querySelector('[data-kginicis-brand-payment-mark=\"true\"], [data-kginicis-naverpay-mark=\"true\"]')\n        ?? button.querySelector('[data-nhnkcp-easy-pay-mark=\"true\"]')\n        ?? button.querySelector('svg')\n        ?? button.querySelector('i[class*=\"fa-\"], i[role=\"img\"], i');\n}\n\nfunction ensureMark(button: HTMLButtonElement, definition: EasyPayDefinition): void {\n    const existingMark = button.querySelector<HTMLElement>('[data-nhnkcp-easy-pay-mark=\"true\"]');\n    if (existingMark) {\n        existingMark.dataset.nhnkcpEasyPayMethod = definition.id;\n        existingMark.className = `inline-flex items-center justify-center rounded-lg text-xs font-bold ${definition.markClassName}`;\n        existingMark.textContent = definition.markText;\n        return;\n    }\n\n    const mark = createMark(definition);\n    const icon = findPaymentIcon(button);\n    if (icon && icon.parentElement) {\n        icon.replaceWith(mark);\n        return;\n    }\n\n    const row = findPaymentRow(button);\n    row?.prepend(mark);\n}\n\nfunction updatePaymentText(button: HTMLButtonElement, definition: EasyPayDefinition): void {\n    const paragraphs = Array.from(button.querySelectorAll<HTMLParagraphElement>('p'));\n    const copy = copyFor(definition);\n    const headingText = displayText(copy.heading);\n    const descriptionText = displayText(copy.description);\n\n    const heading = paragraphs[0];\n    const description = paragraphs[1];\n\n    if (heading && heading.textContent !== headingText) {\n        heading.textContent = headingText;\n    }\n    if (heading) {\n        heading.setAttribute('aria-label', copy.heading);\n        heading.style.textAlign = 'left';\n        heading.style.whiteSpace = 'normal';\n        heading.style.wordBreak = 'keep-all';\n        heading.style.overflowWrap = 'anywhere';\n    }\n\n    if (description && description.textContent !== descriptionText) {\n        description.textContent = descriptionText;\n    }\n    if (description) {\n        description.style.textAlign = 'left';\n        description.style.fontSize = '12px';\n        description.style.lineHeight = '1rem';\n        description.style.whiteSpace = 'normal';\n        description.style.wordBreak = 'keep-all';\n        description.style.overflowWrap = 'anywhere';\n    }\n\n    alignPaymentTextLeft(button, heading, description);\n    button.title = copy.title;\n}\n\nfunction showButton(button: HTMLButtonElement, definition: EasyPayDefinition): void {\n    if (isNhnKcpApplePayMethod(definition.id) && !isIosMobileDevice()) {\n        button.hidden = true;\n        button.disabled = true;\n        button.style.display = 'none';\n        button.setAttribute('aria-hidden', 'true');\n        button.dataset.nhnkcpEasyPayMethod = definition.id;\n        button.dataset.nhnkcpEasyPayHidden = 'true';\n        delete button.dataset.nhnkcpEasyPayVisible;\n        return;\n    }\n\n    if (button.hidden) button.hidden = false;\n    if (button.disabled) button.disabled = false;\n    if (button.style.display === 'none') button.style.removeProperty('display');\n    button.removeAttribute('aria-hidden');\n    button.dataset.nhnkcpEasyPayMethod = definition.id;\n    button.dataset.nhnkcpEasyPayVisible = 'true';\n    delete button.dataset.nhnkcpEasyPayHidden;\n\n    removeKginicisBrandArtifacts(button);\n    ensureMark(button, definition);\n    updatePaymentText(button, definition);\n}\n\nfunction reconcileKginicisPatchedDuplicates(root: ParentNode): boolean {\n    const duplicateGroups: Record<string, string[]> = {\n        kginicis_naverpay: ['nhnkcp_naverpay', 'nhnkcp_naverpay_point'],\n        kginicis_kakaopay: ['nhnkcp_kakaopay'],\n    };\n    let changed = false;\n\n    Object.entries(duplicateGroups).forEach(([kginicisMethod, nhnkcpMethods]) => {\n        const buttons = Array.from(root.querySelectorAll<HTMLButtonElement>(`button[data-kginicis-brand-payment-method=\"${kginicisMethod}\"]`))\n            .filter((button) => !button.dataset.nhnkcpEasyPayMethod);\n\n        buttons.slice(1).forEach((button, index) => {\n            const definition = findDefinitionById(nhnkcpMethods[index]);\n            if (!definition) return;\n\n            showButton(button, definition);\n            changed = true;\n        });\n    });\n\n    return changed;\n}\n\nexport async function syncRenderedCheckoutEasyPayMethods(\n    root: ParentNode = document,\n): Promise<boolean> {\n    if (typeof window === 'undefined' || typeof document === 'undefined') return false;\n    if (!isCheckoutPage()) return false;\n\n    let changed = false;\n\n    root.querySelectorAll<HTMLButtonElement>('button').forEach((button) => {\n        const definition = findDefinitionForButton(button);\n        if (!definition) return;\n\n        showButton(button, definition);\n        changed = true;\n    });\n\n    if (reconcileKginicisPatchedDuplicates(root)) {\n        changed = true;\n    }\n\n    return changed;\n}\n\nfunction queueSync(): void {\n    if (syncQueued) return;\n    syncQueued = true;\n\n    window.setTimeout(() => {\n        syncQueued = false;\n        void syncRenderedCheckoutEasyPayMethods();\n    }, 0);\n}\n\nfunction stopRetries(): void {\n    if (retryTimer === null) return;\n\n    window.clearInterval(retryTimer);\n    retryTimer = null;\n}\n\nfunction startSync(): void {\n    if (!isCheckoutPage()) return;\n\n    stopRetries();\n    void syncRenderedCheckoutEasyPayMethods();\n\n    let attempts = 0;\n    retryTimer = window.setInterval(() => {\n        attempts += 1;\n        void syncRenderedCheckoutEasyPayMethods();\n\n        if (attempts >= SYNC_RETRY_ATTEMPTS) {\n            stopRetries();\n        }\n    }, SYNC_RETRY_INTERVAL_MS);\n\n    const body = document.body as HTMLElement & Record<string, unknown>;\n    if (body[LISTENER_FLAG]) return;\n    body[LISTENER_FLAG] = true;\n\n    observer = new MutationObserver(() => queueSync());\n    observer.observe(document.body, { childList: true, subtree: true, characterData: true });\n}\n\nfunction onRouteChange(): void {\n    if (isCheckoutPage()) startSync();\n}\n\nexport function installCheckoutEasyPayInjector(): void {\n    if (typeof window === 'undefined' || typeof document === 'undefined') return;\n    const w = windowRecord();\n    if (w[FLAG]) return;\n    w[FLAG] = true;\n\n    console.info(`[${PLUGIN_ID}] checkout easy pay method sync installed`);\n\n    if (document.readyState === 'loading') {\n        document.addEventListener('DOMContentLoaded', () => startSync());\n    } else {\n        startSync();\n    }\n\n    const origPush = history.pushState.bind(history);\n    history.pushState = (...args: Parameters<typeof history.pushState>) => {\n        origPush(...args);\n        window.setTimeout(() => onRouteChange(), 200);\n    };\n    window.addEventListener('popstate', () => window.setTimeout(() => onRouteChange(), 200));\n}\n\nexport function resetCheckoutEasyPayInjectorForTests(): void {\n    observer?.disconnect();\n    observer = null;\n    stopRetries();\n    syncQueued = false;\n    delete windowRecord()[FLAG];\n    if (document.body) {\n        delete ((document.body as HTMLElement & Record<string, unknown>)[LISTENER_FLAG]);\n    }\n}\n","const PLUGIN_ID = 'sirsoft-pay_nhnkcp';\nconst FLAG = '__kcpAdminApplePayNoticeInjectorInstalled';\nconst ADMIN_SETTINGS_RE = /^\\/admin\\/ecommerce\\/settings\\/?$/;\nconst LISTENER_FLAG = '__kcpAdminApplePayNoticeListenerAttached';\nconst NOTICE_KO = '애플페이는 IOS 기기에 모바일결제만 가능합니다.';\nconst NOTICE_EN = 'Apple Pay is available only for mobile payments on iOS devices.';\n\nlet observer: MutationObserver | null = null;\nlet retryTimer: number | null = null;\nlet syncQueued = false;\n\nfunction windowRecord(): Record<string, unknown> {\n    return window as unknown as Record<string, unknown>;\n}\n\nfunction isOrderSettingsPage(): boolean {\n    if (!ADMIN_SETTINGS_RE.test(window.location.pathname)) return false;\n\n    const tab = new URLSearchParams(window.location.search).get('tab');\n    return tab === null || tab === 'order_settings';\n}\n\nfunction noticeText(): string {\n    const lang = document.documentElement.lang || navigator.language || '';\n\n    return lang.toLowerCase().startsWith('ko') ? NOTICE_KO : NOTICE_EN;\n}\n\nfunction normalizedText(value: string | null | undefined): string {\n    return (value ?? '').replace(/\\s+/g, ' ').trim();\n}\n\nfunction isApplePayLabel(element: HTMLElement): boolean {\n    const text = normalizedText(element.textContent);\n\n    return text === '애플페이' || text === 'Apple Pay';\n}\n\nfunction createNotice(): HTMLSpanElement {\n    const notice = document.createElement('span');\n    notice.dataset.nhnkcpAdminApplePayNotice = 'true';\n    notice.className = 'text-label-subtle';\n    notice.style.display = 'block';\n    notice.style.width = '100%';\n    notice.style.flexBasis = '100%';\n    notice.style.marginTop = '2px';\n    notice.style.fontSize = '12px';\n    notice.style.lineHeight = '1rem';\n    notice.textContent = noticeText();\n\n    return notice;\n}\n\nexport function patchAdminApplePayNotice(root: ParentNode = document): boolean {\n    if (typeof window === 'undefined' || typeof document === 'undefined') return false;\n    if (!isOrderSettingsPage()) return false;\n    const bodyText = normalizedText(document.body?.innerText ?? document.body?.textContent);\n    if (bodyText.includes(noticeText())) return false;\n\n    const applePayLabel = Array.from(root.querySelectorAll<HTMLElement>('span, p, div'))\n        .find(isApplePayLabel);\n    if (!applePayLabel) return false;\n\n    applePayLabel.insertAdjacentElement('afterend', createNotice());\n    return true;\n}\n\nfunction queueSync(): void {\n    if (syncQueued) return;\n    syncQueued = true;\n\n    window.setTimeout(() => {\n        syncQueued = false;\n        patchAdminApplePayNotice();\n    }, 0);\n}\n\nfunction stopRetries(): void {\n    if (retryTimer === null) return;\n\n    window.clearInterval(retryTimer);\n    retryTimer = null;\n}\n\nfunction startSync(): void {\n    if (!isOrderSettingsPage()) return;\n\n    stopRetries();\n    patchAdminApplePayNotice();\n\n    let attempts = 0;\n    retryTimer = window.setInterval(() => {\n        attempts += 1;\n        if (patchAdminApplePayNotice() || attempts >= 50) {\n            stopRetries();\n        }\n    }, 200);\n\n    const body = document.body as HTMLElement & Record<string, unknown>;\n    if (body[LISTENER_FLAG]) return;\n    body[LISTENER_FLAG] = true;\n\n    observer = new MutationObserver(() => queueSync());\n    observer.observe(document.body, { childList: true, subtree: true, characterData: true });\n}\n\nfunction onRouteChange(): void {\n    if (isOrderSettingsPage()) startSync();\n}\n\nexport function installAdminApplePayNoticeInjector(): void {\n    if (typeof window === 'undefined' || typeof document === 'undefined') return;\n    const w = windowRecord();\n    if (w[FLAG]) return;\n    w[FLAG] = true;\n\n    console.info(`[${PLUGIN_ID}] admin Apple Pay notice injector installed`);\n\n    if (document.readyState === 'loading') {\n        document.addEventListener('DOMContentLoaded', () => startSync());\n    } else {\n        startSync();\n    }\n\n    const origPush = history.pushState.bind(history);\n    history.pushState = (...args: Parameters<typeof history.pushState>) => {\n        origPush(...args);\n        window.setTimeout(() => onRouteChange(), 200);\n    };\n    window.addEventListener('popstate', () => window.setTimeout(() => onRouteChange(), 200));\n}\n\nexport function resetAdminApplePayNoticeInjectorForTests(): void {\n    observer?.disconnect();\n    observer = null;\n    stopRetries();\n    syncQueued = false;\n    delete windowRecord()[FLAG];\n    if (document.body) {\n        delete ((document.body as HTMLElement & Record<string, unknown>)[LISTENER_FLAG]);\n    }\n}\n","const PLUGIN_ID = 'sirsoft-pay_nhnkcp';\nconst FLAG = '__nhnkcpAdminPaymentMethodBrandInjectorInstalled';\nconst LISTENER_FLAG = '__nhnkcpAdminPaymentMethodBrandSyncListenerAttached';\nconst ADMIN_SETTINGS_RE = /^\\/admin\\/ecommerce\\/settings\\/?$/;\nconst MARK_SELECTOR = '[data-nhnkcp-admin-payment-brand-mark=\"true\"]';\nconst SYNC_RETRY_INTERVAL_MS = 200;\nconst SYNC_RETRY_ATTEMPTS = 120;\n\ninterface AdminPaymentBrandDefinition {\n    id: string;\n    labels: string[];\n    shortLabels: string[];\n    markLines: string[];\n    markClassName: string;\n}\n\nconst ADMIN_PAYMENT_BRAND_DEFINITIONS: AdminPaymentBrandDefinition[] = [\n    {\n        id: 'nhnkcp_payco',\n        labels: ['PAYCO (NHN KCP)', 'PAYCO로 결제 (NHN KCP)', 'Pay with PAYCO (NHN KCP)'],\n        shortLabels: ['PAYCO'],\n        markLines: ['P'],\n        markClassName: 'bg-red-500 text-white',\n    },\n    {\n        id: 'nhnkcp_naverpay',\n        labels: ['네이버페이 (NHN KCP)', '네이버페이 신용카드로 결제 (NHN KCP)', 'Naver Pay (NHN KCP)', 'Pay by Naver Pay credit card (NHN KCP)'],\n        shortLabels: ['네이버페이 (카드)', 'Naver Pay (Card)'],\n        markLines: ['N'],\n        markClassName: 'bg-green-500 text-white',\n    },\n    {\n        id: 'nhnkcp_naverpay_point',\n        labels: ['네이버페이 포인트 (NHN KCP)', '네이버페이 머니/포인트로 결제 (NHN KCP)', 'Naver Pay Point (NHN KCP)', 'Pay with Naver Pay Money/Points (NHN KCP)'],\n        shortLabels: ['네이버페이 (포인트)', 'Naver Pay (Point)'],\n        markLines: ['NP'],\n        markClassName: 'bg-green-600 text-white',\n    },\n    {\n        id: 'nhnkcp_kakaopay',\n        labels: ['카카오페이 (NHN KCP)', '카카오페이로 결제 (NHN KCP)', 'Kakao Pay (NHN KCP)', 'Pay with Kakao Pay (NHN KCP)'],\n        shortLabels: ['카카오페이', 'Kakao Pay'],\n        markLines: ['K'],\n        markClassName: 'bg-yellow-400 text-gray-950',\n    },\n    {\n        id: 'nhnkcp_applepay',\n        labels: ['애플페이 (NHN KCP)', '애플페이로 결제 (NHN KCP)', 'Apple Pay (NHN KCP)', 'Pay with Apple Pay (NHN KCP)'],\n        shortLabels: ['애플페이', 'Apple Pay'],\n        markLines: ['A'],\n        markClassName: 'bg-gray-900 text-white',\n    },\n];\n\nlet observer: MutationObserver | null = null;\nlet retryTimer: number | null = null;\nlet syncQueued = false;\n\nfunction windowRecord(): Record<string, unknown> {\n    return window as unknown as Record<string, unknown>;\n}\n\nfunction isOrderSettingsPage(): boolean {\n    if (!ADMIN_SETTINGS_RE.test(window.location.pathname)) return false;\n\n    const tab = new URLSearchParams(window.location.search).get('tab');\n    return tab === null || tab === '' || tab === 'order_settings';\n}\n\nfunction classNameOf(element: Element): string {\n    return element instanceof HTMLElement ? element.className : '';\n}\n\nfunction comparableText(value: string | null | undefined): string {\n    return (value ?? '')\n        .replace(/\\u200B/g, '')\n        .replace(/\\s+/g, ' ')\n        .trim();\n}\n\nfunction isPaymentMethodItem(element: HTMLElement): boolean {\n    const className = classNameOf(element);\n\n    return className.includes('excel-card')\n        || (className.includes('flex-center') && className.includes('border') && className.includes('gap-4'));\n}\n\nfunction findTitleElement(item: HTMLElement): HTMLElement | null {\n    return item.querySelector<HTMLElement>('.font-medium');\n}\n\nfunction findDefinitionForItem(item: HTMLElement): AdminPaymentBrandDefinition | null {\n    const title = comparableText(findTitleElement(item)?.textContent);\n    const text = comparableText(item.textContent);\n\n    return ADMIN_PAYMENT_BRAND_DEFINITIONS.find((definition) => (\n        definition.shortLabels.some((label) => title === label)\n        || definition.labels.some((label) => text.includes(label))\n    )) ?? null;\n}\n\nfunction findPaymentMethodItems(root: ParentNode): HTMLElement[] {\n    return Array.from(root.querySelectorAll<HTMLElement>('div'))\n        .filter(isPaymentMethodItem);\n}\n\nfunction findPaymentIcon(item: HTMLElement): Element | null {\n    const icons = Array.from(item.querySelectorAll<Element>('svg, [data-icon], i'));\n\n    return icons.find((element) => (\n        !element.closest('[data-drag-handle]')\n        && !element.closest(MARK_SELECTOR)\n        && !element.closest('.row-stack, .excel-card-body, button, select, [role=\"switch\"]')\n    )) ?? null;\n}\n\nfunction applyBrandMarkContent(mark: HTMLSpanElement, definition: AdminPaymentBrandDefinition): void {\n    mark.dataset.nhnkcpAdminPaymentBrandMark = 'true';\n    mark.dataset.nhnkcpAdminPaymentMethod = definition.id;\n    mark.setAttribute('aria-hidden', 'true');\n    mark.className = `inline-flex items-center justify-center rounded-lg font-bold ${definition.markClassName}`;\n    mark.style.width = '32px';\n    mark.style.height = '32px';\n    mark.style.flex = '0 0 32px';\n    mark.style.lineHeight = '1';\n    mark.style.fontSize = definition.markLines.join('').length > 2 ? '9px' : '12px';\n\n    const expectedText = definition.markLines.join('');\n    if (mark.textContent === expectedText) return;\n\n    mark.replaceChildren();\n    if (definition.markLines.length > 1) {\n        mark.style.flexDirection = 'column';\n        definition.markLines.forEach((line) => {\n            const lineElement = document.createElement('span');\n            lineElement.style.lineHeight = '1';\n            lineElement.textContent = line;\n            mark.appendChild(lineElement);\n        });\n    } else {\n        mark.style.removeProperty('flex-direction');\n        mark.textContent = definition.markLines[0] ?? '';\n    }\n}\n\nfunction createBrandMark(definition: AdminPaymentBrandDefinition): HTMLSpanElement {\n    const mark = document.createElement('span');\n    applyBrandMarkContent(mark, definition);\n\n    return mark;\n}\n\nfunction syncBrandMark(item: HTMLElement, definition: AdminPaymentBrandDefinition): boolean {\n    const existing = item.querySelector<HTMLElement>(MARK_SELECTOR);\n    if (existing instanceof HTMLSpanElement) {\n        item.dataset.nhnkcpAdminPaymentMethod = definition.id;\n        applyBrandMarkContent(existing, definition);\n        return true;\n    }\n\n    const mark = createBrandMark(definition);\n    const icon = findPaymentIcon(item);\n    if (icon && icon.parentElement) {\n        item.dataset.nhnkcpAdminPaymentMethod = definition.id;\n        icon.replaceWith(mark);\n        return true;\n    }\n\n    const title = findTitleElement(item);\n    if (title && title.parentElement) {\n        item.dataset.nhnkcpAdminPaymentMethod = definition.id;\n        title.parentElement.insertBefore(mark, title);\n        return true;\n    }\n\n    return false;\n}\n\nexport function syncRenderedAdminPaymentMethodBrands(root: ParentNode = document): boolean {\n    if (typeof window === 'undefined' || typeof document === 'undefined') return false;\n    if (!isOrderSettingsPage()) return false;\n\n    let matched = false;\n\n    findPaymentMethodItems(root).forEach((item) => {\n        const definition = findDefinitionForItem(item);\n        if (!definition) return;\n\n        if (syncBrandMark(item, definition)) {\n            matched = true;\n        }\n    });\n\n    return matched;\n}\n\nfunction queueSync(): void {\n    if (syncQueued) return;\n    syncQueued = true;\n\n    window.setTimeout(() => {\n        syncQueued = false;\n        syncRenderedAdminPaymentMethodBrands();\n    }, 0);\n}\n\nfunction stopRetries(): void {\n    if (retryTimer === null) return;\n\n    window.clearInterval(retryTimer);\n    retryTimer = null;\n}\n\nfunction startSync(): void {\n    if (!isOrderSettingsPage()) return;\n\n    stopRetries();\n    syncRenderedAdminPaymentMethodBrands();\n\n    let attempts = 0;\n    retryTimer = window.setInterval(() => {\n        attempts += 1;\n        syncRenderedAdminPaymentMethodBrands();\n\n        if (attempts >= SYNC_RETRY_ATTEMPTS) {\n            stopRetries();\n        }\n    }, SYNC_RETRY_INTERVAL_MS);\n\n    const body = document.body as HTMLElement & Record<string, unknown>;\n    if (body[LISTENER_FLAG]) return;\n    body[LISTENER_FLAG] = true;\n\n    observer = new MutationObserver(() => queueSync());\n    observer.observe(document.body, { childList: true, subtree: true, characterData: true });\n}\n\nfunction onRouteChange(): void {\n    if (isOrderSettingsPage()) {\n        startSync();\n        return;\n    }\n\n    stopRetries();\n}\n\nexport function installAdminPaymentMethodBrandInjector(): void {\n    if (typeof window === 'undefined' || typeof document === 'undefined') return;\n    const w = windowRecord();\n    if (w[FLAG]) return;\n    w[FLAG] = true;\n\n    console.info(`[${PLUGIN_ID}] admin payment method brand sync installed`);\n\n    if (document.readyState === 'loading') {\n        document.addEventListener('DOMContentLoaded', () => startSync());\n    } else {\n        startSync();\n    }\n\n    const origPush = history.pushState.bind(history);\n    history.pushState = (...args: Parameters<typeof history.pushState>) => {\n        origPush(...args);\n        window.setTimeout(() => onRouteChange(), 200);\n    };\n    window.addEventListener('popstate', () => window.setTimeout(() => onRouteChange(), 200));\n}\n\nexport function resetAdminPaymentMethodBrandInjectorForTests(): void {\n    observer?.disconnect();\n    observer = null;\n    stopRetries();\n    syncQueued = false;\n    delete windowRecord()[FLAG];\n    if (document.body) {\n        delete ((document.body as HTMLElement & Record<string, unknown>)[LISTENER_FLAG]);\n    }\n}\n","const PLUGIN_ID = 'sirsoft-pay_nhnkcp';\nconst FLAG = '__nhnkcpAdminPaymentDisplayInjectorInstalled';\n\nconst ADMIN_ORDER_SHOW_RE = /^\\/admin\\/ecommerce\\/orders\\/([^/]+)$/;\n\ninterface AdminTransactionStatus {\n    _pay_method_label?: string | null;\n    _base_pay_method_label?: string | null;\n    _embedded_pg_provider_label?: string | null;\n}\n\nfunction getToken(): string | null {\n    return localStorage.getItem('auth_token');\n}\n\nasync function fetchAdminTransactionStatus(orderNumber: string): Promise<AdminTransactionStatus | null> {\n    const token = getToken();\n    if (!token) return null;\n\n    try {\n        const res = await fetch(`/api/plugins/${PLUGIN_ID}/admin/orders/${orderNumber}/transaction-status`, {\n            headers: { Authorization: `Bearer ${token}`, Accept: 'application/json' },\n        });\n        if (!res.ok) return null;\n\n        const json = (await res.json()) as { data?: AdminTransactionStatus | null } | AdminTransactionStatus;\n        return ('data' in json ? json.data : json) ?? null;\n    } catch {\n        return null;\n    }\n}\n\nfunction directElementChildren(el: Element): HTMLElement[] {\n    return Array.from(el.children).filter(\n        (child): child is HTMLElement => child instanceof HTMLElement,\n    );\n}\n\nfunction patchLabeledPaymentMethod(root: Element, displayLabel: string): boolean {\n    let patched = false;\n\n    const rows = Array.from(root.querySelectorAll<HTMLElement>('div'));\n    for (const row of rows) {\n        const children = directElementChildren(row);\n        const labelIndex = children.findIndex(child => child.textContent?.trim() === '결제수단');\n        if (labelIndex < 0) continue;\n\n        const value = children\n            .slice(labelIndex + 1)\n            .find(child => child.textContent?.trim() && child.textContent.trim() !== '결제수단');\n        if (!value) continue;\n\n        const installment = children\n            .slice(labelIndex + 2)\n            .find(child => /^\\(.+\\)$/.test(child.textContent?.trim() ?? ''));\n        const installmentText = installment?.textContent?.trim().replace(/^\\(|\\)$/g, '') ?? '';\n        const nextDisplayLabel = installmentText && displayLabel.endsWith(')')\n            ? displayLabel.replace(/\\)$/, `, ${installmentText})`)\n            : displayLabel;\n\n        if (value.textContent?.trim() !== nextDisplayLabel) {\n            value.textContent = nextDisplayLabel;\n            value.dataset.nhnkcpPaymentMethodPatched = 'true';\n        }\n        row.dataset.nhnkcpPaymentMethodRow = 'admin-order';\n        if (installment && installmentText) {\n            installment.textContent = '';\n            installment.style.display = 'none';\n            installment.dataset.nhnkcpPaymentInstallmentHidden = 'true';\n        }\n        patched = true;\n    }\n\n    return patched;\n}\n\nfunction patchPaymentMethodBadge(root: Element, baseLabel: string, embeddedLabel: string): boolean {\n    const candidates = Array.from(root.querySelectorAll<HTMLElement>('span')).filter(\n        el => el.textContent?.trim() === baseLabel,\n    );\n\n    const badge = candidates.find(el => {\n        const className = typeof el.className === 'string' ? el.className : '';\n        return className.includes('rounded-full') || className.includes('font-medium');\n    });\n\n    if (!badge) return false;\n\n    badge.textContent = embeddedLabel;\n    badge.dataset.nhnkcpPaymentMethodPatched = 'true';\n    badge.dataset.nhnkcpPaymentMethodBadge = 'admin-order';\n    return true;\n}\n\nexport function patchAdminPaymentMethodDisplay(\n    root: Element,\n    status: AdminTransactionStatus | null | undefined,\n): boolean {\n    const displayLabel = status?._pay_method_label;\n    const embeddedLabel = status?._embedded_pg_provider_label;\n    const baseLabel = status?._base_pay_method_label;\n\n    if (!displayLabel || !embeddedLabel) return false;\n\n    const labeled = patchLabeledPaymentMethod(root, displayLabel);\n    const badge = baseLabel ? patchPaymentMethodBadge(root, baseLabel, embeddedLabel) : false;\n\n    return labeled || badge;\n}\n\nasync function tryInject(orderNumber: string): Promise<boolean> {\n    const root = document.getElementById('section_payment_info') ?? document.getElementById('payment_info_card');\n    if (!root) return false;\n\n    const status = await fetchAdminTransactionStatus(orderNumber);\n    if (!status) return true;\n\n    const patched = patchAdminPaymentMethodDisplay(root, status);\n    if (patched) {\n        console.info(`[${PLUGIN_ID}] payment method display patched on admin order detail`);\n    }\n\n    return true;\n}\n\nfunction startPolling(orderNumber: string): void {\n    let attempts = 0;\n    const id = setInterval(() => {\n        attempts++;\n        void tryInject(orderNumber).then(done => {\n            if (done || attempts >= 30) clearInterval(id);\n        });\n    }, 400);\n}\n\nfunction onRouteChange(): void {\n    const match = location.pathname.match(ADMIN_ORDER_SHOW_RE);\n    if (match) startPolling(match[1]);\n}\n\nexport function installAdminOrderPaymentDisplayInjector(): void {\n    if (typeof window === 'undefined') return;\n    const w = window as unknown as Record<string, unknown>;\n    if (w[FLAG]) return;\n    w[FLAG] = true;\n\n    console.info(`[${PLUGIN_ID}] admin order payment display injector installed`);\n\n    const schedule = (delay = 1500) => setTimeout(onRouteChange, delay);\n\n    if (document.readyState === 'loading') {\n        document.addEventListener('DOMContentLoaded', () => schedule());\n    } else {\n        schedule();\n    }\n\n    const origPush = history.pushState.bind(history);\n    history.pushState = (...args: Parameters<typeof history.pushState>) => {\n        origPush(...args);\n        schedule(600);\n    };\n    window.addEventListener('popstate', () => schedule(500));\n}\n","import { handlerMap } from './handlers';\nimport { installOrderResponseInterceptor } from './orderResponseInterceptor';\nimport { installOrderCompleteReceiptInjector } from './orderCompleteReceiptInjector';\nimport { installMypageOrderShowInjector } from './mypageOrderShowInjector';\nimport { installCheckoutEasyPayInjector } from './checkoutEasyPayInjector';\nimport { installAdminApplePayNoticeInjector } from './adminApplePayNoticeInjector';\nimport { installAdminPaymentMethodBrandInjector } from './adminPaymentMethodBrandInjector';\nimport { installAdminOrderPaymentDisplayInjector } from './adminOrderPaymentDisplayInjector';\n\nclass KcpReceiptPopup {\n    constructor(params: { url?: string; cash_url?: string }) {\n        const features = 'width=800,height=600,scrollbars=yes,resizable=yes,toolbar=no,menubar=no';\n        if (params.url) {\n            window.open(params.url, 'kcp_receipt', features);\n        }\n        if (params.cash_url) {\n            window.open(params.cash_url, 'kcp_cash_receipt', features);\n        }\n    }\n}\n(window as Record<string, unknown>).KcpReceiptPopup = KcpReceiptPopup;\n\nconst PLUGIN_IDENTIFIER = 'sirsoft-pay_nhnkcp';\n\nconst logger = {\n    info: (...args: unknown[]) => console.info(`[${PLUGIN_IDENTIFIER}]`, ...args),\n    warn: (...args: unknown[]) => console.warn(`[${PLUGIN_IDENTIFIER}]`, ...args),\n    error: (...args: unknown[]) => console.error(`[${PLUGIN_IDENTIFIER}]`, ...args),\n};\n\nfunction registerHandlers(): number {\n    const g7Core = (window as Record<string, unknown>).G7Core as Record<string, unknown> | undefined;\n\n    if (!g7Core) {\n        return 0;\n    }\n\n    const getDispatcher = g7Core.getActionDispatcher as (() => Record<string, unknown>) | undefined;\n\n    if (typeof getDispatcher !== 'function') {\n        return 0;\n    }\n\n    const dispatcher = getDispatcher() as Record<string, unknown> | undefined;\n\n    if (!dispatcher || typeof dispatcher.registerHandler !== 'function') {\n        return 0;\n    }\n\n    let count = 0;\n    for (const [name, handler] of Object.entries(handlerMap)) {\n        const fullName = `${PLUGIN_IDENTIFIER}.${name}`;\n        dispatcher.registerHandler(fullName, handler, {\n            category: 'plugin',\n            source: PLUGIN_IDENTIFIER,\n        });\n        count++;\n    }\n\n    return count;\n}\n\nfunction initPlugin(): void {\n    const doInit = () => {\n        const count = registerHandlers();\n\n        if (count > 0) {\n            logger.info(`${count} handler(s) registered`);\n            return;\n        }\n\n        let retries = 0;\n        const maxRetries = 50;\n        const interval = setInterval(() => {\n            retries++;\n            const result = registerHandlers();\n\n            if (result > 0) {\n                clearInterval(interval);\n                logger.info(`${result} handler(s) registered (after ${retries} retries)`);\n                return;\n            }\n\n            if (retries >= maxRetries) {\n                clearInterval(interval);\n                logger.warn('ActionDispatcher not available after timeout');\n            }\n        }, 100);\n    };\n\n    if (document.readyState === 'loading') {\n        document.addEventListener('DOMContentLoaded', doInit);\n    } else {\n        doInit();\n    }\n}\n\ninstallOrderResponseInterceptor();\ninstallOrderCompleteReceiptInjector();\ninstallMypageOrderShowInjector();\ninstallCheckoutEasyPayInjector();\ninstallAdminApplePayNoticeInjector();\ninstallAdminPaymentMethodBrandInjector();\ninstallAdminOrderPaymentDisplayInjector();\ninitPlugin();\n\n(window as Record<string, unknown>).__SirsoftNhnkcp = {\n    identifier: PLUGIN_IDENTIFIER,\n    handlers: Object.keys(handlerMap),\n    initPlugin,\n};\n"],"names":["resolveApiUrl","url","trimReason","reason","resolveRetryUrl","closeReportUrl","postPaymentContext","payload","keepalive","apiClient","response","message","data","responseMessage","preparePaymentRetry","context","retryUrl","reportPaymentWindowClosed","error","NHNKCP_APPLEPAY_METHOD","isNhnKcpApplePayMethod","paymentMethod","isIosMobileDevice","nav","ua","platform","touchPoints","applePayUnsupportedMessage","normalizeCurrency","currency","isSupportedKcpCurrency","unsupportedCurrencyMessage","normalized","buildKcpTaxFields","pgPaymentData","paymentAmount","taxFreeAmt","taxTotalAmt","originalVatAmt","taxablePaymentAmt","vatAmt","supplyAmt","KcpCancelledError","msg","KCP_PAY_METHOD","KCP_EASY_PAY_DIRECT","buildKcpEasyPayReturnFields","isEasyPay","methodKey","isKcpPaymentFrameClosed","iframe","style","rect","watchKcpPaymentFrameClosure","onClose","stopped","intervalId","observer","stop","checkClosed","observeTarget","isMobileDevice","requestPaymentHandler","action","_context","paramPaymentMethod","G7Core","closeReportContext","configJson","config","callbackUrl","handleMobilePayment","handlePcPayment","responseData","firstFieldError","errorMessage","approvalJson","errors","pay_url","fields","form","name","value","input","payMethod","directOverride","hiddenInputs","n","v","resolve","reject","overlay","iframeWin","settled","sdkLoadTimer","stopCloseWatcher","cleanup","rejectOnce","markCompletingPayment","resCode","resMsg","orderForm","targetForm","i","el","dest","isCancelled","err","iframeDoc","METHOD_TO_TEXT","SELECTED_SHADOW","getEasyPayButtonContainer","clearEasyPayButtonStyles","container","btn","updateEasyPayButtonStyles","selectedMethod","selectedText","setPaymentMethodHandler","fallbackCopy","text","textarea","copyToClipboardHandler","handlerMap","ORDER_CREATE_PATH","TARGET_PG_PROVIDER","PLUGIN_IDENTIFIER","EASY_PAY_PREFIX","logger","args","extractUrl","extractMethod","init","isTargetEndpoint","method","path","buildNoOpRedirectUrl","mutateResponse","originalResponse","mutatedBody","json","buildPaymentMethodBlockedResponse","extractPaymentMethodFromBody","body","replacePaymentMethodInBody","replacement","parsed","installOrderResponseInterceptor","flag","w","ORIGINAL_FETCH_KEY","browserFetch","originalFetch","originalPaymentMethod","modifiedInit","pm","localPm","cloned","requiresPg","isNhnkcp","orderData","options","firstName","orderName","orderTax","enrichedPgPaymentData","PLUGIN_ID","FLAG","BTN_ID","ORDER_COMPLETE_RE","getToken","fetchPayment","orderNumber","token","res","fetchReceiptUrl","makeBtn","classes","onClick","patchPaymentMethodDisplay","displayLabel","rows","row","spans","child","label","injectOnOrderComplete","payment","blueBtn","b","receiptInfo","receiptBtn","KcpPopup","lastBtn","cashBtnId","cashBtn","tryInject","ocMatch","installOrderCompleteReceiptInjector","schedule","delay","origPush","VBANK_ID","ROW_ID","MOCK_DEPOSIT_ID","ORDER_SHOW_RE","getOrderFromState","getState","fetchReceiptUrls","fetchMockDepositInfo","buildMockDepositBlock","info","wrap","header","badge","title","f","lbl","submitRow","adminNotice","findPaymentRowsContainer","panel","h3","panelDiv","makeInfoRow","valueClass","val","patchMypagePaymentMethodDisplay","buildVbankInfoBlock","totalAmountFormatted","notice","buildReceiptRow","inner","needsVbank","needsReceipt","mightNeedMock","vbankDone","receiptDone","mockDone","displayPatched","startPolling","attempts","id","done","onRouteChange","match","installMypageOrderShowInjector","CHECKOUT_RE","LISTENER_FLAG","SYNC_RETRY_INTERVAL_MS","SYNC_RETRY_ATTEMPTS","EASY_PAY_DEFINITIONS","retryTimer","syncQueued","windowRecord","isCheckoutPage","normalizedText","isKoreanPage","copyFor","definition","displayText","findDefinitionById","findDefinitionForButton","button","markedDefinition","findPaymentRow","alignPaymentTextLeft","heading","description","textContainer","createMark","mark","removeKginicisBrandArtifacts","element","findPaymentIcon","ensureMark","existingMark","icon","updatePaymentText","paragraphs","copy","headingText","descriptionText","showButton","reconcileKginicisPatchedDuplicates","root","duplicateGroups","changed","kginicisMethod","nhnkcpMethods","index","syncRenderedCheckoutEasyPayMethods","queueSync","stopRetries","startSync","installCheckoutEasyPayInjector","ADMIN_SETTINGS_RE","NOTICE_KO","NOTICE_EN","isOrderSettingsPage","tab","noticeText","isApplePayLabel","createNotice","patchAdminApplePayNotice","applePayLabel","installAdminApplePayNoticeInjector","MARK_SELECTOR","ADMIN_PAYMENT_BRAND_DEFINITIONS","classNameOf","comparableText","isPaymentMethodItem","className","findTitleElement","item","findDefinitionForItem","findPaymentMethodItems","applyBrandMarkContent","expectedText","line","lineElement","createBrandMark","syncBrandMark","existing","syncRenderedAdminPaymentMethodBrands","matched","installAdminPaymentMethodBrandInjector","ADMIN_ORDER_SHOW_RE","fetchAdminTransactionStatus","directElementChildren","patchLabeledPaymentMethod","patched","children","labelIndex","installment","installmentText","nextDisplayLabel","patchPaymentMethodBadge","baseLabel","embeddedLabel","patchAdminPaymentMethodDisplay","status","labeled","installAdminOrderPaymentDisplayInjector","KcpReceiptPopup","params","features","registerHandlers","g7Core","getDispatcher","dispatcher","count","handler","fullName","initPlugin","doInit","retries","maxRetries","interval","result"],"mappings":"yBASA,SAASA,GAAcC,EAAqB,CACxC,MAAI,gBAAgB,KAAKA,CAAG,GAAKA,EAAI,WAAW,OAAO,EAC5CA,EAGPA,EAAI,WAAW,WAAW,EACnB,OAAOA,CAAG,GAGjBA,EAAI,WAAW,UAAU,EAClB,QAAQA,CAAG,GAGfA,CACX,CAEA,SAASC,GAAWC,EAAwB,CACxC,OAAOA,EAAO,KAAA,EAAO,MAAM,EAAG,GAAG,CACrC,CAEA,SAASC,GAAgBC,EAA6C,CAClE,GAAKA,EAIL,OAAOA,EAAe,QAAQ,2BAA4B,gBAAgB,CAC9E,CAEA,eAAeC,GAAmBL,EAAaM,EAAkCC,EAAY,GAAsB,CAC/G,MAAMC,EAAc,OAAe,QAAS,IAC5C,GAAI,OAAOA,GAAW,MAAS,WAAY,CACvC,MAAMA,EAAU,KAAKR,EAAKM,CAAO,EACjC,MACJ,CAEA,MAAMG,EAAW,MAAM,MAAMV,GAAcC,CAAG,EAAG,CAC7C,OAAQ,OACR,QAAS,CAAE,eAAgB,kBAAA,EAC3B,KAAM,KAAK,UAAUM,CAAO,EAC5B,UAAAC,CAAA,CACH,EAED,GAAI,CAACE,EAAS,GAAI,CACd,IAAIC,EAAU,mCAAmCD,EAAS,MAAM,IAChE,GAAI,CACA,MAAME,EAAO,MAAMF,EAAS,KAAA,EACtBG,EAAkB,MAAM,QAAQD,GAAM,QAAQ,OAAO,EACrDA,EAAK,OAAO,QAAQ,CAAC,EACrBA,GAAM,OAASA,GAAM,QACvB,OAAOC,GAAoB,UAAYA,EAAgB,KAAA,IAAW,KAClEF,EAAUE,EAElB,MAAQ,CAER,CACA,MAAM,IAAI,MAAMF,CAAO,CAC3B,CACJ,CAEA,eAAsBG,GAAoBC,EAAmD,CACzF,MAAMC,EAAWZ,GAAgBW,EAAQ,cAAc,EAClDC,GAIL,MAAMV,GAAmBU,EAAU,CAC/B,IAAKD,EAAQ,IACb,MAAO,OAAOA,EAAQ,KAAK,EAC3B,YAAaA,EAAQ,aAAe,GACpC,YAAaA,EAAQ,aAAe,GACpC,eAAgBA,EAAQ,gBAAkB,EAAA,CAC7C,CACL,CAEA,eAAsBE,GAClBF,EACAZ,EAAS,oBACI,CACb,GAAI,CAACY,EAAQ,eACT,OAGJ,MAAMR,EAAU,CACZ,IAAKQ,EAAQ,IACb,MAAO,OAAOA,EAAQ,KAAK,EAC3B,YAAaA,EAAQ,aAAe,GACpC,YAAaA,EAAQ,aAAe,GACpC,eAAgBA,EAAQ,gBAAkB,GAC1C,OAAQb,GAAWC,CAAM,GAAK,mBAAA,EAGlC,GAAI,CACA,MAAMG,GAAmBS,EAAQ,eAAgBR,EAAS,EAAI,CAClE,OAASW,EAAO,CACZ,QAAQ,KAAK,6DAA8DA,CAAK,CACpF,CACJ,CCzGO,MAAMC,GAAyB,kBAE/B,SAASC,EAAuBC,EAAiC,CACpE,OAAOA,IAAkBF,EAC7B,CAEO,SAASG,GAA6B,CACzC,GAAI,OAAO,UAAc,IAAa,MAAO,GAE7C,MAAMC,EAAM,UAONC,GAAMD,EAAI,WAAa,IAAI,YAAA,EAC3BE,IAAaF,EAAI,eAAe,UAAYA,EAAI,WAAa,IAAI,YAAA,EACjEG,EAAcH,EAAI,gBAAkB,EAE1C,MAAI,mBAAmB,KAAKC,CAAE,GAAK,uBAAuB,KAAKC,CAAQ,EAC5D,GAGJ,qBAAqB,KAAKD,CAAE,GAAKE,EAAc,CAC1D,CAEO,SAASC,GAAqC,CAKjD,QAJa,OAAO,SAAa,IAC3B,SAAS,gBAAgB,KACzB,KAEO,IAAI,YAAA,EAAc,WAAW,IAAI,EACnC,8BAGJ,iEACX,CCJA,SAASC,EAAkBC,EAA2B,CAGlD,OAFoBA,GAAY,OAAO,KAAA,EAAO,YAAA,GAEzB,KACzB,CAEO,SAASC,GAAuBD,EAA4B,CAC/D,OAAOD,EAAkBC,CAAQ,IAAM,KAC3C,CAEA,SAASE,GAA2BF,EAA2B,CAC3D,MAAMG,EAAaJ,EAAkBC,CAAQ,EAK7C,QAJe,OAAO,SAAa,IAAc,SAAS,gBAAgB,KAAO,KAAO,IACnF,YAAA,EACA,WAAW,IAAI,EAGd,4BAA4BG,CAAU,IACtC,wCAAwCA,CAAU,GAC5D,CAEO,SAASC,GAAkBC,EAAsD,CACpF,MAAMC,EAAgB,KAAK,IAAI,EAAG,KAAK,MAAM,OAAOD,EAAc,QAAU,CAAC,CAAC,CAAC,EACzEE,EAAa,KAAK,IACpB,KAAK,IAAI,EAAG,KAAK,MAAM,OAAOF,EAAc,iBAAmB,CAAC,CAAC,CAAC,EAClEC,CAAA,EAGJ,GAAIC,GAAc,EACd,MAAO,CAAA,EAGX,MAAMC,EAAc,KAAK,IAAI,EAAG,KAAK,MAAM,OAAOH,EAAc,YAAc,CAAC,CAAC,CAAC,EAC3EI,EAAiB,KAAK,IAAI,EAAG,KAAK,MAAM,OAAOJ,EAAc,YAAc,CAAC,CAAC,CAAC,EAC9EK,EAAoB,KAAK,IAAI,EAAGJ,EAAgBC,CAAU,EAC1DI,EAASD,EAAoB,GAAKF,EAAc,GAAKC,EAAiB,EACtE,KAAK,IAAIC,EAAmB,KAAK,MAAMA,GAAqBD,EAAiBD,EAAY,CAAC,EAC1F,EACAI,EAAYF,EAAoBC,EAEtC,MAAO,CACH,SAAU,OACV,aAAc,OAAOC,CAAS,EAC9B,aAAc,OAAOD,CAAM,EAC3B,cAAe,OAAOJ,CAAU,CAAA,CAExC,CAgBA,MAAMM,UAA0B,KAAM,CAClC,YAAYC,EAAc,CACtB,MAAMA,GAAO,cAAc,EAC3B,KAAK,KAAO,mBAChB,CACJ,CAGA,MAAMC,GAAyC,CAC3C,KAAiB,eACjB,cAAiB,eACjB,gBAAiB,eACjB,OAAiB,eACjB,KAAiB,eACjB,MAAiB,eACjB,MAAiB,cACrB,EAGMC,GAA8D,CAChE,aAAuB,CAAE,aAAc,GAAA,EACvC,gBAAuB,CAAE,gBAAiB,GAAA,EAC1C,sBAAuB,CAAE,gBAAiB,IAAK,sBAAuB,GAAA,EACtE,gBAAuB,CAAE,gBAAiB,GAAA,EAC1C,gBAAuB,CAAE,gBAAiB,GAAA,CAC9C,EAEO,SAASC,GAA4BzB,EAAuB0B,EAA4C,CAC3G,MAAMC,EAAY3B,EAAc,YAAA,EAChC,MAAI,CAAC0B,GAAa,CAAC,OAAO,UAAU,eAAe,KAAKF,GAAqBG,CAAS,EAC3E,CAAA,EAGJ,CACH,YAAaA,EACb,uBAAwBA,CAAA,CAEhC,CAEA,SAASC,GAAwBC,EAAoC,CACjE,GAAI,CAACA,EAAO,YACR,MAAO,GAGX,MAAMC,EAAQ,OAAO,iBAAiBD,CAAM,EAC5C,GAAIC,EAAM,UAAY,QAAUA,EAAM,aAAe,SACjD,MAAO,GAGX,MAAMC,EAAOF,EAAO,sBAAA,EACpB,OAAOE,EAAK,OAAS,GAAKA,EAAK,QAAU,CAC7C,CAEO,SAASC,GACZH,EACAI,EACU,CACV,IAAIC,EAAU,GACVC,EACAC,EAEJ,MAAMC,EAAO,IAAM,CACfH,EAAU,GACNE,IACAA,EAAS,WAAA,EACTA,EAAW,QAEXD,IAAe,SACf,OAAO,cAAcA,CAAU,EAC/BA,EAAa,OAErB,EAEMG,EAAc,IAAM,CAClBJ,GAAW,CAACN,GAAwBC,CAAM,IAI9CQ,EAAA,EACAJ,EAAA,EACJ,EAEMM,EAAgB,SAAS,MAAQ,SAAS,gBAChD,OAAIA,GAAiB,OAAO,iBAAqB,MAC7CH,EAAW,IAAI,iBAAiBE,CAAW,EAC3CF,EAAS,QAAQG,EAAe,CAC5B,WAAY,GACZ,gBAAiB,CAAC,QAAS,SAAU,OAAO,EAC5C,UAAW,GACX,QAAS,EAAA,CACZ,GAGLJ,EAAa,OAAO,YAAYG,EAAa,GAAG,EAEzCD,CACX,CASA,SAASG,IAA0B,CAC/B,GAAI,OAAO,UAAc,IAAa,MAAO,GAC7C,GAAIvC,EAAA,EAAqB,MAAO,GAEhC,MAAMC,EAAM,UACZ,GAAIA,EAAI,eAAe,SAAW,OAC9B,OAAOA,EAAI,cAAc,OAG7B,MAAMC,GAAM,UAAU,WAAa,IAAI,YAAA,EAOvC,MANI,oFAAiF,KAAKA,CAAE,IAKvE,UAAsD,gBAAkB,GAC3E,GAAK,CAACA,EAAG,SAAS,SAAS,GAAK,CAACA,EAAG,SAAS,WAAW,EAK9E,CAQA,eAAsBsC,GAAsBC,EAAaC,EAA+B,CACpF,KAAM,CAAE,cAAA9B,EAAe,cAAe+B,GAAwBF,EAAO,QAAU,CAAA,EAE/E,GAAI,CAAC7B,EAAe,CAChB,QAAQ,MAAM,gDAAgD,EAC9D,MACJ,CAEA,MAAMb,EAAgB4C,GAAsB/B,EAAc,YAAc,OAClEa,EAAY,OAAO1B,GAAkB,UAAYA,EAAc,WAAW,SAAS,EAEnF6C,EAAU,OAAe,OAC/B,IAAIC,EAAuD,KAE3D,GAAI,CACA,GAAI,CAACrC,GAAuBI,EAAc,QAAQ,EAAG,CACjD,MAAMvB,EAAUoB,GAA2BG,EAAc,QAAQ,EACjEgC,GAAQ,OAAO,WAAW,CAAE,oBAAqBvD,EAAS,kBAAmB,GAAO,cAAAU,EAAe,EACnG6C,GAAQ,OAAO,OAAO,4BAA4B,EAClD,MACJ,CAEA,GAAI9C,EAAuBC,CAAa,GAAK,CAACC,IAAqB,CAC/D,MAAMX,EAAUgB,EAAA,EAChBuC,GAAQ,OAAO,WAAW,CACtB,oBAAqBvD,EACrB,kBAAmB,GACnB,cAAAU,CAAA,CACH,EACD6C,GAAQ,OAAO,OAAO,4BAA4B,EAClD,MACJ,CAGA,MAAME,EAAa,MAAMF,EAAO,IAAI,IAAI,0DAA0D,EAElG,GAAI,CAACE,EAAW,KAAM,CAClB,QAAQ,MAAM,qDAAsDA,CAAU,EAC9E,MACJ,CAEA,MAAMC,EAAuBD,EAAW,KACxCD,EAAqB,CACjB,eAAgBE,EAAO,cAAc,aACrC,IAAKnC,EAAc,aACnB,MAAO,OAAOA,EAAc,MAAM,EAClC,YAAaA,EAAc,gBAAkB,GAC7C,YAAaA,EAAc,gBAAkB,GAC7C,eAAgBb,CAAA,EAEpB,MAAMiD,EAAc,OAAO,SAAS,OAASD,EAAO,cAAc,SAElE,MAAMvD,GAAoBqD,CAAkB,EAExCN,KACA,MAAMU,GAAoBL,EAAQhC,EAAeb,EAAe0B,EAAWuB,CAAW,EAEtF,MAAME,GAAgBH,EAAQnC,EAAeb,EAAe0B,EAAWuB,CAAW,CAG1F,OAASpD,EAAgB,CACrB,GAAIA,aAAiBwB,EAAmB,CAChCyB,GACA,MAAMlD,GAA0BkD,EAAoBjD,EAAM,SAAW,mBAAmB,EAE5FgD,GAAQ,OAAO,WAAW,CAAE,kBAAmB,GAAO,cAAA7C,EAAe,EACrE,MACJ,CAEA,QAAQ,MAAM,4CAA6CH,CAAK,EAOhE,MAAMuD,EADSvD,GACc,UAAU,KACjCwD,EAAkBD,GAAc,OAChC,OAAO,OAAOA,EAAa,MAAM,EAAE,CAAC,IAAI,CAAC,EACzC,OACAE,EACFF,GAAc,OACXA,GAAc,SACdC,IACCxD,aAAiB,MAAQA,EAAM,QAAU,iBAEjDgD,GAAQ,OAAO,WAAW,CAAE,oBAAqBS,EAAc,kBAAmB,GAAO,cAAAtD,EAAe,EACxG6C,GAAQ,OAAO,OAAO,4BAA4B,CACtD,CACJ,CASA,eAAeK,GACXL,EACAhC,EACAb,EACA0B,EACAuB,EACa,CACb,MAAMM,EAAe,MAAMV,EAAO,IAAI,KAAK,kDAAmD,CAC1F,aAAchC,EAAc,aAC5B,OAAQA,EAAc,OACtB,UAAWA,EAAc,WACzB,WAAYb,EACZ,UAAWa,EAAc,eAAiB,GAC1C,UAAWA,EAAc,gBAAkB,GAC3C,UAAWA,EAAc,gBAAkB,GAC3C,QAASoC,EACT,SAAU1C,EAAkBM,EAAc,QAAQ,CAAA,CACrD,EAED,GAAI,CAAC0C,EAAa,SAAW,CAACA,EAAa,KAAM,CAM7C,MAAMC,EAASD,EAAa,OACtBF,EAAkBG,EAAS,OAAO,OAAOA,CAAM,EAAE,CAAC,IAAI,CAAC,EAAI,OACjE,MAAM,IAAI,MACND,EAAa,OACNA,EAAa,SACbF,GACA,mBAAA,CAEf,CAEA,KAAM,CAAE,QAAAI,EAAS,OAAAC,CAAA,EAAWH,EAAa,KAGnCI,EAAO,SAAS,cAAc,MAAM,EAC1CA,EAAK,OAAS,OACdA,EAAK,OAASF,EACdE,EAAK,cAAgB,SACrBA,EAAK,MAAM,QAAU,OAErB,SAAW,CAACC,EAAMC,CAAK,IAAK,OAAO,QAAQH,CAAM,EAAG,CAChD,MAAMI,EAAQ,SAAS,cAAc,OAAO,EAC5CA,EAAM,KAAO,SACbA,EAAM,KAAOF,EACbE,EAAM,MAAQ,OAAOD,CAAK,EAC1BF,EAAK,YAAYG,CAAK,CAC1B,CAEA,SAAS,KAAK,YAAYH,CAAI,EAC9BA,EAAK,OAAA,EAGL,MAAM,IAAI,QAAe,IAAM,CAAC,CAAC,CACrC,CAQA,eAAeR,GACXH,EACAnC,EACAb,EACA0B,EACAuB,EACa,CAEb,MAAMc,EAAYrC,EACZ,eACCH,GAAeV,EAAc,YAAc,MAAM,GAAK,eAOvD6C,EAAiC,CACnC,QALW1D,IAAkB,eAC1BgD,EAAO,oBAAsBA,EAAO,UACpCA,EAAO,YAAc,CAACtB,EAAasB,EAAO,kBAAoBA,EAAO,UAAaA,EAAO,UAI5F,UAAWnC,EAAc,aACzB,UAAWA,EAAc,WACzB,SAAU,OAAOA,EAAc,MAAM,EACrC,UAAWA,EAAc,eAAiB,GAC1C,UAAWA,EAAc,gBAAkB,GAC3C,UAAWA,EAAc,gBAAkB,GAC3C,WAAYkD,EACZ,QAASd,CAAA,EAoBb,GAjBA,OAAO,OAAOS,EAAQ9C,GAAkBC,CAAa,CAAC,EACtD,OAAO,OAAO6C,EAAQjC,GAA4BzB,EAAe0B,CAAS,CAAC,EAGvEqC,IAAc,iBACdL,EAAO,iBAAsB,OAAOV,EAAO,mBAAqB,CAAC,EACjEU,EAAO,YAAiB,KAIxBV,EAAO,YAAc,CAACtB,IACtBgC,EAAO,UAAe,IACtBA,EAAO,QAAa,KAKpBhC,EAAW,CAEXgC,EAAO,aAAqB,GAC5BA,EAAO,gBAAqB,IAC5BA,EAAO,gBAAqB,IAC5BA,EAAO,gBAAqB,IAC5B,MAAMM,EAAiBxC,GAAoBxB,CAAa,EACpDgE,GACA,OAAO,OAAON,EAAQM,CAAc,CAE5C,CAEA,MAAMC,EAAe,OAAO,QAAQP,CAAM,EACrC,IAAI,CAAC,CAACQ,EAAGC,CAAC,IAAM,8BAA8BD,CAAC,YAAYC,EAAE,QAAQ,KAAM,QAAQ,CAAC,IAAI,EACxF,KAAK,EAAE,EAEZ,MAAM,IAAI,QAAc,CAACC,EAASC,IAAW,CAEzC,SAAS,eAAe,gBAAgB,GAAG,OAAA,EAC3C,SAAS,eAAe,iBAAiB,GAAG,OAAA,EAG5C,MAAMC,EAAU,SAAS,cAAc,KAAK,EAC5CA,EAAQ,GAAK,kBACbA,EAAQ,MAAM,QAAU,+FACxB,SAAS,KAAK,YAAYA,CAAO,EAGjC,MAAMzC,EAAS,SAAS,cAAc,QAAQ,EAC9CA,EAAO,GAAK,iBACZA,EAAO,aAAa,oBAAqB,MAAM,EAC/CA,EAAO,MAAM,QAAU,oGACvB,SAAS,KAAK,YAAYA,CAAM,EAEhC,MAAM0C,EAAY1C,EAAO,cACzB,IAAI2C,EAAU,GACVC,EACAC,EAEJ,MAAMC,GAAU,IAAM,CAClBD,IAAA,EACAA,EAAmB,OACfD,IAAiB,SACjB,aAAaA,CAAY,EACzBA,EAAe,QAEnB5C,EAAO,OAAA,EACPyC,EAAQ,OAAA,CACZ,EAEMM,EAAc/E,GAAiB,CAC7B2E,IAIJA,EAAU,GACVG,GAAA,EACAN,EAAOxE,CAAK,EAChB,EAEMgF,EAAwB,IAAM,CAChCL,EAAU,GACVE,IAAA,EACAA,EAAmB,OACfD,IAAiB,SACjB,aAAaA,CAAY,EACzBA,EAAe,OAEvB,EAEAC,EAAmB1C,GAA4BH,EAAQ,IAAM,CACzD+C,EAAW,IAAIvD,EAAkB,0BAA0B,CAAC,CAChE,CAAC,EAGDkD,EAAU,kBAAoB,SAAUZ,EAAuB,CAC3D,MAAMmB,EAAWnB,EAAK,SAAiB,QAAW,OAAS,GACrDoB,EAAWpB,EAAK,SAAiB,SAAY,OAAS,GAE5D,GAAImB,IAAY,OAAQ,CACpBD,EAAA,EAMA,MAAMG,EAAYT,EAAU,SAAS,MAAM,UAAU,YAAY,EAC3DU,EAAcD,GAAaA,IAAcrB,EAAQqB,EAAYrB,EAEnE,GAAIqB,GAAaA,IAAcrB,EAC3B,QAASuB,EAAI,EAAGA,EAAIvB,EAAK,SAAS,OAAQuB,IAAK,CAC3C,MAAMC,EAAKxB,EAAK,SAASuB,CAAC,EAC1B,GAAI,CAACC,EAAG,KAAM,SACd,IAAIC,EAAOJ,EAAU,SAAS,UAAUG,EAAG,IAAI,EAC1CC,IACDA,EAAOb,EAAU,SAAS,cAAc,OAAO,EAC/Ca,EAAK,KAAO,SACZA,EAAK,KAAOD,EAAG,KACfH,EAAU,YAAYI,CAAI,GAE9BA,EAAK,MAAQD,EAAG,KACpB,CAGJF,EAAW,OAAShC,EACpBgC,EAAW,OAAS,OACpBA,EAAW,OAAS,OACpBV,EAAU,SAAS,KAAK,YAAYU,CAAU,EAC9CA,EAAW,OAAA,CACf,KAAO,CAEH,MAAMI,EAAcP,IAAY,IAAMA,IAAY,QAAUC,EAAO,SAAS,IAAI,EAChFH,EAAWS,EAAc,IAAIhE,EAAkB0D,CAAM,EAAI,IAAI,MAAM,WAAWD,CAAO,MAAMC,CAAM,EAAE,CAAC,CACxG,CACJ,EAEAR,EAAU,UAAae,GAAe,CAClCV,EAAWU,CAAG,CAClB,EAGA,MAAMC,EAAa1D,EAAO,iBAAmB0C,EAAU,SACvDgB,EAAU,KAAA,EACVA,EAAU,MAAM;AAAA,eACTvC,EAAO,OAAO;AAAA;AAAA,0BAEHiB,CAAY;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,eAavB,EACPsB,EAAU,MAAA,EAGVd,EAAe,OAAO,WAAW,IAAM,CACnCG,EAAW,IAAI,MAAM,sBAAsB,CAAC,CAChD,EAAG,IAAK,EAERL,EAAU,WAAa,IAAM,CACrBE,IAAiB,SACjB,aAAaA,CAAY,EACzBA,EAAe,OAEvB,CACJ,CAAC,CACL,CCxkBA,MAAMe,GAAyC,CAC3C,aAAuB,QACvB,gBAAuB,QACvB,sBAAuB,YACvB,gBAAuB,QACvB,gBAAuB,WAC3B,EAEMC,GAAkB,gDAExB,SAASC,IAA4C,CAEjD,OADgB,SAAS,cAAc,uBAAuB,GAC5C,IACtB,CAEA,SAASC,IAAiC,CACtC,MAAMC,EAAYF,GAAA,EACbE,GACLA,EAAU,iBAAoC,QAAQ,EAAE,QAAQC,GAAO,CACnEA,EAAI,MAAM,UAAY,GACtBA,EAAI,MAAM,QAAU,EACxB,CAAC,CACL,CAEA,SAASC,GAA0BC,EAA8B,CAC7D,MAAMH,EAAYF,GAAA,EAClB,GAAI,CAACE,EAAW,OAEhB,MAAMI,EAAeR,GAAeO,CAAc,EAClDH,EAAU,iBAAoC,QAAQ,EAAE,QAAQC,GAAO,CAC/DA,EAAI,aAAa,KAAA,IAAWG,GAC5BH,EAAI,MAAM,UAAYJ,GACtBI,EAAI,MAAM,QAAU,SAEpBA,EAAI,MAAM,UAAY,GACtBA,EAAI,MAAM,QAAU,GAE5B,CAAC,CACL,CAEO,SAASI,GAAwBvD,EAAmB,CACvD,MAAM1C,EAAgB0C,EAAO,QAAQ,cACrC,GAAI,CAAC1C,EAAe,OAEpB,MAAM6C,EAAU,OAAe,OAC/B,GAAI9C,EAAuBC,CAAa,GAAK,CAACC,IAAqB,CAC/D,MAAMX,EAAUgB,EAAA,EAChBuC,GAAQ,OAAO,WAAW,CACtB,oBAAqBvD,EACrB,kBAAmB,EAAA,CACtB,EACDuD,GAAQ,OAAO,OAAO,4BAA4B,EAClD8C,GAAA,EACA,MACJ,CAEA,MAAMjE,EAAY,OAAO1B,GAAkB,UAAYA,EAAc,WAAW,SAAS,EACzF6C,GAAQ,OAAO,WAAW,CACtB,cAAA7C,EACA,oBAAqB0B,EAAY,OAAS1B,CAAA,CAC7C,EAEG0B,EACAoE,GAA0B9F,CAAa,EAEvC2F,GAAA,CAER,CCzEA,SAASO,GAAaC,EAAoB,CACtC,MAAMC,EAAW,SAAS,cAAc,UAAU,EAClDA,EAAS,MAAQD,EACjBC,EAAS,aAAa,WAAY,UAAU,EAC5CA,EAAS,MAAM,SAAW,QAC1BA,EAAS,MAAM,KAAO,UACtBA,EAAS,MAAM,IAAM,IAErB,SAAS,KAAK,YAAYA,CAAQ,EAClCA,EAAS,OAAA,EAET,GAAI,CACA,SAAS,YAAY,MAAM,CAC/B,QAAA,CACIA,EAAS,OAAA,CACb,CACJ,CAEA,eAAsBC,GAAuB3D,EAA4B,CACrE,MAAMyD,EAAO,OAAOzD,EAAO,QAAQ,MAAQ,EAAE,EAE7C,GAAIyD,IAAS,GAIb,IAAI,UAAU,WAAa,OAAO,UAAU,UAAU,WAAc,WAAY,CAC5E,MAAM,UAAU,UAAU,UAAUA,CAAI,EACxC,MACJ,CAEAD,GAAaC,CAAI,EACrB,CC7BO,MAAMG,GAA8D,CACvE,eAAgB7D,GAChB,iBAAkBwD,GAClB,gBAAiBI,EACrB,ECmBME,GAAoB,6CACpBC,GAAqB,iBACrBC,EAAoB,qBACpBC,GAAkB,UAElBC,EAAS,CACX,KAAM,IAAIC,IAAoB,QAAQ,KAAK,IAAIH,CAAiB,IAAK,GAAGG,CAAI,EAC5E,KAAM,IAAIA,IAAoB,QAAQ,KAAK,IAAIH,CAAiB,IAAK,GAAGG,CAAI,EAC5E,MAAO,IAAIA,IAAoB,QAAQ,MAAM,IAAIH,CAAiB,IAAK,GAAGG,CAAI,CAClF,EAmBA,SAASC,GAAW/C,EAAkC,CAClD,OAAI,OAAOA,GAAU,SAAiBA,EAClCA,aAAiB,IAAYA,EAAM,SAAA,EACnC,OAAO,QAAY,KAAeA,aAAiB,QAAgBA,EAAM,IACtE,OAAOA,CAAK,CACvB,CAEA,SAASgD,GAAchD,EAA0BiD,EAA4B,CACzE,OAAIA,GAAM,OAAeA,EAAK,OAAO,YAAA,EACjC,OAAO,QAAY,KAAejD,aAAiB,QAAgBA,EAAM,OAAO,YAAA,EAC7E,KACX,CAEA,SAASkD,GAAiBpI,EAAaqI,EAAyB,CAC5D,GAAIA,IAAW,OAAQ,MAAO,GAC9B,MAAMC,EAAOtI,EAAI,MAAM,GAAG,EAAE,CAAC,EAAE,MAAM,GAAG,EAAE,CAAC,EAC3C,OAAOsI,IAASX,IAAqBW,EAAK,SAASX,EAAiB,CACxE,CAEA,SAASY,IAA+B,CACpC,OAAO,OAAO,SAAS,SAAW,OAAO,SAAS,OAAS,OAAO,SAAS,IAC/E,CAEA,SAASC,GAAeC,EAA4BC,EAAgD,CAChG,MAAMC,EAAO,KAAK,UAAUD,CAAW,EACvC,OAAO,IAAI,SAASC,EAAM,CACtB,OAAQF,EAAiB,OACzB,WAAYA,EAAiB,WAC7B,QAASA,EAAiB,OAAA,CAC7B,CACL,CAEA,SAASG,GAAkClI,EAA2B,CAClE,OAAO,IAAI,SAAS,KAAK,UAAU,CAC/B,QAAS,GACT,QAAAA,EACA,MAAOA,EACP,OAAQ,CACJ,eAAgB,CAACA,CAAO,CAAA,CAC5B,CACH,EAAG,CACA,OAAQ,IACR,WAAY,wBACZ,QAAS,CACL,eAAgB,kBAAA,CACpB,CACH,CACL,CAEA,SAASmI,GAA6BC,EAAkC,CACpE,GAAI,CAEA,OADe,KAAK,MAAMA,CAAI,EAChB,cAClB,MAAQ,CACJ,MACJ,CACJ,CAEA,SAASC,GAA2BD,EAAcE,EAA6B,CAC3E,GAAI,CACA,MAAMC,EAAS,KAAK,MAAMH,CAAI,EAC9B,OAAAG,EAAO,eAAoBD,EACpB,KAAK,UAAUC,CAAM,CAChC,MAAQ,CACJ,OAAOH,CACX,CACJ,CAEO,SAASI,IAAwC,CACpD,GAAI,OAAO,OAAW,KAAe,OAAO,OAAO,OAAU,WACzD,OAGJ,MAAMC,EAAO,sCACPC,EAAI,OACV,GAAIA,EAAED,CAAI,EACN,OAEJC,EAAED,CAAI,EAAI,GAGV,MAAME,EAAqB,2BACtBD,EAAEC,CAAkB,IACrBD,EAAEC,CAAkB,EAAI,OAAO,MAAM,KAAK,MAAM,GAGpD,MAAMC,EAAeF,EAAEC,CAAkB,EAEnCE,EAAgB,OAAO,MAAM,KAAK,MAAM,EAE9C,OAAO,MAAQ,eACXrE,EACAiD,EACiB,CACjB,MAAMnI,EAAMiI,GAAW/C,CAAK,EACtBmD,EAASH,GAAchD,EAAOiD,CAAI,EAGxC,GAAI,CAACC,GAAiBpI,EAAKqI,CAAM,EAC7B,OAAOkB,EAAcrE,EAAOiD,CAAI,EAIpC,IAAIqB,EACAC,EAAetB,EAEnB,GAAIA,GAAM,MAAQ,OAAOA,EAAK,MAAS,SAAU,CAC7C,MAAMuB,EAAKb,GAA6BV,EAAK,IAAI,EAC7C,OAAOuB,GAAO,UAAYA,EAAG,WAAW5B,EAAe,IACvD0B,EAAwBE,EAExBD,EAAe,CAAE,GAAGtB,EAAM,KAAMY,GAA2BZ,EAAK,KAAM,MAAM,CAAA,EAC5EJ,EAAO,KAAK,gDAAgD2B,CAAE,YAAY,EAElF,CAIA,GAAI,CAACF,EACD,GAAI,CAEA,MAAMG,EAAY,OAAe,QAAS,OAAO,cAAc,cAC3D,OAAOA,GAAY,UAAYA,EAAQ,WAAW7B,EAAe,IACjE0B,EAAwBG,EACxB5B,EAAO,KAAK,wCAAwC4B,CAAO,GAAG,EAEtE,MAAQ,CAAe,CAG3B,GAAIxI,EAAuBqI,CAAqB,GAAK,CAACnI,IAAqB,CACvE,MAAMX,EAAUgB,EAAA,EAChBqG,OAAAA,EAAO,KAAKrH,CAAO,EACZkI,GAAkClI,CAAO,CACpD,CAKA,MAAMD,EAAW,MADD+I,EAAwBF,EAAeC,GACxBrE,EAAOuE,CAAY,EAElD,IAAIG,EACJ,GAAI,CACAA,EAASnJ,EAAS,MAAA,CACtB,MAAQ,CACJ,OAAOA,CACX,CAEA,IAAIqI,EAAuC,KAC3C,GAAI,CACAA,EAAQ,MAAMc,EAAO,KAAA,CACzB,MAAQ,CACJ,OAAOnJ,CACX,CAEA,MAAME,EAAOmI,GAAM,KACnB,GAAI,CAACnI,EAAM,OAAOF,EAElB,MAAMoJ,GAAalJ,EAAK,sBAAwB,GAC1CmJ,EAAWnJ,EAAK,cAAgBiH,GAOtC,GAHI,CAAC4B,IAA0B,CAACK,IAAc,CAACC,IAG3CN,GAAyB,CAAC7I,EAAK,OAAS,CAACA,EAAK,gBAC9C,OAAOF,EAKX,IAAIwB,EAAgBtB,EAAK,gBACzB,GAAI,CAACsB,GAAiBuH,GAAyB7I,EAAK,MAAO,CACvD,MAAMoJ,EAAYpJ,EAAK,MACjBqJ,EAAUD,EAAU,QACpBE,EAAaD,IAAU,CAAC,GAAG,cAAuC,OAAOD,EAAU,cAAgB,EAAE,EACrGG,GAAaF,GAAS,QAAU,GAAK,EACrC,GAAGC,CAAS,OAAOD,GAAS,QAAU,GAAK,CAAC,IAC5CC,EACNhI,EAAgB,CACZ,aAAc8H,EAAU,aACxB,WAAYG,EACZ,OAAQ,KAAK,MAAM,OAAOH,EAAU,kBAAoBA,EAAU,cAAgB,CAAC,CAAC,EACpF,SAAU,MACV,cAAeA,EAAU,cAAgB,KACzC,eAAgBA,EAAU,eAAiB,KAC3C,eAAgB,OAAOA,EAAU,eAAiB,EAAE,EAAE,QAAQ,UAAW,EAAE,CAAA,EAE/EhC,EAAO,KAAK,uDAAwD,CAChE,aAAc9F,EAAc,aAC5B,OAAQA,EAAc,MAAA,CACzB,CACL,CAEA,GAAI,CAACA,EACD8F,OAAAA,EAAO,KAAK,mDAAmD,EACxDtH,EAGXsH,EAAO,KAAK,sDAAsD,EAGlE,MAAMoC,EAAWxJ,EAAK,MAChB,CACE,WAAYA,EAAK,MAAM,kBAAoB,EAC3C,WAAYA,EAAK,MAAM,kBAAoB,EAC3C,gBAAiBA,EAAK,MAAM,uBAAyB,CAAA,EAEvD,CAAA,EAGAyJ,EAAyB,CAACZ,GAAyBC,GAAc,MAAQ,OAAOA,EAAa,MAAS,UACrG,IAAM,CACL,MAAMC,EAAKb,GAA6BY,EAAc,IAAc,EACpE,OAAOC,EAAK,CAAE,GAAGzH,EAAe,WAAYyH,EAAI,GAAGS,GAAa,CAAE,GAAGlI,EAAe,GAAGkI,CAAA,CAC3F,KACE,CAAE,GAAGlI,EAAe,GAAGkI,CAAA,EAExBtG,GAAsB,CAEvB,OAAQ,CACJ,cAAeuG,EACf,cAAeZ,CAAA,CACnB,CACH,EAED,MAAMd,EAAuC,CACzC,GAAGI,EACH,KAAM,CACF,GAAGnI,EACH,oBAAqB,GACrB,aAAc4H,GAAA,CAAqB,CACvC,EAGJ,OAAOC,GAAe/H,EAAUiI,CAAW,CAC/C,EAEAX,EAAO,KAAK,sCAAsC,CACtD,CCtSA,MAAMsC,EAAY,qBACZC,GAAO,kCACPC,GAAS,qBAETC,GAAoB,sCAS1B,SAASC,IAA0B,CAC/B,OAAO,aAAa,QAAQ,YAAY,CAC5C,CAEA,eAAeC,GAAaC,EAA8C,CACtE,MAAMC,EAAQH,GAAA,EACd,GAAI,CAACG,EAAO,OAAO,KAEnB,GAAI,CACA,MAAMC,EAAM,MAAM,MAAM,8CAA8CF,CAAW,GAAI,CACjF,QAAS,CAAE,cAAe,UAAUC,CAAK,GAAI,OAAQ,kBAAA,CAAmB,CAC3E,EACD,OAAKC,EAAI,IACK,MAAMA,EAAI,KAAA,IACX,MAAM,SAAW,KAFV,IAGxB,MAAQ,CACJ,OAAO,IACX,CACJ,CAQA,eAAeC,EAAgBH,EAAkD,CAC7E,MAAMC,EAAQH,GAAA,EACd,GAAI,CAACG,EAAO,OAAO,KAEnB,GAAI,CACA,MAAMC,EAAM,MAAM,MAAM,gBAAgBR,CAAS,gBAAgBM,CAAW,WAAY,CACpF,QAAS,CAAE,cAAe,UAAUC,CAAK,GAAI,OAAQ,kBAAA,CAAmB,CAC3E,EACD,OAAKC,EAAI,GACD,MAAMA,EAAI,KAAA,EADE,IAExB,MAAQ,CACJ,OAAO,IACX,CACJ,CAEA,SAASE,GAAQxD,EAAcyD,EAAiBC,EAA8D,CAC1G,MAAMhE,EAAM,SAAS,cAAc,QAAQ,EAC3C,OAAAA,EAAI,KAAO,SACXA,EAAI,UAAY+D,EAChB/D,EAAI,YAAcM,EAClBN,EAAI,iBAAiB,QAAS,IAAMgE,EAAQhE,CAAG,CAAC,EACzCA,CACX,CAEA,SAASiE,GAA0BC,EAAkD,CACjF,GAAI,CAACA,EAAc,MAAO,GAE1B,MAAMC,EAAO,MAAM,KAAK,SAAS,iBAA8B,KAAK,CAAC,EACrE,UAAWC,KAAOD,EAAM,CACpB,MAAME,EAAQ,MAAM,KAAKD,EAAI,QAAQ,EAAE,OAClCE,GAAgCA,aAAiB,aAAeA,EAAM,UAAY,MAAA,EAEvF,GAAID,EAAM,OAAS,EAAG,SAEtB,MAAME,EAAQF,EAAM,CAAC,EAAE,aAAa,KAAA,EACpC,GAAIE,IAAU,SAAWA,IAAU,QAAUA,IAAU,QAAS,SAEhE,MAAMvG,EAAQqG,EAAMA,EAAM,OAAS,CAAC,EACpC,OAAIrG,EAAM,aAAa,KAAA,IAAWkG,GAC9BE,EAAI,QAAQ,uBAAyB,OAC9B,KAGXpG,EAAM,YAAckG,EACpBlG,EAAM,QAAQ,2BAA6B,OAC3CoG,EAAI,QAAQ,uBAAyB,OAC9B,GACX,CAEA,MAAO,EACX,CAGA,eAAeI,GAAsBd,EAAoC,CACrE,GAAI,SAAS,eAAeJ,EAAM,EAAG,OAErC,MAAMmB,EAAU,MAAMhB,GAAaC,CAAW,EAG9C,GAAI,CAACe,GAAWA,EAAQ,cAAgB,UAAY,CAACA,EAAQ,gBAAkB,CAACA,EAAQ,QAAS,OAGjG,MAAMC,EAAU,MAAM,KAAK,SAAS,iBAAoC,uBAAuB,CAAC,EAC3F,KAAKC,GAAKA,EAAE,UAAU,SAAS,aAAa,CAAC,EAElD,GAAI,CAACD,GAAS,cAAe,OAE7B,MAAME,EAAc,MAAMf,EAAgBH,CAAW,EACrDO,GAA0BW,GAAa,4BAA4B,EAEnE,MAAM7E,EAAY2E,EAAQ,cAEpBG,EAAaf,GAAQ,SAAUY,EAAQ,UAAU,QAAQ,eAAgB,cAAc,EAAE,QAAQ,qBAAsB,oBAAoB,EAAG,MAAO1E,GAAQ,CAC/JA,EAAI,SAAW,GACfA,EAAI,YAAc,UAClB,MAAMtG,EAAO,MAAMmK,EAAgBH,CAAW,EAG9C,GAFA1D,EAAI,SAAW,GACfA,EAAI,YAAc,SACdtG,EAAM,CACN,MAAMoL,EAAY,OAA8C,gBAE5DA,OAAcA,EAAS,CAAE,IAAKpL,EAAK,aAAe,OAAW,CACrE,CACJ,CAAC,EACDmL,EAAW,GAAKvB,GAGhB,MAAMyB,EAAUhF,EAAU,iBAC1BA,EAAU,aAAa8E,EAAYE,CAAO,EAG1C,MAAMC,EAAY,0BAClB,GAAI,CAAC,SAAS,eAAeA,CAAS,IAAMP,EAAQ,iBAAmB,SAAWA,EAAQ,iBAAmB,iBAAkB,CAC3H,MAAMQ,EAAUnB,GAAQ,WAAYe,EAAW,UAAU,QAAQ,gBAAiB,aAAa,EAAE,QAAQ,sBAAuB,mBAAmB,EAAG,MAAO7E,GAAQ,CACjKA,EAAI,SAAW,GACfA,EAAI,YAAc,UAClB,MAAMtG,EAAO,MAAMmK,EAAgBH,CAAW,EAG9C,GAFA1D,EAAI,SAAW,GACfA,EAAI,YAAc,WACdtG,EAAM,CACN,MAAMoL,EAAY,OAA8C,gBAE5DA,OAAcA,EAAS,CAAE,SAAUpL,EAAK,kBAAoB,OAAW,CAC/E,CACJ,CAAC,EACDuL,EAAQ,GAAKD,EACbjF,EAAU,aAAakF,EAASF,CAAO,CAC3C,CAEA,QAAQ,KAAK,IAAI3B,CAAS,kDAAkD,CAChF,CAEA,SAAS8B,IAAkB,CAEvB,MAAMC,EADO,SAAS,SACD,MAAM5B,EAAiB,EACxC4B,GACKX,GAAsBW,EAAQ,CAAC,CAAC,CAG7C,CAEO,SAASC,IAA4C,CACxD,GAAI,OAAO,OAAW,IAAa,OACnC,MAAMjD,EAAI,OACV,GAAIA,EAAEkB,EAAI,EAAG,OACblB,EAAEkB,EAAI,EAAI,GAEV,QAAQ,KAAK,IAAID,CAAS,6CAA6C,EAEvE,MAAMiC,EAAW,CAACC,EAAQ,OAAS,WAAWJ,GAAWI,CAAK,EAG1D,SAAS,aAAe,UACxB,SAAS,iBAAiB,mBAAoB,IAAMD,EAAA,CAAU,EAE9DA,EAAA,EAIJ,MAAME,EAAW,QAAQ,UAAU,KAAK,OAAO,EAC/C,QAAQ,UAAY,IAAIxE,IAA+C,CACnEwE,EAAS,GAAGxE,CAAI,EAChBsE,EAAA,CACJ,EACA,OAAO,iBAAiB,WAAY,IAAMA,EAAS,GAAG,CAAC,CAC3D,CCxLA,MAAMjC,EAAY,qBACZC,GAAO,+BACPmC,EAAW,mBACXC,EAAS,qBACTC,EAAkB,sBAElBC,GAAgB,8BAoBtB,SAASC,GAAkBlC,EAAuC,CAC9D,GAAI,CAEA,MAAMmC,EADM,OAA8C,QACrC,SAGfnM,EAFMmM,OAAc,oBACP,OACC,KACpB,MAAI,CAACnM,GAAQA,EAAK,eAAiBgK,EAAoB,KAChDhK,CACX,MAAQ,CACJ,OAAO,IACX,CACJ,CAEA,SAAS8J,IAA0B,CAC/B,OAAO,aAAa,QAAQ,YAAY,CAC5C,CAQA,eAAesC,GAAiBpC,EAAkD,CAC9E,MAAMC,EAAQH,GAAA,EACd,GAAI,CAACG,EAAO,OAAO,KACnB,GAAI,CACA,MAAMC,EAAM,MAAM,MAAM,gBAAgBR,CAAS,gBAAgBM,CAAW,WAAY,CACpF,QAAS,CAAE,cAAe,UAAUC,CAAK,GAAI,OAAQ,kBAAA,CAAmB,CAC3E,EACD,OAAKC,EAAI,GACD,MAAMA,EAAI,KAAA,EADE,IAExB,MAAQ,CACJ,OAAO,IACX,CACJ,CAWA,eAAemC,GAAqBrC,EAAsD,CACtF,MAAMC,EAAQH,GAAA,EACd,GAAI,CAACG,EAAO,OAAO,KACnB,GAAI,CACA,MAAMC,EAAM,MAAM,MAAM,gBAAgBR,CAAS,gBAAgBM,CAAW,2BAA4B,CACpG,QAAS,CAAE,cAAe,UAAUC,CAAK,GAAI,OAAQ,kBAAA,CAAmB,CAC3E,EACD,OAAKC,EAAI,GACD,MAAMA,EAAI,KAAA,EADE,IAExB,MAAQ,CACJ,OAAO,IACX,CACJ,CAEA,SAASoC,GAAsBC,EAAoC,CAC/D,MAAMC,EAAO,SAAS,cAAc,KAAK,EACzCA,EAAK,GAAKR,EACVQ,EAAK,UAAY,4EAEjB,MAAMC,EAAS,SAAS,cAAc,KAAK,EAC3CA,EAAO,UAAY,+BAEnB,MAAMC,EAAQ,SAAS,cAAc,MAAM,EAC3CA,EAAM,UAAY,0LAClBA,EAAM,YAAc,OAEpB,MAAMC,EAAQ,SAAS,cAAc,GAAG,EACxCA,EAAM,UAAY,6DAClBA,EAAM,YAAc,SAEpBF,EAAO,YAAYC,CAAK,EACxBD,EAAO,YAAYE,CAAK,EAExB,MAAMvI,EAAO,SAAS,cAAc,MAAM,EAC1CA,EAAK,OAAS,OACdA,EAAK,OAASmI,EAAK,UAAY,GAC/BnI,EAAK,OAAS,SACdA,EAAK,UAAY,YAEjB,MAAMD,EAAoF,CACtF,CAAE,MAAO,WAAY,KAAM,aAAc,MAAOoI,EAAK,UAAY,EAAA,EACjE,CAAE,MAAO,OAAW,KAAM,aAAe,MAAOA,EAAK,YAAc,EAAA,EACnE,CAAE,MAAO,OAAW,KAAM,WAAe,MAAO,UAAW,SAAU,EAAA,EACrE,CAAE,MAAO,WAAY,KAAM,WAAc,MAAOA,EAAK,YAAc,EAAA,CAAG,EAG1E,UAAWK,KAAKzI,EAAQ,CACpB,MAAMuG,EAAM,SAAS,cAAc,KAAK,EACxCA,EAAI,UAAY,kCAEhB,MAAMmC,EAAM,SAAS,cAAc,MAAM,EACzCA,EAAI,UAAY,8DAChBA,EAAI,YAAcD,EAAE,MAEpB,MAAMrI,EAAQ,SAAS,cAAc,OAAO,EAC5CA,EAAM,KAAO,OACbA,EAAM,KAAOqI,EAAE,KACfrI,EAAM,MAAQqI,EAAE,MAChBrI,EAAM,SAAW,CAACqI,EAAE,SACpBrI,EAAM,UAAYqI,EAAE,SACd,iJACA,sJAENlC,EAAI,YAAYmC,CAAG,EACnBnC,EAAI,YAAYnG,CAAK,EACrBH,EAAK,YAAYsG,CAAG,CACxB,CAEA,MAAMoC,EAAY,SAAS,cAAc,KAAK,EAC9CA,EAAU,UAAY,OAEtB,MAAMxG,EAAM,SAAS,cAAc,QAAQ,EAW3C,GAVAA,EAAI,KAAO,SACXA,EAAI,UAAY,wOAChBA,EAAI,YAAc,WAElBwG,EAAU,YAAYxG,CAAG,EACzBlC,EAAK,YAAY0I,CAAS,EAE1BN,EAAK,YAAYC,CAAM,EACvBD,EAAK,YAAYpI,CAAI,EAEjBmI,EAAK,cAAe,CACpB,MAAMQ,EAAc,SAAS,cAAc,GAAG,EAC9CA,EAAY,UAAY,4EACxBA,EAAY,YAAc,iBAC1BP,EAAK,YAAYO,CAAW,CAChC,CAEA,OAAOP,CACX,CAEA,SAASQ,IAA2C,CAChD,MAAMC,EAAQ,SAAS,eAAe,0BAA0B,EAChE,GAAIA,EAEA,OADe,MAAM,KAAKA,EAAM,QAAQ,EAAE,KAAKrH,GAAMA,EAAG,WAAW,SAAS,SAAS,CAAC,GACrEqH,EAIrB,MAAMC,EAAK,MAAM,KAAK,SAAS,iBAA8B,IAAI,CAAC,EAAE,KAChEtH,GAAMA,EAAG,aAAa,SAAS,OAAO,CAAA,EAE1C,GAAI,CAACsH,EAAI,OAAO,KAEhB,MAAMC,EAAWD,EAAG,eAAe,cACnC,OAAKC,EAEU,MAAM,KAAKA,EAAS,QAAQ,EAAE,KAAKvH,GAAMA,EAAG,WAAW,SAAS,SAAS,CAAC,GACxEuH,EAHK,IAI1B,CAGA,SAASC,EAAYvC,EAAevG,EAAe+I,EAAa,4CAA0D,CACtH,MAAM3C,EAAM,SAAS,cAAc,KAAK,EACxCA,EAAI,UAAY,4CAEhB,MAAMmC,EAAM,SAAS,cAAc,MAAM,EACzCA,EAAI,UAAY,mCAChBA,EAAI,YAAchC,EAElB,MAAMyC,EAAM,SAAS,cAAc,MAAM,EACzC,OAAAA,EAAI,UAAYD,EAChBC,EAAI,YAAchJ,EAElBoG,EAAI,YAAYmC,CAAG,EACnBnC,EAAI,YAAY4C,CAAG,EACZ5C,CACX,CAEO,SAAS6C,GAAgClH,EAAoBmE,EAAkD,CAClH,GAAI,CAACA,EAAc,MAAO,GAE1B,MAAMC,EAAO,MAAM,KAAKpE,EAAU,iBAA8B,KAAK,CAAC,EACtE,UAAWqE,KAAOD,EAAM,CACpB,MAAME,EAAQ,MAAM,KAAKD,EAAI,QAAQ,EAAE,OAClCE,GAAgCA,aAAiB,aAAeA,EAAM,UAAY,MAAA,EAEvF,GAAID,EAAM,OAAS,EAAG,SAEtB,MAAME,EAAQF,EAAM,CAAC,EAAE,aAAa,KAAA,EACpC,GAAIE,IAAU,SAAWA,IAAU,QAAUA,IAAU,iBAAkB,SAEzE,MAAMvG,EAAQqG,EAAMA,EAAM,OAAS,CAAC,EACpC,OAAIrG,EAAM,aAAa,KAAA,IAAWkG,GAC9BE,EAAI,QAAQ,uBAAyB,OAC9B,KAGXpG,EAAM,YAAckG,EACpBlG,EAAM,QAAQ,2BAA6B,OAC3CoG,EAAI,QAAQ,uBAAyB,OAC9B,GACX,CAEA,MAAO,EACX,CAEA,SAAS8C,GAAoBzC,EAAkB0C,EAA2C,CACtF,MAAMjB,EAAO,SAAS,cAAc,KAAK,EACzCA,EAAK,GAAKV,EACVU,EAAK,UAAY,oEAEjB,MAAMG,EAAQ,SAAS,cAAc,GAAG,EACxCA,EAAM,UAAY,yDAClBA,EAAM,YAAc,aAEpB,MAAMlC,EAAO,SAAS,cAAc,KAAK,EACzCA,EAAK,UAAY,cACjBA,EAAK,YAAY2C,EAAY,KAAMrC,EAAQ,YAAc,EAAE,CAAC,EAC5DN,EAAK,YAAY2C,EAAY,OAAQrC,EAAQ,cAAgB,GAAI,mEAAmE,CAAC,EACrIN,EAAK,YAAY2C,EAAY,MAAOrC,EAAQ,cAAgB,EAAE,CAAC,EAC/DN,EAAK,YAAY2C,EAAY,QAASK,CAAoB,CAAC,EACvD1C,EAAQ,oBACRN,EAAK,YAAY2C,EAAY,QAASrC,EAAQ,kBAAkB,CAAC,EAGrE,MAAM2C,EAAS,SAAS,cAAc,GAAG,EACzC,OAAAA,EAAO,UAAY,6CACnBA,EAAO,YAAc,mCAErBlB,EAAK,YAAYG,CAAK,EACtBH,EAAK,YAAY/B,CAAI,EACrB+B,EAAK,YAAYkB,CAAM,EAChBlB,CACX,CAEA,SAASmB,GAAgB3D,EAAkC,CACvD,MAAMU,EAAM,SAAS,cAAc,KAAK,EACxCA,EAAI,GAAKqB,EACTrB,EAAI,UAAY,0DAEhB,MAAMkD,EAAQ,SAAS,cAAc,KAAK,EAC1CA,EAAM,UAAY,oCAElB,MAAM/C,EAAQ,SAAS,cAAc,MAAM,EAC3CA,EAAM,UAAY,2CAClBA,EAAM,YAAc,MAEpB,MAAMvE,EAAM,SAAS,cAAc,QAAQ,EAC3C,OAAAA,EAAI,KAAO,SACXA,EAAI,UAAY,8GAChBA,EAAI,YAAc,SAElBA,EAAI,iBAAiB,QAAS,SAAY,CACtCA,EAAI,SAAW,GACfA,EAAI,YAAc,UAClB,MAAMtG,EAAO,MAAMoM,GAAiBpC,CAAW,EAG/C,GAFA1D,EAAI,SAAW,GACfA,EAAI,YAAc,SACdtG,EAAM,CACN,MAAMoL,EAAY,OAA8C,gBAE5DA,GACA,IAAIA,EAAS,CAAE,IAAKpL,EAAK,YAAa,SAAUA,EAAK,iBAAkB,CAE/E,CACJ,CAAC,EAED4N,EAAM,YAAY/C,CAAK,EACvB+C,EAAM,YAAYtH,CAAG,EACrBoE,EAAI,YAAYkD,CAAK,EACdlD,CACX,CAEA,eAAec,GAAUxB,EAAuC,CAC5D,MAAMZ,EAAY8C,GAAkBlC,CAAW,EAE/C,GAAI,CAACZ,EAAW,CAGZ,GAAI,CAAC,SAAS,eAAe4C,CAAe,EAAG,CAC3C,MAAM3F,EAAY2G,GAAA,EAClB,GAAI,CAAC3G,EAAW,MAAO,GACvB,MAAMkG,EAAO,MAAMF,GAAqBrC,CAAW,EAC/CuC,GAAM,YACNlG,EAAU,YAAYiG,GAAsBC,CAAI,CAAC,EACjD,QAAQ,KAAK,IAAI7C,CAAS,mDAAmD,EAErF,CACA,MAAO,EACX,CAEA,KAAM,CAAE,QAAAqB,GAAY3B,EACpB,GAAI,CAAC2B,GAAWA,EAAQ,cAAgB,SAAU,MAAO,GAEzD,MAAM8C,EAAa9C,EAAQ,iBAAmB,SAAW,CAAC,CAACA,EAAQ,WAE7D+C,EAAe,CAAC,CAAC/C,EAAQ,gBAAkB,CAAC,CAACA,EAAQ,QAErDgD,EAAgBhD,EAAQ,iBAAmB,SAAW,CAAC,CAACA,EAAQ,aAEhEiD,EAAe,CAACH,GAAiB,CAAC,CAAC,SAAS,eAAe/B,CAAQ,EACnEmC,EAAe,CAACH,GAAiB,CAAC,CAAC,SAAS,eAAe/B,CAAM,EAEjEmC,EAAe,CAACH,GAAiB,CAAC,CAAC,SAAS,eAAe/B,CAAe,EAEhF,GAAIgC,GAAaC,GAAeC,EAAU,MAAO,GAEjD,MAAM7H,EAAY2G,GAAA,EAClB,GAAI,CAAC3G,EAAW,MAAO,GAEvB,MAAM6E,EAAc4C,EAAe,MAAM1B,GAAiBpC,CAAW,EAAI,KACnEmE,EAAiBZ,GACnBlH,EACA6E,GAAa,4BAAA,EAGjB,GAAI,CAAC,SAAS,eAAeY,CAAQ,GAAK+B,EACtC,OAAAxH,EAAU,YAAYmH,GAAoBzC,EAAS3B,EAAU,wBAA0B,EAAE,CAAC,EAC1F,QAAQ,KAAK,IAAIM,CAAS,4CAA4C,EAC/D,GAGX,GAAI,CAAC,SAAS,eAAeqC,CAAM,GAAK+B,EACpC,OAAAzH,EAAU,YAAYsH,GAAgB3D,CAAW,CAAC,EAClD,QAAQ,KAAK,IAAIN,CAAS,gDAAgD,EACnE,GAOX,GAJIyE,GACA,QAAQ,KAAK,IAAIzE,CAAS,uDAAuD,EAGjF,CAAC,SAAS,eAAesC,CAAe,GAAK+B,EAAe,CAC5D,MAAMxB,EAAO,MAAMF,GAAqBrC,CAAW,EACnD,GAAIuC,GAAM,UACNlG,EAAU,YAAYiG,GAAsBC,CAAI,CAAC,EACjD,QAAQ,KAAK,IAAI7C,CAAS,mDAAmD,MAG7E,OAAO,EAEf,CAEA,MAAO,EACX,CAEA,SAAS0E,GAAapE,EAA2B,CAC7C,IAAIqE,EAAW,EACf,MAAMC,EAAK,YAAY,IAAM,CACzBD,IACK7C,GAAUxB,CAAW,EAAE,KAAKuE,GAAQ,EACjCA,GAAQF,GAAY,KAAI,cAAcC,CAAE,CAChD,CAAC,CACL,EAAG,GAAG,CACV,CAEA,SAASE,IAAsB,CAC3B,MAAMC,EAAQ,SAAS,SAAS,MAAMxC,EAAa,EAC/CwC,GAAOL,GAAaK,EAAM,CAAC,CAAC,CACpC,CAEO,SAASC,IAAuC,CACnD,GAAI,OAAO,OAAW,IAAa,OACnC,MAAMjG,EAAI,OACV,GAAIA,EAAEkB,EAAI,EAAG,OACblB,EAAEkB,EAAI,EAAI,GAEV,QAAQ,KAAK,IAAID,CAAS,wCAAwC,EAElE,MAAMiC,EAAW,CAACC,EAAQ,OAAS,WAAW4C,GAAe5C,CAAK,EAE9D,SAAS,aAAe,UACxB,SAAS,iBAAiB,mBAAoB,IAAMD,EAAA,CAAU,EAE9DA,EAAA,EAGJ,MAAME,EAAW,QAAQ,UAAU,KAAK,OAAO,EAC/C,QAAQ,UAAY,IAAIxE,IAA+C,CACnEwE,EAAS,GAAGxE,CAAI,EAChBsE,EAAS,GAAG,CAChB,EACA,OAAO,iBAAiB,WAAY,IAAMA,EAAS,GAAG,CAAC,CAC3D,CCnZA,MAAMjC,GAAY,qBACZC,GAAO,wCACPgF,GAAc,wBACdC,GAAgB,2CAChBC,GAAyB,IACzBC,GAAsB,IAkBtBC,GAA4C,CAC9C,CACI,GAAI,eACJ,UAAW,QACX,OAAQ,CAAC,kBAAmB,qBAAsB,sBAAuB,0BAA0B,EACnG,GAAI,CACA,QAAS,QACT,YAAa,sBACb,MAAO,qBAAA,EAEX,GAAI,CACA,QAAS,QACT,YAAa,2BACb,MAAO,0BAAA,EAEX,SAAU,IACV,cAAe,uBAAA,EAEnB,CACI,GAAI,kBACJ,UAAW,WACX,OAAQ,CAAC,kBAAmB,2BAA4B,wBAAyB,sBAAuB,qBAAsB,wCAAwC,EACtK,GAAI,CACA,QAAS,aACT,YAAa,2BACb,MAAO,0BAAA,EAEX,GAAI,CACA,QAAS,mBACT,YAAa,yCACb,MAAO,wCAAA,EAEX,SAAU,IACV,cAAe,yBAAA,EAEnB,CACI,GAAI,wBACJ,UAAW,iBACX,OAAQ,CAAC,sBAAuB,6BAA8B,gCAAiC,4BAA6B,2BAA4B,2CAA2C,EACnM,GAAI,CACA,QAAS,cACT,YAAa,6BACb,MAAO,4BAAA,EAEX,GAAI,CACA,QAAS,oBACT,YAAa,4CACb,MAAO,2CAAA,EAEX,SAAU,KACV,cAAe,yBAAA,EAEnB,CACI,GAAI,kBACJ,UAAW,WACX,OAAQ,CAAC,kBAAmB,sBAAuB,wBAAyB,sBAAuB,qBAAsB,8BAA8B,EACvJ,GAAI,CACA,QAAS,QACT,YAAa,sBACb,MAAO,qBAAA,EAEX,GAAI,CACA,QAAS,YACT,YAAa,+BACb,MAAO,8BAAA,EAEX,SAAU,IACV,cAAe,6BAAA,EAEnB,CACI,GAAI,kBACJ,UAAW,WACX,OAAQ,CAAC,iBAAkB,qBAAsB,yBAA0B,sBAAuB,8BAA8B,EAChI,GAAI,CACA,QAAS,OACT,YAAa,qBACb,MAAO,oBAAA,EAEX,GAAI,CACA,QAAS,YACT,YAAa,+BACb,MAAO,8BAAA,EAEX,SAAU,IACV,cAAe,wBAAA,CAEvB,EAEA,IAAIlM,GAAoC,KACpCmM,EAA4B,KAC5BC,EAAa,GAEjB,SAASC,IAAwC,CAC7C,OAAO,MACX,CAEA,SAASC,GAA0B,CAC/B,OAAOR,GAAY,KAAK,OAAO,SAAS,QAAQ,CACpD,CAEA,SAASS,GAAe9K,EAA0C,CAC9D,OAAQA,GAAS,IAAI,QAAQ,OAAQ,GAAG,EAAE,KAAA,CAC9C,CAEA,SAAS+K,IAAwB,CAG7B,OAFa,SAAS,gBAAgB,MAAQ,UAAU,UAAY,IAExD,cAAc,WAAW,IAAI,CAC7C,CAEA,SAASC,GAAQC,EAA4C,CACzD,OAAOF,GAAA,EAAiBE,EAAW,GAAKA,EAAW,EACvD,CAEA,SAASC,GAAYlL,EAAuB,CACxC,OAAOA,EACF,WAAW,QAAS,QAAa,EACjC,WAAW,QAAS,QAAa,EACjC,WAAW,YAAa,YAAiB,EACzC,WAAW,YAAa,YAAiB,CAClD,CAEA,SAASmL,GAAmBnB,EAAkD,CAC1E,OAAOS,GAAqB,KAAMQ,GAAeA,EAAW,KAAOjB,CAAE,GAAK,IAC9E,CAEA,SAASoB,GAAwBC,EAAqD,CAClF,MAAMC,EAAmBH,GAAmBE,EAAO,QAAQ,mBAAmB,EAC9E,GAAIC,EAAkB,OAAOA,EAE7B,MAAMhJ,EAAOwI,GAAeO,EAAO,WAAW,EAE9C,OAAOZ,GAAqB,KAAMQ,GAC9BA,EAAW,OAAO,KAAM1E,GAAUjE,EAAK,SAASiE,CAAK,CAAC,CACzD,GAAK,IACV,CAEA,SAASgF,GAAeF,EAA+C,CACnE,OAAOA,EAAO,cAA2B,oDAAoD,GACtFA,EAAO,cAA2B,oBAAoB,CACjE,CAEA,SAASG,GAAqBH,EAA2BI,EAAuBC,EAAiC,CAC7GL,EAAO,MAAM,UAAY,OAEzB,MAAMjF,EAAMmF,GAAeF,CAAM,EAC7BjF,IACAA,EAAI,MAAM,eAAiB,aAC3BA,EAAI,MAAM,UAAY,OACtBA,EAAI,MAAM,MAAQ,QAGtB,MAAMuF,EAAgBF,GAAS,eAAiBC,GAAa,cACzDC,aAAyB,cACzBA,EAAc,MAAM,UAAY,OAChCA,EAAc,MAAM,SAAW,IAEvC,CAEA,SAASC,GAAWX,EAAgD,CAChE,MAAMY,EAAO,SAAS,cAAc,MAAM,EAC1C,OAAAA,EAAK,QAAQ,kBAAoB,OACjCA,EAAK,QAAQ,oBAAsBZ,EAAW,GAC9CY,EAAK,aAAa,cAAe,MAAM,EACvCA,EAAK,UAAY,wEAAwEZ,EAAW,aAAa,GACjHY,EAAK,MAAM,MAAQ,OACnBA,EAAK,MAAM,OAAS,OACpBA,EAAK,MAAM,KAAO,WAClBA,EAAK,YAAcZ,EAAW,SAEvBY,CACX,CAEA,SAASC,GAA6BT,EAAiC,CACnE,OAAOA,EAAO,QAAQ,2BACtB,OAAOA,EAAO,QAAQ,2BACtB,OAAOA,EAAO,QAAQ,4BAEtBA,EAAO,iBAA8B,iFAAiF,EAAE,QAASU,GAAY,CACzIA,EAAQ,OAAA,CACZ,CAAC,EAEDV,EAAO,iBAA8B,0JAA0J,EAAE,QAASU,GAAY,CAClN,OAAOA,EAAQ,QAAQ,4BACvB,OAAOA,EAAQ,QAAQ,gCACvB,OAAOA,EAAQ,QAAQ,wBACvB,OAAOA,EAAQ,QAAQ,2BAC3B,CAAC,CACL,CAEA,SAASC,GAAgBX,EAA2C,CAChE,OAAOA,EAAO,cAAc,iFAAiF,GACtGA,EAAO,cAAc,oCAAoC,GACzDA,EAAO,cAAc,KAAK,GAC1BA,EAAO,cAAc,mCAAmC,CACnE,CAEA,SAASY,GAAWZ,EAA2BJ,EAAqC,CAChF,MAAMiB,EAAeb,EAAO,cAA2B,oCAAoC,EAC3F,GAAIa,EAAc,CACdA,EAAa,QAAQ,oBAAsBjB,EAAW,GACtDiB,EAAa,UAAY,wEAAwEjB,EAAW,aAAa,GACzHiB,EAAa,YAAcjB,EAAW,SACtC,MACJ,CAEA,MAAMY,EAAOD,GAAWX,CAAU,EAC5BkB,EAAOH,GAAgBX,CAAM,EACnC,GAAIc,GAAQA,EAAK,cAAe,CAC5BA,EAAK,YAAYN,CAAI,EACrB,MACJ,CAEYN,GAAeF,CAAM,GAC5B,QAAQQ,CAAI,CACrB,CAEA,SAASO,GAAkBf,EAA2BJ,EAAqC,CACvF,MAAMoB,EAAa,MAAM,KAAKhB,EAAO,iBAAuC,GAAG,CAAC,EAC1EiB,EAAOtB,GAAQC,CAAU,EACzBsB,EAAcrB,GAAYoB,EAAK,OAAO,EACtCE,EAAkBtB,GAAYoB,EAAK,WAAW,EAE9Cb,EAAUY,EAAW,CAAC,EACtBX,EAAcW,EAAW,CAAC,EAE5BZ,GAAWA,EAAQ,cAAgBc,IACnCd,EAAQ,YAAcc,GAEtBd,IACAA,EAAQ,aAAa,aAAca,EAAK,OAAO,EAC/Cb,EAAQ,MAAM,UAAY,OAC1BA,EAAQ,MAAM,WAAa,SAC3BA,EAAQ,MAAM,UAAY,WAC1BA,EAAQ,MAAM,aAAe,YAG7BC,GAAeA,EAAY,cAAgBc,IAC3Cd,EAAY,YAAcc,GAE1Bd,IACAA,EAAY,MAAM,UAAY,OAC9BA,EAAY,MAAM,SAAW,OAC7BA,EAAY,MAAM,WAAa,OAC/BA,EAAY,MAAM,WAAa,SAC/BA,EAAY,MAAM,UAAY,WAC9BA,EAAY,MAAM,aAAe,YAGrCF,GAAqBH,EAAQI,EAASC,CAAW,EACjDL,EAAO,MAAQiB,EAAK,KACxB,CAEA,SAASG,GAAWpB,EAA2BJ,EAAqC,CAChF,GAAI/O,EAAuB+O,EAAW,EAAE,GAAK,CAAC7O,IAAqB,CAC/DiP,EAAO,OAAS,GAChBA,EAAO,SAAW,GAClBA,EAAO,MAAM,QAAU,OACvBA,EAAO,aAAa,cAAe,MAAM,EACzCA,EAAO,QAAQ,oBAAsBJ,EAAW,GAChDI,EAAO,QAAQ,oBAAsB,OACrC,OAAOA,EAAO,QAAQ,qBACtB,MACJ,CAEIA,EAAO,SAAQA,EAAO,OAAS,IAC/BA,EAAO,WAAUA,EAAO,SAAW,IACnCA,EAAO,MAAM,UAAY,QAAQA,EAAO,MAAM,eAAe,SAAS,EAC1EA,EAAO,gBAAgB,aAAa,EACpCA,EAAO,QAAQ,oBAAsBJ,EAAW,GAChDI,EAAO,QAAQ,qBAAuB,OACtC,OAAOA,EAAO,QAAQ,oBAEtBS,GAA6BT,CAAM,EACnCY,GAAWZ,EAAQJ,CAAU,EAC7BmB,GAAkBf,EAAQJ,CAAU,CACxC,CAEA,SAASyB,GAAmCC,EAA2B,CACnE,MAAMC,EAA4C,CAC9C,kBAAmB,CAAC,kBAAmB,uBAAuB,EAC9D,kBAAmB,CAAC,iBAAiB,CAAA,EAEzC,IAAIC,EAAU,GAEd,cAAO,QAAQD,CAAe,EAAE,QAAQ,CAAC,CAACE,EAAgBC,CAAa,IAAM,CACzD,MAAM,KAAKJ,EAAK,iBAAoC,8CAA8CG,CAAc,IAAI,CAAC,EAChI,OAAQzB,GAAW,CAACA,EAAO,QAAQ,mBAAmB,EAEnD,MAAM,CAAC,EAAE,QAAQ,CAACA,EAAQ2B,IAAU,CACxC,MAAM/B,EAAaE,GAAmB4B,EAAcC,CAAK,CAAC,EACrD/B,IAELwB,GAAWpB,EAAQJ,CAAU,EAC7B4B,EAAU,GACd,CAAC,CACL,CAAC,EAEMA,CACX,CAEA,eAAsBI,EAClBN,EAAmB,SACH,CAEhB,GADI,OAAO,OAAW,KAAe,OAAO,SAAa,KACrD,CAAC9B,EAAA,EAAkB,MAAO,GAE9B,IAAIgC,EAAU,GAEd,OAAAF,EAAK,iBAAoC,QAAQ,EAAE,QAAStB,GAAW,CACnE,MAAMJ,EAAaG,GAAwBC,CAAM,EAC5CJ,IAELwB,GAAWpB,EAAQJ,CAAU,EAC7B4B,EAAU,GACd,CAAC,EAEGH,GAAmCC,CAAI,IACvCE,EAAU,IAGPA,CACX,CAEA,SAASK,IAAkB,CACnBvC,IACJA,EAAa,GAEb,OAAO,WAAW,IAAM,CACpBA,EAAa,GACRsC,EAAA,CACT,EAAG,CAAC,EACR,CAEA,SAASE,IAAoB,CACrBzC,IAAe,OAEnB,OAAO,cAAcA,CAAU,EAC/BA,EAAa,KACjB,CAEA,SAAS0C,GAAkB,CACvB,GAAI,CAACvC,IAAkB,OAEvBsC,GAAA,EACKF,EAAA,EAEL,IAAIlD,EAAW,EACfW,EAAa,OAAO,YAAY,IAAM,CAClCX,GAAY,EACPkD,EAAA,EAEDlD,GAAYS,IACZ2C,GAAA,CAER,EAAG5C,EAAsB,EAEzB,MAAM1G,EAAO,SAAS,KAClBA,EAAKyG,EAAa,IACtBzG,EAAKyG,EAAa,EAAI,GAEtB/L,GAAW,IAAI,iBAAiB,IAAM2O,IAAW,EACjD3O,GAAS,QAAQ,SAAS,KAAM,CAAE,UAAW,GAAM,QAAS,GAAM,cAAe,EAAA,CAAM,EAC3F,CAEA,SAAS2L,IAAsB,CACvBW,EAAA,GAAkBuC,EAAA,CAC1B,CAEO,SAASC,IAAuC,CACnD,GAAI,OAAO,OAAW,KAAe,OAAO,SAAa,IAAa,OACtE,MAAMlJ,EAAIyG,GAAA,EACV,GAAIzG,EAAEkB,EAAI,EAAG,OACblB,EAAEkB,EAAI,EAAI,GAEV,QAAQ,KAAK,IAAID,EAAS,2CAA2C,EAEjE,SAAS,aAAe,UACxB,SAAS,iBAAiB,mBAAoB,IAAMgI,EAAA,CAAW,EAE/DA,EAAA,EAGJ,MAAM7F,EAAW,QAAQ,UAAU,KAAK,OAAO,EAC/C,QAAQ,UAAY,IAAIxE,IAA+C,CACnEwE,EAAS,GAAGxE,CAAI,EAChB,OAAO,WAAW,IAAMmH,GAAA,EAAiB,GAAG,CAChD,EACA,OAAO,iBAAiB,WAAY,IAAM,OAAO,WAAW,IAAMA,KAAiB,GAAG,CAAC,CAC3F,CCjaA,MAAM9E,GAAY,qBACZC,GAAO,4CACPiI,GAAoB,oCACpBhD,GAAgB,2CAChBiD,GAAY,8BACZC,GAAY,kEAElB,IAAIjP,GAAoC,KACpCmM,EAA4B,KAC5BC,EAAa,GAEjB,SAASC,IAAwC,CAC7C,OAAO,MACX,CAEA,SAAS6C,GAA+B,CACpC,GAAI,CAACH,GAAkB,KAAK,OAAO,SAAS,QAAQ,EAAG,MAAO,GAE9D,MAAMI,EAAM,IAAI,gBAAgB,OAAO,SAAS,MAAM,EAAE,IAAI,KAAK,EACjE,OAAOA,IAAQ,MAAQA,IAAQ,gBACnC,CAEA,SAASC,IAAqB,CAG1B,OAFa,SAAS,gBAAgB,MAAQ,UAAU,UAAY,IAExD,YAAA,EAAc,WAAW,IAAI,EAAIJ,GAAYC,EAC7D,CAEA,SAAS1C,GAAe9K,EAA0C,CAC9D,OAAQA,GAAS,IAAI,QAAQ,OAAQ,GAAG,EAAE,KAAA,CAC9C,CAEA,SAAS4N,GAAgB7B,EAA+B,CACpD,MAAMzJ,EAAOwI,GAAeiB,EAAQ,WAAW,EAE/C,OAAOzJ,IAAS,QAAUA,IAAS,WACvC,CAEA,SAASuL,IAAgC,CACrC,MAAMzE,EAAS,SAAS,cAAc,MAAM,EAC5C,OAAAA,EAAO,QAAQ,0BAA4B,OAC3CA,EAAO,UAAY,oBACnBA,EAAO,MAAM,QAAU,QACvBA,EAAO,MAAM,MAAQ,OACrBA,EAAO,MAAM,UAAY,OACzBA,EAAO,MAAM,UAAY,MACzBA,EAAO,MAAM,SAAW,OACxBA,EAAO,MAAM,WAAa,OAC1BA,EAAO,YAAcuE,GAAA,EAEdvE,CACX,CAEO,SAAS0E,EAAyBnB,EAAmB,SAAmB,CAI3E,GAHI,OAAO,OAAW,KAAe,OAAO,SAAa,KACrD,CAACc,EAAA,GACY3C,GAAe,SAAS,MAAM,WAAa,SAAS,MAAM,WAAW,EACzE,SAAS6C,GAAA,CAAY,EAAG,MAAO,GAE5C,MAAMI,EAAgB,MAAM,KAAKpB,EAAK,iBAA8B,cAAc,CAAC,EAC9E,KAAKiB,EAAe,EACzB,OAAKG,GAELA,EAAc,sBAAsB,WAAYF,IAAc,EACvD,IAHoB,EAI/B,CAEA,SAASX,IAAkB,CACnBvC,IACJA,EAAa,GAEb,OAAO,WAAW,IAAM,CACpBA,EAAa,GACbmD,EAAA,CACJ,EAAG,CAAC,EACR,CAEA,SAASX,IAAoB,CACrBzC,IAAe,OAEnB,OAAO,cAAcA,CAAU,EAC/BA,EAAa,KACjB,CAEA,SAAS0C,GAAkB,CACvB,GAAI,CAACK,IAAuB,OAE5BN,GAAA,EACAW,EAAA,EAEA,IAAI/D,EAAW,EACfW,EAAa,OAAO,YAAY,IAAM,CAClCX,GAAY,GACR+D,EAAA,GAA8B/D,GAAY,KAC1CoD,GAAA,CAER,EAAG,GAAG,EAEN,MAAMtJ,EAAO,SAAS,KAClBA,EAAKyG,EAAa,IACtBzG,EAAKyG,EAAa,EAAI,GAEtB/L,GAAW,IAAI,iBAAiB,IAAM2O,IAAW,EACjD3O,GAAS,QAAQ,SAAS,KAAM,CAAE,UAAW,GAAM,QAAS,GAAM,cAAe,EAAA,CAAM,EAC3F,CAEA,SAAS2L,IAAsB,CACvBuD,EAAA,GAAuBL,EAAA,CAC/B,CAEO,SAASY,IAA2C,CACvD,GAAI,OAAO,OAAW,KAAe,OAAO,SAAa,IAAa,OACtE,MAAM7J,EAAIyG,GAAA,EACV,GAAIzG,EAAEkB,EAAI,EAAG,OACblB,EAAEkB,EAAI,EAAI,GAEV,QAAQ,KAAK,IAAID,EAAS,6CAA6C,EAEnE,SAAS,aAAe,UACxB,SAAS,iBAAiB,mBAAoB,IAAMgI,EAAA,CAAW,EAE/DA,EAAA,EAGJ,MAAM7F,EAAW,QAAQ,UAAU,KAAK,OAAO,EAC/C,QAAQ,UAAY,IAAIxE,IAA+C,CACnEwE,EAAS,GAAGxE,CAAI,EAChB,OAAO,WAAW,IAAMmH,GAAA,EAAiB,GAAG,CAChD,EACA,OAAO,iBAAiB,WAAY,IAAM,OAAO,WAAW,IAAMA,KAAiB,GAAG,CAAC,CAC3F,CClIA,MAAM9E,GAAY,qBACZC,GAAO,mDACPiF,GAAgB,sDAChBgD,GAAoB,oCACpBW,GAAgB,gDAChB1D,GAAyB,IACzBC,GAAsB,IAUtB0D,GAAiE,CACnE,CACI,GAAI,eACJ,OAAQ,CAAC,kBAAmB,sBAAuB,0BAA0B,EAC7E,YAAa,CAAC,OAAO,EACrB,UAAW,CAAC,GAAG,EACf,cAAe,uBAAA,EAEnB,CACI,GAAI,kBACJ,OAAQ,CAAC,kBAAmB,2BAA4B,sBAAuB,wCAAwC,EACvH,YAAa,CAAC,aAAc,kBAAkB,EAC9C,UAAW,CAAC,GAAG,EACf,cAAe,yBAAA,EAEnB,CACI,GAAI,wBACJ,OAAQ,CAAC,sBAAuB,6BAA8B,4BAA6B,2CAA2C,EACtI,YAAa,CAAC,cAAe,mBAAmB,EAChD,UAAW,CAAC,IAAI,EAChB,cAAe,yBAAA,EAEnB,CACI,GAAI,kBACJ,OAAQ,CAAC,kBAAmB,sBAAuB,sBAAuB,8BAA8B,EACxG,YAAa,CAAC,QAAS,WAAW,EAClC,UAAW,CAAC,GAAG,EACf,cAAe,6BAAA,EAEnB,CACI,GAAI,kBACJ,OAAQ,CAAC,iBAAkB,qBAAsB,sBAAuB,8BAA8B,EACtG,YAAa,CAAC,OAAQ,WAAW,EACjC,UAAW,CAAC,GAAG,EACf,cAAe,wBAAA,CAEvB,EAEA,IAAI3P,GAAoC,KACpCmM,EAA4B,KAC5BC,GAAa,GAEjB,SAASC,IAAwC,CAC7C,OAAO,MACX,CAEA,SAAS6C,IAA+B,CACpC,GAAI,CAACH,GAAkB,KAAK,OAAO,SAAS,QAAQ,EAAG,MAAO,GAE9D,MAAMI,EAAM,IAAI,gBAAgB,OAAO,SAAS,MAAM,EAAE,IAAI,KAAK,EACjE,OAAOA,IAAQ,MAAQA,IAAQ,IAAMA,IAAQ,gBACjD,CAEA,SAASS,GAAYpC,EAA0B,CAC3C,OAAOA,aAAmB,YAAcA,EAAQ,UAAY,EAChE,CAEA,SAASqC,GAAepO,EAA0C,CAC9D,OAAQA,GAAS,IACZ,QAAQ,UAAW,EAAE,EACrB,QAAQ,OAAQ,GAAG,EACnB,KAAA,CACT,CAEA,SAASqO,GAAoBtC,EAA+B,CACxD,MAAMuC,EAAYH,GAAYpC,CAAO,EAErC,OAAOuC,EAAU,SAAS,YAAY,GAC9BA,EAAU,SAAS,aAAa,GAAKA,EAAU,SAAS,QAAQ,GAAKA,EAAU,SAAS,OAAO,CAC3G,CAEA,SAASC,GAAiBC,EAAuC,CAC7D,OAAOA,EAAK,cAA2B,cAAc,CACzD,CAEA,SAASC,GAAsBD,EAAuD,CAClF,MAAMnG,EAAQ+F,GAAeG,GAAiBC,CAAI,GAAG,WAAW,EAC1DlM,EAAO8L,GAAeI,EAAK,WAAW,EAE5C,OAAON,GAAgC,KAAMjD,GACzCA,EAAW,YAAY,KAAM1E,GAAU8B,IAAU9B,CAAK,GACnD0E,EAAW,OAAO,KAAM1E,GAAUjE,EAAK,SAASiE,CAAK,CAAC,CAC5D,GAAK,IACV,CAEA,SAASmI,GAAuB/B,EAAiC,CAC7D,OAAO,MAAM,KAAKA,EAAK,iBAA8B,KAAK,CAAC,EACtD,OAAO0B,EAAmB,CACnC,CAEA,SAASrC,GAAgBwC,EAAmC,CAGxD,OAFc,MAAM,KAAKA,EAAK,iBAA0B,qBAAqB,CAAC,EAEjE,KAAMzC,GACf,CAACA,EAAQ,QAAQ,oBAAoB,GAClC,CAACA,EAAQ,QAAQkC,EAAa,GAC9B,CAAClC,EAAQ,QAAQ,+DAA+D,CACtF,GAAK,IACV,CAEA,SAAS4C,GAAsB9C,EAAuBZ,EAA+C,CACjGY,EAAK,QAAQ,4BAA8B,OAC3CA,EAAK,QAAQ,yBAA2BZ,EAAW,GACnDY,EAAK,aAAa,cAAe,MAAM,EACvCA,EAAK,UAAY,gEAAgEZ,EAAW,aAAa,GACzGY,EAAK,MAAM,MAAQ,OACnBA,EAAK,MAAM,OAAS,OACpBA,EAAK,MAAM,KAAO,WAClBA,EAAK,MAAM,WAAa,IACxBA,EAAK,MAAM,SAAWZ,EAAW,UAAU,KAAK,EAAE,EAAE,OAAS,EAAI,MAAQ,OAEzE,MAAM2D,EAAe3D,EAAW,UAAU,KAAK,EAAE,EAC7CY,EAAK,cAAgB+C,IAEzB/C,EAAK,gBAAA,EACDZ,EAAW,UAAU,OAAS,GAC9BY,EAAK,MAAM,cAAgB,SAC3BZ,EAAW,UAAU,QAAS4D,GAAS,CACnC,MAAMC,EAAc,SAAS,cAAc,MAAM,EACjDA,EAAY,MAAM,WAAa,IAC/BA,EAAY,YAAcD,EAC1BhD,EAAK,YAAYiD,CAAW,CAChC,CAAC,IAEDjD,EAAK,MAAM,eAAe,gBAAgB,EAC1CA,EAAK,YAAcZ,EAAW,UAAU,CAAC,GAAK,IAEtD,CAEA,SAAS8D,GAAgB9D,EAA0D,CAC/E,MAAMY,EAAO,SAAS,cAAc,MAAM,EAC1C,OAAA8C,GAAsB9C,EAAMZ,CAAU,EAE/BY,CACX,CAEA,SAASmD,GAAcR,EAAmBvD,EAAkD,CACxF,MAAMgE,EAAWT,EAAK,cAA2BP,EAAa,EAC9D,GAAIgB,aAAoB,gBACpB,OAAAT,EAAK,QAAQ,yBAA2BvD,EAAW,GACnD0D,GAAsBM,EAAUhE,CAAU,EACnC,GAGX,MAAMY,EAAOkD,GAAgB9D,CAAU,EACjCkB,EAAOH,GAAgBwC,CAAI,EACjC,GAAIrC,GAAQA,EAAK,cACb,OAAAqC,EAAK,QAAQ,yBAA2BvD,EAAW,GACnDkB,EAAK,YAAYN,CAAI,EACd,GAGX,MAAMxD,EAAQkG,GAAiBC,CAAI,EACnC,OAAInG,GAASA,EAAM,eACfmG,EAAK,QAAQ,yBAA2BvD,EAAW,GACnD5C,EAAM,cAAc,aAAawD,EAAMxD,CAAK,EACrC,IAGJ,EACX,CAEO,SAAS6G,GAAqCvC,EAAmB,SAAmB,CAEvF,GADI,OAAO,OAAW,KAAe,OAAO,SAAa,KACrD,CAACc,GAAA,EAAuB,MAAO,GAEnC,IAAI0B,EAAU,GAEd,OAAAT,GAAuB/B,CAAI,EAAE,QAAS6B,GAAS,CAC3C,MAAMvD,EAAawD,GAAsBD,CAAI,EACxCvD,GAED+D,GAAcR,EAAMvD,CAAU,IAC9BkE,EAAU,GAElB,CAAC,EAEMA,CACX,CAEA,SAASjC,IAAkB,CACnBvC,KACJA,GAAa,GAEb,OAAO,WAAW,IAAM,CACpBA,GAAa,GACbuE,GAAA,CACJ,EAAG,CAAC,EACR,CAEA,SAAS/B,IAAoB,CACrBzC,IAAe,OAEnB,OAAO,cAAcA,CAAU,EAC/BA,EAAa,KACjB,CAEA,SAAS0C,IAAkB,CACvB,GAAI,CAACK,KAAuB,OAE5BN,GAAA,EACA+B,GAAA,EAEA,IAAInF,EAAW,EACfW,EAAa,OAAO,YAAY,IAAM,CAClCX,GAAY,EACZmF,GAAA,EAEInF,GAAYS,IACZ2C,GAAA,CAER,EAAG5C,EAAsB,EAEzB,MAAM1G,EAAO,SAAS,KAClBA,EAAKyG,EAAa,IACtBzG,EAAKyG,EAAa,EAAI,GAEtB/L,GAAW,IAAI,iBAAiB,IAAM2O,IAAW,EACjD3O,GAAS,QAAQ,SAAS,KAAM,CAAE,UAAW,GAAM,QAAS,GAAM,cAAe,EAAA,CAAM,EAC3F,CAEA,SAAS2L,IAAsB,CAC3B,GAAIuD,KAAuB,CACvBL,GAAA,EACA,MACJ,CAEAD,GAAA,CACJ,CAEO,SAASiC,IAA+C,CAC3D,GAAI,OAAO,OAAW,KAAe,OAAO,SAAa,IAAa,OACtE,MAAMjL,EAAIyG,GAAA,EACV,GAAIzG,EAAEkB,EAAI,EAAG,OACblB,EAAEkB,EAAI,EAAI,GAEV,QAAQ,KAAK,IAAID,EAAS,6CAA6C,EAEnE,SAAS,aAAe,UACxB,SAAS,iBAAiB,mBAAoB,IAAMgI,GAAA,CAAW,EAE/DA,GAAA,EAGJ,MAAM7F,EAAW,QAAQ,UAAU,KAAK,OAAO,EAC/C,QAAQ,UAAY,IAAIxE,IAA+C,CACnEwE,EAAS,GAAGxE,CAAI,EAChB,OAAO,WAAW,IAAMmH,GAAA,EAAiB,GAAG,CAChD,EACA,OAAO,iBAAiB,WAAY,IAAM,OAAO,WAAW,IAAMA,KAAiB,GAAG,CAAC,CAC3F,CC1QA,MAAM9E,GAAY,qBACZC,GAAO,+CAEPgK,GAAsB,wCAQ5B,SAAS7J,IAA0B,CAC/B,OAAO,aAAa,QAAQ,YAAY,CAC5C,CAEA,eAAe8J,GAA4B5J,EAA6D,CACpG,MAAMC,EAAQH,GAAA,EACd,GAAI,CAACG,EAAO,OAAO,KAEnB,GAAI,CACA,MAAMC,EAAM,MAAM,MAAM,gBAAgBR,EAAS,iBAAiBM,CAAW,sBAAuB,CAChG,QAAS,CAAE,cAAe,UAAUC,CAAK,GAAI,OAAQ,kBAAA,CAAmB,CAC3E,EACD,GAAI,CAACC,EAAI,GAAI,OAAO,KAEpB,MAAMlC,EAAQ,MAAMkC,EAAI,KAAA,EACxB,OAAQ,SAAUlC,EAAOA,EAAK,KAAOA,IAAS,IAClD,MAAQ,CACJ,OAAO,IACX,CACJ,CAEA,SAAS6L,GAAsBjO,EAA4B,CACvD,OAAO,MAAM,KAAKA,EAAG,QAAQ,EAAE,OAC1BgF,GAAgCA,aAAiB,WAAA,CAE1D,CAEA,SAASkJ,GAA0B7C,EAAezG,EAA+B,CAC7E,IAAIuJ,EAAU,GAEd,MAAMtJ,EAAO,MAAM,KAAKwG,EAAK,iBAA8B,KAAK,CAAC,EACjE,UAAWvG,KAAOD,EAAM,CACpB,MAAMuJ,EAAWH,GAAsBnJ,CAAG,EACpCuJ,EAAaD,EAAS,UAAUpJ,GAASA,EAAM,aAAa,KAAA,IAAW,MAAM,EACnF,GAAIqJ,EAAa,EAAG,SAEpB,MAAM3P,EAAQ0P,EACT,MAAMC,EAAa,CAAC,EACpB,KAAKrJ,GAASA,EAAM,aAAa,QAAUA,EAAM,YAAY,KAAA,IAAW,MAAM,EACnF,GAAI,CAACtG,EAAO,SAEZ,MAAM4P,EAAcF,EACf,MAAMC,EAAa,CAAC,EACpB,KAAKrJ,GAAS,WAAW,KAAKA,EAAM,aAAa,KAAA,GAAU,EAAE,CAAC,EAC7DuJ,EAAkBD,GAAa,aAAa,KAAA,EAAO,QAAQ,WAAY,EAAE,GAAK,GAC9EE,EAAmBD,GAAmB3J,EAAa,SAAS,GAAG,EAC/DA,EAAa,QAAQ,MAAO,KAAK2J,CAAe,GAAG,EACnD3J,EAEFlG,EAAM,aAAa,KAAA,IAAW8P,IAC9B9P,EAAM,YAAc8P,EACpB9P,EAAM,QAAQ,2BAA6B,QAE/CoG,EAAI,QAAQ,uBAAyB,cACjCwJ,GAAeC,IACfD,EAAY,YAAc,GAC1BA,EAAY,MAAM,QAAU,OAC5BA,EAAY,QAAQ,+BAAiC,QAEzDH,EAAU,EACd,CAEA,OAAOA,CACX,CAEA,SAASM,GAAwBpD,EAAeqD,EAAmBC,EAAgC,CAK/F,MAAM7H,EAJa,MAAM,KAAKuE,EAAK,iBAA8B,MAAM,CAAC,EAAE,OACtErL,GAAMA,EAAG,aAAa,KAAA,IAAW0O,CAAA,EAGZ,KAAK1O,GAAM,CAChC,MAAMgN,EAAY,OAAOhN,EAAG,WAAc,SAAWA,EAAG,UAAY,GACpE,OAAOgN,EAAU,SAAS,cAAc,GAAKA,EAAU,SAAS,aAAa,CACjF,CAAC,EAED,OAAKlG,GAELA,EAAM,YAAc6H,EACpB7H,EAAM,QAAQ,2BAA6B,OAC3CA,EAAM,QAAQ,yBAA2B,cAClC,IALY,EAMvB,CAEO,SAAS8H,GACZvD,EACAwD,EACO,CACP,MAAMjK,EAAeiK,GAAQ,kBACvBF,EAAgBE,GAAQ,4BACxBH,EAAYG,GAAQ,uBAE1B,GAAI,CAACjK,GAAgB,CAAC+J,EAAe,MAAO,GAE5C,MAAMG,EAAUZ,GAA0B7C,EAAMzG,CAAY,EACtDkC,EAAQ4H,EAAYD,GAAwBpD,EAAMqD,EAAWC,CAAa,EAAI,GAEpF,OAAOG,GAAWhI,CACtB,CAEA,eAAelB,GAAUxB,EAAuC,CAC5D,MAAMiH,EAAO,SAAS,eAAe,sBAAsB,GAAK,SAAS,eAAe,mBAAmB,EAC3G,GAAI,CAACA,EAAM,MAAO,GAElB,MAAMwD,EAAS,MAAMb,GAA4B5J,CAAW,EAC5D,OAAKyK,GAEWD,GAA+BvD,EAAMwD,CAAM,GAEvD,QAAQ,KAAK,IAAI/K,EAAS,wDAAwD,EAG/E,EACX,CAEA,SAAS0E,GAAapE,EAA2B,CAC7C,IAAIqE,EAAW,EACf,MAAMC,EAAK,YAAY,IAAM,CACzBD,IACK7C,GAAUxB,CAAW,EAAE,KAAKuE,GAAQ,EACjCA,GAAQF,GAAY,KAAI,cAAcC,CAAE,CAChD,CAAC,CACL,EAAG,GAAG,CACV,CAEA,SAASE,IAAsB,CAC3B,MAAMC,EAAQ,SAAS,SAAS,MAAMkF,EAAmB,EACrDlF,GAAOL,GAAaK,EAAM,CAAC,CAAC,CACpC,CAEO,SAASkG,IAAgD,CAC5D,GAAI,OAAO,OAAW,IAAa,OACnC,MAAMlM,EAAI,OACV,GAAIA,EAAEkB,EAAI,EAAG,OACblB,EAAEkB,EAAI,EAAI,GAEV,QAAQ,KAAK,IAAID,EAAS,kDAAkD,EAE5E,MAAMiC,EAAW,CAACC,EAAQ,OAAS,WAAW4C,GAAe5C,CAAK,EAE9D,SAAS,aAAe,UACxB,SAAS,iBAAiB,mBAAoB,IAAMD,EAAA,CAAU,EAE9DA,EAAA,EAGJ,MAAME,EAAW,QAAQ,UAAU,KAAK,OAAO,EAC/C,QAAQ,UAAY,IAAIxE,IAA+C,CACnEwE,EAAS,GAAGxE,CAAI,EAChBsE,EAAS,GAAG,CAChB,EACA,OAAO,iBAAiB,WAAY,IAAMA,EAAS,GAAG,CAAC,CAC3D,CCzJA,MAAMiJ,EAAgB,CAClB,YAAYC,EAA6C,CACrD,MAAMC,EAAW,0EACbD,EAAO,KACP,OAAO,KAAKA,EAAO,IAAK,cAAeC,CAAQ,EAE/CD,EAAO,UACP,OAAO,KAAKA,EAAO,SAAU,mBAAoBC,CAAQ,CAEjE,CACJ,CACC,OAAmC,gBAAkBF,GAEtD,MAAM1N,EAAoB,qBAEpBE,GAAS,CACX,KAAM,IAAIC,IAAoB,QAAQ,KAAK,IAAIH,CAAiB,IAAK,GAAGG,CAAI,EAC5E,KAAM,IAAIA,IAAoB,QAAQ,KAAK,IAAIH,CAAiB,IAAK,GAAGG,CAAI,EAC5E,MAAO,IAAIA,IAAoB,QAAQ,MAAM,IAAIH,CAAiB,IAAK,GAAGG,CAAI,CAClF,EAEA,SAAS0N,IAA2B,CAChC,MAAMC,EAAU,OAAmC,OAEnD,GAAI,CAACA,EACD,MAAO,GAGX,MAAMC,EAAgBD,EAAO,oBAE7B,GAAI,OAAOC,GAAkB,WACzB,MAAO,GAGX,MAAMC,EAAaD,EAAA,EAEnB,GAAI,CAACC,GAAc,OAAOA,EAAW,iBAAoB,WACrD,MAAO,GAGX,IAAIC,EAAQ,EACZ,SAAW,CAAC9Q,EAAM+Q,CAAO,IAAK,OAAO,QAAQrO,EAAU,EAAG,CACtD,MAAMsO,EAAW,GAAGnO,CAAiB,IAAI7C,CAAI,GAC7C6Q,EAAW,gBAAgBG,EAAUD,EAAS,CAC1C,SAAU,SACV,OAAQlO,CAAA,CACX,EACDiO,GACJ,CAEA,OAAOA,CACX,CAEA,SAASG,IAAmB,CACxB,MAAMC,EAAS,IAAM,CACjB,MAAMJ,EAAQJ,GAAA,EAEd,GAAII,EAAQ,EAAG,CACX/N,GAAO,KAAK,GAAG+N,CAAK,wBAAwB,EAC5C,MACJ,CAEA,IAAIK,EAAU,EACd,MAAMC,EAAa,GACbC,EAAW,YAAY,IAAM,CAC/BF,IACA,MAAMG,EAASZ,GAAA,EAEf,GAAIY,EAAS,EAAG,CACZ,cAAcD,CAAQ,EACtBtO,GAAO,KAAK,GAAGuO,CAAM,iCAAiCH,CAAO,WAAW,EACxE,MACJ,CAEIA,GAAWC,IACX,cAAcC,CAAQ,EACtBtO,GAAO,KAAK,8CAA8C,EAElE,EAAG,GAAG,CACV,EAEI,SAAS,aAAe,UACxB,SAAS,iBAAiB,mBAAoBmO,CAAM,EAEpDA,EAAA,CAER,CAEAhN,GAAA,EACAmD,GAAA,EACAgD,GAAA,EACAiD,GAAA,EACAW,GAAA,EACAoB,GAAA,EACAiB,GAAA,EACAW,GAAA,EAEC,OAAmC,gBAAkB,CAClD,WAAYpO,EACZ,SAAU,OAAO,KAAKH,EAAU,EAChC,WAAAuO,EACJ"}
\ No newline at end of file
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/editor-spec.json b/plugins/_bundled/sirsoft-pay_nhnkcp/editor-spec.json
new file mode 100644
index 00000000..8787ebd5
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/editor-spec.json
@@ -0,0 +1,119 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$comment": "레이아웃 편집기 스펙 — NHN KCP 결제 플러그인 도메인 sampleData. plugin_settings 레이아웃의 data_source 중 플러그인 고유 ID(vbank_info / health) 의 응답 shape 를 실제 바인딩(vbank_info.data.{notify_url,guide_steps,...} / health.data.{data.overall,checks.*}) 역추론해 작성. 공통 ID 'settings' 는 admin 템플릿 스펙 sampleData 가 커버(전역 고유 ID 병합 specMerge 템플릿 우선)하므로 본 스펙에 미포함.",
+  "pluginId": "sirsoft-pay_nhnkcp",
+  "version": "1.0.0",
+  "description": "NHN KCP 결제 플러그인 레이아웃 편집기 샘플 데이터 (가상계좌 입금통보 URL / 연동 상태 점검).",
+  "sampleData": {
+    "byDataSourceId": {
+      "vbank_info": {
+        "data": {
+          "title": "가상계좌 입금통보 URL",
+          "description": "아래 URL 을 PG 관리자에 등록하면 입금 완료 시 자동으로 주문이 처리됩니다.",
+          "notify_url": "https://example.com/api/plugins/sirsoft-pay_nhnkcp/vbank/notify",
+          "copyable": true,
+          "guide_url": "https://example.com/docs/vbank",
+          "guide_steps": [
+            "PG 관리자 페이지에 로그인합니다.",
+            "가상계좌 입금통보 URL 설정 메뉴로 이동합니다.",
+            "위 URL 을 붙여넣고 저장합니다."
+          ]
+        }
+      },
+      "health": {
+        "data": {
+          "summary": {
+            "pc_payment_ready": true,
+            "mobile_payment_ready": false,
+            "mobile_vbank_only_ready": false,
+            "error_count": 1,
+            "warning_count": 0,
+            "fixed_count": 0
+          },
+          "checks": [
+            {
+              "id": "exec_function",
+              "category": "pc",
+              "label": "PHP exec() 함수",
+              "status": "ok",
+              "detail": "CLI 호출 가능"
+            },
+            {
+              "id": "bin_directory",
+              "category": "pc",
+              "label": "CLI 바이너리 디렉토리",
+              "status": "ok",
+              "detail": "디렉토리 존재"
+            },
+            {
+              "id": "cli_pp_cli_exe",
+              "category": "pc",
+              "label": "CLI 바이너리 (Windows) — pp_cli_exe.exe",
+              "status": "ok",
+              "detail": "Windows 바이너리 — 실행 권한 검사 생략"
+            },
+            {
+              "id": "pub_key",
+              "category": "pc",
+              "label": "KCP 공개키 (pub.key)",
+              "status": "ok",
+              "detail": "파일 존재"
+            },
+            {
+              "id": "soap_extension",
+              "category": "mobile",
+              "label": "PHP SOAP 확장",
+              "status": "error",
+              "detail": "모바일 결제 (SmartPhone Pay) 가 동작하지 않습니다.",
+              "remediation": "PHP SOAP 확장을 설치하고 PHP-FPM 을 재시작하세요:\nUbuntu/Debian: sudo apt install php8.x-soap && sudo systemctl restart php8.x-fpm\nRHEL/CentOS:   sudo yum install php-soap && sudo systemctl restart php-fpm\n확인: php -m | grep soap"
+            },
+            {
+              "id": "wsdl_file",
+              "category": "mobile",
+              "label": "WSDL 파일",
+              "status": "ok",
+              "detail": "테스트/라이브 WSDL 모두 존재"
+            }
+          ]
+        }
+      }
+    }
+  },
+  "states": {
+    "comment": "플러그인 설정 변종.",
+    "groups": [
+      {
+        "comment": "결제/인증 플러그인 설정. _local.form.is_test_mode 로 운영모드 경고(live_mode_warning)를 if 분기한다.",
+        "scope": {
+          "kind": "route",
+          "match": "*/admin/plugins/sirsoft-pay_nhnkcp/settings"
+        },
+        "items": [
+          {
+            "id": "test_mode_on",
+            "label": "$t:editor.state.test_mode_on",
+            "default": true,
+            "initialState": {
+              "local": {
+                "form": {
+                  "is_test_mode": true
+                }
+              }
+            }
+          },
+          {
+            "id": "test_mode_off",
+            "label": "$t:editor.state.test_mode_off",
+            "initialState": {
+              "local": {
+                "form": {
+                  "is_test_mode": false
+                }
+              }
+            }
+          }
+        ]
+      }
+    ]
+  }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/lang/en/activity_log.php b/plugins/_bundled/sirsoft-pay_nhnkcp/lang/en/activity_log.php
new file mode 100644
index 00000000..6e2208e5
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/lang/en/activity_log.php
@@ -0,0 +1,10 @@
+<?php
+
+return [
+    'action' => [
+        'cancel' => 'PG Payment Cancellation',
+    ],
+    'description' => [
+        'payment_cancel' => 'NHN KCP confirmed payment cancellation (order :order_number, refunded :refund_amount KRW).',
+    ],
+];
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/lang/en/messages.php b/plugins/_bundled/sirsoft-pay_nhnkcp/lang/en/messages.php
new file mode 100644
index 00000000..116e7b99
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/lang/en/messages.php
@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+return [
+    'refund' => [
+        'missing_tid' => 'Cannot process refund: transaction number (tno) is missing.',
+        'default_reason' => 'Buyer refund request',
+        'in_progress' => 'NHN KCP refund is already in progress.',
+    ],
+    'errors' => [
+        'wsdl_missing' => 'KCP WSDL file not found: :file',
+        'approval_key_error' => 'KCP approval key error [:code]: :message',
+        'soap_error' => 'KCP SOAP integration error: :message',
+        'cli_binary_missing' => 'KCP CLI binary missing: :path',
+        'cli_binary_not_executable' => 'KCP CLI binary is not executable. Operator action required (sudo chmod 755 :path)',
+    ],
+];
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/lang/en/payment_methods.php b/plugins/_bundled/sirsoft-pay_nhnkcp/lang/en/payment_methods.php
new file mode 100644
index 00000000..fdf56986
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/lang/en/payment_methods.php
@@ -0,0 +1,24 @@
+<?php
+
+return [
+    'payco' => [
+        'name' => 'PAYCO',
+        'description' => 'Pay with PAYCO (NHN KCP)',
+    ],
+    'naverpay' => [
+        'name' => 'Naver Pay (Card)',
+        'description' => 'Pay by Naver Pay credit card (NHN KCP)',
+    ],
+    'naverpay_point' => [
+        'name' => 'Naver Pay (Point)',
+        'description' => 'Pay with Naver Pay Money/Points (NHN KCP)',
+    ],
+    'kakaopay' => [
+        'name' => 'Kakao Pay',
+        'description' => 'Pay with Kakao Pay (NHN KCP)',
+    ],
+    'applepay' => [
+        'name' => 'Apple Pay',
+        'description' => 'Pay with Apple Pay (NHN KCP) · Apple Pay is available only for mobile payments on iOS devices.',
+    ],
+];
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/lang/en/provider.php b/plugins/_bundled/sirsoft-pay_nhnkcp/lang/en/provider.php
new file mode 100644
index 00000000..9360576b
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/lang/en/provider.php
@@ -0,0 +1,13 @@
+<?php
+
+/**
+ * NHN KCP PG provider meta (English)
+ *
+ * Label referenced by name_key in the
+ * `sirsoft-ecommerce.payment.registered_pg_providers` hook payload.
+ * Resolved via the active language pack at runtime.
+ */
+return [
+    'name' => 'NHN KCP',
+    'description' => 'NHN KCP payment gateway (Standard Pay) — card / bank transfer / virtual account / mobile',
+];
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/lang/ko/activity_log.php b/plugins/_bundled/sirsoft-pay_nhnkcp/lang/ko/activity_log.php
new file mode 100644
index 00000000..19542284
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/lang/ko/activity_log.php
@@ -0,0 +1,10 @@
+<?php
+
+return [
+    'action' => [
+        'cancel' => 'PG 결제 취소',
+    ],
+    'description' => [
+        'payment_cancel' => 'NHN KCP 결제 취소가 확인되었습니다 (주문 :order_number, 환불금액 :refund_amount원).',
+    ],
+];
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/lang/ko/messages.php b/plugins/_bundled/sirsoft-pay_nhnkcp/lang/ko/messages.php
new file mode 100644
index 00000000..866a4515
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/lang/ko/messages.php
@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+return [
+    'refund' => [
+        'missing_tid' => '거래번호(tno)가 없어 환불을 진행할 수 없습니다.',
+        'default_reason' => '구매자 환불 요청',
+        'in_progress' => 'NHN KCP 환불이 이미 처리 중입니다.',
+    ],
+    'errors' => [
+        'wsdl_missing' => 'KCP WSDL 파일이 없습니다: :file',
+        'approval_key_error' => 'KCP 승인키 오류 [:code]: :message',
+        'soap_error' => 'KCP SOAP 연동 오류: :message',
+        'cli_binary_missing' => 'KCP CLI 바이너리 누락: :path',
+        'cli_binary_not_executable' => 'KCP CLI 바이너리 실행 권한 부족 — 운영자 조치 필요 (sudo chmod 755 :path)',
+    ],
+];
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/lang/ko/payment_methods.php b/plugins/_bundled/sirsoft-pay_nhnkcp/lang/ko/payment_methods.php
new file mode 100644
index 00000000..bda5b958
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/lang/ko/payment_methods.php
@@ -0,0 +1,24 @@
+<?php
+
+return [
+    'payco' => [
+        'name' => 'PAYCO',
+        'description' => 'PAYCO로 결제 (NHN KCP)',
+    ],
+    'naverpay' => [
+        'name' => '네이버페이 (카드)',
+        'description' => '네이버페이 신용카드로 결제 (NHN KCP)',
+    ],
+    'naverpay_point' => [
+        'name' => '네이버페이 (포인트)',
+        'description' => '네이버페이 머니/포인트로 결제 (NHN KCP)',
+    ],
+    'kakaopay' => [
+        'name' => '카카오페이',
+        'description' => '카카오페이로 결제 (NHN KCP)',
+    ],
+    'applepay' => [
+        'name' => '애플페이',
+        'description' => '애플페이로 결제 (NHN KCP) · 애플페이는 IOS 기기에 모바일결제만 가능합니다.',
+    ],
+];
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/lang/ko/provider.php b/plugins/_bundled/sirsoft-pay_nhnkcp/lang/ko/provider.php
new file mode 100644
index 00000000..86f0347c
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/lang/ko/provider.php
@@ -0,0 +1,12 @@
+<?php
+
+/**
+ * NHN KCP PG 프로바이더 메타 (Korean)
+ *
+ * `sirsoft-ecommerce.payment.registered_pg_providers` 훅 페이로드의
+ * name_key 가 가리키는 라벨. 활성 언어팩으로 자동 보강된다.
+ */
+return [
+    'name' => 'NHN KCP',
+    'description' => 'NHN KCP 결제 게이트웨이 (Standard Pay 연동) — 카드/계좌이체/가상계좌/휴대폰 결제 지원',
+];
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/package-lock.json b/plugins/_bundled/sirsoft-pay_nhnkcp/package-lock.json
new file mode 100644
index 00000000..88427008
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/package-lock.json
@@ -0,0 +1,3179 @@
+{
+    "name": "@g7/sirsoft-pay_nhnkcp",
+    "version": "1.0.0-beta.4",
+    "lockfileVersion": 3,
+    "requires": true,
+    "packages": {
+        "": {
+            "name": "@g7/sirsoft-pay_nhnkcp",
+            "version": "1.0.0-beta.4",
+            "devDependencies": {
+                "jsdom": "^27.4.0",
+                "typescript": "^5.3.3",
+                "vite": "^5.4.14",
+                "vitest": "^4.1.8"
+            }
+        },
+        "node_modules/@acemir/cssom": {
+            "version": "0.9.31",
+            "resolved": "https://registry.npmjs.org/@acemir/cssom/-/cssom-0.9.31.tgz",
+            "integrity": "sha512-ZnR3GSaH+/vJ0YlHau21FjfLYjMpYVIzTD8M8vIEQvIGxeOXyXdzCI140rrCY862p/C/BbzWsjc1dgnM9mkoTA==",
+            "dev": true
+        },
+        "node_modules/@asamuzakjp/css-color": {
+            "version": "4.1.2",
+            "resolved": "https://registry.npmjs.org/@asamuzakjp/css-color/-/css-color-4.1.2.tgz",
+            "integrity": "sha512-NfBUvBaYgKIuq6E/RBLY1m0IohzNHAYyaJGuTK79Z23uNwmz2jl1mPsC5ZxCCxylinKhT1Amn5oNTlx1wN8cQg==",
+            "dev": true,
+            "dependencies": {
+                "@csstools/css-calc": "^3.0.0",
+                "@csstools/css-color-parser": "^4.0.1",
+                "@csstools/css-parser-algorithms": "^4.0.0",
+                "@csstools/css-tokenizer": "^4.0.0",
+                "lru-cache": "^11.2.5"
+            }
+        },
+        "node_modules/@asamuzakjp/dom-selector": {
+            "version": "6.8.1",
+            "resolved": "https://registry.npmjs.org/@asamuzakjp/dom-selector/-/dom-selector-6.8.1.tgz",
+            "integrity": "sha512-MvRz1nCqW0fsy8Qz4dnLIvhOlMzqDVBabZx6lH+YywFDdjXhMY37SmpV1XFX3JzG5GWHn63j6HX6QPr3lZXHvQ==",
+            "dev": true,
+            "dependencies": {
+                "@asamuzakjp/nwsapi": "^2.3.9",
+                "bidi-js": "^1.0.3",
+                "css-tree": "^3.1.0",
+                "is-potential-custom-element-name": "^1.0.1",
+                "lru-cache": "^11.2.6"
+            }
+        },
+        "node_modules/@asamuzakjp/nwsapi": {
+            "version": "2.3.9",
+            "resolved": "https://registry.npmjs.org/@asamuzakjp/nwsapi/-/nwsapi-2.3.9.tgz",
+            "integrity": "sha512-n8GuYSrI9bF7FFZ/SjhwevlHc8xaVlb/7HmHelnc/PZXBD2ZR49NnN9sMMuDdEGPeeRQ5d0hqlSlEpgCX3Wl0Q==",
+            "dev": true
+        },
+        "node_modules/@csstools/color-helpers": {
+            "version": "6.0.2",
+            "resolved": "https://registry.npmjs.org/@csstools/color-helpers/-/color-helpers-6.0.2.tgz",
+            "integrity": "sha512-LMGQLS9EuADloEFkcTBR3BwV/CGHV7zyDxVRtVDTwdI2Ca4it0CCVTT9wCkxSgokjE5Ho41hEPgb8OEUwoXr6Q==",
+            "dev": true,
+            "funding": [
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/csstools"
+                },
+                {
+                    "type": "opencollective",
+                    "url": "https://opencollective.com/csstools"
+                }
+            ],
+            "engines": {
+                "node": ">=20.19.0"
+            }
+        },
+        "node_modules/@csstools/css-calc": {
+            "version": "3.2.0",
+            "resolved": "https://registry.npmjs.org/@csstools/css-calc/-/css-calc-3.2.0.tgz",
+            "integrity": "sha512-bR9e6o2BDB12jzN/gIbjHa5wLJ4UjD1CB9pM7ehlc0ddk6EBz+yYS1EV2MF55/HUxrHcB/hehAyt5vhsA3hx7w==",
+            "dev": true,
+            "funding": [
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/csstools"
+                },
+                {
+                    "type": "opencollective",
+                    "url": "https://opencollective.com/csstools"
+                }
+            ],
+            "engines": {
+                "node": ">=20.19.0"
+            },
+            "peerDependencies": {
+                "@csstools/css-parser-algorithms": "^4.0.0",
+                "@csstools/css-tokenizer": "^4.0.0"
+            }
+        },
+        "node_modules/@csstools/css-color-parser": {
+            "version": "4.1.0",
+            "resolved": "https://registry.npmjs.org/@csstools/css-color-parser/-/css-color-parser-4.1.0.tgz",
+            "integrity": "sha512-U0KhLYmy2GVj6q4T3WaAe6NPuFYCPQoE3b0dRGxejWDgcPp8TP7S5rVdM5ZrFaqu4N67X8YaPBw14dQSYx3IyQ==",
+            "dev": true,
+            "funding": [
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/csstools"
+                },
+                {
+                    "type": "opencollective",
+                    "url": "https://opencollective.com/csstools"
+                }
+            ],
+            "dependencies": {
+                "@csstools/color-helpers": "^6.0.2",
+                "@csstools/css-calc": "^3.2.0"
+            },
+            "engines": {
+                "node": ">=20.19.0"
+            },
+            "peerDependencies": {
+                "@csstools/css-parser-algorithms": "^4.0.0",
+                "@csstools/css-tokenizer": "^4.0.0"
+            }
+        },
+        "node_modules/@csstools/css-parser-algorithms": {
+            "version": "4.0.0",
+            "resolved": "https://registry.npmjs.org/@csstools/css-parser-algorithms/-/css-parser-algorithms-4.0.0.tgz",
+            "integrity": "sha512-+B87qS7fIG3L5h3qwJ/IFbjoVoOe/bpOdh9hAjXbvx0o8ImEmUsGXN0inFOnk2ChCFgqkkGFQ+TpM5rbhkKe4w==",
+            "dev": true,
+            "funding": [
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/csstools"
+                },
+                {
+                    "type": "opencollective",
+                    "url": "https://opencollective.com/csstools"
+                }
+            ],
+            "engines": {
+                "node": ">=20.19.0"
+            },
+            "peerDependencies": {
+                "@csstools/css-tokenizer": "^4.0.0"
+            }
+        },
+        "node_modules/@csstools/css-syntax-patches-for-csstree": {
+            "version": "1.1.3",
+            "resolved": "https://registry.npmjs.org/@csstools/css-syntax-patches-for-csstree/-/css-syntax-patches-for-csstree-1.1.3.tgz",
+            "integrity": "sha512-SH60bMfrRCJF3morcdk57WklujF4Jr/EsQUzqkarfHXEFcAR1gg7fS/chAE922Sehgzc1/+Tz5H3Ypa1HiEKrg==",
+            "dev": true,
+            "funding": [
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/csstools"
+                },
+                {
+                    "type": "opencollective",
+                    "url": "https://opencollective.com/csstools"
+                }
+            ],
+            "peerDependencies": {
+                "css-tree": "^3.2.1"
+            },
+            "peerDependenciesMeta": {
+                "css-tree": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/@csstools/css-tokenizer": {
+            "version": "4.0.0",
+            "resolved": "https://registry.npmjs.org/@csstools/css-tokenizer/-/css-tokenizer-4.0.0.tgz",
+            "integrity": "sha512-QxULHAm7cNu72w97JUNCBFODFaXpbDg+dP8b/oWFAZ2MTRppA3U00Y2L1HqaS4J6yBqxwa/Y3nMBaxVKbB/NsA==",
+            "dev": true,
+            "funding": [
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/csstools"
+                },
+                {
+                    "type": "opencollective",
+                    "url": "https://opencollective.com/csstools"
+                }
+            ],
+            "engines": {
+                "node": ">=20.19.0"
+            }
+        },
+        "node_modules/@emnapi/core": {
+            "version": "1.10.0",
+            "resolved": "https://registry.npmjs.org/@emnapi/core/-/core-1.10.0.tgz",
+            "integrity": "sha512-yq6OkJ4p82CAfPl0u9mQebQHKPJkY7WrIuk205cTYnYe+k2Z8YBh11FrbRG/H6ihirqcacOgl2BIO8oyMQLeXw==",
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "dependencies": {
+                "@emnapi/wasi-threads": "1.2.1",
+                "tslib": "^2.4.0"
+            }
+        },
+        "node_modules/@emnapi/runtime": {
+            "version": "1.10.0",
+            "resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.10.0.tgz",
+            "integrity": "sha512-ewvYlk86xUoGI0zQRNq/mC+16R1QeDlKQy21Ki3oSYXNgLb45GV1P6A0M+/s6nyCuNDqe5VpaY84BzXGwVbwFA==",
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "dependencies": {
+                "tslib": "^2.4.0"
+            }
+        },
+        "node_modules/@emnapi/wasi-threads": {
+            "version": "1.2.1",
+            "resolved": "https://registry.npmjs.org/@emnapi/wasi-threads/-/wasi-threads-1.2.1.tgz",
+            "integrity": "sha512-uTII7OYF+/Mes/MrcIOYp5yOtSMLBWSIoLPpcgwipoiKbli6k322tcoFsxoIIxPDqW01SQGAgko4EzZi2BNv2w==",
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "dependencies": {
+                "tslib": "^2.4.0"
+            }
+        },
+        "node_modules/@esbuild/aix-ppc64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.21.5.tgz",
+            "integrity": "sha512-1SDgH6ZSPTlggy1yI6+Dbkiz8xzpHJEVAlF/AM1tHPLsf5STom9rwtjE4hKAF20FfXXNTFqEYXyJNWh1GiZedQ==",
+            "cpu": [
+                "ppc64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "aix"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/android-arm": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.21.5.tgz",
+            "integrity": "sha512-vCPvzSjpPHEi1siZdlvAlsPxXl7WbOVUBBAowWug4rJHb68Ox8KualB+1ocNvT5fjv6wpkX6o/iEpbDrf68zcg==",
+            "cpu": [
+                "arm"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "android"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/android-arm64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.21.5.tgz",
+            "integrity": "sha512-c0uX9VAUBQ7dTDCjq+wdyGLowMdtR/GoC2U5IYk/7D1H1JYC0qseD7+11iMP2mRLN9RcCMRcjC4YMclCzGwS/A==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "android"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/android-x64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.21.5.tgz",
+            "integrity": "sha512-D7aPRUUNHRBwHxzxRvp856rjUHRFW1SdQATKXH2hqA0kAZb1hKmi02OpYRacl0TxIGz/ZmXWlbZgjwWYaCakTA==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "android"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/darwin-arm64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.21.5.tgz",
+            "integrity": "sha512-DwqXqZyuk5AiWWf3UfLiRDJ5EDd49zg6O9wclZ7kUMv2WRFr4HKjXp/5t8JZ11QbQfUS6/cRCKGwYhtNAY88kQ==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "darwin"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/darwin-x64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.21.5.tgz",
+            "integrity": "sha512-se/JjF8NlmKVG4kNIuyWMV/22ZaerB+qaSi5MdrXtd6R08kvs2qCN4C09miupktDitvh8jRFflwGFBQcxZRjbw==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "darwin"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/freebsd-arm64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.21.5.tgz",
+            "integrity": "sha512-5JcRxxRDUJLX8JXp/wcBCy3pENnCgBR9bN6JsY4OmhfUtIHe3ZW0mawA7+RDAcMLrMIZaf03NlQiX9DGyB8h4g==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "freebsd"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/freebsd-x64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.21.5.tgz",
+            "integrity": "sha512-J95kNBj1zkbMXtHVH29bBriQygMXqoVQOQYA+ISs0/2l3T9/kj42ow2mpqerRBxDJnmkUDCaQT/dfNXWX/ZZCQ==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "freebsd"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/linux-arm": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.21.5.tgz",
+            "integrity": "sha512-bPb5AHZtbeNGjCKVZ9UGqGwo8EUu4cLq68E95A53KlxAPRmUyYv2D6F0uUI65XisGOL1hBP5mTronbgo+0bFcA==",
+            "cpu": [
+                "arm"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/linux-arm64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.21.5.tgz",
+            "integrity": "sha512-ibKvmyYzKsBeX8d8I7MH/TMfWDXBF3db4qM6sy+7re0YXya+K1cem3on9XgdT2EQGMu4hQyZhan7TeQ8XkGp4Q==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/linux-ia32": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.21.5.tgz",
+            "integrity": "sha512-YvjXDqLRqPDl2dvRODYmmhz4rPeVKYvppfGYKSNGdyZkA01046pLWyRKKI3ax8fbJoK5QbxblURkwK/MWY18Tg==",
+            "cpu": [
+                "ia32"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/linux-loong64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.21.5.tgz",
+            "integrity": "sha512-uHf1BmMG8qEvzdrzAqg2SIG/02+4/DHB6a9Kbya0XDvwDEKCoC8ZRWI5JJvNdUjtciBGFQ5PuBlpEOXQj+JQSg==",
+            "cpu": [
+                "loong64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/linux-mips64el": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.21.5.tgz",
+            "integrity": "sha512-IajOmO+KJK23bj52dFSNCMsz1QP1DqM6cwLUv3W1QwyxkyIWecfafnI555fvSGqEKwjMXVLokcV5ygHW5b3Jbg==",
+            "cpu": [
+                "mips64el"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/linux-ppc64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.21.5.tgz",
+            "integrity": "sha512-1hHV/Z4OEfMwpLO8rp7CvlhBDnjsC3CttJXIhBi+5Aj5r+MBvy4egg7wCbe//hSsT+RvDAG7s81tAvpL2XAE4w==",
+            "cpu": [
+                "ppc64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/linux-riscv64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.21.5.tgz",
+            "integrity": "sha512-2HdXDMd9GMgTGrPWnJzP2ALSokE/0O5HhTUvWIbD3YdjME8JwvSCnNGBnTThKGEB91OZhzrJ4qIIxk/SBmyDDA==",
+            "cpu": [
+                "riscv64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/linux-s390x": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.21.5.tgz",
+            "integrity": "sha512-zus5sxzqBJD3eXxwvjN1yQkRepANgxE9lgOW2qLnmr8ikMTphkjgXu1HR01K4FJg8h1kEEDAqDcZQtbrRnB41A==",
+            "cpu": [
+                "s390x"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/linux-x64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.21.5.tgz",
+            "integrity": "sha512-1rYdTpyv03iycF1+BhzrzQJCdOuAOtaqHTWJZCWvijKD2N5Xu0TtVC8/+1faWqcP9iBCWOmjmhoH94dH82BxPQ==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/netbsd-arm64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.28.0.tgz",
+            "integrity": "sha512-CR/RYotgtCKwtftMwJlUU7xCVNg3lMYZ0RzTmAHSfLCXw3NtZtNpswLEj/Kkf6kEL3Gw+BpOekRX0BYCtklhUw==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "netbsd"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/@esbuild/netbsd-x64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.21.5.tgz",
+            "integrity": "sha512-Woi2MXzXjMULccIwMnLciyZH4nCIMpWQAs049KEeMvOcNADVxo0UBIQPfSmxB3CWKedngg7sWZdLvLczpe0tLg==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "netbsd"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/openbsd-arm64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.28.0.tgz",
+            "integrity": "sha512-cXb5vApOsRsxsEl4mcZ1XY3D4DzcoMxR/nnc4IyqYs0rTI8ZKmW6kyyg+11Z8yvgMfAEldKzP7AdP64HnSC/6g==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "openbsd"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/@esbuild/openbsd-x64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.21.5.tgz",
+            "integrity": "sha512-HLNNw99xsvx12lFBUwoT8EVCsSvRNDVxNpjZ7bPn947b8gJPzeHWyNVhFsaerc0n3TsbOINvRP2byTZ5LKezow==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "openbsd"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/openharmony-arm64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.28.0.tgz",
+            "integrity": "sha512-FLGfyizszcef5C3YtoyQDACyg95+dndv79i2EekILBofh5wpCa1KuBqOWKrEHZg3zrL3t5ouE5jgr94vA+Wb2w==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "openharmony"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/@esbuild/sunos-x64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.21.5.tgz",
+            "integrity": "sha512-6+gjmFpfy0BHU5Tpptkuh8+uw3mnrvgs+dSPQXQOv3ekbordwnzTVEb4qnIvQcYXq6gzkyTnoZ9dZG+D4garKg==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "sunos"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/win32-arm64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.21.5.tgz",
+            "integrity": "sha512-Z0gOTd75VvXqyq7nsl93zwahcTROgqvuAcYDUr+vOv8uHhNSKROyU961kgtCD1e95IqPKSQKH7tBTslnS3tA8A==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "win32"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/win32-ia32": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.21.5.tgz",
+            "integrity": "sha512-SWXFF1CL2RVNMaVs+BBClwtfZSvDgtL//G/smwAc5oVK/UPu2Gu9tIaRgFmYFFKrmg3SyAjSrElf0TiJ1v8fYA==",
+            "cpu": [
+                "ia32"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "win32"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/win32-x64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.21.5.tgz",
+            "integrity": "sha512-tQd/1efJuzPC6rCFwEvLtci/xNFcTZknmXs98FYDfGE4wP9ClFV98nyKrzJKVPMhdDnjzLhdUyMX4PsQAPjwIw==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "win32"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@exodus/bytes": {
+            "version": "1.15.0",
+            "resolved": "https://registry.npmjs.org/@exodus/bytes/-/bytes-1.15.0.tgz",
+            "integrity": "sha512-UY0nlA+feH81UGSHv92sLEPLCeZFjXOuHhrIo0HQydScuQc8s0A7kL/UdgwgDq8g8ilksmuoF35YVTNphV2aBQ==",
+            "dev": true,
+            "engines": {
+                "node": "^20.19.0 || ^22.12.0 || >=24.0.0"
+            },
+            "peerDependencies": {
+                "@noble/hashes": "^1.8.0 || ^2.0.0"
+            },
+            "peerDependenciesMeta": {
+                "@noble/hashes": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/@jridgewell/sourcemap-codec": {
+            "version": "1.5.5",
+            "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz",
+            "integrity": "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==",
+            "dev": true,
+            "license": "MIT"
+        },
+        "node_modules/@napi-rs/wasm-runtime": {
+            "version": "1.1.4",
+            "resolved": "https://registry.npmjs.org/@napi-rs/wasm-runtime/-/wasm-runtime-1.1.4.tgz",
+            "integrity": "sha512-3NQNNgA1YSlJb/kMH1ildASP9HW7/7kYnRI2szWJaofaS1hWmbGI4H+d3+22aGzXXN9IJ+n+GiFVcGipJP18ow==",
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "dependencies": {
+                "@tybys/wasm-util": "^0.10.1"
+            },
+            "funding": {
+                "type": "github",
+                "url": "https://github.com/sponsors/Brooooooklyn"
+            },
+            "peerDependencies": {
+                "@emnapi/core": "^1.7.1",
+                "@emnapi/runtime": "^1.7.1"
+            }
+        },
+        "node_modules/@oxc-project/types": {
+            "version": "0.133.0",
+            "resolved": "https://registry.npmjs.org/@oxc-project/types/-/types-0.133.0.tgz",
+            "integrity": "sha512-KzkdCd6Uxqnf6l3HOw1xfatAlUURA0g14cvBYFyJ5SaNOQbOUvBr9PKArcPcrNIeRsBdgcUzOGrhKveVpvOIGA==",
+            "dev": true,
+            "license": "MIT",
+            "funding": {
+                "url": "https://github.com/sponsors/Boshen"
+            }
+        },
+        "node_modules/@rolldown/binding-android-arm64": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/@rolldown/binding-android-arm64/-/binding-android-arm64-1.0.3.tgz",
+            "integrity": "sha512-454rs7jHngixp/NMxd5srYD57OnzSlZ/eFTETjORQHLwJG1lRtmNOJcBerZlfu4GjKqeq8aCCIQrMdHyhI51Hw==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "android"
+            ],
+            "engines": {
+                "node": "^20.19.0 || >=22.12.0"
+            }
+        },
+        "node_modules/@rolldown/binding-darwin-arm64": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/@rolldown/binding-darwin-arm64/-/binding-darwin-arm64-1.0.3.tgz",
+            "integrity": "sha512-PcAhP+ynjURNyy8SKGl5DQP94aGuB/7JrXJb/t7P+hanXvQVMWzUvRRhBAcg/lNRadBhoUPqSoP4xw5tR/KBEA==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "darwin"
+            ],
+            "engines": {
+                "node": "^20.19.0 || >=22.12.0"
+            }
+        },
+        "node_modules/@rolldown/binding-darwin-x64": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/@rolldown/binding-darwin-x64/-/binding-darwin-x64-1.0.3.tgz",
+            "integrity": "sha512-9YpfeUvSE2RS7wysJ81uOZkXJz7f7Q55H2Gvp3VEw/EsahqDtrphrZ0EwDLK5vvKOzaCrBsjF8JmnMLcUt78Gg==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "darwin"
+            ],
+            "engines": {
+                "node": "^20.19.0 || >=22.12.0"
+            }
+        },
+        "node_modules/@rolldown/binding-freebsd-x64": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/@rolldown/binding-freebsd-x64/-/binding-freebsd-x64-1.0.3.tgz",
+            "integrity": "sha512-yB1IlAsSNHncV6SCTL27/MVGR5htvQsoGxIv5KMGXALp+Ll1wYsn+x98M9MW7qa+NdSbvrrY7ANI4wLJ0n1e6g==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "freebsd"
+            ],
+            "engines": {
+                "node": "^20.19.0 || >=22.12.0"
+            }
+        },
+        "node_modules/@rolldown/binding-linux-arm-gnueabihf": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm-gnueabihf/-/binding-linux-arm-gnueabihf-1.0.3.tgz",
+            "integrity": "sha512-Yi30IVAAfLUCy2MseFjbB1jAMDl1VMCAas5StnYp8da9+CKvMd2H2cbEjWcw5NPaPqzvYkVIaF1nNUG+b7u/sw==",
+            "cpu": [
+                "arm"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": "^20.19.0 || >=22.12.0"
+            }
+        },
+        "node_modules/@rolldown/binding-linux-arm64-gnu": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm64-gnu/-/binding-linux-arm64-gnu-1.0.3.tgz",
+            "integrity": "sha512-jsO7R8To+AdlYgUmN5sHSCZbfhtMBkO0WUx8iORQnPcMMdgr7qM2DQmMwgabs3GhNztdmoKkMKQFHD6DTMCIQw==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": "^20.19.0 || >=22.12.0"
+            }
+        },
+        "node_modules/@rolldown/binding-linux-arm64-musl": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm64-musl/-/binding-linux-arm64-musl-1.0.3.tgz",
+            "integrity": "sha512-VWkUHwWriDciit80wleYwKILoR/KMvxh/IdwS/paX+ZgpuRpCrKLUdadJbc0NpBEiyhpYawsJ73j9aCvOH+f7Q==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": "^20.19.0 || >=22.12.0"
+            }
+        },
+        "node_modules/@rolldown/binding-linux-ppc64-gnu": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-ppc64-gnu/-/binding-linux-ppc64-gnu-1.0.3.tgz",
+            "integrity": "sha512-5f1laC0SlIR0yDbFCd8acUhvJIag6N3zC5P7oUPN6wX0aOma+uKJ0wBDH5aq7I1PVI2ttTlhJwzwRIBnLiSGEg==",
+            "cpu": [
+                "ppc64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": "^20.19.0 || >=22.12.0"
+            }
+        },
+        "node_modules/@rolldown/binding-linux-s390x-gnu": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-s390x-gnu/-/binding-linux-s390x-gnu-1.0.3.tgz",
+            "integrity": "sha512-Iq4ko0r4XsgbrF/LunNgHtAGLRRVE2kXonAXQ/MV0mC6jQpMOhW1SvtZja2EhC/kd05++bP78dsqBeIQyYJ6Yg==",
+            "cpu": [
+                "s390x"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": "^20.19.0 || >=22.12.0"
+            }
+        },
+        "node_modules/@rolldown/binding-linux-x64-gnu": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-x64-gnu/-/binding-linux-x64-gnu-1.0.3.tgz",
+            "integrity": "sha512-B8m6tD5+/N5FeNQFbKlLA/2yVq9ycQP1SeedyEYYKWBNR3ZQbkvIUcNnDNM03lO1l5F2roiiFJGgvoLLyZXtSg==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": "^20.19.0 || >=22.12.0"
+            }
+        },
+        "node_modules/@rolldown/binding-linux-x64-musl": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-x64-musl/-/binding-linux-x64-musl-1.0.3.tgz",
+            "integrity": "sha512-pSdpdUJHkuCxun9LE7jvgUB9qsRgaiyNNCX7m/AvHTcq67AiT/Yhoxvw5zPfhrM8k/BfP8ce/hMOpthKDpEUow==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": "^20.19.0 || >=22.12.0"
+            }
+        },
+        "node_modules/@rolldown/binding-openharmony-arm64": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/@rolldown/binding-openharmony-arm64/-/binding-openharmony-arm64-1.0.3.tgz",
+            "integrity": "sha512-OXXS3RKJgX2uLwM+gYyuH5omcH8fL1LJs96pZGgtetVCahON57+d4SJHzTgZiOjxgGkSnpXpOsWuPDGAKAigEg==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "openharmony"
+            ],
+            "engines": {
+                "node": "^20.19.0 || >=22.12.0"
+            }
+        },
+        "node_modules/@rolldown/binding-wasm32-wasi": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/@rolldown/binding-wasm32-wasi/-/binding-wasm32-wasi-1.0.3.tgz",
+            "integrity": "sha512-JTtb8BWFynicNSoPrehsCzBtOKjZ6jhMiPFEmOiuXg1Fl8dn2KHQob+GuPSGR0dryQa1PQJbzjF3dqO/whhjLg==",
+            "cpu": [
+                "wasm32"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "dependencies": {
+                "@emnapi/core": "1.10.0",
+                "@emnapi/runtime": "1.10.0",
+                "@napi-rs/wasm-runtime": "^1.1.4"
+            },
+            "engines": {
+                "node": "^20.19.0 || >=22.12.0"
+            }
+        },
+        "node_modules/@rolldown/binding-win32-arm64-msvc": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/@rolldown/binding-win32-arm64-msvc/-/binding-win32-arm64-msvc-1.0.3.tgz",
+            "integrity": "sha512-gEdFFEN70A/jxb2svrWsN3aDL7OUtmvlOy+6fa2jxG8K0wQ1ZbdeLGnidov6Yu5/733dI5ySfzFlQ/cb0bSz1g==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "win32"
+            ],
+            "engines": {
+                "node": "^20.19.0 || >=22.12.0"
+            }
+        },
+        "node_modules/@rolldown/binding-win32-x64-msvc": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/@rolldown/binding-win32-x64-msvc/-/binding-win32-x64-msvc-1.0.3.tgz",
+            "integrity": "sha512-eXB7CHuaQdqmJcc3koCNtNPmT/bj2gc999kUFgBxG8Ac0NdgXc4rkCHhqrgrhN3zddvvvrgzj1e90SuSfmyIXA==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "win32"
+            ],
+            "engines": {
+                "node": "^20.19.0 || >=22.12.0"
+            }
+        },
+        "node_modules/@rolldown/pluginutils": {
+            "version": "1.0.1",
+            "resolved": "https://registry.npmjs.org/@rolldown/pluginutils/-/pluginutils-1.0.1.tgz",
+            "integrity": "sha512-2j9bGt5Jh8hj+vPtgzPtl72j0yRxHAyumoo6TNfAjsLB04UtpSvPbPcDcBMxz7n+9CYB0c1GxQFxYRg2jimqGw==",
+            "dev": true,
+            "license": "MIT"
+        },
+        "node_modules/@rollup/rollup-android-arm-eabi": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.60.2.tgz",
+            "integrity": "sha512-dnlp69efPPg6Uaw2dVqzWRfAWRnYVb1XJ8CyyhIbZeaq4CA5/mLeZ1IEt9QqQxmbdvagjLIm2ZL8BxXv5lH4Yw==",
+            "cpu": [
+                "arm"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "android"
+            ]
+        },
+        "node_modules/@rollup/rollup-android-arm64": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.60.2.tgz",
+            "integrity": "sha512-OqZTwDRDchGRHHm/hwLOL7uVPB9aUvI0am/eQuWMNyFHf5PSEQmyEeYYheA0EPPKUO/l0uigCp+iaTjoLjVoHg==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "android"
+            ]
+        },
+        "node_modules/@rollup/rollup-darwin-arm64": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.60.2.tgz",
+            "integrity": "sha512-UwRE7CGpvSVEQS8gUMBe1uADWjNnVgP3Iusyda1nSRwNDCsRjnGc7w6El6WLQsXmZTbLZx9cecegumcitNfpmA==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "darwin"
+            ]
+        },
+        "node_modules/@rollup/rollup-darwin-x64": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.60.2.tgz",
+            "integrity": "sha512-gjEtURKLCC5VXm1I+2i1u9OhxFsKAQJKTVB8WvDAHF+oZlq0GTVFOlTlO1q3AlCTE/DF32c16ESvfgqR7343/g==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "darwin"
+            ]
+        },
+        "node_modules/@rollup/rollup-freebsd-arm64": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.60.2.tgz",
+            "integrity": "sha512-Bcl6CYDeAgE70cqZaMojOi/eK63h5Me97ZqAQoh77VPjMysA/4ORQBRGo3rRy45x4MzVlU9uZxs8Uwy7ZaKnBw==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "freebsd"
+            ]
+        },
+        "node_modules/@rollup/rollup-freebsd-x64": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.60.2.tgz",
+            "integrity": "sha512-LU+TPda3mAE2QB0/Hp5VyeKJivpC6+tlOXd1VMoXV/YFMvk/MNk5iXeBfB4MQGRWyOYVJ01625vjkr0Az98OJQ==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "freebsd"
+            ]
+        },
+        "node_modules/@rollup/rollup-linux-arm-gnueabihf": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.60.2.tgz",
+            "integrity": "sha512-2QxQrM+KQ7DAW4o22j+XZ6RKdxjLD7BOWTP0Bv0tmjdyhXSsr2Ul1oJDQqh9Zf5qOwTuTc7Ek83mOFaKnodPjg==",
+            "cpu": [
+                "arm"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ]
+        },
+        "node_modules/@rollup/rollup-linux-arm-musleabihf": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.60.2.tgz",
+            "integrity": "sha512-TbziEu2DVsTEOPif2mKWkMeDMLoYjx95oESa9fkQQK7r/Orta0gnkcDpzwufEcAO2BLBsD7mZkXGFqEdMRRwfw==",
+            "cpu": [
+                "arm"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ]
+        },
+        "node_modules/@rollup/rollup-linux-arm64-gnu": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.60.2.tgz",
+            "integrity": "sha512-bO/rVDiDUuM2YfuCUwZ1t1cP+/yqjqz+Xf2VtkdppefuOFS2OSeAfgafaHNkFn0t02hEyXngZkxtGqXcXwO8Rg==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ]
+        },
+        "node_modules/@rollup/rollup-linux-arm64-musl": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.60.2.tgz",
+            "integrity": "sha512-hr26p7e93Rl0Za+JwW7EAnwAvKkehh12BU1Llm9Ykiibg4uIr2rbpxG9WCf56GuvidlTG9KiiQT/TXT1yAWxTA==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ]
+        },
+        "node_modules/@rollup/rollup-linux-loong64-gnu": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.60.2.tgz",
+            "integrity": "sha512-pOjB/uSIyDt+ow3k/RcLvUAOGpysT2phDn7TTUB3n75SlIgZzM6NKAqlErPhoFU+npgY3/n+2HYIQVbF70P9/A==",
+            "cpu": [
+                "loong64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ]
+        },
+        "node_modules/@rollup/rollup-linux-loong64-musl": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-musl/-/rollup-linux-loong64-musl-4.60.2.tgz",
+            "integrity": "sha512-2/w+q8jszv9Ww1c+6uJT3OwqhdmGP2/4T17cu8WuwyUuuaCDDJ2ojdyYwZzCxx0GcsZBhzi3HmH+J5pZNXnd+Q==",
+            "cpu": [
+                "loong64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ]
+        },
+        "node_modules/@rollup/rollup-linux-ppc64-gnu": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.60.2.tgz",
+            "integrity": "sha512-11+aL5vKheYgczxtPVVRhdptAM2H7fcDR5Gw4/bTcteuZBlH4oP9f5s9zYO9aGZvoGeBpqXI/9TZZihZ609wKw==",
+            "cpu": [
+                "ppc64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ]
+        },
+        "node_modules/@rollup/rollup-linux-ppc64-musl": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-musl/-/rollup-linux-ppc64-musl-4.60.2.tgz",
+            "integrity": "sha512-i16fokAGK46IVZuV8LIIwMdtqhin9hfYkCh8pf8iC3QU3LpwL+1FSFGej+O7l3E/AoknL6Dclh2oTdnRMpTzFQ==",
+            "cpu": [
+                "ppc64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ]
+        },
+        "node_modules/@rollup/rollup-linux-riscv64-gnu": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.60.2.tgz",
+            "integrity": "sha512-49FkKS6RGQoriDSK/6E2GkAsAuU5kETFCh7pG4yD/ylj9rKhTmO3elsnmBvRD4PgJPds5W2PkhC82aVwmUcJ7A==",
+            "cpu": [
+                "riscv64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ]
+        },
+        "node_modules/@rollup/rollup-linux-riscv64-musl": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.60.2.tgz",
+            "integrity": "sha512-mjYNkHPfGpUR00DuM1ZZIgs64Hpf4bWcz9Z41+4Q+pgDx73UwWdAYyf6EG/lRFldmdHHzgrYyge5akFUW0D3mQ==",
+            "cpu": [
+                "riscv64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ]
+        },
+        "node_modules/@rollup/rollup-linux-s390x-gnu": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.60.2.tgz",
+            "integrity": "sha512-ALyvJz965BQk8E9Al/JDKKDLH2kfKFLTGMlgkAbbYtZuJt9LU8DW3ZoDMCtQpXAltZxwBHevXz5u+gf0yA0YoA==",
+            "cpu": [
+                "s390x"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ]
+        },
+        "node_modules/@rollup/rollup-linux-x64-gnu": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.60.2.tgz",
+            "integrity": "sha512-UQjrkIdWrKI626Du8lCQ6MJp/6V1LAo2bOK9OTu4mSn8GGXIkPXk/Vsp4bLHCd9Z9Iz2OTEaokUE90VweJgIYQ==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ]
+        },
+        "node_modules/@rollup/rollup-linux-x64-musl": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.60.2.tgz",
+            "integrity": "sha512-bTsRGj6VlSdn/XD4CGyzMnzaBs9bsRxy79eTqTCBsA8TMIEky7qg48aPkvJvFe1HyzQ5oMZdg7AnVlWQSKLTnw==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ]
+        },
+        "node_modules/@rollup/rollup-openbsd-x64": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-openbsd-x64/-/rollup-openbsd-x64-4.60.2.tgz",
+            "integrity": "sha512-6d4Z3534xitaA1FcMWP7mQPq5zGwBmGbhphh2DwaA1aNIXUu3KTOfwrWpbwI4/Gr0uANo7NTtaykFyO2hPuFLg==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "openbsd"
+            ]
+        },
+        "node_modules/@rollup/rollup-openharmony-arm64": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.60.2.tgz",
+            "integrity": "sha512-NetAg5iO2uN7eB8zE5qrZ3CSil+7IJt4WDFLcC75Ymywq1VZVD6qJ6EvNLjZ3rEm6gB7XW5JdT60c6MN35Z85Q==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "openharmony"
+            ]
+        },
+        "node_modules/@rollup/rollup-win32-arm64-msvc": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.60.2.tgz",
+            "integrity": "sha512-NCYhOotpgWZ5kdxCZsv6Iudx0wX8980Q/oW4pNFNihpBKsDbEA1zpkfxJGC0yugsUuyDZ7gL37dbzwhR0VI7pQ==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "win32"
+            ]
+        },
+        "node_modules/@rollup/rollup-win32-ia32-msvc": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.60.2.tgz",
+            "integrity": "sha512-RXsaOqXxfoUBQoOgvmmijVxJnW2IGB0eoMO7F8FAjaj0UTywUO/luSqimWBJn04WNgUkeNhh7fs7pESXajWmkg==",
+            "cpu": [
+                "ia32"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "win32"
+            ]
+        },
+        "node_modules/@rollup/rollup-win32-x64-gnu": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.60.2.tgz",
+            "integrity": "sha512-qdAzEULD+/hzObedtmV6iBpdL5TIbKVztGiK7O3/KYSf+HIzU257+MX1EXJcyIiDbMAqmbwaufcYPvyRryeZtA==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "win32"
+            ]
+        },
+        "node_modules/@rollup/rollup-win32-x64-msvc": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.60.2.tgz",
+            "integrity": "sha512-Nd/SgG27WoA9e+/TdK74KnHz852TLa94ovOYySo/yMPuTmpckK/jIF2jSwS3g7ELSKXK13/cVdmg1Z/DaCWKxA==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "win32"
+            ]
+        },
+        "node_modules/@standard-schema/spec": {
+            "version": "1.1.0",
+            "resolved": "https://registry.npmjs.org/@standard-schema/spec/-/spec-1.1.0.tgz",
+            "integrity": "sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w==",
+            "dev": true,
+            "license": "MIT"
+        },
+        "node_modules/@tybys/wasm-util": {
+            "version": "0.10.2",
+            "resolved": "https://registry.npmjs.org/@tybys/wasm-util/-/wasm-util-0.10.2.tgz",
+            "integrity": "sha512-RoBvJ2X0wuKlWFIjrwffGw1IqZHKQqzIchKaadZZfnNpsAYp2mM0h36JtPCjNDAHGgYez/15uMBpfGwchhiMgg==",
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "dependencies": {
+                "tslib": "^2.4.0"
+            }
+        },
+        "node_modules/@types/chai": {
+            "version": "5.2.3",
+            "resolved": "https://registry.npmjs.org/@types/chai/-/chai-5.2.3.tgz",
+            "integrity": "sha512-Mw558oeA9fFbv65/y4mHtXDs9bPnFMZAL/jxdPFUpOHHIXX91mcgEHbS5Lahr+pwZFR8A7GQleRWeI6cGFC2UA==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "@types/deep-eql": "*",
+                "assertion-error": "^2.0.1"
+            }
+        },
+        "node_modules/@types/deep-eql": {
+            "version": "4.0.2",
+            "resolved": "https://registry.npmjs.org/@types/deep-eql/-/deep-eql-4.0.2.tgz",
+            "integrity": "sha512-c9h9dVVMigMPc4bwTvC5dxqtqJZwQPePsWjPlpSOnojbor6pGqdk541lfA7AqFQr5pB1BRdq0juY9db81BwyFw==",
+            "dev": true,
+            "license": "MIT"
+        },
+        "node_modules/@types/estree": {
+            "version": "1.0.8",
+            "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.8.tgz",
+            "integrity": "sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==",
+            "dev": true
+        },
+        "node_modules/@vitest/expect": {
+            "version": "4.1.8",
+            "resolved": "https://registry.npmjs.org/@vitest/expect/-/expect-4.1.8.tgz",
+            "integrity": "sha512-h3nDO677RDLEGlBxyQ5CW8RlMThSKSRLUePLOx09gNIWRL40edgA1GCZSZgf1W55MFAG6/Sw14KeaAnqv0NKdQ==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "@standard-schema/spec": "^1.1.0",
+                "@types/chai": "^5.2.2",
+                "@vitest/spy": "4.1.8",
+                "@vitest/utils": "4.1.8",
+                "chai": "^6.2.2",
+                "tinyrainbow": "^3.1.0"
+            },
+            "funding": {
+                "url": "https://opencollective.com/vitest"
+            }
+        },
+        "node_modules/@vitest/pretty-format": {
+            "version": "4.1.8",
+            "resolved": "https://registry.npmjs.org/@vitest/pretty-format/-/pretty-format-4.1.8.tgz",
+            "integrity": "sha512-9GasEBxpZ1VYIpqHf/0+YGg121uSNwCKOJqIrTwWP/TB7DmFCiaBpNl3aPZzoLWfWkuqhbH8vJIVobZkvdo2cA==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "tinyrainbow": "^3.1.0"
+            },
+            "funding": {
+                "url": "https://opencollective.com/vitest"
+            }
+        },
+        "node_modules/@vitest/runner": {
+            "version": "4.1.8",
+            "resolved": "https://registry.npmjs.org/@vitest/runner/-/runner-4.1.8.tgz",
+            "integrity": "sha512-EmVxeBAfMJvycdjd6Hm+RbFBbA9fKvo0Kx37hNpBYoYeavH3RNsBXWDooR1mgD52dCrxIIuP7UotpfiwOikvcg==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "@vitest/utils": "4.1.8",
+                "pathe": "^2.0.3"
+            },
+            "funding": {
+                "url": "https://opencollective.com/vitest"
+            }
+        },
+        "node_modules/@vitest/snapshot": {
+            "version": "4.1.8",
+            "resolved": "https://registry.npmjs.org/@vitest/snapshot/-/snapshot-4.1.8.tgz",
+            "integrity": "sha512-acfZboRmAIf05DEKcBQy33VXojFJjtUdLyo7oOmV9kebb2xdU01UknNiPuPZoJZQyO7DF0gZdTGTpeAzET9QPQ==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "@vitest/pretty-format": "4.1.8",
+                "@vitest/utils": "4.1.8",
+                "magic-string": "^0.30.21",
+                "pathe": "^2.0.3"
+            },
+            "funding": {
+                "url": "https://opencollective.com/vitest"
+            }
+        },
+        "node_modules/@vitest/spy": {
+            "version": "4.1.8",
+            "resolved": "https://registry.npmjs.org/@vitest/spy/-/spy-4.1.8.tgz",
+            "integrity": "sha512-6EevtBp6OZOPF7bmz36HrGMeP3txgVSrgebWxHOafDXGkhIzfXK14f8KF6MuFfgXXUeHxmpD3BQxkV00/3s5mA==",
+            "dev": true,
+            "license": "MIT",
+            "funding": {
+                "url": "https://opencollective.com/vitest"
+            }
+        },
+        "node_modules/@vitest/utils": {
+            "version": "4.1.8",
+            "resolved": "https://registry.npmjs.org/@vitest/utils/-/utils-4.1.8.tgz",
+            "integrity": "sha512-uOJamYALNhfJ6iolExyQM40yIQwDqYnkKtQ5VCiSe17E33H0aQ/u+1GlRuz4LZBk6Mm3sg90G9hEbmEt37C1Zg==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "@vitest/pretty-format": "4.1.8",
+                "convert-source-map": "^2.0.0",
+                "tinyrainbow": "^3.1.0"
+            },
+            "funding": {
+                "url": "https://opencollective.com/vitest"
+            }
+        },
+        "node_modules/agent-base": {
+            "version": "7.1.4",
+            "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-7.1.4.tgz",
+            "integrity": "sha512-MnA+YT8fwfJPgBx3m60MNqakm30XOkyIoH1y6huTQvC0PwZG7ki8NacLBcrPbNoo8vEZy7Jpuk7+jMO+CUovTQ==",
+            "dev": true,
+            "engines": {
+                "node": ">= 14"
+            }
+        },
+        "node_modules/assertion-error": {
+            "version": "2.0.1",
+            "resolved": "https://registry.npmjs.org/assertion-error/-/assertion-error-2.0.1.tgz",
+            "integrity": "sha512-Izi8RQcffqCeNVgFigKli1ssklIbpHnCYc6AknXGYoB6grJqyeby7jv12JUQgmTAnIDnbck1uxksT4dzN3PWBA==",
+            "dev": true,
+            "license": "MIT",
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/bidi-js": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/bidi-js/-/bidi-js-1.0.3.tgz",
+            "integrity": "sha512-RKshQI1R3YQ+n9YJz2QQ147P66ELpa1FQEg20Dk8oW9t2KgLbpDLLp9aGZ7y8WHSshDknG0bknqGw5/tyCs5tw==",
+            "dev": true,
+            "dependencies": {
+                "require-from-string": "^2.0.2"
+            }
+        },
+        "node_modules/chai": {
+            "version": "6.2.2",
+            "resolved": "https://registry.npmjs.org/chai/-/chai-6.2.2.tgz",
+            "integrity": "sha512-NUPRluOfOiTKBKvWPtSD4PhFvWCqOi0BGStNWs57X9js7XGTprSmFoz5F0tWhR4WPjNeR9jXqdC7/UpSJTnlRg==",
+            "dev": true,
+            "license": "MIT",
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/convert-source-map": {
+            "version": "2.0.0",
+            "resolved": "https://registry.npmjs.org/convert-source-map/-/convert-source-map-2.0.0.tgz",
+            "integrity": "sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==",
+            "dev": true,
+            "license": "MIT"
+        },
+        "node_modules/css-tree": {
+            "version": "3.2.1",
+            "resolved": "https://registry.npmjs.org/css-tree/-/css-tree-3.2.1.tgz",
+            "integrity": "sha512-X7sjQzceUhu1u7Y/ylrRZFU2FS6LRiFVp6rKLPg23y3x3c3DOKAwuXGDp+PAGjh6CSnCjYeAul8pcT8bAl+lSA==",
+            "dev": true,
+            "dependencies": {
+                "mdn-data": "2.27.1",
+                "source-map-js": "^1.2.1"
+            },
+            "engines": {
+                "node": "^10 || ^12.20.0 || ^14.13.0 || >=15.0.0"
+            }
+        },
+        "node_modules/cssstyle": {
+            "version": "5.3.7",
+            "resolved": "https://registry.npmjs.org/cssstyle/-/cssstyle-5.3.7.tgz",
+            "integrity": "sha512-7D2EPVltRrsTkhpQmksIu+LxeWAIEk6wRDMJ1qljlv+CKHJM+cJLlfhWIzNA44eAsHXSNe3+vO6DW1yCYx8SuQ==",
+            "dev": true,
+            "dependencies": {
+                "@asamuzakjp/css-color": "^4.1.1",
+                "@csstools/css-syntax-patches-for-csstree": "^1.0.21",
+                "css-tree": "^3.1.0",
+                "lru-cache": "^11.2.4"
+            },
+            "engines": {
+                "node": ">=20"
+            }
+        },
+        "node_modules/data-urls": {
+            "version": "6.0.1",
+            "resolved": "https://registry.npmjs.org/data-urls/-/data-urls-6.0.1.tgz",
+            "integrity": "sha512-euIQENZg6x8mj3fO6o9+fOW8MimUI4PpD/fZBhJfeioZVy9TUpM4UY7KjQNVZFlqwJ0UdzRDzkycB997HEq1BQ==",
+            "dev": true,
+            "dependencies": {
+                "whatwg-mimetype": "^5.0.0",
+                "whatwg-url": "^15.1.0"
+            },
+            "engines": {
+                "node": ">=20"
+            }
+        },
+        "node_modules/data-urls/node_modules/whatwg-mimetype": {
+            "version": "5.0.0",
+            "resolved": "https://registry.npmjs.org/whatwg-mimetype/-/whatwg-mimetype-5.0.0.tgz",
+            "integrity": "sha512-sXcNcHOC51uPGF0P/D4NVtrkjSU2fNsm9iog4ZvZJsL3rjoDAzXZhkm2MWt1y+PUdggKAYVoMAIYcs78wJ51Cw==",
+            "dev": true,
+            "engines": {
+                "node": ">=20"
+            }
+        },
+        "node_modules/debug": {
+            "version": "4.4.3",
+            "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz",
+            "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==",
+            "dev": true,
+            "dependencies": {
+                "ms": "^2.1.3"
+            },
+            "engines": {
+                "node": ">=6.0"
+            },
+            "peerDependenciesMeta": {
+                "supports-color": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/decimal.js": {
+            "version": "10.6.0",
+            "resolved": "https://registry.npmjs.org/decimal.js/-/decimal.js-10.6.0.tgz",
+            "integrity": "sha512-YpgQiITW3JXGntzdUmyUR1V812Hn8T1YVXhCu+wO3OpS4eU9l4YdD3qjyiKdV6mvV29zapkMeD390UVEf2lkUg==",
+            "dev": true
+        },
+        "node_modules/detect-libc": {
+            "version": "2.1.2",
+            "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz",
+            "integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==",
+            "dev": true,
+            "license": "Apache-2.0",
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/entities": {
+            "version": "8.0.0",
+            "resolved": "https://registry.npmjs.org/entities/-/entities-8.0.0.tgz",
+            "integrity": "sha512-zwfzJecQ/Uej6tusMqwAqU/6KL2XaB2VZ2Jg54Je6ahNBGNH6Ek6g3jjNCF0fG9EWQKGZNddNjU5F1ZQn/sBnA==",
+            "dev": true,
+            "engines": {
+                "node": ">=20.19.0"
+            },
+            "funding": {
+                "url": "https://github.com/fb55/entities?sponsor=1"
+            }
+        },
+        "node_modules/es-module-lexer": {
+            "version": "2.1.0",
+            "resolved": "https://registry.npmjs.org/es-module-lexer/-/es-module-lexer-2.1.0.tgz",
+            "integrity": "sha512-n27zTYMjYu1aj4MjCWzSP7G9r75utsaoc8m61weK+W8JMBGGQybd43GstCXZ3WNmSFtGT9wi59qQTW6mhTR5LQ==",
+            "dev": true,
+            "license": "MIT"
+        },
+        "node_modules/esbuild": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.21.5.tgz",
+            "integrity": "sha512-mg3OPMV4hXywwpoDxu3Qda5xCKQi+vCTZq8S9J/EpkhB2HzKXq4SNFZE3+NK93JYxc8VMSep+lOUSC/RVKaBqw==",
+            "dev": true,
+            "hasInstallScript": true,
+            "bin": {
+                "esbuild": "bin/esbuild"
+            },
+            "engines": {
+                "node": ">=12"
+            },
+            "optionalDependencies": {
+                "@esbuild/aix-ppc64": "0.21.5",
+                "@esbuild/android-arm": "0.21.5",
+                "@esbuild/android-arm64": "0.21.5",
+                "@esbuild/android-x64": "0.21.5",
+                "@esbuild/darwin-arm64": "0.21.5",
+                "@esbuild/darwin-x64": "0.21.5",
+                "@esbuild/freebsd-arm64": "0.21.5",
+                "@esbuild/freebsd-x64": "0.21.5",
+                "@esbuild/linux-arm": "0.21.5",
+                "@esbuild/linux-arm64": "0.21.5",
+                "@esbuild/linux-ia32": "0.21.5",
+                "@esbuild/linux-loong64": "0.21.5",
+                "@esbuild/linux-mips64el": "0.21.5",
+                "@esbuild/linux-ppc64": "0.21.5",
+                "@esbuild/linux-riscv64": "0.21.5",
+                "@esbuild/linux-s390x": "0.21.5",
+                "@esbuild/linux-x64": "0.21.5",
+                "@esbuild/netbsd-x64": "0.21.5",
+                "@esbuild/openbsd-x64": "0.21.5",
+                "@esbuild/sunos-x64": "0.21.5",
+                "@esbuild/win32-arm64": "0.21.5",
+                "@esbuild/win32-ia32": "0.21.5",
+                "@esbuild/win32-x64": "0.21.5"
+            }
+        },
+        "node_modules/estree-walker": {
+            "version": "3.0.3",
+            "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-3.0.3.tgz",
+            "integrity": "sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "@types/estree": "^1.0.0"
+            }
+        },
+        "node_modules/expect-type": {
+            "version": "1.3.0",
+            "resolved": "https://registry.npmjs.org/expect-type/-/expect-type-1.3.0.tgz",
+            "integrity": "sha512-knvyeauYhqjOYvQ66MznSMs83wmHrCycNEN6Ao+2AeYEfxUIkuiVxdEa1qlGEPK+We3n0THiDciYSsCcgW/DoA==",
+            "dev": true,
+            "engines": {
+                "node": ">=12.0.0"
+            }
+        },
+        "node_modules/fdir": {
+            "version": "6.5.0",
+            "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz",
+            "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==",
+            "dev": true,
+            "license": "MIT",
+            "engines": {
+                "node": ">=12.0.0"
+            },
+            "peerDependencies": {
+                "picomatch": "^3 || ^4"
+            },
+            "peerDependenciesMeta": {
+                "picomatch": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/fsevents": {
+            "version": "2.3.3",
+            "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
+            "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==",
+            "dev": true,
+            "hasInstallScript": true,
+            "optional": true,
+            "os": [
+                "darwin"
+            ],
+            "engines": {
+                "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
+            }
+        },
+        "node_modules/html-encoding-sniffer": {
+            "version": "6.0.0",
+            "resolved": "https://registry.npmjs.org/html-encoding-sniffer/-/html-encoding-sniffer-6.0.0.tgz",
+            "integrity": "sha512-CV9TW3Y3f8/wT0BRFc1/KAVQ3TUHiXmaAb6VW9vtiMFf7SLoMd1PdAc4W3KFOFETBJUb90KatHqlsZMWV+R9Gg==",
+            "dev": true,
+            "dependencies": {
+                "@exodus/bytes": "^1.6.0"
+            },
+            "engines": {
+                "node": "^20.19.0 || ^22.12.0 || >=24.0.0"
+            }
+        },
+        "node_modules/http-proxy-agent": {
+            "version": "7.0.2",
+            "resolved": "https://registry.npmjs.org/http-proxy-agent/-/http-proxy-agent-7.0.2.tgz",
+            "integrity": "sha512-T1gkAiYYDWYx3V5Bmyu7HcfcvL7mUrTWiM6yOfa3PIphViJ/gFPbvidQ+veqSOHci/PxBcDabeUNCzpOODJZig==",
+            "dev": true,
+            "dependencies": {
+                "agent-base": "^7.1.0",
+                "debug": "^4.3.4"
+            },
+            "engines": {
+                "node": ">= 14"
+            }
+        },
+        "node_modules/https-proxy-agent": {
+            "version": "7.0.6",
+            "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-7.0.6.tgz",
+            "integrity": "sha512-vK9P5/iUfdl95AI+JVyUuIcVtd4ofvtrOr3HNtM2yxC9bnMbEdp3x01OhQNnjb8IJYi38VlTE3mBXwcfvywuSw==",
+            "dev": true,
+            "dependencies": {
+                "agent-base": "^7.1.2",
+                "debug": "4"
+            },
+            "engines": {
+                "node": ">= 14"
+            }
+        },
+        "node_modules/is-potential-custom-element-name": {
+            "version": "1.0.1",
+            "resolved": "https://registry.npmjs.org/is-potential-custom-element-name/-/is-potential-custom-element-name-1.0.1.tgz",
+            "integrity": "sha512-bCYeRA2rVibKZd+s2625gGnGF/t7DSqDs4dP7CrLA1m7jKWz6pps0LpYLJN8Q64HtmPKJ1hrN3nzPNKFEKOUiQ==",
+            "dev": true
+        },
+        "node_modules/jsdom": {
+            "version": "27.4.0",
+            "resolved": "https://registry.npmjs.org/jsdom/-/jsdom-27.4.0.tgz",
+            "integrity": "sha512-mjzqwWRD9Y1J1KUi7W97Gja1bwOOM5Ug0EZ6UDK3xS7j7mndrkwozHtSblfomlzyB4NepioNt+B2sOSzczVgtQ==",
+            "dev": true,
+            "dependencies": {
+                "@acemir/cssom": "^0.9.28",
+                "@asamuzakjp/dom-selector": "^6.7.6",
+                "@exodus/bytes": "^1.6.0",
+                "cssstyle": "^5.3.4",
+                "data-urls": "^6.0.0",
+                "decimal.js": "^10.6.0",
+                "html-encoding-sniffer": "^6.0.0",
+                "http-proxy-agent": "^7.0.2",
+                "https-proxy-agent": "^7.0.6",
+                "is-potential-custom-element-name": "^1.0.1",
+                "parse5": "^8.0.0",
+                "saxes": "^6.0.0",
+                "symbol-tree": "^3.2.4",
+                "tough-cookie": "^6.0.0",
+                "w3c-xmlserializer": "^5.0.0",
+                "webidl-conversions": "^8.0.0",
+                "whatwg-mimetype": "^4.0.0",
+                "whatwg-url": "^15.1.0",
+                "ws": "^8.18.3",
+                "xml-name-validator": "^5.0.0"
+            },
+            "engines": {
+                "node": "^20.19.0 || ^22.12.0 || >=24.0.0"
+            },
+            "peerDependencies": {
+                "canvas": "^3.0.0"
+            },
+            "peerDependenciesMeta": {
+                "canvas": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/lightningcss": {
+            "version": "1.32.0",
+            "resolved": "https://registry.npmjs.org/lightningcss/-/lightningcss-1.32.0.tgz",
+            "integrity": "sha512-NXYBzinNrblfraPGyrbPoD19C1h9lfI/1mzgWYvXUTe414Gz/X1FD2XBZSZM7rRTrMA8JL3OtAaGifrIKhQ5yQ==",
+            "dev": true,
+            "license": "MPL-2.0",
+            "dependencies": {
+                "detect-libc": "^2.0.3"
+            },
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            },
+            "optionalDependencies": {
+                "lightningcss-android-arm64": "1.32.0",
+                "lightningcss-darwin-arm64": "1.32.0",
+                "lightningcss-darwin-x64": "1.32.0",
+                "lightningcss-freebsd-x64": "1.32.0",
+                "lightningcss-linux-arm-gnueabihf": "1.32.0",
+                "lightningcss-linux-arm64-gnu": "1.32.0",
+                "lightningcss-linux-arm64-musl": "1.32.0",
+                "lightningcss-linux-x64-gnu": "1.32.0",
+                "lightningcss-linux-x64-musl": "1.32.0",
+                "lightningcss-win32-arm64-msvc": "1.32.0",
+                "lightningcss-win32-x64-msvc": "1.32.0"
+            }
+        },
+        "node_modules/lightningcss-android-arm64": {
+            "version": "1.32.0",
+            "resolved": "https://registry.npmjs.org/lightningcss-android-arm64/-/lightningcss-android-arm64-1.32.0.tgz",
+            "integrity": "sha512-YK7/ClTt4kAK0vo6w3X+Pnm0D2cf2vPHbhOXdoNti1Ga0al1P4TBZhwjATvjNwLEBCnKvjJc2jQgHXH0NEwlAg==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MPL-2.0",
+            "optional": true,
+            "os": [
+                "android"
+            ],
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            }
+        },
+        "node_modules/lightningcss-darwin-arm64": {
+            "version": "1.32.0",
+            "resolved": "https://registry.npmjs.org/lightningcss-darwin-arm64/-/lightningcss-darwin-arm64-1.32.0.tgz",
+            "integrity": "sha512-RzeG9Ju5bag2Bv1/lwlVJvBE3q6TtXskdZLLCyfg5pt+HLz9BqlICO7LZM7VHNTTn/5PRhHFBSjk5lc4cmscPQ==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MPL-2.0",
+            "optional": true,
+            "os": [
+                "darwin"
+            ],
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            }
+        },
+        "node_modules/lightningcss-darwin-x64": {
+            "version": "1.32.0",
+            "resolved": "https://registry.npmjs.org/lightningcss-darwin-x64/-/lightningcss-darwin-x64-1.32.0.tgz",
+            "integrity": "sha512-U+QsBp2m/s2wqpUYT/6wnlagdZbtZdndSmut/NJqlCcMLTWp5muCrID+K5UJ6jqD2BFshejCYXniPDbNh73V8w==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MPL-2.0",
+            "optional": true,
+            "os": [
+                "darwin"
+            ],
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            }
+        },
+        "node_modules/lightningcss-freebsd-x64": {
+            "version": "1.32.0",
+            "resolved": "https://registry.npmjs.org/lightningcss-freebsd-x64/-/lightningcss-freebsd-x64-1.32.0.tgz",
+            "integrity": "sha512-JCTigedEksZk3tHTTthnMdVfGf61Fky8Ji2E4YjUTEQX14xiy/lTzXnu1vwiZe3bYe0q+SpsSH/CTeDXK6WHig==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MPL-2.0",
+            "optional": true,
+            "os": [
+                "freebsd"
+            ],
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            }
+        },
+        "node_modules/lightningcss-linux-arm-gnueabihf": {
+            "version": "1.32.0",
+            "resolved": "https://registry.npmjs.org/lightningcss-linux-arm-gnueabihf/-/lightningcss-linux-arm-gnueabihf-1.32.0.tgz",
+            "integrity": "sha512-x6rnnpRa2GL0zQOkt6rts3YDPzduLpWvwAF6EMhXFVZXD4tPrBkEFqzGowzCsIWsPjqSK+tyNEODUBXeeVHSkw==",
+            "cpu": [
+                "arm"
+            ],
+            "dev": true,
+            "license": "MPL-2.0",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            }
+        },
+        "node_modules/lightningcss-linux-arm64-gnu": {
+            "version": "1.32.0",
+            "resolved": "https://registry.npmjs.org/lightningcss-linux-arm64-gnu/-/lightningcss-linux-arm64-gnu-1.32.0.tgz",
+            "integrity": "sha512-0nnMyoyOLRJXfbMOilaSRcLH3Jw5z9HDNGfT/gwCPgaDjnx0i8w7vBzFLFR1f6CMLKF8gVbebmkUN3fa/kQJpQ==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MPL-2.0",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            }
+        },
+        "node_modules/lightningcss-linux-arm64-musl": {
+            "version": "1.32.0",
+            "resolved": "https://registry.npmjs.org/lightningcss-linux-arm64-musl/-/lightningcss-linux-arm64-musl-1.32.0.tgz",
+            "integrity": "sha512-UpQkoenr4UJEzgVIYpI80lDFvRmPVg6oqboNHfoH4CQIfNA+HOrZ7Mo7KZP02dC6LjghPQJeBsvXhJod/wnIBg==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MPL-2.0",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            }
+        },
+        "node_modules/lightningcss-linux-x64-gnu": {
+            "version": "1.32.0",
+            "resolved": "https://registry.npmjs.org/lightningcss-linux-x64-gnu/-/lightningcss-linux-x64-gnu-1.32.0.tgz",
+            "integrity": "sha512-V7Qr52IhZmdKPVr+Vtw8o+WLsQJYCTd8loIfpDaMRWGUZfBOYEJeyJIkqGIDMZPwPx24pUMfwSxxI8phr/MbOA==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MPL-2.0",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            }
+        },
+        "node_modules/lightningcss-linux-x64-musl": {
+            "version": "1.32.0",
+            "resolved": "https://registry.npmjs.org/lightningcss-linux-x64-musl/-/lightningcss-linux-x64-musl-1.32.0.tgz",
+            "integrity": "sha512-bYcLp+Vb0awsiXg/80uCRezCYHNg1/l3mt0gzHnWV9XP1W5sKa5/TCdGWaR/zBM2PeF/HbsQv/j2URNOiVuxWg==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MPL-2.0",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            }
+        },
+        "node_modules/lightningcss-win32-arm64-msvc": {
+            "version": "1.32.0",
+            "resolved": "https://registry.npmjs.org/lightningcss-win32-arm64-msvc/-/lightningcss-win32-arm64-msvc-1.32.0.tgz",
+            "integrity": "sha512-8SbC8BR40pS6baCM8sbtYDSwEVQd4JlFTOlaD3gWGHfThTcABnNDBda6eTZeqbofalIJhFx0qKzgHJmcPTnGdw==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MPL-2.0",
+            "optional": true,
+            "os": [
+                "win32"
+            ],
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            }
+        },
+        "node_modules/lightningcss-win32-x64-msvc": {
+            "version": "1.32.0",
+            "resolved": "https://registry.npmjs.org/lightningcss-win32-x64-msvc/-/lightningcss-win32-x64-msvc-1.32.0.tgz",
+            "integrity": "sha512-Amq9B/SoZYdDi1kFrojnoqPLxYhQ4Wo5XiL8EVJrVsB8ARoC1PWW6VGtT0WKCemjy8aC+louJnjS7U18x3b06Q==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MPL-2.0",
+            "optional": true,
+            "os": [
+                "win32"
+            ],
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            }
+        },
+        "node_modules/lru-cache": {
+            "version": "11.3.5",
+            "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-11.3.5.tgz",
+            "integrity": "sha512-NxVFwLAnrd9i7KUBxC4DrUhmgjzOs+1Qm50D3oF1/oL+r1NpZ4gA7xvG0/zJ8evR7zIKn4vLf7qTNduWFtCrRw==",
+            "dev": true,
+            "engines": {
+                "node": "20 || >=22"
+            }
+        },
+        "node_modules/magic-string": {
+            "version": "0.30.21",
+            "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.21.tgz",
+            "integrity": "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "@jridgewell/sourcemap-codec": "^1.5.5"
+            }
+        },
+        "node_modules/mdn-data": {
+            "version": "2.27.1",
+            "resolved": "https://registry.npmjs.org/mdn-data/-/mdn-data-2.27.1.tgz",
+            "integrity": "sha512-9Yubnt3e8A0OKwxYSXyhLymGW4sCufcLG6VdiDdUGVkPhpqLxlvP5vl1983gQjJl3tqbrM731mjaZaP68AgosQ==",
+            "dev": true
+        },
+        "node_modules/ms": {
+            "version": "2.1.3",
+            "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
+            "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
+            "dev": true
+        },
+        "node_modules/nanoid": {
+            "version": "3.3.12",
+            "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.12.tgz",
+            "integrity": "sha512-ZB9RH/39qpq5Vu6Y+NmUaFhQR6pp+M2Xt76XBnEwDaGcVAqhlvxrl3B2bKS5D3NH3QR76v3aSrKaF/Kiy7lEtQ==",
+            "dev": true,
+            "funding": [
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/ai"
+                }
+            ],
+            "license": "MIT",
+            "bin": {
+                "nanoid": "bin/nanoid.cjs"
+            },
+            "engines": {
+                "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1"
+            }
+        },
+        "node_modules/obug": {
+            "version": "2.1.1",
+            "resolved": "https://registry.npmjs.org/obug/-/obug-2.1.1.tgz",
+            "integrity": "sha512-uTqF9MuPraAQ+IsnPf366RG4cP9RtUi7MLO1N3KEc+wb0a6yKpeL0lmk2IB1jY5KHPAlTc6T/JRdC/YqxHNwkQ==",
+            "dev": true,
+            "funding": [
+                "https://github.com/sponsors/sxzz",
+                "https://opencollective.com/debug"
+            ],
+            "license": "MIT"
+        },
+        "node_modules/parse5": {
+            "version": "8.0.1",
+            "resolved": "https://registry.npmjs.org/parse5/-/parse5-8.0.1.tgz",
+            "integrity": "sha512-z1e/HMG90obSGeidlli3hj7cbocou0/wa5HacvI3ASx34PecNjNQeaHNo5WIZpWofN9kgkqV1q5YvXe3F0FoPw==",
+            "dev": true,
+            "dependencies": {
+                "entities": "^8.0.0"
+            },
+            "funding": {
+                "url": "https://github.com/inikulin/parse5?sponsor=1"
+            }
+        },
+        "node_modules/pathe": {
+            "version": "2.0.3",
+            "resolved": "https://registry.npmjs.org/pathe/-/pathe-2.0.3.tgz",
+            "integrity": "sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w==",
+            "dev": true,
+            "license": "MIT"
+        },
+        "node_modules/picocolors": {
+            "version": "1.1.1",
+            "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
+            "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==",
+            "dev": true
+        },
+        "node_modules/picomatch": {
+            "version": "4.0.4",
+            "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.4.tgz",
+            "integrity": "sha512-QP88BAKvMam/3NxH6vj2o21R6MjxZUAd6nlwAS/pnGvN9IVLocLHxGYIzFhg6fUQ+5th6P4dv4eW9jX3DSIj7A==",
+            "dev": true,
+            "license": "MIT",
+            "engines": {
+                "node": ">=12"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/jonschlinkert"
+            }
+        },
+        "node_modules/postcss": {
+            "version": "8.5.15",
+            "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.15.tgz",
+            "integrity": "sha512-FfR8sjd4em2T6fb3I2MwAJU7HWVMr9zba+enmQeeWFfCbm+UOC/0X4DS8XtpUTMwWMGbjKYP7xjfNekzyGmB3A==",
+            "dev": true,
+            "funding": [
+                {
+                    "type": "opencollective",
+                    "url": "https://opencollective.com/postcss/"
+                },
+                {
+                    "type": "tidelift",
+                    "url": "https://tidelift.com/funding/github/npm/postcss"
+                },
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/ai"
+                }
+            ],
+            "license": "MIT",
+            "dependencies": {
+                "nanoid": "^3.3.12",
+                "picocolors": "^1.1.1",
+                "source-map-js": "^1.2.1"
+            },
+            "engines": {
+                "node": "^10 || ^12 || >=14"
+            }
+        },
+        "node_modules/punycode": {
+            "version": "2.3.1",
+            "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz",
+            "integrity": "sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==",
+            "dev": true,
+            "engines": {
+                "node": ">=6"
+            }
+        },
+        "node_modules/require-from-string": {
+            "version": "2.0.2",
+            "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz",
+            "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==",
+            "dev": true,
+            "engines": {
+                "node": ">=0.10.0"
+            }
+        },
+        "node_modules/rolldown": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/rolldown/-/rolldown-1.0.3.tgz",
+            "integrity": "sha512-i00lAJ2ks1BYr7rjNjKC7BcqAS7nVfiT3QX1SI5aY+AFHblCmaUf9OE9dbdzDvW6dJxbi2ZCZiy9v3CcwOiX3g==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "@oxc-project/types": "=0.133.0",
+                "@rolldown/pluginutils": "^1.0.0"
+            },
+            "bin": {
+                "rolldown": "bin/cli.mjs"
+            },
+            "engines": {
+                "node": "^20.19.0 || >=22.12.0"
+            },
+            "optionalDependencies": {
+                "@rolldown/binding-android-arm64": "1.0.3",
+                "@rolldown/binding-darwin-arm64": "1.0.3",
+                "@rolldown/binding-darwin-x64": "1.0.3",
+                "@rolldown/binding-freebsd-x64": "1.0.3",
+                "@rolldown/binding-linux-arm-gnueabihf": "1.0.3",
+                "@rolldown/binding-linux-arm64-gnu": "1.0.3",
+                "@rolldown/binding-linux-arm64-musl": "1.0.3",
+                "@rolldown/binding-linux-ppc64-gnu": "1.0.3",
+                "@rolldown/binding-linux-s390x-gnu": "1.0.3",
+                "@rolldown/binding-linux-x64-gnu": "1.0.3",
+                "@rolldown/binding-linux-x64-musl": "1.0.3",
+                "@rolldown/binding-openharmony-arm64": "1.0.3",
+                "@rolldown/binding-wasm32-wasi": "1.0.3",
+                "@rolldown/binding-win32-arm64-msvc": "1.0.3",
+                "@rolldown/binding-win32-x64-msvc": "1.0.3"
+            }
+        },
+        "node_modules/rollup": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.60.2.tgz",
+            "integrity": "sha512-J9qZyW++QK/09NyN/zeO0dG/1GdGfyp9lV8ajHnRVLfo/uFsbji5mHnDgn/qYdUHyCkM2N+8VyspgZclfAh0eQ==",
+            "dev": true,
+            "dependencies": {
+                "@types/estree": "1.0.8"
+            },
+            "bin": {
+                "rollup": "dist/bin/rollup"
+            },
+            "engines": {
+                "node": ">=18.0.0",
+                "npm": ">=8.0.0"
+            },
+            "optionalDependencies": {
+                "@rollup/rollup-android-arm-eabi": "4.60.2",
+                "@rollup/rollup-android-arm64": "4.60.2",
+                "@rollup/rollup-darwin-arm64": "4.60.2",
+                "@rollup/rollup-darwin-x64": "4.60.2",
+                "@rollup/rollup-freebsd-arm64": "4.60.2",
+                "@rollup/rollup-freebsd-x64": "4.60.2",
+                "@rollup/rollup-linux-arm-gnueabihf": "4.60.2",
+                "@rollup/rollup-linux-arm-musleabihf": "4.60.2",
+                "@rollup/rollup-linux-arm64-gnu": "4.60.2",
+                "@rollup/rollup-linux-arm64-musl": "4.60.2",
+                "@rollup/rollup-linux-loong64-gnu": "4.60.2",
+                "@rollup/rollup-linux-loong64-musl": "4.60.2",
+                "@rollup/rollup-linux-ppc64-gnu": "4.60.2",
+                "@rollup/rollup-linux-ppc64-musl": "4.60.2",
+                "@rollup/rollup-linux-riscv64-gnu": "4.60.2",
+                "@rollup/rollup-linux-riscv64-musl": "4.60.2",
+                "@rollup/rollup-linux-s390x-gnu": "4.60.2",
+                "@rollup/rollup-linux-x64-gnu": "4.60.2",
+                "@rollup/rollup-linux-x64-musl": "4.60.2",
+                "@rollup/rollup-openbsd-x64": "4.60.2",
+                "@rollup/rollup-openharmony-arm64": "4.60.2",
+                "@rollup/rollup-win32-arm64-msvc": "4.60.2",
+                "@rollup/rollup-win32-ia32-msvc": "4.60.2",
+                "@rollup/rollup-win32-x64-gnu": "4.60.2",
+                "@rollup/rollup-win32-x64-msvc": "4.60.2",
+                "fsevents": "~2.3.2"
+            }
+        },
+        "node_modules/saxes": {
+            "version": "6.0.0",
+            "resolved": "https://registry.npmjs.org/saxes/-/saxes-6.0.0.tgz",
+            "integrity": "sha512-xAg7SOnEhrm5zI3puOOKyy1OMcMlIJZYNJY7xLBwSze0UjhPLnWfj2GF2EpT0jmzaJKIWKHLsaSSajf35bcYnA==",
+            "dev": true,
+            "dependencies": {
+                "xmlchars": "^2.2.0"
+            },
+            "engines": {
+                "node": ">=v12.22.7"
+            }
+        },
+        "node_modules/siginfo": {
+            "version": "2.0.0",
+            "resolved": "https://registry.npmjs.org/siginfo/-/siginfo-2.0.0.tgz",
+            "integrity": "sha512-ybx0WO1/8bSBLEWXZvEd7gMW3Sn3JFlW3TvX1nREbDLRNQNaeNN8WK0meBwPdAaOI7TtRRRJn/Es1zhrrCHu7g==",
+            "dev": true
+        },
+        "node_modules/source-map-js": {
+            "version": "1.2.1",
+            "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz",
+            "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==",
+            "dev": true,
+            "engines": {
+                "node": ">=0.10.0"
+            }
+        },
+        "node_modules/stackback": {
+            "version": "0.0.2",
+            "resolved": "https://registry.npmjs.org/stackback/-/stackback-0.0.2.tgz",
+            "integrity": "sha512-1XMJE5fQo1jGH6Y/7ebnwPOBEkIEnT4QF32d5R1+VXdXveM0IBMJt8zfaxX1P3QhVwrYe+576+jkANtSS2mBbw==",
+            "dev": true
+        },
+        "node_modules/std-env": {
+            "version": "4.1.0",
+            "resolved": "https://registry.npmjs.org/std-env/-/std-env-4.1.0.tgz",
+            "integrity": "sha512-Rq7ybcX2RuC55r9oaPVEW7/xu3tj8u4GeBYHBWCychFtzMIr86A7e3PPEBPT37sHStKX3+TiX/Fr/ACmJLVlLQ==",
+            "dev": true,
+            "license": "MIT"
+        },
+        "node_modules/symbol-tree": {
+            "version": "3.2.4",
+            "resolved": "https://registry.npmjs.org/symbol-tree/-/symbol-tree-3.2.4.tgz",
+            "integrity": "sha512-9QNk5KwDF+Bvz+PyObkmSYjI5ksVUYtjW7AU22r2NKcfLJcXp96hkDWU3+XndOsUb+AQ9QhfzfCT2O+CNWT5Tw==",
+            "dev": true
+        },
+        "node_modules/tinybench": {
+            "version": "2.9.0",
+            "resolved": "https://registry.npmjs.org/tinybench/-/tinybench-2.9.0.tgz",
+            "integrity": "sha512-0+DUvqWMValLmha6lr4kD8iAMK1HzV0/aKnCtWb9v9641TnP/MFb7Pc2bxoxQjTXAErryXVgUOfv2YqNllqGeg==",
+            "dev": true
+        },
+        "node_modules/tinyexec": {
+            "version": "1.2.4",
+            "resolved": "https://registry.npmjs.org/tinyexec/-/tinyexec-1.2.4.tgz",
+            "integrity": "sha512-SHf/r48b7vOrjve9PxJo3MN5v5yuyjHvdUcrQffT3WXMUfnGmHDVbC4k3sHJaJTgZCwpUplIaAo5ANtMyp3YHg==",
+            "dev": true,
+            "license": "MIT",
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/tinyglobby": {
+            "version": "0.2.17",
+            "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.17.tgz",
+            "integrity": "sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "fdir": "^6.5.0",
+                "picomatch": "^4.0.4"
+            },
+            "engines": {
+                "node": ">=12.0.0"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/SuperchupuDev"
+            }
+        },
+        "node_modules/tinyrainbow": {
+            "version": "3.1.0",
+            "resolved": "https://registry.npmjs.org/tinyrainbow/-/tinyrainbow-3.1.0.tgz",
+            "integrity": "sha512-Bf+ILmBgretUrdJxzXM0SgXLZ3XfiaUuOj/IKQHuTXip+05Xn+uyEYdVg0kYDipTBcLrCVyUzAPz7QmArb0mmw==",
+            "dev": true,
+            "license": "MIT",
+            "engines": {
+                "node": ">=14.0.0"
+            }
+        },
+        "node_modules/tldts": {
+            "version": "7.0.28",
+            "resolved": "https://registry.npmjs.org/tldts/-/tldts-7.0.28.tgz",
+            "integrity": "sha512-+Zg3vWhRUv8B1maGSTFdev9mjoo8Etn2Ayfs4cnjlD3CsGkxXX4QyW3j2WJ0wdjYcYmy7Lx2RDsZMhgCWafKIw==",
+            "dev": true,
+            "dependencies": {
+                "tldts-core": "^7.0.28"
+            },
+            "bin": {
+                "tldts": "bin/cli.js"
+            }
+        },
+        "node_modules/tldts-core": {
+            "version": "7.0.28",
+            "resolved": "https://registry.npmjs.org/tldts-core/-/tldts-core-7.0.28.tgz",
+            "integrity": "sha512-7W5Efjhsc3chVdFhqtaU0KtK32J37Zcr9RKtID54nG+tIpcY79CQK/veYPODxtD/LJ4Lue66jvrQzIX2Z2/pUQ==",
+            "dev": true
+        },
+        "node_modules/tough-cookie": {
+            "version": "6.0.1",
+            "resolved": "https://registry.npmjs.org/tough-cookie/-/tough-cookie-6.0.1.tgz",
+            "integrity": "sha512-LktZQb3IeoUWB9lqR5EWTHgW/VTITCXg4D21M+lvybRVdylLrRMnqaIONLVb5mav8vM19m44HIcGq4qASeu2Qw==",
+            "dev": true,
+            "dependencies": {
+                "tldts": "^7.0.5"
+            },
+            "engines": {
+                "node": ">=16"
+            }
+        },
+        "node_modules/tr46": {
+            "version": "6.0.0",
+            "resolved": "https://registry.npmjs.org/tr46/-/tr46-6.0.0.tgz",
+            "integrity": "sha512-bLVMLPtstlZ4iMQHpFHTR7GAGj2jxi8Dg0s2h2MafAE4uSWF98FC/3MomU51iQAMf8/qDUbKWf5GxuvvVcXEhw==",
+            "dev": true,
+            "dependencies": {
+                "punycode": "^2.3.1"
+            },
+            "engines": {
+                "node": ">=20"
+            }
+        },
+        "node_modules/tslib": {
+            "version": "2.8.1",
+            "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz",
+            "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==",
+            "dev": true,
+            "license": "0BSD",
+            "optional": true
+        },
+        "node_modules/typescript": {
+            "version": "5.9.3",
+            "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
+            "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==",
+            "dev": true,
+            "bin": {
+                "tsc": "bin/tsc",
+                "tsserver": "bin/tsserver"
+            },
+            "engines": {
+                "node": ">=14.17"
+            }
+        },
+        "node_modules/vite": {
+            "version": "5.4.21",
+            "resolved": "https://registry.npmjs.org/vite/-/vite-5.4.21.tgz",
+            "integrity": "sha512-o5a9xKjbtuhY6Bi5S3+HvbRERmouabWbyUcpXXUA1u+GNUKoROi9byOJ8M0nHbHYHkYICiMlqxkg1KkYmm25Sw==",
+            "dev": true,
+            "dependencies": {
+                "esbuild": "^0.21.3",
+                "postcss": "^8.4.43",
+                "rollup": "^4.20.0"
+            },
+            "bin": {
+                "vite": "bin/vite.js"
+            },
+            "engines": {
+                "node": "^18.0.0 || >=20.0.0"
+            },
+            "funding": {
+                "url": "https://github.com/vitejs/vite?sponsor=1"
+            },
+            "optionalDependencies": {
+                "fsevents": "~2.3.3"
+            },
+            "peerDependencies": {
+                "@types/node": "^18.0.0 || >=20.0.0",
+                "less": "*",
+                "lightningcss": "^1.21.0",
+                "sass": "*",
+                "sass-embedded": "*",
+                "stylus": "*",
+                "sugarss": "*",
+                "terser": "^5.4.0"
+            },
+            "peerDependenciesMeta": {
+                "@types/node": {
+                    "optional": true
+                },
+                "less": {
+                    "optional": true
+                },
+                "lightningcss": {
+                    "optional": true
+                },
+                "sass": {
+                    "optional": true
+                },
+                "sass-embedded": {
+                    "optional": true
+                },
+                "stylus": {
+                    "optional": true
+                },
+                "sugarss": {
+                    "optional": true
+                },
+                "terser": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/vitest": {
+            "version": "4.1.8",
+            "resolved": "https://registry.npmjs.org/vitest/-/vitest-4.1.8.tgz",
+            "integrity": "sha512-flY6ScbCIt9HThs+C5HS7jvGOB560DJtk/Z15IQROTA6zEy49Nh8T/dofWTQL+n3vswqn87sbJNiuqw1SDp5Ig==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "@vitest/expect": "4.1.8",
+                "@vitest/mocker": "4.1.8",
+                "@vitest/pretty-format": "4.1.8",
+                "@vitest/runner": "4.1.8",
+                "@vitest/snapshot": "4.1.8",
+                "@vitest/spy": "4.1.8",
+                "@vitest/utils": "4.1.8",
+                "es-module-lexer": "^2.0.0",
+                "expect-type": "^1.3.0",
+                "magic-string": "^0.30.21",
+                "obug": "^2.1.1",
+                "pathe": "^2.0.3",
+                "picomatch": "^4.0.3",
+                "std-env": "^4.0.0-rc.1",
+                "tinybench": "^2.9.0",
+                "tinyexec": "^1.0.2",
+                "tinyglobby": "^0.2.15",
+                "tinyrainbow": "^3.1.0",
+                "vite": "^6.0.0 || ^7.0.0 || ^8.0.0",
+                "why-is-node-running": "^2.3.0"
+            },
+            "bin": {
+                "vitest": "vitest.mjs"
+            },
+            "engines": {
+                "node": "^20.0.0 || ^22.0.0 || >=24.0.0"
+            },
+            "funding": {
+                "url": "https://opencollective.com/vitest"
+            },
+            "peerDependencies": {
+                "@edge-runtime/vm": "*",
+                "@opentelemetry/api": "^1.9.0",
+                "@types/node": "^20.0.0 || ^22.0.0 || >=24.0.0",
+                "@vitest/browser-playwright": "4.1.8",
+                "@vitest/browser-preview": "4.1.8",
+                "@vitest/browser-webdriverio": "4.1.8",
+                "@vitest/coverage-istanbul": "4.1.8",
+                "@vitest/coverage-v8": "4.1.8",
+                "@vitest/ui": "4.1.8",
+                "happy-dom": "*",
+                "jsdom": "*",
+                "vite": "^6.0.0 || ^7.0.0 || ^8.0.0"
+            },
+            "peerDependenciesMeta": {
+                "@edge-runtime/vm": {
+                    "optional": true
+                },
+                "@opentelemetry/api": {
+                    "optional": true
+                },
+                "@types/node": {
+                    "optional": true
+                },
+                "@vitest/browser-playwright": {
+                    "optional": true
+                },
+                "@vitest/browser-preview": {
+                    "optional": true
+                },
+                "@vitest/browser-webdriverio": {
+                    "optional": true
+                },
+                "@vitest/coverage-istanbul": {
+                    "optional": true
+                },
+                "@vitest/coverage-v8": {
+                    "optional": true
+                },
+                "@vitest/ui": {
+                    "optional": true
+                },
+                "happy-dom": {
+                    "optional": true
+                },
+                "jsdom": {
+                    "optional": true
+                },
+                "vite": {
+                    "optional": false
+                }
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/aix-ppc64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.28.0.tgz",
+            "integrity": "sha512-lhRUCeuOyJQURhTxl4WkpFTjIsbDayJHih5kZC1giwE+MhIzAb7mEsQMqMf18rHLsrb5qI1tafG20mLxEWcWlA==",
+            "cpu": [
+                "ppc64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "aix"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/android-arm": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.28.0.tgz",
+            "integrity": "sha512-wqh0ByljabXLKHeWXYLqoJ5jKC4XBaw6Hk08OfMrCRd2nP2ZQ5eleDZC41XHyCNgktBGYMbqnrJKq/K/lzPMSQ==",
+            "cpu": [
+                "arm"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "android"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/android-arm64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.28.0.tgz",
+            "integrity": "sha512-+WzIXQOSaGs33tLEgYPYe/yQHf0WTU0X42Jca3y8NWMbUVhp7rUnw+vAsRC/QiDrdD31IszMrZy+qwPOPjd+rw==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "android"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/android-x64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.28.0.tgz",
+            "integrity": "sha512-+VJggoaKhk2VNNqVL7f6S189UzShHC/mR9EE8rDdSkdpN0KflSwWY/gWjDrNxxisg8Fp1ZCD9jLMo4m0OUfeUA==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "android"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/darwin-arm64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.28.0.tgz",
+            "integrity": "sha512-0T+A9WZm+bZ84nZBtk1ckYsOvyA3x7e2Acj1KdVfV4/2tdG4fzUp91YHx+GArWLtwqp77pBXVCPn2We7Letr0Q==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "darwin"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/darwin-x64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.28.0.tgz",
+            "integrity": "sha512-fyzLm/DLDl/84OCfp2f/XQ4flmORsjU7VKt8HLjvIXChJoFFOIL6pLJPH4Yhd1n1gGFF9mPwtlN5Wf82DZs+LQ==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "darwin"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/freebsd-arm64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.28.0.tgz",
+            "integrity": "sha512-l9GeW5UZBT9k9brBYI+0WDffcRxgHQD8ShN2Ur4xWq/NFzUKm3k5lsH4PdaRgb2w7mI9u61nr2gI2mLI27Nh3Q==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "freebsd"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/freebsd-x64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.28.0.tgz",
+            "integrity": "sha512-BXoQai/A0wPO6Es3yFJ7APCiKGc1tdAEOgeTNy3SsB491S3aHn4S4r3e976eUnPdU+NbdtmBuLncYir2tMU9Nw==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "freebsd"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/linux-arm": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.28.0.tgz",
+            "integrity": "sha512-CjaaREJagqJp7iTaNQjjidaNbCKYcd4IDkzbwwxtSvjI7NZm79qiHc8HqciMddQ6CKvJT6aBd8lO9kN/ZudLlw==",
+            "cpu": [
+                "arm"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/linux-arm64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.28.0.tgz",
+            "integrity": "sha512-RVyzfb3FWsGA55n6WY0MEIEPURL1FcbhFE6BffZEMEekfCzCIMtB5yyDcFnVbTnwk+CLAgTujmV/Lgvih56W+A==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/linux-ia32": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.28.0.tgz",
+            "integrity": "sha512-KBnSTt1kxl9x70q+ydterVdl+Cn0H18ngRMRCEQfrbqdUuntQQ0LoMZv47uB97NljZFzY6HcfqEZ2SAyIUTQBQ==",
+            "cpu": [
+                "ia32"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/linux-loong64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.28.0.tgz",
+            "integrity": "sha512-zpSlUce1mnxzgBADvxKXX5sl8aYQHo2ezvMNI8I0lbblJtp8V4odlm3Yzlj7gPyt3T8ReksE6bK+pT3WD+aJRg==",
+            "cpu": [
+                "loong64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/linux-mips64el": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.28.0.tgz",
+            "integrity": "sha512-2jIfP6mmjkdmeTlsX/9vmdmhBmKADrWqN7zcdtHIeNSCH1SqIoNI63cYsjQR8J+wGa4Y5izRcSHSm8K3QWmk3w==",
+            "cpu": [
+                "mips64el"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/linux-ppc64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.28.0.tgz",
+            "integrity": "sha512-bc0FE9wWeC0WBm49IQMPSPILRocGTQt3j5KPCA8os6VprfuJ7KD+5PzESSrJ6GmPIPJK965ZJHTUlSA6GNYEhg==",
+            "cpu": [
+                "ppc64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/linux-riscv64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.28.0.tgz",
+            "integrity": "sha512-SQPZOwoTTT/HXFXQJG/vBX8sOFagGqvZyXcgLA3NhIqcBv1BJU1d46c0rGcrij2B56Z2rNiSLaZOYW5cUk7yLQ==",
+            "cpu": [
+                "riscv64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/linux-s390x": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.28.0.tgz",
+            "integrity": "sha512-SCfR0HN8CEEjnYnySJTd2cw0k9OHB/YFzt5zgJEwa+wL/T/raGWYMBqwDNAC6dqFKmJYZoQBRfHjgwLHGSrn3Q==",
+            "cpu": [
+                "s390x"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/linux-x64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.28.0.tgz",
+            "integrity": "sha512-us0dSb9iFxIi8srnpl931Nvs65it/Jd2a2K3qs7fz2WfGPHqzfzZTfec7oxZJRNPXPnNYZtanmRc4AL/JwVzHQ==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/netbsd-x64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.28.0.tgz",
+            "integrity": "sha512-nU1yhmYutL+fQ71Kxnhg8uEOdC0pwEW9entHykTgEbna2pw2dkbFSMeqjjyHZoCmt8SBkOSvV+yNmm94aUrrqw==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "netbsd"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/openbsd-x64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.28.0.tgz",
+            "integrity": "sha512-8wZM2qqtv9UP3mzy7HiGYNH/zjTA355mpeuA+859TyR+e+Tc08IHYpLJuMsfpDJwoLo1ikIJI8jC3GFjnRClzA==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "openbsd"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/sunos-x64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.28.0.tgz",
+            "integrity": "sha512-1ZgjUoEdHZZl/YlV76TSCz9Hqj9h9YmMGAgAPYd+q4SicWNX3G5GCyx9uhQWSLcbvPW8Ni7lj4gDa1T40akdlw==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "sunos"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/win32-arm64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.28.0.tgz",
+            "integrity": "sha512-Q9StnDmQ/enxnpxCCLSg0oo4+34B9TdXpuyPeTedN/6+iXBJ4J+zwfQI28u/Jl40nOYAxGoNi7mFP40RUtkmUA==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "win32"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/win32-ia32": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.28.0.tgz",
+            "integrity": "sha512-zF3ag/gfiCe6U2iczcRzSYJKH1DCI+ByzSENHlM2FcDbEeo5Zd2C86Aq0tKUYAJJ1obRP84ymxIAksZUcdztHA==",
+            "cpu": [
+                "ia32"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "win32"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/win32-x64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.28.0.tgz",
+            "integrity": "sha512-pEl1bO9mfAmIC+tW5btTmrKaujg3zGtUmWNdCw/xs70FBjwAL3o9OEKNHvNmnyylD6ubxUERiEhdsL0xBQ9efw==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "win32"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@vitest/mocker": {
+            "version": "4.1.8",
+            "resolved": "https://registry.npmjs.org/@vitest/mocker/-/mocker-4.1.8.tgz",
+            "integrity": "sha512-LEiN/xe4OSIbKe9HQIp5OC24agGD9J5CnmMgsLohVVoOPWL9a2sBoR6VBx43jQZb7Kr1l4RCuyCJzcAa0+dojw==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "@vitest/spy": "4.1.8",
+                "estree-walker": "^3.0.3",
+                "magic-string": "^0.30.21"
+            },
+            "funding": {
+                "url": "https://opencollective.com/vitest"
+            },
+            "peerDependencies": {
+                "msw": "^2.4.9",
+                "vite": "^6.0.0 || ^7.0.0 || ^8.0.0"
+            },
+            "peerDependenciesMeta": {
+                "msw": {
+                    "optional": true
+                },
+                "vite": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/vitest/node_modules/esbuild": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.28.0.tgz",
+            "integrity": "sha512-sNR9MHpXSUV/XB4zmsFKN+QgVG82Cc7+/aaxJ8Adi8hyOac+EXptIp45QBPaVyX3N70664wRbTcLTOemCAnyqw==",
+            "dev": true,
+            "hasInstallScript": true,
+            "license": "MIT",
+            "optional": true,
+            "peer": true,
+            "bin": {
+                "esbuild": "bin/esbuild"
+            },
+            "engines": {
+                "node": ">=18"
+            },
+            "optionalDependencies": {
+                "@esbuild/aix-ppc64": "0.28.0",
+                "@esbuild/android-arm": "0.28.0",
+                "@esbuild/android-arm64": "0.28.0",
+                "@esbuild/android-x64": "0.28.0",
+                "@esbuild/darwin-arm64": "0.28.0",
+                "@esbuild/darwin-x64": "0.28.0",
+                "@esbuild/freebsd-arm64": "0.28.0",
+                "@esbuild/freebsd-x64": "0.28.0",
+                "@esbuild/linux-arm": "0.28.0",
+                "@esbuild/linux-arm64": "0.28.0",
+                "@esbuild/linux-ia32": "0.28.0",
+                "@esbuild/linux-loong64": "0.28.0",
+                "@esbuild/linux-mips64el": "0.28.0",
+                "@esbuild/linux-ppc64": "0.28.0",
+                "@esbuild/linux-riscv64": "0.28.0",
+                "@esbuild/linux-s390x": "0.28.0",
+                "@esbuild/linux-x64": "0.28.0",
+                "@esbuild/netbsd-arm64": "0.28.0",
+                "@esbuild/netbsd-x64": "0.28.0",
+                "@esbuild/openbsd-arm64": "0.28.0",
+                "@esbuild/openbsd-x64": "0.28.0",
+                "@esbuild/openharmony-arm64": "0.28.0",
+                "@esbuild/sunos-x64": "0.28.0",
+                "@esbuild/win32-arm64": "0.28.0",
+                "@esbuild/win32-ia32": "0.28.0",
+                "@esbuild/win32-x64": "0.28.0"
+            }
+        },
+        "node_modules/vitest/node_modules/vite": {
+            "version": "8.0.16",
+            "resolved": "https://registry.npmjs.org/vite/-/vite-8.0.16.tgz",
+            "integrity": "sha512-h9bXPmJichP5fLmVQo3PyaGSDE2n3aPuomeAlVRm0JLmt4rY6zmPKd59HYI4LNW8oTK7tlTsuC7l/m7awx9Jcw==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "lightningcss": "^1.32.0",
+                "picomatch": "^4.0.4",
+                "postcss": "^8.5.15",
+                "rolldown": "1.0.3",
+                "tinyglobby": "^0.2.17"
+            },
+            "bin": {
+                "vite": "bin/vite.js"
+            },
+            "engines": {
+                "node": "^20.19.0 || >=22.12.0"
+            },
+            "funding": {
+                "url": "https://github.com/vitejs/vite?sponsor=1"
+            },
+            "optionalDependencies": {
+                "fsevents": "~2.3.3"
+            },
+            "peerDependencies": {
+                "@types/node": "^20.19.0 || >=22.12.0",
+                "@vitejs/devtools": "^0.1.18",
+                "esbuild": "^0.27.0 || ^0.28.0",
+                "jiti": ">=1.21.0",
+                "less": "^4.0.0",
+                "sass": "^1.70.0",
+                "sass-embedded": "^1.70.0",
+                "stylus": ">=0.54.8",
+                "sugarss": "^5.0.0",
+                "terser": "^5.16.0",
+                "tsx": "^4.8.1",
+                "yaml": "^2.4.2"
+            },
+            "peerDependenciesMeta": {
+                "@types/node": {
+                    "optional": true
+                },
+                "@vitejs/devtools": {
+                    "optional": true
+                },
+                "esbuild": {
+                    "optional": true
+                },
+                "jiti": {
+                    "optional": true
+                },
+                "less": {
+                    "optional": true
+                },
+                "sass": {
+                    "optional": true
+                },
+                "sass-embedded": {
+                    "optional": true
+                },
+                "stylus": {
+                    "optional": true
+                },
+                "sugarss": {
+                    "optional": true
+                },
+                "terser": {
+                    "optional": true
+                },
+                "tsx": {
+                    "optional": true
+                },
+                "yaml": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/w3c-xmlserializer": {
+            "version": "5.0.0",
+            "resolved": "https://registry.npmjs.org/w3c-xmlserializer/-/w3c-xmlserializer-5.0.0.tgz",
+            "integrity": "sha512-o8qghlI8NZHU1lLPrpi2+Uq7abh4GGPpYANlalzWxyWteJOCsr/P+oPBA49TOLu5FTZO4d3F9MnWJfiMo4BkmA==",
+            "dev": true,
+            "dependencies": {
+                "xml-name-validator": "^5.0.0"
+            },
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/webidl-conversions": {
+            "version": "8.0.1",
+            "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-8.0.1.tgz",
+            "integrity": "sha512-BMhLD/Sw+GbJC21C/UgyaZX41nPt8bUTg+jWyDeg7e7YN4xOM05YPSIXceACnXVtqyEw/LMClUQMtMZ+PGGpqQ==",
+            "dev": true,
+            "engines": {
+                "node": ">=20"
+            }
+        },
+        "node_modules/whatwg-mimetype": {
+            "version": "4.0.0",
+            "resolved": "https://registry.npmjs.org/whatwg-mimetype/-/whatwg-mimetype-4.0.0.tgz",
+            "integrity": "sha512-QaKxh0eNIi2mE9p2vEdzfagOKHCcj1pJ56EEHGQOVxp8r9/iszLUUV7v89x9O1p/T+NlTM5W7jW6+cz4Fq1YVg==",
+            "dev": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/whatwg-url": {
+            "version": "15.1.0",
+            "resolved": "https://registry.npmjs.org/whatwg-url/-/whatwg-url-15.1.0.tgz",
+            "integrity": "sha512-2ytDk0kiEj/yu90JOAp44PVPUkO9+jVhyf+SybKlRHSDlvOOZhdPIrr7xTH64l4WixO2cP+wQIcgujkGBPPz6g==",
+            "dev": true,
+            "dependencies": {
+                "tr46": "^6.0.0",
+                "webidl-conversions": "^8.0.0"
+            },
+            "engines": {
+                "node": ">=20"
+            }
+        },
+        "node_modules/why-is-node-running": {
+            "version": "2.3.0",
+            "resolved": "https://registry.npmjs.org/why-is-node-running/-/why-is-node-running-2.3.0.tgz",
+            "integrity": "sha512-hUrmaWBdVDcxvYqnyh09zunKzROWjbZTiNy8dBEjkS7ehEDQibXJ7XvlmtbwuTclUiIyN+CyXQD4Vmko8fNm8w==",
+            "dev": true,
+            "dependencies": {
+                "siginfo": "^2.0.0",
+                "stackback": "0.0.2"
+            },
+            "bin": {
+                "why-is-node-running": "cli.js"
+            },
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/ws": {
+            "version": "8.20.0",
+            "resolved": "https://registry.npmjs.org/ws/-/ws-8.20.0.tgz",
+            "integrity": "sha512-sAt8BhgNbzCtgGbt2OxmpuryO63ZoDk/sqaB/znQm94T4fCEsy/yV+7CdC1kJhOU9lboAEU7R3kquuycDoibVA==",
+            "dev": true,
+            "engines": {
+                "node": ">=10.0.0"
+            },
+            "peerDependencies": {
+                "bufferutil": "^4.0.1",
+                "utf-8-validate": ">=5.0.2"
+            },
+            "peerDependenciesMeta": {
+                "bufferutil": {
+                    "optional": true
+                },
+                "utf-8-validate": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/xml-name-validator": {
+            "version": "5.0.0",
+            "resolved": "https://registry.npmjs.org/xml-name-validator/-/xml-name-validator-5.0.0.tgz",
+            "integrity": "sha512-EvGK8EJ3DhaHfbRlETOWAS5pO9MZITeauHKJyb8wyajUfQUenkIg2MvLDTZ4T/TgIcm3HU0TFBgWWboAZ30UHg==",
+            "dev": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/xmlchars": {
+            "version": "2.2.0",
+            "resolved": "https://registry.npmjs.org/xmlchars/-/xmlchars-2.2.0.tgz",
+            "integrity": "sha512-JZnDKK8B0RCDw84FNdDAIpZK+JuJw+s7Lz8nksI7SIuU3UXJJslUthsi+uWBUYOwPFwW7W7PRLRfUKpxjtjFCw==",
+            "dev": true
+        }
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/package.json b/plugins/_bundled/sirsoft-pay_nhnkcp/package.json
new file mode 100644
index 00000000..a6775d63
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/package.json
@@ -0,0 +1,19 @@
+{
+    "name": "@g7/sirsoft-pay_nhnkcp",
+    "version": "1.0.0-beta.4",
+    "type": "module",
+    "private": true,
+    "scripts": {
+        "dev": "vite",
+        "build": "vite build",
+        "preview": "vite preview",
+        "test": "vitest",
+        "test:run": "vitest run"
+    },
+    "devDependencies": {
+        "jsdom": "^27.4.0",
+        "typescript": "^5.3.3",
+        "vite": "^5.4.14",
+        "vitest": "^4.1.8"
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/plugin.json b/plugins/_bundled/sirsoft-pay_nhnkcp/plugin.json
new file mode 100644
index 00000000..6c5eb1e5
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/plugin.json
@@ -0,0 +1,34 @@
+{
+    "identifier": "sirsoft-pay_nhnkcp",
+    "vendor": "sirsoft",
+    "name": {
+        "ko": "NHN KCP",
+        "en": "NHN KCP"
+    },
+    "version": "1.0.0-beta.4",
+    "license": "MIT",
+    "github_url": "https://github.com/gnuboard/g7-plugin-sirsoft-pay_nhnkcp",
+    "github_changelog_url": "https://github.com/gnuboard/g7-plugin-sirsoft-pay_nhnkcp/blob/main/CHANGELOG.md",
+    "description": {
+        "ko": "NHN KCP 결제 게이트웨이 (Standard Pay 연동)",
+        "en": "NHN KCP payment gateway (Standard Pay integration)"
+    },
+    "g7_version": ">=7.0.0-beta.2",
+    "dependencies": {
+        "modules": {
+            "sirsoft-ecommerce": ">=1.0.0-beta.5"
+        },
+        "plugins": {}
+    },
+    "assets": {
+        "js": {
+            "entry": "resources/js/index.ts",
+            "output": "dist/js/plugin.iife.js"
+        },
+        "handlers": true
+    },
+    "loading": {
+        "strategy": "global",
+        "priority": 100
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/plugin.php b/plugins/_bundled/sirsoft-pay_nhnkcp/plugin.php
new file mode 100644
index 00000000..e0f39fea
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/plugin.php
@@ -0,0 +1,204 @@
+<?php
+
+namespace Plugins\Sirsoft\PayNhnkcp;
+
+use App\Extension\AbstractPlugin;
+
+/**
+ * NHN KCP PG 플러그인
+ *
+ * NHN KCP Standard Pay(카드/계좌이체/가상계좌/휴대폰) 연동을 제공합니다.
+ * sirsoft-ecommerce 모듈 전용 플러그인입니다.
+ */
+class Plugin extends AbstractPlugin
+{
+    public function getMetadata(): array
+    {
+        return [
+            'author' => 'Sirsoft',
+            'license' => 'MIT',
+            'homepage' => 'https://sir.kr',
+            'keywords' => ['payment', 'nhnkcp', 'kcp', 'pg', 'card', 'ecommerce'],
+        ];
+    }
+
+    public function getSettingsSchema(): array
+    {
+        return [
+            'is_test_mode' => [
+                'type' => 'boolean',
+                'default' => true,
+                'label' => ['ko' => '테스트 모드', 'en' => 'Test Mode'],
+                'hint' => [
+                    'ko' => '테스트 모드에서는 실제 결제가 발생하지 않습니다.',
+                    'en' => 'No real payments occur in test mode.',
+                ],
+            ],
+            'test_site_cd' => [
+                'type' => 'string',
+                'default' => 'T0000',
+                'label' => ['ko' => '테스트 사이트 코드 (site_cd)', 'en' => 'Test Site Code (site_cd)'],
+                'hint' => [
+                    'ko' => 'KCP에서 발급받은 테스트 사이트 코드 (기본값: T0000)',
+                    'en' => 'Test site code issued by KCP (default: T0000)',
+                ],
+            ],
+            'test_site_key' => [
+                'type' => 'string',
+                'default' => '',
+                'sensitive' => true,
+                'label' => ['ko' => '테스트 사이트 키 (site_key)', 'en' => 'Test Site Key (site_key)'],
+                'hint' => [
+                    'ko' => 'KCP에서 발급받은 테스트 사이트 키',
+                    'en' => 'Test site key issued by KCP',
+                ],
+            ],
+            'live_site_cd' => [
+                'type' => 'string',
+                'default' => '',
+                'label' => ['ko' => '라이브 사이트 코드 (site_cd)', 'en' => 'Live Site Code (site_cd)'],
+                'hint' => [
+                    'ko' => 'KCP에서 발급받은 라이브 사이트 코드 (SR prefix 제외하고 입력)',
+                    'en' => 'Live site code issued by KCP (enter without SR prefix)',
+                ],
+            ],
+            'live_site_key' => [
+                'type' => 'string',
+                'default' => '',
+                'sensitive' => true,
+                'label' => ['ko' => '라이브 사이트 키 (site_key)', 'en' => 'Live Site Key (site_key)'],
+                'hint' => [
+                    'ko' => '외부에 노출되지 않도록 주의하세요.',
+                    'en' => 'Keep this key secret.',
+                ],
+            ],
+            'redirect_success_url' => [
+                'type' => 'string',
+                'default' => '/shop/orders/{orderId}/complete',
+                'label' => ['ko' => '결제 성공 리다이렉트 URL', 'en' => 'Payment Success Redirect URL'],
+                'hint' => [
+                    'ko' => '상대 경로(/shop/...) 또는 전체 URL(https://...) 모두 가능합니다. {orderId}는 주문번호로 자동 치환됩니다.',
+                    'en' => 'Supports relative paths (/shop/...) or full URLs (https://...). {orderId} will be replaced with the actual order number.',
+                ],
+            ],
+            'redirect_fail_url' => [
+                'type' => 'string',
+                'default' => '/shop/checkout',
+                'label' => ['ko' => '결제 실패 리다이렉트 URL', 'en' => 'Payment Failure Redirect URL'],
+                'hint' => [
+                    'ko' => '상대 경로 또는 전체 URL 모두 가능합니다. 오류 정보는 쿼리 파라미터로 자동 추가됩니다.',
+                    'en' => 'Supports relative paths or full URLs. Error details are appended as query parameters.',
+                ],
+            ],
+            'use_escrow' => [
+                'type' => 'boolean',
+                'default' => false,
+                'label' => ['ko' => '에스크로 결제 활성화', 'en' => 'Enable Escrow Payment'],
+                'hint' => [
+                    'ko' => 'KCP 에스크로 결제 사용 시 활성화. 별도 site_cd 가 필요합니다.',
+                    'en' => 'Enable KCP escrow payment. A separate site_cd is required.',
+                ],
+            ],
+            'escrow_test_site_cd' => [
+                'type' => 'string',
+                'default' => '',
+                'label' => ['ko' => '테스트 에스크로 사이트 코드', 'en' => 'Test Escrow Site Code'],
+                'hint' => [
+                    'ko' => 'KCP 에스크로 테스트 site_cd. 미입력 시 일반 test_site_cd 를 그대로 사용.',
+                    'en' => 'KCP escrow test site_cd. Falls back to regular test_site_cd if empty.',
+                ],
+            ],
+            'vbank_expire_days' => [
+                'type' => 'integer',
+                'default' => 3,
+                'min' => 1,
+                'max' => 30,
+                'label' => ['ko' => '가상계좌 입금 만료(일)', 'en' => 'Virtual Account Expiry (days)'],
+                'hint' => [
+                    'ko' => '가상계좌 발급 후 입금 가능 기간. 모바일 vcnt_expire_term 값으로 전달.',
+                    'en' => 'Days the virtual account remains payable after issuance.',
+                ],
+            ],
+            'easy_pay_allow_with_other_pg' => ['type' => 'boolean', 'default' => false],
+            'easy_pay_payco'               => ['type' => 'boolean', 'default' => false],
+            'easy_pay_naverpay'            => ['type' => 'boolean', 'default' => false],
+            'easy_pay_naverpay_point'      => ['type' => 'boolean', 'default' => false],
+            'easy_pay_kakaopay'            => ['type' => 'boolean', 'default' => false],
+            'easy_pay_applepay'            => ['type' => 'boolean', 'default' => false],
+        ];
+    }
+
+    public function getConfigValues(): array
+    {
+        return [
+            'is_test_mode' => true,
+            'test_site_cd' => 'T0000',
+            'test_site_key' => '',
+            'live_site_cd' => '',
+            'live_site_key' => '',
+            'redirect_success_url' => '/shop/orders/{orderId}/complete',
+            'redirect_fail_url' => '/shop/checkout',
+            'use_escrow' => false,
+            'escrow_test_site_cd' => '',
+            'vbank_expire_days' => 3,
+            'easy_pay_allow_with_other_pg' => false,
+            'easy_pay_payco'               => false,
+            'easy_pay_naverpay'            => false,
+            'easy_pay_naverpay_point'      => false,
+            'easy_pay_kakaopay'            => false,
+            'easy_pay_applepay'            => false,
+        ];
+    }
+
+    public function getHookListeners(): array
+    {
+        return [
+            Listeners\RegisterPgProviderListener::class,
+            Listeners\PaymentRefundListener::class,
+            Listeners\CancelActivityLogListener::class,
+            Listeners\RegisterEasyPayMethodsListener::class,
+            Listeners\AdjustEcommercePaymentMethodsLayoutListener::class,
+            Listeners\EnsureAdminOrderListTestBadgeLayoutListener::class,
+            Listeners\EnsureAdminOrderDetailPaymentQueryLayoutListener::class,
+            Listeners\RestoreLayoutExtensionsAfterUpdateListener::class,
+        ];
+    }
+
+    public function getHooks(): array
+    {
+        return [
+            [
+                'name' => 'sirsoft-pay_nhnkcp.payment.before_confirm',
+                'type' => 'action',
+                'description' => [
+                    'ko' => 'KCP 결제 승인 확인 전',
+                    'en' => 'Before KCP payment confirmation',
+                ],
+            ],
+            [
+                'name' => 'sirsoft-pay_nhnkcp.payment.after_confirm',
+                'type' => 'action',
+                'description' => [
+                    'ko' => 'KCP 결제 승인 확인 완료 후',
+                    'en' => 'After KCP payment confirmation completed',
+                ],
+            ],
+            [
+                'name' => 'sirsoft-pay_nhnkcp.payment.before_cancel',
+                'type' => 'action',
+                'description' => [
+                    'ko' => 'KCP 결제 취소 API 호출 전 (본인인증 등 확장 지점)',
+                    'en' => 'Before KCP cancel API call (extension point for re-auth, etc.)',
+                ],
+            ],
+            [
+                'name' => 'sirsoft-pay_nhnkcp.payment.after_cancel',
+                'type' => 'action',
+                'description' => [
+                    'ko' => 'KCP 결제 취소 완료 후',
+                    'en' => 'After KCP cancel completed',
+                ],
+            ],
+        ];
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/resources/extensions/admin_order_list_test_badge.json b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/extensions/admin_order_list_test_badge.json
new file mode 100644
index 00000000..501d1908
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/extensions/admin_order_list_test_badge.json
@@ -0,0 +1,295 @@
+{
+    "target_layout": "admin_ecommerce_order_list",
+    "priority": 200,
+    "data_sources": [
+        {
+            "id": "nhnkcp_test_map",
+            "label_key": "$t:sirsoft-pay_nhnkcp.editor.data_source.nhnkcp_test_map",
+            "type": "api",
+            "endpoint": "/api/plugins/sirsoft-pay_nhnkcp/admin/orders/test-mode-map",
+            "method": "GET",
+            "auto_fetch": true,
+            "auth_required": true,
+            "loading_strategy": "progressive"
+        },
+        {
+            "id": "nhnkcp_easy_pay_display_map",
+            "label_key": "$t:sirsoft-pay_nhnkcp.editor.data_source.nhnkcp_easy_pay_display_map",
+            "type": "api",
+            "endpoint": "/api/plugins/sirsoft-pay_nhnkcp/admin/orders/easy-pay-display-map",
+            "method": "GET",
+            "auto_fetch": true,
+            "auth_required": true,
+            "loading_strategy": "progressive"
+        },
+        {
+            "id": "nicepay_test_map",
+            "label_key": "$t:sirsoft-pay_nhnkcp.editor.data_source.nicepay_test_map",
+            "type": "api",
+            "endpoint": "/api/plugins/sirsoft-pay_nicepayments/admin/orders/test-mode-map",
+            "method": "GET",
+            "auto_fetch": true,
+            "auth_required": true,
+            "loading_strategy": "progressive",
+            "condition": "{{installed_plugins?.['sirsoft-pay_nicepayments']?.is_active === true}}"
+        }
+    ],
+    "injections": [
+        {
+            "target_id": "order_datagrid",
+            "position": "inject_props",
+            "props": {
+                "columns": [
+                    {
+                        "field": "no",
+                        "header": "NO",
+                        "width": "60px",
+                        "sortable": false,
+                        "required": false,
+                        "cellChildren": [
+                            { "type": "basic", "name": "Span", "text": "{{row.no}}" }
+                        ]
+                    },
+                    {
+                        "field": "ordered_at",
+                        "header": "$t:sirsoft-ecommerce.admin.order.column.order_date",
+                        "width": "140px",
+                        "sortable": true,
+                        "required": true,
+                        "cellChildren": [
+                            { "type": "basic", "name": "Span", "text": "{{row.ordered_at_formatted}}" }
+                        ]
+                    },
+                    {
+                        "field": "order_number",
+                        "header": "$t:sirsoft-ecommerce.admin.order.column.order_number",
+                        "width": "140px",
+                        "sortable": true,
+                        "required": true,
+                        "cellChildren": [
+                            {
+                                "type": "basic",
+                                "name": "Span",
+                                "props": { "className": "font-medium text-blue-600 dark:text-blue-400 cursor-pointer hover:underline" },
+                                "text": "{{row.order_number}}",
+                                "actions": [
+                                    { "type": "click", "handler": "navigate", "params": { "path": "/admin/ecommerce/orders/{{row.order_number}}" } }
+                                ]
+                            }
+                        ]
+                    },
+                    {
+                        "field": "product",
+                        "header": "$t:sirsoft-ecommerce.admin.order.column.product",
+                        "width": "auto",
+                        "sortable": false,
+                        "required": false,
+                        "cellChildren": [
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": { "className": "flex items-start gap-2" },
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "Img",
+                                        "props": { "src": "{{row.first_option?.thumbnail_url}}", "alt": "{{row.first_option?.product_name}}", "className": "w-10 h-10 rounded object-cover flex-shrink-0 bg-gray-100 dark:bg-gray-700" },
+                                        "if": "{{row.first_option?.thumbnail_url}}"
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": { "className": "space-y-0.5 min-w-0" },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "props": { "className": "font-medium" },
+                                                "children": [
+                                                    { "type": "basic", "name": "A", "props": { "className": "hover:underline hover:text-blue-600 dark:text-blue-400 dark:hover:text-blue-400 cursor-pointer", "href": "{{'\/admin\/ecommerce\/products\/' + row.first_option?.product_code + '\/edit'}}", "target": "_blank" }, "text": "{{row.first_option?.product_name}}", "if": "{{row.first_option?.product_code}}" },
+                                                    { "type": "basic", "name": "Span", "text": "{{row.first_option?.product_name}}", "if": "{{!row.first_option?.product_code}}" },
+                                                    { "type": "basic", "name": "Span", "props": { "className": "text-gray-500 dark:text-gray-400 font-normal ml-1" }, "text": "$t:defer:sirsoft-ecommerce.admin.order.product.more|count={{row.options_count - 1}}", "if": "{{row.options_count > 1}}" }
+                                                ]
+                                            },
+                                            { "type": "basic", "name": "Div", "props": { "className": "text-tertiary" }, "text": "{{row.first_option?.product_option_name}}", "if": "{{row.first_option?.product_option_name}}" }
+                                        ]
+                                    }
+                                ]
+                            }
+                        ]
+                    },
+                    {
+                        "field": "order_amount",
+                        "header": "$t:sirsoft-ecommerce.admin.order.column.order_amount",
+                        "width": "140px",
+                        "sortable": true,
+                        "required": true,
+                        "cellChildren": [
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": { "className": "row-stack" },
+                                "children": [
+                                    { "type": "basic", "name": "Span", "props": { "className": "font-medium" }, "text": "{{row.total_amount_formatted}}" },
+                                    { "type": "basic", "name": "Span", "props": { "className": "text-xs text-gray-400 dark:text-gray-500" }, "text": "$t:defer:sirsoft-ecommerce.admin.order.column.shipping_fee_short|amount={{row.total_shipping_amount_formatted}}", "if": "{{row.total_shipping_amount > 0}}" },
+                                    { "type": "basic", "name": "Span", "props": { "className": "text-xs text-green-600 dark:text-green-400" }, "text": "$t:defer:sirsoft-ecommerce.admin.order.column.paid_short|amount={{row.total_paid_amount_formatted}}", "if": "{{row.total_paid_amount > 0}}" },
+                                    { "type": "basic", "name": "Span", "props": { "className": "text-xs text-red-600 dark:text-red-400" }, "text": "$t:defer:sirsoft-ecommerce.admin.order.column.unpaid_short|amount={{row.total_unpaid_amount_formatted}}", "if": "{{row.total_unpaid_amount > 0}}" }
+                                ]
+                            }
+                        ]
+                    },
+                    {
+                        "field": "order_status",
+                        "header": "$t:sirsoft-ecommerce.admin.order.column.order_status",
+                        "width": "100px",
+                        "sortable": false,
+                        "required": false,
+                        "cellChildren": [
+                            { "type": "composite", "name": "StatusBadge", "props": { "status": "{{row.order_status_variant || 'default'}}", "label": "{{row.order_status_label}}", "showIcon": false } }
+                        ]
+                    },
+                    {
+                        "field": "orderer",
+                        "header": "$t:sirsoft-ecommerce.admin.order.column.orderer",
+                        "width": "140px",
+                        "sortable": false,
+                        "required": false,
+                        "cellChildren": [
+                            { "type": "basic", "name": "Span", "props": { "className": "text-gray-500 dark:text-gray-400" }, "text": "-", "if": "{{!row.address?.orderer_name && !row.user?.name}}" },
+                            {
+                                "type": "composite",
+                                "name": "ActionMenu",
+                                "if": "{{!!row.address?.orderer_name || !!row.user?.name}}",
+                                "props": {
+                                    "position": "right",
+                                    "items": [
+                                        { "id": "view_member", "label": "$t:sirsoft-ecommerce.admin.order.action.view_member", "iconName": "user", "if": "{{!!row.user?.uuid}}" },
+                                        { "id": "search_by_orderer_member", "label": "$t:sirsoft-ecommerce.admin.order.action.search_by_orderer", "iconName": "magnifying-glass", "if": "{{!!row.user?.uuid}}" },
+                                        { "id": "search_by_orderer_guest", "label": "$t:sirsoft-ecommerce.admin.order.action.search_by_orderer", "iconName": "magnifying-glass", "if": "{{!row.user?.uuid}}" }
+                                    ]
+                                },
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": { "className": "flex-center gap-2 hover:bg-gray-50 dark:bg-gray-800 dark:hover:bg-gray-700 rounded-lg px-1 py-0.5 transition-colors" },
+                                        "children": [
+                                            { "type": "basic", "name": "Icon", "if": "{{!!row.user?.uuid}}", "props": { "name": "fa-regular fa-user", "className": "text-gray-400 dark:text-gray-500 flex-shrink-0" } },
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "props": { "className": "min-w-0 flex-1" },
+                                                "children": [
+                                                    { "type": "basic", "name": "Span", "if": "{{!!row.user?.uuid}}", "props": { "className": "font-medium text-gray-900 dark:text-gray-100 truncate block" }, "text": "{{row.address?.orderer_name || row.user?.name}}" },
+                                                    { "type": "basic", "name": "Span", "if": "{{!row.user?.uuid}}", "props": { "className": "text-gray-600 dark:text-gray-400 truncate block" }, "text": "{{row.address?.orderer_name || row.user?.name}}" },
+                                                    { "type": "basic", "name": "Span", "comment": "첫구매 표시", "if": "{{row.is_first_order}}", "props": { "className": "text-xs text-emerald-500 dark:text-emerald-400" }, "text": "$t:sirsoft-ecommerce.admin.order.column.first_order" }
+                                                ]
+                                            }
+                                        ]
+                                    }
+                                ],
+                                "actions": [
+                                    {
+                                        "event": "onItemClick",
+                                        "handler": "switch",
+                                        "value": "{{$args[0]}}",
+                                        "cases": {
+                                            "view_member": { "handler": "openWindow", "params": { "path": "/admin/users/{{row.user?.uuid}}" } },
+                                            "search_by_orderer_member": {
+                                                "handler": "sequence",
+                                                "actions": [
+                                                    { "handler": "setState", "params": { "target": "_local", "filter.ordererUuid": "{{row.user?.uuid}}", "filter.searchField": "all", "filter.searchKeyword": "", "ordererSearchResults": "{{[{ uuid: row.user?.uuid, name: row.user?.name || row.address?.orderer_name, email: row.user?.email || '' }]}}" } },
+                                                    { "handler": "navigate", "params": { "path": "/admin/ecommerce/orders", "query": { "orderer_uuid": "{{row.user?.uuid}}", "page": 1 }, "transition_overlay_target": "order_datagrid__body" } }
+                                                ]
+                                            },
+                                            "search_by_orderer_guest": {
+                                                "handler": "sequence",
+                                                "actions": [
+                                                    { "handler": "setState", "params": { "target": "_local", "filter.searchField": "orderer_name", "filter.searchKeyword": "{{row.address?.orderer_name || row.user?.name}}" } },
+                                                    { "handler": "navigate", "params": { "path": "/admin/ecommerce/orders", "query": { "search_field": "orderer_name", "search_keyword": "{{row.address?.orderer_name || row.user?.name}}", "page": 1 }, "transition_overlay_target": "order_datagrid__body" } }
+                                                ]
+                                            }
+                                        }
+                                    }
+                                ]
+                            }
+                        ]
+                    },
+                    {
+                        "field": "payment_method",
+                        "header": "$t:sirsoft-ecommerce.admin.order.column.payment_method",
+                        "width": "100px",
+                        "sortable": false,
+                        "required": false,
+                        "cellChildren": [
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": { "className": "row-stack" },
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "Span",
+                                        "text": "{{nhnkcp_easy_pay_display_map.data?.[row.order_number]?.payment_method_display_label ?? row.payment?.payment_method_label}}"
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "Span",
+                                        "if": "{{nhnkcp_test_map.data?.[row.order_number] === true}}",
+                                        "props": { "className": "text-xs font-medium text-orange-500 dark:text-orange-400 leading-tight" },
+                                        "text": "($t:sirsoft-pay_nhnkcp.admin.test_mode_badge)"
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "Span",
+                                        "if": "{{nicepay_test_map.data?.[row.order_number] === true}}",
+                                        "props": { "className": "text-xs font-medium text-orange-500 dark:text-orange-400 leading-tight" },
+                                        "text": "($t:sirsoft-pay_nicepayments.admin.test_mode_badge)"
+                                    }
+                                ]
+                            }
+                        ]
+                    },
+                    {
+                        "field": "delivery_method",
+                        "header": "$t:sirsoft-ecommerce.admin.order.column.delivery_method",
+                        "width": "100px",
+                        "sortable": false,
+                        "required": false,
+                        "cellChildren": [
+                            { "type": "basic", "name": "Span", "text": "{{row.shipping?.shipping_type_label}}" }
+                        ]
+                    },
+                    {
+                        "field": "country",
+                        "header": "$t:sirsoft-ecommerce.admin.order.column.country",
+                        "width": "80px",
+                        "sortable": false,
+                        "required": false,
+                        "cellChildren": [
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": { "className": "flex-center gap-2" },
+                                "children": [
+                                    { "type": "basic", "name": "Span", "props": { "className": "fi fi-{{row.address?.recipient_country_code?.toLowerCase()}} flex-shrink-0" }, "if": "{{row.address?.recipient_country_code}}" },
+                                    { "type": "basic", "name": "Span", "text": "{{$localized(row.address?.recipient_country_name) ?? row.address?.recipient_country_code}}", "if": "{{row.address?.recipient_country_code}}" }
+                                ]
+                            }
+                        ]
+                    },
+                    {
+                        "field": "device",
+                        "header": "$t:sirsoft-ecommerce.admin.order.column.device",
+                        "width": "80px",
+                        "sortable": false,
+                        "required": false,
+                        "cellChildren": [
+                            { "type": "basic", "name": "Span", "text": "{{row.order_device_label}}" }
+                        ]
+                    }
+                ]
+            }
+        }
+    ]
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/resources/extensions/admin_order_payment_query.json b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/extensions/admin_order_payment_query.json
new file mode 100644
index 00000000..a0b3eadc
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/extensions/admin_order_payment_query.json
@@ -0,0 +1,548 @@
+{
+    "target_layout": "admin_ecommerce_order_detail",
+    "data_sources": [
+        {
+            "id": "kcp_status",
+            "label_key": "$t:sirsoft-pay_nhnkcp.editor.data_source.kcp_status",
+            "type": "api",
+            "endpoint": "/api/plugins/sirsoft-pay_nhnkcp/admin/orders/{{route.orderNumber}}/transaction-status",
+            "method": "GET",
+            "auto_fetch": true,
+            "auth_required": true
+        },
+        {
+            "id": "kcp_escrow_delivery",
+            "label_key": "$t:sirsoft-pay_nhnkcp.editor.data_source.kcp_escrow_delivery",
+            "type": "api",
+            "endpoint": "/api/plugins/sirsoft-pay_nhnkcp/admin/orders/{{route.orderNumber}}/escrow-delivery",
+            "method": "GET",
+            "auto_fetch": true,
+            "auth_required": true
+        }
+    ],
+    "injections": [
+        {
+            "target_id": "sticky_header_container",
+            "position": "append_child",
+            "components": [
+                {
+                    "type": "basic",
+                    "name": "Div",
+                    "if": "{{kcp_status.data?._is_test_mode === true}}",
+                    "props": { "className": "mx-6 mb-3 px-3 py-2 bg-orange-50 dark:bg-orange-900/20 border border-orange-200 dark:border-orange-700 rounded-lg flex-center gap-2" },
+                    "children": [
+                        {
+                            "type": "basic",
+                            "name": "Icon",
+                            "props": { "name": "flask-conical", "className": "w-4 h-4 text-orange-600 dark:text-orange-400 flex-shrink-0" }
+                        },
+                        {
+                            "type": "basic",
+                            "name": "Span",
+                            "props": { "className": "text-sm font-semibold text-orange-800 dark:text-orange-300" },
+                            "text": "$t:sirsoft-pay_nhnkcp.admin.test_mode_badge"
+                        },
+                        {
+                            "type": "basic",
+                            "name": "Span",
+                            "props": { "className": "text-sm text-orange-700 dark:text-orange-400" },
+                            "text": "$t:sirsoft-pay_nhnkcp.admin.test_mode_order_notice"
+                        }
+                    ]
+                }
+            ]
+        },
+        {
+            "target_id": "tab_content_area",
+            "position": "append_child",
+            "components": [
+                {
+                    "id": "kcp_info_panel",
+                    "type": "basic",
+                    "name": "Div",
+                    "if": "{{!!kcp_status.data?.tno}}",
+                    "props": { "className": "admin-card" },
+                    "children": [
+                        {
+                            "type": "basic",
+                            "name": "Div",
+                            "props": { "className": "flex-center gap-2 mb-4" },
+                            "children": [
+                                {
+                                    "type": "basic",
+                                    "name": "Div",
+                                    "props": { "className": "w-1.5 h-4 bg-blue-500 rounded-full flex-shrink-0" }
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "H3",
+                                    "props": { "className": "text-sm font-semibold text-gray-800 dark:text-gray-200" },
+                                    "text": "$t:sirsoft-pay_nhnkcp.admin.order_info_title"
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "Span",
+                                    "props": { "className": "text-hint hidden sm:inline" },
+                                    "text": "$t:sirsoft-pay_nhnkcp.admin.order_info_description"
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "Span",
+                                    "if": "{{kcp_status.data?.refund_status === 'completed' && (kcp_status.data?.payment_status === 'cancelled' || kcp_status.data?.payment_status === 'partial_cancelled')}}",
+                                    "props": { "className": "ml-auto inline-flex items-center px-2 py-0.5 rounded-full text-xs font-semibold bg-red-100 text-red-800 dark:bg-red-900/30 dark:text-red-300" },
+                                    "text": "$t:sirsoft-pay_nhnkcp.admin.pay_status_cancel_completed"
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "Span",
+                                    "if": "{{kcp_status.data?.payment_status === 'partial_cancelled' && kcp_status.data?.refund_status !== 'completed'}}",
+                                    "props": { "className": "ml-auto inline-flex items-center px-2 py-0.5 rounded-full text-xs font-semibold bg-amber-100 text-amber-800 dark:bg-amber-900/30 dark:text-amber-300" },
+                                    "text": "$t:sirsoft-pay_nhnkcp.admin.pay_status_partial_cancelled"
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "Span",
+                                    "if": "{{kcp_status.data?.payment_status === 'cancelled' && kcp_status.data?.refund_status !== 'completed'}}",
+                                    "props": { "className": "ml-auto inline-flex items-center px-2 py-0.5 rounded-full text-xs font-semibold bg-red-100 text-red-800 dark:bg-red-900/30 dark:text-red-300" },
+                                    "text": "$t:sirsoft-pay_nhnkcp.admin.pay_status_cancelled"
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "Span",
+                                    "if": "{{kcp_status.data?.payment_status === 'paid' && kcp_status.data?.res_cd === '0000'}}",
+                                    "props": { "className": "ml-auto inline-flex items-center px-2 py-0.5 rounded-full text-xs font-semibold bg-green-100 text-green-800 dark:bg-green-900/30 dark:text-green-300" },
+                                    "text": "$t:sirsoft-pay_nhnkcp.admin.pay_status_approved"
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "Span",
+                                    "if": "{{!(kcp_status.data?.refund_status === 'completed' && (kcp_status.data?.payment_status === 'cancelled' || kcp_status.data?.payment_status === 'partial_cancelled')) && kcp_status.data?.payment_status !== 'cancelled' && kcp_status.data?.payment_status !== 'partial_cancelled' && !(kcp_status.data?.payment_status === 'paid' && kcp_status.data?.res_cd === '0000')}}",
+                                    "props": { "className": "ml-auto inline-flex items-center px-2 py-0.5 rounded-full text-xs font-semibold bg-amber-100 text-amber-800 dark:bg-amber-900/30 dark:text-amber-300" },
+                                    "text": "$t:sirsoft-pay_nhnkcp.admin.pay_status_unknown"
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "Span",
+                                    "if": "{{kcp_escrow_delivery.data?.has_escrow_payment === true}}",
+                                    "props": { "className": "inline-flex items-center px-2 py-0.5 rounded-full text-xs font-semibold bg-purple-100 text-purple-800 dark:bg-purple-900/30 dark:text-purple-300" },
+                                    "text": "$t:sirsoft-pay_nhnkcp.admin.escrow_badge"
+                                }
+                            ]
+                        },
+                        {
+                            "type": "basic",
+                            "name": "Div",
+                            "props": { "className": "grid grid-cols-2 gap-x-4 gap-y-2 text-xs" },
+                            "children": [
+                                {
+                                    "type": "basic",
+                                    "name": "Span",
+                                    "props": { "className": "text-gray-500 dark:text-gray-400" },
+                                    "text": "$t:sirsoft-pay_nhnkcp.admin.result_payment_status"
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "Span",
+                                    "props": { "className": "text-gray-900 dark:text-gray-100" },
+                                    "text": "{{kcp_status.data?.payment_status_label ?? '-'}}"
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "Span",
+                                    "props": { "className": "text-gray-500 dark:text-gray-400" },
+                                    "text": "$t:sirsoft-pay_nhnkcp.admin.result_tno"
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "Span",
+                                    "props": { "className": "font-mono text-gray-900 dark:text-gray-100 break-all" },
+                                    "text": "{{kcp_status.data?.tno ?? '-'}}"
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "Span",
+                                    "props": { "className": "text-gray-500 dark:text-gray-400" },
+                                    "text": "$t:sirsoft-pay_nhnkcp.admin.result_app_no"
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "Span",
+                                    "props": { "className": "font-mono text-gray-900 dark:text-gray-100" },
+                                    "text": "{{kcp_status.data?.app_no ?? '-'}}"
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "Span",
+                                    "props": { "className": "text-gray-500 dark:text-gray-400" },
+                                    "text": "$t:sirsoft-pay_nhnkcp.admin.result_app_time"
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "Span",
+                                    "props": { "className": "font-mono text-gray-900 dark:text-gray-100" },
+                                    "text": "{{kcp_status.data?.app_time ?? '-'}}"
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "Span",
+                                    "props": { "className": "text-gray-500 dark:text-gray-400" },
+                                    "text": "$t:sirsoft-pay_nhnkcp.admin.result_pay_method"
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "Span",
+                                    "props": { "className": "text-gray-900 dark:text-gray-100" },
+                                    "text": "{{kcp_status.data?.card_name ?? kcp_status.data?.bank_name ?? kcp_status.data?.use_pay_method ?? '-'}}"
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "Span",
+                                    "props": { "className": "text-gray-500 dark:text-gray-400" },
+                                    "text": "$t:sirsoft-pay_nhnkcp.admin.result_res_cd"
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "Span",
+                                    "props": { "className": "font-mono text-gray-900 dark:text-gray-100" },
+                                    "text": "{{kcp_status.data?.res_cd ?? '-'}}"
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "Span",
+                                    "if": "{{(kcp_status.data?.cancelled_amount ?? 0) > 0}}",
+                                    "props": { "className": "text-gray-500 dark:text-gray-400" },
+                                    "text": "$t:sirsoft-pay_nhnkcp.admin.result_cancelled_amount"
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "Span",
+                                    "if": "{{(kcp_status.data?.cancelled_amount ?? 0) > 0}}",
+                                    "props": { "className": "font-mono text-gray-900 dark:text-gray-100" },
+                                    "text": "{{kcp_status.data?.cancelled_amount_formatted ?? '-'}}"
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "Span",
+                                    "if": "{{!!kcp_status.data?.cancelled_at}}",
+                                    "props": { "className": "text-gray-500 dark:text-gray-400" },
+                                    "text": "$t:sirsoft-pay_nhnkcp.admin.result_cancelled_at"
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "Span",
+                                    "if": "{{!!kcp_status.data?.cancelled_at}}",
+                                    "props": { "className": "font-mono text-gray-900 dark:text-gray-100" },
+                                    "text": "{{kcp_status.data?.cancelled_at ?? '-'}}"
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "Span",
+                                    "if": "{{!!kcp_status.data?.refund_status}}",
+                                    "props": { "className": "text-gray-500 dark:text-gray-400" },
+                                    "text": "$t:sirsoft-pay_nhnkcp.admin.result_refund_status"
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "Span",
+                                    "if": "{{!!kcp_status.data?.refund_status}}",
+                                    "props": { "className": "text-gray-900 dark:text-gray-100" },
+                                    "text": "{{kcp_status.data?.refund_status_label ?? kcp_status.data?.refund_status ?? '-'}}"
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "Span",
+                                    "if": "{{!!kcp_status.data?.refund_number}}",
+                                    "props": { "className": "text-gray-500 dark:text-gray-400" },
+                                    "text": "$t:sirsoft-pay_nhnkcp.admin.result_refund_number"
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "Span",
+                                    "if": "{{!!kcp_status.data?.refund_number}}",
+                                    "props": { "className": "font-mono text-gray-900 dark:text-gray-100 break-all" },
+                                    "text": "{{kcp_status.data?.refund_number ?? '-'}}"
+                                }
+                            ]
+                        }
+                    ]
+                },
+                {
+                    "id": "kcp_escrow_delivery_panel",
+                    "type": "basic",
+                    "name": "Div",
+                    "if": "{{kcp_escrow_delivery.data?.has_escrow_payment === true}}",
+                    "props": { "className": "admin-card mt-4" },
+                    "children": [
+                        {
+                            "type": "basic",
+                            "name": "Div",
+                            "props": { "className": "flex-center gap-2 mb-4" },
+                            "children": [
+                                {
+                                    "type": "basic",
+                                    "name": "Div",
+                                    "props": { "className": "w-1.5 h-4 bg-purple-500 rounded-full flex-shrink-0" }
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "H3",
+                                    "props": { "className": "text-sm font-semibold text-gray-800 dark:text-gray-200" },
+                                    "text": "$t:sirsoft-pay_nhnkcp.admin.escrow_delivery_title"
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "Span",
+                                    "props": { "className": "text-hint hidden sm:inline" },
+                                    "text": "$t:sirsoft-pay_nhnkcp.admin.escrow_delivery_description"
+                                }
+                            ]
+                        },
+                        {
+                            "type": "basic",
+                            "name": "Div",
+                            "if": "{{kcp_escrow_delivery.data?.registered_delivery}}",
+                            "props": { "className": "mb-4 p-3 rounded-lg bg-purple-50 dark:bg-purple-900/20 border border-purple-100 dark:border-purple-700/50" },
+                            "children": [
+                                {
+                                    "type": "basic",
+                                    "name": "Div",
+                                    "props": { "className": "flex-center gap-2 mb-2" },
+                                    "children": [
+                                        {
+                                            "type": "basic",
+                                            "name": "Icon",
+                                            "props": { "name": "truck", "className": "w-3.5 h-3.5 text-purple-600 dark:text-purple-400 flex-shrink-0" }
+                                        },
+                                        {
+                                            "type": "basic",
+                                            "name": "Span",
+                                            "props": { "className": "inline-flex items-center px-2 py-0.5 rounded-full text-xs font-semibold bg-purple-100 text-purple-800 dark:bg-purple-900/30 dark:text-purple-300" },
+                                            "text": "$t:sirsoft-pay_nhnkcp.admin.escrow_delivery_already_registered"
+                                        }
+                                    ]
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "Div",
+                                    "props": { "className": "grid grid-cols-2 gap-x-4 gap-y-1 text-xs" },
+                                    "children": [
+                                        {
+                                            "type": "basic",
+                                            "name": "Span",
+                                            "props": { "className": "text-gray-500 dark:text-gray-400" },
+                                            "text": "$t:sirsoft-pay_nhnkcp.admin.escrow_delivery_registered_at"
+                                        },
+                                        {
+                                            "type": "basic",
+                                            "name": "Span",
+                                            "props": { "className": "text-gray-900 dark:text-gray-100 font-mono" },
+                                            "text": "{{kcp_escrow_delivery.data.registered_delivery.registered_at ?? '-'}}"
+                                        },
+                                        {
+                                            "type": "basic",
+                                            "name": "Span",
+                                            "props": { "className": "text-gray-500 dark:text-gray-400" },
+                                            "text": "$t:sirsoft-pay_nhnkcp.admin.escrow_delivery_invoice_info"
+                                        },
+                                        {
+                                            "type": "basic",
+                                            "name": "Span",
+                                            "props": { "className": "text-gray-900 dark:text-gray-100 font-mono" },
+                                            "text": "{{kcp_escrow_delivery.data.registered_delivery.deli_numb ?? '-'}}"
+                                        },
+                                        {
+                                            "type": "basic",
+                                            "name": "Span",
+                                            "props": { "className": "text-gray-500 dark:text-gray-400" },
+                                            "text": "$t:sirsoft-pay_nhnkcp.admin.escrow_delivery_courier_info"
+                                        },
+                                        {
+                                            "type": "basic",
+                                            "name": "Span",
+                                            "props": { "className": "text-gray-900 dark:text-gray-100" },
+                                            "text": "{{kcp_escrow_delivery.data.registered_delivery.courier_name ?? '-'}}"
+                                        }
+                                    ]
+                                }
+                            ]
+                        },
+                        {
+                            "type": "basic",
+                            "name": "Div",
+                            "props": { "className": "space-y-2" },
+                            "children": [
+                                {
+                                    "type": "basic",
+                                    "name": "Div",
+                                    "props": { "className": "flex-center gap-2" },
+                                    "children": [
+                                        {
+                                            "type": "basic",
+                                            "name": "Label",
+                                            "props": { "className": "text-tertiary w-20 flex-shrink-0" },
+                                            "text": "$t:sirsoft-pay_nhnkcp.admin.escrow_delivery_invoice_label"
+                                        },
+                                        {
+                                            "type": "basic",
+                                            "name": "Input",
+                                            "props": {
+                                                "type": "text",
+                                                "placeholder": "$t:sirsoft-pay_nhnkcp.admin.escrow_delivery_invoice_placeholder",
+                                                "className": "flex-1 text-xs px-2 py-1.5 border border-gray-300 dark:border-gray-600 rounded bg-white dark:bg-gray-700 text-gray-900 dark:text-gray-100 font-mono"
+                                            },
+                                            "actions": [
+                                                {
+                                                    "type": "change",
+                                                    "handler": "setState",
+                                                    "params": { "target": "local", "_ked_deli_numb": "{{$event.target.value}}" }
+                                                }
+                                            ]
+                                        }
+                                    ]
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "Div",
+                                    "props": { "className": "flex-center gap-2" },
+                                    "children": [
+                                        {
+                                            "type": "basic",
+                                            "name": "Label",
+                                            "props": { "className": "text-tertiary w-20 flex-shrink-0" },
+                                            "text": "$t:sirsoft-pay_nhnkcp.admin.escrow_delivery_courier_label"
+                                        },
+                                        {
+                                            "type": "basic",
+                                            "name": "Select",
+                                            "props": {
+                                                "className": "flex-1 text-xs px-2 py-1.5 border border-gray-300 dark:border-gray-600 rounded bg-white dark:bg-gray-700 text-gray-900 dark:text-gray-100"
+                                            },
+                                            "actions": [
+                                                {
+                                                    "type": "change",
+                                                    "handler": "setState",
+                                                    "params": { "target": "local", "_ked_deli_corp": "{{$event.target.value}}" }
+                                                }
+                                            ],
+                                            "children": [
+                                                { "type": "basic", "name": "Option", "props": { "value": "" }, "text": "$t:sirsoft-pay_nhnkcp.admin.escrow_delivery_courier_placeholder" },
+                                                { "type": "basic", "name": "Option", "props": { "value": "04" }, "text": "CJ대한통운" },
+                                                { "type": "basic", "name": "Option", "props": { "value": "05" }, "text": "한진택배" },
+                                                { "type": "basic", "name": "Option", "props": { "value": "06" }, "text": "로젠택배" },
+                                                { "type": "basic", "name": "Option", "props": { "value": "08" }, "text": "롯데택배" },
+                                                { "type": "basic", "name": "Option", "props": { "value": "09" }, "text": "우체국택배" },
+                                                { "type": "basic", "name": "Option", "props": { "value": "11" }, "text": "경동택배" },
+                                                { "type": "basic", "name": "Option", "props": { "value": "13" }, "text": "일양로지스" },
+                                                { "type": "basic", "name": "Option", "props": { "value": "14" }, "text": "합동택배" },
+                                                { "type": "basic", "name": "Option", "props": { "value": "20" }, "text": "드림택배" },
+                                                { "type": "basic", "name": "Option", "props": { "value": "23" }, "text": "천일택배" },
+                                                { "type": "basic", "name": "Option", "props": { "value": "26" }, "text": "건영택배" },
+                                                { "type": "basic", "name": "Option", "props": { "value": "40" }, "text": "기타" }
+                                            ]
+                                        }
+                                    ]
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "Div",
+                                    "props": { "className": "flex justify-end" },
+                                    "children": [
+                                        {
+                                            "type": "basic",
+                                            "name": "Button",
+                                            "props": {
+                                                "disabled": "{{_local._ked_registering}}",
+                                                "className": "flex-center gap-1.5 px-3 py-1.5 text-xs font-medium bg-purple-600 hover:bg-purple-700 text-white rounded-md transition-colors disabled:opacity-50 disabled:cursor-not-allowed"
+                                            },
+                                            "actions": [
+                                                {
+                                                    "type": "click",
+                                                    "handler": "sequence",
+                                                    "actions": [
+                                                        {
+                                                            "handler": "setState",
+                                                            "params": { "target": "local", "_ked_registering": true, "_ked_error": null }
+                                                        },
+                                                        {
+                                                            "handler": "apiCall",
+                                                            "auth_required": true,
+                                                            "target": "/api/plugins/sirsoft-pay_nhnkcp/admin/orders/{{route.orderNumber}}/escrow-delivery",
+                                                            "params": {
+                                                                "method": "POST",
+                                                                "body": {
+                                                                    "deli_numb": "{{_local._ked_deli_numb ?? ''}}",
+                                                                    "deli_corp": "{{_local._ked_deli_corp ?? ''}}"
+                                                                }
+                                                            },
+                                                            "onSuccess": [
+                                                                {
+                                                                    "handler": "setState",
+                                                                    "params": { "target": "local", "_ked_registering": false }
+                                                                },
+                                                                {
+                                                                    "handler": "toast",
+                                                                    "params": { "type": "success", "message": "$t:sirsoft-pay_nhnkcp.admin.escrow_delivery_success" }
+                                                                },
+                                                                {
+                                                                    "handler": "refetchDataSource",
+                                                                    "params": { "dataSourceId": "kcp_escrow_delivery" }
+                                                                }
+                                                            ],
+                                                            "onError": [
+                                                                {
+                                                                    "handler": "setState",
+                                                                    "params": {
+                                                                        "target": "local",
+                                                                        "_ked_registering": false,
+                                                                        "_ked_error": "{{response?.errors?.deli_numb?.[0] ?? response?.errors?.deli_corp?.[0] ?? response?.errors?.message?.[0] ?? '$t:sirsoft-pay_nhnkcp.admin.escrow_delivery_error'}}"
+                                                                    }
+                                                                }
+                                                            ]
+                                                        }
+                                                    ]
+                                                }
+                                            ],
+                                            "children": [
+                                                {
+                                                    "type": "basic",
+                                                    "name": "Icon",
+                                                    "if": "{{_local._ked_registering}}",
+                                                    "props": { "name": "spinner", "className": "w-3 h-3 animate-spin" }
+                                                },
+                                                {
+                                                    "type": "basic",
+                                                    "name": "Span",
+                                                    "if": "{{_local._ked_registering}}",
+                                                    "text": "$t:sirsoft-pay_nhnkcp.admin.escrow_delivery_registering"
+                                                },
+                                                {
+                                                    "type": "basic",
+                                                    "name": "Span",
+                                                    "if": "{{!_local._ked_registering && !kcp_escrow_delivery.data?.registered_delivery}}",
+                                                    "text": "$t:sirsoft-pay_nhnkcp.admin.escrow_delivery_register_button"
+                                                },
+                                                {
+                                                    "type": "basic",
+                                                    "name": "Span",
+                                                    "if": "{{!_local._ked_registering && kcp_escrow_delivery.data?.registered_delivery}}",
+                                                    "text": "$t:sirsoft-pay_nhnkcp.admin.escrow_delivery_change_button"
+                                                }
+                                            ]
+                                        }
+                                    ]
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "Div",
+                                    "if": "{{_local._ked_error}}",
+                                    "props": { "className": "text-xs text-red-600 dark:text-red-400 bg-red-50 dark:bg-red-900/20 rounded px-2 py-1.5" },
+                                    "text": "{{_local._ked_error}}"
+                                }
+                            ]
+                        }
+                    ]
+                }
+            ]
+        }
+    ]
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/resources/extensions/checkout_easy_pay.json b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/extensions/checkout_easy_pay.json
new file mode 100644
index 00000000..24806443
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/extensions/checkout_easy_pay.json
@@ -0,0 +1,97 @@
+{
+    "target_layout": "shop/checkout",
+    "data_sources": [
+        {
+            "id": "nhnkcp_easy_pay_config",
+            "label_key": "$t:sirsoft-pay_nhnkcp.editor.data_source.nhnkcp_easy_pay_config",
+            "type": "api",
+            "endpoint": "/api/modules/sirsoft-ecommerce/payments/client-config/nhnkcp",
+            "method": "GET",
+            "auto_fetch": true
+        }
+    ],
+    "modals": [
+        {
+            "id": "nhnkcp_payment_error_modal",
+            "type": "composite",
+            "name": "Modal",
+            "props": {
+                "title": "$t:sirsoft-pay_nhnkcp.payment_error.title",
+                "size": "sm",
+                "showCloseButton": true
+            },
+            "children": [
+                {
+                    "type": "basic",
+                    "name": "Div",
+                    "props": {
+                        "className": "text-center py-4"
+                    },
+                    "children": [
+                        {
+                            "type": "basic",
+                            "name": "Icon",
+                            "props": {
+                                "name": "exclamation-circle",
+                                "className": "text-red-500 text-4xl mb-4"
+                            }
+                        },
+                        {
+                            "type": "basic",
+                            "name": "P",
+                            "props": {
+                                "className": "text-gray-700 dark:text-gray-300"
+                            },
+                            "text": "$t:sirsoft-pay_nhnkcp.payment_error.message"
+                        },
+                        {
+                            "type": "basic",
+                            "name": "P",
+                            "if": "{{_local.paymentErrorMessage}}",
+                            "props": {
+                                "className": "text-sm text-red-600 dark:text-red-400 mt-2"
+                            },
+                            "text": "{{_local.paymentErrorMessage}}"
+                        }
+                    ]
+                },
+                {
+                    "type": "basic",
+                    "name": "Div",
+                    "props": {
+                        "className": "flex justify-center mt-6"
+                    },
+                    "children": [
+                        {
+                            "type": "basic",
+                            "name": "Button",
+                            "props": {
+                                "type": "button",
+                                "className": "px-6 py-2 bg-blue-600 text-white rounded-lg font-medium hover:bg-blue-700 transition-colors"
+                            },
+                            "text": "$t:common.confirm",
+                            "actions": [
+                                {
+                                    "type": "click",
+                                    "handler": "sequence",
+                                    "actions": [
+                                        {
+                                            "handler": "setState",
+                                            "params": {
+                                                "target": "local",
+                                                "paymentErrorMessage": null
+                                            }
+                                        },
+                                        {
+                                            "handler": "closeModal"
+                                        }
+                                    ]
+                                }
+                            ]
+                        }
+                    ]
+                }
+            ]
+        }
+    ]
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/resources/extensions/user_order_complete_receipt.json b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/extensions/user_order_complete_receipt.json
new file mode 100644
index 00000000..7dbbade6
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/extensions/user_order_complete_receipt.json
@@ -0,0 +1,313 @@
+{
+  "target_layout": "shop/order_complete",
+  "injections": [
+    {
+      "target_id": "order_complete_payment_summary",
+      "position": "append_child",
+      "components": [
+        {
+          "type": "basic",
+          "name": "Div",
+          "if": "{{orderData?.data?.payment?.pg_provider === 'nhnkcp' && orderData?.data?.payment?.vbank_name}}",
+          "props": {
+            "className": "pt-4 mt-2 border-t border-gray-200 dark:border-gray-700 space-y-3"
+          },
+          "children": [
+            {
+              "type": "basic",
+              "name": "P",
+              "props": {
+                "className": "text-sm font-semibold text-gray-800 dark:text-gray-200"
+              },
+              "text": "$t:sirsoft-pay_nhnkcp.user.vbank_title"
+            },
+            {
+              "type": "basic",
+              "name": "Div",
+              "props": {
+                "className": "space-y-1.5"
+              },
+              "children": [
+                {
+                  "type": "basic",
+                  "name": "Div",
+                  "props": {
+                    "className": "flex-between text-sm"
+                  },
+                  "children": [
+                    {
+                      "type": "basic",
+                      "name": "Span",
+                      "props": {
+                        "className": "text-gray-500 dark:text-gray-400"
+                      },
+                      "text": "$t:sirsoft-pay_nhnkcp.user.vbank_bank_name"
+                    },
+                    {
+                      "type": "basic",
+                      "name": "Span",
+                      "props": {
+                        "className": "text-primary font-medium"
+                      },
+                      "text": "{{orderData?.data?.payment?.vbank_name}}"
+                    }
+                  ]
+                },
+                {
+                  "type": "basic",
+                  "name": "Div",
+                  "props": {
+                    "className": "flex-between text-sm"
+                  },
+                  "children": [
+                    {
+                      "type": "basic",
+                      "name": "Span",
+                      "props": {
+                        "className": "text-gray-500 dark:text-gray-400"
+                      },
+                      "text": "$t:sirsoft-pay_nhnkcp.user.vbank_account"
+                    },
+                    {
+                      "type": "basic",
+                      "name": "Span",
+                      "props": {
+                        "className": "text-primary font-medium font-mono tracking-wide"
+                      },
+                      "text": "{{orderData?.data?.payment?.vbank_number}}"
+                    }
+                  ]
+                },
+                {
+                  "type": "basic",
+                  "name": "Div",
+                  "props": {
+                    "className": "flex-between text-sm"
+                  },
+                  "children": [
+                    {
+                      "type": "basic",
+                      "name": "Span",
+                      "props": {
+                        "className": "text-gray-500 dark:text-gray-400"
+                      },
+                      "text": "$t:sirsoft-pay_nhnkcp.user.vbank_holder"
+                    },
+                    {
+                      "type": "basic",
+                      "name": "Span",
+                      "props": {
+                        "className": "text-primary font-medium"
+                      },
+                      "text": "{{orderData?.data?.payment?.vbank_holder}}"
+                    }
+                  ]
+                },
+                {
+                  "type": "basic",
+                  "name": "Div",
+                  "props": {
+                    "className": "flex-between text-sm"
+                  },
+                  "children": [
+                    {
+                      "type": "basic",
+                      "name": "Span",
+                      "props": {
+                        "className": "text-gray-500 dark:text-gray-400"
+                      },
+                      "text": "$t:sirsoft-pay_nhnkcp.user.vbank_due"
+                    },
+                    {
+                      "type": "basic",
+                      "name": "Span",
+                      "props": {
+                        "className": "text-primary font-medium"
+                      },
+                      "text": "{{orderData?.data?.payment?.due_date_formatted}}"
+                    }
+                  ]
+                }
+              ]
+            },
+            {
+              "type": "basic",
+              "name": "P",
+              "props": {
+                "className": "text-xs text-amber-600 dark:text-amber-400"
+              },
+              "text": "$t:sirsoft-pay_nhnkcp.user.vbank_notice"
+            }
+          ]
+        },
+        {
+          "type": "basic",
+          "name": "Div",
+          "if": "{{orderData?.data?.payment?.pg_provider === 'nhnkcp' && orderData?.data?.payment?.transaction_id && !orderData?.data?.payment?.vbank_name}}",
+          "props": {
+            "className": "pt-4 mt-2 border-t border-gray-200 dark:border-gray-700"
+          },
+          "children": [
+            {
+              "type": "basic",
+              "name": "Div",
+              "props": {
+                "className": "flex-between"
+              },
+              "children": [
+                {
+                  "type": "basic",
+                  "name": "Span",
+                  "props": {
+                    "className": "text-secondary text-sm"
+                  },
+                  "text": "$t:sirsoft-pay_nhnkcp.user.receipt_label"
+                },
+                {
+                  "type": "basic",
+                  "name": "Div",
+                  "props": {
+                    "className": "flex-center gap-3"
+                  },
+                  "children": [
+                    {
+                      "type": "basic",
+                      "name": "Button",
+                      "if": "{{!_local._kcpOcReceiptLoaded}}",
+                      "props": {
+                        "type": "button",
+                        "className": "inline-flex items-center gap-1 text-sm text-blue-600 dark:text-blue-400 hover:underline disabled:opacity-50",
+                        "disabled": "{{_local._kcpOcReceiptLoading === true}}"
+                      },
+                      "actions": [
+                        {
+                          "type": "click",
+                          "handler": "sequence",
+                          "actions": [
+                            {
+                              "handler": "setState",
+                              "params": {
+                                "target": "local",
+                                "_kcpOcReceiptLoading": true
+                              }
+                            },
+                            {
+                              "handler": "apiCall",
+                              "auth_required": true,
+                              "target": "/api/plugins/sirsoft-pay_nhnkcp/user/orders/{{route.id}}/receipt",
+                              "params": {
+                                "method": "GET"
+                              },
+                              "onSuccess": [
+                                {
+                                  "handler": "setState",
+                                  "params": {
+                                    "target": "local",
+                                    "_kcpOcReceiptLoading": false,
+                                    "_kcpOcReceiptLoaded": true,
+                                    "_kcpOcReceiptUrl": "{{$response.receipt_url}}",
+                                    "_kcpOcCashReceiptUrl": "{{$response.cash_receipt_url}}"
+                                  }
+                                }
+                              ],
+                              "onError": [
+                                {
+                                  "handler": "setState",
+                                  "params": {
+                                    "target": "local",
+                                    "_kcpOcReceiptLoading": false
+                                  }
+                                }
+                              ]
+                            }
+                          ]
+                        }
+                      ],
+                      "children": [
+                        {
+                          "type": "basic",
+                          "name": "Icon",
+                          "if": "{{_local._kcpOcReceiptLoading === true}}",
+                          "props": {
+                            "name": "spinner",
+                            "className": "w-3.5 h-3.5 animate-spin"
+                          }
+                        },
+                        {
+                          "type": "basic",
+                          "name": "Icon",
+                          "if": "{{!_local._kcpOcReceiptLoading}}",
+                          "props": {
+                            "name": "file-text",
+                            "className": "w-3.5 h-3.5"
+                          }
+                        },
+                        {
+                          "type": "basic",
+                          "name": "Span",
+                          "text": "$t:sirsoft-pay_nhnkcp.user.receipt_view"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "basic",
+                      "name": "A",
+                      "if": "{{_local._kcpOcReceiptLoaded && _local._kcpOcReceiptUrl}}",
+                      "props": {
+                        "href": "{{_local._kcpOcReceiptUrl}}",
+                        "target": "_blank",
+                        "rel": "noopener noreferrer",
+                        "className": "inline-flex items-center gap-1 text-sm text-blue-600 dark:text-blue-400 hover:underline"
+                      },
+                      "children": [
+                        {
+                          "type": "basic",
+                          "name": "Icon",
+                          "props": {
+                            "name": "file-text",
+                            "className": "w-3.5 h-3.5"
+                          }
+                        },
+                        {
+                          "type": "basic",
+                          "name": "Span",
+                          "text": "$t:sirsoft-pay_nhnkcp.user.receipt_view"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "basic",
+                      "name": "A",
+                      "if": "{{_local._kcpOcReceiptLoaded && _local._kcpOcCashReceiptUrl}}",
+                      "props": {
+                        "href": "{{_local._kcpOcCashReceiptUrl}}",
+                        "target": "_blank",
+                        "rel": "noopener noreferrer",
+                        "className": "inline-flex items-center gap-1 text-sm text-green-600 dark:text-green-400 hover:underline"
+                      },
+                      "children": [
+                        {
+                          "type": "basic",
+                          "name": "Icon",
+                          "props": {
+                            "name": "receipt",
+                            "className": "w-3.5 h-3.5"
+                          }
+                        },
+                        {
+                          "type": "basic",
+                          "name": "Span",
+                          "text": "$t:sirsoft-pay_nhnkcp.user.cash_receipt_view"
+                        }
+                      ]
+                    }
+                  ]
+                }
+              ]
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/resources/extensions/user_order_show.json b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/extensions/user_order_show.json
new file mode 100644
index 00000000..b0191e5e
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/extensions/user_order_show.json
@@ -0,0 +1,374 @@
+{
+  "target_layout": "mypage/orders/show",
+  "injections": [
+    {
+      "target_id": "order_payment_info_panel",
+      "position": "append_child",
+      "components": [
+        {
+          "type": "basic",
+          "name": "Div",
+          "if": "{{order.data.payment?.pg_provider === 'nhnkcp' && order.data.payment?.is_escrow}}",
+          "props": {
+            "className": "pt-2 mt-1"
+          },
+          "children": [
+            {
+              "type": "basic",
+              "name": "Span",
+              "props": {
+                "className": "inline-flex items-center gap-1 px-2 py-0.5 rounded-full text-xs font-semibold bg-purple-100 text-purple-800 dark:bg-purple-900/30 dark:text-purple-300"
+              },
+              "children": [
+                {
+                  "type": "basic",
+                  "name": "Icon",
+                  "props": {
+                    "name": "shield-check",
+                    "className": "w-3 h-3"
+                  }
+                },
+                {
+                  "type": "basic",
+                  "name": "Span",
+                  "text": "$t:sirsoft-pay_nhnkcp.user.escrow_badge"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "type": "basic",
+          "name": "Div",
+          "if": "{{order.data.payment?.pg_provider === 'nhnkcp' && order.data.payment?.vbank_name}}",
+          "props": {
+            "className": "pt-4 mt-2 border-t border-gray-200 dark:border-gray-700 space-y-3"
+          },
+          "children": [
+            {
+              "type": "basic",
+              "name": "P",
+              "props": {
+                "className": "text-sm font-semibold text-gray-800 dark:text-gray-200"
+              },
+              "text": "$t:sirsoft-pay_nhnkcp.user.vbank_title"
+            },
+            {
+              "type": "basic",
+              "name": "Div",
+              "props": {
+                "className": "space-y-1.5"
+              },
+              "children": [
+                {
+                  "type": "basic",
+                  "name": "Div",
+                  "props": {
+                    "className": "flex-between text-sm"
+                  },
+                  "children": [
+                    {
+                      "type": "basic",
+                      "name": "Span",
+                      "props": {
+                        "className": "text-gray-500 dark:text-gray-400"
+                      },
+                      "text": "$t:sirsoft-pay_nhnkcp.user.vbank_bank_name"
+                    },
+                    {
+                      "type": "basic",
+                      "name": "Span",
+                      "props": {
+                        "className": "text-primary font-medium"
+                      },
+                      "text": "{{order.data.payment?.vbank_name}}"
+                    }
+                  ]
+                },
+                {
+                  "type": "basic",
+                  "name": "Div",
+                  "props": {
+                    "className": "flex-between text-sm"
+                  },
+                  "children": [
+                    {
+                      "type": "basic",
+                      "name": "Span",
+                      "props": {
+                        "className": "text-gray-500 dark:text-gray-400"
+                      },
+                      "text": "$t:sirsoft-pay_nhnkcp.user.vbank_account"
+                    },
+                    {
+                      "type": "basic",
+                      "name": "Span",
+                      "props": {
+                        "className": "text-primary font-medium font-mono tracking-wide"
+                      },
+                      "text": "{{order.data.payment?.vbank_number}}"
+                    }
+                  ]
+                },
+                {
+                  "type": "basic",
+                  "name": "Div",
+                  "props": {
+                    "className": "flex-between text-sm"
+                  },
+                  "children": [
+                    {
+                      "type": "basic",
+                      "name": "Span",
+                      "props": {
+                        "className": "text-gray-500 dark:text-gray-400"
+                      },
+                      "text": "$t:sirsoft-pay_nhnkcp.user.vbank_holder"
+                    },
+                    {
+                      "type": "basic",
+                      "name": "Span",
+                      "props": {
+                        "className": "text-primary font-medium"
+                      },
+                      "text": "{{order.data.payment?.vbank_holder}}"
+                    }
+                  ]
+                },
+                {
+                  "type": "basic",
+                  "name": "Div",
+                  "props": {
+                    "className": "flex-between text-sm"
+                  },
+                  "children": [
+                    {
+                      "type": "basic",
+                      "name": "Span",
+                      "props": {
+                        "className": "text-gray-500 dark:text-gray-400"
+                      },
+                      "text": "$t:sirsoft-pay_nhnkcp.user.vbank_due"
+                    },
+                    {
+                      "type": "basic",
+                      "name": "Span",
+                      "props": {
+                        "className": "text-primary font-medium"
+                      },
+                      "text": "{{order.data.payment?.due_date_formatted}}"
+                    }
+                  ]
+                }
+              ]
+            },
+            {
+              "type": "basic",
+              "name": "P",
+              "props": {
+                "className": "text-xs text-amber-600 dark:text-amber-400"
+              },
+              "text": "$t:sirsoft-pay_nhnkcp.user.vbank_notice"
+            }
+          ]
+        },
+        {
+          "type": "basic",
+          "name": "Div",
+          "if": "{{order.data.payment?.pg_provider === 'nhnkcp' && (order.data.total_vat_amount > 0 || order.data.total_tax_free_amount > 0)}}",
+          "props": {
+            "className": "pt-4 mt-2 border-t border-gray-200 dark:border-gray-700 space-y-1.5"
+          },
+          "children": [
+            {
+              "type": "basic",
+              "name": "P",
+              "props": {
+                "className": "text-sm font-semibold text-gray-800 dark:text-gray-200 mb-1"
+              },
+              "text": "$t:sirsoft-pay_nhnkcp.user.tax_breakdown_title"
+            },
+            {
+              "type": "basic",
+              "name": "Div",
+              "props": {
+                "className": "flex-between text-sm"
+              },
+              "children": [
+                {
+                  "type": "basic",
+                  "name": "Span",
+                  "props": {
+                    "className": "text-gray-500 dark:text-gray-400"
+                  },
+                  "text": "$t:sirsoft-pay_nhnkcp.user.supply_amount"
+                },
+                {
+                  "type": "basic",
+                  "name": "Span",
+                  "props": {
+                    "className": "text-primary font-medium"
+                  },
+                  "text": "{{order.data.total_taxable_supply_amount_formatted}}"
+                }
+              ]
+            },
+            {
+              "type": "basic",
+              "name": "Div",
+              "props": {
+                "className": "flex-between text-sm"
+              },
+              "children": [
+                {
+                  "type": "basic",
+                  "name": "Span",
+                  "props": {
+                    "className": "text-gray-500 dark:text-gray-400"
+                  },
+                  "text": "$t:sirsoft-pay_nhnkcp.user.vat_amount"
+                },
+                {
+                  "type": "basic",
+                  "name": "Span",
+                  "props": {
+                    "className": "text-primary font-medium"
+                  },
+                  "text": "{{order.data.total_vat_amount_formatted}}"
+                }
+              ]
+            },
+            {
+              "type": "basic",
+              "name": "Div",
+              "if": "{{order.data.total_tax_free_amount > 0}}",
+              "props": {
+                "className": "flex-between text-sm"
+              },
+              "children": [
+                {
+                  "type": "basic",
+                  "name": "Span",
+                  "props": {
+                    "className": "text-gray-500 dark:text-gray-400"
+                  },
+                  "text": "$t:sirsoft-pay_nhnkcp.user.tax_free_amount"
+                },
+                {
+                  "type": "basic",
+                  "name": "Span",
+                  "props": {
+                    "className": "text-primary font-medium"
+                  },
+                  "text": "{{order.data.total_tax_free_amount_formatted}}"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "type": "basic",
+          "name": "Div",
+          "if": "{{order.data.payment?.pg_provider === 'nhnkcp' && order.data.payment?.transaction_id && order.data.payment?.paid_at}}",
+          "props": {
+            "id": "kcp-mp-receipt-row",
+            "className": "pt-4 mt-2 border-t border-gray-200 dark:border-gray-700"
+          },
+          "children": [
+            {
+              "type": "basic",
+              "name": "Div",
+              "props": {
+                "className": "flex-between"
+              },
+              "children": [
+                {
+                  "type": "basic",
+                  "name": "Span",
+                  "props": {
+                    "className": "text-label-subtle"
+                  },
+                  "text": "$t:sirsoft-pay_nhnkcp.user.receipt_label"
+                },
+                {
+                  "type": "basic",
+                  "name": "Button",
+                  "props": {
+                    "type": "button",
+                    "className": "inline-flex items-center gap-1 text-sm text-blue-600 dark:text-blue-400 hover:underline disabled:opacity-50",
+                    "disabled": "{{_local._kcpReceiptLoading === true}}"
+                  },
+                  "actions": [
+                    {
+                      "type": "click",
+                      "handler": "sequence",
+                      "actions": [
+                        {
+                          "handler": "setState",
+                          "params": {
+                            "target": "local",
+                            "_kcpReceiptLoading": true
+                          }
+                        },
+                        {
+                          "handler": "apiCall",
+                          "auth_required": true,
+                          "target": "/api/plugins/sirsoft-pay_nhnkcp/user/orders/{{route.order_number}}/receipt",
+                          "params": {
+                            "method": "GET"
+                          }
+                        },
+                        {
+                          "handler": "callExternal",
+                          "params": {
+                            "constructor": "KcpReceiptPopup",
+                            "args": {
+                              "url": "{{$prev.receipt_url}}",
+                              "cash_url": "{{$prev.cash_receipt_url}}"
+                            }
+                          }
+                        },
+                        {
+                          "handler": "setState",
+                          "params": {
+                            "target": "local",
+                            "_kcpReceiptLoading": false
+                          }
+                        }
+                      ]
+                    }
+                  ],
+                  "children": [
+                    {
+                      "type": "basic",
+                      "name": "Icon",
+                      "if": "{{_local._kcpReceiptLoading === true}}",
+                      "props": {
+                        "name": "spinner",
+                        "className": "w-3.5 h-3.5 animate-spin"
+                      }
+                    },
+                    {
+                      "type": "basic",
+                      "name": "Icon",
+                      "if": "{{!_local._kcpReceiptLoading}}",
+                      "props": {
+                        "name": "file-text",
+                        "className": "w-3.5 h-3.5"
+                      }
+                    },
+                    {
+                      "type": "basic",
+                      "name": "Span",
+                      "text": "$t:sirsoft-pay_nhnkcp.user.receipt_view"
+                    }
+                  ]
+                }
+              ]
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/__tests__/adminApplePayNoticeInjector.test.ts b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/__tests__/adminApplePayNoticeInjector.test.ts
new file mode 100644
index 00000000..89a16d69
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/__tests__/adminApplePayNoticeInjector.test.ts
@@ -0,0 +1,38 @@
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import {
+    patchAdminApplePayNotice,
+    resetAdminApplePayNoticeInjectorForTests,
+} from '../adminApplePayNoticeInjector';
+
+describe('adminApplePayNoticeInjector', () => {
+    beforeEach(() => {
+        document.documentElement.lang = 'ko';
+        window.history.pushState({}, '', '/admin/ecommerce/settings?tab=order_settings');
+        document.body.innerHTML = `
+            <section>
+                <div>
+                    <span>애플페이</span>
+                </div>
+            </section>
+        `;
+    });
+
+    afterEach(() => {
+        resetAdminApplePayNoticeInjectorForTests();
+        document.body.innerHTML = '';
+    });
+
+    it('관리자 주문설정의 애플페이 항목에 iOS 모바일 결제 안내를 추가한다', () => {
+        expect(patchAdminApplePayNotice()).toBe(true);
+
+        expect(document.body.textContent).toContain('애플페이는 IOS 기기에 모바일결제만 가능합니다.');
+        expect(document.querySelectorAll('[data-nhnkcp-admin-apple-pay-notice="true"]')).toHaveLength(1);
+    });
+
+    it('주문설정 화면이 아니면 안내를 추가하지 않는다', () => {
+        window.history.pushState({}, '', '/admin/ecommerce/settings?tab=shipping');
+
+        expect(patchAdminApplePayNotice()).toBe(false);
+        expect(document.body.textContent).not.toContain('애플페이는 IOS 기기에 모바일결제만 가능합니다.');
+    });
+});
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/__tests__/adminPaymentMethodBrandInjector.test.ts b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/__tests__/adminPaymentMethodBrandInjector.test.ts
new file mode 100644
index 00000000..b16f51d0
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/__tests__/adminPaymentMethodBrandInjector.test.ts
@@ -0,0 +1,87 @@
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import {
+    resetAdminPaymentMethodBrandInjectorForTests,
+    syncRenderedAdminPaymentMethodBrands,
+} from '../adminPaymentMethodBrandInjector';
+
+function desktopItem(testId: string, title: string, description: string): string {
+    return `
+        <div class="flex-center border rounded-lg p-3 gap-4" data-test-item="${testId}">
+            <div data-drag-handle="true"><svg data-drag-icon="true"></svg></div>
+            <svg data-original-icon="true"></svg>
+            <div class="flex-1 min-w-0">
+                <div class="flex-center gap-2">
+                    <span class="font-medium text-gray-900 dark:text-gray-100">${title}</span>
+                </div>
+                <span class="text-label-subtle">${description}</span>
+            </div>
+            <div class="row-stack">
+                <span>PG사</span>
+                <select></select>
+            </div>
+        </div>
+    `;
+}
+
+function mobileItem(testId: string, title: string): string {
+    return `
+        <div class="excel-card" data-test-item="${testId}">
+            <div class="excel-card-header">
+                <div class="flex-center gap-3 flex-1 min-w-0">
+                    <div data-drag-handle="true"><svg data-drag-icon="true"></svg></div>
+                    <svg data-original-icon="true"></svg>
+                    <span class="font-medium text-gray-900 dark:text-gray-100 truncate">${title}</span>
+                </div>
+            </div>
+            <div class="excel-card-body">
+                <div class="row-stack"><label>PG사</label><select></select></div>
+            </div>
+        </div>
+    `;
+}
+
+describe('adminPaymentMethodBrandInjector', () => {
+    beforeEach(() => {
+        document.documentElement.lang = 'ko';
+        window.history.pushState({}, '', '/admin/ecommerce/settings?tab=order_settings');
+        document.body.innerHTML = `
+            ${desktopItem('payco', 'PAYCO', 'PAYCO로 결제 (NHN KCP)')}
+            ${mobileItem('kakaopay', '카카오페이')}
+            ${desktopItem('nice-payco', 'PAYCO (나이스페이먼츠)', 'PAYCO로 결제 (나이스페이먼츠)')}
+            ${desktopItem('card', '신용카드', '신용카드로 결제')}
+        `;
+    });
+
+    afterEach(() => {
+        resetAdminPaymentMethodBrandInjectorForTests();
+        document.body.innerHTML = '';
+    });
+
+    it('NHN KCP 간편결제 행의 기본 아이콘을 브랜드 텍스트 배지로 바꾼다', () => {
+        expect(syncRenderedAdminPaymentMethodBrands()).toBe(true);
+
+        const payco = document.querySelector<HTMLElement>('[data-test-item="payco"]');
+        const kakaoPay = document.querySelector<HTMLElement>('[data-test-item="kakaopay"]');
+        const nicePayco = document.querySelector<HTMLElement>('[data-test-item="nice-payco"]');
+        const card = document.querySelector<HTMLElement>('[data-test-item="card"]');
+
+        expect(payco?.dataset.nhnkcpAdminPaymentMethod).toBe('nhnkcp_payco');
+        expect(payco?.querySelector('[data-nhnkcp-admin-payment-brand-mark="true"]')?.textContent).toBe('P');
+        expect(payco?.querySelector('[data-original-icon="true"]')).toBeNull();
+        expect(payco?.querySelector('[data-drag-icon="true"]')).not.toBeNull();
+
+        expect(kakaoPay?.dataset.nhnkcpAdminPaymentMethod).toBe('nhnkcp_kakaopay');
+        expect(kakaoPay?.querySelector('[data-nhnkcp-admin-payment-brand-mark="true"]')?.textContent).toBe('K');
+
+        expect(nicePayco?.dataset.nhnkcpAdminPaymentMethod).toBeUndefined();
+        expect(nicePayco?.querySelector('[data-original-icon="true"]')).not.toBeNull();
+        expect(card?.querySelector('[data-original-icon="true"]')).not.toBeNull();
+    });
+
+    it('주문설정 화면이 아니면 관리자 결제수단 아이콘을 바꾸지 않는다', () => {
+        window.history.pushState({}, '', '/admin/ecommerce/settings?tab=shipping');
+
+        expect(syncRenderedAdminPaymentMethodBrands()).toBe(false);
+        expect(document.querySelector('[data-nhnkcp-admin-payment-brand-mark="true"]')).toBeNull();
+    });
+});
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/__tests__/checkoutEasyPayInjector.test.ts b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/__tests__/checkoutEasyPayInjector.test.ts
new file mode 100644
index 00000000..127ca8b8
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/__tests__/checkoutEasyPayInjector.test.ts
@@ -0,0 +1,226 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import {
+    resetCheckoutEasyPayInjectorForTests,
+    syncRenderedCheckoutEasyPayMethods,
+} from '../checkoutEasyPayInjector';
+
+function paymentButton(label: string, description: string): string {
+    return `
+        <button type="button">
+            <div class="flex items-center gap-3">
+                <i class="fas fa-wallet" role="img"></i>
+                <div>
+                    <p>${label}</p>
+                    <p>${description}</p>
+                </div>
+            </div>
+        </button>
+    `;
+}
+
+function renderPaymentButtons(): void {
+    document.body.innerHTML = `
+        ${paymentButton('Naver Pay (KG Inicis)', 'Pay with Naver Pay')}
+        ${paymentButton('Kakao Pay (KG Inicis)', 'Pay with Kakao Pay')}
+        ${paymentButton('PAYCO (NHN KCP)', 'Pay with PAYCO')}
+        ${paymentButton('Naver Pay (NHN KCP)', 'Pay with Naver Pay')}
+        ${paymentButton('Naver Pay Point (NHN KCP)', 'Pay with Naver Pay points')}
+        ${paymentButton('Kakao Pay (NHN KCP)', 'Pay with Kakao Pay')}
+        ${paymentButton('Apple Pay (NHN KCP)', 'Pay with Apple Pay')}
+        ${paymentButton('Credit Card', 'Pay securely with credit card')}
+    `;
+}
+
+function visibleButtonTexts(): string[] {
+    return Array.from(document.querySelectorAll<HTMLButtonElement>('button'))
+        .filter((button) => !button.hidden && button.style.display !== 'none')
+        .map((button) => plainText(button));
+}
+
+function plainText(element: Element | null | undefined): string {
+    return (element?.textContent ?? '').replace(/\u200B/g, '').replace(/\s+/g, ' ').trim();
+}
+
+function mockIosDevice(): void {
+    vi.spyOn(window.navigator, 'userAgent', 'get').mockReturnValue(
+        'Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Mobile/15E148 Safari/604.1',
+    );
+    vi.spyOn(window.navigator, 'platform', 'get').mockReturnValue('iPhone');
+}
+
+describe('checkoutEasyPayInjector', () => {
+    beforeEach(() => {
+        document.documentElement.lang = 'en';
+        window.history.pushState({}, '', '/shop/checkout');
+        renderPaymentButtons();
+    });
+
+    afterEach(() => {
+        resetCheckoutEasyPayInjectorForTests();
+        document.body.innerHTML = '';
+        vi.restoreAllMocks();
+    });
+
+    it('주문설정에서 렌더링된 NHN KCP 간편결제는 KCP 플러그인 설정과 무관하게 유지한다', async () => {
+        mockIosDevice();
+
+        await syncRenderedCheckoutEasyPayMethods();
+
+        expect(visibleButtonTexts()).toEqual([
+            'Naver Pay (KG Inicis) Pay with Naver Pay',
+            'Kakao Pay (KG Inicis) Pay with Kakao Pay',
+            'P PAYCO Pay with PAYCO (NHN KCP)',
+            'N Naver Pay (Card) Pay by Naver Pay credit card (NHN KCP)',
+            'NP Naver Pay (Point) Pay with Naver Pay Money/Points (NHN KCP)',
+            'K Kakao Pay Pay with Kakao Pay (NHN KCP)',
+            'A Apple Pay Pay with Apple Pay (NHN KCP)',
+            'Credit Card Pay securely with credit card',
+        ]);
+        expect(document.querySelectorAll('[data-nhnkcp-easy-pay-hidden="true"]')).toHaveLength(0);
+    });
+
+    it('한국어 체크아웃에서 요청한 NHN KCP 간편결제 문구와 왼쪽 정렬을 적용한다', async () => {
+        mockIosDevice();
+        document.documentElement.lang = 'ko';
+        document.body.innerHTML = `
+            ${paymentButton('PAYCO (NHN KCP)', 'PAYCO로 결제')}
+            ${paymentButton('네이버페이 (NHN KCP)', '네이버페이로 결제')}
+            ${paymentButton('네이버페이 포인트 (NHN KCP)', '네이버페이 포인트로 결제')}
+            ${paymentButton('카카오페이 (NHN KCP)', '카카오페이로 결제')}
+            ${paymentButton('Apple Pay (NHN KCP)', 'Apple Pay로 결제')}
+        `;
+
+        await syncRenderedCheckoutEasyPayMethods();
+
+        expect(visibleButtonTexts()).toEqual([
+            'P PAYCO PAYCO로 결제 (NHN KCP)',
+            'N 네이버페이 (카드) 네이버페이 신용카드로 결제 (NHN KCP)',
+            'NP 네이버페이 (포인트) 네이버페이 머니/포인트로 결제 (NHN KCP)',
+            'K 카카오페이 카카오페이로 결제 (NHN KCP)',
+            'A 애플페이 애플페이로 결제 (NHN KCP)',
+        ]);
+
+        const paycoButton = document.querySelector<HTMLButtonElement>('[data-nhnkcp-easy-pay-method="nhnkcp_payco"]');
+        const appleButton = document.querySelector<HTMLButtonElement>('[data-nhnkcp-easy-pay-method="nhnkcp_applepay"]');
+        const paycoRow = paycoButton?.querySelector<HTMLElement>('.flex.items-center');
+        const appleRow = appleButton?.querySelector<HTMLElement>('.flex.items-center');
+
+        expect(paycoButton?.style.textAlign).toBe('left');
+        expect(appleButton?.style.textAlign).toBe('left');
+        expect(paycoRow?.style.justifyContent).toBe('flex-start');
+        expect(appleRow?.style.justifyContent).toBe('flex-start');
+        expect(paycoButton?.querySelectorAll('p')[0].style.textAlign).toBe('left');
+        expect(appleButton?.querySelectorAll('p')[0].style.textAlign).toBe('left');
+    });
+
+    it('KG 이니시스 브랜드 보정기가 다시 잡지 않도록 충돌되는 원문 매칭을 피한다', async () => {
+        await syncRenderedCheckoutEasyPayMethods();
+
+        const naverButton = document.querySelector<HTMLButtonElement>('[data-nhnkcp-easy-pay-method="nhnkcp_naverpay"]');
+        const kakaoButton = document.querySelector<HTMLButtonElement>('[data-nhnkcp-easy-pay-method="nhnkcp_kakaopay"]');
+
+        expect(naverButton?.textContent).not.toContain('Naver Pay');
+        expect(kakaoButton?.textContent).not.toContain('Kakao Pay');
+        expect((naverButton?.textContent ?? '').replace(/\u200B/g, '')).toContain('Naver Pay (Card)');
+        expect((kakaoButton?.textContent ?? '').replace(/\u200B/g, '')).toContain('Kakao Pay');
+    });
+
+    it('KG 브랜드 문구로 바뀐 버튼을 NHN KCP 문구로 복구한다', async () => {
+        await syncRenderedCheckoutEasyPayMethods();
+
+        const naverButton = document.querySelector<HTMLButtonElement>('[data-nhnkcp-easy-pay-method="nhnkcp_naverpay"]');
+        const kakaoButton = document.querySelector<HTMLButtonElement>('[data-nhnkcp-easy-pay-method="nhnkcp_kakaopay"]');
+
+        expect(naverButton).not.toBeNull();
+        expect(kakaoButton).not.toBeNull();
+
+        if (naverButton && kakaoButton) {
+            naverButton.dataset.kginicisBrandPaymentMethod = 'kginicis_naverpay';
+            naverButton.querySelectorAll('p')[0].textContent = 'Naver Pay';
+            naverButton.querySelectorAll('p')[1].textContent = 'Pay with Naver Pay (KG Inicis)';
+
+            kakaoButton.dataset.kginicisBrandPaymentMethod = 'kginicis_kakaopay';
+            kakaoButton.querySelectorAll('p')[0].textContent = 'Kakao Pay';
+            kakaoButton.querySelectorAll('p')[1].textContent = 'Pay with Kakao Pay (KG Inicis)';
+            const kgMark = document.createElement('span');
+            kgMark.dataset.kginicisBrandPaymentMark = 'true';
+            kgMark.textContent = 'KakaoPay';
+            kakaoButton.querySelector('.flex.items-center')?.prepend(kgMark);
+        }
+
+        await syncRenderedCheckoutEasyPayMethods();
+
+        expect(naverButton?.dataset.kginicisBrandPaymentMethod).toBeUndefined();
+        expect(plainText(naverButton)).toContain('Naver Pay (Card)');
+        expect(plainText(naverButton)).toContain('Pay by Naver Pay credit card (NHN KCP)');
+        expect(naverButton?.textContent).not.toContain('KG Inicis');
+
+        expect(kakaoButton?.dataset.kginicisBrandPaymentMethod).toBeUndefined();
+        expect(plainText(kakaoButton)).toContain('Kakao Pay');
+        expect(plainText(kakaoButton)).toContain('Pay with Kakao Pay (NHN KCP)');
+        expect(kakaoButton?.textContent).not.toContain('KG Inicis');
+        expect(kakaoButton?.querySelector('[data-kginicis-brand-payment-mark="true"]')).toBeNull();
+    });
+
+    it('iOS 모바일 기기에서는 Apple Pay도 주문설정에서 렌더링된 경우 숨기지 않는다', async () => {
+        mockIosDevice();
+
+        await syncRenderedCheckoutEasyPayMethods();
+
+        const appleButton = document.querySelector<HTMLButtonElement>('[data-nhnkcp-easy-pay-method="nhnkcp_applepay"]');
+
+        expect(appleButton).not.toBeNull();
+        expect(appleButton?.hidden).toBe(false);
+        expect(appleButton?.style.display).not.toBe('none');
+        expect(appleButton?.textContent).toContain('Pay with Apple Pay (NHN KCP)');
+    });
+
+    it('iOS 모바일 기기가 아니면 Apple Pay 버튼을 숨긴다', async () => {
+        await syncRenderedCheckoutEasyPayMethods();
+
+        const appleButton = document.querySelector<HTMLButtonElement>('[data-nhnkcp-easy-pay-method="nhnkcp_applepay"]');
+
+        expect(appleButton).not.toBeNull();
+        expect(appleButton?.hidden).toBe(true);
+        expect(appleButton?.disabled).toBe(true);
+        expect(appleButton?.style.display).toBe('none');
+        expect(visibleButtonTexts()).not.toContain('A Apple Pay Pay with Apple Pay (NHN KCP)');
+    });
+
+    it('KG 보정기가 먼저 NHN KCP Naver/Kakao 버튼을 KG 버튼으로 바꿔도 중복 버튼을 회수한다', async () => {
+        document.body.innerHTML = `
+            ${paymentButton('NPay Naver Pay', 'Pay with Naver Pay (KG Inicis)')}
+            ${paymentButton('KakaoPay Kakao Pay', 'Pay with Kakao Pay (KG Inicis)')}
+            ${paymentButton('NPay Naver Pay', 'Pay with Naver Pay (KG Inicis)')}
+            ${paymentButton('NPay Naver Pay', 'Pay with Naver Pay (KG Inicis)')}
+            ${paymentButton('KakaoPay Kakao Pay', 'Pay with Kakao Pay (KG Inicis)')}
+        `;
+
+        const buttons = document.querySelectorAll<HTMLButtonElement>('button');
+        buttons[0].dataset.kginicisBrandPaymentMethod = 'kginicis_naverpay';
+        buttons[1].dataset.kginicisBrandPaymentMethod = 'kginicis_kakaopay';
+        buttons[2].dataset.kginicisBrandPaymentMethod = 'kginicis_naverpay';
+        buttons[3].dataset.kginicisBrandPaymentMethod = 'kginicis_naverpay';
+        buttons[4].dataset.kginicisBrandPaymentMethod = 'kginicis_kakaopay';
+
+        await syncRenderedCheckoutEasyPayMethods();
+
+        expect(buttons[0].hidden).toBe(false);
+        expect(buttons[1].hidden).toBe(false);
+        expect(buttons[2].dataset.nhnkcpEasyPayMethod).toBe('nhnkcp_naverpay');
+        expect(buttons[2].hidden).toBe(false);
+        expect(plainText(buttons[2])).toContain('Naver Pay (Card)');
+        expect(plainText(buttons[2])).toContain('Pay by Naver Pay credit card (NHN KCP)');
+        expect(buttons[2].textContent).not.toContain('KG Inicis');
+        expect(buttons[3].dataset.nhnkcpEasyPayMethod).toBe('nhnkcp_naverpay_point');
+        expect(buttons[3].hidden).toBe(false);
+        expect(plainText(buttons[3])).toContain('Naver Pay (Point)');
+        expect(plainText(buttons[3])).toContain('Pay with Naver Pay Money/Points (NHN KCP)');
+        expect(buttons[3].textContent).not.toContain('KG Inicis');
+        expect(buttons[4].dataset.nhnkcpEasyPayMethod).toBe('nhnkcp_kakaopay');
+        expect(buttons[4].hidden).toBe(false);
+        expect(plainText(buttons[4])).toContain('Kakao Pay');
+        expect(plainText(buttons[4])).toContain('Pay with Kakao Pay (NHN KCP)');
+        expect(buttons[4].textContent).not.toContain('KG Inicis');
+    });
+});
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/__tests__/handlers/copyToClipboard.test.ts b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/__tests__/handlers/copyToClipboard.test.ts
new file mode 100644
index 00000000..a969cf9f
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/__tests__/handlers/copyToClipboard.test.ts
@@ -0,0 +1,42 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { copyToClipboardHandler } from '../../handlers/copyToClipboard';
+
+describe('copyToClipboardHandler', () => {
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+
+    it('전달받은 text를 브라우저 클립보드에 복사한다', async () => {
+        const writeText = vi.fn().mockResolvedValue(undefined);
+
+        Object.defineProperty(navigator, 'clipboard', {
+            configurable: true,
+            value: { writeText },
+        });
+
+        await copyToClipboardHandler({
+            params: {
+                text: '114.207.113.206',
+            },
+        });
+
+        expect(writeText).toHaveBeenCalledWith('114.207.113.206');
+    });
+
+    it('text가 비어 있으면 클립보드를 호출하지 않는다', async () => {
+        const writeText = vi.fn().mockResolvedValue(undefined);
+
+        Object.defineProperty(navigator, 'clipboard', {
+            configurable: true,
+            value: { writeText },
+        });
+
+        await copyToClipboardHandler({
+            params: {
+                text: '',
+            },
+        });
+
+        expect(writeText).not.toHaveBeenCalled();
+    });
+});
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/__tests__/handlers/requestPayment.test.ts b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/__tests__/handlers/requestPayment.test.ts
new file mode 100644
index 00000000..22919876
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/__tests__/handlers/requestPayment.test.ts
@@ -0,0 +1,225 @@
+/**
+ * requestPayment 핸들러 테스트
+ *
+ * NHN KCP 결제창 호출 핸들러의 입력 검증 및 에러 경로 동작을 검증합니다.
+ * iframe SDK 로드 / KCP_Pay_Execute 호출 등 외부 부수효과 의존 흐름은
+ * tests/scenarios 매니페스트(통합 시나리오)에서 다루며, 본 단위 테스트는
+ * "초기 가드 + catch 블록 정상 호출" 두 축에 집중합니다.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import {
+    buildKcpEasyPayReturnFields,
+    buildKcpTaxFields,
+    isSupportedKcpCurrency,
+    requestPaymentHandler,
+    watchKcpPaymentFrameClosure,
+} from '../../handlers/requestPayment';
+
+const PG_PAYMENT = {
+    order_number: 'ORD-001',
+    order_name: 'Test Order',
+    amount: 10000,
+    pay_method: 'card',
+};
+
+describe('requestPaymentHandler', () => {
+    let apiGet: ReturnType<typeof vi.fn>;
+    let setLocalSpy: ReturnType<typeof vi.fn>;
+    let modalOpenSpy: ReturnType<typeof vi.fn>;
+
+    beforeEach(() => {
+        apiGet = vi.fn();
+        setLocalSpy = vi.fn();
+        modalOpenSpy = vi.fn();
+        document.documentElement.lang = 'ko';
+        (window as Record<string, unknown>).G7Core = {
+            api: { get: apiGet },
+            state: { setLocal: setLocalSpy },
+            modal: { open: modalOpenSpy },
+            toast: { error: vi.fn() },
+        };
+    });
+
+    afterEach(() => {
+        delete (window as Record<string, unknown>).G7Core;
+        vi.useRealTimers();
+        vi.restoreAllMocks();
+        document.body.innerHTML = '';
+    });
+
+    it('pgPaymentData가 없으면 console.error 후 조기 반환', async () => {
+        const consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => {});
+
+        await requestPaymentHandler({ params: {} });
+
+        expect(consoleSpy).toHaveBeenCalledWith(
+            expect.stringContaining('pgPaymentData is required')
+        );
+        expect(apiGet).not.toHaveBeenCalled();
+        expect(setLocalSpy).not.toHaveBeenCalled();
+    });
+
+    it('iOS 모바일 기기가 아니면 Apple Pay 결제 요청을 client config 호출 전 차단', async () => {
+        await requestPaymentHandler({
+            params: {
+                pgPaymentData: PG_PAYMENT,
+                paymentMethod: 'nhnkcp_applepay',
+            },
+        });
+
+        expect(apiGet).not.toHaveBeenCalled();
+        expect(setLocalSpy).toHaveBeenCalledWith(
+            expect.objectContaining({
+                paymentErrorMessage: '애플페이는 IOS 기기에 모바일결제만 가능합니다.',
+                isSubmittingOrder: false,
+                paymentMethod: 'nhnkcp_applepay',
+            }),
+        );
+        expect(modalOpenSpy).toHaveBeenCalledWith('nhnkcp_payment_error_modal');
+    });
+
+    it('KRW가 아닌 통화는 client config 호출 전 차단', async () => {
+        await requestPaymentHandler({
+            params: {
+                pgPaymentData: { ...PG_PAYMENT, currency: 'USD' },
+            },
+        });
+
+        expect(apiGet).not.toHaveBeenCalled();
+        expect(setLocalSpy).toHaveBeenCalledWith(
+            expect.objectContaining({
+                paymentErrorMessage: 'NHN KCP는 KRW 결제만 지원합니다. (USD)',
+                isSubmittingOrder: false,
+                paymentMethod: 'card',
+            }),
+        );
+        expect(modalOpenSpy).toHaveBeenCalledWith('nhnkcp_payment_error_modal');
+    });
+
+    it('client config 응답에 data 가 없으면 console.error 후 조기 반환', async () => {
+        const consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => {});
+        apiGet.mockResolvedValue({}); // data 누락
+
+        await requestPaymentHandler({ params: { pgPaymentData: PG_PAYMENT } });
+
+        expect(consoleSpy).toHaveBeenCalledWith(
+            expect.stringContaining('Failed to fetch client config'),
+            expect.anything()
+        );
+        expect(setLocalSpy).not.toHaveBeenCalled();
+    });
+
+    it('client config API 자체가 throw 하면 catch 블록에서 setLocal 복구', async () => {
+        vi.spyOn(console, 'error').mockImplementation(() => {});
+        apiGet.mockRejectedValue(new Error('Network error'));
+
+        await requestPaymentHandler({ params: { pgPaymentData: PG_PAYMENT } });
+
+        // catch 블록은 paymentMethod를 pgPaymentData.pay_method 또는 'card' 로 setLocal 복구
+        expect(setLocalSpy).toHaveBeenCalledWith(
+            expect.objectContaining({
+                isSubmittingOrder: false,
+                paymentMethod: 'card',
+            })
+        );
+    });
+
+    it('pay_method 가 vbank 면 catch 시 그 값으로 복구', async () => {
+        vi.spyOn(console, 'error').mockImplementation(() => {});
+        apiGet.mockRejectedValue(new Error('boom'));
+
+        await requestPaymentHandler({
+            params: {
+                pgPaymentData: { ...PG_PAYMENT, pay_method: 'vbank' },
+            },
+        });
+
+        expect(setLocalSpy).toHaveBeenCalledWith(
+            expect.objectContaining({
+                isSubmittingOrder: false,
+                paymentMethod: 'vbank',
+            })
+        );
+    });
+
+    it('KCP 결제 iframe 이 제거되면 닫힘 콜백을 한 번만 실행', async () => {
+        vi.useFakeTimers();
+
+        const iframe = document.createElement('iframe');
+        Object.defineProperty(iframe, 'getBoundingClientRect', {
+            value: () => ({ width: 100, height: 100 }),
+        });
+        document.body.appendChild(iframe);
+
+        const onClose = vi.fn();
+        const stop = watchKcpPaymentFrameClosure(iframe, onClose);
+
+        iframe.remove();
+        await vi.runOnlyPendingTimersAsync();
+
+        expect(onClose).toHaveBeenCalledTimes(1);
+
+        document.body.appendChild(iframe);
+        iframe.remove();
+        await vi.runOnlyPendingTimersAsync();
+
+        expect(onClose).toHaveBeenCalledTimes(1);
+        stop();
+        vi.useRealTimers();
+    });
+
+    it('KCP 결제 iframe 감시를 중지하면 제거되어도 닫힘 콜백을 실행하지 않음', async () => {
+        vi.useFakeTimers();
+
+        const iframe = document.createElement('iframe');
+        Object.defineProperty(iframe, 'getBoundingClientRect', {
+            value: () => ({ width: 100, height: 100 }),
+        });
+        document.body.appendChild(iframe);
+
+        const onClose = vi.fn();
+        const stop = watchKcpPaymentFrameClosure(iframe, onClose);
+
+        stop();
+        iframe.remove();
+        await vi.runOnlyPendingTimersAsync();
+
+        expect(onClose).not.toHaveBeenCalled();
+        vi.useRealTimers();
+    });
+
+    it('복합과세 분할 필드를 실결제액 기준으로 재배분', () => {
+        const fields = buildKcpTaxFields({
+            ...PG_PAYMENT,
+            amount: 19000,
+            tax_amount: 11000,
+            vat_amount: 1000,
+            tax_free_amount: 10000,
+        });
+
+        expect(fields).toEqual({
+            tax_flag: 'TG03',
+            comm_tax_mny: '8182',
+            comm_vat_mny: '818',
+            comm_free_mny: '10000',
+        });
+        expect(
+            Number(fields.comm_tax_mny) + Number(fields.comm_vat_mny) + Number(fields.comm_free_mny),
+        ).toBe(19000);
+    });
+
+    it('KCP 통화 가드는 빈 값과 KRW만 허용', () => {
+        expect(isSupportedKcpCurrency(undefined)).toBe(true);
+        expect(isSupportedKcpCurrency('KRW')).toBe(true);
+        expect(isSupportedKcpCurrency('usd')).toBe(false);
+    });
+
+    it('간편결제 원 결제수단을 KCP callback 반환 필드에 싣는다', () => {
+        expect(buildKcpEasyPayReturnFields('nhnkcp_naverpay', true)).toEqual({
+            param_opt_1: 'nhnkcp_naverpay',
+            nhnkcp_easy_pay_method: 'nhnkcp_naverpay',
+        });
+        expect(buildKcpEasyPayReturnFields('card', false)).toEqual({});
+        expect(buildKcpEasyPayReturnFields('nhnkcp_unknown', true)).toEqual({});
+    });
+});
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/__tests__/layouts/pluginSettingsSticky.test.tsx b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/__tests__/layouts/pluginSettingsSticky.test.tsx
new file mode 100644
index 00000000..84b2680c
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/__tests__/layouts/pluginSettingsSticky.test.tsx
@@ -0,0 +1,153 @@
+/**
+ * @file pluginSettingsSticky.test.tsx
+ * @description sirsoft-pay_nhnkcp 플러그인 환경설정 화면 하단 저장 버튼 sticky 고정 테스트
+ *
+ * 플러그인 환경설정(plugin_settings.json)의 하단 저장/취소 버튼 영역이
+ * 긴 콘텐츠를 스크롤하는 동안에도 화면 하단에 고정되도록 sticky 클래스가
+ * 적용되어 있는지 검증한다.
+ */
+
+import { describe, it, expect } from 'vitest';
+import pluginSettingsLayout from '../../../layouts/admin/plugin_settings.json';
+
+/** 레이아웃 트리에서 주어진 id 의 노드를 찾는다. */
+function findById(node: unknown, id: string): Record<string, unknown> | undefined {
+  if (!node || typeof node !== 'object') {
+    return undefined;
+  }
+  const value = node as Record<string, unknown>;
+  if (value.id === id) {
+    return value;
+  }
+  for (const child of Object.values(value)) {
+    const found = findById(child, id);
+    if (found) {
+      return found;
+    }
+  }
+  return undefined;
+}
+
+function classNameOf(node: Record<string, unknown> | undefined): string {
+  const props = (node?.props ?? {}) as Record<string, unknown>;
+  return typeof props.className === 'string' ? props.className : '';
+}
+
+function collectClassNames(node: unknown, classNames: string[] = []): string[] {
+  if (!node || typeof node !== 'object') {
+    return classNames;
+  }
+  const value = node as Record<string, unknown>;
+  const props = (value.props ?? {}) as Record<string, unknown>;
+  if (typeof props.className === 'string') {
+    classNames.push(props.className);
+  }
+  for (const child of Object.values(value)) {
+    collectClassNames(child, classNames);
+  }
+
+  return classNames;
+}
+
+function collectIds(node: unknown, ids: string[] = []): string[] {
+  if (!node || typeof node !== 'object') {
+    return ids;
+  }
+  const value = node as Record<string, unknown>;
+  if (typeof value.id === 'string') {
+    ids.push(value.id);
+  }
+  for (const child of Object.values(value)) {
+    collectIds(child, ids);
+  }
+
+  return ids;
+}
+
+describe('plugin_settings 하단 버튼 sticky 고정', () => {
+  it('가상계좌 입금통보 URL 등록 경로를 설정 화면에 노출해야 한다', () => {
+    const section = findById(pluginSettingsLayout, 'vbank_notify_section');
+    expect(section).toBeDefined();
+
+    const serialized = JSON.stringify(section);
+    expect(serialized).toContain('sirsoft-pay_nhnkcp.settings.section_vbank_notify');
+    expect(serialized).toContain('sirsoft-pay_nhnkcp.settings.vbank_notify_hint');
+    expect(serialized).toContain('sirsoft-pay_nhnkcp.settings.vbank_notify_path');
+  });
+
+  it('결제취소 서버 IP 등록 안내를 설정 화면에 노출해야 한다', () => {
+    const notice = findById(pluginSettingsLayout, 'cancel_server_ip_notice');
+    expect(notice).toBeDefined();
+
+    const className = classNameOf(notice);
+    expect(className).toContain('border-amber-200');
+    expect(className).toContain('dark:border-amber-700');
+
+    const serialized = JSON.stringify(notice);
+    expect(serialized).toContain('sirsoft-pay_nhnkcp.settings.cancel_server_ip_title');
+    expect(serialized).toContain('sirsoft-pay_nhnkcp.settings.cancel_server_ip_body');
+    expect(serialized).toContain('sirsoft-pay_nhnkcp.settings.cancel_server_ip_path');
+    expect(serialized).toContain('sirsoft-pay_nhnkcp.settings.cancel_server_ip_effect');
+    expect(serialized).toContain('sirsoft-pay_nhnkcp.settings.cancel_server_ip_value_label');
+    expect(serialized).toContain('health.data.summary.cancel_server_ip.address');
+    expect(serialized).toContain('sirsoft-pay_nhnkcp.copyToClipboard');
+    expect(serialized).toContain('https://partner.kcp.co.kr/');
+    expect(serialized).not.toContain('https://admin8.kcp.co.kr');
+
+    const ids = collectIds(pluginSettingsLayout);
+    expect(ids.indexOf('cancel_server_ip_notice')).toBeGreaterThan(-1);
+    expect(ids.indexOf('vbank_notify_section')).toBeGreaterThan(-1);
+    expect(ids.indexOf('cancel_server_ip_notice')).toBeLessThan(ids.indexOf('vbank_notify_section'));
+  });
+
+  it('footer_buttons 에 sticky bottom 고정 클래스가 존재해야 한다', () => {
+    const footer = findById(pluginSettingsLayout, 'footer_buttons');
+    expect(footer).toBeDefined();
+
+    const className = classNameOf(footer);
+    expect(className).toContain('sticky');
+    expect(className).toContain('bottom-0');
+    expect(className).toContain('z-10');
+    expect(className).toContain('border-gray-200');
+  });
+
+  it('health_check_card 가 기본 검정 border 대신 관리자 카드 톤을 명시해야 한다', () => {
+    const card = findById(pluginSettingsLayout, 'health_check_card');
+    expect(card).toBeDefined();
+
+    const className = classNameOf(card);
+    expect(className).toContain('shadow-sm');
+    expect(className).toContain('border-gray-200');
+    expect(className).toContain('dark:border-gray-700');
+  });
+
+  it('health_check_card 내부 구분선도 기본 검정 border 로 떨어지지 않아야 한다', () => {
+    const card = findById(pluginSettingsLayout, 'health_check_card');
+    expect(card).toBeDefined();
+
+    const classNames = collectClassNames(card);
+    expect(classNames).not.toContain('flex items-center justify-between p-4 border-b dark:border-gray-700');
+    expect(classNames).not.toContain('grid grid-cols-1 sm:grid-cols-3 gap-3 p-4 border-b dark:border-gray-700');
+  });
+
+  it('활성 테마의 신규 시맨틱 CSS 없이도 설정 화면 기본 레이아웃이 적용되어야 한다', () => {
+    const root = findById(pluginSettingsLayout, 'plugin_settings_content');
+    expect(root).toBeDefined();
+
+    const rootClassName = classNameOf(root);
+    expect(rootClassName).toContain('p-4');
+    expect(rootClassName).toContain('sm:p-6');
+    expect(rootClassName).toContain('lg:p-8');
+    expect(rootClassName).toContain('min-h-screen');
+    expect(rootClassName).toContain('bg-gray-50');
+    expect(rootClassName).toContain('dark:bg-gray-900');
+
+    const classNames = collectClassNames(pluginSettingsLayout);
+    for (const className of classNames) {
+      expect(className).not.toContain('admin-page-content-responsive');
+      expect(className).not.toContain('flex-between');
+      expect(className).not.toContain('sticky-footer-buttons');
+      expect(className).not.toContain('row-stack');
+    }
+  });
+});
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/__tests__/orderPaymentDisplayInjectors.test.ts b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/__tests__/orderPaymentDisplayInjectors.test.ts
new file mode 100644
index 00000000..eb133598
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/__tests__/orderPaymentDisplayInjectors.test.ts
@@ -0,0 +1,44 @@
+import { afterEach, describe, expect, it } from 'vitest';
+import { patchAdminPaymentMethodDisplay } from '../adminOrderPaymentDisplayInjector';
+import { patchMypagePaymentMethodDisplay } from '../mypageOrderShowInjector';
+
+describe('NHN KCP order payment display injectors', () => {
+    afterEach(() => {
+        document.body.innerHTML = '';
+    });
+
+    it('마이페이지 주문 상세의 결제 방법 행을 간편결제 표시로 바꾼다', () => {
+        const container = document.createElement('div');
+        container.innerHTML = `
+            <div class="flex items-center justify-between">
+                <span class="text-gray-500">결제 방법</span>
+                <span class="text-gray-900">신용카드</span>
+            </div>
+        `;
+
+        expect(patchMypagePaymentMethodDisplay(container, '네이버페이 (신용카드)')).toBe(true);
+        expect(container.textContent?.replace(/\s+/g, '')).toContain('결제방법네이버페이(신용카드)');
+        expect(container.querySelector('[data-nhnkcp-payment-method-patched="true"]')).not.toBeNull();
+    });
+
+    it('관리자 주문 상세의 결제수단 행과 상단 배지를 간편결제 표시로 바꾼다', () => {
+        const root = document.createElement('div');
+        root.innerHTML = `
+            <span class="inline-flex rounded-full font-medium">신용카드</span>
+            <div>
+                <span class="text-xs block">결제수단</span>
+                <span class="text-sm font-semibold block">신용카드</span>
+                <span class="text-xs text-gray-500">(일시불)</span>
+            </div>
+        `;
+
+        expect(patchAdminPaymentMethodDisplay(root, {
+            _pay_method_label: '카카오페이 (신용카드)',
+            _base_pay_method_label: '신용카드',
+            _embedded_pg_provider_label: '카카오페이',
+        })).toBe(true);
+
+        const text = root.textContent?.replace(/\s+/g, '');
+        expect(text).toContain('카카오페이결제수단카카오페이(신용카드,일시불)');
+    });
+});
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/__tests__/orderResponseInterceptor.test.ts b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/__tests__/orderResponseInterceptor.test.ts
new file mode 100644
index 00000000..1ac801f3
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/__tests__/orderResponseInterceptor.test.ts
@@ -0,0 +1,158 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { requestPaymentHandler } from '../handlers/requestPayment';
+import { installOrderResponseInterceptor } from '../orderResponseInterceptor';
+
+vi.mock('../handlers/requestPayment', () => ({
+    requestPaymentHandler: vi.fn().mockResolvedValue(undefined),
+}));
+
+interface MutatedOrderResponse {
+    data?: {
+        redirect_url?: string;
+        requires_pg_payment?: boolean;
+    };
+}
+
+function windowRecord(): Record<string, unknown> {
+    return window as unknown as Record<string, unknown>;
+}
+
+describe('installOrderResponseInterceptor', () => {
+    beforeEach(() => {
+        document.documentElement.lang = 'ko';
+        window.history.pushState({}, '', '/shop/checkout');
+        vi.mocked(requestPaymentHandler).mockClear();
+        vi.spyOn(console, 'info').mockImplementation(() => {});
+    });
+
+    afterEach(() => {
+        const w = windowRecord();
+        delete w['__sirsoftNhnkcpInterceptorInstalled'];
+        delete w['__sirsoftPgOriginalFetch'];
+        delete w['G7Core'];
+        document.body.innerHTML = '';
+        vi.restoreAllMocks();
+    });
+
+    it('NHN KCP 간편결제는 주문 생성 요청을 card로 전송하고 원래 결제수단으로 KCP 결제창을 호출한다', async () => {
+        let sentBody = '';
+        window.fetch = vi.fn().mockImplementation(async (_input, init?: RequestInit) => {
+            sentBody = String(init?.body ?? '');
+
+            return new Response(JSON.stringify({
+                success: true,
+                data: {
+                    order: {
+                        order_number: 'ORD-100',
+                        total_amount: 15000,
+                        total_due_amount: 14000,
+                        orderer_name: 'Tester',
+                        orderer_email: 'tester@example.test',
+                        orderer_phone: '010-1234-5678',
+                        options: [{ product_name: '테스트 상품' }],
+                    },
+                    redirect_url: '/shop/orders/ORD-100/complete',
+                    requires_pg_payment: true,
+                    pg_provider: 'sirsoft-kginicis',
+                },
+            }), {
+                status: 200,
+                headers: { 'Content-Type': 'application/json' },
+            });
+        }) as unknown as typeof fetch;
+
+        installOrderResponseInterceptor();
+
+        const response = await window.fetch('/api/modules/sirsoft-ecommerce/user/orders', {
+            method: 'POST',
+            body: JSON.stringify({ payment_method: 'nhnkcp_naverpay' }),
+        });
+        const body = (await response.json()) as MutatedOrderResponse;
+
+        expect(JSON.parse(sentBody)).toMatchObject({ payment_method: 'card' });
+        expect(requestPaymentHandler).toHaveBeenCalledWith({
+            params: {
+                pgPaymentData: expect.objectContaining({
+                    order_number: 'ORD-100',
+                    order_name: '테스트 상품',
+                    amount: 14000,
+                    customer_phone: '01012345678',
+                }),
+                paymentMethod: 'nhnkcp_naverpay',
+            },
+        });
+        expect(body.data?.requires_pg_payment).toBe(false);
+        expect(body.data?.redirect_url).toBe('/shop/checkout');
+    });
+
+    it('iOS 모바일 기기가 아닌 Apple Pay 주문 생성 요청은 서버 전송 전에 차단한다', async () => {
+        const fetchSpy = vi.fn().mockResolvedValue(
+            new Response(JSON.stringify({ success: true }), {
+                status: 200,
+                headers: { 'Content-Type': 'application/json' },
+            }),
+        );
+        window.fetch = fetchSpy as unknown as typeof fetch;
+
+        installOrderResponseInterceptor();
+
+        const response = await window.fetch('/api/modules/sirsoft-ecommerce/user/orders', {
+            method: 'POST',
+            body: JSON.stringify({ payment_method: 'nhnkcp_applepay' }),
+        });
+        const body = await response.json() as {
+            success?: boolean;
+            error?: string;
+            errors?: { payment_method?: string[] };
+        };
+
+        expect(fetchSpy).not.toHaveBeenCalled();
+        expect(response.status).toBe(422);
+        expect(body.success).toBe(false);
+        expect(body.error).toBe('애플페이는 IOS 기기에 모바일결제만 가능합니다.');
+        expect(body.errors?.payment_method?.[0]).toBe('애플페이는 IOS 기기에 모바일결제만 가능합니다.');
+        expect(requestPaymentHandler).not.toHaveBeenCalled();
+    });
+
+    it('일반 NHN KCP 주문 응답도 결제창을 호출하고 fallback 이동을 막는다', async () => {
+        window.fetch = vi.fn().mockResolvedValue(
+            new Response(JSON.stringify({
+                success: true,
+                data: {
+                    order: { order_number: 'ORD-101' },
+                    redirect_url: '/shop/orders/ORD-101/complete',
+                    requires_pg_payment: true,
+                    pg_provider: 'sirsoft-nhnkcp',
+                    pg_payment_data: {
+                        order_number: 'ORD-101',
+                        order_name: '일반 주문',
+                        amount: 20000,
+                    },
+                },
+            }), {
+                status: 200,
+                headers: { 'Content-Type': 'application/json' },
+            }),
+        ) as unknown as typeof fetch;
+
+        installOrderResponseInterceptor();
+
+        const response = await window.fetch('/api/modules/sirsoft-ecommerce/user/orders', {
+            method: 'POST',
+            body: JSON.stringify({ payment_method: 'card' }),
+        });
+        const body = (await response.json()) as MutatedOrderResponse;
+
+        expect(requestPaymentHandler).toHaveBeenCalledWith({
+            params: {
+                pgPaymentData: expect.objectContaining({
+                    order_number: 'ORD-101',
+                    pay_method: 'card',
+                }),
+                paymentMethod: undefined,
+            },
+        });
+        expect(body.data?.requires_pg_payment).toBe(false);
+        expect(body.data?.redirect_url).toBe('/shop/checkout');
+    });
+});
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/__tests__/paymentCloseReport.test.ts b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/__tests__/paymentCloseReport.test.ts
new file mode 100644
index 00000000..5be262b8
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/__tests__/paymentCloseReport.test.ts
@@ -0,0 +1,92 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { preparePaymentRetry, reportPaymentWindowClosed } from '../paymentCloseReport';
+
+function windowRecord(): Record<string, any> {
+    return window as unknown as Record<string, any>;
+}
+
+describe('paymentCloseReport', () => {
+    afterEach(() => {
+        delete windowRecord().G7Core;
+        vi.restoreAllMocks();
+    });
+
+    it('G7Core API로 NHN KCP 결제창 닫힘을 보고한다', async () => {
+        const apiPost = vi.fn().mockResolvedValue({ success: true });
+        windowRecord().G7Core = {
+            api: { post: apiPost },
+        };
+
+        await reportPaymentWindowClosed({
+            closeReportUrl: '/plugins/sirsoft-pay_nhnkcp/payment/close-report',
+            oid: 'ORD-KCP-CLOSE-001',
+            price: 10000,
+            buyer_email: 'buyer@example.com',
+            buyer_phone: '01012345678',
+            payment_method: 'card',
+        }, 'kcp-window-closed');
+
+        expect(apiPost).toHaveBeenCalledWith('/plugins/sirsoft-pay_nhnkcp/payment/close-report', {
+            oid: 'ORD-KCP-CLOSE-001',
+            price: 10000,
+            buyer_email: 'buyer@example.com',
+            buyer_phone: '01012345678',
+            payment_method: 'card',
+            reason: 'kcp-window-closed',
+        });
+    });
+
+    it('G7Core API가 없으면 /plugins 경로를 /api/plugins 경로로 변환해 fetch 한다', async () => {
+        const fetchSpy = vi.spyOn(globalThis, 'fetch').mockResolvedValue(new Response('{}'));
+
+        await reportPaymentWindowClosed({
+            closeReportUrl: '/plugins/sirsoft-pay_nhnkcp/payment/close-report',
+            oid: 'ORD-KCP-CLOSE-002',
+            price: 15000,
+        });
+
+        expect(fetchSpy).toHaveBeenCalledWith('/api/plugins/sirsoft-pay_nhnkcp/payment/close-report', expect.objectContaining({
+            method: 'POST',
+            keepalive: true,
+        }));
+    });
+
+    it('결제창을 열기 전 같은 주문 재시도 준비 API를 호출한다', async () => {
+        const apiPost = vi.fn().mockResolvedValue({ success: true });
+        windowRecord().G7Core = {
+            api: { post: apiPost },
+        };
+
+        await preparePaymentRetry({
+            closeReportUrl: '/plugins/sirsoft-pay_nhnkcp/payment/close-report',
+            oid: 'ORD-KCP-RETRY-001',
+            price: 20000,
+            buyer_email: 'buyer@example.com',
+            buyer_phone: '01012345678',
+            payment_method: 'nhnkcp_kakaopay',
+        });
+
+        expect(apiPost).toHaveBeenCalledWith('/plugins/sirsoft-pay_nhnkcp/payment/retry', {
+            oid: 'ORD-KCP-RETRY-001',
+            price: 20000,
+            buyer_email: 'buyer@example.com',
+            buyer_phone: '01012345678',
+            payment_method: 'nhnkcp_kakaopay',
+        });
+    });
+
+    it('재시도 준비 API가 실패하면 결제창을 열지 않도록 오류를 전파한다', async () => {
+        vi.spyOn(globalThis, 'fetch').mockResolvedValue(new Response(JSON.stringify({
+            errors: { message: ['Order is not retryable for NHN KCP payment.'] },
+        }), {
+            status: 409,
+            headers: { 'Content-Type': 'application/json' },
+        }));
+
+        await expect(preparePaymentRetry({
+            closeReportUrl: '/plugins/sirsoft-pay_nhnkcp/payment/close-report',
+            oid: 'ORD-KCP-RETRY-002',
+            price: 20000,
+        })).rejects.toThrow('Order is not retryable for NHN KCP payment.');
+    });
+});
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/adminApplePayNoticeInjector.ts b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/adminApplePayNoticeInjector.ts
new file mode 100644
index 00000000..35d91ddd
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/adminApplePayNoticeInjector.ts
@@ -0,0 +1,142 @@
+const PLUGIN_ID = 'sirsoft-pay_nhnkcp';
+const FLAG = '__kcpAdminApplePayNoticeInjectorInstalled';
+const ADMIN_SETTINGS_RE = /^\/admin\/ecommerce\/settings\/?$/;
+const LISTENER_FLAG = '__kcpAdminApplePayNoticeListenerAttached';
+const NOTICE_KO = '애플페이는 IOS 기기에 모바일결제만 가능합니다.';
+const NOTICE_EN = 'Apple Pay is available only for mobile payments on iOS devices.';
+
+let observer: MutationObserver | null = null;
+let retryTimer: number | null = null;
+let syncQueued = false;
+
+function windowRecord(): Record<string, unknown> {
+    return window as unknown as Record<string, unknown>;
+}
+
+function isOrderSettingsPage(): boolean {
+    if (!ADMIN_SETTINGS_RE.test(window.location.pathname)) return false;
+
+    const tab = new URLSearchParams(window.location.search).get('tab');
+    return tab === null || tab === 'order_settings';
+}
+
+function noticeText(): string {
+    const lang = document.documentElement.lang || navigator.language || '';
+
+    return lang.toLowerCase().startsWith('ko') ? NOTICE_KO : NOTICE_EN;
+}
+
+function normalizedText(value: string | null | undefined): string {
+    return (value ?? '').replace(/\s+/g, ' ').trim();
+}
+
+function isApplePayLabel(element: HTMLElement): boolean {
+    const text = normalizedText(element.textContent);
+
+    return text === '애플페이' || text === 'Apple Pay';
+}
+
+function createNotice(): HTMLSpanElement {
+    const notice = document.createElement('span');
+    notice.dataset.nhnkcpAdminApplePayNotice = 'true';
+    notice.className = 'text-label-subtle';
+    notice.style.display = 'block';
+    notice.style.width = '100%';
+    notice.style.flexBasis = '100%';
+    notice.style.marginTop = '2px';
+    notice.style.fontSize = '12px';
+    notice.style.lineHeight = '1rem';
+    notice.textContent = noticeText();
+
+    return notice;
+}
+
+export function patchAdminApplePayNotice(root: ParentNode = document): boolean {
+    if (typeof window === 'undefined' || typeof document === 'undefined') return false;
+    if (!isOrderSettingsPage()) return false;
+    const bodyText = normalizedText(document.body?.innerText ?? document.body?.textContent);
+    if (bodyText.includes(noticeText())) return false;
+
+    const applePayLabel = Array.from(root.querySelectorAll<HTMLElement>('span, p, div'))
+        .find(isApplePayLabel);
+    if (!applePayLabel) return false;
+
+    applePayLabel.insertAdjacentElement('afterend', createNotice());
+    return true;
+}
+
+function queueSync(): void {
+    if (syncQueued) return;
+    syncQueued = true;
+
+    window.setTimeout(() => {
+        syncQueued = false;
+        patchAdminApplePayNotice();
+    }, 0);
+}
+
+function stopRetries(): void {
+    if (retryTimer === null) return;
+
+    window.clearInterval(retryTimer);
+    retryTimer = null;
+}
+
+function startSync(): void {
+    if (!isOrderSettingsPage()) return;
+
+    stopRetries();
+    patchAdminApplePayNotice();
+
+    let attempts = 0;
+    retryTimer = window.setInterval(() => {
+        attempts += 1;
+        if (patchAdminApplePayNotice() || attempts >= 50) {
+            stopRetries();
+        }
+    }, 200);
+
+    const body = document.body as HTMLElement & Record<string, unknown>;
+    if (body[LISTENER_FLAG]) return;
+    body[LISTENER_FLAG] = true;
+
+    observer = new MutationObserver(() => queueSync());
+    observer.observe(document.body, { childList: true, subtree: true, characterData: true });
+}
+
+function onRouteChange(): void {
+    if (isOrderSettingsPage()) startSync();
+}
+
+export function installAdminApplePayNoticeInjector(): void {
+    if (typeof window === 'undefined' || typeof document === 'undefined') return;
+    const w = windowRecord();
+    if (w[FLAG]) return;
+    w[FLAG] = true;
+
+    console.info(`[${PLUGIN_ID}] admin Apple Pay notice injector installed`);
+
+    if (document.readyState === 'loading') {
+        document.addEventListener('DOMContentLoaded', () => startSync());
+    } else {
+        startSync();
+    }
+
+    const origPush = history.pushState.bind(history);
+    history.pushState = (...args: Parameters<typeof history.pushState>) => {
+        origPush(...args);
+        window.setTimeout(() => onRouteChange(), 200);
+    };
+    window.addEventListener('popstate', () => window.setTimeout(() => onRouteChange(), 200));
+}
+
+export function resetAdminApplePayNoticeInjectorForTests(): void {
+    observer?.disconnect();
+    observer = null;
+    stopRetries();
+    syncQueued = false;
+    delete windowRecord()[FLAG];
+    if (document.body) {
+        delete ((document.body as HTMLElement & Record<string, unknown>)[LISTENER_FLAG]);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/adminOrderPaymentDisplayInjector.ts b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/adminOrderPaymentDisplayInjector.ts
new file mode 100644
index 00000000..7ba49962
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/adminOrderPaymentDisplayInjector.ts
@@ -0,0 +1,163 @@
+const PLUGIN_ID = 'sirsoft-pay_nhnkcp';
+const FLAG = '__nhnkcpAdminPaymentDisplayInjectorInstalled';
+
+const ADMIN_ORDER_SHOW_RE = /^\/admin\/ecommerce\/orders\/([^/]+)$/;
+
+interface AdminTransactionStatus {
+    _pay_method_label?: string | null;
+    _base_pay_method_label?: string | null;
+    _embedded_pg_provider_label?: string | null;
+}
+
+function getToken(): string | null {
+    return localStorage.getItem('auth_token');
+}
+
+async function fetchAdminTransactionStatus(orderNumber: string): Promise<AdminTransactionStatus | null> {
+    const token = getToken();
+    if (!token) return null;
+
+    try {
+        const res = await fetch(`/api/plugins/${PLUGIN_ID}/admin/orders/${orderNumber}/transaction-status`, {
+            headers: { Authorization: `Bearer ${token}`, Accept: 'application/json' },
+        });
+        if (!res.ok) return null;
+
+        const json = (await res.json()) as { data?: AdminTransactionStatus | null } | AdminTransactionStatus;
+        return ('data' in json ? json.data : json) ?? null;
+    } catch {
+        return null;
+    }
+}
+
+function directElementChildren(el: Element): HTMLElement[] {
+    return Array.from(el.children).filter(
+        (child): child is HTMLElement => child instanceof HTMLElement,
+    );
+}
+
+function patchLabeledPaymentMethod(root: Element, displayLabel: string): boolean {
+    let patched = false;
+
+    const rows = Array.from(root.querySelectorAll<HTMLElement>('div'));
+    for (const row of rows) {
+        const children = directElementChildren(row);
+        const labelIndex = children.findIndex(child => child.textContent?.trim() === '결제수단');
+        if (labelIndex < 0) continue;
+
+        const value = children
+            .slice(labelIndex + 1)
+            .find(child => child.textContent?.trim() && child.textContent.trim() !== '결제수단');
+        if (!value) continue;
+
+        const installment = children
+            .slice(labelIndex + 2)
+            .find(child => /^\(.+\)$/.test(child.textContent?.trim() ?? ''));
+        const installmentText = installment?.textContent?.trim().replace(/^\(|\)$/g, '') ?? '';
+        const nextDisplayLabel = installmentText && displayLabel.endsWith(')')
+            ? displayLabel.replace(/\)$/, `, ${installmentText})`)
+            : displayLabel;
+
+        if (value.textContent?.trim() !== nextDisplayLabel) {
+            value.textContent = nextDisplayLabel;
+            value.dataset.nhnkcpPaymentMethodPatched = 'true';
+        }
+        row.dataset.nhnkcpPaymentMethodRow = 'admin-order';
+        if (installment && installmentText) {
+            installment.textContent = '';
+            installment.style.display = 'none';
+            installment.dataset.nhnkcpPaymentInstallmentHidden = 'true';
+        }
+        patched = true;
+    }
+
+    return patched;
+}
+
+function patchPaymentMethodBadge(root: Element, baseLabel: string, embeddedLabel: string): boolean {
+    const candidates = Array.from(root.querySelectorAll<HTMLElement>('span')).filter(
+        el => el.textContent?.trim() === baseLabel,
+    );
+
+    const badge = candidates.find(el => {
+        const className = typeof el.className === 'string' ? el.className : '';
+        return className.includes('rounded-full') || className.includes('font-medium');
+    });
+
+    if (!badge) return false;
+
+    badge.textContent = embeddedLabel;
+    badge.dataset.nhnkcpPaymentMethodPatched = 'true';
+    badge.dataset.nhnkcpPaymentMethodBadge = 'admin-order';
+    return true;
+}
+
+export function patchAdminPaymentMethodDisplay(
+    root: Element,
+    status: AdminTransactionStatus | null | undefined,
+): boolean {
+    const displayLabel = status?._pay_method_label;
+    const embeddedLabel = status?._embedded_pg_provider_label;
+    const baseLabel = status?._base_pay_method_label;
+
+    if (!displayLabel || !embeddedLabel) return false;
+
+    const labeled = patchLabeledPaymentMethod(root, displayLabel);
+    const badge = baseLabel ? patchPaymentMethodBadge(root, baseLabel, embeddedLabel) : false;
+
+    return labeled || badge;
+}
+
+async function tryInject(orderNumber: string): Promise<boolean> {
+    const root = document.getElementById('section_payment_info') ?? document.getElementById('payment_info_card');
+    if (!root) return false;
+
+    const status = await fetchAdminTransactionStatus(orderNumber);
+    if (!status) return true;
+
+    const patched = patchAdminPaymentMethodDisplay(root, status);
+    if (patched) {
+        console.info(`[${PLUGIN_ID}] payment method display patched on admin order detail`);
+    }
+
+    return true;
+}
+
+function startPolling(orderNumber: string): void {
+    let attempts = 0;
+    const id = setInterval(() => {
+        attempts++;
+        void tryInject(orderNumber).then(done => {
+            if (done || attempts >= 30) clearInterval(id);
+        });
+    }, 400);
+}
+
+function onRouteChange(): void {
+    const match = location.pathname.match(ADMIN_ORDER_SHOW_RE);
+    if (match) startPolling(match[1]);
+}
+
+export function installAdminOrderPaymentDisplayInjector(): void {
+    if (typeof window === 'undefined') return;
+    const w = window as unknown as Record<string, unknown>;
+    if (w[FLAG]) return;
+    w[FLAG] = true;
+
+    console.info(`[${PLUGIN_ID}] admin order payment display injector installed`);
+
+    const schedule = (delay = 1500) => setTimeout(onRouteChange, delay);
+
+    if (document.readyState === 'loading') {
+        document.addEventListener('DOMContentLoaded', () => schedule());
+    } else {
+        schedule();
+    }
+
+    const origPush = history.pushState.bind(history);
+    history.pushState = (...args: Parameters<typeof history.pushState>) => {
+        origPush(...args);
+        schedule(600);
+    };
+    window.addEventListener('popstate', () => schedule(500));
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/adminPaymentMethodBrandInjector.ts b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/adminPaymentMethodBrandInjector.ts
new file mode 100644
index 00000000..c1771664
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/adminPaymentMethodBrandInjector.ts
@@ -0,0 +1,278 @@
+const PLUGIN_ID = 'sirsoft-pay_nhnkcp';
+const FLAG = '__nhnkcpAdminPaymentMethodBrandInjectorInstalled';
+const LISTENER_FLAG = '__nhnkcpAdminPaymentMethodBrandSyncListenerAttached';
+const ADMIN_SETTINGS_RE = /^\/admin\/ecommerce\/settings\/?$/;
+const MARK_SELECTOR = '[data-nhnkcp-admin-payment-brand-mark="true"]';
+const SYNC_RETRY_INTERVAL_MS = 200;
+const SYNC_RETRY_ATTEMPTS = 120;
+
+interface AdminPaymentBrandDefinition {
+    id: string;
+    labels: string[];
+    shortLabels: string[];
+    markLines: string[];
+    markClassName: string;
+}
+
+const ADMIN_PAYMENT_BRAND_DEFINITIONS: AdminPaymentBrandDefinition[] = [
+    {
+        id: 'nhnkcp_payco',
+        labels: ['PAYCO (NHN KCP)', 'PAYCO로 결제 (NHN KCP)', 'Pay with PAYCO (NHN KCP)'],
+        shortLabels: ['PAYCO'],
+        markLines: ['P'],
+        markClassName: 'bg-red-500 text-white',
+    },
+    {
+        id: 'nhnkcp_naverpay',
+        labels: ['네이버페이 (NHN KCP)', '네이버페이 신용카드로 결제 (NHN KCP)', 'Naver Pay (NHN KCP)', 'Pay by Naver Pay credit card (NHN KCP)'],
+        shortLabels: ['네이버페이 (카드)', 'Naver Pay (Card)'],
+        markLines: ['N'],
+        markClassName: 'bg-green-500 text-white',
+    },
+    {
+        id: 'nhnkcp_naverpay_point',
+        labels: ['네이버페이 포인트 (NHN KCP)', '네이버페이 머니/포인트로 결제 (NHN KCP)', 'Naver Pay Point (NHN KCP)', 'Pay with Naver Pay Money/Points (NHN KCP)'],
+        shortLabels: ['네이버페이 (포인트)', 'Naver Pay (Point)'],
+        markLines: ['NP'],
+        markClassName: 'bg-green-600 text-white',
+    },
+    {
+        id: 'nhnkcp_kakaopay',
+        labels: ['카카오페이 (NHN KCP)', '카카오페이로 결제 (NHN KCP)', 'Kakao Pay (NHN KCP)', 'Pay with Kakao Pay (NHN KCP)'],
+        shortLabels: ['카카오페이', 'Kakao Pay'],
+        markLines: ['K'],
+        markClassName: 'bg-yellow-400 text-gray-950',
+    },
+    {
+        id: 'nhnkcp_applepay',
+        labels: ['애플페이 (NHN KCP)', '애플페이로 결제 (NHN KCP)', 'Apple Pay (NHN KCP)', 'Pay with Apple Pay (NHN KCP)'],
+        shortLabels: ['애플페이', 'Apple Pay'],
+        markLines: ['A'],
+        markClassName: 'bg-gray-900 text-white',
+    },
+];
+
+let observer: MutationObserver | null = null;
+let retryTimer: number | null = null;
+let syncQueued = false;
+
+function windowRecord(): Record<string, unknown> {
+    return window as unknown as Record<string, unknown>;
+}
+
+function isOrderSettingsPage(): boolean {
+    if (!ADMIN_SETTINGS_RE.test(window.location.pathname)) return false;
+
+    const tab = new URLSearchParams(window.location.search).get('tab');
+    return tab === null || tab === '' || tab === 'order_settings';
+}
+
+function classNameOf(element: Element): string {
+    return element instanceof HTMLElement ? element.className : '';
+}
+
+function comparableText(value: string | null | undefined): string {
+    return (value ?? '')
+        .replace(/\u200B/g, '')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+
+function isPaymentMethodItem(element: HTMLElement): boolean {
+    const className = classNameOf(element);
+
+    return className.includes('excel-card')
+        || (className.includes('flex-center') && className.includes('border') && className.includes('gap-4'));
+}
+
+function findTitleElement(item: HTMLElement): HTMLElement | null {
+    return item.querySelector<HTMLElement>('.font-medium');
+}
+
+function findDefinitionForItem(item: HTMLElement): AdminPaymentBrandDefinition | null {
+    const title = comparableText(findTitleElement(item)?.textContent);
+    const text = comparableText(item.textContent);
+
+    return ADMIN_PAYMENT_BRAND_DEFINITIONS.find((definition) => (
+        definition.shortLabels.some((label) => title === label)
+        || definition.labels.some((label) => text.includes(label))
+    )) ?? null;
+}
+
+function findPaymentMethodItems(root: ParentNode): HTMLElement[] {
+    return Array.from(root.querySelectorAll<HTMLElement>('div'))
+        .filter(isPaymentMethodItem);
+}
+
+function findPaymentIcon(item: HTMLElement): Element | null {
+    const icons = Array.from(item.querySelectorAll<Element>('svg, [data-icon], i'));
+
+    return icons.find((element) => (
+        !element.closest('[data-drag-handle]')
+        && !element.closest(MARK_SELECTOR)
+        && !element.closest('.row-stack, .excel-card-body, button, select, [role="switch"]')
+    )) ?? null;
+}
+
+function applyBrandMarkContent(mark: HTMLSpanElement, definition: AdminPaymentBrandDefinition): void {
+    mark.dataset.nhnkcpAdminPaymentBrandMark = 'true';
+    mark.dataset.nhnkcpAdminPaymentMethod = definition.id;
+    mark.setAttribute('aria-hidden', 'true');
+    mark.className = `inline-flex items-center justify-center rounded-lg font-bold ${definition.markClassName}`;
+    mark.style.width = '32px';
+    mark.style.height = '32px';
+    mark.style.flex = '0 0 32px';
+    mark.style.lineHeight = '1';
+    mark.style.fontSize = definition.markLines.join('').length > 2 ? '9px' : '12px';
+
+    const expectedText = definition.markLines.join('');
+    if (mark.textContent === expectedText) return;
+
+    mark.replaceChildren();
+    if (definition.markLines.length > 1) {
+        mark.style.flexDirection = 'column';
+        definition.markLines.forEach((line) => {
+            const lineElement = document.createElement('span');
+            lineElement.style.lineHeight = '1';
+            lineElement.textContent = line;
+            mark.appendChild(lineElement);
+        });
+    } else {
+        mark.style.removeProperty('flex-direction');
+        mark.textContent = definition.markLines[0] ?? '';
+    }
+}
+
+function createBrandMark(definition: AdminPaymentBrandDefinition): HTMLSpanElement {
+    const mark = document.createElement('span');
+    applyBrandMarkContent(mark, definition);
+
+    return mark;
+}
+
+function syncBrandMark(item: HTMLElement, definition: AdminPaymentBrandDefinition): boolean {
+    const existing = item.querySelector<HTMLElement>(MARK_SELECTOR);
+    if (existing instanceof HTMLSpanElement) {
+        item.dataset.nhnkcpAdminPaymentMethod = definition.id;
+        applyBrandMarkContent(existing, definition);
+        return true;
+    }
+
+    const mark = createBrandMark(definition);
+    const icon = findPaymentIcon(item);
+    if (icon && icon.parentElement) {
+        item.dataset.nhnkcpAdminPaymentMethod = definition.id;
+        icon.replaceWith(mark);
+        return true;
+    }
+
+    const title = findTitleElement(item);
+    if (title && title.parentElement) {
+        item.dataset.nhnkcpAdminPaymentMethod = definition.id;
+        title.parentElement.insertBefore(mark, title);
+        return true;
+    }
+
+    return false;
+}
+
+export function syncRenderedAdminPaymentMethodBrands(root: ParentNode = document): boolean {
+    if (typeof window === 'undefined' || typeof document === 'undefined') return false;
+    if (!isOrderSettingsPage()) return false;
+
+    let matched = false;
+
+    findPaymentMethodItems(root).forEach((item) => {
+        const definition = findDefinitionForItem(item);
+        if (!definition) return;
+
+        if (syncBrandMark(item, definition)) {
+            matched = true;
+        }
+    });
+
+    return matched;
+}
+
+function queueSync(): void {
+    if (syncQueued) return;
+    syncQueued = true;
+
+    window.setTimeout(() => {
+        syncQueued = false;
+        syncRenderedAdminPaymentMethodBrands();
+    }, 0);
+}
+
+function stopRetries(): void {
+    if (retryTimer === null) return;
+
+    window.clearInterval(retryTimer);
+    retryTimer = null;
+}
+
+function startSync(): void {
+    if (!isOrderSettingsPage()) return;
+
+    stopRetries();
+    syncRenderedAdminPaymentMethodBrands();
+
+    let attempts = 0;
+    retryTimer = window.setInterval(() => {
+        attempts += 1;
+        syncRenderedAdminPaymentMethodBrands();
+
+        if (attempts >= SYNC_RETRY_ATTEMPTS) {
+            stopRetries();
+        }
+    }, SYNC_RETRY_INTERVAL_MS);
+
+    const body = document.body as HTMLElement & Record<string, unknown>;
+    if (body[LISTENER_FLAG]) return;
+    body[LISTENER_FLAG] = true;
+
+    observer = new MutationObserver(() => queueSync());
+    observer.observe(document.body, { childList: true, subtree: true, characterData: true });
+}
+
+function onRouteChange(): void {
+    if (isOrderSettingsPage()) {
+        startSync();
+        return;
+    }
+
+    stopRetries();
+}
+
+export function installAdminPaymentMethodBrandInjector(): void {
+    if (typeof window === 'undefined' || typeof document === 'undefined') return;
+    const w = windowRecord();
+    if (w[FLAG]) return;
+    w[FLAG] = true;
+
+    console.info(`[${PLUGIN_ID}] admin payment method brand sync installed`);
+
+    if (document.readyState === 'loading') {
+        document.addEventListener('DOMContentLoaded', () => startSync());
+    } else {
+        startSync();
+    }
+
+    const origPush = history.pushState.bind(history);
+    history.pushState = (...args: Parameters<typeof history.pushState>) => {
+        origPush(...args);
+        window.setTimeout(() => onRouteChange(), 200);
+    };
+    window.addEventListener('popstate', () => window.setTimeout(() => onRouteChange(), 200));
+}
+
+export function resetAdminPaymentMethodBrandInjectorForTests(): void {
+    observer?.disconnect();
+    observer = null;
+    stopRetries();
+    syncQueued = false;
+    delete windowRecord()[FLAG];
+    if (document.body) {
+        delete ((document.body as HTMLElement & Record<string, unknown>)[LISTENER_FLAG]);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/checkoutEasyPayInjector.ts b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/checkoutEasyPayInjector.ts
new file mode 100644
index 00000000..75a88623
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/checkoutEasyPayInjector.ts
@@ -0,0 +1,429 @@
+import {
+    isIosMobileDevice,
+    isNhnKcpApplePayMethod,
+} from './support/applePayDevice';
+
+const PLUGIN_ID = 'sirsoft-pay_nhnkcp';
+const FLAG = '__kcpCheckoutEasyPayInjectorInstalled';
+const CHECKOUT_RE = /^\/shop\/checkout\/?$/;
+const LISTENER_FLAG = '__kcpCheckoutEasyPaySyncListenerAttached';
+const SYNC_RETRY_INTERVAL_MS = 200;
+const SYNC_RETRY_ATTEMPTS = 120;
+
+interface EasyPayCopy {
+    heading: string;
+    description: string;
+    title: string;
+}
+
+interface EasyPayDefinition {
+    id: string;
+    configKey: string;
+    labels: string[];
+    ko: EasyPayCopy;
+    en: EasyPayCopy;
+    markText: string;
+    markClassName: string;
+}
+
+const EASY_PAY_DEFINITIONS: EasyPayDefinition[] = [
+    {
+        id: 'nhnkcp_payco',
+        configKey: 'PAYCO',
+        labels: ['PAYCO (NHN KCP)', 'PAYCO NHN KCP 간편결제', 'PAYCO로 결제 (NHN KCP)', 'Pay with PAYCO (NHN KCP)'],
+        ko: {
+            heading: 'PAYCO',
+            description: 'PAYCO로 결제 (NHN KCP)',
+            title: 'PAYCO로 결제 (NHN KCP)',
+        },
+        en: {
+            heading: 'PAYCO',
+            description: 'Pay with PAYCO (NHN KCP)',
+            title: 'Pay with PAYCO (NHN KCP)',
+        },
+        markText: 'P',
+        markClassName: 'bg-red-500 text-white',
+    },
+    {
+        id: 'nhnkcp_naverpay',
+        configKey: 'NAVERPAY',
+        labels: ['네이버페이 (NHN KCP)', '네이버페이 신용카드로 결제 (NHN KCP)', 'NaverPay NHN KCP 간편결제', 'Naver Pay (NHN KCP)', 'NaverPay (NHN KCP)', 'Pay by Naver Pay credit card (NHN KCP)'],
+        ko: {
+            heading: '네이버페이 (카드)',
+            description: '네이버페이 신용카드로 결제 (NHN KCP)',
+            title: '네이버페이 신용카드로 결제 (NHN KCP)',
+        },
+        en: {
+            heading: 'Naver Pay (Card)',
+            description: 'Pay by Naver Pay credit card (NHN KCP)',
+            title: 'Pay by Naver Pay credit card (NHN KCP)',
+        },
+        markText: 'N',
+        markClassName: 'bg-green-500 text-white',
+    },
+    {
+        id: 'nhnkcp_naverpay_point',
+        configKey: 'NAVERPAY POINT',
+        labels: ['네이버페이 포인트 (NHN KCP)', '네이버페이 머니/포인트로 결제 (NHN KCP)', 'NaverPay 포인트 NHN KCP 포인트 간편결제', 'Naver Pay Point (NHN KCP)', 'NaverPay Point (NHN KCP)', 'Pay with Naver Pay Money/Points (NHN KCP)'],
+        ko: {
+            heading: '네이버페이 (포인트)',
+            description: '네이버페이 머니/포인트로 결제 (NHN KCP)',
+            title: '네이버페이 머니/포인트로 결제 (NHN KCP)',
+        },
+        en: {
+            heading: 'Naver Pay (Point)',
+            description: 'Pay with Naver Pay Money/Points (NHN KCP)',
+            title: 'Pay with Naver Pay Money/Points (NHN KCP)',
+        },
+        markText: 'NP',
+        markClassName: 'bg-green-600 text-white',
+    },
+    {
+        id: 'nhnkcp_kakaopay',
+        configKey: 'KAKAOPAY',
+        labels: ['카카오페이 (NHN KCP)', '카카오페이로 결제 (NHN KCP)', 'KakaoPay NHN KCP 간편결제', 'Kakao Pay (NHN KCP)', 'KakaoPay (NHN KCP)', 'Pay with Kakao Pay (NHN KCP)'],
+        ko: {
+            heading: '카카오페이',
+            description: '카카오페이로 결제 (NHN KCP)',
+            title: '카카오페이로 결제 (NHN KCP)',
+        },
+        en: {
+            heading: 'Kakao Pay',
+            description: 'Pay with Kakao Pay (NHN KCP)',
+            title: 'Pay with Kakao Pay (NHN KCP)',
+        },
+        markText: 'K',
+        markClassName: 'bg-yellow-400 text-gray-950',
+    },
+    {
+        id: 'nhnkcp_applepay',
+        configKey: 'APPLEPAY',
+        labels: ['애플페이 (NHN KCP)', '애플페이로 결제 (NHN KCP)', 'Apple Pay NHN KCP 간편결제', 'Apple Pay (NHN KCP)', 'Pay with Apple Pay (NHN KCP)'],
+        ko: {
+            heading: '애플페이',
+            description: '애플페이로 결제 (NHN KCP)',
+            title: '애플페이로 결제 (NHN KCP)',
+        },
+        en: {
+            heading: 'Apple Pay',
+            description: 'Pay with Apple Pay (NHN KCP)',
+            title: 'Pay with Apple Pay (NHN KCP)',
+        },
+        markText: 'A',
+        markClassName: 'bg-gray-900 text-white',
+    },
+];
+
+let observer: MutationObserver | null = null;
+let retryTimer: number | null = null;
+let syncQueued = false;
+
+function windowRecord(): Record<string, unknown> {
+    return window as unknown as Record<string, unknown>;
+}
+
+function isCheckoutPage(): boolean {
+    return CHECKOUT_RE.test(window.location.pathname);
+}
+
+function normalizedText(value: string | null | undefined): string {
+    return (value ?? '').replace(/\s+/g, ' ').trim();
+}
+
+function isKoreanPage(): boolean {
+    const lang = document.documentElement.lang || navigator.language || '';
+
+    return lang.toLowerCase().startsWith('ko');
+}
+
+function copyFor(definition: EasyPayDefinition): EasyPayCopy {
+    return isKoreanPage() ? definition.ko : definition.en;
+}
+
+function displayText(value: string): string {
+    return value
+        .replaceAll('네이버페이', '네이\u200B버페이')
+        .replaceAll('카카오페이', '카카\u200B오페이')
+        .replaceAll('Naver Pay', 'Naver\u200B Pay')
+        .replaceAll('Kakao Pay', 'Kakao\u200B Pay');
+}
+
+function findDefinitionById(id: string | undefined): EasyPayDefinition | null {
+    return EASY_PAY_DEFINITIONS.find((definition) => definition.id === id) ?? null;
+}
+
+function findDefinitionForButton(button: HTMLButtonElement): EasyPayDefinition | null {
+    const markedDefinition = findDefinitionById(button.dataset.nhnkcpEasyPayMethod);
+    if (markedDefinition) return markedDefinition;
+
+    const text = normalizedText(button.textContent);
+
+    return EASY_PAY_DEFINITIONS.find((definition) => (
+        definition.labels.some((label) => text.includes(label))
+    )) ?? null;
+}
+
+function findPaymentRow(button: HTMLButtonElement): HTMLElement | null {
+    return button.querySelector<HTMLElement>('.flex.items-center.gap-2, .flex.items-center.gap-3')
+        ?? button.querySelector<HTMLElement>('.flex.items-center');
+}
+
+function alignPaymentTextLeft(button: HTMLButtonElement, heading?: HTMLElement, description?: HTMLElement): void {
+    button.style.textAlign = 'left';
+
+    const row = findPaymentRow(button);
+    if (row) {
+        row.style.justifyContent = 'flex-start';
+        row.style.textAlign = 'left';
+        row.style.width = '100%';
+    }
+
+    const textContainer = heading?.parentElement ?? description?.parentElement;
+    if (textContainer instanceof HTMLElement) {
+        textContainer.style.textAlign = 'left';
+        textContainer.style.minWidth = '0';
+    }
+}
+
+function createMark(definition: EasyPayDefinition): HTMLSpanElement {
+    const mark = document.createElement('span');
+    mark.dataset.nhnkcpEasyPayMark = 'true';
+    mark.dataset.nhnkcpEasyPayMethod = definition.id;
+    mark.setAttribute('aria-hidden', 'true');
+    mark.className = `inline-flex items-center justify-center rounded-lg text-xs font-bold ${definition.markClassName}`;
+    mark.style.width = '32px';
+    mark.style.height = '32px';
+    mark.style.flex = '0 0 32px';
+    mark.textContent = definition.markText;
+
+    return mark;
+}
+
+function removeKginicisBrandArtifacts(button: HTMLButtonElement): void {
+    delete button.dataset.kginicisBrandPaymentButton;
+    delete button.dataset.kginicisBrandPaymentMethod;
+    delete button.dataset.kginicisNaverpayBrandButton;
+
+    button.querySelectorAll<HTMLElement>('[data-kginicis-brand-payment-mark="true"], [data-kginicis-naverpay-mark="true"]').forEach((element) => {
+        element.remove();
+    });
+
+    button.querySelectorAll<HTMLElement>('[data-kginicis-brand-payment-heading], [data-kginicis-brand-payment-description], [data-kginicis-naverpay-heading], [data-kginicis-naverpay-description]').forEach((element) => {
+        delete element.dataset.kginicisBrandPaymentHeading;
+        delete element.dataset.kginicisBrandPaymentDescription;
+        delete element.dataset.kginicisNaverpayHeading;
+        delete element.dataset.kginicisNaverpayDescription;
+    });
+}
+
+function findPaymentIcon(button: HTMLButtonElement): Element | null {
+    return button.querySelector('[data-kginicis-brand-payment-mark="true"], [data-kginicis-naverpay-mark="true"]')
+        ?? button.querySelector('[data-nhnkcp-easy-pay-mark="true"]')
+        ?? button.querySelector('svg')
+        ?? button.querySelector('i[class*="fa-"], i[role="img"], i');
+}
+
+function ensureMark(button: HTMLButtonElement, definition: EasyPayDefinition): void {
+    const existingMark = button.querySelector<HTMLElement>('[data-nhnkcp-easy-pay-mark="true"]');
+    if (existingMark) {
+        existingMark.dataset.nhnkcpEasyPayMethod = definition.id;
+        existingMark.className = `inline-flex items-center justify-center rounded-lg text-xs font-bold ${definition.markClassName}`;
+        existingMark.textContent = definition.markText;
+        return;
+    }
+
+    const mark = createMark(definition);
+    const icon = findPaymentIcon(button);
+    if (icon && icon.parentElement) {
+        icon.replaceWith(mark);
+        return;
+    }
+
+    const row = findPaymentRow(button);
+    row?.prepend(mark);
+}
+
+function updatePaymentText(button: HTMLButtonElement, definition: EasyPayDefinition): void {
+    const paragraphs = Array.from(button.querySelectorAll<HTMLParagraphElement>('p'));
+    const copy = copyFor(definition);
+    const headingText = displayText(copy.heading);
+    const descriptionText = displayText(copy.description);
+
+    const heading = paragraphs[0];
+    const description = paragraphs[1];
+
+    if (heading && heading.textContent !== headingText) {
+        heading.textContent = headingText;
+    }
+    if (heading) {
+        heading.setAttribute('aria-label', copy.heading);
+        heading.style.textAlign = 'left';
+        heading.style.whiteSpace = 'normal';
+        heading.style.wordBreak = 'keep-all';
+        heading.style.overflowWrap = 'anywhere';
+    }
+
+    if (description && description.textContent !== descriptionText) {
+        description.textContent = descriptionText;
+    }
+    if (description) {
+        description.style.textAlign = 'left';
+        description.style.fontSize = '12px';
+        description.style.lineHeight = '1rem';
+        description.style.whiteSpace = 'normal';
+        description.style.wordBreak = 'keep-all';
+        description.style.overflowWrap = 'anywhere';
+    }
+
+    alignPaymentTextLeft(button, heading, description);
+    button.title = copy.title;
+}
+
+function showButton(button: HTMLButtonElement, definition: EasyPayDefinition): void {
+    if (isNhnKcpApplePayMethod(definition.id) && !isIosMobileDevice()) {
+        button.hidden = true;
+        button.disabled = true;
+        button.style.display = 'none';
+        button.setAttribute('aria-hidden', 'true');
+        button.dataset.nhnkcpEasyPayMethod = definition.id;
+        button.dataset.nhnkcpEasyPayHidden = 'true';
+        delete button.dataset.nhnkcpEasyPayVisible;
+        return;
+    }
+
+    if (button.hidden) button.hidden = false;
+    if (button.disabled) button.disabled = false;
+    if (button.style.display === 'none') button.style.removeProperty('display');
+    button.removeAttribute('aria-hidden');
+    button.dataset.nhnkcpEasyPayMethod = definition.id;
+    button.dataset.nhnkcpEasyPayVisible = 'true';
+    delete button.dataset.nhnkcpEasyPayHidden;
+
+    removeKginicisBrandArtifacts(button);
+    ensureMark(button, definition);
+    updatePaymentText(button, definition);
+}
+
+function reconcileKginicisPatchedDuplicates(root: ParentNode): boolean {
+    const duplicateGroups: Record<string, string[]> = {
+        kginicis_naverpay: ['nhnkcp_naverpay', 'nhnkcp_naverpay_point'],
+        kginicis_kakaopay: ['nhnkcp_kakaopay'],
+    };
+    let changed = false;
+
+    Object.entries(duplicateGroups).forEach(([kginicisMethod, nhnkcpMethods]) => {
+        const buttons = Array.from(root.querySelectorAll<HTMLButtonElement>(`button[data-kginicis-brand-payment-method="${kginicisMethod}"]`))
+            .filter((button) => !button.dataset.nhnkcpEasyPayMethod);
+
+        buttons.slice(1).forEach((button, index) => {
+            const definition = findDefinitionById(nhnkcpMethods[index]);
+            if (!definition) return;
+
+            showButton(button, definition);
+            changed = true;
+        });
+    });
+
+    return changed;
+}
+
+export async function syncRenderedCheckoutEasyPayMethods(
+    root: ParentNode = document,
+): Promise<boolean> {
+    if (typeof window === 'undefined' || typeof document === 'undefined') return false;
+    if (!isCheckoutPage()) return false;
+
+    let changed = false;
+
+    root.querySelectorAll<HTMLButtonElement>('button').forEach((button) => {
+        const definition = findDefinitionForButton(button);
+        if (!definition) return;
+
+        showButton(button, definition);
+        changed = true;
+    });
+
+    if (reconcileKginicisPatchedDuplicates(root)) {
+        changed = true;
+    }
+
+    return changed;
+}
+
+function queueSync(): void {
+    if (syncQueued) return;
+    syncQueued = true;
+
+    window.setTimeout(() => {
+        syncQueued = false;
+        void syncRenderedCheckoutEasyPayMethods();
+    }, 0);
+}
+
+function stopRetries(): void {
+    if (retryTimer === null) return;
+
+    window.clearInterval(retryTimer);
+    retryTimer = null;
+}
+
+function startSync(): void {
+    if (!isCheckoutPage()) return;
+
+    stopRetries();
+    void syncRenderedCheckoutEasyPayMethods();
+
+    let attempts = 0;
+    retryTimer = window.setInterval(() => {
+        attempts += 1;
+        void syncRenderedCheckoutEasyPayMethods();
+
+        if (attempts >= SYNC_RETRY_ATTEMPTS) {
+            stopRetries();
+        }
+    }, SYNC_RETRY_INTERVAL_MS);
+
+    const body = document.body as HTMLElement & Record<string, unknown>;
+    if (body[LISTENER_FLAG]) return;
+    body[LISTENER_FLAG] = true;
+
+    observer = new MutationObserver(() => queueSync());
+    observer.observe(document.body, { childList: true, subtree: true, characterData: true });
+}
+
+function onRouteChange(): void {
+    if (isCheckoutPage()) startSync();
+}
+
+export function installCheckoutEasyPayInjector(): void {
+    if (typeof window === 'undefined' || typeof document === 'undefined') return;
+    const w = windowRecord();
+    if (w[FLAG]) return;
+    w[FLAG] = true;
+
+    console.info(`[${PLUGIN_ID}] checkout easy pay method sync installed`);
+
+    if (document.readyState === 'loading') {
+        document.addEventListener('DOMContentLoaded', () => startSync());
+    } else {
+        startSync();
+    }
+
+    const origPush = history.pushState.bind(history);
+    history.pushState = (...args: Parameters<typeof history.pushState>) => {
+        origPush(...args);
+        window.setTimeout(() => onRouteChange(), 200);
+    };
+    window.addEventListener('popstate', () => window.setTimeout(() => onRouteChange(), 200));
+}
+
+export function resetCheckoutEasyPayInjectorForTests(): void {
+    observer?.disconnect();
+    observer = null;
+    stopRetries();
+    syncQueued = false;
+    delete windowRecord()[FLAG];
+    if (document.body) {
+        delete ((document.body as HTMLElement & Record<string, unknown>)[LISTENER_FLAG]);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/handlers/copyToClipboard.ts b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/handlers/copyToClipboard.ts
new file mode 100644
index 00000000..2177f880
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/handlers/copyToClipboard.ts
@@ -0,0 +1,34 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+
+function fallbackCopy(text: string): void {
+    const textarea = document.createElement('textarea');
+    textarea.value = text;
+    textarea.setAttribute('readonly', 'readonly');
+    textarea.style.position = 'fixed';
+    textarea.style.left = '-9999px';
+    textarea.style.top = '0';
+
+    document.body.appendChild(textarea);
+    textarea.select();
+
+    try {
+        document.execCommand('copy');
+    } finally {
+        textarea.remove();
+    }
+}
+
+export async function copyToClipboardHandler(action: any): Promise<void> {
+    const text = String(action.params?.text ?? '');
+
+    if (text === '') {
+        return;
+    }
+
+    if (navigator.clipboard && typeof navigator.clipboard.writeText === 'function') {
+        await navigator.clipboard.writeText(text);
+        return;
+    }
+
+    fallbackCopy(text);
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/handlers/index.ts b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/handlers/index.ts
new file mode 100644
index 00000000..b6494f16
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/handlers/index.ts
@@ -0,0 +1,9 @@
+import { requestPaymentHandler } from './requestPayment';
+import { setPaymentMethodHandler } from './setPaymentMethod';
+import { copyToClipboardHandler } from './copyToClipboard';
+
+export const handlerMap: Record<string, (...args: unknown[]) => unknown> = {
+    requestPayment: requestPaymentHandler,
+    setPaymentMethod: setPaymentMethodHandler,
+    copyToClipboard: copyToClipboardHandler,
+} as const;
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/handlers/requestPayment.ts b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/handlers/requestPayment.ts
new file mode 100644
index 00000000..fafe0821
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/handlers/requestPayment.ts
@@ -0,0 +1,593 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+
+import {
+    PaymentCloseReportContext,
+    preparePaymentRetry,
+    reportPaymentWindowClosed,
+} from '../paymentCloseReport';
+import {
+    applePayUnsupportedMessage,
+    isIosMobileDevice,
+    isNhnKcpApplePayMethod,
+} from '../support/applePayDevice';
+
+interface PgPaymentData {
+    order_number: string;
+    order_name: string;
+    amount: number;
+    currency?: string;
+    pay_method?: string;
+    customer_name?: string;
+    customer_email?: string;
+    customer_phone?: string;
+    /** 복합과세 분할용 — orderResponseInterceptor가 data.order 에서 주입 */
+    tax_amount?: number;
+    vat_amount?: number;
+    tax_free_amount?: number;
+}
+
+interface RequestPaymentParams {
+    pgPaymentData: PgPaymentData;
+    paymentMethod?: string;
+}
+
+function normalizeCurrency(currency?: string): string {
+    const normalized = (currency ?? 'KRW').trim().toUpperCase();
+
+    return normalized || 'KRW';
+}
+
+export function isSupportedKcpCurrency(currency?: string): boolean {
+    return normalizeCurrency(currency) === 'KRW';
+}
+
+function unsupportedCurrencyMessage(currency?: string): string {
+    const normalized = normalizeCurrency(currency);
+    const isKo = ((typeof document !== 'undefined' ? document.documentElement.lang : '') || '')
+        .toLowerCase()
+        .startsWith('ko');
+
+    return isKo
+        ? `NHN KCP는 KRW 결제만 지원합니다. (${normalized})`
+        : `NHN KCP supports KRW payments only. (${normalized})`;
+}
+
+export function buildKcpTaxFields(pgPaymentData: PgPaymentData): Record<string, string> {
+    const paymentAmount = Math.max(0, Math.round(Number(pgPaymentData.amount ?? 0)));
+    const taxFreeAmt = Math.min(
+        Math.max(0, Math.round(Number(pgPaymentData.tax_free_amount ?? 0))),
+        paymentAmount,
+    );
+
+    if (taxFreeAmt <= 0) {
+        return {};
+    }
+
+    const taxTotalAmt = Math.max(0, Math.round(Number(pgPaymentData.tax_amount ?? 0)));
+    const originalVatAmt = Math.max(0, Math.round(Number(pgPaymentData.vat_amount ?? 0)));
+    const taxablePaymentAmt = Math.max(0, paymentAmount - taxFreeAmt);
+    const vatAmt = taxablePaymentAmt > 0 && taxTotalAmt > 0 && originalVatAmt > 0
+        ? Math.min(taxablePaymentAmt, Math.round(taxablePaymentAmt * (originalVatAmt / taxTotalAmt)))
+        : 0;
+    const supplyAmt = taxablePaymentAmt - vatAmt;
+
+    return {
+        tax_flag: 'TG03',
+        comm_tax_mny: String(supplyAmt),
+        comm_vat_mny: String(vatAmt),
+        comm_free_mny: String(taxFreeAmt),
+    };
+}
+
+interface ClientConfig {
+    client_id: string;
+    easy_pay_client_id?: string;
+    sdk_url: string;
+    callback_urls: {
+        callback: string;
+        close_report?: string;
+    };
+    vbank_expire_days?: number;
+    use_escrow?: boolean;
+    escrow_client_id?: string;
+}
+
+// 사용자가 결제창을 직접 닫은 경우 - 에러 모달 없이 조용히 처리
+class KcpCancelledError extends Error {
+    constructor(msg?: string) {
+        super(msg ?? '결제가 취소되었습니다.');
+        this.name = 'KcpCancelledError';
+    }
+}
+
+// KCP pay_method 비트마스크 변환 (PC: payplus_web.jsp 규격)
+const KCP_PAY_METHOD: Record<string, string> = {
+    card:            '100000000000', // 신용카드
+    bank_transfer:   '010000000000', // 계좌이체
+    virtual_account: '001000000000', // 가상계좌
+    mobile:          '000010000000', // 휴대폰결제
+    bank:            '010000000000',
+    vbank:           '001000000000',
+    phone:           '000010000000',
+};
+
+// KCP 간편결제 direct 파라미터 (PC/모바일 공통)
+const KCP_EASY_PAY_DIRECT: Record<string, Record<string, string>> = {
+    nhnkcp_payco:          { payco_direct: 'Y' },
+    nhnkcp_naverpay:       { naverpay_direct: 'Y' },
+    nhnkcp_naverpay_point: { naverpay_direct: 'Y', naverpay_point_direct: 'Y' },
+    nhnkcp_kakaopay:       { kakaopay_direct: 'Y' },
+    nhnkcp_applepay:       { applepay_direct: 'Y' },
+};
+
+export function buildKcpEasyPayReturnFields(paymentMethod: string, isEasyPay: boolean): Record<string, string> {
+    const methodKey = paymentMethod.toLowerCase();
+    if (!isEasyPay || !Object.prototype.hasOwnProperty.call(KCP_EASY_PAY_DIRECT, methodKey)) {
+        return {};
+    }
+
+    return {
+        param_opt_1: methodKey,
+        nhnkcp_easy_pay_method: methodKey,
+    };
+}
+
+function isKcpPaymentFrameClosed(iframe: HTMLIFrameElement): boolean {
+    if (!iframe.isConnected) {
+        return true;
+    }
+
+    const style = window.getComputedStyle(iframe);
+    if (style.display === 'none' || style.visibility === 'hidden') {
+        return true;
+    }
+
+    const rect = iframe.getBoundingClientRect();
+    return rect.width <= 0 || rect.height <= 0;
+}
+
+export function watchKcpPaymentFrameClosure(
+    iframe: HTMLIFrameElement,
+    onClose: () => void,
+): () => void {
+    let stopped = false;
+    let intervalId: number | undefined;
+    let observer: MutationObserver | undefined;
+
+    const stop = () => {
+        stopped = true;
+        if (observer) {
+            observer.disconnect();
+            observer = undefined;
+        }
+        if (intervalId !== undefined) {
+            window.clearInterval(intervalId);
+            intervalId = undefined;
+        }
+    };
+
+    const checkClosed = () => {
+        if (stopped || !isKcpPaymentFrameClosed(iframe)) {
+            return;
+        }
+
+        stop();
+        onClose();
+    };
+
+    const observeTarget = document.body ?? document.documentElement;
+    if (observeTarget && typeof MutationObserver !== 'undefined') {
+        observer = new MutationObserver(checkClosed);
+        observer.observe(observeTarget, {
+            attributes: true,
+            attributeFilter: ['class', 'hidden', 'style'],
+            childList: true,
+            subtree: true,
+        });
+    }
+
+    intervalId = window.setInterval(checkClosed, 300);
+
+    return stop;
+}
+
+/**
+ * 모바일 기기 여부 판별 (3단계 fallback)
+ *
+ * 1) User Agent Client Hints — 브라우저가 직접 판단 (Chrome/Edge 90+)
+ * 2) UA 문자열 파싱
+ * 3) iPadOS 등 데스크탑 UA를 보내는 터치 기기 판별 (maxTouchPoints > 1)
+ */
+function isMobileDevice(): boolean {
+    if (typeof navigator === 'undefined') return false;
+    if (isIosMobileDevice()) return true;
+
+    const nav = navigator as Navigator & { userAgentData?: { mobile: boolean } };
+    if (nav.userAgentData?.mobile !== undefined) {
+        return nav.userAgentData.mobile;
+    }
+
+    const ua = (navigator.userAgent || '').toLowerCase();
+    if (/android|iphone|ipod|windows phone|iemobile|blackberry|opera mini|mobile safari/.test(ua)) {
+        return true;
+    }
+
+    // iPadOS, Android 태블릿 등 — 터치스크린 노트북은 maxTouchPoints=1이므로 >1 조건 필요
+    const touchPoints = (navigator as Navigator & { maxTouchPoints?: number }).maxTouchPoints ?? 0;
+    if (touchPoints > 1 && !ua.includes('windows') && !ua.includes('macintosh')) {
+        return true;
+    }
+
+    return false;
+}
+
+/**
+ * NHN KCP 결제창 호출 핸들러
+ *
+ * - 모바일: SOAP approval_key 획득 → form POST(페이지 전환) → 기존 authCallback 처리
+ * - PC: payplus_web.jsp SDK를 iframe 내 동기 로드 → KCP_Pay_Execute() → 콜백
+ */
+export async function requestPaymentHandler(action: any, _context?: any): Promise<void> {
+    const { pgPaymentData, paymentMethod: paramPaymentMethod } = (action.params || {}) as RequestPaymentParams;
+
+    if (!pgPaymentData) {
+        console.error('[sirsoft-pay_nhnkcp] pgPaymentData is required');
+        return;
+    }
+
+    const paymentMethod = paramPaymentMethod ?? pgPaymentData.pay_method ?? 'card';
+    const isEasyPay = typeof paymentMethod === 'string' && paymentMethod.startsWith('nhnkcp_');
+
+    const G7Core = (window as any).G7Core;
+    let closeReportContext: PaymentCloseReportContext | null = null;
+
+    try {
+        if (!isSupportedKcpCurrency(pgPaymentData.currency)) {
+            const message = unsupportedCurrencyMessage(pgPaymentData.currency);
+            G7Core?.state?.setLocal?.({ paymentErrorMessage: message, isSubmittingOrder: false, paymentMethod });
+            G7Core?.modal?.open?.('nhnkcp_payment_error_modal');
+            return;
+        }
+
+        if (isNhnKcpApplePayMethod(paymentMethod) && !isIosMobileDevice()) {
+            const message = applePayUnsupportedMessage();
+            G7Core?.state?.setLocal?.({
+                paymentErrorMessage: message,
+                isSubmittingOrder: false,
+                paymentMethod,
+            });
+            G7Core?.modal?.open?.('nhnkcp_payment_error_modal');
+            return;
+        }
+
+        // 1. Client Config API 호출
+        const configJson = await G7Core.api.get('/modules/sirsoft-ecommerce/payments/client-config/nhnkcp');
+
+        if (!configJson.data) {
+            console.error('[sirsoft-pay_nhnkcp] Failed to fetch client config', configJson);
+            return;
+        }
+
+        const config: ClientConfig = configJson.data;
+        closeReportContext = {
+            closeReportUrl: config.callback_urls.close_report,
+            oid: pgPaymentData.order_number,
+            price: Number(pgPaymentData.amount),
+            buyer_email: pgPaymentData.customer_email ?? '',
+            buyer_phone: pgPaymentData.customer_phone ?? '',
+            payment_method: paymentMethod,
+        };
+        const callbackUrl = window.location.origin + config.callback_urls.callback;
+
+        await preparePaymentRetry(closeReportContext);
+
+        if (isMobileDevice()) {
+            await handleMobilePayment(G7Core, pgPaymentData, paymentMethod, isEasyPay, callbackUrl);
+        } else {
+            await handlePcPayment(config, pgPaymentData, paymentMethod, isEasyPay, callbackUrl);
+        }
+
+    } catch (error: unknown) {
+        if (error instanceof KcpCancelledError) {
+            if (closeReportContext) {
+                await reportPaymentWindowClosed(closeReportContext, error.message || 'kcp-window-closed');
+            }
+            G7Core?.state?.setLocal?.({ isSubmittingOrder: false, paymentMethod });
+            return;
+        }
+
+        console.error('[sirsoft-pay_nhnkcp] requestPayment error', error);
+
+        // axios error 의 response.data 에서 사용자 친화적 메시지 추출.
+        // G7Core.api 는 axios 기반이라 4xx/5xx 응답은 자동 reject 됨 — generic
+        // "Request failed with status code 422" 가 아니라 Laravel ValidationException
+        // 의 message / errors 필드를 우선 사용.
+        const anyErr = error as { response?: { data?: { message?: string; error?: string; errors?: Record<string, string[]> } }; message?: string };
+        const responseData = anyErr?.response?.data;
+        const firstFieldError = responseData?.errors
+            ? Object.values(responseData.errors)[0]?.[0]
+            : undefined;
+        const errorMessage =
+            responseData?.error
+            ?? responseData?.message
+            ?? firstFieldError
+            ?? (error instanceof Error ? error.message : 'Unknown error');
+
+        G7Core?.state?.setLocal?.({ paymentErrorMessage: errorMessage, isSubmittingOrder: false, paymentMethod });
+        G7Core?.modal?.open?.('nhnkcp_payment_error_modal');
+    }
+}
+
+/**
+ * 모바일 결제 흐름
+ *
+ * 1) 서버에서 SOAP으로 approval_key + pay_url 획득
+ * 2) 전체 form fields를 받아 브라우저가 pay_url 로 POST 전환 (페이지 이동)
+ * 3) KCP가 결제 완료 후 Ret_URL(authCallback)로 redirect → 기존 서버 처리
+ */
+async function handleMobilePayment(
+    G7Core: any,
+    pgPaymentData: PgPaymentData,
+    paymentMethod: string,
+    isEasyPay: boolean,
+    callbackUrl: string,
+): Promise<void> {
+    const approvalJson = await G7Core.api.post('/plugins/sirsoft-pay_nhnkcp/mobile/approval-key', {
+        order_number: pgPaymentData.order_number,
+        amount: pgPaymentData.amount,
+        good_name: pgPaymentData.order_name,
+        pay_method: paymentMethod,
+        buyr_name: pgPaymentData.customer_name ?? '',
+        buyr_mail: pgPaymentData.customer_email ?? '',
+        buyr_tel1: pgPaymentData.customer_phone ?? '',
+        ret_url: callbackUrl,
+        currency: normalizeCurrency(pgPaymentData.currency),
+    });
+
+    if (!approvalJson.success || !approvalJson.data) {
+        // 서버 응답의 에러 메시지 우선순위:
+        //   1. ResponseHelper::error 의 'error' 필드 (커스텀)
+        //   2. Laravel ValidationException 의 'message' 필드 (422 응답 표준)
+        //   3. 'errors' 객체의 첫 번째 메시지 (필드별 validation 메시지)
+        //   4. fallback
+        const errors = approvalJson.errors as Record<string, string[]> | undefined;
+        const firstFieldError = errors ? Object.values(errors)[0]?.[0] : undefined;
+        throw new Error(
+            approvalJson.error
+                ?? approvalJson.message
+                ?? firstFieldError
+                ?? 'KCP 모바일 승인키 획득 실패',
+        );
+    }
+
+    const { pay_url, fields } = approvalJson.data as { pay_url: string; fields: Record<string, string> };
+
+    // 페이지 전환 form 생성 및 제출
+    const form = document.createElement('form');
+    form.method = 'POST';
+    form.action = pay_url;
+    form.acceptCharset = 'euc-kr'; // KCP 모바일은 EUC-KR 인코딩 필요
+    form.style.display = 'none';
+
+    for (const [name, value] of Object.entries(fields)) {
+        const input = document.createElement('input');
+        input.type = 'hidden';
+        input.name = name;
+        input.value = String(value);
+        form.appendChild(input);
+    }
+
+    document.body.appendChild(form);
+    form.submit();
+
+    // 페이지가 pay_url 로 이동하므로 Promise는 자연스럽게 중단됨
+    await new Promise<never>(() => {});
+}
+
+/**
+ * PC 결제 흐름
+ *
+ * Chrome 비동기 document.write() 차단을 우회하기 위해 iframe 내에서
+ * document.open/write/close 로 SDK를 동기 로드한 뒤 KCP_Pay_Execute() 호출.
+ */
+async function handlePcPayment(
+    config: ClientConfig,
+    pgPaymentData: PgPaymentData,
+    paymentMethod: string,
+    isEasyPay: boolean,
+    callbackUrl: string,
+): Promise<void> {
+    // 간편결제는 pay_method 항상 "100000000000" (카드 비트마스크), direct 파라미터로 수단 지정
+    const payMethod = isEasyPay
+        ? '100000000000'
+        : (KCP_PAY_METHOD[pgPaymentData.pay_method ?? 'card'] ?? '100000000000');
+
+    // PAYCO 전용 테스트 site_cd (S6729), 그 외 간편결제·에스크로·일반은 각자 site_cd 사용
+    const siteCd = paymentMethod === 'nhnkcp_payco'
+        ? (config.easy_pay_client_id ?? config.client_id)
+        : (config.use_escrow && !isEasyPay ? (config.escrow_client_id ?? config.client_id) : config.client_id);
+
+    const fields: Record<string, string> = {
+        site_cd: siteCd,
+        ordr_idxx: pgPaymentData.order_number,
+        good_name: pgPaymentData.order_name,
+        good_mny: String(pgPaymentData.amount),
+        buyr_name: pgPaymentData.customer_name ?? '',
+        buyr_mail: pgPaymentData.customer_email ?? '',
+        buyr_tel1: pgPaymentData.customer_phone ?? '',
+        pay_method: payMethod,
+        Ret_URL: callbackUrl,
+    };
+
+    Object.assign(fields, buildKcpTaxFields(pgPaymentData));
+    Object.assign(fields, buildKcpEasyPayReturnFields(paymentMethod, isEasyPay));
+
+    // 가상계좌 전용 파라미터
+    if (payMethod === '001000000000') {
+        fields['vcnt_expire_term'] = String(config.vbank_expire_days ?? 3);
+        fields['disp_tax_yn'] = 'N';
+    }
+
+    // 에스크로 결제 파라미터 (간편결제 제외)
+    if (config.use_escrow && !isEasyPay) {
+        fields['escw_used'] = 'Y';
+        fields['pay_mod'] = 'O';
+    }
+
+    // 간편결제: GNU5 규격과 동일하게 모든 direct 파라미터를 기본값("" 또는 "A")으로 초기화한 뒤
+    // 선택된 수단만 "Y"로 덮어씀 — 초기값이 없으면 KCP가 이전 요청값을 재사용할 수 있음
+    if (isEasyPay) {
+        // GNU5 규격: 모든 direct 파라미터를 기본값으로 초기화 후 선택된 수단만 Y로 덮어씀
+        fields['payco_direct']    = '';
+        fields['naverpay_direct'] = 'A';
+        fields['kakaopay_direct'] = 'A';
+        fields['applepay_direct'] = 'A';
+        const directOverride = KCP_EASY_PAY_DIRECT[paymentMethod];
+        if (directOverride) {
+            Object.assign(fields, directOverride);
+        }
+    }
+
+    const hiddenInputs = Object.entries(fields)
+        .map(([n, v]) => `<input type="hidden" name="${n}" value="${v.replace(/"/g, '&quot;')}">`)
+        .join('');
+
+    await new Promise<void>((resolve, reject) => {
+        // 기존 요소 정리
+        document.getElementById('kcp-sdk-iframe')?.remove();
+        document.getElementById('kcp-dim-overlay')?.remove();
+
+        // 메인 창에 반투명 dim 오버레이 (결제창 뒤 배경)
+        const overlay = document.createElement('div');
+        overlay.id = 'kcp-dim-overlay';
+        overlay.style.cssText = 'position:fixed;top:0;left:0;width:100%;height:100%;background:rgba(0,0,0,0.6);z-index:99998;';
+        document.body.appendChild(overlay);
+
+        // 투명 iframe - KCP 결제창이 내부에 렌더링됨
+        const iframe = document.createElement('iframe');
+        iframe.id = 'kcp-sdk-iframe';
+        iframe.setAttribute('allowtransparency', 'true');
+        iframe.style.cssText = 'position:fixed;top:0;left:0;width:100%;height:100%;border:0;z-index:99999;background:transparent;';
+        document.body.appendChild(iframe);
+
+        const iframeWin = iframe.contentWindow as any;
+        let settled = false;
+        let sdkLoadTimer: number | undefined;
+        let stopCloseWatcher: (() => void) | undefined;
+
+        const cleanup = () => {
+            stopCloseWatcher?.();
+            stopCloseWatcher = undefined;
+            if (sdkLoadTimer !== undefined) {
+                clearTimeout(sdkLoadTimer);
+                sdkLoadTimer = undefined;
+            }
+            iframe.remove();
+            overlay.remove();
+        };
+
+        const rejectOnce = (error: Error) => {
+            if (settled) {
+                return;
+            }
+
+            settled = true;
+            cleanup();
+            reject(error);
+        };
+
+        const markCompletingPayment = () => {
+            settled = true;
+            stopCloseWatcher?.();
+            stopCloseWatcher = undefined;
+            if (sdkLoadTimer !== undefined) {
+                clearTimeout(sdkLoadTimer);
+                sdkLoadTimer = undefined;
+            }
+        };
+
+        stopCloseWatcher = watchKcpPaymentFrameClosure(iframe, () => {
+            rejectOnce(new KcpCancelledError('kcp-payment-frame-closed'));
+        });
+
+        // 결제 완료 콜백 - KCP가 결제 후 호출
+        iframeWin.m_Completepayment = function (form: HTMLFormElement) {
+            const resCode = (form.elements as any)['res_cd']?.value ?? '';
+            const resMsg  = (form.elements as any)['res_msg']?.value ?? '';
+
+            if (resCode === '0000') {
+                markCompletingPayment();
+
+                // GNU5 패턴(GetField): KCP 결과를 order_info에 병합 후 order_info를 POST.
+                // KakaoPay 등 direct 결제에서 KCP가 ordr_idxx 없는 새 폼을 전달하므로
+                // form을 그대로 제출하면 서버 검증 실패(invalid_params).
+                // order_info(우리 주문 필드 포함)를 기준으로 병합해야 한다.
+                const orderForm = iframeWin.document.forms.namedItem('order_info') as HTMLFormElement | null;
+                const targetForm = (orderForm && orderForm !== form) ? orderForm : form;
+
+                if (orderForm && orderForm !== form) {
+                    for (let i = 0; i < form.elements.length; i++) {
+                        const el = form.elements[i] as HTMLInputElement;
+                        if (!el.name) continue;
+                        let dest = orderForm.elements.namedItem(el.name) as HTMLInputElement | null;
+                        if (!dest) {
+                            dest = iframeWin.document.createElement('input') as HTMLInputElement;
+                            dest.type = 'hidden';
+                            dest.name = el.name;
+                            orderForm.appendChild(dest);
+                        }
+                        dest.value = el.value;
+                    }
+                }
+
+                targetForm.action = callbackUrl;
+                targetForm.method = 'POST';
+                targetForm.target = '_top';
+                iframeWin.document.body.appendChild(targetForm);
+                targetForm.submit();
+            } else {
+                // 취소 또는 오류
+                const isCancelled = resCode === '' || resCode === '7777' || resMsg.includes('취소');
+                rejectOnce(isCancelled ? new KcpCancelledError(resMsg) : new Error(`KCP 오류 [${resCode}]: ${resMsg}`));
+            }
+        };
+
+        iframeWin.__kcpFail = (err: Error) => {
+            rejectOnce(err);
+        };
+
+        // SDK 동기 로드 + KCP_Pay_Execute 호출
+        const iframeDoc = (iframe.contentDocument || iframeWin.document) as Document;
+        iframeDoc.open();
+        iframeDoc.write(`<!DOCTYPE html><html><head>
+<script src="${config.sdk_url}"><\/script>
+</head><body style="margin:0;padding:0;background:transparent;">
+<form name="order_info">${hiddenInputs}</form>
+<script>
+try {
+  if (typeof KCP_Pay_Execute === 'function') {
+    KCP_Pay_Execute(document.forms['order_info']);
+    window.__kcpReady && window.__kcpReady();
+  } else {
+    window.__kcpFail && window.__kcpFail(new Error('KCP_Pay_Execute not defined'));
+  }
+} catch(e) {
+  window.__kcpFail && window.__kcpFail(e);
+}
+<\/script>
+</body></html>`);
+        iframeDoc.close();
+
+        // SDK 로드 실패 대비 타임아웃 — 결제창이 열리면(__kcpReady) 즉시 해제됨
+        sdkLoadTimer = window.setTimeout(() => {
+            rejectOnce(new Error('KCP SDK load timeout'));
+        }, 15000);
+
+        iframeWin.__kcpReady = () => {
+            if (sdkLoadTimer !== undefined) {
+                clearTimeout(sdkLoadTimer);
+                sdkLoadTimer = undefined;
+            }
+        };
+    });
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/handlers/setPaymentMethod.ts b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/handlers/setPaymentMethod.ts
new file mode 100644
index 00000000..d91963c2
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/handlers/setPaymentMethod.ts
@@ -0,0 +1,76 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+
+import {
+    applePayUnsupportedMessage,
+    isIosMobileDevice,
+    isNhnKcpApplePayMethod,
+} from '../support/applePayDevice';
+
+const METHOD_TO_TEXT: Record<string, string> = {
+    nhnkcp_payco:          'PAYCO',
+    nhnkcp_naverpay:       '네이버페이',
+    nhnkcp_naverpay_point: '네이버페이 포인트',
+    nhnkcp_kakaopay:       '카카오페이',
+    nhnkcp_applepay:       'Apple Pay',
+};
+
+const SELECTED_SHADOW = '0 0 0 2px #ffffff, 0 0 0 5px rgba(0,0,0,0.55)';
+
+function getEasyPayButtonContainer(): Element | null {
+    const section = document.querySelector('.nhnkcp-easy-pay-btns');
+    return section ?? null;
+}
+
+function clearEasyPayButtonStyles(): void {
+    const container = getEasyPayButtonContainer();
+    if (!container) return;
+    container.querySelectorAll<HTMLButtonElement>('button').forEach(btn => {
+        btn.style.boxShadow = '';
+        btn.style.outline = '';
+    });
+}
+
+function updateEasyPayButtonStyles(selectedMethod: string): void {
+    const container = getEasyPayButtonContainer();
+    if (!container) return;
+
+    const selectedText = METHOD_TO_TEXT[selectedMethod];
+    container.querySelectorAll<HTMLButtonElement>('button').forEach(btn => {
+        if (btn.textContent?.trim() === selectedText) {
+            btn.style.boxShadow = SELECTED_SHADOW;
+            btn.style.outline = 'none';
+        } else {
+            btn.style.boxShadow = '';
+            btn.style.outline = '';
+        }
+    });
+}
+
+export function setPaymentMethodHandler(action: any): void {
+    const paymentMethod = action.params?.paymentMethod;
+    if (!paymentMethod) return;
+
+    const G7Core = (window as any).G7Core;
+    if (isNhnKcpApplePayMethod(paymentMethod) && !isIosMobileDevice()) {
+        const message = applePayUnsupportedMessage();
+        G7Core?.state?.setLocal?.({
+            paymentErrorMessage: message,
+            isSubmittingOrder: false,
+        });
+        G7Core?.modal?.open?.('nhnkcp_payment_error_modal');
+        clearEasyPayButtonStyles();
+        return;
+    }
+
+    const isEasyPay = typeof paymentMethod === 'string' && paymentMethod.startsWith('nhnkcp_');
+    G7Core?.state?.setLocal?.({
+        paymentMethod,
+        serverPaymentMethod: isEasyPay ? 'card' : paymentMethod,
+    });
+
+    if (isEasyPay) {
+        updateEasyPayButtonStyles(paymentMethod);
+    } else {
+        clearEasyPayButtonStyles();
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/index.ts b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/index.ts
new file mode 100644
index 00000000..f553c68f
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/index.ts
@@ -0,0 +1,111 @@
+import { handlerMap } from './handlers';
+import { installOrderResponseInterceptor } from './orderResponseInterceptor';
+import { installOrderCompleteReceiptInjector } from './orderCompleteReceiptInjector';
+import { installMypageOrderShowInjector } from './mypageOrderShowInjector';
+import { installCheckoutEasyPayInjector } from './checkoutEasyPayInjector';
+import { installAdminApplePayNoticeInjector } from './adminApplePayNoticeInjector';
+import { installAdminPaymentMethodBrandInjector } from './adminPaymentMethodBrandInjector';
+import { installAdminOrderPaymentDisplayInjector } from './adminOrderPaymentDisplayInjector';
+
+class KcpReceiptPopup {
+    constructor(params: { url?: string; cash_url?: string }) {
+        const features = 'width=800,height=600,scrollbars=yes,resizable=yes,toolbar=no,menubar=no';
+        if (params.url) {
+            window.open(params.url, 'kcp_receipt', features);
+        }
+        if (params.cash_url) {
+            window.open(params.cash_url, 'kcp_cash_receipt', features);
+        }
+    }
+}
+(window as Record<string, unknown>).KcpReceiptPopup = KcpReceiptPopup;
+
+const PLUGIN_IDENTIFIER = 'sirsoft-pay_nhnkcp';
+
+const logger = {
+    info: (...args: unknown[]) => console.info(`[${PLUGIN_IDENTIFIER}]`, ...args),
+    warn: (...args: unknown[]) => console.warn(`[${PLUGIN_IDENTIFIER}]`, ...args),
+    error: (...args: unknown[]) => console.error(`[${PLUGIN_IDENTIFIER}]`, ...args),
+};
+
+function registerHandlers(): number {
+    const g7Core = (window as Record<string, unknown>).G7Core as Record<string, unknown> | undefined;
+
+    if (!g7Core) {
+        return 0;
+    }
+
+    const getDispatcher = g7Core.getActionDispatcher as (() => Record<string, unknown>) | undefined;
+
+    if (typeof getDispatcher !== 'function') {
+        return 0;
+    }
+
+    const dispatcher = getDispatcher() as Record<string, unknown> | undefined;
+
+    if (!dispatcher || typeof dispatcher.registerHandler !== 'function') {
+        return 0;
+    }
+
+    let count = 0;
+    for (const [name, handler] of Object.entries(handlerMap)) {
+        const fullName = `${PLUGIN_IDENTIFIER}.${name}`;
+        dispatcher.registerHandler(fullName, handler, {
+            category: 'plugin',
+            source: PLUGIN_IDENTIFIER,
+        });
+        count++;
+    }
+
+    return count;
+}
+
+function initPlugin(): void {
+    const doInit = () => {
+        const count = registerHandlers();
+
+        if (count > 0) {
+            logger.info(`${count} handler(s) registered`);
+            return;
+        }
+
+        let retries = 0;
+        const maxRetries = 50;
+        const interval = setInterval(() => {
+            retries++;
+            const result = registerHandlers();
+
+            if (result > 0) {
+                clearInterval(interval);
+                logger.info(`${result} handler(s) registered (after ${retries} retries)`);
+                return;
+            }
+
+            if (retries >= maxRetries) {
+                clearInterval(interval);
+                logger.warn('ActionDispatcher not available after timeout');
+            }
+        }, 100);
+    };
+
+    if (document.readyState === 'loading') {
+        document.addEventListener('DOMContentLoaded', doInit);
+    } else {
+        doInit();
+    }
+}
+
+installOrderResponseInterceptor();
+installOrderCompleteReceiptInjector();
+installMypageOrderShowInjector();
+installCheckoutEasyPayInjector();
+installAdminApplePayNoticeInjector();
+installAdminPaymentMethodBrandInjector();
+installAdminOrderPaymentDisplayInjector();
+initPlugin();
+
+(window as Record<string, unknown>).__SirsoftNhnkcp = {
+    identifier: PLUGIN_IDENTIFIER,
+    handlers: Object.keys(handlerMap),
+    initPlugin,
+};
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/mypageOrderShowInjector.ts b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/mypageOrderShowInjector.ts
new file mode 100644
index 00000000..79de24f9
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/mypageOrderShowInjector.ts
@@ -0,0 +1,409 @@
+const PLUGIN_ID = 'sirsoft-pay_nhnkcp';
+const FLAG = '__kcpMpShowInjectorInstalled';
+const VBANK_ID = 'kcp-mp-vbank-row';
+const ROW_ID = 'kcp-mp-receipt-row';
+const MOCK_DEPOSIT_ID = 'kcp-mp-mock-deposit';
+
+const ORDER_SHOW_RE = /^\/mypage\/orders\/([^/]+)$/;
+
+interface Payment {
+    pg_provider?: string;
+    payment_method?: string;
+    transaction_id?: string | null;
+    paid_at?: string | null;
+    vbank_name?: string;
+    vbank_number?: string;
+    vbank_holder?: string;
+    due_date_formatted?: string;
+    [key: string]: unknown;
+}
+
+interface OrderData {
+    order_number?: string;
+    total_amount_formatted?: string;
+    payment?: Payment;
+}
+
+function getOrderFromState(orderNumber: string): OrderData | null {
+    try {
+        const g7 = (window as unknown as Record<string, unknown>).G7Core as Record<string, unknown> | undefined;
+        const getState = g7?.getState as (() => Record<string, unknown>) | undefined;
+        const ctx = getState?.()?.currentDataContext as Record<string, unknown> | undefined;
+        const order = ctx?.order as { data?: OrderData } | undefined;
+        const data = order?.data;
+        if (!data || data.order_number !== orderNumber) return null;
+        return data;
+    } catch {
+        return null;
+    }
+}
+
+function getToken(): string | null {
+    return localStorage.getItem('auth_token');
+}
+
+interface ReceiptInfo {
+    receipt_url?: string;
+    cash_receipt_url?: string | null;
+    payment_method_display_label?: string | null;
+}
+
+async function fetchReceiptUrls(orderNumber: string): Promise<ReceiptInfo | null> {
+    const token = getToken();
+    if (!token) return null;
+    try {
+        const res = await fetch(`/api/plugins/${PLUGIN_ID}/user/orders/${orderNumber}/receipt`, {
+            headers: { Authorization: `Bearer ${token}`, Accept: 'application/json' },
+        });
+        if (!res.ok) return null;
+        return (await res.json()) as ReceiptInfo;
+    } catch {
+        return null;
+    }
+}
+
+interface MockDepositInfo {
+    available: boolean;
+    trade_no?: string;
+    account_no?: string;
+    notify_url?: string;
+    mock_url?: string;
+    is_admin_view?: boolean;
+}
+
+async function fetchMockDepositInfo(orderNumber: string): Promise<MockDepositInfo | null> {
+    const token = getToken();
+    if (!token) return null;
+    try {
+        const res = await fetch(`/api/plugins/${PLUGIN_ID}/user/orders/${orderNumber}/vbank-mock-deposit-info`, {
+            headers: { Authorization: `Bearer ${token}`, Accept: 'application/json' },
+        });
+        if (!res.ok) return null;
+        return (await res.json()) as MockDepositInfo;
+    } catch {
+        return null;
+    }
+}
+
+function buildMockDepositBlock(info: MockDepositInfo): HTMLElement {
+    const wrap = document.createElement('div');
+    wrap.id = MOCK_DEPOSIT_ID;
+    wrap.className = 'pt-4 mt-2 border-t border-dashed border-orange-300 dark:border-orange-700';
+
+    const header = document.createElement('div');
+    header.className = 'flex items-center gap-2 mb-3';
+
+    const badge = document.createElement('span');
+    badge.className = 'inline-flex items-center px-2 py-0.5 rounded text-xs font-bold bg-orange-100 text-orange-700 dark:bg-orange-900/40 dark:text-orange-300 border border-orange-300 dark:border-orange-700';
+    badge.textContent = 'TEST';
+
+    const title = document.createElement('p');
+    title.className = 'text-sm font-semibold text-orange-700 dark:text-orange-300';
+    title.textContent = '모의입금처리';
+
+    header.appendChild(badge);
+    header.appendChild(title);
+
+    const form = document.createElement('form');
+    form.method = 'POST';
+    form.action = info.mock_url ?? '';
+    form.target = '_blank';
+    form.className = 'space-y-2';
+
+    const fields: Array<{ label: string; name: string; value: string; editable?: boolean }> = [
+        { label: 'KCP 거래번호', name: 'e_trade_no', value: info.trade_no ?? '' },
+        { label: '입금계좌',    name: 'deposit_no',  value: info.account_no ?? '' },
+        { label: '입금자명',    name: 'req_name',    value: 'NHN KCP', editable: true },
+        { label: '입금통보 URL', name: 'noti_url',   value: info.notify_url ?? '' },
+    ];
+
+    for (const f of fields) {
+        const row = document.createElement('div');
+        row.className = 'flex items-center gap-2 text-sm';
+
+        const lbl = document.createElement('span');
+        lbl.className = 'w-28 flex-shrink-0 text-gray-500 dark:text-gray-400 text-xs';
+        lbl.textContent = f.label;
+
+        const input = document.createElement('input');
+        input.type = 'text';
+        input.name = f.name;
+        input.value = f.value;
+        input.readOnly = !f.editable;
+        input.className = f.editable
+            ? 'flex-1 px-2 py-1 text-xs border border-gray-300 dark:border-gray-600 rounded bg-white dark:bg-gray-700 text-gray-900 dark:text-white font-mono'
+            : 'flex-1 px-2 py-1 text-xs border border-gray-200 dark:border-gray-700 rounded bg-gray-50 dark:bg-gray-800 text-gray-700 dark:text-gray-300 font-mono';
+
+        row.appendChild(lbl);
+        row.appendChild(input);
+        form.appendChild(row);
+    }
+
+    const submitRow = document.createElement('div');
+    submitRow.className = 'pt-1';
+
+    const btn = document.createElement('button');
+    btn.type = 'submit';
+    btn.className = 'w-full py-1.5 text-xs font-semibold rounded border border-orange-400 dark:border-orange-600 bg-orange-50 dark:bg-orange-900/30 text-orange-700 dark:text-orange-300 hover:bg-orange-100 dark:hover:bg-orange-900/50 transition-colors';
+    btn.textContent = '입금통보 테스트';
+
+    submitRow.appendChild(btn);
+    form.appendChild(submitRow);
+
+    wrap.appendChild(header);
+    wrap.appendChild(form);
+
+    if (info.is_admin_view) {
+        const adminNotice = document.createElement('p');
+        adminNotice.className = 'mt-2 text-xs text-center text-orange-500 dark:text-orange-400 font-medium';
+        adminNotice.textContent = '관리자에게만 출력되는 내용';
+        wrap.appendChild(adminNotice);
+    }
+
+    return wrap;
+}
+
+function findPaymentRowsContainer(): Element | null {
+    const panel = document.getElementById('order_payment_info_panel');
+    if (panel) {
+        const spaceY = Array.from(panel.children).find(el => el.className?.includes('space-y'));
+        return spaceY ?? panel;
+    }
+
+    // "결제 정보" 헤딩 탐색
+    const h3 = Array.from(document.querySelectorAll<HTMLElement>('h3')).find(
+        el => el.textContent?.includes('결제 정보'),
+    );
+    if (!h3) return null;
+
+    const panelDiv = h3.parentElement?.parentElement;
+    if (!panelDiv) return null;
+
+    const spaceY = Array.from(panelDiv.children).find(el => el.className?.includes('space-y'));
+    return spaceY ?? panelDiv;
+}
+
+// 라벨 + 값 행 생성 헬퍼
+function makeInfoRow(label: string, value: string, valueClass = 'font-medium text-gray-900 dark:text-white'): HTMLElement {
+    const row = document.createElement('div');
+    row.className = 'flex items-center justify-between text-sm';
+
+    const lbl = document.createElement('span');
+    lbl.className = 'text-gray-500 dark:text-gray-400';
+    lbl.textContent = label;
+
+    const val = document.createElement('span');
+    val.className = valueClass;
+    val.textContent = value;
+
+    row.appendChild(lbl);
+    row.appendChild(val);
+    return row;
+}
+
+export function patchMypagePaymentMethodDisplay(container: Element, displayLabel: string | null | undefined): boolean {
+    if (!displayLabel) return false;
+
+    const rows = Array.from(container.querySelectorAll<HTMLElement>('div'));
+    for (const row of rows) {
+        const spans = Array.from(row.children).filter(
+            (child): child is HTMLElement => child instanceof HTMLElement && child.tagName === 'SPAN',
+        );
+        if (spans.length < 2) continue;
+
+        const label = spans[0].textContent?.trim();
+        if (label !== '결제 방법' && label !== '결제수단' && label !== 'Payment Method') continue;
+
+        const value = spans[spans.length - 1];
+        if (value.textContent?.trim() === displayLabel) {
+            row.dataset.nhnkcpPaymentMethodRow = 'true';
+            return true;
+        }
+
+        value.textContent = displayLabel;
+        value.dataset.nhnkcpPaymentMethodPatched = 'true';
+        row.dataset.nhnkcpPaymentMethodRow = 'true';
+        return true;
+    }
+
+    return false;
+}
+
+function buildVbankInfoBlock(payment: Payment, totalAmountFormatted: string): HTMLElement {
+    const wrap = document.createElement('div');
+    wrap.id = VBANK_ID;
+    wrap.className = 'pt-4 mt-2 border-t border-gray-200 dark:border-gray-700 space-y-3';
+
+    const title = document.createElement('p');
+    title.className = 'text-sm font-semibold text-gray-800 dark:text-gray-200';
+    title.textContent = '가상계좌 입금 안내';
+
+    const rows = document.createElement('div');
+    rows.className = 'space-y-1.5';
+    rows.appendChild(makeInfoRow('은행', payment.vbank_name ?? ''));
+    rows.appendChild(makeInfoRow('계좌번호', payment.vbank_number ?? '', 'font-medium text-gray-900 dark:text-white font-mono tracking-wide'));
+    rows.appendChild(makeInfoRow('예금주', payment.vbank_holder ?? ''));
+    rows.appendChild(makeInfoRow('입금 금액', totalAmountFormatted));
+    if (payment.due_date_formatted) {
+        rows.appendChild(makeInfoRow('입금 기한', payment.due_date_formatted));
+    }
+
+    const notice = document.createElement('p');
+    notice.className = 'text-xs text-amber-600 dark:text-amber-400';
+    notice.textContent = '입금 기한 내에 입금하지 않으시면 주문이 자동 취소됩니다.';
+
+    wrap.appendChild(title);
+    wrap.appendChild(rows);
+    wrap.appendChild(notice);
+    return wrap;
+}
+
+function buildReceiptRow(orderNumber: string): HTMLElement {
+    const row = document.createElement('div');
+    row.id = ROW_ID;
+    row.className = 'pt-4 mt-2 border-t border-gray-200 dark:border-gray-700';
+
+    const inner = document.createElement('div');
+    inner.className = 'flex items-center justify-between';
+
+    const label = document.createElement('span');
+    label.className = 'text-gray-500 dark:text-gray-400 text-sm';
+    label.textContent = '영수증';
+
+    const btn = document.createElement('button');
+    btn.type = 'button';
+    btn.className = 'inline-flex items-center gap-1 text-sm text-blue-600 dark:text-blue-400 hover:underline disabled:opacity-50';
+    btn.textContent = '영수증 조회';
+
+    btn.addEventListener('click', async () => {
+        btn.disabled = true;
+        btn.textContent = '로딩 중...';
+        const data = await fetchReceiptUrls(orderNumber);
+        btn.disabled = false;
+        btn.textContent = '영수증 조회';
+        if (data) {
+            const KcpPopup = (window as unknown as Record<string, unknown>).KcpReceiptPopup as
+                (new (p: { url?: string; cash_url?: string }) => unknown) | undefined;
+            if (KcpPopup) {
+                new KcpPopup({ url: data.receipt_url, cash_url: data.cash_receipt_url });
+            }
+        }
+    });
+
+    inner.appendChild(label);
+    inner.appendChild(btn);
+    row.appendChild(inner);
+    return row;
+}
+
+async function tryInject(orderNumber: string): Promise<boolean> {
+    const orderData = getOrderFromState(orderNumber);
+
+    if (!orderData) {
+        // ctx.order가 null — 관리자가 타인 주문 열람 시 mypage API 404로 상태 없음.
+        // 컨테이너가 렌더링됐으면 모의입금 API만 직접 시도 후 종료.
+        if (!document.getElementById(MOCK_DEPOSIT_ID)) {
+            const container = findPaymentRowsContainer();
+            if (!container) return false; // 컨테이너 미렌더링 → 재시도
+            const info = await fetchMockDepositInfo(orderNumber);
+            if (info?.available) {
+                container.appendChild(buildMockDepositBlock(info));
+                console.info(`[${PLUGIN_ID}] mock deposit form injected on mypage order show`);
+            }
+        }
+        return true;
+    }
+
+    const { payment } = orderData;
+    if (!payment || payment.pg_provider !== 'nhnkcp') return true; // nhnkcp 아님
+
+    const needsVbank = payment.payment_method === 'vbank' && !!payment.vbank_name;
+    // 영수증 버튼은 결제완료(paid_at 채워짐) 시점에만 표시 — 가상계좌 입금대기 상태 차단
+    const needsReceipt = !!payment.transaction_id && !!payment.paid_at;
+    // 가상계좌 계좌번호가 발급된 경우 API로 모의입금 가능 여부 확인 (tno는 서버에서 fallback)
+    const mightNeedMock = payment.payment_method === 'vbank' && !!payment.vbank_number;
+
+    const vbankDone    = !needsVbank    || !!document.getElementById(VBANK_ID);
+    const receiptDone  = !needsReceipt  || !!document.getElementById(ROW_ID);
+    // 모의입금은 API 결과에 따라 달라지므로 DOM에 없으면 매번 체크
+    const mockDone     = !mightNeedMock || !!document.getElementById(MOCK_DEPOSIT_ID);
+
+    if (vbankDone && receiptDone && mockDone) return true;
+
+    const container = findPaymentRowsContainer();
+    if (!container) return false; // DOM 미렌더링 → 재시도
+
+    const receiptInfo = needsReceipt ? await fetchReceiptUrls(orderNumber) : null;
+    const displayPatched = patchMypagePaymentMethodDisplay(
+        container,
+        receiptInfo?.payment_method_display_label,
+    );
+
+    if (!document.getElementById(VBANK_ID) && needsVbank) {
+        container.appendChild(buildVbankInfoBlock(payment, orderData.total_amount_formatted ?? ''));
+        console.info(`[${PLUGIN_ID}] vbank info injected on mypage order show`);
+        return false;
+    }
+
+    if (!document.getElementById(ROW_ID) && needsReceipt) {
+        container.appendChild(buildReceiptRow(orderNumber));
+        console.info(`[${PLUGIN_ID}] receipt button injected on mypage order show`);
+        return false;
+    }
+
+    if (displayPatched) {
+        console.info(`[${PLUGIN_ID}] payment method display patched on mypage order show`);
+    }
+
+    if (!document.getElementById(MOCK_DEPOSIT_ID) && mightNeedMock) {
+        const info = await fetchMockDepositInfo(orderNumber);
+        if (info?.available) {
+            container.appendChild(buildMockDepositBlock(info));
+            console.info(`[${PLUGIN_ID}] mock deposit form injected on mypage order show`);
+        } else {
+            // 테스트 모드 아님 or 조건 불충족 — 더 이상 시도 불필요
+            return true;
+        }
+    }
+
+    return true;
+}
+
+function startPolling(orderNumber: string): void {
+    let attempts = 0;
+    const id = setInterval(() => {
+        attempts++;
+        void tryInject(orderNumber).then(done => {
+            if (done || attempts >= 30) clearInterval(id);
+        });
+    }, 400);
+}
+
+function onRouteChange(): void {
+    const match = location.pathname.match(ORDER_SHOW_RE);
+    if (match) startPolling(match[1]);
+}
+
+export function installMypageOrderShowInjector(): void {
+    if (typeof window === 'undefined') return;
+    const w = window as unknown as Record<string, unknown>;
+    if (w[FLAG]) return;
+    w[FLAG] = true;
+
+    console.info(`[${PLUGIN_ID}] mypage order show injector installed`);
+
+    const schedule = (delay = 1500) => setTimeout(onRouteChange, delay);
+
+    if (document.readyState === 'loading') {
+        document.addEventListener('DOMContentLoaded', () => schedule());
+    } else {
+        schedule();
+    }
+
+    const origPush = history.pushState.bind(history);
+    history.pushState = (...args: Parameters<typeof history.pushState>) => {
+        origPush(...args);
+        schedule(600);
+    };
+    window.addEventListener('popstate', () => schedule(500));
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/orderCompleteReceiptInjector.ts b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/orderCompleteReceiptInjector.ts
new file mode 100644
index 00000000..99834685
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/orderCompleteReceiptInjector.ts
@@ -0,0 +1,185 @@
+const PLUGIN_ID = 'sirsoft-pay_nhnkcp';
+const FLAG = '__kcpOcReceiptInjectorInstalled';
+const BTN_ID = 'kcp-oc-receipt-btn';
+
+const ORDER_COMPLETE_RE = /^\/shop\/orders\/([^/]+)\/complete$/;
+
+type Payment = {
+    pg_provider: string;
+    transaction_id: string | null;
+    paid_at: string | null;
+    [key: string]: unknown;
+};
+
+function getToken(): string | null {
+    return localStorage.getItem('auth_token');
+}
+
+async function fetchPayment(orderNumber: string): Promise<Payment | null> {
+    const token = getToken();
+    if (!token) return null;
+
+    try {
+        const res = await fetch(`/api/modules/sirsoft-ecommerce/user/orders/${orderNumber}`, {
+            headers: { Authorization: `Bearer ${token}`, Accept: 'application/json' },
+        });
+        if (!res.ok) return null;
+        const data = (await res.json()) as { data?: { payment?: Payment } };
+        return data?.data?.payment ?? null;
+    } catch {
+        return null;
+    }
+}
+
+interface ReceiptInfo {
+    receipt_url: string;
+    cash_receipt_url: string | null;
+    payment_method_display_label?: string | null;
+}
+
+async function fetchReceiptUrl(orderNumber: string): Promise<ReceiptInfo | null> {
+    const token = getToken();
+    if (!token) return null;
+
+    try {
+        const res = await fetch(`/api/plugins/${PLUGIN_ID}/user/orders/${orderNumber}/receipt`, {
+            headers: { Authorization: `Bearer ${token}`, Accept: 'application/json' },
+        });
+        if (!res.ok) return null;
+        return (await res.json()) as ReceiptInfo;
+    } catch {
+        return null;
+    }
+}
+
+function makeBtn(text: string, classes: string, onClick: (btn: HTMLButtonElement) => void): HTMLButtonElement {
+    const btn = document.createElement('button');
+    btn.type = 'button';
+    btn.className = classes;
+    btn.textContent = text;
+    btn.addEventListener('click', () => onClick(btn));
+    return btn;
+}
+
+function patchPaymentMethodDisplay(displayLabel: string | null | undefined): boolean {
+    if (!displayLabel) return false;
+
+    const rows = Array.from(document.querySelectorAll<HTMLElement>('div'));
+    for (const row of rows) {
+        const spans = Array.from(row.children).filter(
+            (child): child is HTMLElement => child instanceof HTMLElement && child.tagName === 'SPAN',
+        );
+        if (spans.length < 2) continue;
+
+        const label = spans[0].textContent?.trim();
+        if (label !== '결제 방법' && label !== '결제수단' && label !== '결제 방식') continue;
+
+        const value = spans[spans.length - 1];
+        if (value.textContent?.trim() === displayLabel) {
+            row.dataset.nhnkcpPaymentMethodRow = 'true';
+            return true;
+        }
+
+        value.textContent = displayLabel;
+        value.dataset.nhnkcpPaymentMethodPatched = 'true';
+        row.dataset.nhnkcpPaymentMethodRow = 'true';
+        return true;
+    }
+
+    return false;
+}
+
+// 주문완료 페이지 버튼 영역에 영수증 버튼 주입
+async function injectOnOrderComplete(orderNumber: string): Promise<void> {
+    if (document.getElementById(BTN_ID)) return;
+
+    const payment = await fetchPayment(orderNumber);
+    // 입금완료(paid_at 채워짐) 시점에만 영수증 버튼 표시.
+    // 가상계좌 발급 시 transaction_id 는 채워지지만 paid_at 은 null 이므로 입금대기 상태에선 미노출.
+    if (!payment || payment.pg_provider !== 'nhnkcp' || !payment.transaction_id || !payment.paid_at) return;
+
+    // "주문 상세 보기" 버튼 찾기 (bg-blue-600)
+    const blueBtn = Array.from(document.querySelectorAll<HTMLButtonElement>('button[type="button"]'))
+        .find(b => b.className.includes('bg-blue-600'));
+
+    if (!blueBtn?.parentElement) return;
+
+    const receiptInfo = await fetchReceiptUrl(orderNumber);
+    patchPaymentMethodDisplay(receiptInfo?.payment_method_display_label);
+
+    const container = blueBtn.parentElement;
+
+    const receiptBtn = makeBtn('영수증 조회', blueBtn.className.replace(/bg-blue-\d+/g, 'bg-green-600').replace(/hover:bg-blue-\d+/g, 'hover:bg-green-700'), async (btn) => {
+        btn.disabled = true;
+        btn.textContent = '로딩 중...';
+        const data = await fetchReceiptUrl(orderNumber);
+        btn.disabled = false;
+        btn.textContent = '영수증 조회';
+        if (data) {
+            const KcpPopup = (window as unknown as Record<string, unknown>).KcpReceiptPopup as
+                (new (p: { url?: string; cash_url?: string }) => unknown) | undefined;
+            if (KcpPopup) new KcpPopup({ url: data.receipt_url ?? undefined });
+        }
+    });
+    receiptBtn.id = BTN_ID;
+
+    // "쇼핑 계속하기" 버튼 앞에 삽입
+    const lastBtn = container.lastElementChild;
+    container.insertBefore(receiptBtn, lastBtn);
+
+    // 현금영수증 버튼 (가상계좌/계좌이체)
+    const cashBtnId = 'kcp-oc-cash-receipt-btn';
+    if (!document.getElementById(cashBtnId) && (payment.payment_method === 'vbank' || payment.payment_method === 'bank_transfer')) {
+        const cashBtn = makeBtn('현금영수증 조회', receiptBtn.className.replace(/bg-green-\d+/g, 'bg-teal-600').replace(/hover:bg-green-\d+/g, 'hover:bg-teal-700'), async (btn) => {
+            btn.disabled = true;
+            btn.textContent = '로딩 중...';
+            const data = await fetchReceiptUrl(orderNumber);
+            btn.disabled = false;
+            btn.textContent = '현금영수증 조회';
+            if (data) {
+                const KcpPopup = (window as unknown as Record<string, unknown>).KcpReceiptPopup as
+                    (new (p: { url?: string; cash_url?: string }) => unknown) | undefined;
+                if (KcpPopup) new KcpPopup({ cash_url: data.cash_receipt_url ?? undefined });
+            }
+        });
+        cashBtn.id = cashBtnId;
+        container.insertBefore(cashBtn, lastBtn);
+    }
+
+    console.info(`[${PLUGIN_ID}] receipt button injected on order complete page`);
+}
+
+function tryInject(): void {
+    const path = location.pathname;
+    const ocMatch = path.match(ORDER_COMPLETE_RE);
+    if (ocMatch) {
+        void injectOnOrderComplete(ocMatch[1]);
+    }
+    // 마이페이지 주문상세는 mypageOrderShowInjector가 처리
+}
+
+export function installOrderCompleteReceiptInjector(): void {
+    if (typeof window === 'undefined') return;
+    const w = window as Record<string, unknown>;
+    if (w[FLAG]) return;
+    w[FLAG] = true;
+
+    console.info(`[${PLUGIN_ID}] order complete receipt injector installed`);
+
+    const schedule = (delay = 1200) => setTimeout(tryInject, delay);
+
+    // 현재 페이지 즉시 처리
+    if (document.readyState === 'loading') {
+        document.addEventListener('DOMContentLoaded', () => schedule());
+    } else {
+        schedule();
+    }
+
+    // SPA 네비게이션 감지
+    const origPush = history.pushState.bind(history);
+    history.pushState = (...args: Parameters<typeof history.pushState>) => {
+        origPush(...args);
+        schedule();
+    };
+    window.addEventListener('popstate', () => schedule(500));
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/orderResponseInterceptor.ts b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/orderResponseInterceptor.ts
new file mode 100644
index 00000000..50e2b7ca
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/orderResponseInterceptor.ts
@@ -0,0 +1,295 @@
+/**
+ * 주문 생성 API 응답 인터셉터
+ *
+ * 체크아웃 템플릿(_checkout_summary.json)에는 'sirsoft-tosspayments' 분기만
+ * 정의되어 있어서, 'sirsoft-nhnkcp' PG는 navigate 기본 분기로 떨어져
+ * /shop/orders/{order_number}/complete 로 이동해버림 (결제창 미노출).
+ *
+ * 코어/템플릿 수정 없이 이 문제를 우회하기 위해 plugin loading 시점에
+ * window.fetch 를 래핑해 다음을 수행:
+ *
+ *   1. POST /api/modules/sirsoft-ecommerce/user/orders 요청 body에서
+ *      nhnkcp_* 간편결제 수단을 'card'로 교체 후 서버 전송
+ *   2. 응답에서 data.pg_provider === 'sirsoft-nhnkcp' 이면
+ *      requestPayment 핸들러를 직접 호출하여 결제창 띄움
+ *   3. data.redirect_url 을 현재 URL로 교체하고 requires_pg_payment를 false로 변경
+ *      → 템플릿 fallback 분기의 navigate 가 navigate-to-self 가 되어 실질적 이동 없음
+ *
+ * 결과: 체크아웃 페이지에 머문 채 PG 팝업이 뜨고, PG 콜백이 정식 complete 페이지로 redirect.
+ */
+
+import { requestPaymentHandler } from './handlers/requestPayment';
+import {
+    applePayUnsupportedMessage,
+    isIosMobileDevice,
+    isNhnKcpApplePayMethod,
+} from './support/applePayDevice';
+
+const ORDER_CREATE_PATH = '/api/modules/sirsoft-ecommerce/user/orders';
+const TARGET_PG_PROVIDER = 'sirsoft-nhnkcp';
+const PLUGIN_IDENTIFIER = 'sirsoft-pay_nhnkcp';
+const EASY_PAY_PREFIX = 'nhnkcp_';
+
+const logger = {
+    info: (...args: unknown[]) => console.info(`[${PLUGIN_IDENTIFIER}]`, ...args),
+    warn: (...args: unknown[]) => console.warn(`[${PLUGIN_IDENTIFIER}]`, ...args),
+    error: (...args: unknown[]) => console.error(`[${PLUGIN_IDENTIFIER}]`, ...args),
+};
+
+interface OrderCreateResponseBody {
+    success?: boolean;
+    message?: string;
+    data?: {
+        order?: {
+            order_number?: string;
+            total_tax_amount?: number;
+            total_vat_amount?: number;
+            total_tax_free_amount?: number;
+        };
+        redirect_url?: string;
+        requires_pg_payment?: boolean;
+        pg_provider?: string;
+        pg_payment_data?: Record<string, unknown>;
+    };
+}
+
+function extractUrl(input: RequestInfo | URL): string {
+    if (typeof input === 'string') return input;
+    if (input instanceof URL) return input.toString();
+    if (typeof Request !== 'undefined' && input instanceof Request) return input.url;
+    return String(input);
+}
+
+function extractMethod(input: RequestInfo | URL, init?: RequestInit): string {
+    if (init?.method) return init.method.toUpperCase();
+    if (typeof Request !== 'undefined' && input instanceof Request) return input.method.toUpperCase();
+    return 'GET';
+}
+
+function isTargetEndpoint(url: string, method: string): boolean {
+    if (method !== 'POST') return false;
+    const path = url.split('?')[0].split('#')[0];
+    return path === ORDER_CREATE_PATH || path.endsWith(ORDER_CREATE_PATH);
+}
+
+function buildNoOpRedirectUrl(): string {
+    return window.location.pathname + window.location.search + window.location.hash;
+}
+
+function mutateResponse(originalResponse: Response, mutatedBody: OrderCreateResponseBody): Response {
+    const json = JSON.stringify(mutatedBody);
+    return new Response(json, {
+        status: originalResponse.status,
+        statusText: originalResponse.statusText,
+        headers: originalResponse.headers,
+    });
+}
+
+function buildPaymentMethodBlockedResponse(message: string): Response {
+    return new Response(JSON.stringify({
+        success: false,
+        message,
+        error: message,
+        errors: {
+            payment_method: [message],
+        },
+    }), {
+        status: 422,
+        statusText: 'Unprocessable Content',
+        headers: {
+            'Content-Type': 'application/json',
+        },
+    });
+}
+
+function extractPaymentMethodFromBody(body: string): string | undefined {
+    try {
+        const parsed = JSON.parse(body) as Record<string, unknown>;
+        return parsed['payment_method'] as string | undefined;
+    } catch {
+        return undefined;
+    }
+}
+
+function replacePaymentMethodInBody(body: string, replacement: string): string {
+    try {
+        const parsed = JSON.parse(body) as Record<string, unknown>;
+        parsed['payment_method'] = replacement;
+        return JSON.stringify(parsed);
+    } catch {
+        return body;
+    }
+}
+
+export function installOrderResponseInterceptor(): void {
+    if (typeof window === 'undefined' || typeof window.fetch !== 'function') {
+        return;
+    }
+
+    const flag = '__sirsoftNhnkcpInterceptorInstalled' as const;
+    const w = window as unknown as Record<string, unknown>;
+    if (w[flag]) {
+        return;
+    }
+    w[flag] = true;
+
+    // 최초 설치 플러그인이 원본 브라우저 fetch를 보존 (다른 PG 인터셉터가 쌓이기 전)
+    const ORIGINAL_FETCH_KEY = '__sirsoftPgOriginalFetch';
+    if (!w[ORIGINAL_FETCH_KEY]) {
+        w[ORIGINAL_FETCH_KEY] = window.fetch.bind(window);
+    }
+    // easy pay 요청 시 다른 PG 인터셉터(KG 이니시스 등)를 완전히 우회하는 원본 fetch
+    const browserFetch = w[ORIGINAL_FETCH_KEY] as typeof fetch;
+
+    const originalFetch = window.fetch.bind(window);
+
+    window.fetch = async function patchedFetch(
+        input: RequestInfo | URL,
+        init?: RequestInit
+    ): Promise<Response> {
+        const url = extractUrl(input);
+        const method = extractMethod(input, init);
+
+        // 주문 생성 엔드포인트가 아니면 바로 통과
+        if (!isTargetEndpoint(url, method)) {
+            return originalFetch(input, init);
+        }
+
+        // 요청 body에서 payment_method 추출 (nhnkcp_* 간편결제 감지)
+        let originalPaymentMethod: string | undefined;
+        let modifiedInit = init;
+
+        if (init?.body && typeof init.body === 'string') {
+            const pm = extractPaymentMethodFromBody(init.body);
+            if (typeof pm === 'string' && pm.startsWith(EASY_PAY_PREFIX)) {
+                originalPaymentMethod = pm;
+                // nhnkcp_* → 'card'로 교체해 서버 전송 (서버 ValidationEnum에 없는 값 방지)
+                modifiedInit = { ...init, body: replacePaymentMethodInBody(init.body, 'card') };
+                logger.info(`easy pay detected: replacing payment_method '${pm}' → 'card'`);
+            }
+        }
+
+        // G7Core 로컬 상태 fallback — 간편결제 버튼 클릭 시 serverPaymentMethod='card'로
+        // 서버에 전달되어 요청 body에서 감지 불가인 경우 대비
+        if (!originalPaymentMethod) {
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const localPm = ((window as any).G7Core)?.state?.getLocal?.()?.paymentMethod;
+                if (typeof localPm === 'string' && localPm.startsWith(EASY_PAY_PREFIX)) {
+                    originalPaymentMethod = localPm;
+                    logger.info(`easy pay detected from local state: '${localPm}'`);
+                }
+            } catch { /* ignore */ }
+        }
+
+        if (isNhnKcpApplePayMethod(originalPaymentMethod) && !isIosMobileDevice()) {
+            const message = applePayUnsupportedMessage();
+            logger.warn(message);
+            return buildPaymentMethodBlockedResponse(message);
+        }
+
+        // easy pay일 때 browserFetch(원본)를 사용해 KG 이니시스 등 다른 PG 인터셉터 우회
+        // 기본 PG가 KG 이니시스여도 NHN KCP 결제창이 열리도록 함
+        const fetchFn = originalPaymentMethod ? browserFetch : originalFetch;
+        const response = await fetchFn(input, modifiedInit);
+
+        let cloned: Response;
+        try {
+            cloned = response.clone();
+        } catch {
+            return response;
+        }
+
+        let body: OrderCreateResponseBody | null = null;
+        try {
+            body = (await cloned.json()) as OrderCreateResponseBody;
+        } catch {
+            return response;
+        }
+
+        const data = body?.data;
+        if (!data) return response;
+
+        const requiresPg = data.requires_pg_payment === true;
+        const isNhnkcp = data.pg_provider === TARGET_PG_PROVIDER;
+
+        // 일반 결제: pg_provider가 nhnkcp이고 requires_pg_payment=true인 경우에만 처리
+        // 간편결제: pg_provider 무관하게 NHN KCP 처리 (기본 PG가 KG 이니시스여도 KCP 결제창 띄움)
+        if (!originalPaymentMethod && (!requiresPg || !isNhnkcp)) {
+            return response;
+        }
+        if (originalPaymentMethod && !data.order && !data.pg_payment_data) {
+            return response;
+        }
+
+        // pg_payment_data: 서버 응답에 포함되거나,
+        // 간편결제 + 기본 PG가 타 PG인 경우 data.order에서 직접 구성
+        let pgPaymentData = data.pg_payment_data;
+        if (!pgPaymentData && originalPaymentMethod && data.order) {
+            const orderData = data.order as Record<string, unknown>;
+            const options = orderData.options as Array<Record<string, unknown>> | undefined;
+            const firstName = (options?.[0]?.product_name as string | undefined) ?? String(orderData.order_number ?? '');
+            const orderName = (options?.length ?? 0) > 1
+                ? `${firstName} 외 ${(options?.length ?? 0) - 1}건`
+                : firstName;
+            pgPaymentData = {
+                order_number: orderData.order_number,
+                order_name: orderName,
+                amount: Math.floor(Number(orderData.total_due_amount ?? orderData.total_amount ?? 0)),
+                currency: 'KRW',
+                customer_name: orderData.orderer_name ?? null,
+                customer_email: orderData.orderer_email ?? null,
+                customer_phone: String(orderData.orderer_phone ?? '').replace(/[^0-9]/g, ''),
+            };
+            logger.info('pg_payment_data constructed from order (기본 PG가 타 PG)', {
+                order_number: pgPaymentData.order_number,
+                amount: pgPaymentData.amount,
+            });
+        }
+
+        if (!pgPaymentData) {
+            logger.warn('nhnkcp order detected but pg_payment_data missing');
+            return response;
+        }
+
+        logger.info('intercepted order create response — opening PG popup');
+
+        // 주문 세금 정보 추출 — PC 결제창의 복합과세 분할 필드 전달용
+        const orderTax = data.order
+            ? {
+                tax_amount: data.order.total_tax_amount ?? 0,
+                vat_amount: data.order.total_vat_amount ?? 0,
+                tax_free_amount: data.order.total_tax_free_amount ?? 0,
+            }
+            : {};
+
+        // 간편결제가 아닌 경우 요청 body의 pay_method를 pgPaymentData에 주입
+        const enrichedPgPaymentData = (!originalPaymentMethod && modifiedInit?.body && typeof modifiedInit.body === 'string')
+            ? (() => {
+                const pm = extractPaymentMethodFromBody(modifiedInit!.body as string);
+                return pm ? { ...pgPaymentData, pay_method: pm, ...orderTax } : { ...pgPaymentData, ...orderTax };
+            })()
+            : { ...pgPaymentData, ...orderTax };
+
+        void requestPaymentHandler({
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            params: {
+                pgPaymentData: enrichedPgPaymentData as any,
+                paymentMethod: originalPaymentMethod,
+            },
+        });
+
+        const mutatedBody: OrderCreateResponseBody = {
+            ...body,
+            data: {
+                ...data,
+                requires_pg_payment: false,
+                redirect_url: buildNoOpRedirectUrl(),
+            },
+        };
+
+        return mutateResponse(response, mutatedBody);
+    };
+
+    logger.info('order response interceptor installed');
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/paymentCloseReport.ts b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/paymentCloseReport.ts
new file mode 100644
index 00000000..ad558a91
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/paymentCloseReport.ts
@@ -0,0 +1,106 @@
+export interface PaymentCloseReportContext {
+    closeReportUrl?: string;
+    oid: string;
+    price: number;
+    buyer_email?: string;
+    buyer_phone?: string;
+    payment_method?: string;
+}
+
+function resolveApiUrl(url: string): string {
+    if (/^https?:\/\//i.test(url) || url.startsWith('/api/')) {
+        return url;
+    }
+
+    if (url.startsWith('/plugins/')) {
+        return `/api${url}`;
+    }
+
+    if (url.startsWith('plugins/')) {
+        return `/api/${url}`;
+    }
+
+    return url;
+}
+
+function trimReason(reason: string): string {
+    return reason.trim().slice(0, 160);
+}
+
+function resolveRetryUrl(closeReportUrl?: string): string | undefined {
+    if (!closeReportUrl) {
+        return undefined;
+    }
+
+    return closeReportUrl.replace(/\/payment\/close-report$/, '/payment/retry');
+}
+
+async function postPaymentContext(url: string, payload: Record<string, unknown>, keepalive = false): Promise<void> {
+    const apiClient = ((window as any).G7Core)?.api;
+    if (typeof apiClient?.post === 'function') {
+        await apiClient.post(url, payload);
+        return;
+    }
+
+    const response = await fetch(resolveApiUrl(url), {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(payload),
+        keepalive,
+    });
+
+    if (!response.ok) {
+        let message = `NHN KCP payment request failed (${response.status})`;
+        try {
+            const data = await response.json();
+            const responseMessage = Array.isArray(data?.errors?.message)
+                ? data.errors.message[0]
+                : data?.error ?? data?.message;
+            if (typeof responseMessage === 'string' && responseMessage.trim() !== '') {
+                message = responseMessage;
+            }
+        } catch {
+            // JSON 응답이 아니면 HTTP 상태 메시지를 사용한다.
+        }
+        throw new Error(message);
+    }
+}
+
+export async function preparePaymentRetry(context: PaymentCloseReportContext): Promise<void> {
+    const retryUrl = resolveRetryUrl(context.closeReportUrl);
+    if (!retryUrl) {
+        return;
+    }
+
+    await postPaymentContext(retryUrl, {
+        oid: context.oid,
+        price: Number(context.price),
+        buyer_email: context.buyer_email ?? '',
+        buyer_phone: context.buyer_phone ?? '',
+        payment_method: context.payment_method ?? '',
+    });
+}
+
+export async function reportPaymentWindowClosed(
+    context: PaymentCloseReportContext,
+    reason = 'kcp-window-closed',
+): Promise<void> {
+    if (!context.closeReportUrl) {
+        return;
+    }
+
+    const payload = {
+        oid: context.oid,
+        price: Number(context.price),
+        buyer_email: context.buyer_email ?? '',
+        buyer_phone: context.buyer_phone ?? '',
+        payment_method: context.payment_method ?? '',
+        reason: trimReason(reason) || 'kcp-window-closed',
+    };
+
+    try {
+        await postPaymentContext(context.closeReportUrl, payload, true);
+    } catch (error) {
+        console.warn('[sirsoft-pay_nhnkcp] failed to report payment window close', error);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/support/applePayDevice.ts b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/support/applePayDevice.ts
new file mode 100644
index 00000000..82d63510
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/js/support/applePayDevice.ts
@@ -0,0 +1,38 @@
+export const NHNKCP_APPLEPAY_METHOD = 'nhnkcp_applepay';
+
+export function isNhnKcpApplePayMethod(paymentMethod: unknown): boolean {
+    return paymentMethod === NHNKCP_APPLEPAY_METHOD;
+}
+
+export function isIosMobileDevice(): boolean {
+    if (typeof navigator === 'undefined') return false;
+
+    const nav = navigator as Navigator & {
+        userAgentData?: {
+            mobile?: boolean;
+            platform?: string;
+        };
+        maxTouchPoints?: number;
+    };
+    const ua = (nav.userAgent || '').toLowerCase();
+    const platform = ((nav.userAgentData?.platform ?? nav.platform) || '').toLowerCase();
+    const touchPoints = nav.maxTouchPoints ?? 0;
+
+    if (/iphone|ipad|ipod/.test(ua) || /iphone|ipad|ipod|ios/.test(platform)) {
+        return true;
+    }
+
+    return /macintosh|mac os x/.test(ua) && touchPoints > 1;
+}
+
+export function applePayUnsupportedMessage(): string {
+    const lang = typeof document !== 'undefined'
+        ? document.documentElement.lang
+        : '';
+
+    if ((lang || '').toLowerCase().startsWith('ko')) {
+        return '애플페이는 IOS 기기에 모바일결제만 가능합니다.';
+    }
+
+    return 'Apple Pay is available only for mobile payments on iOS devices.';
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/resources/lang/en.json b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/lang/en.json
new file mode 100644
index 00000000..8493b708
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/lang/en.json
@@ -0,0 +1,158 @@
+{
+    "editor": {
+        "data_source": {
+            "health": "Health",
+            "kcp_escrow_delivery": "Escrow Delivery",
+            "kcp_status": "Payment Status",
+            "nhnkcp_test_mode_status": "Test Mode Status",
+            "nhnkcp_easy_pay_config": "Easy Pay Config",
+            "nhnkcp_easy_pay_display_map": "Easy Pay Display Map",
+            "nhnkcp_test_map": "Test Payment Map",
+            "nicepay_test_map": "Test Payment Map",
+            "settings": "Payment Settings",
+            "vbank_info": "Virtual Account Info"
+        }
+    },
+    "messages": {
+        "refund": {
+            "missing_tid": "Cannot process refund: transaction number (tno) is missing.",
+            "default_reason": "Admin cancellation"
+        },
+        "payment": {
+            "auth_failed": "KCP payment authentication failed.",
+            "order_not_found": "Order not found.",
+            "amount_mismatch": "Payment amount does not match.",
+            "confirm_failed": "KCP transaction inquiry failed."
+        }
+    },
+    "payment_error": {
+        "title": "Payment Error",
+        "message": "An error occurred while processing the payment."
+    },
+    "user": {
+        "test_mode_badge": "Test Payment",
+        "payment_type_label": "Payment Method",
+        "receipt_label": "Receipt",
+        "receipt_view": "View Receipt",
+        "cash_receipt_view": "View Cash Receipt",
+        "vbank_title": "Virtual Account Deposit Guide",
+        "vbank_bank_name": "Bank",
+        "vbank_account": "Account Number",
+        "vbank_holder": "Account Holder",
+        "vbank_due": "Deposit Deadline",
+        "vbank_notice": "Your order will be automatically cancelled if payment is not received by the deadline.",
+        "tax_breakdown_title": "Tax Breakdown",
+        "supply_amount": "Supply Amount",
+        "vat_amount": "VAT",
+        "tax_free_amount": "Tax-Free Amount",
+        "escrow_badge": "Escrow"
+    },
+    "admin": {
+        "test_mode_badge": "Test Payment",
+        "test_mode_order_notice": "This order was processed as a test payment.",
+        "test_mode_settings_warning_plugin": "NHN KCP",
+        "test_mode_settings_warning_title": "Warning: NHN KCP payments are currently set to test mode.",
+        "test_mode_settings_warning_body": "Test payments do not create real payments. If the shop is live, switch this plugin to live payment mode before operating.",
+        "test_mode_settings_warning_action": "Switch to live mode",
+        "order_info_title": "NHN KCP Payment Info",
+        "order_info_description": "Displays stored KCP original approval and current payment status.",
+        "pay_status_approved": "Approved",
+        "pay_status_cancelled": "Cancelled",
+        "pay_status_cancel_completed": "Cancellation Completed",
+        "pay_status_partial_cancelled": "Partially Cancelled",
+        "pay_status_unknown": "Unknown",
+        "result_payment_status": "Current Payment Status",
+        "result_tno": "Transaction No. (TNO)",
+        "result_app_no": "Original Approval No.",
+        "result_app_time": "Original Approval Time",
+        "result_pay_method": "Pay Method",
+        "result_res_cd": "Original Approval Result Code",
+        "result_cancelled_amount": "Cancelled Amount",
+        "result_cancelled_at": "Cancelled At",
+        "result_refund_status": "Refund Status",
+        "result_refund_number": "Refund No.",
+        "escrow_badge": "Escrow",
+        "escrow_delivery_title": "KCP Escrow Delivery Registration",
+        "escrow_delivery_description": "Register the tracking number with KCP after shipping.",
+        "escrow_delivery_invoice_label": "Tracking No.",
+        "escrow_delivery_invoice_placeholder": "Enter tracking number",
+        "escrow_delivery_courier_label": "Courier",
+        "escrow_delivery_courier_placeholder": "Select courier",
+        "escrow_delivery_already_registered": "Delivery Registered",
+        "escrow_delivery_registered_at": "Registered At",
+        "escrow_delivery_invoice_info": "Tracking No.",
+        "escrow_delivery_courier_info": "Courier",
+        "escrow_delivery_register_button": "Register",
+        "escrow_delivery_change_button": "Update",
+        "escrow_delivery_registering": "Registering...",
+        "escrow_delivery_success": "Delivery info registered with KCP.",
+        "escrow_delivery_error": "Failed to register delivery info."
+    },
+    "settings": {
+        "title": "NHN KCP Settings",
+        "description": "Manage NHN KCP payment plugin settings.",
+        "test_mode": "Test Mode",
+        "test_mode_hint": "No real payments occur in test mode.",
+        "live_mode_warning_title": "Live Mode Active",
+        "live_mode_warning_body": "Real payments will occur. Verify that your live site code and key are configured correctly.",
+        "cancel_server_ip_title": "Payment cancellation server IP registration required",
+        "cancel_server_ip_body": "NHN KCP allows live payment cancellations from the shop admin only when the shop server's outbound IP is registered in the KCP merchant admin.",
+        "cancel_server_ip_path": "NHN KCP Merchant Admin > Technology Management Center > Security Management > Server IP Settings (Payment)",
+        "cancel_server_ip_effect": "If the IP is not registered or the server IP changes, cancellation from this admin screen may fail and you may need to cancel directly in the KCP merchant admin.",
+        "cancel_server_ip_value_label": "Server IP to register",
+        "cancel_server_ip_unavailable": "Server IP needs verification",
+        "cancel_server_ip_copied": "Server IP copied to clipboard.",
+        "cancel_server_ip_link": "Open NHN KCP Merchant Admin",
+        "section_test_keys": "Test Credentials",
+        "test_site_cd": "Test Site Code (site_cd)",
+        "test_site_cd_hint": "Test site code issued by KCP (default: T0000)",
+        "test_site_key": "Test Site Key (site_key)",
+        "test_site_key_hint": "Test site key issued by KCP",
+        "section_live_keys": "Live Credentials",
+        "live_site_cd": "Live Site Code (site_cd)",
+        "live_site_cd_hint": "Live site code issued by KCP (enter without SR prefix)",
+        "live_site_cd_example": "e.g.: xxxxxx → full site_cd used will be SRxxxxxx",
+        "live_site_key": "Live Site Key (site_key)",
+        "live_site_key_hint": "Keep this key secret.",
+        "section_easy_pay": "Easy Pay Settings",
+        "section_easy_pay_hint": "Select the easy payment services to enable. Only activate services for which you have completed a KCP merchant agreement.",
+        "easy_pay_allow_with_other_pg": "Available with other PGs",
+        "easy_pay_allow_with_other_pg_hint": "When enabled, NHN KCP easy pay buttons will appear on the checkout page even when another PG is set as the default payment method.",
+        "easy_pay_payco": "PAYCO",
+        "easy_pay_naverpay": "NaverPay",
+        "easy_pay_naverpay_hint": "Not available in test mode",
+        "easy_pay_naverpay_point": "NaverPay Point",
+        "easy_pay_naverpay_point_hint": "Requires a NaverPay Point payment agreement with KCP. If you see error [DR02], disable this option and contact KCP.",
+        "easy_pay_kakaopay": "KakaoPay",
+        "easy_pay_kakaopay_hint": "Not available in test mode",
+        "easy_pay_applepay": "Apple Pay",
+        "easy_pay_applepay_hint": "Available on iOS Safari only",
+        "section_redirect": "Redirect URLs",
+        "redirect_success_url": "Payment Success Redirect URL",
+        "redirect_success_url_hint": "Supports relative paths or full URLs. {orderId} will be replaced with the actual order number.",
+        "redirect_fail_url": "Payment Failure Redirect URL",
+        "redirect_fail_url_hint": "Supports relative paths or full URLs. Error details are appended as query parameters.",
+        "section_vbank": "Virtual Account Settings",
+        "section_vbank_hint": "Settings for virtual account payment.",
+        "vbank_expire_days": "Deposit Validity Period",
+        "vbank_expire_days_hint": "Number of days the virtual account remains valid for deposit (1–7 days).",
+        "vbank_expire_days_unit": "days",
+        "section_vbank_notify": "Virtual Account Deposit Notification URL",
+        "vbank_notify_hint": "Register this URL as the deposit notification URL in the NHN KCP merchant admin to enable automatic virtual account payment processing.",
+        "vbank_notify_path": "Registration path: NHN KCP Merchant Admin > Technology Management Center > Webhook Management > Webhook URL Settings",
+        "vbank_notify_copied": "URL copied to clipboard.",
+        "copy": "Copy",
+        "section_escrow": "Escrow Settings",
+        "section_escrow_hint": "With escrow, payment is held until the buyer confirms receipt.",
+        "use_escrow": "Enable Escrow Payments",
+        "use_escrow_hint": "When enabled, escrow applies to all payments.",
+        "escrow_test_site_cd": "Escrow Test Site Code",
+        "escrow_test_site_cd_hint": "KCP escrow test site_cd (default: T0007)",
+        "section_escrow_notify": "Escrow Common Notification URL",
+        "escrow_common_notify_hint": "Register this URL as the common notification URL in the NHN KCP merchant admin to enable automatic escrow purchase confirmation/cancellation processing.",
+        "escrow_common_notify_copied": "URL copied to clipboard."
+    },
+    "easy_pay": {
+        "section_title": "Easy Pay"
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/resources/lang/ko.json b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/lang/ko.json
new file mode 100644
index 00000000..2fbe7a66
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/lang/ko.json
@@ -0,0 +1,158 @@
+{
+    "editor": {
+        "data_source": {
+            "health": "연동 상태",
+            "kcp_escrow_delivery": "에스크로 배송",
+            "kcp_status": "결제 상태",
+            "nhnkcp_test_mode_status": "테스트 모드 상태",
+            "nhnkcp_easy_pay_config": "간편결제 설정",
+            "nhnkcp_easy_pay_display_map": "간편결제 표시 맵",
+            "nhnkcp_test_map": "테스트 결제 맵",
+            "nicepay_test_map": "테스트 결제 맵",
+            "settings": "결제 설정",
+            "vbank_info": "가상계좌 정보"
+        }
+    },
+    "messages": {
+        "refund": {
+            "missing_tid": "결제 거래번호(tno)가 없습니다.",
+            "default_reason": "관리자 환불"
+        },
+        "payment": {
+            "auth_failed": "KCP 결제 인증에 실패했습니다.",
+            "order_not_found": "주문을 찾을 수 없습니다.",
+            "amount_mismatch": "결제 금액이 일치하지 않습니다.",
+            "confirm_failed": "KCP 거래 조회에 실패했습니다."
+        }
+    },
+    "payment_error": {
+        "title": "결제 오류",
+        "message": "결제 처리 중 오류가 발생했습니다."
+    },
+    "user": {
+        "test_mode_badge": "테스트 결제",
+        "payment_type_label": "결제 수단",
+        "receipt_label": "영수증",
+        "receipt_view": "영수증 조회",
+        "cash_receipt_view": "현금영수증 조회",
+        "vbank_title": "가상계좌 입금 안내",
+        "vbank_bank_name": "은행",
+        "vbank_account": "계좌번호",
+        "vbank_holder": "예금주",
+        "vbank_due": "입금 기한",
+        "vbank_notice": "입금 기한 내에 입금하지 않으시면 주문이 자동 취소됩니다.",
+        "tax_breakdown_title": "세금 상세",
+        "supply_amount": "공급가액",
+        "vat_amount": "부가세",
+        "tax_free_amount": "면세금액",
+        "escrow_badge": "에스크로"
+    },
+    "admin": {
+        "test_mode_badge": "테스트 결제",
+        "test_mode_order_notice": "이 주문은 테스트 결제로 처리되었습니다.",
+        "test_mode_settings_warning_plugin": "NHN KCP",
+        "test_mode_settings_warning_title": "(주의!) NHN KCP 결제 설정이 현재 테스트결제로 되어 있습니다.",
+        "test_mode_settings_warning_body": "테스트결제 시 실제 결제가 되지 않으므로, 쇼핑몰 운영 중이면 반드시 실결제로 설정하여 운영하세요.",
+        "test_mode_settings_warning_action": "실결제로 설정",
+        "order_info_title": "NHN KCP 결제 정보",
+        "order_info_description": "DB에 저장된 KCP 원승인 및 현재 결제 상태를 표시합니다.",
+        "pay_status_approved": "승인",
+        "pay_status_cancelled": "취소",
+        "pay_status_cancel_completed": "취소완료",
+        "pay_status_partial_cancelled": "부분취소",
+        "pay_status_unknown": "미확인",
+        "result_payment_status": "현재 결제상태",
+        "result_tno": "거래번호 (TNO)",
+        "result_app_no": "원승인번호",
+        "result_app_time": "원승인일시",
+        "result_pay_method": "결제수단",
+        "result_res_cd": "원승인 응답코드",
+        "result_cancelled_amount": "취소금액",
+        "result_cancelled_at": "취소일시",
+        "result_refund_status": "환불상태",
+        "result_refund_number": "환불번호",
+        "escrow_badge": "에스크로",
+        "escrow_delivery_title": "KCP 에스크로 배송 등록",
+        "escrow_delivery_description": "상품 발송 후 KCP에 운송장번호를 등록하세요.",
+        "escrow_delivery_invoice_label": "운송장번호",
+        "escrow_delivery_invoice_placeholder": "운송장번호 입력",
+        "escrow_delivery_courier_label": "택배사",
+        "escrow_delivery_courier_placeholder": "택배사 선택",
+        "escrow_delivery_already_registered": "배송등록 완료",
+        "escrow_delivery_registered_at": "등록일시",
+        "escrow_delivery_invoice_info": "운송장번호",
+        "escrow_delivery_courier_info": "택배사",
+        "escrow_delivery_register_button": "배송등록",
+        "escrow_delivery_change_button": "배송정보 수정",
+        "escrow_delivery_registering": "등록 중...",
+        "escrow_delivery_success": "배송정보가 KCP에 등록되었습니다.",
+        "escrow_delivery_error": "배송등록에 실패했습니다."
+    },
+    "settings": {
+        "title": "NHN KCP 설정",
+        "description": "NHN KCP 결제 플러그인 설정을 관리합니다.",
+        "test_mode": "테스트 모드",
+        "test_mode_hint": "테스트 모드에서는 실제 결제가 발생하지 않습니다.",
+        "live_mode_warning_title": "라이브 모드 활성화",
+        "live_mode_warning_body": "실제 결제가 발생합니다. 라이브 사이트 코드 및 키를 정확히 설정했는지 확인하세요.",
+        "cancel_server_ip_title": "결제취소 서버 IP 등록 필요",
+        "cancel_server_ip_body": "NHN KCP는 거래 취소 보안을 위해 쇼핑몰 서버의 외부 송신 IP가 상점관리자에 등록된 경우에만 쇼핑몰 관리자에서 실결제 취소를 허용합니다.",
+        "cancel_server_ip_path": "NHN KCP 상점관리자 > 기술관리센터 > 보안관리 > 서버 IP 설정(결제)",
+        "cancel_server_ip_effect": "IP가 등록되지 않았거나 서버 IP가 변경되면 이 관리자 화면에서 결제취소가 실패할 수 있으며, 이 경우 KCP 상점관리자에서 직접 취소해야 합니다.",
+        "cancel_server_ip_value_label": "등록할 서버 IP",
+        "cancel_server_ip_unavailable": "서버 IP 확인 필요",
+        "cancel_server_ip_copied": "서버 IP가 클립보드에 복사되었습니다.",
+        "cancel_server_ip_link": "NHN KCP 상점관리자 열기",
+        "section_test_keys": "테스트 인증 정보",
+        "test_site_cd": "테스트 사이트 코드 (site_cd)",
+        "test_site_cd_hint": "KCP에서 발급받은 테스트 사이트 코드 (기본값: T0000)",
+        "test_site_key": "테스트 사이트 키 (site_key)",
+        "test_site_key_hint": "KCP에서 발급받은 테스트 사이트 키",
+        "section_live_keys": "라이브 인증 정보",
+        "live_site_cd": "라이브 사이트 코드 (site_cd)",
+        "live_site_cd_hint": "KCP에서 발급받은 라이브 사이트 코드 (SR prefix 제외하고 입력)",
+        "live_site_cd_example": "예: xxxxxx → 실제 사용 site_cd는 SRxxxxxx",
+        "live_site_key": "라이브 사이트 키 (site_key)",
+        "live_site_key_hint": "외부에 노출되지 않도록 주의하세요.",
+        "section_easy_pay": "간편결제 설정",
+        "section_easy_pay_hint": "사용할 간편결제 서비스를 선택하세요. KCP 가맹점 계약이 완료된 서비스만 활성화하세요.",
+        "easy_pay_allow_with_other_pg": "타 PG와 사용가능함",
+        "easy_pay_allow_with_other_pg_hint": "활성화하면, 다른 PG사가 기본 결제수단으로 설정된 경우에도 체크아웃 페이지에 NHN KCP 간편결제 버튼이 표시됩니다.",
+        "easy_pay_payco": "PAYCO (페이코)",
+        "easy_pay_naverpay": "네이버페이",
+        "easy_pay_naverpay_hint": "테스트 모드에서 결제 불가",
+        "easy_pay_naverpay_point": "네이버페이 포인트결제",
+        "easy_pay_naverpay_point_hint": "KCP 가맹점에서 네이버페이 포인트결제 계약이 필요합니다. [DR02] 오류 발생 시 비활성화 후 KCP에 문의하세요.",
+        "easy_pay_kakaopay": "카카오페이",
+        "easy_pay_kakaopay_hint": "테스트 모드에서 결제 불가",
+        "easy_pay_applepay": "애플페이",
+        "easy_pay_applepay_hint": "iOS Safari에서만 사용 가능",
+        "section_redirect": "리다이렉트 URL",
+        "redirect_success_url": "결제 성공 리다이렉트 URL",
+        "redirect_success_url_hint": "상대 경로(/shop/...) 또는 전체 URL 모두 가능합니다. {orderId}는 주문번호로 자동 치환됩니다.",
+        "redirect_fail_url": "결제 실패 리다이렉트 URL",
+        "redirect_fail_url_hint": "상대 경로 또는 전체 URL 모두 가능합니다. 오류 정보는 쿼리 파라미터로 자동 추가됩니다.",
+        "section_vbank": "가상계좌 설정",
+        "section_vbank_hint": "가상계좌 결제 관련 설정입니다.",
+        "vbank_expire_days": "입금 유효기간",
+        "vbank_expire_days_hint": "가상계좌 발급 후 입금 가능한 기한 (1~7일).",
+        "vbank_expire_days_unit": "일",
+        "section_vbank_notify": "가상계좌 입금통보 URL",
+        "vbank_notify_hint": "NHN KCP 가맹점 어드민에서 이 URL을 입금통보 URL로 등록해야 가상계좌 결제가 자동으로 처리됩니다.",
+        "vbank_notify_path": "등록 경로: NHN KCP 상점관리자 > 기술관리센터 > 웹훅(Webhook) 관리 > 웹훅 URL 설정",
+        "vbank_notify_copied": "URL이 클립보드에 복사되었습니다.",
+        "copy": "복사",
+        "section_escrow": "에스크로 설정",
+        "section_escrow_hint": "에스크로 결제를 사용하면 구매자가 구매확인 후 판매자에게 결제금액이 정산됩니다.",
+        "use_escrow": "에스크로 결제 사용",
+        "use_escrow_hint": "활성화하면 모든 결제에 에스크로가 적용됩니다.",
+        "escrow_test_site_cd": "에스크로 테스트 사이트 코드",
+        "escrow_test_site_cd_hint": "KCP 에스크로 테스트용 site_cd (기본값: T0007)",
+        "section_escrow_notify": "에스크로 공통통보 URL",
+        "escrow_common_notify_hint": "NHN KCP 가맹점 어드민에서 이 URL을 공통통보 URL로 등록해야 구매확인/취소가 자동으로 처리됩니다.",
+        "escrow_common_notify_copied": "URL이 클립보드에 복사되었습니다."
+    },
+    "easy_pay": {
+        "section_title": "간편결제"
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/resources/layouts/admin/plugin_settings.json b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/layouts/admin/plugin_settings.json
new file mode 100644
index 00000000..70ec8558
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/resources/layouts/admin/plugin_settings.json
@@ -0,0 +1,1944 @@
+{
+    "version": "1.0.0",
+    "layout_name": "plugin_settings",
+    "permissions": [
+        "core.plugins.update"
+    ],
+    "extends": "_admin_base",
+    "meta": {
+        "title": "$t:sirsoft-pay_nhnkcp.settings.title",
+        "description": "$t:sirsoft-pay_nhnkcp.settings.description"
+    },
+    "data_sources": [
+        {
+            "id": "settings",
+            "label_key": "$t:sirsoft-pay_nhnkcp.editor.data_source.settings",
+            "type": "api",
+            "endpoint": "/api/admin/plugins/{{route.identifier}}/settings",
+            "method": "GET",
+            "auto_fetch": true,
+            "auth_required": true,
+            "initLocal": "form",
+            "refetchOnMount": true
+        },
+        {
+            "id": "vbank_info",
+            "label_key": "$t:sirsoft-pay_nhnkcp.editor.data_source.vbank_info",
+            "type": "api",
+            "endpoint": "/api/plugins/sirsoft-pay_nhnkcp/admin/vbank-notify-url",
+            "method": "GET",
+            "auto_fetch": true,
+            "auth_required": true,
+            "initLocal": "vbankInfo"
+        },
+        {
+            "id": "health",
+            "label_key": "$t:sirsoft-pay_nhnkcp.editor.data_source.health",
+            "type": "api",
+            "endpoint": "/api/plugins/sirsoft-pay_nhnkcp/admin/health",
+            "method": "GET",
+            "auto_fetch": true,
+            "auth_required": true
+        }
+    ],
+    "slots": {
+        "content": [
+            {
+                "id": "plugin_settings_content",
+                "type": "basic",
+                "name": "Div",
+                "dataKey": "form",
+                "trackChanges": true,
+                "props": {
+                    "className": "p-4 sm:p-6 lg:p-8 min-h-screen bg-gray-50 dark:bg-gray-900"
+                },
+                "children": [
+                    {
+                        "id": "page_header",
+                        "type": "composite",
+                        "name": "PageHeader",
+                        "props": {
+                            "title": "$t:sirsoft-pay_nhnkcp.settings.title",
+                            "description": "$t:sirsoft-pay_nhnkcp.settings.description",
+                            "backPath": "/admin/plugins",
+                            "backLabel": "$t:admin.plugins.back_to_list"
+                        }
+                    },
+                    {
+                        "id": "health_check_card",
+                        "comment": "시스템 점검 — PC 결제(CLI 바이너리)와 모바일 결제(SOAP 확장) 사전조건 진단",
+                        "type": "basic",
+                        "name": "Div",
+                        "if": "{{health.data}}",
+                        "props": {
+                            "className": "mt-6 rounded-lg bg-white dark:bg-gray-800 shadow-sm border border-gray-200 dark:border-gray-700"
+                        },
+                        "children": [
+                            {
+                                "comment": "헤더 — PC/모바일 결제 가능 여부 요약 + 새로고침 버튼",
+                                "type": "basic",
+                                "name": "Div",
+                                "props": {
+                                    "className": "flex items-center justify-between p-4 border-b border-gray-200 dark:border-gray-700"
+                                },
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": { "className": "flex-center gap-3" },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Icon",
+                                                "props": {
+                                                    "name": "{{health.data.summary.error_count > 0 ? 'triangle-exclamation' : (health.data.summary.warning_count > 0 ? 'circle-info' : 'circle-check')}}",
+                                                    "className": "{{health.data.summary.error_count > 0 ? 'w-5 h-5 text-red-600 dark:text-red-400' : (health.data.summary.warning_count > 0 ? 'w-5 h-5 text-amber-500 dark:text-amber-400' : 'w-5 h-5 text-green-600 dark:text-green-400')}}"
+                                                }
+                                            },
+                                            {
+                                                "type": "basic",
+                                                "name": "H2",
+                                                "props": { "className": "text-base font-semibold text-gray-900 dark:text-gray-100" },
+                                                "text": "시스템 점검"
+                                            },
+                                            {
+                                                "type": "basic",
+                                                "name": "Span",
+                                                "if": "{{health.data.summary.error_count > 0}}",
+                                                "props": { "className": "ml-2 inline-flex items-center px-2 py-0.5 rounded text-xs font-medium bg-red-100 text-red-800 dark:bg-red-900/30 dark:text-red-300" },
+                                                "text": "오류 {{health.data.summary.error_count}}건"
+                                            },
+                                            {
+                                                "type": "basic",
+                                                "name": "Span",
+                                                "if": "{{health.data.summary.warning_count > 0}}",
+                                                "props": { "className": "ml-2 inline-flex items-center px-2 py-0.5 rounded text-xs font-medium bg-amber-100 text-amber-800 dark:bg-amber-900/30 dark:text-amber-300" },
+                                                "text": "경고 {{health.data.summary.warning_count}}건"
+                                            },
+                                            {
+                                                "type": "basic",
+                                                "name": "Span",
+                                                "if": "{{health.data.summary.fixed_count > 0}}",
+                                                "props": { "className": "ml-2 inline-flex items-center px-2 py-0.5 rounded text-xs font-medium bg-blue-100 text-blue-800 dark:bg-blue-900/30 dark:text-blue-300" },
+                                                "text": "자동 복구 {{health.data.summary.fixed_count}}건"
+                                            },
+                                            {
+                                                "type": "basic",
+                                                "name": "Span",
+                                                "if": "{{health.data.summary.error_count === 0 && health.data.summary.warning_count === 0 && health.data.summary.fixed_count === 0}}",
+                                                "props": { "className": "ml-2 inline-flex items-center px-2 py-0.5 rounded text-xs font-medium bg-green-100 text-green-800 dark:bg-green-900/30 dark:text-green-300" },
+                                                "text": "모두 정상"
+                                            }
+                                        ]
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "Button",
+                                        "props": {
+                                            "className": "px-3 py-1.5 text-sm border rounded hover:bg-gray-50 dark:hover:bg-gray-700 dark:border-gray-600 dark:text-gray-200 inline-flex items-center gap-1.5"
+                                        },
+                                        "children": [
+                                            { "type": "basic", "name": "Icon", "props": { "name": "arrows-rotate", "className": "w-4 h-4" } },
+                                            { "type": "basic", "name": "Span", "text": "다시 검사" }
+                                        ],
+                                        "actions": [
+                                            {
+                                                "type": "click",
+                                                "handler": "refetchDataSource",
+                                                "params": { "dataSourceId": "health" }
+                                            }
+                                        ]
+                                    }
+                                ]
+                            },
+                            {
+                                "comment": "PC/모바일 카드/모바일 가상계좌 결제 가능 여부 요약 배지",
+                                "type": "basic",
+                                "name": "Div",
+                                "props": { "className": "grid grid-cols-1 sm:grid-cols-3 gap-3 p-4 border-b border-gray-200 dark:border-gray-700" },
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "{{health.data.summary.pc_payment_ready ? 'p-3 rounded border border-green-200 bg-green-50 dark:bg-green-900/20 dark:border-green-800' : 'p-3 rounded border border-red-200 bg-red-50 dark:bg-red-900/20 dark:border-red-800'}}"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "props": { "className": "flex-center gap-2" },
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Icon",
+                                                        "props": {
+                                                            "name": "{{health.data.summary.pc_payment_ready ? 'circle-check' : 'circle-xmark'}}",
+                                                            "className": "{{health.data.summary.pc_payment_ready ? 'w-4 h-4 text-green-600 dark:text-green-400' : 'w-4 h-4 text-red-600 dark:text-red-400'}}"
+                                                        }
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Span",
+                                                        "props": { "className": "font-medium text-sm text-gray-900 dark:text-gray-100" },
+                                                        "text": "PC 결제 (Standard Pay)"
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Span",
+                                                        "props": {
+                                                            "className": "{{health.data.summary.pc_payment_ready ? 'text-success-soft' : 'text-danger-soft'}}"
+                                                        },
+                                                        "text": "{{health.data.summary.pc_payment_ready ? '동작 가능' : '동작 불가'}}"
+                                                    }
+                                                ]
+                                            },
+                                            {
+                                                "type": "basic",
+                                                "name": "P",
+                                                "props": { "className": "text-secondary text-xs mt-1 ml-6" },
+                                                "text": "CLI 바이너리 필요"
+                                            }
+                                        ]
+                                    },
+                                    {
+                                        "comment": "모바일 카드/일반결제 — SOAP + CLI 모두 필요 (KCP가 enc_data를 콜백으로 보냄)",
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "{{health.data.summary.mobile_payment_ready ? 'p-3 rounded border border-green-200 bg-green-50 dark:bg-green-900/20 dark:border-green-800' : 'p-3 rounded border border-red-200 bg-red-50 dark:bg-red-900/20 dark:border-red-800'}}"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "props": { "className": "flex-center gap-2" },
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Icon",
+                                                        "props": {
+                                                            "name": "{{health.data.summary.mobile_payment_ready ? 'circle-check' : 'circle-xmark'}}",
+                                                            "className": "{{health.data.summary.mobile_payment_ready ? 'w-4 h-4 text-green-600 dark:text-green-400' : 'w-4 h-4 text-red-600 dark:text-red-400'}}"
+                                                        }
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Span",
+                                                        "props": { "className": "font-medium text-sm text-gray-900 dark:text-gray-100" },
+                                                        "text": "모바일 카드/일반결제"
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Span",
+                                                        "props": {
+                                                            "className": "{{health.data.summary.mobile_payment_ready ? 'text-success-soft' : 'text-danger-soft'}}"
+                                                        },
+                                                        "text": "{{health.data.summary.mobile_payment_ready ? '동작 가능' : '동작 불가'}}"
+                                                    }
+                                                ]
+                                            },
+                                            {
+                                                "type": "basic",
+                                                "name": "P",
+                                                "props": { "className": "text-secondary text-xs mt-1 ml-6" },
+                                                "text": "SmartPhone Pay (SOAP) + CLI 바이너리 모두 필요"
+                                            }
+                                        ]
+                                    },
+                                    {
+                                        "comment": "모바일 가상계좌 — SOAP만 필요 (KCP가 평문 콜백)",
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "{{health.data.summary.mobile_vbank_only_ready ? 'p-3 rounded border border-green-200 bg-green-50 dark:bg-green-900/20 dark:border-green-800' : 'p-3 rounded border border-red-200 bg-red-50 dark:bg-red-900/20 dark:border-red-800'}}"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "props": { "className": "flex-center gap-2" },
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Icon",
+                                                        "props": {
+                                                            "name": "{{health.data.summary.mobile_vbank_only_ready ? 'circle-check' : 'circle-xmark'}}",
+                                                            "className": "{{health.data.summary.mobile_vbank_only_ready ? 'w-4 h-4 text-green-600 dark:text-green-400' : 'w-4 h-4 text-red-600 dark:text-red-400'}}"
+                                                        }
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Span",
+                                                        "props": { "className": "font-medium text-sm text-gray-900 dark:text-gray-100" },
+                                                        "text": "모바일 가상계좌"
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Span",
+                                                        "props": {
+                                                            "className": "{{health.data.summary.mobile_vbank_only_ready ? 'text-success-soft' : 'text-danger-soft'}}"
+                                                        },
+                                                        "text": "{{health.data.summary.mobile_vbank_only_ready ? '동작 가능' : '동작 불가'}}"
+                                                    }
+                                                ]
+                                            },
+                                            {
+                                                "type": "basic",
+                                                "name": "P",
+                                                "props": { "className": "text-secondary text-xs mt-1 ml-6" },
+                                                "text": "SmartPhone Pay (SOAP) 만 필요 (평문 콜백)"
+                                            }
+                                        ]
+                                    }
+                                ]
+                            },
+                            {
+                                "comment": "개별 점검 항목 리스트",
+                                "type": "basic",
+                                "name": "Div",
+                                "props": { "className": "divide-y dark:divide-gray-700" },
+                                "iteration": {
+                                    "source": "{{health.data.checks ?? []}}",
+                                    "item_var": "check"
+                                },
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": { "className": "p-4" },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "props": { "className": "panel-header-row" },
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Icon",
+                                                        "props": {
+                                                            "name": "{{check.status === 'ok' ? 'circle-check' : (check.status === 'fixed' ? 'wrench' : (check.status === 'warning' ? 'circle-info' : 'circle-xmark'))}}",
+                                                            "className": "{{check.status === 'ok' ? 'w-5 h-5 text-green-600 dark:text-green-400 mt-0.5' : (check.status === 'fixed' ? 'w-5 h-5 text-blue-600 dark:text-blue-400 mt-0.5' : (check.status === 'warning' ? 'w-5 h-5 text-amber-500 dark:text-amber-400 mt-0.5' : 'w-5 h-5 text-red-600 dark:text-red-400 mt-0.5'))}}"
+                                                        }
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Div",
+                                                        "props": { "className": "flex-1 min-w-0" },
+                                                        "children": [
+                                                            {
+                                                                "type": "basic",
+                                                                "name": "Div",
+                                                                "props": { "className": "flex-center gap-2 flex-wrap" },
+                                                                "children": [
+                                                                    {
+                                                                        "type": "basic",
+                                                                        "name": "Span",
+                                                                        "props": { "className": "text-sm font-medium text-gray-900 dark:text-gray-100" },
+                                                                        "text": "{{check.label}}"
+                                                                    },
+                                                                    {
+                                                                        "type": "basic",
+                                                                        "name": "Span",
+                                                                        "props": {
+                                                                            "className": "{{check.category === 'pc' ? 'text-xs px-1.5 py-0.5 rounded bg-gray-100 dark:bg-gray-700 text-gray-600 dark:text-gray-300' : 'text-xs px-1.5 py-0.5 rounded bg-indigo-100 dark:bg-indigo-900/30 text-indigo-700 dark:text-indigo-300'}}"
+                                                                        },
+                                                                        "text": "{{check.category === 'pc' ? 'PC' : '모바일'}}"
+                                                                    },
+                                                                    {
+                                                                        "type": "basic",
+                                                                        "name": "Span",
+                                                                        "if": "{{check.status === 'fixed'}}",
+                                                                        "props": { "className": "text-xs px-1.5 py-0.5 rounded bg-blue-100 text-blue-800 dark:bg-blue-900/30 dark:text-blue-300" },
+                                                                        "text": "자동 복구됨"
+                                                                    }
+                                                                ]
+                                                            },
+                                                            {
+                                                                "type": "basic",
+                                                                "name": "P",
+                                                                "props": { "className": "text-secondary text-xs mt-1" },
+                                                                "text": "{{check.detail}}"
+                                                            },
+                                                            {
+                                                                "comment": "사용자 조치 안내 — error/warning에서만 표시",
+                                                                "type": "basic",
+                                                                "name": "Div",
+                                                                "if": "{{check.remediation}}",
+                                                                "props": { "className": "mt-2 p-2.5 rounded bg-amber-50 border border-amber-200 dark:bg-amber-900/20 dark:border-amber-800" },
+                                                                "children": [
+                                                                    {
+                                                                        "type": "basic",
+                                                                        "name": "P",
+                                                                        "props": { "className": "text-xs font-medium text-amber-900 dark:text-amber-200 mb-1" },
+                                                                        "text": "↓ 사용자 조치 필요"
+                                                                    },
+                                                                    {
+                                                                        "type": "basic",
+                                                                        "name": "Pre",
+                                                                        "props": { "className": "text-xs text-amber-900 dark:text-amber-100 whitespace-pre-wrap font-mono leading-relaxed" },
+                                                                        "text": "{{check.remediation}}"
+                                                                    }
+                                                                ]
+                                                            }
+                                                        ]
+                                                    }
+                                                ]
+                                            }
+                                        ]
+                                    }
+                                ]
+                            }
+                        ]
+                    },
+                    {
+                        "id": "validation_error",
+                        "type": "basic",
+                        "name": "Div",
+                        "if": "{{_local.errors}}",
+                        "props": {
+                            "className": "alert-danger"
+                        },
+                        "children": [
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": {
+                                    "className": "flex gap-3"
+                                },
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "Icon",
+                                        "props": {
+                                            "name": "triangle-exclamation",
+                                            "className": "w-5 h-5 text-red-600 dark:text-red-400 dark:text-red-400 flex-shrink-0 mt-0.5"
+                                        }
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "H3",
+                                                "props": {
+                                                    "className": "text-error-soft"
+                                                },
+                                                "text": "$t:admin.plugins.settings.validation_error"
+                                            },
+                                            {
+                                                "type": "basic",
+                                                "name": "Ul",
+                                                "if": "{{typeof _local.errors === 'object' && Object.keys(_local.errors).length > 0}}",
+                                                "props": {
+                                                    "className": "mt-2 list-disc list-inside space-y-1"
+                                                },
+                                                "iteration": {
+                                                    "source": "Object.entries(_local.errors ?? {}).flatMap(([field, messages]) => Array.isArray(messages) ? messages : [messages])",
+                                                    "item_var": "message"
+                                                },
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Li",
+                                                        "props": {
+                                                            "className": "grid-3col-responsive"
+                                                        },
+                                                        "text": "{{message}}"
+                                                    }
+                                                ]
+                                            }
+                                        ]
+                                    }
+                                ]
+                            }
+                        ]
+                    },
+                    {
+                        "id": "test_mode_card",
+                        "type": "basic",
+                        "name": "Div",
+                        "props": {
+                            "className": "mt-6 bg-white dark:bg-gray-800 rounded-lg shadow-sm border border-gray-200 dark:border-gray-700"
+                        },
+                        "children": [
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": {
+                                    "className": "p-6"
+                                },
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "flex items-center justify-between"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Label",
+                                                        "props": {
+                                                            "className": "form-label"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nhnkcp.settings.test_mode"
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "P",
+                                                        "props": {
+                                                            "className": "form-hint"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nhnkcp.settings.test_mode_hint"
+                                                    }
+                                                ]
+                                            },
+                                            {
+                                                "type": "composite",
+                                                "name": "Toggle",
+                                                "props": {
+                                                    "name": "is_test_mode"
+                                                }
+                                            }
+                                        ]
+                                    }
+                                ]
+                            }
+                        ]
+                    },
+                    {
+                        "id": "live_mode_warning",
+                        "type": "basic",
+                        "name": "Div",
+                        "if": "{{_local.form && !_local.form.is_test_mode}}",
+                        "props": {
+                            "className": "mt-6 bg-amber-50 dark:bg-amber-900/20 border border-amber-200 dark:border-amber-700 rounded-lg p-4"
+                        },
+                        "children": [
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": {
+                                    "className": "flex gap-3"
+                                },
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "Icon",
+                                        "props": {
+                                            "name": "triangle-exclamation",
+                                            "className": "w-5 h-5 text-amber-600 dark:text-amber-400 flex-shrink-0 mt-0.5"
+                                        }
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "H3",
+                                                "props": {
+                                                    "className": "text-sm font-semibold text-warning-soft"
+                                                },
+                                                "text": "$t:sirsoft-pay_nhnkcp.settings.live_mode_warning_title"
+                                            },
+                                            {
+                                                "type": "basic",
+                                                "name": "P",
+                                                "props": {
+                                                    "className": "mt-1 text-warning-soft"
+                                                },
+                                                "text": "$t:sirsoft-pay_nhnkcp.settings.live_mode_warning_body"
+                                            }
+                                        ]
+                                    }
+                                ]
+                            }
+                        ]
+                    },
+                    {
+                        "id": "live_keys_section",
+                        "type": "basic",
+                        "name": "Div",
+                        "props": {
+                            "className": "mt-6 bg-white dark:bg-gray-800 rounded-lg shadow-sm border border-gray-200 dark:border-gray-700"
+                        },
+                        "children": [
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": {
+                                    "className": "flex-start justify-between px-6 py-4"
+                                },
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "H3",
+                                        "props": {
+                                            "className": "text-error-strong"
+                                        },
+                                        "text": "$t:sirsoft-pay_nhnkcp.settings.section_live_keys"
+                                    }
+                                ]
+                            },
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": {
+                                    "className": "p-6 space-y-6"
+                                },
+                                "children": [
+                                    {
+                                        "id": "field_live_site_cd",
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "section-heading-md"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "props": {
+                                                    "className": "lg:col-span-1"
+                                                },
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Label",
+                                                        "props": {
+                                                            "className": "form-label"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nhnkcp.settings.live_site_cd"
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "P",
+                                                        "props": {
+                                                            "className": "form-hint"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nhnkcp.settings.live_site_cd_hint"
+                                                    }
+                                                ]
+                                            },
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "props": {
+                                                    "className": "lg:col-span-2"
+                                                },
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Div",
+                                                        "props": {
+                                                            "className": "flex rounded-lg border border-gray-300 dark:border-gray-600 overflow-hidden focus-within:ring-2 focus-within:ring-blue-500 dark:focus-within:ring-blue-400 focus-within:border-transparent"
+                                                        },
+                                                        "children": [
+                                                            {
+                                                                "type": "basic",
+                                                                "name": "Span",
+                                                                "props": {
+                                                                    "className": "inline-flex items-center px-3 bg-gray-100 dark:bg-gray-600 border-r border-gray-300 dark:border-gray-600 text-body font-mono font-bold select-none"
+                                                                },
+                                                                "text": "SR"
+                                                            },
+                                                            {
+                                                                "type": "basic",
+                                                                "name": "Input",
+                                                                "props": {
+                                                                    "type": "text",
+                                                                    "name": "live_site_cd",
+                                                                    "placeholder": "xxxxxx",
+                                                                    "className": "flex-1 font-mono outline-none border-0"
+                                                                }
+                                                            }
+                                                        ]
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "P",
+                                                        "props": {
+                                                            "className": "mt-1.5 text-tertiary"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nhnkcp.settings.live_site_cd_example"
+                                                    }
+                                                ]
+                                            }
+                                        ]
+                                    },
+                                    {
+                                        "id": "field_live_site_key",
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "section-heading-md"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "props": {
+                                                    "className": "lg:col-span-1"
+                                                },
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Label",
+                                                        "props": {
+                                                            "className": "form-label"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nhnkcp.settings.live_site_key"
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "P",
+                                                        "props": {
+                                                            "className": "form-hint"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nhnkcp.settings.live_site_key_hint"
+                                                    }
+                                                ]
+                                            },
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "props": {
+                                                    "className": "lg:col-span-2"
+                                                },
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Input",
+                                                        "props": {
+                                                            "type": "password",
+                                                            "name": "live_site_key",
+                                                            "placeholder": "••••••••••••••••",
+                                                            "className": "dark:focus:ring-blue-400 focus:border-transparent font-mono"
+                                                        }
+                                                    }
+                                                ]
+                                            }
+                                        ]
+                                    }
+                                ]
+                            }
+                        ]
+                    },
+                    {
+                        "id": "easy_pay_section",
+                        "_comment_hidden": "간편결제는 차후 오픈 예정 — 현재는 렌더링 차단. 오픈 시 if 키 제거하면 복원됨.",
+                        "if": "{{false}}",
+                        "type": "basic",
+                        "name": "Div",
+                        "props": {
+                            "className": "mt-6 bg-white dark:bg-gray-800 rounded-lg shadow-sm border border-gray-200 dark:border-gray-700"
+                        },
+                        "children": [
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": {
+                                    "className": "flex-start justify-between px-6 py-4"
+                                },
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "H3",
+                                        "props": {
+                                            "className": "text-error-strong"
+                                        },
+                                        "text": "$t:sirsoft-pay_nhnkcp.settings.section_easy_pay"
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "P",
+                                        "props": {
+                                            "className": "form-hint"
+                                        },
+                                        "text": "$t:sirsoft-pay_nhnkcp.settings.section_easy_pay_hint"
+                                    }
+                                ]
+                            },
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": {
+                                    "className": "divide-y divide-gray-100 dark:divide-gray-700"
+                                },
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "flex items-center justify-between px-6 py-4 bg-blue-50 dark:bg-blue-900/20"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Label",
+                                                        "props": {
+                                                            "className": "form-label"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nhnkcp.settings.easy_pay_allow_with_other_pg"
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "P",
+                                                        "props": {
+                                                            "className": "form-hint"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nhnkcp.settings.easy_pay_allow_with_other_pg_hint"
+                                                    }
+                                                ]
+                                            },
+                                            {
+                                                "type": "composite",
+                                                "name": "Toggle",
+                                                "props": {
+                                                    "name": "easy_pay_allow_with_other_pg"
+                                                }
+                                            }
+                                        ]
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "flex items-center justify-between px-6 py-4"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Label",
+                                                "props": {
+                                                    "className": "form-label"
+                                                },
+                                                "text": "$t:sirsoft-pay_nhnkcp.settings.easy_pay_payco"
+                                            },
+                                            {
+                                                "type": "composite",
+                                                "name": "Toggle",
+                                                "props": {
+                                                    "name": "easy_pay_payco"
+                                                }
+                                            }
+                                        ]
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "flex-start justify-between px-6 py-4"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Label",
+                                                        "props": {
+                                                            "className": "form-label"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nhnkcp.settings.easy_pay_naverpay"
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "P",
+                                                        "props": {
+                                                            "className": "mt-1 text-xs text-amber-600 dark:text-amber-400"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nhnkcp.settings.easy_pay_naverpay_hint"
+                                                    }
+                                                ]
+                                            },
+                                            {
+                                                "type": "composite",
+                                                "name": "Toggle",
+                                                "props": {
+                                                    "name": "easy_pay_naverpay"
+                                                }
+                                            }
+                                        ]
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "flex-start justify-between px-6 py-4"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Label",
+                                                        "props": {
+                                                            "className": "form-label"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nhnkcp.settings.easy_pay_naverpay_point"
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "P",
+                                                        "props": {
+                                                            "className": "mt-1 text-xs text-amber-600 dark:text-amber-400"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nhnkcp.settings.easy_pay_naverpay_point_hint"
+                                                    }
+                                                ]
+                                            },
+                                            {
+                                                "type": "composite",
+                                                "name": "Toggle",
+                                                "props": {
+                                                    "name": "easy_pay_naverpay_point"
+                                                }
+                                            }
+                                        ]
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "flex-start justify-between px-6 py-4"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Label",
+                                                        "props": {
+                                                            "className": "form-label"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nhnkcp.settings.easy_pay_kakaopay"
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "P",
+                                                        "props": {
+                                                            "className": "mt-1 text-xs text-amber-600 dark:text-amber-400"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nhnkcp.settings.easy_pay_kakaopay_hint"
+                                                    }
+                                                ]
+                                            },
+                                            {
+                                                "type": "composite",
+                                                "name": "Toggle",
+                                                "props": {
+                                                    "name": "easy_pay_kakaopay"
+                                                }
+                                            }
+                                        ]
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "flex-start justify-between px-6 py-4"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Label",
+                                                        "props": {
+                                                            "className": "form-label"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nhnkcp.settings.easy_pay_applepay"
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "P",
+                                                        "props": {
+                                                            "className": "form-hint"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nhnkcp.settings.easy_pay_applepay_hint"
+                                                    }
+                                                ]
+                                            },
+                                            {
+                                                "type": "composite",
+                                                "name": "Toggle",
+                                                "props": {
+                                                    "name": "easy_pay_applepay"
+                                                }
+                                            }
+                                        ]
+                                    }
+                                ]
+                            }
+                        ]
+                    },
+                    {
+                        "id": "redirect_section",
+                        "type": "basic",
+                        "name": "Div",
+                        "props": {
+                            "className": "mt-6 bg-white dark:bg-gray-800 rounded-lg shadow-sm border border-gray-200 dark:border-gray-700"
+                        },
+                        "children": [
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": {
+                                    "className": "flex-start justify-between px-6 py-4"
+                                },
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "H3",
+                                        "props": {
+                                            "className": "text-error-strong"
+                                        },
+                                        "text": "$t:sirsoft-pay_nhnkcp.settings.section_redirect"
+                                    }
+                                ]
+                            },
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": {
+                                    "className": "p-6 space-y-6"
+                                },
+                                "children": [
+                                    {
+                                        "id": "field_redirect_success_url",
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "section-heading-md"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "props": {
+                                                    "className": "lg:col-span-1"
+                                                },
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Label",
+                                                        "props": {
+                                                            "className": "form-label"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nhnkcp.settings.redirect_success_url"
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "P",
+                                                        "props": {
+                                                            "className": "form-hint"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nhnkcp.settings.redirect_success_url_hint"
+                                                    }
+                                                ]
+                                            },
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "props": {
+                                                    "className": "lg:col-span-2"
+                                                },
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Input",
+                                                        "props": {
+                                                            "type": "text",
+                                                            "name": "redirect_success_url",
+                                                            "placeholder": "/shop/orders/{orderId}/complete",
+                                                            "className": "dark:focus:ring-blue-400 focus:border-transparent"
+                                                        }
+                                                    }
+                                                ]
+                                            }
+                                        ]
+                                    },
+                                    {
+                                        "id": "field_redirect_fail_url",
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "section-heading-md"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "props": {
+                                                    "className": "lg:col-span-1"
+                                                },
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Label",
+                                                        "props": {
+                                                            "className": "form-label"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nhnkcp.settings.redirect_fail_url"
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "P",
+                                                        "props": {
+                                                            "className": "form-hint"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nhnkcp.settings.redirect_fail_url_hint"
+                                                    }
+                                                ]
+                                            },
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "props": {
+                                                    "className": "lg:col-span-2"
+                                                },
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Input",
+                                                        "props": {
+                                                            "type": "text",
+                                                            "name": "redirect_fail_url",
+                                                            "placeholder": "/shop/checkout",
+                                                            "className": "dark:focus:ring-blue-400 focus:border-transparent"
+                                                        }
+                                                    }
+                                                ]
+                                            }
+                                        ]
+                                    }
+                                ]
+                            }
+                        ]
+                    },
+                    {
+                        "id": "vbank_settings_section",
+                        "type": "basic",
+                        "name": "Div",
+                        "props": {
+                            "className": "mt-6 bg-white dark:bg-gray-800 rounded-lg shadow-sm border border-gray-200 dark:border-gray-700"
+                        },
+                        "children": [
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": {
+                                    "className": "flex-start justify-between px-6 py-4"
+                                },
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "H3",
+                                        "props": {
+                                            "className": "text-error-strong"
+                                        },
+                                        "text": "$t:sirsoft-pay_nhnkcp.settings.section_vbank"
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "P",
+                                        "props": {
+                                            "className": "form-hint"
+                                        },
+                                        "text": "$t:sirsoft-pay_nhnkcp.settings.section_vbank_hint"
+                                    }
+                                ]
+                            },
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": {
+                                    "className": "p-6"
+                                },
+                                "children": [
+                                    {
+                                        "id": "field_vbank_expire_days",
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "section-heading-md"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "props": {
+                                                    "className": "lg:col-span-1"
+                                                },
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Label",
+                                                        "props": {
+                                                            "className": "form-label"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nhnkcp.settings.vbank_expire_days"
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "P",
+                                                        "props": {
+                                                            "className": "form-hint"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nhnkcp.settings.vbank_expire_days_hint"
+                                                    }
+                                                ]
+                                            },
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "props": {
+                                                    "className": "lg:col-span-2"
+                                                },
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Div",
+                                                        "props": {
+                                                            "className": "flex-center gap-2"
+                                                        },
+                                                        "children": [
+                                                            {
+                                                                "type": "basic",
+                                                                "name": "Input",
+                                                                "props": {
+                                                                    "type": "number",
+                                                                    "name": "vbank_expire_days",
+                                                                    "min": "1",
+                                                                    "max": "7",
+                                                                    "placeholder": "3",
+                                                                    "className": "w-24 dark:focus:ring-blue-400 focus:border-transparent"
+                                                                }
+                                                            },
+                                                            {
+                                                                "type": "basic",
+                                                                "name": "Span",
+                                                                "props": {
+                                                                    "className": "text-label-subtle"
+                                                                },
+                                                                "text": "$t:sirsoft-pay_nhnkcp.settings.vbank_expire_days_unit"
+                                                            }
+                                                        ]
+                                                    }
+                                                ]
+                                            }
+                                        ]
+                                    }
+                                ]
+                            }
+                        ]
+                    },
+                    {
+                        "id": "cancel_server_ip_notice",
+                        "type": "basic",
+                        "name": "Div",
+                        "props": {
+                            "className": "mt-6 bg-amber-50 dark:bg-amber-900/20 border border-amber-200 dark:border-amber-700 rounded-lg p-4"
+                        },
+                        "children": [
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": {
+                                    "className": "flex gap-3"
+                                },
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "Icon",
+                                        "props": {
+                                            "name": "triangle-exclamation",
+                                            "className": "w-5 h-5 text-amber-600 dark:text-amber-400 flex-shrink-0 mt-0.5"
+                                        }
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "flex-1 min-w-0"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "H3",
+                                                "props": {
+                                                    "className": "text-sm font-semibold text-warning-soft"
+                                                },
+                                                "text": "$t:sirsoft-pay_nhnkcp.settings.cancel_server_ip_title"
+                                            },
+                                            {
+                                                "type": "basic",
+                                                "name": "P",
+                                                "props": {
+                                                    "className": "mt-1 text-warning-soft"
+                                                },
+                                                "text": "$t:sirsoft-pay_nhnkcp.settings.cancel_server_ip_body"
+                                            },
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "props": {
+                                                    "className": "mt-3 rounded border border-amber-200 dark:border-amber-800 bg-white/70 dark:bg-gray-900/30 px-3 py-2"
+                                                },
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "P",
+                                                        "props": {
+                                                            "className": "text-xs font-medium text-amber-900 dark:text-amber-200"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nhnkcp.settings.cancel_server_ip_path"
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "P",
+                                                        "props": {
+                                                            "className": "mt-1 text-xs text-amber-800 dark:text-amber-100"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nhnkcp.settings.cancel_server_ip_effect"
+                                                    }
+                                                ]
+                                            },
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "props": {
+                                                    "className": "mt-3"
+                                                },
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "P",
+                                                        "props": {
+                                                            "className": "text-xs font-medium text-amber-900 dark:text-amber-200 mb-1.5"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nhnkcp.settings.cancel_server_ip_value_label"
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Div",
+                                                        "props": {
+                                                            "className": "flex-center gap-2"
+                                                        },
+                                                        "children": [
+                                                            {
+                                                                "type": "basic",
+                                                                "name": "Input",
+                                                                "props": {
+                                                                    "type": "text",
+                                                                    "readOnly": true,
+                                                                    "value": "{{health.data.summary.cancel_server_ip.address ?? ''}}",
+                                                                    "placeholder": "$t:sirsoft-pay_nhnkcp.settings.cancel_server_ip_unavailable",
+                                                                    "className": "input-readonly flex-1 font-mono"
+                                                                }
+                                                            },
+                                                            {
+                                                                "type": "basic",
+                                                                "name": "Button",
+                                                                "if": "{{!!health.data.summary.cancel_server_ip.address}}",
+                                                                "props": {
+                                                                    "className": "flex-center gap-1.5 px-3 py-2 bg-gray-100 dark:bg-gray-700 hover:bg-gray-200 dark:hover:bg-gray-600 text-body border border-gray-300 dark:border-gray-600 rounded-lg font-medium transition-colors whitespace-nowrap"
+                                                                },
+                                                                "actions": [
+                                                                    {
+                                                                        "type": "click",
+                                                                        "handler": "sequence",
+                                                                        "actions": [
+                                                                            {
+                                                                                "handler": "sirsoft-pay_nhnkcp.copyToClipboard",
+                                                                                "params": {
+                                                                                    "text": "{{health.data.summary.cancel_server_ip.address}}"
+                                                                                }
+                                                                            },
+                                                                            {
+                                                                                "handler": "toast",
+                                                                                "params": {
+                                                                                    "type": "success",
+                                                                                    "message": "$t:sirsoft-pay_nhnkcp.settings.cancel_server_ip_copied"
+                                                                                }
+                                                                            }
+                                                                        ]
+                                                                    }
+                                                                ],
+                                                                "children": [
+                                                                    {
+                                                                        "type": "basic",
+                                                                        "name": "Icon",
+                                                                        "props": {
+                                                                            "name": "copy",
+                                                                            "className": "w-4 h-4"
+                                                                        }
+                                                                    },
+                                                                    {
+                                                                        "type": "basic",
+                                                                        "name": "Span",
+                                                                        "text": "$t:sirsoft-pay_nhnkcp.settings.copy"
+                                                                    }
+                                                                ]
+                                                            }
+                                                        ]
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "P",
+                                                        "props": {
+                                                            "className": "mt-1.5 text-xs text-amber-800 dark:text-amber-100"
+                                                        },
+                                                        "text": "{{health.data.summary.cancel_server_ip.source_label ?? ''}}"
+                                                    }
+                                                ]
+                                            },
+                                            {
+                                                "type": "basic",
+                                                "name": "A",
+                                                "props": {
+                                                    "href": "https://partner.kcp.co.kr/",
+                                                    "target": "_blank",
+                                                    "rel": "noopener noreferrer",
+                                                    "className": "mt-3 inline-flex items-center gap-1.5 text-sm font-medium text-amber-800 hover:text-amber-950 dark:text-amber-200 dark:hover:text-amber-100"
+                                                },
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Icon",
+                                                        "props": {
+                                                            "name": "external-link",
+                                                            "className": "w-4 h-4"
+                                                        }
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Span",
+                                                        "text": "$t:sirsoft-pay_nhnkcp.settings.cancel_server_ip_link"
+                                                    }
+                                                ]
+                                            }
+                                        ]
+                                    }
+                                ]
+                            }
+                        ]
+                    },
+                    {
+                        "id": "vbank_notify_section",
+                        "type": "basic",
+                        "name": "Div",
+                        "props": {
+                            "className": "mt-6 bg-white dark:bg-gray-800 rounded-lg shadow-sm border border-blue-200 dark:border-blue-800"
+                        },
+                        "children": [
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": {
+                                    "className": "px-6 py-4 border-b border-blue-200 dark:border-blue-800 bg-blue-50 dark:bg-blue-900/20 rounded-t-lg"
+                                },
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "flex-center gap-2"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Icon",
+                                                "props": {
+                                                    "name": "bell",
+                                                    "className": "w-4 h-4 text-blue-600 dark:text-blue-400"
+                                                }
+                                            },
+                                            {
+                                                "type": "basic",
+                                                "name": "H3",
+                                                "props": {
+                                                    "className": "text-base font-semibold text-blue-900 dark:text-blue-100"
+                                                },
+                                                "text": "$t:sirsoft-pay_nhnkcp.settings.section_vbank_notify"
+                                            }
+                                        ]
+                                    }
+                                ]
+                            },
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": {
+                                    "className": "p-6"
+                                },
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "P",
+                                        "props": {
+                                            "className": "text-label mb-3"
+                                        },
+                                        "text": "$t:sirsoft-pay_nhnkcp.settings.vbank_notify_hint"
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "P",
+                                        "props": {
+                                            "className": "text-xs text-gray-600 dark:text-gray-400 mb-4"
+                                        },
+                                        "text": "$t:sirsoft-pay_nhnkcp.settings.vbank_notify_path"
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "flex-center gap-2"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Input",
+                                                "props": {
+                                                    "type": "text",
+                                                    "readOnly": true,
+                                                    "value": "{{_local.vbankInfo?.url ?? '/plugins/sirsoft-pay_nhnkcp/payment/vbank-notify'}}",
+                                                    "className": "input-readonly flex-1 font-mono"
+                                                }
+                                            },
+                                            {
+                                                "type": "basic",
+                                                "name": "Button",
+                                                "props": {
+                                                    "className": "flex-center gap-1.5 px-3 py-2 bg-gray-100 dark:bg-gray-700 hover:bg-gray-200 dark:hover:bg-gray-600 text-body border border-gray-300 dark:border-gray-600 rounded-lg font-medium transition-colors whitespace-nowrap"
+                                                },
+                                                "actions": [
+                                                    {
+                                                        "type": "click",
+                                                        "handler": "sequence",
+                                                        "actions": [
+                                                            {
+                                                                "handler": "sirsoft-pay_nhnkcp.copyToClipboard",
+                                                                "params": {
+                                                                    "text": "{{_local.vbankInfo?.url ?? '/plugins/sirsoft-pay_nhnkcp/payment/vbank-notify'}}"
+                                                                }
+                                                            },
+                                                            {
+                                                                "handler": "toast",
+                                                                "params": {
+                                                                    "type": "success",
+                                                                    "message": "$t:sirsoft-pay_nhnkcp.settings.vbank_notify_copied"
+                                                                }
+                                                            }
+                                                        ]
+                                                    }
+                                                ],
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Icon",
+                                                        "props": {
+                                                            "name": "copy",
+                                                            "className": "w-4 h-4"
+                                                        }
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Span",
+                                                        "text": "$t:sirsoft-pay_nhnkcp.settings.copy"
+                                                    }
+                                                ]
+                                            }
+                                        ]
+                                    }
+                                ]
+                            }
+                        ]
+                    },
+                    {
+                        "id": "escrow_settings_section",
+                        "type": "basic",
+                        "name": "Div",
+                        "props": {
+                            "className": "mt-6 bg-white dark:bg-gray-800 rounded-lg shadow-sm border border-gray-200 dark:border-gray-700"
+                        },
+                        "children": [
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": {
+                                    "className": "flex-start justify-between px-6 py-4"
+                                },
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": { "className": "flex-center gap-2" },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Icon",
+                                                "props": { "name": "shield-check", "className": "text-secondary w-4 h-4" }
+                                            },
+                                            {
+                                                "type": "basic",
+                                                "name": "H3",
+                                                "props": { "className": "text-base font-semibold text-gray-900 dark:text-gray-100" },
+                                                "text": "$t:sirsoft-pay_nhnkcp.settings.section_escrow"
+                                            }
+                                        ]
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "P",
+                                        "props": { "className": "mt-1 text-label-subtle" },
+                                        "text": "$t:sirsoft-pay_nhnkcp.settings.section_escrow_hint"
+                                    }
+                                ]
+                            },
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": { "className": "p-6 space-y-4" },
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": { "className": "flex items-center justify-between" },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Label",
+                                                        "props": { "className": "form-label" },
+                                                        "text": "$t:sirsoft-pay_nhnkcp.settings.use_escrow"
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "P",
+                                                        "props": { "className": "form-hint" },
+                                                        "text": "$t:sirsoft-pay_nhnkcp.settings.use_escrow_hint"
+                                                    }
+                                                ]
+                                            },
+                                            {
+                                                "type": "composite",
+                                                "name": "Toggle",
+                                                "props": { "name": "use_escrow" }
+                                            }
+                                        ]
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "if": "{{_local.form.use_escrow && _local.form.is_test_mode}}",
+                                        "props": { "className": "section-heading-md" },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "props": { "className": "lg:col-span-1" },
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Label",
+                                                        "props": { "className": "form-label" },
+                                                        "text": "$t:sirsoft-pay_nhnkcp.settings.escrow_test_site_cd"
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "P",
+                                                        "props": { "className": "form-hint" },
+                                                        "text": "$t:sirsoft-pay_nhnkcp.settings.escrow_test_site_cd_hint"
+                                                    }
+                                                ]
+                                            },
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "props": { "className": "lg:col-span-2" },
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Input",
+                                                        "props": {
+                                                            "type": "text",
+                                                            "name": "escrow_test_site_cd",
+                                                            "placeholder": "T0007",
+                                                            "className": "dark:focus:ring-blue-400 focus:border-transparent"
+                                                        }
+                                                    }
+                                                ]
+                                            }
+                                        ]
+                                    }
+                                ]
+                            }
+                        ]
+                    },
+                    {
+                        "id": "escrow_notify_section",
+                        "type": "basic",
+                        "name": "Div",
+                        "if": "{{_local.form.use_escrow}}",
+                        "props": {
+                            "className": "mt-6 bg-white dark:bg-gray-800 rounded-lg shadow-sm border border-purple-200 dark:border-purple-800"
+                        },
+                        "children": [
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": {
+                                    "className": "px-6 py-4 border-b border-purple-200 dark:border-purple-800 bg-purple-50 dark:bg-purple-900/20 rounded-t-lg"
+                                },
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": { "className": "flex-center gap-2" },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Icon",
+                                                "props": { "name": "bell", "className": "w-4 h-4 text-purple-600 dark:text-purple-400" }
+                                            },
+                                            {
+                                                "type": "basic",
+                                                "name": "H3",
+                                                "props": { "className": "text-base font-semibold text-purple-900 dark:text-purple-100" },
+                                                "text": "$t:sirsoft-pay_nhnkcp.settings.section_escrow_notify"
+                                            }
+                                        ]
+                                    }
+                                ]
+                            },
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": { "className": "p-6" },
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "P",
+                                        "props": { "className": "text-label mb-3" },
+                                        "text": "$t:sirsoft-pay_nhnkcp.settings.escrow_common_notify_hint"
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": { "className": "flex-center gap-2" },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Input",
+                                                "props": {
+                                                    "type": "text",
+                                                    "readOnly": true,
+                                                    "value": "{{_local.vbankInfo?.escrow_common_notify_url ?? '/plugins/sirsoft-pay_nhnkcp/payment/escrow-common-notify'}}",
+                                                    "className": "input-readonly flex-1 font-mono"
+                                                }
+                                            },
+                                            {
+                                                "type": "basic",
+                                                "name": "Button",
+                                                "props": {
+                                                    "className": "flex-center gap-1.5 px-3 py-2 bg-gray-100 dark:bg-gray-700 hover:bg-gray-200 dark:hover:bg-gray-600 text-body border border-gray-300 dark:border-gray-600 rounded-lg font-medium transition-colors whitespace-nowrap"
+                                                },
+                                                "actions": [
+                                                    {
+                                                        "type": "click",
+                                                        "handler": "sequence",
+                                                        "actions": [
+                                                            {
+                                                                "handler": "sirsoft-pay_nhnkcp.copyToClipboard",
+                                                                "params": {
+                                                                    "text": "{{_local.vbankInfo?.escrow_common_notify_url ?? '/plugins/sirsoft-pay_nhnkcp/payment/escrow-common-notify'}}"
+                                                                }
+                                                            },
+                                                            {
+                                                                "handler": "toast",
+                                                                "params": {
+                                                                    "type": "success",
+                                                                    "message": "$t:sirsoft-pay_nhnkcp.settings.escrow_common_notify_copied"
+                                                                }
+                                                            }
+                                                        ]
+                                                    }
+                                                ],
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Icon",
+                                                        "props": { "name": "copy", "className": "w-4 h-4" }
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Span",
+                                                        "text": "$t:sirsoft-pay_nhnkcp.settings.copy"
+                                                    }
+                                                ]
+                                            }
+                                        ]
+                                    }
+                                ]
+                            }
+                        ]
+                    },
+                    {
+                        "id": "footer_buttons",
+                        "type": "basic",
+                        "name": "Div",
+                        "props": {
+                            "className": "sticky bottom-0 z-10 flex justify-end items-center gap-3 mt-6 px-4 py-3 bg-gray-50 border border-gray-200 rounded-lg dark:bg-gray-800 dark:border-gray-700"
+                        },
+                        "children": [
+                            {
+                                "id": "cancel_button",
+                                "type": "basic",
+                                "name": "Button",
+                                "props": {
+                                    "className": "btn btn-secondary"
+                                },
+                                "actions": [
+                                    {
+                                        "type": "click",
+                                        "handler": "navigate",
+                                        "params": {
+                                            "path": "/admin/plugins"
+                                        }
+                                    }
+                                ],
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "Span",
+                                        "text": "$t:common.cancel"
+                                    }
+                                ]
+                            },
+                            {
+                                "id": "save_button",
+                                "type": "basic",
+                                "name": "Button",
+                                "props": {
+                                    "disabled": "{{!_local.hasChanges || _local.isSaving}}",
+                                    "className": "btn btn-primary flex-center gap-1.5"
+                                },
+                                "actions": [
+                                    {
+                                        "type": "click",
+                                        "handler": "sequence",
+                                        "actions": [
+                                            {
+                                                "handler": "setState",
+                                                "params": {
+                                                    "target": "local",
+                                                    "isSaving": true,
+                                                    "errors": null
+                                                }
+                                            },
+                                            {
+                                                "handler": "apiCall",
+                                                "auth_required": true,
+                                                "target": "/api/admin/plugins/{{route.identifier}}/settings",
+                                                "params": {
+                                                    "method": "PUT",
+                                                    "body": "{{_local.form}}"
+                                                },
+                                                "onSuccess": [
+                                                    {
+                                                        "handler": "setState",
+                                                        "params": {
+                                                            "target": "local",
+                                                            "isSaving": false,
+                                                            "hasChanges": false
+                                                        }
+                                                    },
+                                                    {
+                                                        "handler": "toast",
+                                                        "params": {
+                                                            "type": "success",
+                                                            "message": "$t:admin.plugins.settings.save_success"
+                                                        }
+                                                    },
+                                                    {
+                                                        "handler": "refetchDataSource",
+                                                        "params": {
+                                                            "dataSourceId": "settings"
+                                                        }
+                                                    }
+                                                ],
+                                                "onError": [
+                                                    {
+                                                        "handler": "setState",
+                                                        "params": {
+                                                            "target": "local",
+                                                            "isSaving": false,
+                                                            "errors": "{{$error.errors}}"
+                                                        }
+                                                    },
+                                                    {
+                                                        "handler": "toast",
+                                                        "params": {
+                                                            "type": "error",
+                                                            "message": "$t:admin.plugins.settings.save_error"
+                                                        }
+                                                    }
+                                                ]
+                                            }
+                                        ]
+                                    }
+                                ],
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "Icon",
+                                        "if": "{{_local.isSaving}}",
+                                        "props": {
+                                            "name": "spinner",
+                                            "className": "spinner-sm"
+                                        }
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "Span",
+                                        "if": "{{!_local.isSaving}}",
+                                        "text": "$t:common.save"
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "Span",
+                                        "if": "{{_local.isSaving}}",
+                                        "text": "$t:common.saving"
+                                    }
+                                ]
+                            }
+                        ]
+                    }
+                ]
+            }
+        ]
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Concerns/IssuesReceiptCookie.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Concerns/IssuesReceiptCookie.php
new file mode 100644
index 00000000..84666529
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Concerns/IssuesReceiptCookie.php
@@ -0,0 +1,69 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Concerns;
+
+use Illuminate\Cookie\CookieJar;
+use Symfony\Component\HttpFoundation\Cookie;
+
+trait IssuesReceiptCookie
+{
+    public const RECEIPT_COOKIE_NAME = 'nhnkcp_receipt_token';
+    private const RECEIPT_COOKIE_TTL_MINUTES = 5;
+
+    protected function queueReceiptCookie(string $orderNumber): void
+    {
+        $expiresTs = time() + (self::RECEIPT_COOKIE_TTL_MINUTES * 60);
+        $signature = $this->signReceiptToken($orderNumber, $expiresTs);
+        $tokenValue = $orderNumber.'|'.$expiresTs.'|'.$signature;
+
+        /** @var CookieJar $jar */
+        $jar = app(CookieJar::class);
+
+        $jar->queue(new Cookie(
+            name: self::RECEIPT_COOKIE_NAME,
+            value: $tokenValue,
+            expire: $expiresTs,
+            path: '/',
+            domain: null,
+            secure: request()->isSecure(),
+            httpOnly: true,
+            raw: false,
+            sameSite: Cookie::SAMESITE_LAX,
+        ));
+    }
+
+    protected function verifyReceiptCookie(?string $cookieValue, string $expectedOrderNumber): bool
+    {
+        if (! is_string($cookieValue) || $cookieValue === '') {
+            return false;
+        }
+
+        $parts = explode('|', $cookieValue);
+        if (count($parts) !== 3) {
+            return false;
+        }
+
+        [$orderNumber, $expiresTs, $signature] = $parts;
+
+        if ($orderNumber !== $expectedOrderNumber) {
+            return false;
+        }
+
+        if (! ctype_digit($expiresTs) || (int) $expiresTs < time()) {
+            return false;
+        }
+
+        if (! ctype_xdigit($signature) || strlen($signature) !== 64) {
+            return false;
+        }
+
+        return hash_equals($this->signReceiptToken($orderNumber, (int) $expiresTs), $signature);
+    }
+
+    private function signReceiptToken(string $orderNumber, int $expiresTs): string
+    {
+        return hash_hmac('sha256', $orderNumber.'|'.$expiresTs, (string) config('app.key', ''));
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Concerns/PreventsReplayCallback.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Concerns/PreventsReplayCallback.php
new file mode 100644
index 00000000..7098d2af
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Concerns/PreventsReplayCallback.php
@@ -0,0 +1,57 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Concerns;
+
+use Illuminate\Support\Facades\Log;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentStatusEnum;
+use Modules\Sirsoft\Ecommerce\Models\OrderPayment;
+
+/**
+ * Plugin 측 replay attack 방어 — 동일 PG 거래 ID 의 중복 콜백을 멱등 처리.
+ *
+ * `g7_ecommerce_order_payments.transaction_id` 컬럼은 DB unique 제약이 없으므로
+ * 동일 transaction_id 로 콜백이 두 번 도착하면 두 번 `completePayment()` 가
+ * 실행되어 중복 처리될 위험이 있다 (예: 결제완료 알림 중복, 마일리지 중복 적립).
+ *
+ * 본 트레이트는 콜백 진입 시점에 OrderPayment 를 조회하여 이미 `paid` 상태이면
+ * 멱등 분기로 조기 리턴하도록 한다. modules 영역의 schema 는 변경하지 않고
+ * plugin scope 내에서만 처리한다.
+ */
+trait PreventsReplayCallback
+{
+    /**
+     * 동일 transaction_id 가 이미 paid 상태로 저장되었는지 확인.
+     *
+     * @param  string|null  $transactionId  PG 거래 ID (NHN KCP: tno)
+     * @return bool true 면 중복 콜백 — 멱등 응답으로 처리해야 함
+     */
+    protected function wasAlreadyPaid(?string $transactionId): bool
+    {
+        if ($transactionId === null || $transactionId === '') {
+            return false;
+        }
+
+        return OrderPayment::query()
+            ->where('transaction_id', $transactionId)
+            ->where('payment_status', PaymentStatusEnum::PAID)
+            ->exists();
+    }
+
+    /**
+     * Replay 감지를 로깅. 통일된 로그 형식으로 운영 모니터링 용이성 확보.
+     *
+     * @param  string  $tid  PG 거래 ID
+     * @param  string|null  $moid  주문번호 (있을 경우)
+     * @param  string  $context  콜백 종류 (authCallback / vbankNotify 등)
+     */
+    protected function logReplayDetected(string $tid, ?string $moid, string $context): void
+    {
+        Log::info('NHN KCP: replay detected — already paid, returning idempotent response', [
+            'tid'     => $tid,
+            'moid'    => $moid,
+            'context' => $context,
+        ]);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Concerns/RecordsPaymentWindowClosure.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Concerns/RecordsPaymentWindowClosure.php
new file mode 100644
index 00000000..ea971df7
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Concerns/RecordsPaymentWindowClosure.php
@@ -0,0 +1,250 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Concerns;
+
+use InvalidArgumentException;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Log;
+use Modules\Sirsoft\Ecommerce\Enums\OrderStatusEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentStatusEnum;
+use Modules\Sirsoft\Ecommerce\Models\Order;
+use Modules\Sirsoft\Ecommerce\Models\OrderAddress;
+use Modules\Sirsoft\Ecommerce\Models\OrderPayment;
+use Modules\Sirsoft\Ecommerce\Services\CurrencyConversionService;
+use Modules\Sirsoft\Ecommerce\Services\OrderProcessingService;
+
+trait RecordsPaymentWindowClosure
+{
+    private const KCP_PROVIDER = 'nhnkcp';
+
+    protected function expectedPaymentPrice(Order $order): int
+    {
+        // 결제 청구액 SSoT = 결제 통화(order_currency) 환산액. base(total_due_amount) 직접 비교 시
+        // base≠결제 통화에서 PG 청구 통화와 단위가 어긋난다(buildPgPaymentData 와 동일 기준).
+        return app(CurrencyConversionService::class)->resolveOrderPaymentChargeAmount($order);
+    }
+
+    protected function resolveExpectedPaymentPriceOrNull(Order $order, string $context, array $logContext = []): ?int
+    {
+        try {
+            return $this->expectedPaymentPrice($order);
+        } catch (InvalidArgumentException $e) {
+            $this->logInvalidPaymentCurrency($order, $e, $context, $logContext);
+
+            return null;
+        }
+    }
+
+    protected function logInvalidPaymentCurrency(
+        Order $order,
+        InvalidArgumentException $e,
+        string $context,
+        array $logContext = [],
+    ): void {
+        Log::error('NHN KCP: payment currency is not chargeable', array_merge([
+            'context' => $context,
+            'order_id' => $order->id,
+            'order_number' => $order->order_number,
+            'currency' => $order->currency,
+            'currency_snapshot' => $order->currency_snapshot,
+            'error' => $e->getMessage(),
+        ], $logContext));
+    }
+
+    protected function requestMatchesOrderBuyer(Request $request, Order $order): bool
+    {
+        /** @var OrderAddress|null $address */
+        $address = $order->shippingAddress;
+        if (! $address) {
+            return true;
+        }
+
+        $expectedEmail = strtolower(trim((string) $address->orderer_email));
+        if ($expectedEmail !== '') {
+            $receivedEmail = strtolower(trim((string) $request->input('buyer_email', '')));
+            if ($receivedEmail === '' || $receivedEmail !== $expectedEmail) {
+                return false;
+            }
+        }
+
+        $expectedPhone = $this->digitsOnly((string) $address->orderer_phone);
+        if ($expectedPhone !== '') {
+            $receivedPhone = $this->digitsOnly((string) $request->input('buyer_phone', ''));
+            if ($receivedPhone === '' || $receivedPhone !== $expectedPhone) {
+                return false;
+            }
+        }
+
+        return true;
+    }
+
+    protected function markPaymentWindowClosed(
+        OrderProcessingService $orderService,
+        Order $order,
+        string $failureCode,
+        string $failureMessage,
+        ?string $cancelMessage = null,
+    ): Order {
+        if (! $order->order_status->isBeforePayment()) {
+            return $order;
+        }
+
+        $failedOrder = $orderService->failPayment($order, $failureCode, $failureMessage);
+
+        $cancelledOrder = $orderService->recordPaymentCancellation(
+            $failedOrder,
+            $failureCode,
+            $cancelMessage ?: $failureMessage,
+        );
+
+        return $this->markKcpPaymentFailureRecord(
+            $cancelledOrder,
+            $failureCode,
+            $cancelMessage ?: $failureMessage,
+            'window_closed',
+            PaymentStatusEnum::CANCELLED,
+        );
+    }
+
+    protected function markKcpPaymentFailureRecord(
+        Order $order,
+        string $failureCode,
+        string $failureMessage,
+        string $failureStage,
+        PaymentStatusEnum $paymentStatus = PaymentStatusEnum::FAILED,
+    ): Order {
+        /** @var OrderPayment|null $payment */
+        $payment = $order->payment;
+        if (! $payment || ! $payment->exists) {
+            return $order;
+        }
+
+        $now = now()->toIso8601String();
+        $paymentMeta = $payment->payment_meta ?? [];
+        $history = $paymentMeta['failure_history'] ?? [];
+        $history = is_array($history) ? $history : [];
+        $history[] = [
+            'code' => $failureCode,
+            'message' => $failureMessage,
+            'stage' => $failureStage,
+            'failed_at' => $now,
+        ];
+
+        $paymentMeta['failure_history'] = array_slice($history, -5);
+        $paymentMeta['failure_source'] = self::KCP_PROVIDER;
+        $paymentMeta['failure_code'] = $failureCode;
+        $paymentMeta['failure_message'] = $failureMessage;
+        $paymentMeta['failure_stage'] = $failureStage;
+        $paymentMeta['failed_at'] = $now;
+
+        $payment->update([
+            'pg_provider' => self::KCP_PROVIDER,
+            'payment_status' => $paymentStatus->value,
+            'payment_meta' => $paymentMeta,
+        ]);
+
+        return $order->fresh('payment') ?? $order;
+    }
+
+    protected function restoreRetryableKcpOrder(Order $order, ?int $amount = null): bool
+    {
+        /** @var OrderPayment|null $payment */
+        $payment = $order->payment;
+        if (! $payment || ! $payment->exists) {
+            return false;
+        }
+
+        if ($amount !== null) {
+            $expectedAmount = $this->resolveExpectedPaymentPriceOrNull($order, 'retry_restore', [
+                'received_amount' => $amount,
+            ]);
+            if ($expectedAmount === null || $amount !== $expectedAmount) {
+                return false;
+            }
+        }
+
+        if (! $this->isRetryableKcpFailure($order, $payment)) {
+            return false;
+        }
+
+        DB::transaction(function () use ($order, $payment) {
+            $now = now()->toIso8601String();
+            $orderMeta = $order->order_meta ?? [];
+            $paymentMeta = $payment->payment_meta ?? [];
+
+            $previousFailure = array_filter([
+                'code' => $orderMeta['payment_failure_code'] ?? $paymentMeta['failure_code'] ?? null,
+                'message' => $orderMeta['payment_failure_message'] ?? $paymentMeta['failure_message'] ?? null,
+                'failed_at' => $orderMeta['payment_failed_at'] ?? $paymentMeta['failed_at'] ?? null,
+                'stage' => $paymentMeta['failure_stage'] ?? null,
+            ], fn ($value) => $value !== null && $value !== '');
+
+            if ($previousFailure !== []) {
+                $retryFailures = $orderMeta['nhnkcp_retry_failures'] ?? [];
+                $retryFailures = is_array($retryFailures) ? $retryFailures : [];
+                $retryFailures[] = $previousFailure;
+                $orderMeta['nhnkcp_retry_failures'] = array_slice($retryFailures, -5);
+            }
+
+            unset(
+                $orderMeta['payment_failure_code'],
+                $orderMeta['payment_failure_message'],
+                $orderMeta['payment_failed_at'],
+                $paymentMeta['failure_code'],
+                $paymentMeta['failure_message'],
+                $paymentMeta['failure_source'],
+                $paymentMeta['failure_stage'],
+                $paymentMeta['failed_at'],
+            );
+
+            $orderMeta['nhnkcp_retry_count'] = (int) ($orderMeta['nhnkcp_retry_count'] ?? 0) + 1;
+            $orderMeta['nhnkcp_retry_started_at'] = $now;
+            $paymentMeta['retry_count'] = (int) ($paymentMeta['retry_count'] ?? 0) + 1;
+            $paymentMeta['retry_started_at'] = $now;
+
+            $order->update([
+                'order_status' => OrderStatusEnum::PENDING_ORDER,
+                'order_meta' => $orderMeta,
+            ]);
+
+            $payment->update([
+                'payment_status' => PaymentStatusEnum::READY->value,
+                'payment_meta' => $paymentMeta,
+                'paid_at' => null,
+                'cancelled_at' => null,
+                'transaction_id' => null,
+                'card_approval_number' => null,
+            ]);
+        });
+
+        Log::info('KCP: retryable failed order restored', [
+            'ordr_idxx' => $order->order_number,
+            'payment_id' => $payment->id,
+        ]);
+
+        return true;
+    }
+
+    private function isRetryableKcpFailure(Order $order, OrderPayment $payment): bool
+    {
+        $paymentMeta = $payment->payment_meta ?? [];
+        $failureCode = (string) ($paymentMeta['failure_code'] ?? $order->order_meta['payment_failure_code'] ?? '');
+
+        return $order->order_status === OrderStatusEnum::CANCELLED
+            && $payment->pg_provider === self::KCP_PROVIDER
+            && in_array($payment->payment_status, [PaymentStatusEnum::FAILED, PaymentStatusEnum::CANCELLED], true)
+            && ($paymentMeta['failure_source'] ?? null) === self::KCP_PROVIDER
+            && $failureCode !== 'AMOUNT_MISMATCH'
+            && blank($payment->transaction_id)
+            && blank($payment->card_approval_number)
+            && $payment->paid_at === null;
+    }
+
+    protected function digitsOnly(string $value): string
+    {
+        return preg_replace('/[^0-9]/', '', $value) ?? '';
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Concerns/ResolvesEasyPayDisplay.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Concerns/ResolvesEasyPayDisplay.php
new file mode 100644
index 00000000..21e38d48
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Concerns/ResolvesEasyPayDisplay.php
@@ -0,0 +1,181 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Concerns;
+
+use Modules\Sirsoft\Ecommerce\Enums\PaymentMethodEnum;
+
+trait ResolvesEasyPayDisplay
+{
+    private const EASY_PAY_METHODS = [
+        'nhnkcp_payco' => [
+            'provider' => 'payco',
+            'label' => ['ko' => 'PAYCO (페이코)', 'en' => 'PAYCO'],
+        ],
+        'nhnkcp_naverpay' => [
+            'provider' => 'naverpay',
+            'label' => ['ko' => '네이버페이', 'en' => 'NaverPay'],
+        ],
+        'nhnkcp_naverpay_point' => [
+            'provider' => 'naverpay_point',
+            'label' => ['ko' => '네이버페이 포인트결제', 'en' => 'NaverPay Point'],
+        ],
+        'nhnkcp_kakaopay' => [
+            'provider' => 'kakaopay',
+            'label' => ['ko' => '카카오페이', 'en' => 'KakaoPay'],
+        ],
+        'nhnkcp_applepay' => [
+            'provider' => 'applepay',
+            'label' => ['ko' => '애플페이', 'en' => 'Apple Pay'],
+        ],
+    ];
+
+    /**
+     * @return array{method: string, provider: string, label: array{ko: string, en: string}}|array{}
+     */
+    protected function resolveEasyPayMeta(array $payload): array
+    {
+        $method = strtolower(trim((string) ($payload['nhnkcp_easy_pay_method'] ?? $payload['param_opt_1'] ?? '')));
+        if (! isset(self::EASY_PAY_METHODS[$method])) {
+            return [];
+        }
+
+        $definition = self::EASY_PAY_METHODS[$method];
+
+        return [
+            'method' => $method,
+            'provider' => $definition['provider'],
+            'label' => $definition['label'],
+        ];
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    protected function decodePaymentMeta(mixed $paymentMeta): array
+    {
+        if (is_array($paymentMeta)) {
+            return $paymentMeta;
+        }
+
+        if (! is_string($paymentMeta) || trim($paymentMeta) === '') {
+            return [];
+        }
+
+        $decoded = json_decode($paymentMeta, true);
+
+        return is_array($decoded) ? $decoded : [];
+    }
+
+    /**
+     * @return array{
+     *     payment_method_label: string|null,
+     *     payment_method_display_label: string|null,
+     *     selected_payment_method: string|null,
+     *     embedded_pg_provider: string|null,
+     *     embedded_pg_provider_label: string|null
+     * }
+     */
+    protected function resolvePaymentDisplay(object $payment): array
+    {
+        $paymentMeta = $this->decodePaymentMeta($payment->payment_meta ?? null);
+        $selectedPaymentMethod = $this->stringOrNull($paymentMeta['nhnkcp_easy_pay_method'] ?? null);
+        $provider = $this->stringOrNull(
+            $payment->embedded_pg_provider
+                ?? $paymentMeta['nhnkcp_easy_pay_provider']
+                ?? $paymentMeta['embedded_pg_provider']
+                ?? null
+        );
+
+        if ($provider === null && $selectedPaymentMethod !== null) {
+            $provider = $this->stringOrNull(self::EASY_PAY_METHODS[$selectedPaymentMethod]['provider'] ?? null);
+        }
+
+        $baseLabel = $this->paymentMethodLabel($this->stringOrNull($payment->payment_method ?? null));
+        $embeddedLabel = $this->embeddedPgProviderLabel($provider, $paymentMeta);
+
+        return [
+            'payment_method_label' => $baseLabel,
+            'payment_method_display_label' => $this->paymentMethodDisplayLabel($baseLabel, $embeddedLabel),
+            'selected_payment_method' => $selectedPaymentMethod,
+            'embedded_pg_provider' => $provider,
+            'embedded_pg_provider_label' => $embeddedLabel,
+        ];
+    }
+
+    protected function paymentMethodLabel(?string $method): ?string
+    {
+        if ($method === null || $method === '') {
+            return null;
+        }
+
+        return PaymentMethodEnum::tryFrom($method)?->label() ?? $method;
+    }
+
+    protected function paymentMethodDisplayLabel(?string $baseLabel, ?string $embeddedLabel): ?string
+    {
+        if ($baseLabel === null || $baseLabel === '') {
+            return $embeddedLabel;
+        }
+
+        if ($embeddedLabel === null || $embeddedLabel === '') {
+            return $baseLabel;
+        }
+
+        return $embeddedLabel . ' (' . $baseLabel . ')';
+    }
+
+    /**
+     * @param array<string, mixed> $paymentMeta
+     */
+    protected function embeddedPgProviderLabel(?string $provider, array $paymentMeta = []): ?string
+    {
+        $metaLabel = $this->localizedLabel($paymentMeta['nhnkcp_easy_pay_label'] ?? null)
+            ?? $this->localizedLabel($paymentMeta['embedded_pg_provider_label'] ?? null);
+
+        if ($metaLabel !== null) {
+            return $metaLabel;
+        }
+
+        if ($provider === null || $provider === '') {
+            return null;
+        }
+
+        foreach (self::EASY_PAY_METHODS as $definition) {
+            if (($definition['provider'] ?? null) === $provider) {
+                return $this->localizedLabel($definition['label'] ?? null);
+            }
+        }
+
+        return null;
+    }
+
+    private function localizedLabel(mixed $label): ?string
+    {
+        if (is_string($label) && trim($label) !== '') {
+            return $label;
+        }
+
+        if (! is_array($label)) {
+            return null;
+        }
+
+        $locale = app()->getLocale();
+
+        return $this->stringOrNull($label[$locale] ?? null)
+            ?? $this->stringOrNull($label['ko'] ?? null)
+            ?? $this->stringOrNull($label['en'] ?? null);
+    }
+
+    private function stringOrNull(mixed $value): ?string
+    {
+        if (! is_string($value)) {
+            return null;
+        }
+
+        $value = trim($value);
+
+        return $value === '' ? null : $value;
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Concerns/SanitizesPgResponse.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Concerns/SanitizesPgResponse.php
new file mode 100644
index 00000000..a9839b43
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Concerns/SanitizesPgResponse.php
@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Concerns;
+
+trait SanitizesPgResponse
+{
+    /**
+     * PG 응답 원문 대신 운영에 필요한 필드만 남긴다.
+     *
+     * 카드번호, 구매자 연락처, 가상계좌번호처럼 PG 응답에 섞일 수 있는 민감 필드는
+     * whitelist 에 넣지 않는 방식으로 차단한다. 기존 관리자 조회 호환을 위해
+     * payment_meta.pg_raw_response 키는 유지하되 내용은 sanitized subset 이다.
+     */
+    protected function sanitizePgResponse(array $response, array $allowedKeys): array
+    {
+        $allowed = array_flip($allowedKeys);
+        $sanitized = [];
+
+        foreach ($response as $key => $value) {
+            if (! isset($allowed[$key])) {
+                continue;
+            }
+
+            $sanitized[$key] = is_scalar($value) || $value === null
+                ? $value
+                : json_encode($value, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
+        }
+
+        return $sanitized;
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Concerns/SendsKcpNotifyResponse.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Concerns/SendsKcpNotifyResponse.php
new file mode 100644
index 00000000..fdbfcfc7
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Concerns/SendsKcpNotifyResponse.php
@@ -0,0 +1,43 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Concerns;
+
+use Illuminate\Http\Response;
+
+/**
+ * KCP 공통통보 webhook 표준 응답 헬퍼 (그누보드5 settle_kcp_common.php 동일 패턴)
+ *
+ * KCP 는 응답 body 의 <input name="result"> 값을 파싱한다.
+ *   - result="0000" → 통보 성공 인정 (재시도 차단)
+ *   - 그 외        → 재통보 (최대 10회, 0/5/5/10/20/40/80/160/320/640분)
+ *
+ * vbank-notify / escrow-common-notify 등 KCP 서버 발신 webhook 모두 동일 형식 사용.
+ */
+trait SendsKcpNotifyResponse
+{
+    /**
+     * KCP 표준 통보 응답 (HTML form 으로 result 코드 전달)
+     *
+     * @param  string  $resultCode  통보 처리 결과 ("0000" 성공 / 그 외 재통보 유도)
+     * @return Response 200 + KCP 표준 HTML body
+     */
+    protected function kcpNotifyResponse(string $resultCode = '0000'): Response
+    {
+        $safeCode = htmlspecialchars($resultCode, ENT_QUOTES, 'UTF-8');
+        $html = '<html><body><form><input type="hidden" name="result" value="'.$safeCode.'"></form></body></html>';
+
+        return response($html, 200)->header('Content-Type', 'text/html; charset=utf-8');
+    }
+
+    /**
+     * 재통보 유도 응답 (DB 일시적 오류 등 — KCP 가 재시도)
+     *
+     * @return Response 200 + result="9999" HTML
+     */
+    protected function kcpNotifyRetry(): Response
+    {
+        return $this->kcpNotifyResponse('9999');
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Concerns/SerializesPaymentCallbacks.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Concerns/SerializesPaymentCallbacks.php
new file mode 100644
index 00000000..4c001a6f
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Concerns/SerializesPaymentCallbacks.php
@@ -0,0 +1,57 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Concerns;
+
+use Illuminate\Contracts\Cache\LockTimeoutException;
+use Illuminate\Support\Facades\Cache;
+use Illuminate\Support\Facades\Log;
+
+trait SerializesPaymentCallbacks
+{
+    protected function acquireOrderCallbackLock(string $context, string $orderNumber): mixed
+    {
+        $key = $this->callbackLockKey($context, $orderNumber);
+        $lock = Cache::lock($key, $this->callbackLockTtlSeconds());
+
+        try {
+            $lock->block($this->callbackLockWaitSeconds());
+        } catch (LockTimeoutException $e) {
+            Log::warning('NHN KCP: callback lock timeout', [
+                'context' => $context,
+                'order_number' => $orderNumber,
+                'lock_key' => $key,
+            ]);
+
+            throw $e;
+        }
+
+        return $lock;
+    }
+
+    protected function releaseOrderCallbackLock(mixed $lock): void
+    {
+        if (is_object($lock) && method_exists($lock, 'release')) {
+            $lock->release();
+        }
+    }
+
+    protected function callbackLockKey(string $context, string $orderNumber): string
+    {
+        return 'sirsoft-pay_nhnkcp:callback:'
+            . $context
+            . ':'
+            . sha1(trim($orderNumber));
+    }
+
+    protected function callbackLockTtlSeconds(): int
+    {
+        return 30;
+    }
+
+    protected function callbackLockWaitSeconds(): int
+    {
+        return 10;
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/AdminEscrowDeliveryController.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/AdminEscrowDeliveryController.php
new file mode 100644
index 00000000..5cffc760
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/AdminEscrowDeliveryController.php
@@ -0,0 +1,210 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Controllers;
+
+use App\Helpers\ResponseHelper;
+use App\Http\Controllers\Api\Base\AdminBaseController;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Log;
+use Plugins\Sirsoft\PayNhnkcp\Concerns\SanitizesPgResponse;
+use Plugins\Sirsoft\PayNhnkcp\Services\NhnKcpApiService;
+
+/**
+ * KCP 에스크로 배송등록 관리자 컨트롤러
+ *
+ * 에스크로 결제 후 상품 발송 시 KCP에 운송장번호를 등록합니다.
+ * CLI mod_type=STE1 방식으로 배송정보를 전달합니다.
+ */
+class AdminEscrowDeliveryController extends AdminBaseController
+{
+    use SanitizesPgResponse;
+
+    private const ESCROW_DELIVERY_RESPONSE_KEYS = [
+        'res_cd',
+        'res_msg',
+        'tno',
+        'deli_numb',
+        'deli_corp',
+    ];
+
+    /** KCP 에스크로 택배사 코드표 */
+    private const COURIER_CODES = [
+        '04' => 'CJ대한통운',
+        '05' => '한진택배',
+        '06' => '로젠택배',
+        '08' => '롯데택배',
+        '09' => '우체국택배',
+        '11' => '경동택배',
+        '13' => '일양로지스',
+        '14' => '합동택배',
+        '20' => '드림택배',
+        '23' => '천일택배',
+        '26' => '건영택배',
+        '40' => '기타',
+    ];
+
+    public function __construct(
+        private readonly NhnKcpApiService $apiService,
+    ) {
+        parent::__construct();
+    }
+
+    /**
+     * 배송등록 폼 데이터 반환 (주소 자동완성 및 기등록 배송 이력 포함)
+     */
+    /**
+     * 에스크로 배송 등록 폼 초기 데이터 조회
+     *
+     * 어드민 에스크로 배송 등록 화면에서 주문 정보 + 기본 배송지/수령인을 미리 채울 수 있도록 반환.
+     *
+     * @param  string  $orderNumber  주문번호
+     * @return JsonResponse 폼 초기 데이터 또는 404
+     */
+    public function formData(string $orderNumber): JsonResponse
+    {
+        $payment = $this->findEscrowPayment($orderNumber);
+
+        if (! $payment) {
+            return ResponseHelper::success('messages.success', null);
+        }
+
+        $address = DB::table('ecommerce_order_addresses as a')
+            ->join('ecommerce_orders as o', 'o.id', '=', 'a.order_id')
+            ->where('o.order_number', $orderNumber)
+            ->where('a.address_type', 'shipping')
+            ->select([
+                'a.recipient_name',
+                'a.recipient_phone',
+                'a.zipcode',
+                'a.address',
+                'a.address_detail',
+            ])
+            ->first();
+
+        $meta = $payment->payment_meta ? json_decode($payment->payment_meta, true) : [];
+        $escrowDelivery = $meta['escrow_delivery'] ?? null;
+
+        return ResponseHelper::success('messages.success', [
+            'has_escrow_payment'  => true,
+            'tno'                 => $payment->transaction_id,
+            'courier_codes'       => self::COURIER_CODES,
+            'prefill'             => [
+                'recv_name' => $address?->recipient_name ?? '',
+                'recv_tel'  => $address?->recipient_phone ?? '',
+                'recv_post' => $address?->zipcode ?? '',
+                'recv_addr' => trim(($address?->address ?? '') . ' ' . ($address?->address_detail ?? '')),
+            ],
+            'registered_delivery' => $escrowDelivery,
+        ]);
+    }
+
+    /**
+     * KCP에 배송정보 등록 (CLI mod_type=STE1)
+     */
+    /**
+     * 에스크로 배송 등록 API 호출
+     *
+     * KCP 에스크로 API 로 배송 정보(택배사/송장번호/수령인 등) 등록. 등록 완료 시 구매확정 안내 자동 발송.
+     *
+     * @param  Request  $request  배송 정보 폼
+     * @param  string  $orderNumber  주문번호
+     * @return JsonResponse 등록 결과
+     */
+    public function register(Request $request, string $orderNumber): JsonResponse
+    {
+        $deliNumb = trim((string) $request->input('deli_numb', ''));
+        $deliCorp = trim((string) $request->input('deli_corp', ''));
+
+        if ($deliNumb === '') {
+            return ResponseHelper::error('messages.failed', 422, ['deli_numb' => ['운송장번호를 입력해주세요.']]);
+        }
+
+        if ($deliCorp === '' || ! array_key_exists($deliCorp, self::COURIER_CODES)) {
+            return ResponseHelper::error('messages.failed', 422, ['deli_corp' => ['택배사를 선택해주세요.']]);
+        }
+
+        $payment = $this->findEscrowPayment($orderNumber);
+
+        if (! $payment) {
+            return ResponseHelper::error('messages.failed', 404, null);
+        }
+
+        Log::info('KCP: escrow delivery register requested', [
+            'order_number' => $orderNumber,
+            'tno'          => $payment->transaction_id,
+            'deli_numb'    => $deliNumb,
+            'deli_corp'    => $deliCorp,
+        ]);
+
+        try {
+            $pgResponse = $this->apiService->registerEscrowDelivery(
+                tno: $payment->transaction_id,
+                ordrIdxx: $orderNumber,
+                deliNumb: $deliNumb,
+                deliCorp: $deliCorp,
+            );
+
+            $courierName = self::COURIER_CODES[$deliCorp];
+            $meta = $payment->payment_meta ? json_decode($payment->payment_meta, true) : [];
+            $meta['escrow_delivery'] = [
+                'registered_at' => now()->toDateTimeString(),
+                'deli_numb'     => $deliNumb,
+                'deli_corp'     => $deliCorp,
+                'courier_name'  => $courierName,
+                'pg_response_sanitized' => true,
+                'pg_response'   => $this->sanitizePgResponse($pgResponse, self::ESCROW_DELIVERY_RESPONSE_KEYS),
+            ];
+
+            DB::table('ecommerce_order_payments')
+                ->where('id', $payment->id)
+                ->update([
+                    'payment_meta' => json_encode($meta, JSON_UNESCAPED_UNICODE),
+                    'updated_at'   => now(),
+                ]);
+
+            Log::info('KCP: escrow delivery registered', [
+                'order_number' => $orderNumber,
+                'tno'          => $payment->transaction_id,
+                'deli_numb'    => $deliNumb,
+                'courier_name' => $courierName,
+            ]);
+
+            return ResponseHelper::success('messages.success', [
+                'res_cd'       => $pgResponse['res_cd'] ?? '0000',
+                'deli_numb'    => $deliNumb,
+                'courier_name' => $courierName,
+            ]);
+
+        } catch (\Exception $e) {
+            Log::error('KCP: escrow delivery register exception', [
+                'order_number' => $orderNumber,
+                'error'        => $e->getMessage(),
+            ]);
+
+            return ResponseHelper::error('messages.failed', 500, [
+                'message' => [$e->getMessage()],
+            ]);
+        }
+    }
+
+    private function findEscrowPayment(string $orderNumber): ?object
+    {
+        return DB::table('ecommerce_order_payments as p')
+            ->join('ecommerce_orders as o', 'o.id', '=', 'p.order_id')
+            ->where('o.order_number', $orderNumber)
+            ->where('p.pg_provider', 'nhnkcp')
+            ->where('p.is_escrow', true)
+            ->whereNotNull('p.transaction_id')
+            ->select([
+                'p.id',
+                'p.transaction_id',
+                'p.paid_amount_local',
+                'p.payment_meta',
+            ])
+            ->first();
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/AdminOrderListController.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/AdminOrderListController.php
new file mode 100644
index 00000000..a9bcc21e
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/AdminOrderListController.php
@@ -0,0 +1,104 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Controllers;
+
+use App\Helpers\ResponseHelper;
+use App\Http\Controllers\Api\Base\AdminBaseController;
+use App\Services\PluginSettingsService;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Support\Facades\DB;
+use Plugins\Sirsoft\PayNhnkcp\Concerns\ResolvesEasyPayDisplay;
+
+class AdminOrderListController extends AdminBaseController
+{
+    use ResolvesEasyPayDisplay;
+
+    private const PLUGIN_IDENTIFIER = 'sirsoft-pay_nhnkcp';
+
+    private bool $isTest;
+
+    public function __construct(PluginSettingsService $pluginSettingsService)
+    {
+        parent::__construct();
+        $settings = $pluginSettingsService->get(self::PLUGIN_IDENTIFIER) ?? [];
+        $this->isTest = $settings['is_test_mode'] ?? true;
+    }
+
+    /**
+     * NHN KCP 테스트 모드 주문 맵 반환
+     *
+     * 현재 플러그인이 테스트 모드이면 최근 6개월 nhnkcp 전체 주문을 테스트로 간주한다.
+     * 라이브 모드이면 payment_meta.is_test_mode = true 인 주문만 반환한다.
+     *
+     * @return JsonResponse 테스트 모드 주문 맵 { "order_number": true, ... }
+     */
+    public function testModeMap(): JsonResponse
+    {
+        $query = DB::table('ecommerce_orders as o')
+            ->join('ecommerce_order_payments as p', 'p.order_id', '=', 'o.id')
+            ->where('p.pg_provider', 'nhnkcp')
+            ->where('p.created_at', '>=', now()->subMonths(6));
+
+        if ($this->isTest) {
+            $orderNumbers = $query->pluck('o.order_number');
+            $map = array_fill_keys($orderNumbers->all(), true);
+        } else {
+            $rows = $query
+                ->whereNotNull('p.payment_meta')
+                ->select(['o.order_number', 'p.payment_meta'])
+                ->get();
+
+            $map = [];
+            foreach ($rows as $row) {
+                $meta = json_decode($row->payment_meta, true) ?? [];
+                if ($meta['is_test_mode'] ?? false) {
+                    $map[$row->order_number] = true;
+                }
+            }
+        }
+
+        return ResponseHelper::success('messages.success', $map);
+    }
+
+    /**
+     * NHN KCP 간편결제 표시 맵 반환
+     *
+     * 관리자 주문목록은 코어 OrderPaymentResource 의 기본 payment_method_label 을 사용하므로,
+     * 플러그인 데이터소스로 간편결제 원 결제수단 표시명을 보강한다.
+     *
+     * @return JsonResponse 주문번호별 표시 맵
+     */
+    public function easyPayDisplayMap(): JsonResponse
+    {
+        $rows = DB::table('ecommerce_orders as o')
+            ->join('ecommerce_order_payments as p', 'p.order_id', '=', 'o.id')
+            ->where('p.pg_provider', 'nhnkcp')
+            ->where('p.created_at', '>=', now()->subMonths(6))
+            ->select([
+                'o.order_number',
+                'p.payment_method',
+                'p.embedded_pg_provider',
+                'p.payment_meta',
+            ])
+            ->get();
+
+        $map = [];
+        foreach ($rows as $row) {
+            $display = $this->resolvePaymentDisplay($row);
+            if (($display['embedded_pg_provider_label'] ?? null) === null) {
+                continue;
+            }
+
+            $map[$row->order_number] = [
+                'payment_method_label' => $display['payment_method_label'],
+                'payment_method_display_label' => $display['payment_method_display_label'],
+                'embedded_pg_provider' => $display['embedded_pg_provider'],
+                'embedded_pg_provider_label' => $display['embedded_pg_provider_label'],
+            ];
+        }
+
+        return ResponseHelper::success('messages.success', $map);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/AdminSettingsStatusController.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/AdminSettingsStatusController.php
new file mode 100644
index 00000000..5bf03d56
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/AdminSettingsStatusController.php
@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Controllers;
+
+use App\Helpers\ResponseHelper;
+use App\Services\PluginSettingsService;
+use Illuminate\Http\JsonResponse;
+
+class AdminSettingsStatusController
+{
+    private const PLUGIN_IDENTIFIER = 'sirsoft-pay_nhnkcp';
+
+    public function __construct(private readonly PluginSettingsService $settingsService) {}
+
+    /**
+     * 테스트 모드 활성 여부만 반환한다.
+     *
+     * @return JsonResponse
+     */
+    public function testMode(): JsonResponse
+    {
+        return ResponseHelper::success('messages.success', [
+            'is_test_mode' => (bool) $this->settingsService->get(self::PLUGIN_IDENTIFIER, 'is_test_mode', true),
+        ]);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/AdminTransactionController.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/AdminTransactionController.php
new file mode 100644
index 00000000..8fa43674
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/AdminTransactionController.php
@@ -0,0 +1,158 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Controllers;
+
+use App\Helpers\ResponseHelper;
+use App\Http\Controllers\Api\Base\AdminBaseController;
+use App\Services\PluginSettingsService;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Support\Facades\DB;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentStatusEnum;
+use Modules\Sirsoft\Ecommerce\Enums\RefundStatusEnum;
+use Plugins\Sirsoft\PayNhnkcp\Concerns\ResolvesEasyPayDisplay;
+
+/**
+ * NHN KCP 거래 정보 관리자 컨트롤러
+ *
+ * KCP는 CLI 바이너리 방식으로 승인이 이루어지므로 웹 API 실시간 조회가 불가합니다.
+ * DB에 저장된 거래 정보(payment_meta)를 반환합니다.
+ */
+class AdminTransactionController extends AdminBaseController
+{
+    use ResolvesEasyPayDisplay;
+
+    private const PLUGIN_IDENTIFIER = 'sirsoft-pay_nhnkcp';
+
+    public function __construct(
+        private readonly PluginSettingsService $pluginSettingsService,
+    ) {
+        parent::__construct();
+    }
+
+    /**
+     * GET /api/plugins/sirsoft-pay_nhnkcp/admin/orders/{orderNumber}/transaction-status
+     */
+    /**
+     * 주문번호로 KCP 거래 조회
+     *
+     * 어드민 주문 상세에서 거래 조회 버튼 클릭 시 사용. ecommerce_order_payments
+     * 의 transaction_id (KCP tno) 를 찾아 KCP 단건 거래 조회 API 호출.
+     *
+     * @param  string  $orderNumber  주문번호
+     * @return JsonResponse 거래 정보 또는 매핑 없을 시 null
+     */
+    public function queryByOrder(string $orderNumber): JsonResponse
+    {
+        $payment = DB::table('ecommerce_order_payments as p')
+            ->join('ecommerce_orders as o', 'o.id', '=', 'p.order_id')
+            ->where('o.order_number', $orderNumber)
+            ->where('p.pg_provider', 'nhnkcp')
+            ->whereNotNull('p.transaction_id')
+            ->where('p.transaction_id', '!=', '')
+            ->select([
+                'p.order_id',
+                'p.transaction_id',
+                'p.payment_meta',
+                'p.payment_method',
+                'p.embedded_pg_provider',
+                'p.payment_status',
+                'p.cancelled_amount',
+                'p.cancelled_at',
+                'p.cancel_history',
+                'p.currency',
+            ])
+            ->first();
+
+        if (! $payment) {
+            return ResponseHelper::success('messages.success', null);
+        }
+
+        $settings = $this->pluginSettingsService->get(self::PLUGIN_IDENTIFIER) ?? [];
+        $isTest = (bool) ($settings['is_test_mode'] ?? true);
+
+        $meta = $this->decodePaymentMeta($payment->payment_meta ?? null);
+        $rawResponse = $meta['pg_raw_response'] ?? [];
+        $display = $this->resolvePaymentDisplay($payment);
+        $paymentStatus = is_string($payment->payment_status ?? null)
+            ? PaymentStatusEnum::tryFrom($payment->payment_status)
+            : null;
+        $refund = $this->latestRefundForOrder((int) $payment->order_id);
+        $refundStatus = is_string($refund->refund_status ?? null)
+            ? RefundStatusEnum::tryFrom($refund->refund_status)
+            : null;
+        $cancelledAmount = (float) ($payment->cancelled_amount ?? 0);
+        $refundAmount = $refund ? (float) ($refund->refund_amount ?? 0) : 0.0;
+
+        return ResponseHelper::success('messages.success', [
+            'tno'            => $payment->transaction_id,
+            'app_no'         => $rawResponse['app_no'] ?? $meta['app_no'] ?? null,
+            'use_pay_method' => $meta['use_pay_method'] ?? $rawResponse['use_pay_method'] ?? null,
+            'app_time'       => $meta['app_time'] ?? $rawResponse['app_time'] ?? null,
+            'res_cd'         => $meta['res_cd'] ?? $rawResponse['res_cd'] ?? '0000',
+            'card_name'      => $rawResponse['card_name'] ?? $meta['card_name'] ?? $rawResponse['bank_name'] ?? $meta['bank_name'] ?? null,
+            'account'        => $meta['account'] ?? null,
+            'bank_name'      => $rawResponse['bank_name'] ?? $meta['bank_name'] ?? null,
+            '_is_test_mode'  => $isTest,
+            'payment_status' => $paymentStatus?->value ?? $payment->payment_status,
+            'payment_status_label' => $paymentStatus?->label(),
+            'payment_status_variant' => $paymentStatus?->variant(),
+            'cancelled_amount' => $cancelledAmount,
+            'cancelled_amount_formatted' => $this->formatKrwAmount($cancelledAmount),
+            'cancelled_at' => $payment->cancelled_at,
+            'cancel_history' => $this->decodeJsonArray($payment->cancel_history ?? null),
+            'refund_number' => $refund->refund_number ?? null,
+            'refund_status' => $refundStatus?->value ?? ($refund->refund_status ?? null),
+            'refund_status_label' => $refundStatus?->label(),
+            'refund_status_variant' => $refundStatus?->variant(),
+            'refund_amount' => $refundAmount,
+            'refund_amount_formatted' => $this->formatKrwAmount($refundAmount),
+            'refunded_at' => $refund->refunded_at ?? null,
+            'refund_pg_transaction_id' => $refund->pg_transaction_id ?? null,
+            '_base_pay_method_label' => $display['payment_method_label'],
+            '_embedded_pg_provider' => $display['embedded_pg_provider'],
+            '_embedded_pg_provider_label' => $display['embedded_pg_provider_label'],
+            '_pay_method_label' => $display['payment_method_display_label'],
+            'payment_method_display_label' => $display['payment_method_display_label'],
+        ]);
+    }
+
+    private function latestRefundForOrder(int $orderId): ?object
+    {
+        return DB::table('ecommerce_order_refunds')
+            ->where('order_id', $orderId)
+            ->orderByDesc('id')
+            ->select([
+                'refund_number',
+                'refund_status',
+                'refund_amount',
+                'pg_transaction_id',
+                'refunded_at',
+            ])
+            ->first();
+    }
+
+    private function formatKrwAmount(float $amount): string
+    {
+        return number_format((int) round($amount)).'원';
+    }
+
+    /**
+     * @return array<int|string, mixed>
+     */
+    private function decodeJsonArray(mixed $value): array
+    {
+        if (is_array($value)) {
+            return $value;
+        }
+
+        if (! is_string($value) || trim($value) === '') {
+            return [];
+        }
+
+        $decoded = json_decode($value, true);
+
+        return is_array($decoded) ? $decoded : [];
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/EscrowCommonNotifyController.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/EscrowCommonNotifyController.php
new file mode 100644
index 00000000..6181529f
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/EscrowCommonNotifyController.php
@@ -0,0 +1,211 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Controllers;
+
+use App\Extension\HookManager;
+use Illuminate\Http\Response;
+use Illuminate\Support\Facades\Log;
+use Modules\Sirsoft\Ecommerce\Models\Order;
+use Modules\Sirsoft\Ecommerce\Services\OrderProcessingService;
+use Plugins\Sirsoft\PayNhnkcp\Concerns\SendsKcpNotifyResponse;
+use Plugins\Sirsoft\PayNhnkcp\Http\Requests\EscrowCommonNotifyRequest;
+
+/**
+ * KCP 에스크로 공통통보 컨트롤러
+ *
+ * POST /plugins/sirsoft-pay_nhnkcp/payment/escrow-common-notify
+ * KCP 가맹점 어드민에서 공통통보 URL로 등록해야 합니다.
+ *
+ * tx_cd 별 처리 (그누보드5 settle_kcp_common.php 참고):
+ *   TX02 + cl_status=2 → 구매확인
+ *   TX02 + cl_status=8 → 구매취소
+ *   TX02 + cl_status=3 → 구매취소 확인
+ *   TX03               → 배송시작 통보
+ *
+ * 응답: <form><input name="result" value="0000"> HTML (SendsKcpNotifyResponse trait)
+ * IP 가드: RestrictKcpIp 미들웨어 (routes/web.php)
+ */
+class EscrowCommonNotifyController
+{
+    use SendsKcpNotifyResponse;
+
+    public function __construct(
+        private readonly OrderProcessingService $orderService,
+    ) {}
+
+    /**
+     * KCP 에스크로 통보 처리 (공통 webhook)
+     *
+     * @param  EscrowCommonNotifyRequest  $request  검증된 통보 페이로드 (order_no, tx_cd, cl_status 등)
+     * @return Response 200 + KCP 표준 result HTML
+     */
+    public function handle(EscrowCommonNotifyRequest $request): Response
+    {
+        $validated = $request->validated();
+
+        $txCd     = (string) $validated['tx_cd'];
+        $tno      = (string) ($validated['tno'] ?? '');
+        $orderNo  = (string) $validated['order_no'];
+        $clStatus = (string) ($validated['cl_status'] ?? '');
+
+        Log::info('KCP: escrow common notify received', [
+            'tx_cd'    => $txCd,
+            'tno'      => $tno,
+            'order_no' => $orderNo,
+            'cl_status' => $clStatus,
+        ]);
+
+        try {
+            $order = $this->orderService->findByOrderNumber($orderNo);
+
+            if (! $order) {
+                Log::error('KCP: escrow common notify - order not found', ['order_no' => $orderNo]);
+
+                // 영구 실패 — result=0000 으로 재통보 차단
+                return $this->kcpNotifyResponse();
+            }
+
+            $contextError = $this->validateEscrowNotifyContext($order, $validated, $tno);
+            if ($contextError !== null) {
+                Log::warning('KCP: escrow common notify context mismatch — retry requested', [
+                    'reason' => $contextError,
+                    'tx_cd' => $txCd,
+                    'tno' => $tno,
+                    'order_no' => $orderNo,
+                ]);
+
+                return $this->kcpNotifyRetry();
+            }
+
+            $fingerprint = $this->escrowNotifyFingerprint($validated);
+            if ($this->wasEscrowNotifyAlreadyProcessed($order, $fingerprint)) {
+                Log::info('KCP: escrow common notify replay ignored', [
+                    'tx_cd' => $txCd,
+                    'tno' => $tno,
+                    'order_no' => $orderNo,
+                    'cl_status' => $clStatus,
+                ]);
+
+                return $this->kcpNotifyResponse();
+            }
+
+            match ($txCd) {
+                'TX02' => match ($clStatus) {
+                    '2'  => HookManager::doAction('sirsoft-pay_nhnkcp.escrow.purchase_confirmed', $order, $validated),
+                    '8'  => HookManager::doAction('sirsoft-pay_nhnkcp.escrow.purchase_cancelled', $order, $validated),
+                    '3'  => HookManager::doAction('sirsoft-pay_nhnkcp.escrow.denial_confirmed', $order, $validated),
+                    default => Log::info('KCP: escrow TX02 unknown cl_status', ['cl_status' => $clStatus, 'order_no' => $orderNo]),
+                },
+                'TX03' => HookManager::doAction('sirsoft-pay_nhnkcp.escrow.delivery_started', $order, $validated),
+                default => Log::info('KCP: escrow common notify - unhandled tx_cd', ['tx_cd' => $txCd, 'order_no' => $orderNo]),
+            };
+
+            $this->recordEscrowNotifyProcessed($order, $fingerprint);
+
+            Log::info('KCP: escrow common notify processed', [
+                'tx_cd'    => $txCd,
+                'order_no' => $orderNo,
+                'cl_status' => $clStatus,
+            ]);
+
+        } catch (\Exception $e) {
+            Log::error('KCP: escrow common notify failed', [
+                'tx_cd'    => $txCd,
+                'order_no' => $orderNo,
+                'error'    => $e->getMessage(),
+            ]);
+
+            // 일시적 실패 (DB 등) — result != 0000 으로 KCP 재통보 유도
+            return $this->kcpNotifyRetry();
+        }
+
+        return $this->kcpNotifyResponse();
+    }
+
+    /**
+     * 에스크로 공통통보가 실제 결제 건과 같은 거래인지 확인한다.
+     *
+     * 현재 이 컨트롤러는 hook dispatch 만 하지만, 향후 listener 가 주문 상태를 바꿀 수 있으므로
+     * 주문번호 단독 신뢰를 피하고 저장된 tno/site_cd/escrow 플래그를 먼저 확인한다.
+     */
+    private function validateEscrowNotifyContext(Order $order, array $validated, string $tno): ?string
+    {
+        $payment = $order->payment;
+        if (! $payment) {
+            return 'payment_not_found';
+        }
+
+        if ($payment->pg_provider !== 'nhnkcp') {
+            return 'pg_provider_mismatch';
+        }
+
+        if (! (bool) $payment->is_escrow) {
+            return 'not_escrow_payment';
+        }
+
+        $storedTno = trim((string) ($payment->transaction_id ?? ''));
+        if ($storedTno === '' || $tno === '' || ! hash_equals($storedTno, $tno)) {
+            return 'tno_mismatch';
+        }
+
+        $meta = $payment->payment_meta ?? [];
+        $storedSiteCd = trim((string) ($meta['site_cd'] ?? ''));
+        $receivedSiteCd = trim((string) ($validated['site_cd'] ?? ''));
+        if ($storedSiteCd !== '' && $receivedSiteCd !== '' && ! hash_equals($storedSiteCd, $receivedSiteCd)) {
+            return 'site_cd_mismatch';
+        }
+
+        return null;
+    }
+
+    private function escrowNotifyFingerprint(array $validated): string
+    {
+        $keys = [
+            'site_cd',
+            'tno',
+            'order_no',
+            'tx_cd',
+            'tx_tm',
+            'cl_status',
+            'st_cd',
+            'can_msg',
+            'waybill_no',
+            'waybill_corp',
+        ];
+
+        $payload = [];
+        foreach ($keys as $key) {
+            $payload[$key] = (string) ($validated[$key] ?? '');
+        }
+
+        return hash('sha256', json_encode($payload, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES));
+    }
+
+    private function wasEscrowNotifyAlreadyProcessed(Order $order, string $fingerprint): bool
+    {
+        $payment = $order->payment;
+        $meta = $payment?->payment_meta ?? [];
+        $processed = $meta['escrow_common_notify_fingerprints'] ?? [];
+        $processed = is_array($processed) ? $processed : [];
+
+        return in_array($fingerprint, $processed, true);
+    }
+
+    private function recordEscrowNotifyProcessed(Order $order, string $fingerprint): void
+    {
+        $payment = $order->payment;
+        if (! $payment) {
+            return;
+        }
+
+        $meta = $payment->payment_meta ?? [];
+        $processed = $meta['escrow_common_notify_fingerprints'] ?? [];
+        $processed = is_array($processed) ? $processed : [];
+        $processed[] = $fingerprint;
+        $meta['escrow_common_notify_fingerprints'] = array_values(array_unique(array_slice($processed, -20)));
+
+        $payment->update(['payment_meta' => $meta]);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/HealthCheckController.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/HealthCheckController.php
new file mode 100644
index 00000000..e8cb0793
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/HealthCheckController.php
@@ -0,0 +1,444 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Controllers;
+
+use Illuminate\Http\JsonResponse;
+use Illuminate\Support\Facades\Http;
+
+/**
+ * NHN KCP 플러그인 시스템 점검 컨트롤러
+ *
+ * 관리자 설정 페이지에서 호출되어:
+ *   - PC 결제 (Standard Pay CLI 바이너리) 실행 환경
+ *   - 모바일 결제 (SmartPhone Pay SOAP 호출) 실행 환경
+ * 두 가지 사전조건을 진단하고, 자동 복구 가능한 항목(예: chmod +x)은
+ * 즉시 수정한 뒤 결과를 반환한다.
+ *
+ * 자동 복구 불가능한 항목(php-soap 미설치, exec() disabled 등)은
+ * "사용자 조치 안내" 메시지(remediation)를 함께 반환한다.
+ */
+class HealthCheckController
+{
+    private const STATUS_OK = 'ok';        // 정상
+
+    private const STATUS_FIXED = 'fixed';  // 자동 복구됨
+
+    private const STATUS_WARNING = 'warning';  // 동작 가능하나 권장 상태 아님
+
+    private const STATUS_ERROR = 'error';  // 사용자 조치 필요
+
+    private string $binDir;
+
+    public function __construct()
+    {
+        $this->binDir = dirname(__DIR__, 2) . '/bin';
+    }
+
+    /**
+     * GET /api/plugins/sirsoft-pay_nhnkcp/admin/health
+     *
+     * @return JsonResponse{success: true, data: {summary: array, checks: array}}
+     */
+    public function check(): JsonResponse
+    {
+        // 현재 OS/아키텍처에 해당하는 CLI 바이너리만 체크 — NhnKcpApiService::executeCli() 와 동일 기준
+        [$cliFilename, $cliArch, $cliRequireExec] = $this->resolveCliForCurrentOs();
+
+        $checks = [
+            $this->checkExecFunction(),
+            $this->checkBinDirectory(),
+            $this->checkCliBinary($cliFilename, $cliArch, $cliRequireExec),
+            $this->checkPubKey(),
+            $this->checkSoapExtension(),
+            $this->checkWsdlFile(),
+        ];
+
+        $summary = array_merge(
+            $this->summarize($checks, $cliFilename),
+            ['cancel_server_ip' => $this->resolveCancelServerIp()]
+        );
+
+        return response()->json([
+            'success' => true,
+            'data' => [
+                'summary' => $summary,
+                'checks' => $checks,
+            ],
+        ]);
+    }
+
+    /**
+     * 현재 PHP 런타임의 OS/아키텍처에 맞는 CLI 바이너리 정보 반환
+     *
+     * @return array{0: string, 1: string, 2: bool}  [filename, arch label, requireExec]
+     */
+    private function resolveCliForCurrentOs(): array
+    {
+        // Windows
+        if (strtoupper(substr(PHP_OS, 0, 3)) === 'WIN') {
+            // Windows 는 ACL 기반이라 ELF 의 +x 비트 검사를 적용하지 않음
+            return ['pp_cli_exe.exe', 'Windows', false];
+        }
+
+        // Linux 32-bit (PHP_INT_MAX == 2^31-1)
+        if (PHP_INT_MAX === 2147483647) {
+            return ['pp_cli', 'Linux 32-bit', true];
+        }
+
+        // Linux 64-bit (기본)
+        return ['pp_cli_x64', 'Linux 64-bit', true];
+    }
+
+    /**
+     * 상태 통계: 카테고리별로 PC/모바일 결제 가능 여부 판단
+     *
+     * @param  array<int, array<string, mixed>>  $checks
+     * @param  string  $cliFilename  현재 OS 의 CLI 바이너리 파일명 (cli_id 계산용)
+     */
+    private function summarize(array $checks, string $cliFilename): array
+    {
+        $byId = [];
+        foreach ($checks as $c) {
+            $byId[$c['id']] = $c;
+        }
+
+        $execOk = ! $this->isErroneous($byId['exec_function'] ?? null);
+
+        // 현재 OS 의 CLI 바이너리 ID 동적 계산 (checkCliBinary 와 동일 규칙)
+        $cliId = 'cli_' . preg_replace('/[^a-z0-9_]/i', '_', strtolower(pathinfo($cliFilename, PATHINFO_FILENAME)));
+        $cliOk = ! $this->isErroneous($byId[$cliId] ?? null);
+
+        $pubKeyOk = ! $this->isErroneous($byId['pub_key'] ?? null);
+        $soapOk = ! $this->isErroneous($byId['soap_extension'] ?? null);
+        $wsdlOk = ! $this->isErroneous($byId['wsdl_file'] ?? null);
+
+        // PC 표준결제: CLI 바이너리로 enc_data 복호화 필수
+        $pcReady = $execOk && $cliOk && $pubKeyOk;
+
+        // 모바일 카드/일반결제: KCP 가 콜백에 enc_data 를 동봉 → 서버가 CLI 로 복호화 필요.
+        // SOAP 만으로는 부족. PC 와 동일한 CLI 요건 + 모바일 전용 SOAP/WSDL 모두 필요.
+        $mobileCardReady = $execOk && $cliOk && $pubKeyOk && $soapOk && $wsdlOk;
+
+        // 모바일 가상계좌 전용: KCP 가 평문 필드(bankname/account/depositor)로 콜백 → CLI 불필요.
+        // SOAP/WSDL 만 OK 여도 가상계좌는 동작 가능.
+        $mobileVbankOnlyReady = $soapOk && $wsdlOk;
+
+        $errorCount = 0;
+        $warningCount = 0;
+        $fixedCount = 0;
+        foreach ($checks as $c) {
+            match ($c['status']) {
+                self::STATUS_ERROR => $errorCount++,
+                self::STATUS_WARNING => $warningCount++,
+                self::STATUS_FIXED => $fixedCount++,
+                default => null,
+            };
+        }
+
+        return [
+            'pc_payment_ready' => $pcReady,
+            // 'mobile_payment_ready' 는 카드/일반결제 기준(가장 흔한 케이스). 가상계좌는 별도 필드.
+            'mobile_payment_ready' => $mobileCardReady,
+            'mobile_vbank_only_ready' => $mobileVbankOnlyReady,
+            'error_count' => $errorCount,
+            'warning_count' => $warningCount,
+            'fixed_count' => $fixedCount,
+        ];
+    }
+
+    private function isErroneous(?array $check): bool
+    {
+        return ($check['status'] ?? self::STATUS_ERROR) === self::STATUS_ERROR;
+    }
+
+    /**
+     * KCP 상점관리자 결제서버 IP 설정에 등록할 서버 IP 후보를 반환한다.
+     *
+     * 실제 취소 요청은 서버에서 KCP로 나가므로 공인 outbound IP가 가장 정확하다.
+     * 외부 조회가 실패하면 PHP 서버 변수/호스트명에서 확인 가능한 IP를 fallback으로 제공한다.
+     *
+     * @return array{address: string|null, source: string, source_label: string}
+     */
+    private function resolveCancelServerIp(): array
+    {
+        $publicIp = $this->detectPublicOutboundIp();
+        if ($publicIp !== null) {
+            return [
+                'address' => $publicIp,
+                'source' => 'public_outbound',
+                'source_label' => '공인 송신 IP',
+            ];
+        }
+
+        $serverIp = $this->detectServerVariableIp();
+        if ($serverIp !== null) {
+            return [
+                'address' => $serverIp,
+                'source' => 'server_variable',
+                'source_label' => '서버 IP 후보',
+            ];
+        }
+
+        return [
+            'address' => null,
+            'source' => 'unavailable',
+            'source_label' => '확인 필요',
+        ];
+    }
+
+    private function detectPublicOutboundIp(): ?string
+    {
+        try {
+            $response = Http::timeout(2)
+                ->acceptJson()
+                ->get('https://api.ipify.org', ['format' => 'json']);
+
+            if (! $response->ok()) {
+                return null;
+            }
+
+            $ip = trim((string) ($response->json('ip') ?? ''));
+
+            return $this->normalizeIp($ip);
+        } catch (\Throwable) {
+            return null;
+        }
+    }
+
+    private function detectServerVariableIp(): ?string
+    {
+        $candidates = [
+            (string) request()->server('SERVER_ADDR', ''),
+            (string) ($_SERVER['SERVER_ADDR'] ?? ''),
+            (string) request()->server('LOCAL_ADDR', ''),
+            (string) ($_SERVER['LOCAL_ADDR'] ?? ''),
+            gethostbyname((string) gethostname()),
+        ];
+
+        foreach ($candidates as $candidate) {
+            $ip = $this->normalizeIp($candidate);
+            if ($ip !== null) {
+                return $ip;
+            }
+        }
+
+        return null;
+    }
+
+    private function normalizeIp(?string $ip): ?string
+    {
+        $ip = trim((string) $ip);
+        if ($ip === '') {
+            return null;
+        }
+
+        return filter_var($ip, FILTER_VALIDATE_IP) !== false ? $ip : null;
+    }
+
+    /**
+     * PHP `exec()` 함수 활성화 여부 — disable_functions 에서 차단되면 CLI 호출 불가
+     */
+    private function checkExecFunction(): array
+    {
+        $disabled = array_map('trim', explode(',', (string) ini_get('disable_functions')));
+        $isDisabled = in_array('exec', $disabled, true) || ! function_exists('exec');
+
+        if ($isDisabled) {
+            return [
+                'id' => 'exec_function',
+                'category' => 'pc',
+                'label' => 'PHP exec() 함수',
+                'status' => self::STATUS_ERROR,
+                'detail' => 'php.ini 의 disable_functions 에서 exec 가 차단되어 있습니다.',
+                'remediation' => "php.ini 에서 disable_functions 목록에서 'exec' 를 제거한 뒤 PHP-FPM(또는 Apache) 을 재시작하세요.\n예: sudo sed -i 's/disable_functions = .*exec.*/disable_functions =/' /etc/php/8.x/fpm/php.ini && sudo systemctl restart php8.x-fpm",
+            ];
+        }
+
+        return [
+            'id' => 'exec_function',
+            'category' => 'pc',
+            'label' => 'PHP exec() 함수',
+            'status' => self::STATUS_OK,
+            'detail' => 'CLI 호출 가능',
+        ];
+    }
+
+    /**
+     * bin 디렉토리 존재 여부만 검사 — 쓰기 권한은 CLI 바이너리 단위로 처리
+     */
+    private function checkBinDirectory(): array
+    {
+        if (! is_dir($this->binDir)) {
+            return [
+                'id' => 'bin_directory',
+                'category' => 'pc',
+                'label' => 'CLI 바이너리 디렉토리',
+                'status' => self::STATUS_ERROR,
+                'detail' => "bin 디렉토리가 없습니다: {$this->binDir}",
+                'remediation' => '플러그인을 재설치하거나, KCP 에서 제공한 CLI 바이너리를 bin/ 에 복사하세요.',
+            ];
+        }
+
+        return [
+            'id' => 'bin_directory',
+            'category' => 'pc',
+            'label' => 'CLI 바이너리 디렉토리',
+            'status' => self::STATUS_OK,
+            'detail' => '디렉토리 존재',
+        ];
+    }
+
+    /**
+     * CLI 바이너리: 존재 + (Linux는) 실행 권한 — 권한 없으면 자동 chmod +x 시도
+     */
+    private function checkCliBinary(string $filename, string $arch, bool $requireExec = true): array
+    {
+        $path = $this->binDir . '/' . $filename;
+        $id = 'cli_' . preg_replace('/[^a-z0-9_]/i', '_', strtolower(pathinfo($filename, PATHINFO_FILENAME)));
+        $label = "CLI 바이너리 ({$arch}) — {$filename}";
+
+        if (! file_exists($path)) {
+            return [
+                'id' => $id,
+                'category' => 'pc',
+                'label' => $label,
+                'status' => self::STATUS_ERROR,
+                'detail' => "파일이 없습니다: {$path}",
+                'remediation' => "현재 OS({$arch})에 해당하는 KCP CLI 바이너리를 bin/ 에 복사하세요. (테스트 환경은 플러그인 기본 제공)",
+            ];
+        }
+
+        if (! $requireExec) {
+            return [
+                'id' => $id,
+                'category' => 'pc',
+                'label' => $label,
+                'status' => self::STATUS_OK,
+                'detail' => 'Windows 바이너리 — 실행 권한 검사 생략',
+            ];
+        }
+
+        if (is_executable($path)) {
+            return [
+                'id' => $id,
+                'category' => 'pc',
+                'label' => $label,
+                'status' => self::STATUS_OK,
+                'detail' => '실행 권한 OK (' . substr(sprintf('%o', fileperms($path)), -4) . ')',
+            ];
+        }
+
+        // 자동 복구: chmod +x 시도
+        $beforeMode = substr(sprintf('%o', fileperms($path)), -4);
+        $chmodOk = @chmod($path, 0755);
+
+        if ($chmodOk && is_executable($path)) {
+            return [
+                'id' => $id,
+                'category' => 'pc',
+                'label' => $label,
+                'status' => self::STATUS_FIXED,
+                'detail' => "실행 권한 자동 복구됨: {$beforeMode} → 0755",
+            ];
+        }
+
+        return [
+            'id' => $id,
+            'category' => 'pc',
+            'label' => $label,
+            'status' => self::STATUS_ERROR,
+            'detail' => "실행 권한 없음 ({$beforeMode}) — 자동 복구 실패",
+            'remediation' => "이 파일에 실행 권한을 부여하세요:\n  chmod 755 {$path}\n파일 소유자가 아니면 앞에 sudo 를 붙이세요.",
+        ];
+    }
+
+    /**
+     * pub.key 파일 존재 — KCP CLI 가 결제 응답 복호화에 사용
+     */
+    private function checkPubKey(): array
+    {
+        $path = $this->binDir . '/pub.key';
+
+        if (! file_exists($path)) {
+            return [
+                'id' => 'pub_key',
+                'category' => 'pc',
+                'label' => 'KCP 공개키 (pub.key)',
+                'status' => self::STATUS_ERROR,
+                'detail' => "pub.key 파일이 없습니다: {$path}",
+                'remediation' => 'KCP 에서 제공받은 pub.key 파일을 bin/ 에 복사하세요. (테스트 환경은 플러그인 기본 제공)',
+            ];
+        }
+
+        return [
+            'id' => 'pub_key',
+            'category' => 'pc',
+            'label' => 'KCP 공개키 (pub.key)',
+            'status' => self::STATUS_OK,
+            'detail' => '파일 존재',
+        ];
+    }
+
+    /**
+     * PHP SOAP 확장 — 모바일 SmartPhone Pay 의 approval_key 획득에 필수
+     */
+    private function checkSoapExtension(): array
+    {
+        if (extension_loaded('soap') && class_exists(\SoapClient::class)) {
+            return [
+                'id' => 'soap_extension',
+                'category' => 'mobile',
+                'label' => 'PHP SOAP 확장',
+                'status' => self::STATUS_OK,
+                'detail' => 'SoapClient 사용 가능',
+            ];
+        }
+
+        return [
+            'id' => 'soap_extension',
+            'category' => 'mobile',
+            'label' => 'PHP SOAP 확장',
+            'status' => self::STATUS_ERROR,
+            'detail' => '모바일 결제 (SmartPhone Pay) 가 동작하지 않습니다.',
+            'remediation' => "PHP SOAP 확장을 설치하고 PHP-FPM 을 재시작하세요:\n"
+                . "Ubuntu/Debian: sudo apt install php8.x-soap && sudo systemctl restart php8.x-fpm\n"
+                . "RHEL/CentOS:   sudo yum install php-soap && sudo systemctl restart php-fpm\n"
+                . "확인: php -m | grep soap",
+        ];
+    }
+
+    /**
+     * WSDL 파일 — bin/ 에 KCPPaymentService.wsdl, real_KCPPaymentService.wsdl 필요
+     */
+    private function checkWsdlFile(): array
+    {
+        $wsdlFiles = ['KCPPaymentService.wsdl', 'real_KCPPaymentService.wsdl'];
+        $missing = [];
+        foreach ($wsdlFiles as $f) {
+            if (! file_exists($this->binDir . '/' . $f)) {
+                $missing[] = $f;
+            }
+        }
+
+        if (! empty($missing)) {
+            return [
+                'id' => 'wsdl_file',
+                'category' => 'mobile',
+                'label' => 'WSDL 파일',
+                'status' => self::STATUS_ERROR,
+                'detail' => '누락: ' . implode(', ', $missing),
+                'remediation' => 'KCP 에서 제공받은 WSDL 파일을 bin/ 에 복사하세요. (테스트/라이브 별로 두 개)',
+            ];
+        }
+
+        return [
+            'id' => 'wsdl_file',
+            'category' => 'mobile',
+            'label' => 'WSDL 파일',
+            'status' => self::STATUS_OK,
+            'detail' => '테스트/라이브 WSDL 모두 존재',
+        ];
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/MobileApprovalController.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/MobileApprovalController.php
new file mode 100644
index 00000000..2d122af9
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/MobileApprovalController.php
@@ -0,0 +1,286 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Controllers;
+
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Modules\Sirsoft\Ecommerce\Models\Order;
+use Modules\Sirsoft\Ecommerce\Services\OrderProcessingService;
+use Plugins\Sirsoft\PayNhnkcp\Concerns\RecordsPaymentWindowClosure;
+use Plugins\Sirsoft\PayNhnkcp\Exceptions\NhnKcpApiException;
+use Plugins\Sirsoft\PayNhnkcp\Services\KcpSoapService;
+
+/**
+ * KCP SmartPhone Pay 승인키 컨트롤러
+ *
+ * PC Standard Pay(iframe)와 달리 모바일은 서버에서 SOAP으로 approval_key 를
+ * 먼저 획득하고, 브라우저가 pay_url 로 form POST(페이지 전환)한다.
+ */
+class MobileApprovalController
+{
+    use RecordsPaymentWindowClosure;
+
+    /** 결제수단 → KCP 모바일 pay_method 코드 */
+    private const MOBILE_PAY_METHOD_MAP = [
+        'card' => 'CARD',
+        'bank_transfer' => 'BANK',
+        'virtual_account' => 'VCNT',
+        'mobile' => 'MOBX',
+        'bank' => 'BANK',
+        'vbank' => 'VCNT',
+        'phone' => 'MOBX',
+    ];
+
+    /** KCP 모바일 pay_method → ActionResult (form hidden field) */
+    private const ACTION_RESULT_MAP = [
+        'CARD' => 'card',
+        'BANK' => 'acnt',
+        'MOBX' => 'mobx',
+        'VCNT' => 'vcnt',
+    ];
+
+    /** 간편결제 direct 파라미터 기본값 (매 결제 시 초기화) */
+    private const EASY_PAY_DIRECT_DEFAULTS = [
+        'payco_direct'    => '',
+        'naverpay_direct' => 'A',
+        'kakaopay_direct' => 'A',
+        'applepay_direct' => 'A',
+    ];
+
+    /** 간편결제별 direct 파라미터 override (기본값 위에 덮어씀) */
+    private const EASY_PAY_DIRECT_FIELDS = [
+        'nhnkcp_payco'          => ['payco_direct' => 'Y'],
+        'nhnkcp_naverpay'       => ['naverpay_direct' => 'Y'],
+        'nhnkcp_naverpay_point' => ['naverpay_direct' => 'Y', 'naverpay_point_direct' => 'Y'],
+        'nhnkcp_kakaopay'       => ['kakaopay_direct' => 'Y'],
+        'nhnkcp_applepay'       => ['applepay_direct' => 'Y'],
+    ];
+
+    private const PLUGIN_IDENTIFIER = 'sirsoft-pay_nhnkcp';
+
+    public function __construct(
+        private readonly KcpSoapService $soapService,
+        private readonly OrderProcessingService $orderService,
+    ) {}
+
+    /**
+     * KCP 모바일 결제 승인키 획득
+     *
+     * POST /api/plugins/sirsoft-pay_nhnkcp/mobile/approval-key
+     *
+     * @return JsonResponse{ success: true, data: { pay_url, fields } }
+     */
+    /**
+     * 모바일 결제 승인키 발급 (SOAP)
+     *
+     * KCP 모바일 결제창 진입 전 SOAP 으로 승인키 + payUrl 발급.
+     *
+     * @param  Request  $request  주문/결제 메타
+     * @return JsonResponse approval_key + pay_url
+     */
+    public function getApprovalKey(Request $request): JsonResponse
+    {
+        $validated = $request->validate([
+            'order_number' => ['required', 'string', 'max:40'],
+            'amount' => ['required', 'integer', 'min:100'],
+            'good_name' => ['required', 'string', 'max:100'],
+            'pay_method' => ['required', 'string'],
+            'buyr_name' => ['nullable', 'string', 'max:50'],
+            'buyr_mail' => ['nullable', 'string', 'email', 'max:100'],
+            'buyr_tel1' => ['nullable', 'string', 'max:20'],
+            'ret_url' => ['required', 'string', 'url'],
+            'currency' => ['nullable', 'string', 'size:3'],
+        ]);
+
+        $payMethodKey = strtolower($validated['pay_method']);
+        $isEasyPay = str_starts_with($payMethodKey, 'nhnkcp_');
+        $mobilePayMethod = $isEasyPay
+            ? 'CARD'
+            : (self::MOBILE_PAY_METHOD_MAP[$payMethodKey] ?? 'CARD');
+
+        $settings = plugin_settings(self::PLUGIN_IDENTIFIER) ?? [];
+        $useEscrow = (bool) ($settings['use_escrow'] ?? false) && ! $isEasyPay;
+
+        try {
+            $order = $this->orderService->findByOrderNumber($validated['order_number']);
+            if (! $order) {
+                return response()->json([
+                    'success' => false,
+                    'error' => 'Order not found.',
+                ], 404);
+            }
+
+            if ((int) $order->user_id !== (int) ($request->user()?->id ?? 0)) {
+                return response()->json([
+                    'success' => false,
+                    'error' => 'You cannot request a NHN KCP approval key for this order.',
+                ], 403);
+            }
+
+            $expectedAmount = $this->resolveExpectedPaymentPriceOrNull($order, 'mobile_approval_key', [
+                'order_number' => $validated['order_number'],
+                'requested_amount' => $validated['amount'],
+                'requested_currency' => $validated['currency'] ?? null,
+                'ip' => $request->ip(),
+            ]);
+            if ($expectedAmount === null) {
+                return response()->json([
+                    'success' => false,
+                    'error' => 'Payment currency is not chargeable.',
+                ], 422);
+            }
+
+            if ((int) $validated['amount'] !== $expectedAmount) {
+                return response()->json([
+                    'success' => false,
+                    'error' => 'Payment amount does not match the order amount.',
+                ], 422);
+            }
+
+            if (! $this->isKrwPayment($order, $validated['currency'] ?? null)) {
+                return response()->json([
+                    'success' => false,
+                    'error' => 'NHN KCP supports KRW payments only.',
+                ], 422);
+            }
+
+            if (! $order->order_status->isBeforePayment()) {
+                $restored = $this->restoreRetryableKcpOrder($order, (int) $validated['amount']);
+                if (! $restored) {
+                    return response()->json([
+                        'success' => false,
+                        'error' => 'Order is not retryable for NHN KCP payment.',
+                    ], 409);
+                }
+            }
+
+            $result = $this->soapService->getApprovalKey(
+                orderNumber: $validated['order_number'],
+                goodName: $validated['good_name'],
+                amount: (int) $validated['amount'],
+                payMethod: $mobilePayMethod,
+                retUrl: $validated['ret_url'],
+                payMethodKey: $payMethodKey,
+                escrow: $useEscrow,
+            );
+
+            $siteCd = $useEscrow
+                ? $this->soapService->getEscrowSiteCd()
+                : $this->soapService->getSiteCd($payMethodKey);
+
+            $fields = [
+                'req_tx' => 'pay',
+                'site_cd' => $siteCd,
+                'ordr_idxx' => $validated['order_number'],
+                'pay_method' => $mobilePayMethod,
+                'good_mny' => (string) $validated['amount'],
+                'good_name' => $validated['good_name'],
+                'buyr_name' => $validated['buyr_name'] ?? '',
+                'buyr_mail' => $validated['buyr_mail'] ?? '',
+                'buyr_tel1' => $validated['buyr_tel1'] ?? '',
+                'Ret_URL' => $validated['ret_url'],
+                'ActionResult' => self::ACTION_RESULT_MAP[$mobilePayMethod] ?? 'card',
+                'escw_used' => $useEscrow ? 'Y' : 'N',
+                'quotaopt' => '12',
+                'currency' => '410',
+                'approval_key' => $result['approval_key'],
+                ...$this->buildTaxFields($order, (int) $validated['amount']),
+            ];
+
+            // 가상계좌 전용 파라미터
+            if ($mobilePayMethod === 'VCNT') {
+                $settings = plugin_settings(self::PLUGIN_IDENTIFIER) ?? [];
+                $fields['vcnt_expire_term'] = (string) ((int) ($settings['vbank_expire_days'] ?? 3));
+                $fields['disp_tax_yn'] = 'N';
+            }
+
+            if ($isEasyPay) {
+                // GNU5 규격: 모든 direct 파라미터를 기본값으로 초기화 후 선택된 수단만 Y로 덮어씀
+                $fields = [...$fields, ...self::EASY_PAY_DIRECT_DEFAULTS];
+                if (isset(self::EASY_PAY_DIRECT_FIELDS[$payMethodKey])) {
+                    $fields = [...$fields, ...self::EASY_PAY_DIRECT_FIELDS[$payMethodKey]];
+                }
+                $fields = [...$fields, ...$this->buildEasyPayReturnFields($payMethodKey)];
+            }
+
+            return response()->json([
+                'success' => true,
+                'data' => [
+                    'pay_url' => $result['pay_url'],
+                    'fields' => $fields,
+                ],
+            ]);
+
+        } catch (NhnKcpApiException $e) {
+            return response()->json([
+                'success' => false,
+                'error' => $e->getMessage(),
+            ], 422);
+        }
+    }
+
+    /**
+     * 주문의 과세/비과세 분할 필드 반환 (복합과세 사이트 코드 계약 시 필요)
+     *
+     * 비과세 금액이 있는 경우에만 comm_tax_mny / comm_vat_mny / comm_free_mny 추가.
+     * 전액 과세라면 good_mny 만으로 KCP가 내부적으로 세금 계산.
+     *
+     * @return array<string, string>
+     */
+    private function buildTaxFields(Order $order, int $paymentAmount): array
+    {
+        $taxFreeAmt = (int) round((float) ($order->total_tax_free_amount ?? 0));
+        if ($taxFreeAmt <= 0) {
+            return [];
+        }
+
+        $paymentAmount = max(0, $paymentAmount);
+        $taxFreeAmt = min($taxFreeAmt, $paymentAmount);
+        $taxablePaymentAmt = max(0, $paymentAmount - $taxFreeAmt);
+        $taxTotalAmt = (int) round((float) ($order->total_tax_amount ?? 0));
+        $vatAmt = (int) round((float) ($order->total_vat_amount ?? 0));
+        if ($taxablePaymentAmt > 0 && $taxTotalAmt > 0 && $vatAmt > 0) {
+            $vatAmt = min($taxablePaymentAmt, (int) round($taxablePaymentAmt * ($vatAmt / $taxTotalAmt)));
+        } else {
+            $vatAmt = 0;
+        }
+        $supplyAmt = $taxablePaymentAmt - $vatAmt; // 공급가액 (VAT 제외)
+
+        return [
+            'tax_flag'      => 'TG03',
+            'comm_tax_mny'  => (string) $supplyAmt,
+            'comm_vat_mny'  => (string) $vatAmt,
+            'comm_free_mny' => (string) $taxFreeAmt,
+        ];
+    }
+
+    /**
+     * @return array<string, string>
+     */
+    private function buildEasyPayReturnFields(string $payMethodKey): array
+    {
+        if (! isset(self::EASY_PAY_DIRECT_FIELDS[$payMethodKey])) {
+            return [];
+        }
+
+        return [
+            'param_opt_1' => $payMethodKey,
+            'nhnkcp_easy_pay_method' => $payMethodKey,
+        ];
+    }
+
+    private function isKrwPayment(Order $order, ?string $requestedCurrency): bool
+    {
+        return $this->normalizeCurrency($requestedCurrency) === 'KRW'
+            && $this->normalizeCurrency((string) ($order->currency ?? 'KRW')) === 'KRW';
+    }
+
+    private function normalizeCurrency(?string $currency): string
+    {
+        $normalized = strtoupper(trim((string) $currency));
+
+        return $normalized !== '' ? $normalized : 'KRW';
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/PaymentCallbackController.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/PaymentCallbackController.php
new file mode 100644
index 00000000..4156ebb5
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/PaymentCallbackController.php
@@ -0,0 +1,957 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Controllers;
+
+use App\Extension\HookManager;
+use App\Services\PluginSettingsService;
+use Carbon\Carbon;
+use Illuminate\Contracts\Cache\LockTimeoutException;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+use Illuminate\Support\Facades\Log;
+use Modules\Sirsoft\Ecommerce\Enums\OrderStatusEnum;
+use Modules\Sirsoft\Ecommerce\Exceptions\PaymentAmountMismatchException;
+use Modules\Sirsoft\Ecommerce\Helpers\DeviceDetector;
+use Modules\Sirsoft\Ecommerce\Models\Order;
+use Modules\Sirsoft\Ecommerce\Services\OrderProcessingService;
+use Plugins\Sirsoft\PayNhnkcp\Concerns\PreventsReplayCallback;
+use Plugins\Sirsoft\PayNhnkcp\Concerns\IssuesReceiptCookie;
+use Plugins\Sirsoft\PayNhnkcp\Concerns\RecordsPaymentWindowClosure;
+use Plugins\Sirsoft\PayNhnkcp\Concerns\ResolvesEasyPayDisplay;
+use Plugins\Sirsoft\PayNhnkcp\Concerns\SanitizesPgResponse;
+use Plugins\Sirsoft\PayNhnkcp\Concerns\SerializesPaymentCallbacks;
+use Plugins\Sirsoft\PayNhnkcp\Concerns\SendsKcpNotifyResponse;
+use Plugins\Sirsoft\PayNhnkcp\Http\Requests\AuthCallbackRequest;
+use Plugins\Sirsoft\PayNhnkcp\Http\Requests\VbankNotifyRequest;
+use Plugins\Sirsoft\PayNhnkcp\Services\NhnKcpApiService;
+
+/**
+ * KCP 결제 콜백 컨트롤러
+ *
+ * KCP Standard Pay는 브라우저 POST 콜백 방식입니다:
+ *   1단계: 브라우저가 POST 콜백으로 enc_data, enc_info 등 전달 → authCallback()
+ *   2단계: 서버가 KCP CLI 바이너리로 최종 승인 확인 → NhnKcpApiService::approvePayment()
+ */
+class PaymentCallbackController
+{
+    use PreventsReplayCallback;
+    use IssuesReceiptCookie;
+    use RecordsPaymentWindowClosure;
+    use ResolvesEasyPayDisplay;
+    use SanitizesPgResponse;
+    use SerializesPaymentCallbacks;
+    use SendsKcpNotifyResponse;
+
+    private const PLUGIN_IDENTIFIER = 'sirsoft-pay_nhnkcp';
+
+    private const SUCCESS_RES_CD = '0000';
+
+    // 사용자가 결제창을 직접 닫은 취소 코드 — 조용히 체크아웃으로 복귀
+    private const CANCEL_RES_CODES = ['3001', '3000', '7777', ''];
+
+    // KCP 공통통보 tx_cd — 그누보드5 settle_kcp_common.php 참고
+    private const KCP_TX_CD_VBANK_DEPOSIT = 'TX00';
+
+    // KCP 가상계좌 입금통보 op_cd
+    private const KCP_OP_CD_DEPOSIT_COMPLETE = '50';
+
+    private const KCP_OP_CD_DEPOSIT_RESEND = '01';
+
+    private const KCP_OP_CD_DEPOSIT_CANCEL = '13';
+
+    private const AUTH_RESPONSE_KEYS = [
+        'res_cd',
+        'res_msg',
+        'tno',
+        'ordr_idxx',
+        'good_mny',
+        'use_pay_method',
+        'app_time',
+        'app_no',
+        'card_cd',
+        'card_name',
+        'quota',
+        'noinf',
+        'escw_yn',
+        'bank_code',
+        'bank_name',
+        'cash_yn',
+        'receipt_no',
+    ];
+
+    private const VBANK_NOTIFY_RESPONSE_KEYS = [
+        'site_cd',
+        'tno',
+        'order_no',
+        'tx_cd',
+        'tx_tm',
+        'ipgm_mnyx',
+        'bank_code',
+        'op_cd',
+        'noti_id',
+    ];
+
+    private const VBANK_ISSUE_RESPONSE_KEYS = [
+        'res_cd',
+        'res_msg',
+        'tno',
+        'bankname',
+        'bank_name',
+        'bankcode',
+        'bank_code',
+        'va_date',
+        'vnbank_expire_date',
+        'app_time',
+        'use_pay_method',
+    ];
+
+    public function __construct(
+        private readonly OrderProcessingService $orderService,
+        private readonly PluginSettingsService $pluginSettingsService,
+        private readonly NhnKcpApiService $apiService,
+    ) {}
+
+    /**
+     * KCP 결제 승인 콜백
+     *
+     * POST /plugins/sirsoft-pay_nhnkcp/payment/callback
+     * (CSRF 제외 - KCP가 브라우저 통해 POST 전달)
+     */
+    /**
+     * KCP 결제 승인 콜백
+     *
+     * 1단계: KCP Standard Pay 가 결제창 완료 후 ReturnURL 로 POST 콜백.
+     * 2단계: enc_data + enc_info 로 서버 승인 요청. 결제 수단별로 가상계좌(계좌발급)/
+     * 카드(즉시완료) 분기. 사용자 취소 / 인증 실패 시 에러 query 로 체크아웃 복귀.
+     *
+     * @param  AuthCallbackRequest  $request  검증된 콜백 페이로드
+     * @return RedirectResponse 성공/실패 URL 로 리다이렉트
+     */
+    public function authCallback(AuthCallbackRequest $request): RedirectResponse
+    {
+        $validated = $request->validated();
+
+        $resCd = (string) ($validated['res_cd'] ?? '');
+        $resMsg = $this->decodeKcpMessage($validated['res_msg'] ?? '');
+        $encData = $validated['enc_data'] ?? '';  // 모바일 취소 시 미포함
+        $encInfo = $validated['enc_info'] ?? '';  // 모바일 취소 시 미포함
+        $ordrIdxx = $validated['ordr_idxx'];
+        $goodMny = isset($validated['good_mny']) ? (int) $validated['good_mny'] : 0;
+        $custIp = $request->ip() ?? '127.0.0.1';
+
+        Log::info('KCP: authCallback received', [
+            'ordr_idxx' => $ordrIdxx,
+            'res_cd' => $resCd,
+            'good_mny' => $goodMny,
+            'has_enc_data' => ! empty($encData),
+            'has_enc_info' => ! empty($encInfo),
+            'post_keys' => array_keys($request->all()),
+        ]);
+
+        // 1단계: KCP 브라우저 결과 코드 확인
+        if ($resCd !== self::SUCCESS_RES_CD) {
+            $isCancelled = in_array($resCd, self::CANCEL_RES_CODES, true);
+
+            Log::info('KCP: payment result non-success', [
+                'ordr_idxx' => $ordrIdxx,
+                'res_cd' => $resCd,
+                'res_msg' => $resMsg,
+                'is_cancelled' => $isCancelled,
+            ]);
+
+            // authCallback is a browser-return endpoint without PG-server signature/IP proof.
+            // Do not mutate order state from a non-success browser result alone; the
+            // authenticated close-report path records real window closures.
+
+            // 사용자 취소는 오류 없이 체크아웃으로 복귀
+            if ($isCancelled) {
+                return redirect($this->resolveFailUrl());
+            }
+
+            return redirect($this->resolveFailUrl([
+                'error' => $resCd,
+                'message' => $resMsg,
+                'orderId' => $ordrIdxx,
+            ]));
+        }
+
+        // Approve 성공 후 후속 처리 실패 시 PG 측 자동 cancel 을 위한 추적 변수.
+        // catch 블록에서 tno 가 set 되어 있으면 KCP 측 승인이 이미 발생한 상태이므로
+        // cancelPayment 를 호출해 PG 잔존 승인을 해제한다 (사용자 환불 보장).
+        $order = null;
+        $approvedTno = null;
+        $approvedAmtForCancel = 0;
+        $callbackLock = null;
+
+        try {
+            // 2단계: 주문 조회
+            $order = $this->orderService->findByOrderNumber($ordrIdxx);
+
+            if (! $order) {
+                Log::error('KCP: order not found', ['ordr_idxx' => $ordrIdxx]);
+
+                return redirect($this->resolveFailUrl(['error' => 'order_not_found', 'orderId' => $ordrIdxx]));
+            }
+
+            $callbackLock = $this->acquireOrderCallbackLock('authCallback', $ordrIdxx);
+            $order = $order->fresh('payment') ?? $order;
+
+            if ($order->order_status === OrderStatusEnum::CANCELLED) {
+                $restored = $this->restoreRetryableKcpOrder($order, $goodMny > 0 ? $goodMny : null);
+                if (! $restored) {
+                    Log::warning('KCP: cancelled order is not retryable', ['ordr_idxx' => $ordrIdxx]);
+
+                    return redirect($this->resolveFailUrl([
+                        'error' => 'order_not_retryable',
+                        'orderId' => $ordrIdxx,
+                    ]));
+                }
+
+                $order = $order->fresh('payment') ?? $order;
+            }
+
+            if (($order->payment?->isPaid() ?? false) || $order->order_status === OrderStatusEnum::PAYMENT_COMPLETE) {
+                Log::info('KCP: authCallback already paid order, skipping CLI approval', [
+                    'ordr_idxx' => $ordrIdxx,
+                    'transaction_id' => $order->payment?->transaction_id,
+                ]);
+
+                $this->queueReceiptCookie($ordrIdxx);
+
+                return redirect($this->resolveSuccessUrl($ordrIdxx));
+            }
+
+            $expectedAmount = $this->resolveExpectedPaymentPriceOrNull($order, 'auth_callback', [
+                'ordr_idxx' => $ordrIdxx,
+                'good_mny' => $goodMny,
+            ]);
+            if ($expectedAmount === null) {
+                return redirect($this->resolveFailUrl([
+                    'error' => 'invalid_payment_currency',
+                    'orderId' => $ordrIdxx,
+                ]));
+            }
+
+            if (! $this->isKrwOrder($order)) {
+                Log::warning('KCP: unsupported order currency', [
+                    'ordr_idxx' => $ordrIdxx,
+                    'currency' => $this->orderCurrency($order),
+                ]);
+
+                return redirect($this->resolveFailUrl(['error' => 'currency_not_supported', 'orderId' => $ordrIdxx]));
+            }
+
+            if ($goodMny > 0 && $goodMny !== $expectedAmount) {
+                Log::warning('KCP: browser callback amount mismatch before approval', [
+                    'ordr_idxx' => $ordrIdxx,
+                    'expected' => $expectedAmount,
+                    'actual' => $goodMny,
+                ]);
+
+                $failedOrder = $this->orderService->failPayment($order, 'AMOUNT_MISMATCH', 'KCP callback amount mismatch');
+                $this->markKcpPaymentFailureRecord(
+                    $failedOrder,
+                    'AMOUNT_MISMATCH',
+                    'KCP callback amount mismatch',
+                    'amount_mismatch',
+                );
+
+                return redirect($this->resolveFailUrl(['error' => 'amount_mismatch', 'orderId' => $ordrIdxx]));
+            }
+
+            // 가상계좌: 계좌 발급 완료 처리 (실제 입금은 vbankNotify에서 처리)
+            // KCP 콜백의 use_pay_method=VCNT 또는 주문의 payment_method=vbank 로 감지
+            $isVbank = ($validated['use_pay_method'] ?? '') === 'VCNT'
+                || in_array($order->payment?->payment_method?->value, ['vbank', 'virtual_account'], true);
+            if ($isVbank) {
+                return $this->handleVbankIssued($validated, $order, $encData, $encInfo, $ordrIdxx, $custIp, $request);
+            }
+
+            HookManager::doAction('sirsoft-pay_nhnkcp.payment.before_confirm', $order, $validated);
+
+            // 3단계: KCP CLI로 최종 승인 확인
+            $pgResponse = $this->apiService->approvePayment($encData, $encInfo, $ordrIdxx, $custIp);
+
+            HookManager::doAction('sirsoft-pay_nhnkcp.payment.after_confirm', $order, $pgResponse);
+
+            $pgResCd = $pgResponse['res_cd'] ?? '';
+
+            if ($pgResCd !== self::SUCCESS_RES_CD) {
+                Log::warning('KCP: CLI approval failed', [
+                    'ordr_idxx' => $ordrIdxx,
+                    'res_cd' => $pgResCd,
+                    'res_msg' => $pgResponse['res_msg'] ?? '',
+                ]);
+
+                $failedOrder = $this->orderService->failPayment($order, $pgResCd, $pgResponse['res_msg'] ?? '');
+                $this->markKcpPaymentFailureRecord(
+                    $failedOrder,
+                    $pgResCd,
+                    $pgResponse['res_msg'] ?? '',
+                    'approval_failed',
+                );
+
+                return redirect($this->resolveFailUrl([
+                    'error' => $pgResCd,
+                    'message' => $pgResponse['res_msg'] ?? '',
+                    'orderId' => $ordrIdxx,
+                ]));
+            }
+
+            $tno = $pgResponse['tno'] ?? ($validated['tno'] ?? '');
+
+            // Replay 가드: 동일 tno 가 이미 paid 상태면 중복 처리하지 않고 성공 페이지로 복귀
+            if ($this->wasAlreadyPaid($tno)) {
+                $this->logReplayDetected($tno, $ordrIdxx, 'authCallback (card)');
+                $this->queueReceiptCookie($ordrIdxx);
+
+                return redirect($this->resolveSuccessUrl($ordrIdxx));
+            }
+
+            // KCP는 CLI 응답에 good_mny가 없는 경우가 많으므로 주문 금액으로 검증.
+            // 결제 청구액 SSoT = 결제 통화(order_currency) 환산액 (마일리지/예치금 차감 후 실청구액) —
+            // 클라이언트 결제 요청액(buildPgPaymentData)·코어 최종 승인 검증과 동일 기준.
+            // base≠결제 통화(예: base JPY, 결제 KRW)에서도 PG 청구 통화와 단위가 일치한다.
+            $approvedAmt = $goodMny > 0
+                ? $goodMny
+                : $expectedAmount;
+
+            // PG 측 승인이 확정된 시점 — 후속 처리 실패 시 cancel 필요. catch 에서 참조.
+            $approvedTno = $tno;
+            $approvedAmtForCancel = $approvedAmt;
+
+            $isEscrow = ($pgResponse['escw_yn'] ?? '') === 'Y';
+            $easyPayMeta = $this->resolveEasyPayMeta($validated);
+
+            // 4단계: 주문 완료 처리
+            $this->orderService->completePayment($order, [
+                'transaction_id' => $tno,
+                'card_approval_number' => $pgResponse['app_no'] ?? null,
+                'card_number_masked' => $pgResponse['card_no'] ?? $pgResponse['account'] ?? null,
+                'card_name' => $pgResponse['card_name'] ?? $pgResponse['bank_name'] ?? null,
+                'card_installment_months' => (int) ($pgResponse['quota'] ?? 0),
+                'is_interest_free' => false,
+                'embedded_pg_provider' => $easyPayMeta['provider'] ?? null,
+                'receipt_url' => null,
+                'payment_meta' => [
+                    'res_cd' => $pgResCd,
+                    ...$this->currentCredentialMeta(),
+                    ...($easyPayMeta === [] ? [] : [
+                        'nhnkcp_easy_pay_method' => $easyPayMeta['method'],
+                        'nhnkcp_easy_pay_provider' => $easyPayMeta['provider'],
+                        'nhnkcp_easy_pay_label' => $easyPayMeta['label'],
+                    ]),
+                    'use_pay_method' => $validated['use_pay_method'] ?? $pgResponse['use_pay_method'] ?? null,
+                    'app_time' => $pgResponse['app_time'] ?? null,
+                    'bank_name' => $pgResponse['bank_name'] ?? null,
+                    'vnbank_expire_date' => $pgResponse['vnbank_expire_date'] ?? null,
+                    'escw_yn' => $pgResponse['escw_yn'] ?? null,
+                    'pg_response_sanitized' => true,
+                    'pg_raw_response' => $this->sanitizePgResponse($pgResponse, self::AUTH_RESPONSE_KEYS),
+                ],
+                'payment_device' => DeviceDetector::detect($request),
+            ], $approvedAmt);
+
+            // 에스크로 결제인 경우 is_escrow 플래그 저장
+            if ($isEscrow) {
+                $order->payment()->update(['is_escrow' => true]);
+            }
+
+            // KCP가 실제로 결제를 처리했으므로 pg_provider를 nhnkcp로 보정
+            // (기본 PG가 타 PG일 때 주문이 해당 PG provider로 생성되는 경우 대비)
+            $order->payment()->update(['pg_provider' => 'nhnkcp']);
+
+            $this->queueReceiptCookie($ordrIdxx);
+
+            return redirect($this->resolveSuccessUrl($ordrIdxx));
+
+        } catch (LockTimeoutException $e) {
+            Log::warning('KCP: authCallback skipped because callback lock is busy', [
+                'ordr_idxx' => $ordrIdxx,
+            ]);
+
+            $latestOrder = $this->orderService->findByOrderNumber($ordrIdxx);
+            if (($latestOrder?->payment?->isPaid() ?? false)
+                || $latestOrder?->order_status === OrderStatusEnum::PAYMENT_COMPLETE) {
+                $this->queueReceiptCookie($ordrIdxx);
+
+                return redirect($this->resolveSuccessUrl($ordrIdxx));
+            }
+
+            return redirect($this->resolveFailUrl([
+                'error' => 'callback_locked',
+                'orderId' => $ordrIdxx,
+            ]));
+
+        } catch (PaymentAmountMismatchException $e) {
+            Log::error('KCP: amount mismatch', [
+                'ordr_idxx' => $ordrIdxx,
+                'expected' => $e->getExpectedAmount(),
+                'actual' => $e->getActualAmount(),
+            ]);
+
+            // Approve 가 이미 KCP 측에서 발생했으면 자동 취소로 PG 잔존 승인 해제
+            $this->autoCancelIfApproved($approvedTno, $ordrIdxx, $approvedAmtForCancel, 'amount_mismatch');
+
+            if ($order instanceof Order) {
+                $failedOrder = $this->orderService->failPayment($order, 'AMOUNT_MISMATCH', $e->getMessage());
+                $this->markKcpPaymentFailureRecord(
+                    $failedOrder,
+                    'AMOUNT_MISMATCH',
+                    $e->getMessage(),
+                    'amount_mismatch',
+                );
+            }
+
+            return redirect($this->resolveFailUrl(['error' => 'amount_mismatch', 'orderId' => $ordrIdxx]));
+
+        } catch (\Exception $e) {
+            Log::error('KCP: confirm exception', [
+                'ordr_idxx' => $ordrIdxx,
+                'error' => $e->getMessage(),
+            ]);
+
+            $this->autoCancelIfApproved($approvedTno, $ordrIdxx, $approvedAmtForCancel, 'confirm_failed');
+
+            if ($order instanceof Order) {
+                $failedOrder = $this->orderService->failPayment($order, 'CONFIRM_FAILED', $e->getMessage());
+                $this->markKcpPaymentFailureRecord(
+                    $failedOrder,
+                    'CONFIRM_FAILED',
+                    $e->getMessage(),
+                    'confirm_failed',
+                );
+            }
+
+            return redirect($this->resolveFailUrl([
+                'error' => 'confirm_failed',
+                'message' => $e->getMessage(),
+                'orderId' => $ordrIdxx,
+            ]));
+        } finally {
+            $this->releaseOrderCallbackLock($callbackLock);
+        }
+    }
+
+    /**
+     * KCP 가상계좌 입금 통보 처리
+     *
+     * POST /plugins/sirsoft-pay_nhnkcp/payment/vbank-notify
+     * (KCP 서버 → 우리 서버, CSRF 제외)
+     *
+     * KCP 공식 webhook 페이로드 (그누보드5 settle_kcp_common.php 참고):
+     *   tx_cd=TX00 (가상계좌 입금) + op_cd 50/01/13 + ipgm_mnyx + order_no + noti_id
+     *
+     * 응답: <form><input name="result" value="0000"> HTML 을 KCP 가 파싱.
+     * result="0000" 이면 통보 성공, 그 외이면 재통보 (최대 10회).
+     *
+     * @param  VbankNotifyRequest  $request  검증된 입금통보 페이로드
+     * @return Response 200 + KCP 표준 result HTML
+     */
+    public function vbankNotify(VbankNotifyRequest $request): Response
+    {
+        $validated = $request->validated();
+
+        $txCd = (string) ($validated['tx_cd'] ?? self::KCP_TX_CD_VBANK_DEPOSIT);
+        $tno = $validated['tno'];
+        $orderNo = $validated['order_no'];
+        $opCd = (string) ($validated['op_cd'] ?? '');
+        $ipgmMny = (int) ($validated['ipgm_mnyx'] ?? 0);
+        $notiId = $validated['noti_id'] ?? null;
+        $callbackLock = null;
+
+        // tx_cd 가 TX00 가 아니면 본 endpoint 가 처리하지 않음.
+        // (KCP 가 단일 webhook URL 에 모든 tx_cd 를 보낼 수도 있어 안전하게 무시 + result=0000)
+        if ($txCd !== self::KCP_TX_CD_VBANK_DEPOSIT) {
+            Log::info('KCP: vbank-notify ignored non-TX00', [
+                'tno' => $tno, 'order_no' => $orderNo, 'tx_cd' => $txCd, 'noti_id' => $notiId,
+            ]);
+
+            return $this->kcpNotifyResponse();
+        }
+
+        // op_cd 분기 (그누보드5 settle_kcp_common.php 와 동일 정책):
+        //   13 (망취소)         → 별도 처리 (입금완료 안 함, 결제 취소 정책 미정 — 로깅만)
+        //   그 외 (50/01/18/…)  → 입금완료 처리 (KCP testadmin 모의입금은 op_cd=18 사용 확인됨)
+        // KCP 공식 문서가 50/01/13 만 언급하지만 실제 KCP testadmin 발신은 18 등 추가 코드를
+        // 사용하므로 그누보드5 의 op_cd 무관 입금처리 정책을 따른다 (망취소만 분리).
+        if ($opCd === self::KCP_OP_CD_DEPOSIT_CANCEL) {
+            Log::warning('KCP: vbank deposit cancelled (op_cd=13)', [
+                'tno' => $tno, 'order_no' => $orderNo, 'noti_id' => $notiId, 'ipgm_mnyx' => $ipgmMny,
+            ]);
+
+            return $this->kcpNotifyResponse();
+        }
+
+        try {
+            $order = $this->orderService->findByOrderNumber($orderNo);
+
+            if (! $order) {
+                Log::error('KCP: vbank notify - order not found', [
+                    'order_no' => $orderNo, 'tno' => $tno, 'noti_id' => $notiId,
+                ]);
+
+                // 영구 실패 — 재시도 의미 없음. result=0000 으로 KCP 재통보 차단.
+                return $this->kcpNotifyResponse();
+            }
+
+            $callbackLock = $this->acquireOrderCallbackLock('vbankNotify', $orderNo);
+            $order = $order->fresh('payment') ?? $order;
+
+            $contextError = $this->validateVbankNotifyContext($order, $validated, $tno, $ipgmMny);
+            if ($contextError !== null) {
+                Log::warning('KCP: vbank notify context mismatch — retry requested', [
+                    'reason' => $contextError,
+                    'tno' => $tno,
+                    'order_no' => $orderNo,
+                    'noti_id' => $notiId,
+                ]);
+
+                return $this->kcpNotifyRetry();
+            }
+
+            // 멱등성 — 이미 결제완료 상태면 재처리 없이 0000 응답 (op_cd=01 재전송 대응)
+            if ($order->payment?->isPaid() ?? false) {
+                Log::info('KCP: vbank-notify already paid (idempotent)', [
+                    'tno' => $tno, 'order_no' => $orderNo, 'noti_id' => $notiId, 'op_cd' => $opCd,
+                ]);
+
+                return $this->kcpNotifyResponse();
+            }
+
+            $this->orderService->completePayment($order, [
+                'transaction_id' => $tno,
+                'payment_meta' => [
+                    'tx_cd' => $txCd,
+                    'op_cd' => $opCd,
+                    'noti_id' => $notiId,
+                    ...$this->currentCredentialMeta((string) ($validated['site_cd'] ?? '')),
+                    'bank_code' => $validated['bank_code'] ?? null,
+                    'ipgm_time' => $validated['tx_tm'] ?? null,
+                    'pg_response_sanitized' => true,
+                    'pg_raw_response' => $this->sanitizePgResponse($validated, self::VBANK_NOTIFY_RESPONSE_KEYS),
+                ],
+            ], $ipgmMny);
+
+            $order->payment()->update(['pg_provider' => 'nhnkcp']);
+
+            Log::info('KCP: vbank deposit confirmed', [
+                'tno' => $tno, 'order_no' => $orderNo, 'ipgm_mnyx' => $ipgmMny,
+                'op_cd' => $opCd, 'noti_id' => $notiId,
+            ]);
+
+            return $this->kcpNotifyResponse();
+
+        } catch (LockTimeoutException $e) {
+            Log::warning('KCP: vbank notify lock timeout — retry requested', [
+                'tno' => $tno,
+                'order_no' => $orderNo,
+                'noti_id' => $notiId,
+            ]);
+
+            return $this->kcpNotifyRetry();
+
+        } catch (\Exception $e) {
+            Log::error('KCP: vbank notify failed', [
+                'tno' => $tno, 'order_no' => $orderNo, 'noti_id' => $notiId,
+                'error' => $e->getMessage(),
+            ]);
+
+            // 일시적 실패 (DB 등) — result != 0000 으로 KCP 재통보 유도
+            return $this->kcpNotifyRetry();
+        } finally {
+            $this->releaseOrderCallbackLock($callbackLock);
+        }
+    }
+
+    /**
+     * 가상계좌 발급 처리
+     *
+     * authCallback 에서 use_pay_method=VCNT 일 때 호출.
+     *
+     * PC Standard Pay: enc_data/enc_info 가 동봉되어 CLI 로 복호화하여 계좌 정보를 얻음.
+     * Mobile SmartPhone Pay: enc_data 없이 평문 필드(bankname/account/depositor/va_date)가
+     *   콜백 POST 에 직접 포함되므로 CLI 호출을 건너뛰고 요청에서 직접 읽음.
+     *
+     * 발급 성공 = res_cd == 0000 AND bankname/account 가 모두 채워진 경우만.
+     * 그 외 (CLI 9502 / 예외 / 평문 필드 결락) 는 발급 실패로 판정해 failPayment + fail URL.
+     */
+    private function handleVbankIssued(
+        array $validated,
+        Order $order,
+        string $encData,
+        string $encInfo,
+        string $ordrIdxx,
+        string $custIp,
+        Request $request,
+    ): RedirectResponse {
+        $tno = $validated['tno'] ?? '';
+        $pgResponse = [];
+        $isMobile = $encData === '' || $encInfo === '';
+
+        if ($isMobile) {
+            // 모바일: 콜백 POST 의 평문 필드를 그대로 응답으로 취급
+            // KCP 변종 키 모두 대응 (bankname|bank_name, depositor|account_holder, va_date|vnbank_expire_date)
+            $pgResponse = [
+                'res_cd' => $validated['res_cd'] ?? self::SUCCESS_RES_CD,
+                'res_msg' => $validated['res_msg'] ?? '',
+                'tno' => $tno,
+                'bankname' => $request->input('bankname') ?? $request->input('bank_name'),
+                'account' => $request->input('account'),
+                'depositor' => $request->input('depositor') ?? $request->input('account_holder'),
+                'va_date' => $request->input('va_date') ?? $request->input('vnbank_expire_date'),
+            ];
+        } else {
+            // PC: CLI 호출. 호출 자체 실패(권한 누락 / pub.key 부재 등)는 발급 여부 미확정이므로 안전하게 실패 처리.
+            try {
+                $pgResponse = $this->apiService->approvePayment($encData, $encInfo, $ordrIdxx, $custIp);
+            } catch (\Exception $e) {
+                Log::error('KCP: vbank CLI exception — treating as issuance failure', [
+                    'ordr_idxx' => $ordrIdxx,
+                    'error' => $e->getMessage(),
+                ]);
+
+                $failedOrder = $this->orderService->failPayment($order, 'cli_exception', $e->getMessage());
+                $this->markKcpPaymentFailureRecord(
+                    $failedOrder,
+                    'cli_exception',
+                    $e->getMessage(),
+                    'vbank_cli_exception',
+                );
+
+                return redirect($this->resolveFailUrl([
+                    'error' => 'cli_exception',
+                    'message' => $e->getMessage(),
+                    'orderId' => $ordrIdxx,
+                ]));
+            }
+        }
+
+        $pgResCd = $pgResponse['res_cd'] ?? '';
+        $bankname = $pgResponse['bankname'] ?? null;
+        $account = $pgResponse['account'] ?? null;
+
+        // 발급 성공 판정 — 핵심 필드(은행명/계좌번호) 모두 채워진 경우만 성공.
+        // KCP 표준결제창은 결제수단별로 정상 res_cd 가 다르다 (card=0000, vbank=V000).
+        // res_cd 단일 비교 대신 발급 데이터 존재 여부로 판정해 응답 변종에 견고하게 대응.
+        // - V000 + bankname/account 존재 → 정상 발급 (success)
+        // - 0000 + bankname/account 존재 → 정상 발급 (success)
+        // - 9502 + bankname/account 부재 → 발급 실패 (fail)
+        $hasIssuanceData = ($bankname !== null && $bankname !== '')
+            && ($account !== null && $account !== '');
+
+        if (! $hasIssuanceData) {
+            $resMsg = $this->decodeKcpMessage($pgResponse['res_msg'] ?? '');
+            $effectiveCode = $pgResCd !== '' && $pgResCd !== self::SUCCESS_RES_CD
+                ? $pgResCd
+                : 'vbank_issuance_incomplete';
+            $effectiveMsg = $resMsg !== '' ? $resMsg : '가상계좌 발급 정보 누락';
+
+            Log::warning('KCP: vbank issuance failed', [
+                'ordr_idxx' => $ordrIdxx,
+                'res_cd' => $pgResCd,
+                'res_msg' => $resMsg,
+                'has_bankname' => $bankname !== null && $bankname !== '',
+                'has_account' => $account !== null && $account !== '',
+                'is_mobile' => $isMobile,
+            ]);
+
+            $failedOrder = $this->orderService->failPayment($order, $effectiveCode, $effectiveMsg);
+            $this->markKcpPaymentFailureRecord(
+                $failedOrder,
+                $effectiveCode,
+                $effectiveMsg,
+                'vbank_issuance_failed',
+            );
+
+            return redirect($this->resolveFailUrl([
+                'error' => $effectiveCode,
+                'message' => $effectiveMsg,
+                'orderId' => $ordrIdxx,
+            ]));
+        }
+
+        if ($isMobile) {
+            Log::info('KCP: vbank account issued via mobile callback (no CLI)', [
+                'ordr_idxx' => $ordrIdxx,
+                'tno' => $tno,
+                'bankname' => $bankname,
+                'account' => $account,
+                'va_date' => $pgResponse['va_date'] ?? null,
+            ]);
+        } else {
+            $tno = $pgResponse['tno'] ?? $tno;
+            Log::info('KCP: vbank account issued via CLI', [
+                'ordr_idxx' => $ordrIdxx,
+                'tno' => $tno,
+                'bankname' => $bankname,
+                'account' => $account,
+            ]);
+        }
+
+        // 가상계좌 발급 정보를 OrderPayment vbank 전용 컬럼에 저장 (PENDING_PAYMENT 상태 유지).
+        // 저장 실패 시도 부분 저장으로 사용자에게 잘못된 정보가 노출되지 않도록 failPayment 처리.
+        try {
+            $expireRaw = $pgResponse['va_date'] ?? null;
+            $vbankDueAt = null;
+            if ($expireRaw) {
+                // KCP va_date: YYYYMMDDHHMMSS (14자리) 또는 YYYYMMDD (8자리)
+                try {
+                    $vbankDueAt = strlen($expireRaw) <= 8
+                        ? Carbon::createFromFormat('Ymd', $expireRaw)->endOfDay()
+                        : Carbon::createFromFormat('YmdHis', $expireRaw);
+                } catch (\Exception) {
+                    $vbankDueAt = null;
+                }
+            }
+
+            $order->payment()->update(array_filter([
+                'transaction_id' => $tno ?: null,
+                'vbank_name' => $bankname,
+                'vbank_number' => $account,
+                'vbank_holder' => $pgResponse['depositor'] ?? null,
+                'vbank_due_at' => $vbankDueAt,
+                'vbank_issued_at' => now(),
+                'payment_device' => $isMobile ? 'mobile' : 'pc',
+                'payment_meta' => [
+                    'result_code' => $pgResponse['res_cd'] ?? null,
+                    'tno' => $tno ?: null,
+                    ...$this->currentCredentialMeta(),
+                    'bankname' => $bankname,
+                    'bankcode' => $pgResponse['bankcode'] ?? $pgResponse['bank_code'] ?? null,
+                    'va_date' => $pgResponse['va_date'] ?? $pgResponse['vnbank_expire_date'] ?? null,
+                    'app_time' => $pgResponse['app_time'] ?? null,
+                    'pg_response_sanitized' => true,
+                    'pg_raw_response' => $this->sanitizePgResponse($pgResponse, self::VBANK_ISSUE_RESPONSE_KEYS),
+                ],
+            ], fn ($v) => $v !== null));
+        } catch (\Exception $e) {
+            Log::error('KCP: failed to save vbank info to OrderPayment', [
+                'ordr_idxx' => $ordrIdxx,
+                'error' => $e->getMessage(),
+            ]);
+
+            $failedOrder = $this->orderService->failPayment($order, 'vbank_save_failed', $e->getMessage());
+            $this->markKcpPaymentFailureRecord(
+                $failedOrder,
+                'vbank_save_failed',
+                $e->getMessage(),
+                'vbank_save_failed',
+            );
+
+            return redirect($this->resolveFailUrl([
+                'error' => 'vbank_save_failed',
+                'message' => $e->getMessage(),
+                'orderId' => $ordrIdxx,
+            ]));
+        }
+
+        $this->queueReceiptCookie($ordrIdxx);
+
+        return redirect($this->resolveSuccessUrl($ordrIdxx));
+    }
+
+    /**
+     * KCP webhook 이 주장한 값이 결제창에서 발급받아 저장한 값과 일치하는지 확인한다.
+     *
+     * KCP 입금통보에는 별도 서명 필드가 없으므로, 주문번호만 믿지 않고 저장된
+     * tno/site_cd/가상계좌/금액을 모두 대조해 위조 통보를 차단한다.
+     */
+    private function validateVbankNotifyContext(Order $order, array $validated, string $tno, int $amount): ?string
+    {
+        $payment = $order->payment;
+        if (! $payment) {
+            return 'payment_not_found';
+        }
+
+        if (! in_array($payment->payment_method?->value, ['vbank', 'virtual_account'], true)) {
+            return 'payment_method_not_vbank';
+        }
+
+        $meta = $payment->payment_meta ?? [];
+        $storedTno = trim((string) ($payment->transaction_id ?: ($meta['tno'] ?? '')));
+        if ($storedTno === '' || ! hash_equals($storedTno, $tno)) {
+            return 'tno_mismatch';
+        }
+
+        $storedSiteCd = trim((string) ($meta['site_cd'] ?? ''));
+        $expectedSiteCd = $storedSiteCd !== '' ? $storedSiteCd : trim($this->apiService->getSiteCd());
+        $receivedSiteCd = trim((string) ($validated['site_cd'] ?? ''));
+        if ($expectedSiteCd === '' || $receivedSiteCd === '' || ! hash_equals($expectedSiteCd, $receivedSiteCd)) {
+            return 'site_cd_mismatch';
+        }
+
+        $storedAccount = trim((string) ($payment->vbank_number ?? ''));
+        $receivedAccount = trim((string) ($validated['account'] ?? ''));
+        if ($storedAccount === '' || $receivedAccount === '' || ! hash_equals($storedAccount, $receivedAccount)) {
+            return 'account_mismatch';
+        }
+
+        $expectedAmount = $this->expectedVbankNotifyAmount($order);
+        if ($expectedAmount === null) {
+            return 'invalid_payment_currency';
+        }
+
+        if ($amount !== $expectedAmount) {
+            return 'amount_mismatch';
+        }
+
+        return null;
+    }
+
+    private function expectedVbankNotifyAmount(Order $order): ?int
+    {
+        $payment = $order->payment;
+        $paidAmount = (int) round((float) ($payment?->paid_amount_local ?? 0));
+
+        if (($payment?->isPaid() ?? false) && $paidAmount > 0) {
+            return $paidAmount;
+        }
+
+        return $this->resolveExpectedPaymentPriceOrNull($order, 'vbank_notify', [
+            'transaction_id' => $payment?->transaction_id,
+        ]);
+    }
+
+    /**
+     * 결제 당시 KCP 상점 설정을 payment_meta 에 남겨 이후 환불/통보 검증에 사용한다.
+     *
+     * site_key 같은 비밀값은 저장하지 않고, 공개 식별자인 site_cd 와 test/live 모드만 저장한다.
+     *
+     * @return array{site_cd: string, is_test_mode: bool}
+     */
+    private function currentCredentialMeta(string $siteCd = ''): array
+    {
+        return [
+            'site_cd' => $siteCd !== '' ? $siteCd : $this->apiService->getSiteCd(),
+            'is_test_mode' => $this->apiService->isTestMode(),
+        ];
+    }
+
+    private function resolveSuccessUrl(string $orderId): string
+    {
+        $settings = $this->pluginSettingsService->get(self::PLUGIN_IDENTIFIER) ?? [];
+        $urlTemplate = $settings['redirect_success_url'] ?? '/shop/orders/{orderId}/complete';
+
+        return $this->absolutize(str_replace('{orderId}', $orderId, $urlTemplate));
+    }
+
+    /**
+     * Approve 가 이미 발생한 후 후속 처리 실패 시 PG 측 cancel 을 시도.
+     *
+     * KCP CLI 승인이 완료되었으나 우리 서버에서 completePayment 가 실패한 경우
+     * 사용자 카드/계좌는 PG 측에서 승인 상태로 잔존 → 환불 불가 위험. 본 메서드는
+     * cancelPayment API 로 PG 잔존 승인을 즉시 해제해 사용자 보호를 확보한다.
+     *
+     * cancel 자체가 실패해도 사용자 응답 흐름은 막지 않음 — 로깅만 수행하고
+     * 운영자가 KCP 가맹점 관리자에서 수동 처리하도록 신호.
+     */
+    private function autoCancelIfApproved(
+        ?string $tno,
+        string $ordrIdxx,
+        int $cancelAmt,
+        string $reason,
+    ): void {
+        if ($tno === null || $tno === '' || $cancelAmt <= 0) {
+            return;
+        }
+
+        try {
+            $result = $this->apiService->cancelPayment(
+                $tno,
+                $ordrIdxx,
+                $cancelAmt,
+                'auto-cancel: '.$reason,
+            );
+
+            Log::warning('KCP: auto-cancel after post-approve failure', [
+                'tno' => $tno,
+                'ordr_idxx' => $ordrIdxx,
+                'amount' => $cancelAmt,
+                'reason' => $reason,
+                'res_cd' => $result['res_cd'] ?? null,
+                'res_msg' => $result['res_msg'] ?? null,
+            ]);
+        } catch (\Throwable $e) {
+            Log::error('KCP: auto-cancel FAILED — manual reconciliation required', [
+                'tno' => $tno,
+                'ordr_idxx' => $ordrIdxx,
+                'amount' => $cancelAmt,
+                'reason' => $reason,
+                'error' => $e->getMessage(),
+            ]);
+        }
+    }
+
+    private function resolveFailUrl(array $queryParams = []): string
+    {
+        $settings = $this->pluginSettingsService->get(self::PLUGIN_IDENTIFIER) ?? [];
+        $baseUrl = $this->absolutize($settings['redirect_fail_url'] ?? '/shop/checkout');
+
+        if (empty($queryParams)) {
+            return $baseUrl;
+        }
+
+        // error 코드와 message 가 모두 있으면 message 앞에 '[코드] ' 자동 prefix.
+        // 체크아웃 페이지에서 사용자가 오류 종류를 즉시 식별할 수 있도록 한다.
+        // 예: error=9502, message=연동 모듈 호출 오류 → message=[9502] 연동 모듈 호출 오류
+        if (! empty($queryParams['error']) && ! empty($queryParams['message'])) {
+            $queryParams['message'] = sprintf('[%s] %s', $queryParams['error'], $queryParams['message']);
+        }
+
+        $query = http_build_query(array_filter($queryParams));
+        $separator = str_contains($baseUrl, '?') ? '&' : '?';
+
+        return $baseUrl.$separator.$query;
+    }
+
+    /**
+     * 상대 경로면 APP_URL 기준으로 절대 URL 화.
+     *
+     * PG가 브라우저 POST 로 콜백을 보내는 동안 Apache 가 ProxyPreserveHost Off 등
+     * 으로 Host 헤더를 localhost 로 바꿔서 PHP 에 전달하는 경우, Laravel 의
+     * redirect('/path') 가 http://localhost/path 를 생성해버린다. config('app.url')
+     * (.env 의 APP_URL)을 명시적 base 로 사용하여 도메인을 보존한다.
+     */
+    private function absolutize(string $url): string
+    {
+        if (preg_match('#^https?://#i', $url) === 1) {
+            return $url;
+        }
+
+        $base = rtrim((string) config('app.url'), '/');
+        $path = $url === '' ? '/' : ($url[0] === '/' ? $url : '/'.$url);
+
+        return $base.$path;
+    }
+
+    private function isKrwOrder(Order $order): bool
+    {
+        return $this->orderCurrency($order) === 'KRW';
+    }
+
+    private function orderCurrency(Order $order): string
+    {
+        $currency = strtoupper(trim((string) ($order->currency ?? 'KRW')));
+
+        return $currency !== '' ? $currency : 'KRW';
+    }
+
+    /**
+     * KCP 모바일 게이트웨이는 EUC-KR(CP949) 인코딩으로 res_msg를 POST.
+     * 유효한 UTF-8이 아니면 CP949로 간주하고 변환한다.
+     */
+    private function decodeKcpMessage(string $msg): string
+    {
+        if ($msg === '' || mb_check_encoding($msg, 'UTF-8')) {
+            return $msg;
+        }
+
+        $converted = mb_convert_encoding($msg, 'UTF-8', 'CP949');
+
+        return $converted !== false ? $converted : $msg;
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/PaymentCloseReportController.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/PaymentCloseReportController.php
new file mode 100644
index 00000000..c7f7eb33
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/PaymentCloseReportController.php
@@ -0,0 +1,131 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Controllers;
+
+use App\Helpers\ResponseHelper;
+use Illuminate\Contracts\Cache\LockTimeoutException;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Support\Facades\RateLimiter;
+use Modules\Sirsoft\Ecommerce\Services\OrderProcessingService;
+use Plugins\Sirsoft\PayNhnkcp\Concerns\RecordsPaymentWindowClosure;
+use Plugins\Sirsoft\PayNhnkcp\Concerns\SerializesPaymentCallbacks;
+use Plugins\Sirsoft\PayNhnkcp\Http\Requests\PaymentCloseReportRequest;
+
+class PaymentCloseReportController
+{
+    use RecordsPaymentWindowClosure;
+    use SerializesPaymentCallbacks;
+
+    private const FAILURE_CODE = 'USER_CANCEL';
+
+    private const FAILURE_MESSAGE = '사용자가 NHN KCP 결제창을 닫았습니다.';
+
+    public function __construct(
+        private readonly OrderProcessingService $orderService,
+    ) {}
+
+    /**
+     * PC 결제창 닫힘 보고를 검증하고 결제 실패/취소 이력을 기록합니다.
+     *
+     * @param  PaymentCloseReportRequest  $request  결제창 닫힘 보고 요청
+     * @return JsonResponse 닫힘 보고 처리 결과
+     */
+    public function store(PaymentCloseReportRequest $request): JsonResponse
+    {
+        $validated = $request->validated();
+        $oid = $validated['oid'];
+        $price = (int) $validated['price'];
+
+        $rateLimitKey = $this->rateLimitKey($request, $oid);
+        if (RateLimiter::tooManyAttempts($rateLimitKey, 20)) {
+            return ResponseHelper::error('messages.failed', 429, [
+                'message' => ['Too many NHN KCP payment close reports. Please try again later.'],
+            ]);
+        }
+        RateLimiter::hit($rateLimitKey, 60);
+
+        $callbackLock = null;
+
+        try {
+            // PC close-report 는 PC authCallback 과 경쟁할 수 있으므로 같은 주문 락을 공유한다.
+            // authCallback 이 먼저 결제완료를 확정했다면 아래 최신 주문 조회에서 close-report 를 무시한다.
+            $callbackLock = $this->acquireOrderCallbackLock('authCallback', $oid);
+
+            $order = $this->orderService->findByOrderNumber($oid);
+            if (! $order) {
+                return ResponseHelper::error('messages.failed', 404, [
+                    'message' => ['Order not found.'],
+                ]);
+            }
+
+            if (! $order->order_status->isBeforePayment()) {
+                return ResponseHelper::success('messages.success', [
+                    'status' => 'ignored',
+                    'reason' => 'order_not_payable',
+                ]);
+            }
+
+            // 결제 성공 콜백과 결제창 닫힘 보고가 경쟁할 때, 카드 주문은 승인 직전까지
+            // order_status=PENDING_ORDER 라 위 가드를 통과한다. payment_status 가 이미 PAID 면 결제가
+            // 성공한 것이므로 실패 처리하지 않는다(failPayment 가 옵션을 취소로 덮어 주문/옵션 상태가
+            // 어긋나는 race 차단). failPayment 자체에도 동일 가드가 있으나 여기서 차단해 불필요한
+            // 결제취소 이력 기록까지 미연에 방지한다.
+            if ($order->payment?->isPaid()) {
+                return ResponseHelper::success('messages.success', [
+                    'status' => 'ignored',
+                    'reason' => 'payment_already_paid',
+                ]);
+            }
+
+            if (! $this->requestMatchesOrderBuyer($request, $order)) {
+                return ResponseHelper::error('messages.failed', 403, [
+                    'message' => ['Order buyer verification failed.'],
+                ]);
+            }
+
+            $expectedPrice = $this->resolveExpectedPaymentPriceOrNull($order, 'close_report', [
+                'oid' => $oid,
+                'received_price' => $price,
+                'ip' => $request->ip(),
+            ]);
+            if ($expectedPrice === null) {
+                return ResponseHelper::error('messages.failed', 422, [
+                    'message' => ['Payment currency is not chargeable.'],
+                ]);
+            }
+
+            if ($price !== $expectedPrice) {
+                return ResponseHelper::error('messages.failed', 422, [
+                    'message' => ['Payment amount does not match the order amount.'],
+                ]);
+            }
+
+            $closeReason = trim((string) ($validated['reason'] ?? ''));
+            $this->markPaymentWindowClosed(
+                $this->orderService,
+                $order,
+                self::FAILURE_CODE,
+                self::FAILURE_MESSAGE,
+                $closeReason !== '' ? $closeReason : self::FAILURE_MESSAGE,
+            );
+
+            return ResponseHelper::success('messages.success', [
+                'status' => 'recorded',
+            ]);
+        } catch (LockTimeoutException) {
+            return ResponseHelper::success('messages.success', [
+                'status' => 'ignored',
+                'reason' => 'callback_in_progress',
+            ]);
+        } finally {
+            $this->releaseOrderCallbackLock($callbackLock);
+        }
+    }
+
+    private function rateLimitKey(PaymentCloseReportRequest $request, string $oid): string
+    {
+        return 'sirsoft-pay_nhnkcp:payment-close-report:'.sha1($request->ip().'|'.$oid);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/PaymentRetryController.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/PaymentRetryController.php
new file mode 100644
index 00000000..a5e115d4
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/PaymentRetryController.php
@@ -0,0 +1,93 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Controllers;
+
+use App\Helpers\ResponseHelper;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Support\Facades\RateLimiter;
+use Modules\Sirsoft\Ecommerce\Services\OrderProcessingService;
+use Plugins\Sirsoft\PayNhnkcp\Concerns\RecordsPaymentWindowClosure;
+use Plugins\Sirsoft\PayNhnkcp\Http\Requests\PaymentRetryRequest;
+
+class PaymentRetryController
+{
+    use RecordsPaymentWindowClosure;
+
+    public function __construct(
+        private readonly OrderProcessingService $orderService,
+    ) {}
+
+    /**
+     * 같은 주문번호로 NHN KCP 결제를 다시 열기 전 실패 주문을 결제대기 상태로 복구합니다.
+     *
+     * @param PaymentRetryRequest $request 결제 재시도 준비 요청
+     * @return JsonResponse 재시도 준비 처리 결과
+     */
+    public function store(PaymentRetryRequest $request): JsonResponse
+    {
+        $validated = $request->validated();
+        $oid = $validated['oid'];
+        $price = (int) $validated['price'];
+
+        $rateLimitKey = $this->rateLimitKey($request, $oid);
+        if (RateLimiter::tooManyAttempts($rateLimitKey, 20)) {
+            return ResponseHelper::error('messages.failed', 429, [
+                'message' => ['Too many NHN KCP payment retry requests. Please try again later.'],
+            ]);
+        }
+        RateLimiter::hit($rateLimitKey, 60);
+
+        $order = $this->orderService->findByOrderNumber($oid);
+        if (! $order) {
+            return ResponseHelper::error('messages.failed', 404, [
+                'message' => ['Order not found.'],
+            ]);
+        }
+
+        if (! $this->requestMatchesOrderBuyer($request, $order)) {
+            return ResponseHelper::error('messages.failed', 403, [
+                'message' => ['Order buyer verification failed.'],
+            ]);
+        }
+
+        $expectedPrice = $this->resolveExpectedPaymentPriceOrNull($order, 'payment_retry', [
+            'oid' => $oid,
+            'received_price' => $price,
+            'ip' => $request->ip(),
+        ]);
+        if ($expectedPrice === null) {
+            return ResponseHelper::error('messages.failed', 422, [
+                'message' => ['Payment currency is not chargeable.'],
+            ]);
+        }
+
+        if ($price !== $expectedPrice) {
+            return ResponseHelper::error('messages.failed', 422, [
+                'message' => ['Payment amount does not match the order amount.'],
+            ]);
+        }
+
+        if ($order->order_status->isBeforePayment()) {
+            return ResponseHelper::success('messages.success', [
+                'status' => 'ready',
+            ]);
+        }
+
+        if ($this->restoreRetryableKcpOrder($order, $price)) {
+            return ResponseHelper::success('messages.success', [
+                'status' => 'restored',
+            ]);
+        }
+
+        return ResponseHelper::error('messages.failed', 409, [
+            'message' => ['Order is not retryable for NHN KCP payment.'],
+        ]);
+    }
+
+    private function rateLimitKey(PaymentRetryRequest $request, string $oid): string
+    {
+        return 'sirsoft-pay_nhnkcp:payment-retry:' . sha1($request->ip() . '|' . $oid);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/UserReceiptController.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/UserReceiptController.php
new file mode 100644
index 00000000..723e5336
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/UserReceiptController.php
@@ -0,0 +1,144 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Controllers;
+
+use App\Services\PluginSettingsService;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\DB;
+use Modules\Sirsoft\Ecommerce\Services\GuestOrderAuthService;
+use Plugins\Sirsoft\PayNhnkcp\Concerns\IssuesReceiptCookie;
+use Plugins\Sirsoft\PayNhnkcp\Concerns\ResolvesEasyPayDisplay;
+use Plugins\Sirsoft\PayNhnkcp\Services\NhnKcpApiService;
+
+class UserReceiptController
+{
+    use IssuesReceiptCookie;
+    use ResolvesEasyPayDisplay;
+
+    private const PLUGIN_IDENTIFIER = 'sirsoft-pay_nhnkcp';
+
+    // 카드/계좌이체 영수증 URL (cmd= 로 끝나므로 cmd 값을 바로 붙임)
+    private const BILL_URL_TEST = 'https://testadmin8.kcp.co.kr/assist/bill.BillActionNew.do?cmd=';
+
+    private const BILL_URL_LIVE = 'https://admin8.kcp.co.kr/assist/bill.BillActionNew.do?cmd=';
+
+    // 현금영수증 URL (term_id=PGNW 로 끝나므로 site_cd 값을 바로 붙임)
+    private const CASH_URL_TEST = 'https://testadmin8.kcp.co.kr/Modules/Service/Cash/Cash_Bill_Common_View.jsp?term_id=PGNW';
+
+    private const CASH_URL_LIVE = 'https://admin.kcp.co.kr/Modules/Service/Cash/Cash_Bill_Common_View.jsp?term_id=PGNW';
+
+    public function __construct(
+        private readonly PluginSettingsService $pluginSettingsService,
+        private readonly NhnKcpApiService $apiService,
+        private readonly GuestOrderAuthService $guestOrderAuthService,
+    ) {}
+
+    /**
+     * GET /api/plugins/sirsoft-pay_nhnkcp/user/orders/{orderNumber}/receipt
+     */
+    /**
+     * 사용자 마이페이지 KCP 영수증 정보 조회
+     *
+     * 결제 영수증 URL(신용카드)과 현금영수증 URL(현금/계좌이체)을 반환한다.
+     * receipt_url 이 비어있으면 transaction_id (tno) 로 KCP 영수증 URL 을 동적 생성.
+     *
+     * @param  Request  $request  회원 또는 비회원 영수증 요청
+     * @param  string  $orderNumber  주문번호
+     * @return JsonResponse receipt_url / cash_receipt_url 또는 404
+     */
+    public function show(Request $request, string $orderNumber): JsonResponse
+    {
+        $user = $request->user();
+        $query = DB::table('ecommerce_order_payments as p')
+            ->join('ecommerce_orders as o', 'o.id', '=', 'p.order_id')
+            ->where('o.order_number', $orderNumber)
+            ->where('p.pg_provider', 'nhnkcp')
+            ->whereNotNull('p.transaction_id');
+
+        if ($user) {
+            $query->where('o.user_id', $user->id);
+        } else {
+            $order = $this->guestOrderAuthService->verifyToken($request->header('X-Guest-Order-Token'), $orderNumber);
+
+            if ($order) {
+                $query->whereNull('o.user_id')->where('o.id', $order->id);
+            } elseif ($this->verifyReceiptCookie($request->cookie(self::RECEIPT_COOKIE_NAME), $orderNumber)) {
+                $query->whereNull('o.user_id')
+                    ->where('o.id', function ($sub) use ($orderNumber) {
+                        $sub->select('id')->from('ecommerce_orders')->where('order_number', $orderNumber);
+                    });
+            } else {
+                return response()->json(['error' => 'Not found'], 404);
+            }
+        }
+
+        $payment = $query
+            ->select([
+                'p.transaction_id',
+                'p.payment_meta',
+                'p.payment_method',
+                'p.embedded_pg_provider',
+                'p.payment_device',
+                'p.paid_amount_local',
+                'o.order_number',
+            ])
+            ->first();
+
+        if (! $payment || ! $payment->transaction_id) {
+            return response()->json(['error' => 'Not found'], 404);
+        }
+
+        $settings = $this->pluginSettingsService->get(self::PLUGIN_IDENTIFIER) ?? [];
+        $isTest = (bool) ($settings['is_test_mode'] ?? true);
+
+        $billBaseUrl = $isTest ? self::BILL_URL_TEST : self::BILL_URL_LIVE;
+        $cashBaseUrl = $isTest ? self::CASH_URL_TEST : self::CASH_URL_LIVE;
+
+        $tno = $payment->transaction_id;
+        $orderNo = $payment->order_number;
+        $tradeMony = (int) round((float) ($payment->paid_amount_local ?? 0));
+        $method = $payment->payment_method ?? '';
+        $display = $this->resolvePaymentDisplay($payment);
+
+        // 결제수단 분류 — KCP 영수증 cmd 는 결제수단(휴대폰결제 vs 그 외) 으로만 분기.
+        // 디바이스(PC/모바일) 와 무관 — 모바일 디바이스에서 카드결제해도 card_bill 로 가야 함.
+        // 그누보드5 settle_kcp_common.php 패턴과 일치.
+        $isPhonePayment = $method === 'phone';
+        $isCashMethod = in_array($method, ['bank', 'vbank'], true);
+
+        // 휴대폰결제 → mcash_bill, 그 외 (card / bank / vbank) → card_bill
+        $billCmd = $isPhonePayment ? 'mcash_bill' : 'card_bill';
+        $receiptUrl = $billBaseUrl . $billCmd
+            . '&tno=' . urlencode($tno)
+            . '&order_no=' . urlencode($orderNo)
+            . '&trade_mony=' . $tradeMony;
+
+        // 현금영수증 URL (계좌이체 · 가상계좌만 해당)
+        $cashReceiptUrl = null;
+        if ($isCashMethod) {
+            $meta = $this->decodePaymentMeta($payment->payment_meta ?? null);
+            $pgRaw = $meta['pg_raw_response'] ?? $meta;
+            $authNo = $pgRaw['app_no'] ?? $pgRaw['receipt_no'] ?? $tno;
+            $siteCd = $this->apiService->getSiteCd();
+
+            $cashReceiptUrl = $cashBaseUrl . $siteCd
+                . '&orderid=' . urlencode($orderNo)
+                . '&bill_yn=Y'
+                . '&authno=' . urlencode((string) $authNo);
+        }
+
+        return response()->json([
+            'receipt_url'      => $receiptUrl,
+            'cash_receipt_url' => $cashReceiptUrl,
+            'is_test_mode'     => $isTest,
+            'payment_method_label' => $display['payment_method_label'],
+            'payment_method_display_label' => $display['payment_method_display_label'],
+            'selected_payment_method' => $display['selected_payment_method'],
+            'embedded_pg_provider' => $display['embedded_pg_provider'],
+            'embedded_pg_provider_label' => $display['embedded_pg_provider_label'],
+        ]);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/UserVbankMockDepositController.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/UserVbankMockDepositController.php
new file mode 100644
index 00000000..47ba8b2a
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/UserVbankMockDepositController.php
@@ -0,0 +1,94 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Controllers;
+
+use App\Services\PluginSettingsService;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Modules\Sirsoft\Ecommerce\Services\OrderProcessingService;
+
+/**
+ * 테스트 모드 가상계좌 모의입금처리 정보 제공
+ *
+ * 조건: 테스트 모드 ON + 가상계좌 결제 + 입금대기 상태
+ */
+class UserVbankMockDepositController
+{
+    private const PLUGIN_IDENTIFIER = 'sirsoft-pay_nhnkcp';
+
+    private const KCP_TEST_MOCK_URL = 'https://testadmin.kcp.co.kr/Modules/Noti/TEST_Vcnt_Noti.jsp';
+
+    private const VBANK_NOTIFY_PATH = '/plugins/sirsoft-pay_nhnkcp/payment/vbank-notify';
+
+    public function __construct(
+        private readonly PluginSettingsService $pluginSettingsService,
+        private readonly OrderProcessingService $orderService,
+    ) {}
+
+    /**
+     * 테스트 모드 가상계좌 모의입금 처리 화면 데이터
+     *
+     * 테스트 환경에서 가상계좌 입금을 시뮬레이션할 수 있도록 폼 데이터 반환.
+     *
+     * @param  Request  $request  인증된 사용자 요청
+     * @param  string  $orderNumber  주문번호
+     * @return JsonResponse 가상계좌 폼 데이터 또는 404
+     */
+    public function show(Request $request, string $orderNumber): JsonResponse
+    {
+        $settings = $this->pluginSettingsService->get(self::PLUGIN_IDENTIFIER) ?? [];
+
+        if (! ($settings['is_test_mode'] ?? true)) {
+            return response()->json(['available' => false]);
+        }
+
+        $order = $this->orderService->findByOrderNumber($orderNumber);
+
+        if (! $order) {
+            return response()->json(['available' => false]);
+        }
+
+        $user = $request->user();
+
+        if (! $user) {
+            return response()->json(['available' => false]);
+        }
+
+        $isAdmin = method_exists($user, 'isAdmin') && $user->isAdmin();
+        $isOwner = (int) $order->user_id === (int) $user->id;
+
+        if (! $isAdmin && ! $isOwner) {
+            return response()->json(['available' => false]);
+        }
+
+        $payment = $order->payment;
+
+        if (! $payment) {
+            return response()->json(['available' => false]);
+        }
+
+        $isVbank = in_array($payment->payment_method?->value, ['vbank', 'virtual_account'], true);
+
+        // 가상계좌 계좌번호가 발급됐고 아직 입금완료가 아닌 상태
+        // (handleVbankIssued는 payment_status를 ready로 유지하므로 isPaid 역확인)
+        if (! $isVbank || ! $payment->vbank_number || $payment->isPaid()) {
+            return response()->json(['available' => false]);
+        }
+
+        // transaction_id(tno)가 없으면 payment_meta에서 fallback
+        $meta = $payment->payment_meta ?? [];
+        $tradeNo = $payment->transaction_id
+            ?? (is_array($meta) ? ($meta['tno'] ?? '') : '');
+
+        return response()->json([
+            'available'      => true,
+            'trade_no'       => $tradeNo,
+            'account_no'     => $payment->vbank_number,
+            'notify_url'     => url(self::VBANK_NOTIFY_PATH),
+            'mock_url'       => self::KCP_TEST_MOCK_URL,
+            'is_admin_view'  => $isAdmin,
+        ]);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Exceptions/NhnKcpApiException.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Exceptions/NhnKcpApiException.php
new file mode 100644
index 00000000..567668df
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Exceptions/NhnKcpApiException.php
@@ -0,0 +1,20 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Exceptions;
+
+use RuntimeException;
+
+/**
+ * NHN KCP PG API 호출 실패 예외
+ *
+ * KCP CLI / Standard Pay API 호출 단계에서 발생하는 모든 실패 (CLI 비정상 종료,
+ * 응답 res_cd 비정상, 응답 파싱 실패 등) 를 단일 도메인 예외로 통합한다.
+ *
+ * 베이스 \Exception / \RuntimeException 직접 throw 대신 본 클래스를 사용해
+ * 외부 소비자가 NHN KCP 도메인 오류만 선택적으로 catch 할 수 있도록 한다.
+ */
+class NhnKcpApiException extends RuntimeException
+{
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Http/Middleware/RestrictKcpIp.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Http/Middleware/RestrictKcpIp.php
new file mode 100644
index 00000000..64aa5a23
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Http/Middleware/RestrictKcpIp.php
@@ -0,0 +1,79 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Http\Middleware;
+
+use App\Services\PluginSettingsService;
+use Closure;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Log;
+use Symfony\Component\HttpFoundation\Response;
+
+/**
+ * KCP webhook 발신 IP 화이트리스트 가드 (그누보드5 settle_kcp_common.php 참고)
+ *
+ * 적용 라우트: vbank-notify / escrow-common-notify
+ * (결제창 콜백 authCallback 은 브라우저 POST 라 IP 검증 안 함)
+ *
+ * 테스트 모드 (is_test_mode=true): 우회 — 개발 환경에서 KCP testadmin 외부 발신 IP
+ *   에서 오는 모의입금 webhook 또는 PO 의 직접 테스트 시도를 허용 (그누보드5
+ *   settle_kcp_common.php 의 $default['de_card_test'] 분기와 동일 정책).
+ * 운영 모드 (is_test_mode=false): 화이트리스트 외 요청 403 차단.
+ */
+class RestrictKcpIp
+{
+    /**
+     * KCP 공식 발신 IP 목록 — 그누보드5 settle_kcp_common.php 의 화이트리스트와 동일
+     */
+    private const KCP_NOTIFY_IPS = [
+        '203.238.36.58',
+        '203.238.36.160',
+        '203.238.36.161',
+        '203.238.36.173',
+        '203.238.36.178',
+        // 판교 IDC IP (2019-04-03 추가)
+        '103.215.144.173',
+        '103.215.144.174',
+        '103.215.145.30',
+        '210.122.72.173',
+    ];
+
+    private const PLUGIN_IDENTIFIER = 'sirsoft-pay_nhnkcp';
+
+    public function __construct(
+        private readonly PluginSettingsService $pluginSettingsService,
+    ) {}
+
+    /**
+     * 요청 IP 검증 — 운영 모드 시 KCP 공식 발신 IP 외 모든 요청 403 차단
+     *
+     * @param  Request  $request  유입 요청
+     * @param  Closure  $next  다음 미들웨어
+     * @return Response 통과 시 다음 미들웨어 응답, 차단 시 403
+     */
+    public function handle(Request $request, Closure $next): Response
+    {
+        $settings = $this->pluginSettingsService->get(self::PLUGIN_IDENTIFIER) ?? [];
+
+        // 테스트 모드는 명시적으로 켜진 경우에만 우회한다.
+        // 설정 누락/오설정은 운영 모드처럼 fail-closed 로 처리해 webhook 무인증 노출을 막는다.
+        if (array_key_exists('is_test_mode', $settings) && (bool) $settings['is_test_mode']) {
+            return $next($request);
+        }
+
+        $clientIp = $request->ip() ?? '';
+
+        if (! in_array($clientIp, self::KCP_NOTIFY_IPS, true)) {
+            Log::warning('KCP: webhook from unauthorized IP — blocked', [
+                'ip' => $clientIp,
+                'url' => $request->fullUrl(),
+                'user_agent' => $request->userAgent(),
+            ]);
+
+            abort(403, 'Forbidden');
+        }
+
+        return $next($request);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Http/Requests/AuthCallbackRequest.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Http/Requests/AuthCallbackRequest.php
new file mode 100644
index 00000000..cdb5c6d0
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Http/Requests/AuthCallbackRequest.php
@@ -0,0 +1,78 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Http\Requests;
+
+use Illuminate\Contracts\Validation\Validator;
+use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Http\Exceptions\HttpResponseException;
+use Illuminate\Support\Facades\Log;
+
+/**
+ * KCP 결제 승인 콜백 요청 검증
+ *
+ * POST /plugins/sirsoft-pay_nhnkcp/payment/callback
+ *
+ * KCP가 브라우저를 통해 POST 방식으로 전달하는 파라미터입니다.
+ */
+class AuthCallbackRequest extends FormRequest
+{
+    private const PLUGIN_IDENTIFIER = 'sirsoft-pay_nhnkcp';
+
+    /**
+     * 콜백 요청 인가 — 외부 PG 호출이라 항상 true
+     *
+     * @return bool 항상 true
+     */
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * KCP 콜백 페이로드 검증 규칙
+     *
+     * @return array<string, mixed> Laravel 검증 규칙
+     */
+    public function rules(): array
+    {
+        return [
+            'res_cd' => ['present', 'nullable', 'string'],
+            'res_msg' => ['nullable', 'string'],
+            'enc_data' => ['nullable', 'string'],
+            'enc_info' => ['nullable', 'string'],
+            'tno' => ['nullable', 'string'],
+            'ordr_idxx' => ['required', 'string'],
+            'good_mny' => ['nullable', 'numeric', 'min:1'],
+            'use_pay_method' => ['nullable', 'string'],
+            'param_opt_1' => ['nullable', 'string', 'max:50'],
+            'nhnkcp_easy_pay_method' => ['nullable', 'string', 'max:50'],
+            // 모바일 SmartPhone Pay 가상계좌 콜백 (enc_data 없이 평문 전달)
+            // KCP가 보내는 변종 키 모두 허용 — handleVbankIssued 에서 우선순위로 처리
+            'bankname' => ['nullable', 'string'],
+            'bank_name' => ['nullable', 'string'],
+            'account' => ['nullable', 'string'],
+            'depositor' => ['nullable', 'string'],
+            'account_holder' => ['nullable', 'string'],
+            'va_date' => ['nullable', 'string'],
+            'vnbank_expire_date' => ['nullable', 'string'],
+        ];
+    }
+
+    protected function failedValidation(Validator $validator): void
+    {
+        Log::warning('KCP: authCallback validation failed', [
+            'errors' => $validator->errors()->toArray(),
+            'input' => array_keys($this->all()),
+        ]);
+
+        $settings = plugin_settings(self::PLUGIN_IDENTIFIER);
+        $baseUrl = $settings['redirect_fail_url'] ?? '/shop/checkout';
+        $separator = str_contains($baseUrl, '?') ? '&' : '?';
+
+        throw new HttpResponseException(
+            redirect($baseUrl . $separator . http_build_query(['error' => 'invalid_params']))
+        );
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Http/Requests/EscrowCommonNotifyRequest.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Http/Requests/EscrowCommonNotifyRequest.php
new file mode 100644
index 00000000..58773367
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Http/Requests/EscrowCommonNotifyRequest.php
@@ -0,0 +1,50 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Http\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+/**
+ * KCP 에스크로 공통 통보 요청 검증
+ *
+ * KCP가 구매확인(TX02) 또는 배송시작(TX03) 이벤트 발생 시
+ * 등록된 공통통보 URL로 POST 요청을 보냅니다.
+ */
+class EscrowCommonNotifyRequest extends FormRequest
+{
+    /**
+     * FormRequest 인가 — 외부 PG 웹훅이라 항상 true
+     *
+     * @return bool 항상 true
+     */
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * KCP 에스크로 통보 페이로드 검증 규칙 (KCP 공식 webhook 명세)
+     *
+     * KCP 결제창 콜백과 달리 통보 webhook 은 order_no 키를 사용한다
+     * (그누보드5 settle_kcp_common.php 와 동일). ordr_idxx 사용 시 422 차단.
+     *
+     * @return array<string, mixed> Laravel 검증 규칙
+     */
+    public function rules(): array
+    {
+        return [
+            'site_cd'   => ['nullable', 'string'],
+            'tno'       => ['nullable', 'string'],
+            'order_no'  => ['required', 'string'],
+            'tx_cd'     => ['required', 'string'],
+            'tx_tm'     => ['nullable', 'string'],
+            'cl_status' => ['nullable', 'string'],
+            'st_cd'     => ['nullable', 'string'],
+            'can_msg'   => ['nullable', 'string'],
+            'waybill_no'   => ['nullable', 'string'],
+            'waybill_corp' => ['nullable', 'string'],
+        ];
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Http/Requests/PaymentCloseReportRequest.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Http/Requests/PaymentCloseReportRequest.php
new file mode 100644
index 00000000..5dd5859e
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Http/Requests/PaymentCloseReportRequest.php
@@ -0,0 +1,37 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Http\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class PaymentCloseReportRequest extends FormRequest
+{
+    /**
+     * 결제창 닫힘 보고 요청을 허용합니다.
+     *
+     * @return bool 요청 허용 여부
+     */
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * 결제창 닫힘 보고 요청 검증 규칙을 반환합니다.
+     *
+     * @return array<string, array<int, string>> 필드별 검증 규칙
+     */
+    public function rules(): array
+    {
+        return [
+            'oid'            => ['required', 'string', 'max:40'],
+            'price'          => ['required', 'integer', 'min:1'],
+            'buyer_email'    => ['nullable', 'string', 'max:255'],
+            'buyer_phone'    => ['nullable', 'string', 'max:30'],
+            'payment_method' => ['nullable', 'string', 'max:50'],
+            'reason'         => ['nullable', 'string', 'max:160'],
+        ];
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Http/Requests/PaymentRetryRequest.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Http/Requests/PaymentRetryRequest.php
new file mode 100644
index 00000000..a86a9c0f
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Http/Requests/PaymentRetryRequest.php
@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Http\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class PaymentRetryRequest extends FormRequest
+{
+    /**
+     * 결제 재시도 준비 요청을 허용합니다.
+     *
+     * @return bool 요청 허용 여부
+     */
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * 결제 재시도 준비 요청 검증 규칙을 반환합니다.
+     *
+     * @return array<string, array<int, string>> 필드별 검증 규칙
+     */
+    public function rules(): array
+    {
+        return [
+            'oid'            => ['required', 'string', 'max:40'],
+            'price'          => ['required', 'integer', 'min:1'],
+            'buyer_email'    => ['nullable', 'string', 'max:255'],
+            'buyer_phone'    => ['nullable', 'string', 'max:30'],
+            'payment_method' => ['nullable', 'string', 'max:50'],
+        ];
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Http/Requests/VbankNotifyRequest.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Http/Requests/VbankNotifyRequest.php
new file mode 100644
index 00000000..2534383e
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Http/Requests/VbankNotifyRequest.php
@@ -0,0 +1,62 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Http\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+/**
+ * KCP 가상계좌 입금 통보 요청 검증
+ *
+ * POST /plugins/sirsoft-pay_nhnkcp/payment/vbank-notify
+ *
+ * KCP 서버가 직접 호출하는 입금 확인 웹훅입니다.
+ */
+class VbankNotifyRequest extends FormRequest
+{
+    /**
+     * FormRequest 인가 — 외부 PG 웹훅이라 항상 true
+     *
+     * @return bool 항상 true
+     */
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * KCP 공통통보 페이로드 검증 규칙 (KCP 공식 webhook 명세)
+     *
+     * 키 체계는 KCP 결제창 콜백(authCallback) 과 다르므로 주의 — 결제창은 ordr_idxx/good_mny/res_cd
+     * 를 쓰지만, 통보 webhook 은 order_no/ipgm_mnyx/op_cd 를 쓴다.
+     *
+     * tx_cd 분기 (그누보드5 settle_kcp_common.php 참고):
+     *   TX00 = 가상계좌 입금 통보 (본 endpoint 가 처리)
+     *   TX01 = 가상계좌 환불 통보
+     *   TX02 = 구매확인/구매취소 통보
+     *   TX03 = 배송시작 통보
+     *
+     * 본 endpoint 는 TX00 만 처리하지만 KCP 가 단일 URL 로 모든 tx_cd 를 보낼 수 있으므로
+     * tx_cd 자체는 nullable 로 받고 컨트롤러에서 분기.
+     *
+     * @return array<string, mixed> Laravel 검증 규칙
+     */
+    public function rules(): array
+    {
+        return [
+            'site_cd' => ['nullable', 'string'],
+            'tno' => ['required', 'string'],
+            'order_no' => ['required', 'string'],
+            'tx_cd' => ['nullable', 'string'],
+            'tx_tm' => ['nullable', 'string'],
+            'ipgm_name' => ['nullable', 'string'],
+            'remitter' => ['nullable', 'string'],
+            'ipgm_mnyx' => ['nullable', 'numeric'],
+            'bank_code' => ['nullable', 'string'],
+            'account' => ['nullable', 'string'],
+            'op_cd' => ['nullable', 'string'],
+            'noti_id' => ['nullable', 'string'],
+        ];
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Listeners/AdjustEcommercePaymentMethodsLayoutListener.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Listeners/AdjustEcommercePaymentMethodsLayoutListener.php
new file mode 100644
index 00000000..ca173498
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Listeners/AdjustEcommercePaymentMethodsLayoutListener.php
@@ -0,0 +1,332 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Listeners;
+
+use App\Contracts\Extension\HookListenerInterface;
+
+/**
+ * 이커머스 결제수단 설정 화면에서 NHN KCP 간편결제를 PG 선택 불필요 항목으로 표시한다.
+ */
+class AdjustEcommercePaymentMethodsLayoutListener implements HookListenerInterface
+{
+    private const TARGET_LAYOUT = 'admin_ecommerce_settings';
+
+    private const TEST_MODE_DATA_SOURCE_ID = 'nhnkcp_test_mode_status';
+
+    private const TEST_MODE_NOTICE_ID = 'payment_test_mode_order_settings_notice';
+
+    private const TEST_MODE_NOTICE_ROW_ID = 'nhnkcp_test_mode_order_settings_notice';
+
+    private const TEST_MODE_CONDITION = 'nhnkcp_test_mode_status.data?.is_test_mode === true';
+
+    private const CORE_NO_PG_METHODS = ['point', 'deposit', 'free', 'dbank'];
+
+    private const NHNKCP_NO_PG_METHODS = [
+        'nhnkcp_payco',
+        'nhnkcp_naverpay',
+        'nhnkcp_naverpay_point',
+        'nhnkcp_kakaopay',
+        'nhnkcp_applepay',
+    ];
+
+    /**
+     * @return array<string, array<string, mixed>>
+     */
+    public static function getSubscribedHooks(): array
+    {
+        return [
+            'core.layout_extension.after_apply' => [
+                'method' => 'markEasyPayMethodsAsPgNotRequired',
+                'type' => 'filter',
+                'priority' => 30,
+            ],
+        ];
+    }
+
+    /**
+     * @param mixed ...$args
+     */
+    public function handle(...$args): void {}
+
+    /**
+     * @param array<string, mixed> $layout
+     * @param int $templateId
+     * @return array<string, mixed>
+     */
+    public function markEasyPayMethodsAsPgNotRequired(array $layout, int $templateId): array
+    {
+        if (($layout['layout_name'] ?? '') !== self::TARGET_LAYOUT) {
+            return $layout;
+        }
+
+        $layout = $this->replaceNoPgMethodExpressions($layout);
+
+        return $this->ensureTestModeWarning($layout);
+    }
+
+    /**
+     * @param array<string, mixed> $node
+     * @return array<string, mixed>
+     */
+    private function replaceNoPgMethodExpressions(array $node): array
+    {
+        foreach ($node as $key => $value) {
+            if (is_array($value)) {
+                $node[$key] = $this->replaceNoPgMethodExpressions($value);
+                continue;
+            }
+
+            if (is_string($value)) {
+                $node[$key] = $this->addNhnKcpMethodsToNoPgArray($value);
+            }
+        }
+
+        return $node;
+    }
+
+    private function addNhnKcpMethodsToNoPgArray(string $expression): string
+    {
+        return preg_replace_callback(
+            '/\[((?:\'[^\']+\'\s*,?\s*)+)\]\.includes\(\$method\.id\)/',
+            function (array $matches): string {
+                preg_match_all("/'([^']+)'/", $matches[1], $tokenMatches);
+                $ids = $tokenMatches[1] ?? [];
+
+                foreach (self::CORE_NO_PG_METHODS as $coreId) {
+                    if (! in_array($coreId, $ids, true)) {
+                        return $matches[0];
+                    }
+                }
+
+                foreach (self::NHNKCP_NO_PG_METHODS as $methodId) {
+                    if (! in_array($methodId, $ids, true)) {
+                        $ids[] = $methodId;
+                    }
+                }
+
+                return "['" . implode("','", $ids) . "'].includes(\$method.id)";
+            },
+            $expression
+        ) ?? $expression;
+    }
+
+    /**
+     * @param array<string, mixed> $layout
+     * @return array<string, mixed>
+     */
+    private function ensureTestModeWarning(array $layout): array
+    {
+        $layout = $this->ensureTestModeDataSource($layout);
+
+        return $this->insertTestModeNotice($layout);
+    }
+
+    /**
+     * @param array<string, mixed> $layout
+     * @return array<string, mixed>
+     */
+    private function ensureTestModeDataSource(array $layout): array
+    {
+        $dataSources = is_array($layout['data_sources'] ?? null) ? $layout['data_sources'] : [];
+
+        foreach ($dataSources as $source) {
+            if (is_array($source) && ($source['id'] ?? null) === self::TEST_MODE_DATA_SOURCE_ID) {
+                $layout['data_sources'] = $dataSources;
+
+                return $layout;
+            }
+        }
+
+        $dataSources[] = [
+            'id' => self::TEST_MODE_DATA_SOURCE_ID,
+            'label_key' => '$t:sirsoft-pay_nhnkcp.editor.data_source.nhnkcp_test_mode_status',
+            'type' => 'api',
+            'endpoint' => '/api/plugins/sirsoft-pay_nhnkcp/admin/settings/test-mode-status',
+            'method' => 'GET',
+            'auto_fetch' => true,
+            'auth_required' => true,
+        ];
+
+        $layout['data_sources'] = $dataSources;
+
+        return $layout;
+    }
+
+    /**
+     * @param array<string, mixed> $node
+     * @return array<string, mixed>
+     */
+    private function insertTestModeNotice(array $node): array
+    {
+        if (($node['id'] ?? null) === 'tab_content_order_settings' && is_array($node['children'] ?? null)) {
+            $noticeIndex = $this->findChildIndexById($node['children'], self::TEST_MODE_NOTICE_ID);
+
+            if ($noticeIndex === null) {
+                $insertAt = $this->findChildIndexById($node['children'], 'payment_methods_card') ?? count($node['children']);
+                array_splice($node['children'], $insertAt, 0, [$this->testModeNoticeContainerNode()]);
+                $noticeIndex = $insertAt;
+            }
+
+            if (is_array($node['children'][$noticeIndex] ?? null)) {
+                $notice = $node['children'][$noticeIndex];
+                $notice['if'] = $this->mergeTestModeCondition((string) ($notice['if'] ?? ''));
+                $node['children'][$noticeIndex] = $this->appendTestModeNoticeRow($notice);
+            }
+
+            return $node;
+        }
+
+        foreach ($node as $key => $value) {
+            if (is_array($value)) {
+                $node[$key] = $this->insertTestModeNotice($value);
+            }
+        }
+
+        return $node;
+    }
+
+    /**
+     * @param array<int, mixed> $children
+     */
+    private function findChildIndexById(array $children, string $id): ?int
+    {
+        foreach ($children as $index => $child) {
+            if (is_array($child) && ($child['id'] ?? null) === $id) {
+                return $index;
+            }
+        }
+
+        return null;
+    }
+
+    /**
+     * @param array<int, mixed> $children
+     */
+    private function hasChildWithId(array $children, string $id): bool
+    {
+        return $this->findChildIndexById($children, $id) !== null;
+    }
+
+    private function mergeTestModeCondition(string $condition): string
+    {
+        if (str_contains($condition, self::TEST_MODE_CONDITION)) {
+            return $condition !== '' ? $condition : '{{' . self::TEST_MODE_CONDITION . '}}';
+        }
+
+        $inner = trim($condition);
+        if (str_starts_with($inner, '{{') && str_ends_with($inner, '}}')) {
+            $inner = trim(substr($inner, 2, -2));
+        }
+
+        if ($inner === '') {
+            return '{{' . self::TEST_MODE_CONDITION . '}}';
+        }
+
+        return '{{' . $inner . ' || ' . self::TEST_MODE_CONDITION . '}}';
+    }
+
+    /**
+     * @param array<string, mixed> $notice
+     * @return array<string, mixed>
+     */
+    private function appendTestModeNoticeRow(array $notice): array
+    {
+        $children = is_array($notice['children'] ?? null) ? $notice['children'] : [];
+
+        if (! $this->hasChildWithId($children, self::TEST_MODE_NOTICE_ROW_ID)) {
+            $children[] = $this->testModeNoticeRowNode();
+        }
+
+        $notice['children'] = $children;
+
+        return $notice;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    private function testModeNoticeContainerNode(): array
+    {
+        return [
+            'id' => self::TEST_MODE_NOTICE_ID,
+            'type' => 'basic',
+            'name' => 'Div',
+            'if' => '{{' . self::TEST_MODE_CONDITION . '}}',
+            'props' => [
+                'className' => 'mb-4 space-y-3 rounded-lg border border-orange-200 bg-orange-50 p-4 dark:border-orange-700 dark:bg-orange-900/20',
+            ],
+            'children' => [
+                $this->testModeNoticeRowNode(),
+            ],
+        ];
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    private function testModeNoticeRowNode(): array
+    {
+        return [
+            'id' => self::TEST_MODE_NOTICE_ROW_ID,
+            'type' => 'basic',
+            'name' => 'Div',
+            'if' => '{{' . self::TEST_MODE_CONDITION . '}}',
+            'props' => [
+                'className' => 'flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between',
+            ],
+            'children' => [
+                [
+                    'type' => 'basic',
+                    'name' => 'Div',
+                    'props' => [
+                        'className' => 'min-w-0',
+                    ],
+                    'children' => [
+                        [
+                            'type' => 'basic',
+                            'name' => 'Div',
+                            'props' => [
+                                'className' => 'text-sm font-medium text-orange-950 dark:text-orange-50',
+                            ],
+                            'text' => '$t:sirsoft-pay_nhnkcp.admin.test_mode_settings_warning_plugin',
+                        ],
+                        [
+                            'type' => 'basic',
+                            'name' => 'P',
+                            'props' => [
+                                'className' => 'mt-0.5 text-sm leading-6 text-orange-800 dark:text-orange-200',
+                            ],
+                            'text' => '$t:sirsoft-pay_nhnkcp.admin.test_mode_settings_warning_body',
+                        ],
+                    ],
+                ],
+                [
+                    'type' => 'basic',
+                    'name' => 'Button',
+                    'props' => [
+                        'type' => 'button',
+                        'className' => 'btn btn-outline btn-sm w-full flex-shrink-0 border-orange-300 text-orange-900 hover:bg-orange-100 sm:w-auto dark:border-orange-600 dark:text-orange-100 dark:hover:bg-orange-900/40',
+                    ],
+                    'actions' => [
+                        [
+                            'type' => 'click',
+                            'handler' => 'navigate',
+                            'params' => [
+                                'path' => '/admin/plugins/sirsoft-pay_nhnkcp/settings',
+                            ],
+                        ],
+                    ],
+                    'children' => [
+                                [
+                                    'type' => 'basic',
+                                    'name' => 'Span',
+                                    'text' => '$t:sirsoft-pay_nhnkcp.admin.test_mode_settings_warning_action',
+                                ],
+                    ],
+                ],
+            ],
+        ];
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Listeners/CancelActivityLogListener.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Listeners/CancelActivityLogListener.php
new file mode 100644
index 00000000..28774285
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Listeners/CancelActivityLogListener.php
@@ -0,0 +1,91 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Listeners;
+
+use App\ActivityLog\Traits\ResolvesActivityLogType;
+use App\Contracts\Extension\HookListenerInterface;
+use Modules\Sirsoft\Ecommerce\Models\Order;
+use Modules\Sirsoft\Ecommerce\Models\OrderPayment;
+
+/**
+ * NHN KCP PG 결제 취소 활동 로그 리스너.
+ *
+ * 코어의 sirsoft-ecommerce.payment.refund 필터 훅을 priority 20 으로 구독해
+ * PaymentRefundListener (priority 10) 가 KCP cancel API 호출에 성공한 직후 실행.
+ *
+ * 코어가 이미 기록하는 order.cancel (주문 단위 취소 의도) 와 별도로,
+ * "PG 가 실제로 취소를 확인했다" 는 별도 이벤트를 활동 로그에 보존한다.
+ */
+class CancelActivityLogListener implements HookListenerInterface
+{
+    use ResolvesActivityLogType;
+
+    private const PG_PROVIDER_ID = 'nhnkcp';
+
+    /**
+     * 구독할 훅 매핑 반환
+     *
+     * @return array<string, array<string, mixed>> 훅 구독 설정
+     */
+    public static function getSubscribedHooks(): array
+    {
+        return [
+            'sirsoft-ecommerce.payment.refund' => [
+                'method' => 'logCancelConfirmed',
+                'type' => 'filter',
+                'priority' => 20,
+            ],
+        ];
+    }
+
+    /**
+     * 기본 핸들러 (미사용)
+     *
+     * @param  mixed  ...$args  훅 인수
+     */
+    public function handle(...$args): void {}
+
+    /**
+     * PG 가 결제 취소를 확인한 직후 활동 로그를 기록한다.
+     *
+     * @param  array  $result  이전 필터 누적 결과
+     * @param  Order  $order  대상 주문
+     * @param  OrderPayment  $payment  대상 결제 정보
+     * @param  float  $refundAmount  환불 금액
+     * @param  string|null  $reason  취소 사유
+     * @return array 결과 통과 (mutation 없음)
+     */
+    public function logCancelConfirmed(
+        array $result,
+        Order $order,
+        OrderPayment $payment,
+        float $refundAmount,
+        ?string $reason = null,
+    ): array {
+        if ($payment->pg_provider !== self::PG_PROVIDER_ID) {
+            return $result;
+        }
+        if (empty($result['success'])) {
+            return $result;
+        }
+
+        $this->logActivity('payment.cancel', [
+            'loggable' => $order,
+            'description_key' => 'sirsoft-pay_nhnkcp::activity_log.description.payment_cancel',
+            'description_params' => [
+                'order_number' => $order->order_number,
+                'refund_amount' => number_format((int) $refundAmount),
+            ],
+            'properties' => [
+                'tno' => $payment->transaction_id,
+                'cancel_tno' => $result['transaction_id'] ?? null,
+                'refund_amount' => $refundAmount,
+                'reason' => $reason,
+            ],
+        ]);
+
+        return $result;
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Listeners/EnsureAdminOrderDetailPaymentQueryLayoutListener.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Listeners/EnsureAdminOrderDetailPaymentQueryLayoutListener.php
new file mode 100644
index 00000000..74a9243a
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Listeners/EnsureAdminOrderDetailPaymentQueryLayoutListener.php
@@ -0,0 +1,338 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Listeners;
+
+use App\Contracts\Extension\HookListenerInterface;
+
+class EnsureAdminOrderDetailPaymentQueryLayoutListener implements HookListenerInterface
+{
+    private const TARGET_LAYOUT = 'admin_ecommerce_order_detail';
+
+    private const NOTICE_ID = 'nhnkcp_test_mode_notice';
+
+    private const HEADER_TARGET_IDS = [
+        'sticky_header_container',
+        'page_header_section',
+        'page_header',
+        'order_detail_wrapper',
+    ];
+
+    private const BODY_TARGET_IDS = [
+        'tab_content_area',
+        'order_detail_wrapper',
+    ];
+
+    /**
+     * @return array<string, array<string, mixed>>
+     */
+    public static function getSubscribedHooks(): array
+    {
+        return [
+            'core.layout_extension.after_apply' => [
+                'method' => 'ensurePaymentQueryLayout',
+                'type' => 'filter',
+                'priority' => 66,
+            ],
+        ];
+    }
+
+    /**
+     * @param mixed ...$args
+     */
+    public function handle(...$args): void {}
+
+    /**
+     * @param array<string, mixed> $layout
+     * @param int $templateId
+     * @return array<string, mixed>
+     */
+    public function ensurePaymentQueryLayout(array $layout, int $templateId): array
+    {
+        if (($layout['layout_name'] ?? '') !== self::TARGET_LAYOUT) {
+            return $layout;
+        }
+
+        $extension = $this->orderPaymentQueryExtension();
+
+        $layout = $this->ensureDataSources($layout, $extension['data_sources'] ?? []);
+        $this->ensureInjections($layout, $extension['injections'] ?? []);
+
+        return $layout;
+    }
+
+    /**
+     * @param array<string, mixed> $layout
+     * @param array<int, mixed> $extensionDataSources
+     * @return array<string, mixed>
+     */
+    private function ensureDataSources(array $layout, array $extensionDataSources): array
+    {
+        $dataSources = isset($layout['data_sources']) && is_array($layout['data_sources'])
+            ? $layout['data_sources']
+            : [];
+        $existingIds = [];
+
+        foreach ($dataSources as $dataSource) {
+            if (is_array($dataSource) && is_string($dataSource['id'] ?? null)) {
+                $existingIds[$dataSource['id']] = true;
+            }
+        }
+
+        foreach ($extensionDataSources as $dataSource) {
+            if (! is_array($dataSource) || ! is_string($dataSource['id'] ?? null)) {
+                continue;
+            }
+
+            if (isset($existingIds[$dataSource['id']])) {
+                continue;
+            }
+
+            $dataSources[] = $dataSource;
+            $existingIds[$dataSource['id']] = true;
+        }
+
+        $layout['data_sources'] = $dataSources;
+
+        return $layout;
+    }
+
+    /**
+     * @param array<string, mixed> $layout
+     * @param array<int, mixed> $injections
+     */
+    private function ensureInjections(array &$layout, array $injections): void
+    {
+        foreach ($injections as $injection) {
+            if (! is_array($injection) || ! isset($injection['components']) || ! is_array($injection['components'])) {
+                continue;
+            }
+
+            $position = is_string($injection['position'] ?? null) ? $injection['position'] : 'append_child';
+            $components = $this->normalizeComponents($injection['components']);
+            $targetIds = $this->isHeaderInjection($injection) ? self::HEADER_TARGET_IDS : self::BODY_TARGET_IDS;
+
+            if ($this->appendComponentsToFirstAvailableTarget($layout, $targetIds, $components, $position)) {
+                continue;
+            }
+
+            if (! isset($layout['slots']['content']) || ! is_array($layout['slots']['content'])) {
+                $layout['slots']['content'] = [];
+            }
+
+            $this->mergeMissingComponents($layout['slots']['content'], $components, $position);
+        }
+    }
+
+    /**
+     * @param array<string, mixed> $injection
+     */
+    private function isHeaderInjection(array $injection): bool
+    {
+        return in_array($injection['target_id'] ?? null, self::HEADER_TARGET_IDS, true);
+    }
+
+    /**
+     * @param array<string, mixed> $node
+     * @param array<int, string> $targetIds
+     * @param array<int, mixed> $components
+     */
+    private function appendComponentsToFirstAvailableTarget(
+        array &$node,
+        array $targetIds,
+        array $components,
+        string $position
+    ): bool {
+        foreach ($targetIds as $targetId) {
+            if ($this->appendComponentsToTargetId($node, $targetId, $components, $position)) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+
+    /**
+     * @param array<string, mixed> $node
+     * @param array<int, mixed> $components
+     */
+    private function appendComponentsToTargetId(
+        array &$node,
+        string $targetId,
+        array $components,
+        string $position
+    ): bool {
+        if (($node['id'] ?? null) === $targetId) {
+            if (! isset($node['children']) || ! is_array($node['children'])) {
+                $node['children'] = [];
+            }
+
+            $this->mergeMissingComponents($node['children'], $components, $position);
+
+            return true;
+        }
+
+        foreach ($node as &$value) {
+            if (is_array($value) && $this->appendComponentsToTargetId($value, $targetId, $components, $position)) {
+                return true;
+            }
+        }
+        unset($value);
+
+        return false;
+    }
+
+    /**
+     * @param array<int, mixed> $target
+     * @param array<int, mixed> $components
+     */
+    private function mergeMissingComponents(array &$target, array $components, string $position): void
+    {
+        $missing = [];
+
+        foreach ($components as $component) {
+            if (! is_array($component) || $this->containsComponent($target, $component)) {
+                continue;
+            }
+
+            $missing[] = $component;
+        }
+
+        if ($missing === []) {
+            return;
+        }
+
+        if (str_starts_with($position, 'prepend')) {
+            $target = array_merge($missing, $target);
+
+            return;
+        }
+
+        array_push($target, ...$missing);
+    }
+
+    /**
+     * @param array<int, mixed> $components
+     * @return array<int, mixed>
+     */
+    private function normalizeComponents(array $components): array
+    {
+        return array_map(function ($component) {
+            if (
+                is_array($component)
+                && ! isset($component['id'])
+                && $this->containsString($component, 'sirsoft-pay_nhnkcp.admin.test_mode_order_notice')
+            ) {
+                $component['id'] = self::NOTICE_ID;
+            }
+
+            return $component;
+        }, $components);
+    }
+
+    /**
+     * @param array<string|int, mixed> $node
+     * @param array<string, mixed> $component
+     */
+    private function containsComponent(array $node, array $component): bool
+    {
+        if (is_string($component['id'] ?? null) && $this->containsNodeId($node, $component['id'])) {
+            return true;
+        }
+
+        foreach ($this->componentSignatures($component) as $signature) {
+            if ($this->containsString($node, $signature)) {
+                return true;
+            }
+        }
+
+        $targetJson = json_encode($node, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
+        $componentJson = json_encode($component, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
+
+        return is_string($targetJson)
+            && is_string($componentJson)
+            && $componentJson !== ''
+            && str_contains($targetJson, $componentJson);
+    }
+
+    /**
+     * @param array<string, mixed> $component
+     * @return array<int, string>
+     */
+    private function componentSignatures(array $component): array
+    {
+        $json = json_encode($component, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
+
+        if (! is_string($json)) {
+            return [];
+        }
+
+        $signatures = [];
+
+        foreach ([
+            'sirsoft-pay_nhnkcp.admin.test_mode_order_notice',
+            'sirsoft-pay_nhnkcp.admin.order_info_title',
+            'sirsoft-pay_nhnkcp.admin.escrow_delivery_title',
+        ] as $candidate) {
+            if (str_contains($json, $candidate)) {
+                $signatures[] = $candidate;
+            }
+        }
+
+        return $signatures;
+    }
+
+    /**
+     * @param array<string|int, mixed> $node
+     */
+    private function containsNodeId(array $node, string $id): bool
+    {
+        if (($node['id'] ?? null) === $id) {
+            return true;
+        }
+
+        foreach ($node as $value) {
+            if (is_array($value) && $this->containsNodeId($value, $id)) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+
+    /**
+     * @param array<string|int, mixed> $node
+     */
+    private function containsString(array $node, string $needle): bool
+    {
+        foreach ($node as $value) {
+            if (is_array($value) && $this->containsString($value, $needle)) {
+                return true;
+            }
+
+            if (is_string($value) && str_contains($value, $needle)) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    private function orderPaymentQueryExtension(): array
+    {
+        $path = dirname(__DIR__, 2).'/resources/extensions/admin_order_payment_query.json';
+        $contents = is_file($path) ? file_get_contents($path) : false;
+
+        if (! is_string($contents)) {
+            return [];
+        }
+
+        $decoded = json_decode($contents, true);
+
+        return is_array($decoded) ? $decoded : [];
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Listeners/EnsureAdminOrderListTestBadgeLayoutListener.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Listeners/EnsureAdminOrderListTestBadgeLayoutListener.php
new file mode 100644
index 00000000..0f982095
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Listeners/EnsureAdminOrderListTestBadgeLayoutListener.php
@@ -0,0 +1,243 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Listeners;
+
+use App\Contracts\Extension\HookListenerInterface;
+
+class EnsureAdminOrderListTestBadgeLayoutListener implements HookListenerInterface
+{
+    private const TARGET_LAYOUT = 'admin_ecommerce_order_list';
+
+    private const ORDER_GRID_ID = 'order_datagrid';
+
+    private const DATA_SOURCE_ID = 'nhnkcp_test_map';
+
+    private const EASY_PAY_DISPLAY_DATA_SOURCE_ID = 'nhnkcp_easy_pay_display_map';
+
+    private const BADGE_CONDITION = 'nhnkcp_test_map.data?.[row.order_number] === true';
+
+    private const EASY_PAY_DISPLAY_EXPRESSION = 'nhnkcp_easy_pay_display_map.data?.[row.order_number]?.payment_method_display_label ?? row.payment?.payment_method_label';
+
+    /**
+     * @return array<string, array<string, mixed>>
+     */
+    public static function getSubscribedHooks(): array
+    {
+        return [
+            'core.layout_extension.after_apply' => [
+                'method' => 'ensureTestBadgeLayout',
+                'type' => 'filter',
+                'priority' => 60,
+            ],
+        ];
+    }
+
+    /**
+     * @param mixed ...$args
+     */
+    public function handle(...$args): void {}
+
+    /**
+     * @param array<string, mixed> $layout
+     * @param int $templateId
+     * @return array<string, mixed>
+     */
+    public function ensureTestBadgeLayout(array $layout, int $templateId): array
+    {
+        if (($layout['layout_name'] ?? '') !== self::TARGET_LAYOUT) {
+            return $layout;
+        }
+
+        $layout = $this->ensureDataSource($layout);
+
+        if (isset($layout['components']) && is_array($layout['components'])) {
+            $this->ensureOrderGridBadge($layout['components']);
+        }
+
+        return $layout;
+    }
+
+    /**
+     * @param array<string, mixed> $layout
+     * @return array<string, mixed>
+     */
+    private function ensureDataSource(array $layout): array
+    {
+        $dataSources = isset($layout['data_sources']) && is_array($layout['data_sources'])
+            ? $layout['data_sources']
+            : [];
+
+        $existingIds = [];
+        foreach ($dataSources as $dataSource) {
+            if (is_array($dataSource) && is_string($dataSource['id'] ?? null)) {
+                $existingIds[$dataSource['id']] = true;
+            }
+        }
+
+        if (! isset($existingIds[self::DATA_SOURCE_ID])) {
+            $dataSources[] = [
+                'id' => self::DATA_SOURCE_ID,
+                'label_key' => '$t:sirsoft-pay_nhnkcp.editor.data_source.nhnkcp_test_map',
+                'type' => 'api',
+                'endpoint' => '/api/plugins/sirsoft-pay_nhnkcp/admin/orders/test-mode-map',
+                'method' => 'GET',
+                'auto_fetch' => true,
+                'auth_required' => true,
+                'loading_strategy' => 'progressive',
+            ];
+        }
+
+        if (! isset($existingIds[self::EASY_PAY_DISPLAY_DATA_SOURCE_ID])) {
+            $dataSources[] = [
+                'id' => self::EASY_PAY_DISPLAY_DATA_SOURCE_ID,
+                'label_key' => '$t:sirsoft-pay_nhnkcp.editor.data_source.nhnkcp_easy_pay_display_map',
+                'type' => 'api',
+                'endpoint' => '/api/plugins/sirsoft-pay_nhnkcp/admin/orders/easy-pay-display-map',
+                'method' => 'GET',
+                'auto_fetch' => true,
+                'auth_required' => true,
+                'loading_strategy' => 'progressive',
+            ];
+        }
+
+        $layout['data_sources'] = $dataSources;
+
+        return $layout;
+    }
+
+    /**
+     * @param array<int, mixed> $components
+     */
+    private function ensureOrderGridBadge(array &$components): bool
+    {
+        foreach ($components as &$component) {
+            if (! is_array($component)) {
+                continue;
+            }
+
+            if (($component['id'] ?? '') === self::ORDER_GRID_ID) {
+                $this->ensurePaymentMethodColumnBadge($component);
+
+                return true;
+            }
+
+            if (isset($component['children']) && is_array($component['children'])) {
+                if ($this->ensureOrderGridBadge($component['children'])) {
+                    return true;
+                }
+            }
+        }
+        unset($component);
+
+        return false;
+    }
+
+    /**
+     * @param array<string, mixed> $grid
+     */
+    private function ensurePaymentMethodColumnBadge(array &$grid): void
+    {
+        if (! isset($grid['props']['columns']) || ! is_array($grid['props']['columns'])) {
+            return;
+        }
+
+        foreach ($grid['props']['columns'] as &$column) {
+            if (! is_array($column) || ($column['field'] ?? null) !== 'payment_method') {
+                continue;
+            }
+
+            $this->ensurePaymentMethodDisplayExpression($column);
+            $this->appendBadgeToColumn($column);
+
+            return;
+        }
+        unset($column);
+    }
+
+    /**
+     * @param array<string|int, mixed> $node
+     */
+    private function ensurePaymentMethodDisplayExpression(array &$node): bool
+    {
+        if (($node['text'] ?? null) === '{{row.payment?.payment_method_label}}') {
+            $node['text'] = '{{'.self::EASY_PAY_DISPLAY_EXPRESSION.'}}';
+
+            return true;
+        }
+
+        foreach ($node as &$value) {
+            if (is_array($value) && $this->ensurePaymentMethodDisplayExpression($value)) {
+                return true;
+            }
+        }
+        unset($value);
+
+        return false;
+    }
+
+    /**
+     * @param array<string, mixed> $column
+     */
+    private function appendBadgeToColumn(array &$column): void
+    {
+        if ($this->containsNhnKcpBadgeCondition($column)) {
+            return;
+        }
+
+        if (! isset($column['cellChildren']) || ! is_array($column['cellChildren'])) {
+            $column['cellChildren'] = [];
+        }
+
+        foreach ($column['cellChildren'] as &$cellChild) {
+            if (
+                is_array($cellChild)
+                && ($cellChild['name'] ?? null) === 'Div'
+                && isset($cellChild['children'])
+                && is_array($cellChild['children'])
+            ) {
+                $cellChild['children'][] = $this->badgeComponent();
+
+                return;
+            }
+        }
+        unset($cellChild);
+
+        $column['cellChildren'][] = $this->badgeComponent();
+    }
+
+    /**
+     * @param array<string, mixed> $node
+     */
+    private function containsNhnKcpBadgeCondition(array $node): bool
+    {
+        foreach ($node as $value) {
+            if (is_array($value) && $this->containsNhnKcpBadgeCondition($value)) {
+                return true;
+            }
+
+            if (is_string($value) && str_contains($value, self::BADGE_CONDITION)) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    private function badgeComponent(): array
+    {
+        return [
+            'type' => 'basic',
+            'name' => 'Span',
+            'if' => '{{'.self::BADGE_CONDITION.'}}',
+            'props' => [
+                'className' => 'text-xs font-medium text-orange-500 dark:text-orange-400 leading-tight',
+            ],
+            'text' => '($t:sirsoft-pay_nhnkcp.admin.test_mode_badge)',
+        ];
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Listeners/PaymentRefundListener.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Listeners/PaymentRefundListener.php
new file mode 100644
index 00000000..743371a5
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Listeners/PaymentRefundListener.php
@@ -0,0 +1,166 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Listeners;
+
+use App\Contracts\Extension\HookListenerInterface;
+use Illuminate\Support\Facades\Cache;
+use Illuminate\Support\Facades\Log;
+use Modules\Sirsoft\Ecommerce\Models\Order;
+use Modules\Sirsoft\Ecommerce\Models\OrderPayment;
+use Plugins\Sirsoft\PayNhnkcp\Services\NhnKcpApiService;
+
+class PaymentRefundListener implements HookListenerInterface
+{
+    private const PG_PROVIDER_ID = 'nhnkcp';
+
+    /**
+     * 구독할 훅 매핑 반환
+     *
+     * @return array<string, array<string, mixed>> 훅 구독 설정
+     */
+    public static function getSubscribedHooks(): array
+    {
+        return [
+            'sirsoft-ecommerce.payment.refund' => [
+                'method' => 'processRefund',
+                'type' => 'filter',
+                'priority' => 10,
+            ],
+        ];
+    }
+
+    /**
+     * 기본 핸들러 (미사용 — 개별 메서드에서 처리)
+     *
+     * @param  mixed  ...$args  훅 인수
+     */
+    public function handle(...$args): void {}
+
+    /**
+     * 환불 처리 훅 핸들러 (sirsoft-ecommerce.payment.refund 필터)
+     *
+     * KCP 결제 건 (pg_provider=nhnkcp) 만 처리. before_cancel/after_cancel
+     * 액션 훅을 발행하여 외부 확장 지점 제공.
+     *
+     * @param  array  $result  이전 필터 누적 결과
+     * @param  Order  $order  대상 주문
+     * @param  OrderPayment  $payment  대상 결제 정보
+     * @param  float  $refundAmount  환불 금액
+     * @param  string|null  $reason  환불 사유 (없으면 기본 메시지)
+     * @return array success / error_code / error_message / transaction_id
+     */
+    public function processRefund(
+        array $result,
+        Order $order,
+        OrderPayment $payment,
+        float $refundAmount,
+        ?string $reason = null,
+    ): array {
+        if ($payment->pg_provider !== self::PG_PROVIDER_ID) {
+            return $result;
+        }
+
+        $tno = $payment->transaction_id;
+        if (! $tno) {
+            return [
+                'success' => false,
+                'error_code' => 'MISSING_TNO',
+                'error_message' => __('sirsoft-pay_nhnkcp::messages.refund.missing_tid'),
+                'transaction_id' => null,
+            ];
+        }
+
+        try {
+            $lock = Cache::lock('nhnkcp:refund:' . $payment->id, 30);
+            if (! $lock->get()) {
+                return [
+                    'success' => false,
+                    'error_code' => 'REFUND_IN_PROGRESS',
+                    'error_message' => __('sirsoft-pay_nhnkcp::messages.refund.in_progress'),
+                    'transaction_id' => null,
+                ];
+            }
+
+            try {
+                $apiService = app(NhnKcpApiService::class);
+                $this->restorePaymentCredentials($apiService, $payment);
+
+                $cancelMsg = $reason ?? __('sirsoft-pay_nhnkcp::messages.refund.default_reason');
+                $cancelAmt = (int) $refundAmount;
+                $ordrIdxx = (string) $order->order_number;
+
+                // $refundAmount 는 코어가 결제 통화(order_currency)로 환산해 전달한 실환불액이다.
+                // 누적 취소액도 결제 통화 기준(mc_cancelled_amount[order_currency])으로 맞춰야
+                // base≠결제통화 주문에서 부분취소 판정·총액이 어긋나 PG 실환불이 잘못 전송되지 않는다.
+                $paidAmount = (int) $payment->paid_amount_local;
+                $cumulativeCancelled = (int) round((float) $this->cancelledLocalAmount($payment));
+                $previousCancelled = max(0, $cumulativeCancelled - $cancelAmt);
+                $totalAmt = max($cancelAmt, $paidAmount - $previousCancelled);
+                $isPartial = $previousCancelled > 0 || $cancelAmt < $paidAmount;
+                $response = $apiService->cancelPayment($tno, $ordrIdxx, $cancelAmt, $cancelMsg, $isPartial, $totalAmt);
+
+                Log::info('KCP: refund success', [
+                    'order_id' => $order->id,
+                    'tno' => $tno,
+                    'cancel_amt' => $cancelAmt,
+                ]);
+
+                return [
+                    'success' => true,
+                    'error_code' => null,
+                    'error_message' => null,
+                    'transaction_id' => $response['tno'] ?? $tno,
+                ];
+            } finally {
+                $lock->release();
+            }
+        } catch (\Exception $e) {
+            Log::error('KCP: refund failed', [
+                'order_id' => $order->id,
+                'tno' => $tno,
+                'cancel_amt' => (int) $refundAmount,
+                'error' => $e->getMessage(),
+            ]);
+
+            return [
+                'success' => false,
+                'error_code' => 'PG_API_ERROR',
+                'error_message' => $e->getMessage(),
+                'transaction_id' => null,
+            ];
+        }
+    }
+
+    private function restorePaymentCredentials(NhnKcpApiService $apiService, OrderPayment $payment): void
+    {
+        $meta = $payment->payment_meta ?? [];
+        if (! array_key_exists('is_test_mode', $meta) || empty($meta['site_cd'])) {
+            return;
+        }
+
+        $apiService->useStoredCredentials((bool) $meta['is_test_mode'], (string) $meta['site_cd']);
+    }
+
+    /**
+     * 결제 통화(order_currency) 기준 누적 취소액을 반환합니다.
+     *
+     * 코어가 결제 통화로 누적한 mc_cancelled_amount[order_currency] 를 우선 사용하고,
+     * 없으면(레거시 결제) base 누적 cancelled_amount 로 폴백합니다.
+     *
+     * @param  OrderPayment  $payment  결제 레코드
+     * @return float 결제 통화 기준 누적 취소액
+     */
+    private function cancelledLocalAmount(OrderPayment $payment): float
+    {
+        $currency = $payment->currency;
+        $mc = $payment->mc_cancelled_amount ?? [];
+
+        if ($currency !== null && isset($mc[$currency])) {
+            return (float) $mc[$currency];
+        }
+
+        return (float) $payment->cancelled_amount;
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Listeners/RegisterEasyPayMethodsListener.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Listeners/RegisterEasyPayMethodsListener.php
new file mode 100644
index 00000000..3942c377
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Listeners/RegisterEasyPayMethodsListener.php
@@ -0,0 +1,155 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Listeners;
+
+use App\Contracts\Extension\HookListenerInterface;
+
+/**
+ * NHN KCP 간편결제를 이커머스 결제수단 목록에 등록한다.
+ *
+ * 각 결제수단 ID는 프론트 requestPaymentHandler 의 KCP_EASY_PAY_DIRECT 매핑과 일치한다.
+ */
+class RegisterEasyPayMethodsListener implements HookListenerInterface
+{
+    private const PLUGIN_IDENTIFIER = 'sirsoft-pay_nhnkcp';
+
+    private const EASY_PAY_METHODS = [
+        [
+            'id' => 'nhnkcp_payco',
+            'name_key' => 'sirsoft-pay_nhnkcp::payment_methods.payco.name',
+            'description_key' => 'sirsoft-pay_nhnkcp::payment_methods.payco.description',
+            'icon' => 'wallet',
+        ],
+        [
+            'id' => 'nhnkcp_naverpay',
+            'name_key' => 'sirsoft-pay_nhnkcp::payment_methods.naverpay.name',
+            'description_key' => 'sirsoft-pay_nhnkcp::payment_methods.naverpay.description',
+            'icon' => 'wallet',
+        ],
+        [
+            'id' => 'nhnkcp_naverpay_point',
+            'name_key' => 'sirsoft-pay_nhnkcp::payment_methods.naverpay_point.name',
+            'description_key' => 'sirsoft-pay_nhnkcp::payment_methods.naverpay_point.description',
+            'icon' => 'wallet-cards',
+        ],
+        [
+            'id' => 'nhnkcp_kakaopay',
+            'name_key' => 'sirsoft-pay_nhnkcp::payment_methods.kakaopay.name',
+            'description_key' => 'sirsoft-pay_nhnkcp::payment_methods.kakaopay.description',
+            'icon' => 'message-circle',
+        ],
+        [
+            'id' => 'nhnkcp_applepay',
+            'name_key' => 'sirsoft-pay_nhnkcp::payment_methods.applepay.name',
+            'description_key' => 'sirsoft-pay_nhnkcp::payment_methods.applepay.description',
+            'icon' => 'smartphone',
+        ],
+    ];
+
+    /**
+     * @return array<string, array<string, mixed>>
+     */
+    public static function getSubscribedHooks(): array
+    {
+        return [
+            'sirsoft-ecommerce.settings.filter_available_payment_methods' => [
+                'method' => 'injectEasyPayMethods',
+                'type' => 'filter',
+                'priority' => 30,
+            ],
+        ];
+    }
+
+    /**
+     * @param mixed ...$args
+     */
+    public function handle(...$args): void {}
+
+    /**
+     * @param array<int, array<string, mixed>> $methods
+     * @return array<int, array<string, mixed>>
+     */
+    public function injectEasyPayMethods(array $methods): array
+    {
+        $easyPayMethods = array_map(
+            fn (array $method): array => $this->buildEntry(
+                id: $method['id'],
+                nameKey: $method['name_key'],
+                descriptionKey: $method['description_key'],
+                icon: $method['icon'],
+            ),
+            self::EASY_PAY_METHODS
+        );
+
+        $easyPayIds = array_column($easyPayMethods, 'id');
+        $methods = array_values(array_filter(
+            $methods,
+            fn (array $method): bool => ! in_array($method['id'] ?? null, $easyPayIds, true)
+        ));
+
+        $insertAfter = $this->resolveInsertionIndex($methods);
+        if ($insertAfter === null) {
+            return array_merge($methods, $easyPayMethods);
+        }
+
+        return array_merge(
+            array_slice($methods, 0, $insertAfter + 1),
+            $easyPayMethods,
+            array_slice($methods, $insertAfter + 1),
+        );
+    }
+
+    /**
+     * @param array<int, array<string, mixed>> $methods
+     */
+    private function resolveInsertionIndex(array $methods): ?int
+    {
+        $phoneIndex = null;
+        foreach ($methods as $index => $method) {
+            if (($method['id'] ?? null) === 'phone') {
+                $phoneIndex = $index;
+                break;
+            }
+        }
+
+        if ($phoneIndex === null) {
+            return null;
+        }
+
+        $insertAfter = $phoneIndex;
+        for ($index = $phoneIndex + 1, $count = count($methods); $index < $count; $index++) {
+            $id = (string) ($methods[$index]['id'] ?? '');
+            if (! str_starts_with($id, 'kginicis_') && ! str_starts_with($id, 'nhnkcp_')) {
+                break;
+            }
+            $insertAfter = $index;
+        }
+
+        return $insertAfter;
+    }
+
+    private function buildEntry(string $id, string $nameKey, string $descriptionKey, string $icon): array
+    {
+        return [
+            'id' => $id,
+            'name' => [
+                'ko' => __($nameKey, [], 'ko'),
+                'en' => __($nameKey, [], 'en'),
+            ],
+            'description' => [
+                'ko' => __($descriptionKey, [], 'ko'),
+                'en' => __($descriptionKey, [], 'en'),
+            ],
+            'icon' => $icon,
+            'source' => 'plugin:' . self::PLUGIN_IDENTIFIER,
+            'defaults' => [
+                'pg_provider' => null,
+                'is_active' => false,
+                'min_order_amount' => 0,
+                'stock_deduction_timing' => 'payment_complete',
+            ],
+        ];
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Listeners/RegisterPgProviderListener.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Listeners/RegisterPgProviderListener.php
new file mode 100644
index 00000000..8bf31369
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Listeners/RegisterPgProviderListener.php
@@ -0,0 +1,150 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Listeners;
+
+use App\Contracts\Extension\HookListenerInterface;
+
+class RegisterPgProviderListener implements HookListenerInterface
+{
+    private const PLUGIN_IDENTIFIER = 'sirsoft-pay_nhnkcp';
+
+    private const LIVE_SITE_CD_PREFIX = 'SR';
+
+    /**
+     * 구독할 훅 매핑 반환
+     *
+     * @return array<string, array<string, mixed>> 훅 구독 설정
+     */
+    public static function getSubscribedHooks(): array
+    {
+        return [
+            'sirsoft-ecommerce.payment.registered_pg_providers' => [
+                'method' => 'registerProvider',
+                'type' => 'filter',
+                'priority' => 10,
+            ],
+            'sirsoft-ecommerce.payment.get_client_config' => [
+                'method' => 'getClientConfig',
+                'type' => 'filter',
+                'priority' => 10,
+            ],
+        ];
+    }
+
+    /**
+     * 기본 핸들러 (미사용 — 개별 메서드에서 처리)
+     *
+     * @param  mixed  ...$args  훅 인수
+     */
+    public function handle(...$args): void {}
+
+    /**
+     * PG 제공자 목록에 NHN KCP 등록
+     *
+     * @param  array  $providers  기존 PG 제공자 목록
+     * @return array NHN KCP 가 추가된 PG 제공자 목록
+     */
+    public function registerProvider(array $providers): array
+    {
+        $providers[] = [
+            'id' => 'nhnkcp',
+            'name_key' => 'sirsoft-pay_nhnkcp::provider.name',
+            'name' => localized_label(nameKey: 'sirsoft-pay_nhnkcp::provider.name'),
+            'icon' => 'credit-card',
+            'supported_methods' => ['card', 'bank_transfer', 'virtual_account', 'mobile'],
+        ];
+
+        return $providers;
+    }
+
+    /**
+     * PG 클라이언트 설정 제공 (프론트엔드 SDK용)
+     *
+     * site_cd, SDK URL, 콜백 URL 을 반환. 테스트 모드는 testpay.kcp.co.kr
+     * 라이브 모드는 pay.kcp.co.kr 사용.
+     *
+     * @param  array  $config  기존 설정
+     * @param  string  $provider  PG 제공자 ID
+     * @return array 클라이언트 설정 또는 입력 그대로 (다른 PG 인 경우)
+     */
+    public function getClientConfig(array $config, string $provider): array
+    {
+        if ($provider !== 'nhnkcp') {
+            return $config;
+        }
+
+        $settings = $this->getPluginSettings();
+        $isTest = $settings['is_test_mode'] ?? true;
+
+        $liveSuffix = $settings['live_site_cd'] ?? '';
+        $liveSiteCd = str_starts_with($liveSuffix, self::LIVE_SITE_CD_PREFIX)
+            ? $liveSuffix
+            : self::LIVE_SITE_CD_PREFIX . $liveSuffix;
+
+        $siteCd = $isTest
+            ? ($settings['test_site_cd'] ?? 'T0000')
+            : $liveSiteCd;
+
+        $sdkUrl = $isTest
+            ? 'https://testpay.kcp.co.kr/plugin/payplus_web.jsp'
+            : 'https://pay.kcp.co.kr/plugin/payplus_web.jsp';
+
+        $easyPayKeys = [
+            'PAYCO'         => 'easy_pay_payco',
+            'NAVERPAY'      => 'easy_pay_naverpay',
+            'NAVERPAY POINT' => 'easy_pay_naverpay_point',
+            'KAKAOPAY'      => 'easy_pay_kakaopay',
+            'APPLEPAY'      => 'easy_pay_applepay',
+        ];
+        $enabledEasyPays = array_values(array_keys(array_filter($easyPayKeys, fn ($key) => (bool) ($settings[$key] ?? false))));
+
+        // "타 PG와 사용가능함"이 꺼져 있고 현재 기본 PG가 nhnkcp가 아니면 간편결제 숨김
+        $allowWithOtherPg = (bool) ($settings['easy_pay_allow_with_other_pg'] ?? false);
+        if (! $allowWithOtherPg && ! $this->isNhnKcpDefaultPg()) {
+            $enabledEasyPays = [];
+        }
+
+        // 간편결제 테스트 site_cd: 레거시 코드와 동일하게 S6729 사용
+        // T0000(표준 테스트)은 간편결제 미지원 → [3101] 오류
+        $easyPayTestSiteCd = $settings['easy_pay_test_site_cd'] ?? 'S6729';
+        $easyPayClientId = $isTest ? $easyPayTestSiteCd : $liveSiteCd;
+
+        $useEscrow = (bool) ($settings['use_escrow'] ?? false);
+        $escrowTestSiteCd = trim((string) ($settings['escrow_test_site_cd'] ?? ''));
+        $escrowClientId = $isTest && $escrowTestSiteCd !== '' ? $escrowTestSiteCd : $siteCd;
+
+        return array_merge($config, [
+            'client_id' => $siteCd,
+            'easy_pay_client_id' => $easyPayClientId,
+            'sdk_url' => $sdkUrl,
+            'callback_urls' => [
+                'callback' => '/plugins/sirsoft-pay_nhnkcp/payment/callback',
+                'close_report' => '/plugins/sirsoft-pay_nhnkcp/payment/close-report',
+            ],
+            'enabled_easy_pays' => $enabledEasyPays,
+            'vbank_expire_days' => (int) ($settings['vbank_expire_days'] ?? 3),
+            'use_escrow' => $useEscrow,
+            'escrow_client_id' => $escrowClientId,
+        ]);
+    }
+
+    private function isNhnKcpDefaultPg(): bool
+    {
+        $path = storage_path('app/modules/sirsoft-ecommerce/settings/order_settings.json');
+
+        if (! file_exists($path)) {
+            return false;
+        }
+
+        $data = json_decode(file_get_contents($path), true);
+
+        return ($data['default_pg_provider'] ?? '') === 'nhnkcp';
+    }
+
+    private function getPluginSettings(): array
+    {
+        return plugin_settings(self::PLUGIN_IDENTIFIER);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Listeners/RestoreLayoutExtensionsAfterUpdateListener.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Listeners/RestoreLayoutExtensionsAfterUpdateListener.php
new file mode 100644
index 00000000..abd86a9c
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Listeners/RestoreLayoutExtensionsAfterUpdateListener.php
@@ -0,0 +1,154 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Listeners;
+
+use App\Contracts\Extension\HookListenerInterface;
+use App\Contracts\Repositories\LayoutRepositoryInterface;
+use App\Contracts\Repositories\TemplateRepositoryInterface;
+use App\Enums\LayoutExtensionType;
+use App\Enums\LayoutSourceType;
+use App\Services\LayoutExtensionService;
+use Illuminate\Support\Facades\Log;
+
+class RestoreLayoutExtensionsAfterUpdateListener implements HookListenerInterface
+{
+    private const PLUGIN_IDENTIFIER = 'sirsoft-pay_nhnkcp';
+
+    /**
+     * @return array<string, array<string, mixed>>
+     */
+    public static function getSubscribedHooks(): array
+    {
+        return [
+            'core.plugins.updated' => [
+                'method' => 'restoreCurrentExtensionsAfterUpdate',
+                'type' => 'action',
+                'priority' => 20,
+                'sync' => true,
+            ],
+        ];
+    }
+
+    /**
+     * @param mixed ...$args
+     */
+    public function handle(...$args): void {}
+
+    /**
+     * @param string $identifier
+     */
+    public function restoreCurrentExtensionsAfterUpdate(string $identifier): void
+    {
+        if ($identifier !== self::PLUGIN_IDENTIFIER) {
+            return;
+        }
+
+        $service = app(LayoutExtensionService::class);
+
+        foreach ($this->currentOverlayExtensions() as $extensionData) {
+            $targetLayout = $extensionData['target_layout'] ?? null;
+            if (! is_string($targetLayout) || $targetLayout === '') {
+                continue;
+            }
+
+            foreach ($this->templateIdsForLogicalLayout($targetLayout) as $templateId) {
+                $result = $service->registerExtension(
+                    $extensionData,
+                    LayoutSourceType::Plugin,
+                    self::PLUGIN_IDENTIFIER,
+                    $templateId,
+                    true
+                );
+
+                if ($result !== null) {
+                    $service->invalidateExtensionCache($templateId, $targetLayout, LayoutExtensionType::Overlay);
+                }
+            }
+        }
+    }
+
+    /**
+     * @return array<int, array<string, mixed>>
+     */
+    private function currentOverlayExtensions(): array
+    {
+        $paths = glob($this->extensionsDirectory().'/*.json') ?: [];
+        $extensions = [];
+
+        foreach ($paths as $path) {
+            $extensionData = $this->readExtensionJson($path);
+            if ($extensionData === null || ! isset($extensionData['target_layout'])) {
+                continue;
+            }
+
+            $extensions[] = $extensionData;
+        }
+
+        return $extensions;
+    }
+
+    private function extensionsDirectory(): string
+    {
+        return dirname(__DIR__, 2).'/resources/extensions';
+    }
+
+    /**
+     * @return array<string, mixed>|null
+     */
+    private function readExtensionJson(string $path): ?array
+    {
+        $content = file_get_contents($path);
+        if ($content === false) {
+            Log::warning('NHN KCP layout extension file could not be read.', [
+                'path' => $path,
+            ]);
+
+            return null;
+        }
+
+        $data = json_decode($content, true);
+        if (json_last_error() !== JSON_ERROR_NONE || ! is_array($data)) {
+            Log::warning('NHN KCP layout extension JSON parse failed.', [
+                'path' => $path,
+                'error' => json_last_error_msg(),
+            ]);
+
+            return null;
+        }
+
+        return $data;
+    }
+
+    /**
+     * @return array<int, int>
+     */
+    private function templateIdsForLogicalLayout(string $layoutName): array
+    {
+        $templateRepository = app(TemplateRepositoryInterface::class);
+        $layoutRepository = app(LayoutRepositoryInterface::class);
+        $templateIds = [];
+
+        foreach ($templateRepository->getAll() as $template) {
+            $layoutNames = $layoutRepository->getLayoutNamesByTemplateId((int) $template->id);
+
+            foreach ($layoutNames as $storedName) {
+                if (! is_string($storedName) || ! $this->matchesLogicalLayout($storedName, $layoutName)) {
+                    continue;
+                }
+
+                $templateIds[(int) $template->id] = (int) $template->id;
+
+                break;
+            }
+        }
+
+        return array_values($templateIds);
+    }
+
+    private function matchesLogicalLayout(string $storedName, string $layoutName): bool
+    {
+        return $storedName === $layoutName || str_ends_with($storedName, '.'.$layoutName);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Providers/PayNhnkcpServiceProvider.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Providers/PayNhnkcpServiceProvider.php
new file mode 100644
index 00000000..d3729e65
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Providers/PayNhnkcpServiceProvider.php
@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Providers;
+
+use App\Extension\BasePluginServiceProvider;
+use Illuminate\Cookie\Middleware\EncryptCookies;
+
+class PayNhnkcpServiceProvider extends BasePluginServiceProvider
+{
+    protected string $pluginIdentifier = 'sirsoft-pay_nhnkcp';
+
+    public function boot(): void
+    {
+        parent::boot();
+
+        // PG callback 이 발급하는 영수증 쿠키는 HMAC 으로 자체 무결성 보장하므로
+        // EncryptCookies 대상에서 제외한다. 암호화 대상이면 callback 응답에서
+        // 직접 발급한 평문 쿠키가 다음 API 요청에서 복호화 실패로 폐기될 수 있다.
+        // 값 동기화: IssuesReceiptCookie::RECEIPT_COOKIE_NAME 과 동일해야 함.
+        EncryptCookies::except(['nhnkcp_receipt_token']);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Services/KcpSoapService.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Services/KcpSoapService.php
new file mode 100644
index 00000000..b6f0b177
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Services/KcpSoapService.php
@@ -0,0 +1,196 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Services;
+
+use App\Services\PluginSettingsService;
+use Illuminate\Support\Facades\Log;
+use Plugins\Sirsoft\PayNhnkcp\Exceptions\NhnKcpApiException;
+use SoapClient;
+use SoapFault;
+
+/**
+ * KCP SmartPhone Pay SOAP 서비스
+ *
+ * 모바일 결제창 호출 전 서버에서 approval_key 와 pay_url 을 획득합니다.
+ * PC Standard Pay(payplus_web.jsp iframe)와 달리 모바일은 2-step 방식:
+ *   1) SOAP → approval_key + pay_url
+ *   2) 브라우저 form submit → pay_url (페이지 전환)
+ */
+class KcpSoapService
+{
+    private const PLUGIN_IDENTIFIER = 'sirsoft-pay_nhnkcp';
+
+    private const LIVE_SITE_CD_PREFIX = 'SR';
+
+    private const WSDL_TEST = 'KCPPaymentService.wsdl';
+
+    private const WSDL_LIVE = 'real_KCPPaymentService.wsdl';
+
+    private bool $isTest;
+
+    private string $siteCd;
+
+    private string $escrowSiteCd;
+
+    private string $easyPaySiteCd;
+
+    private string $binDir;
+
+    public function __construct(PluginSettingsService $pluginSettingsService)
+    {
+        $settings = $pluginSettingsService->get(self::PLUGIN_IDENTIFIER) ?? [];
+        $this->isTest = $settings['is_test_mode'] ?? true;
+
+        $liveSuffix = $settings['live_site_cd'] ?? '';
+        $liveSiteCd = str_starts_with($liveSuffix, self::LIVE_SITE_CD_PREFIX)
+            ? $liveSuffix
+            : self::LIVE_SITE_CD_PREFIX . $liveSuffix;
+
+        $this->siteCd = $this->isTest
+            ? ($settings['test_site_cd'] ?? 'T0000')
+            : $liveSiteCd;
+
+        if ($this->isTest) {
+            $escrowTestSiteCd = trim((string) ($settings['escrow_test_site_cd'] ?? ''));
+            $this->escrowSiteCd = $escrowTestSiteCd !== '' ? $escrowTestSiteCd : $this->siteCd;
+        } else {
+            $this->escrowSiteCd = $liveSiteCd;
+        }
+
+        $easyPayTestSiteCd = $settings['easy_pay_test_site_cd'] ?? 'S6729';
+        $this->easyPaySiteCd = $this->isTest ? $easyPayTestSiteCd : $liveSiteCd;
+
+        $this->binDir = dirname(__DIR__, 2) . '/bin';
+    }
+
+    /**
+     * KCP 모바일 결제 승인키 획득 (SOAP)
+     *
+     * @param  string  $orderNumber    주문번호
+     * @param  string  $goodName       상품명
+     * @param  int     $amount         결제 금액
+     * @param  string  $payMethod      결제수단 코드 (CARD/BANK/MOBX/VCNT)
+     * @param  string  $retUrl         결제 결과 콜백 URL
+     * @param  string  $payMethodKey   원본 결제수단 키 (nhnkcp_payco 등, site_cd 분기용)
+     * @param  bool    $escrow         에스크로 여부
+     * @return array{approval_key: string, pay_url: string}
+     *
+     * @throws NhnKcpApiException
+     */
+    public function getApprovalKey(
+        string $orderNumber,
+        string $goodName,
+        int $amount,
+        string $payMethod,
+        string $retUrl,
+        string $payMethodKey = '',
+        bool $escrow = false,
+    ): array {
+        $wsdlFile = $this->binDir . DIRECTORY_SEPARATOR . ($this->isTest ? self::WSDL_TEST : self::WSDL_LIVE);
+
+        if (! file_exists($wsdlFile)) {
+            throw new NhnKcpApiException(__('sirsoft-pay_nhnkcp::messages.errors.wsdl_missing', ['file' => $wsdlFile]));
+        }
+
+        $siteCd = $escrow ? $this->escrowSiteCd : $this->resolveSiteCd($payMethodKey);
+
+        try {
+            $soapClient = new SoapClient($wsdlFile, [
+                'trace' => false,
+                'exceptions' => true,
+                'connection_timeout' => 15,
+                'encoding' => 'UTF-8',
+            ]);
+
+            $req = new \stdClass();
+            $req->accessCredentialType = (object) [
+                'accessLicense' => '',
+                'signature' => '',
+                'timestamp' => '',
+            ];
+            $req->baseRequestType = (object) [
+                'detailLevel' => '0',
+                'requestApp' => 'WEB',
+                'requestID' => $orderNumber,
+                'userAgent' => request()->userAgent() ?? '',
+                'version' => '0.1',
+            ];
+            $req->escrow = $escrow;
+            $req->orderID = $orderNumber;
+            $req->paymentAmount = (string) $amount;
+            $req->paymentMethod = $payMethod;
+            $req->productName = $goodName;
+            $req->returnUrl = $retUrl;
+            $req->siteCode = $siteCd;
+
+            $param = new \stdClass();
+            $param->req = $req;
+
+            $response = $soapClient->__soapCall('approve', [$param], [
+                'uri' => 'http://webservice.act.webpay.service.kcp.kr',
+                'soapaction' => '',
+            ]);
+
+            $resCode = $response->return->baseResponseType->error->code ?? '9999';
+            $resMsg  = (string) ($response->return->baseResponseType->error->message ?? '연동 오류');
+
+            if ($resCode !== '0000') {
+                Log::warning('[nhnkcp] mobile SOAP approval error', [
+                    'order' => $orderNumber,
+                    'res_cd' => $resCode,
+                    'res_msg' => $resMsg,
+                    'site_cd' => $siteCd,
+                ]);
+                throw new NhnKcpApiException(__('sirsoft-pay_nhnkcp::messages.errors.approval_key_error', ['code' => $resCode, 'message' => $resMsg]));
+            }
+
+            return [
+                'approval_key' => (string) ($response->return->approvalKey ?? ''),
+                'pay_url' => (string) ($response->return->payUrl ?? ''),
+            ];
+
+        } catch (SoapFault $e) {
+            Log::error('[nhnkcp] SOAP fault', [
+                'order' => $orderNumber,
+                'error' => $e->getMessage(),
+            ]);
+            throw new NhnKcpApiException(__('sirsoft-pay_nhnkcp::messages.errors.soap_error', ['message' => $e->getMessage()]), 0, $e);
+        }
+    }
+
+    /**
+     * 결제수단 키에 따른 site_cd 반환
+     *
+     * 레거시 settle_kcp.inc.php 규칙: PAYCO만 간편결제 전용 site_cd(테스트: S6729) 사용,
+     * NaverPay/KakaoPay/ApplePay 는 일반 site_cd(테스트: T0000) 사용.
+     *
+     * @param  string  $payMethodKey  결제수단 키 (nhnkcp_payco / nhnkcp_naverpay 등)
+     * @return string KCP site_cd
+     */
+    public function getSiteCd(string $payMethodKey = ''): string
+    {
+        return $this->resolveSiteCd($payMethodKey);
+    }
+
+    /**
+     * 에스크로 전용 site_cd 반환
+     *
+     * @return string 에스크로 전용 KCP site_cd
+     */
+    public function getEscrowSiteCd(): string
+    {
+        return $this->escrowSiteCd;
+    }
+
+    private function resolveSiteCd(string $payMethodKey): string
+    {
+        // PAYCO만 전용 간편결제 site_cd 사용 (레거시 settle_kcp.inc.php 동일)
+        if ($payMethodKey === 'nhnkcp_payco') {
+            return $this->easyPaySiteCd;
+        }
+
+        return $this->siteCd;
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/Services/NhnKcpApiService.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Services/NhnKcpApiService.php
new file mode 100644
index 00000000..1bd2861c
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/Services/NhnKcpApiService.php
@@ -0,0 +1,619 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Services;
+
+use App\Extension\HookManager;
+use App\Services\PluginSettingsService;
+use Illuminate\Support\Facades\Log;
+use Illuminate\Support\Facades\Http;
+use Plugins\Sirsoft\PayNhnkcp\Exceptions\NhnKcpApiException;
+
+class NhnKcpApiService
+{
+    private const PLUGIN_IDENTIFIER = 'sirsoft-pay_nhnkcp';
+
+    private const PA_URL_TEST = 'testpaygw.kcp.co.kr';
+
+    private const PA_URL_LIVE = 'paygw.kcp.co.kr';
+
+    private const PA_PORT = '8090';
+
+    private const TX_APPROVE = '00100000';
+
+    private const TX_CANCEL = '00200000';
+
+    private const JS_URL_TEST = 'https://testpay.kcp.co.kr/plugin/payplus_web.jsp';
+
+    private const JS_URL_LIVE = 'https://pay.kcp.co.kr/plugin/payplus_web.jsp';
+
+    private const API_URL_TEST = 'https://stgapi.kcp.co.kr';
+
+    private const API_URL_LIVE = 'https://api.kcp.co.kr';
+
+    private const LIVE_SITE_CD_PREFIX = 'SR';
+
+    /**
+     * KCP CLI log_level — '1' (오류만).
+     *
+     * '3' (verbose) 은 TX_ENDED 라인에 PG 응답 페이로드 전체(card_no 평문 등) 를
+     * 기록하므로 PCI DSS 위반 위험. LOG_DISABLED_PATH 와 함께 이중 안전장치.
+     */
+    private const LOG_LEVEL = '1';
+
+    /**
+     * KCP CLI log_path — 의도적으로 존재하지 않는 경로.
+     *
+     * gnuboard5 의 settle_kcp.inc.php 가 검증된 패턴 (`$g_conf_log_dir = '/home100/kcp'`).
+     * CLI 가 디렉토리 생성을 시도하지만 실패하므로 로그 작성 단계가 silent skip 된다.
+     * 결과:
+     *  - bin/log/YYYYMM/*.log 자체가 생성되지 않음
+     *  - 카드번호 / 사업자번호 등 결제 메타가 디스크에 잔존하지 않음 (PCI DSS 3.4)
+     *  - 비표준 배포(DocumentRoot=프로젝트 루트)에서 직접 다운로드 위험 자체가 부재
+     *
+     * 디버깅 필요 시 임시로 실제 경로를 지정해 활성화 가능하지만, 그 경우 결제
+     * 메타 평문 잔존을 운영자가 책임져야 함 (PCI 운영자 동의 필요).
+     */
+    private const LOG_DISABLED_PATH = '/home100/kcp';
+
+    private bool $isTest;
+
+    private string $siteCd;
+
+    private string $escrowSiteCd;
+
+    private string $siteKey;
+
+    private string $binDir;
+
+    public function __construct(
+        private readonly PluginSettingsService $pluginSettingsService,
+    )
+    {
+        $settings = $this->pluginSettingsService->get(self::PLUGIN_IDENTIFIER) ?? [];
+        $this->applyCredentials($settings, (bool) ($settings['is_test_mode'] ?? true));
+        $this->binDir = dirname(__DIR__, 2) . '/bin';
+    }
+
+    /**
+     * 활성 site_cd 반환 (테스트/라이브 자동 분기)
+     *
+     * @return string KCP site_cd
+     */
+    public function getSiteCd(): string
+    {
+        return $this->siteCd;
+    }
+
+    /**
+     * 현재 서비스 인스턴스가 테스트 모드인지 반환한다.
+     *
+     * @return bool 테스트 모드 여부
+     */
+    public function isTestMode(): bool
+    {
+        return $this->isTest;
+    }
+
+    /**
+     * 결제 당시 저장된 KCP 상점 코드/모드를 환불·조회 호출 전에 복원한다.
+     *
+     * 사이트 키는 DB 결제 메타에 저장하지 않고 현재 플러그인 설정의 해당 모드 키를 사용한다.
+     *
+     * @param  bool  $isTestMode  결제 당시 테스트 모드 여부
+     * @param  string  $siteCd  결제 당시 KCP site_cd
+     * @return void
+     */
+    public function useStoredCredentials(bool $isTestMode, string $siteCd): void
+    {
+        $settings = $this->pluginSettingsService->get(self::PLUGIN_IDENTIFIER) ?? [];
+        $this->applyCredentials($settings, $isTestMode, $siteCd);
+    }
+
+    /**
+     * Standard Pay JS SDK URL 반환 (테스트/라이브 자동 분기)
+     *
+     * @return string SDK URL
+     */
+    public function getJsUrl(): string
+    {
+        return $this->isTest ? self::JS_URL_TEST : self::JS_URL_LIVE;
+    }
+
+    /**
+     * KCP 거래 조회 (HTTP API 방식)
+     *
+     * 결제 승인/취소 hot path 는 KCP CLI 를 사용하지만, 거래 상태 조회처럼
+     * 부수효과가 없는 요청은 HTTP API 로 제공한다.
+     *
+     * @param string $tno      KCP 거래번호
+     * @param string $ordrIdxx 주문번호
+     * @return array KCP 거래 조회 응답
+     */
+    public function getTransaction(string $tno, string $ordrIdxx): array
+    {
+        $this->assertSafeCliValue($tno, 'tno');
+        $this->assertSafeCliValue($ordrIdxx, 'ordr_idxx');
+
+        $timestamp = now()->format('YmdHis');
+        $signature = hash_hmac(
+            'sha256',
+            implode('|', [$this->siteCd, $tno, $ordrIdxx, $timestamp]),
+            $this->siteKey
+        );
+
+        $url = $this->apiBaseUrl() . '/v1/payment/trade/' . rawurlencode($tno);
+
+        $response = Http::withBasicAuth($this->siteCd, $this->siteKey)
+            ->withHeaders([
+                'X-Kcp-Site-Code' => $this->siteCd,
+                'X-Kcp-Timestamp' => $timestamp,
+                'X-Kcp-Signature' => $signature,
+            ])
+            ->asJson()
+            ->post($url, [
+                'tno' => $tno,
+                'ordr_idxx' => $ordrIdxx,
+            ]);
+
+        if ($response->failed()) {
+            throw new NhnKcpApiException('KCP transaction query HTTP ' . $response->status());
+        }
+
+        $json = $response->json();
+
+        return is_array($json) ? $json : [];
+    }
+
+    /**
+     * KCP 결제 승인 (CLI 방식)
+     *
+     * Standard Pay 결제창 완료 후 받은 enc_data / enc_info 로 KCP CLI 를 통해
+     * 서버 승인 요청. 응답 res_cd = '0000' 이면 성공.
+     *
+     * @param  string  $encData  KCP 암호화 결제 데이터
+     * @param  string  $encInfo  KCP 암호화 결제 정보
+     * @param  string  $ordrIdxx  주문번호
+     * @param  string  $custIp  고객 IP
+     * @return array 파싱된 KCP 응답 (res_cd, res_msg, tno, app_no, card_no, quota 등)
+     */
+    public function approvePayment(string $encData, string $encInfo, string $ordrIdxx, string $custIp): array
+    {
+        return $this->executeCli(
+            txCd: self::TX_APPROVE,
+            ordrIdxx: $ordrIdxx,
+            encData: $encData,
+            encInfo: $encInfo,
+            custIp: $custIp,
+        );
+    }
+
+    /**
+     * KCP 결제 취소 (CLI 방식)
+     *
+     * @param string $tno       KCP 원거래 거래번호
+     * @param string $ordrIdxx  주문번호
+     * @param int    $cancelAmt 취소 금액
+     * @param string $cancelMsg 취소 사유
+     * @param bool   $isPartial 부분 취소 여부
+     * @param int    $totalAmt  현재 부분취소 가능 금액 (KCP rem_mny)
+     * @return array 파싱된 KCP 응답
+     */
+    public function cancelPayment(
+        string $tno,
+        string $ordrIdxx,
+        int $cancelAmt,
+        string $cancelMsg,
+        bool $isPartial = false,
+        int $totalAmt = 0,
+    ): array {
+        $modType = $isPartial ? 'RN07' : 'STSC';
+
+        $fields = [
+            'tno' => $tno,
+            'mod_type' => $modType,
+            'mod_desc' => $cancelMsg,
+        ];
+
+        if ($isPartial && $totalAmt > 0) {
+            // KCP rem_mny는 취소 후 잔액이 아니라 현재 부분취소 가능한 금액이다.
+            // 첫 부분취소는 원거래금액, 이후에는 이전 부분취소 후 남은 잔액을 전달한다.
+            $fields['rem_mny'] = (string) $totalAmt;
+            $fields['mod_mny'] = (string) $cancelAmt;
+        }
+
+        $modxData = $this->buildModData($fields);
+
+        // 훅: 결제 취소 전 (본인인증 등 확장 지점)
+        HookManager::doAction('sirsoft-pay_nhnkcp.payment.before_cancel', $tno, $ordrIdxx, $cancelAmt, $cancelMsg);
+
+        $result = $this->executeCli(
+            txCd: self::TX_CANCEL,
+            ordrIdxx: $ordrIdxx,
+            encData: '',
+            encInfo: '',
+            custIp: '127.0.0.1',
+            modxData: $modxData,
+        );
+
+        if (($result['res_cd'] ?? '') !== '0000') {
+            Log::error('KCP CLI cancel failed', [
+                'res_cd' => $result['res_cd'] ?? '',
+                'res_msg' => $result['res_msg'] ?? '',
+                'tno' => $tno,
+            ]);
+            throw new NhnKcpApiException($result['res_msg'] ?? 'KCP cancel failed');
+        }
+
+        // 훅: 결제 취소 완료 후 (외부 소비자 후처리 확장 지점)
+        HookManager::doAction('sirsoft-pay_nhnkcp.payment.after_cancel', $tno, $result);
+
+        return $result;
+    }
+
+    /**
+     * KCP 에스크로 배송 등록 (CLI 방식, mod_type=STE1)
+     *
+     * 에스크로 결제 후 상품을 발송할 때 KCP에 운송장번호를 등록합니다.
+     * 에스크로 테스트 결제는 별도 설정값이 있으면 그 site_cd를, 없으면 일반 테스트 site_cd를 사용합니다.
+     *
+     * @param  string  $tno       KCP 에스크로 거래번호
+     * @param  string  $ordrIdxx  주문번호
+     * @param  string  $deliNumb  운송장번호
+     * @param  string  $deliCorp  택배사코드 (KCP 코드: '04'=CJ대한통운, '05'=한진택배 등)
+     * @return array 파싱된 KCP 응답
+     */
+    public function registerEscrowDelivery(
+        string $tno,
+        string $ordrIdxx,
+        string $deliNumb,
+        string $deliCorp,
+    ): array {
+        $modxData = $this->buildModData([
+            'tno' => $tno,
+            'mod_type' => 'STE1',
+            'deli_numb' => $deliNumb,
+            'deli_corp' => $deliCorp,
+        ]);
+
+        $result = $this->executeCli(
+            txCd: self::TX_CANCEL,
+            ordrIdxx: $ordrIdxx,
+            encData: '',
+            encInfo: '',
+            custIp: '127.0.0.1',
+            modxData: $modxData,
+            siteCdOverride: $this->escrowSiteCd,
+        );
+
+        if (($result['res_cd'] ?? '') !== '0000') {
+            Log::error('KCP CLI escrow delivery register failed', [
+                'res_cd' => $result['res_cd'] ?? '',
+                'res_msg' => $result['res_msg'] ?? '',
+                'tno' => $tno,
+            ]);
+            throw new NhnKcpApiException($result['res_msg'] ?? 'KCP escrow delivery registration failed');
+        }
+
+        return $result;
+    }
+
+    private function executeCli(
+        string $txCd,
+        string $ordrIdxx,
+        string $encData,
+        string $encInfo,
+        string $custIp,
+        string $modxData = '',
+        string $siteCdOverride = '',
+    ): array {
+        $paUrl = $this->isTest ? self::PA_URL_TEST : self::PA_URL_LIVE;
+        $siteCd = $siteCdOverride !== '' ? $siteCdOverride : $this->siteCd;
+
+        if (strtoupper(substr(PHP_OS, 0, 3)) === 'WIN') {
+            $resData = $this->executeCliWindows($txCd, $ordrIdxx, $encData, $encInfo, $custIp, $paUrl, $modxData, $siteCd);
+        } else {
+            $resData = $this->executeCliLinux($txCd, $ordrIdxx, $encData, $encInfo, $custIp, $paUrl, $modxData, $siteCd);
+        }
+
+        if ($resData === '') {
+            $resData = 'res_cd=9502' . chr(31) . 'res_msg=연동 모듈 호출 오류';
+        }
+
+        // KCP Windows CLI는 CP949(EUC-KR)로 한글을 출력 — MySQL UTF-8 저장을 위해 변환
+        if (! mb_check_encoding($resData, 'UTF-8')) {
+            $converted = mb_convert_encoding($resData, 'UTF-8', 'CP949');
+            if ($converted !== false) {
+                $resData = $converted;
+            }
+        }
+
+        parse_str(str_replace(chr(31), '&', $resData), $result);
+
+        Log::debug('KCP CLI response parsed', [
+            'tx_cd' => $txCd,
+            'ordr_idxx' => $ordrIdxx,
+            'res_cd' => $result['res_cd'] ?? null,
+        ]);
+
+        return $result;
+    }
+
+    private function executeCliWindows(
+        string $txCd,
+        string $ordrIdxx,
+        string $encData,
+        string $encInfo,
+        string $custIp,
+        string $paUrl,
+        string $modxData,
+        string $siteCd = '',
+    ): string {
+        $siteCd = $siteCd !== '' ? $siteCd : $this->siteCd;
+        $keyPath = str_replace('/', DIRECTORY_SEPARATOR, $this->binDir . '/pub.key');
+        $binPath = str_replace('/', DIRECTORY_SEPARATOR, $this->binDir . '/pp_cli_exe.exe');
+
+        // 실행 권한 자가 복구: plugin:update 후 _bundled 의 0664 권한이 활성 디렉토리에 그대로
+        // 회귀해 9502 ("연동 모듈 호출 오류") 가 발생하던 회귀를 결제 hot path 에서 차단.
+        // Windows 에서는 chmod 자체는 no-op 에 가깝지만, is_file 가드는 의미 있음.
+        $this->ensureCliExecutable($binPath);
+        $planData = 'payx_data=' . ($modxData !== '' ? 'mod_data=' . $modxData : '');
+
+        // Shell injection 방어: CLI args 의 각 값을 사전 검증 후 안전한 값만 사용.
+        // 위험 문자(`"`, 제어문자, 개행) 가 포함되면 KCP CLI 인터페이스가 깨지고 cmd.exe
+        // 인수 파싱이 조작될 수 있어 NhnKcpApiException 으로 즉시 거부.
+        $this->assertSafeCliValue($siteCd, 'site_cd');
+        $this->assertSafeCliValue($this->siteKey, 'site_key');
+        $this->assertSafeCliValue($txCd, 'tx_cd');
+        $this->assertSafeCliValue($paUrl, 'pa_url');
+        $this->assertSafeCliValue($ordrIdxx, 'ordr_idxx');
+        $this->assertSafeCliValue($encData, 'enc_data');
+        $this->assertSafeCliValue($encInfo, 'enc_info');
+        $this->assertSafeCliValue($custIp, 'cust_ip');
+        $this->assertSafeCliValue($keyPath, 'key_path');
+        $this->assertSafeCliValue($planData, 'plan_data', allowKcpFieldSeparator: true);
+
+        $args = 'site_cd=' . $siteCd . ','
+            . 'site_key=' . $this->siteKey . ','
+            . 'tx_cd=' . $txCd . ','
+            . 'pa_url=' . $paUrl . ','
+            . 'pa_port=' . self::PA_PORT . ','
+            . 'ordr_idxx=' . $ordrIdxx . ','
+            . 'enc_data=' . $encData . ','
+            . 'enc_info=' . $encInfo . ','
+            . 'trace_no=,'
+            . 'cust_ip=' . $custIp . ','
+            . 'key_path=' . $keyPath . ','
+            . 'log_path=' . self::LOG_DISABLED_PATH . ','
+            . 'log_level=' . self::LOG_LEVEL . ','
+            . 'plan_data=' . $planData;
+
+        // escapeshellarg 로 binPath / args 각각을 안전하게 quoting (Windows 는 `"` 제거 + 큰따옴표 래핑).
+        $command = escapeshellarg($binPath) . ' ' . escapeshellarg($args);
+
+        Log::debug('KCP CLI command prepared (Windows)', [
+            'bin' => basename($binPath),
+            'tx_cd' => $txCd,
+            'ordr_idxx' => $ordrIdxx,
+            'site_cd' => $siteCd,
+        ]);
+
+        exec($command, $output, $returnCode);
+
+        Log::debug('KCP CLI exec result', [
+            'return_code' => $returnCode,
+            'output_count' => count($output),
+        ]);
+
+        // Windows 코드페이지 변경 메시지('Active code page: ...') 등 비-KCP 라인 제거
+        $kcpLines = array_filter($output, static fn (string $line) => str_contains($line, 'res_cd='));
+
+        if (empty($kcpLines)) {
+            return '';
+        }
+
+        return (string) array_values($kcpLines)[0];
+    }
+
+    private function executeCliLinux(
+        string $txCd,
+        string $ordrIdxx,
+        string $encData,
+        string $encInfo,
+        string $custIp,
+        string $paUrl,
+        string $modxData,
+        string $siteCd = '',
+    ): string {
+        $siteCd = $siteCd !== '' ? $siteCd : $this->siteCd;
+        $binExe = PHP_INT_MAX === 2147483647
+            ? $this->binDir . '/pp_cli'
+            : $this->binDir . '/pp_cli_x64';
+
+        // 실행 권한 자가 복구: plugin:update 후 _bundled 의 0664 권한이 활성 디렉토리에 그대로
+        // 회귀해 exec() 가 빈 결과를 반환 → 9502 ("연동 모듈 호출 오류") 가 발생하던 회귀를
+        // 결제 hot path 에서 차단. HealthCheckController 의 admin UI 진입 시점 복구와는 별개로
+        // 사용자 결제 시점 안전망 역할.
+        $this->ensureCliExecutable($binExe);
+
+        $modxArg = $modxData !== '' ? 'mod_data=' . $modxData : '';
+
+        // CLI args 사전 검증 — Linux 도 별도 sanitization 적용해 OS 간 동일한 가드.
+        $this->assertSafeCliValue($siteCd, 'site_cd');
+        $this->assertSafeCliValue($this->siteKey, 'site_key');
+        $this->assertSafeCliValue($txCd, 'tx_cd');
+        $this->assertSafeCliValue($paUrl, 'pa_url');
+        $this->assertSafeCliValue($ordrIdxx, 'ordr_idxx');
+        $this->assertSafeCliValue($encData, 'enc_data');
+        $this->assertSafeCliValue($encInfo, 'enc_info');
+        $this->assertSafeCliValue($custIp, 'cust_ip');
+        $this->assertSafeCliValue($modxArg, 'modx_data', allowKcpFieldSeparator: true);
+
+        $args = 'home=' . $this->binDir . ','
+            . 'site_cd=' . $siteCd . ','
+            . 'site_key=' . $this->siteKey . ','
+            . 'tx_cd=' . $txCd . ','
+            . 'pa_url=' . $paUrl . ','
+            . 'pa_port=' . self::PA_PORT . ','
+            . 'ordr_idxx=' . $ordrIdxx . ','
+            . 'enc_data=' . $encData . ','
+            . 'enc_info=' . $encInfo . ','
+            . 'trace_no=,'
+            . 'cust_ip=' . $custIp . ','
+            . 'modx_data=' . $modxArg . ','
+            . 'log_path=' . self::LOG_DISABLED_PATH . ','
+            . 'log_level=' . self::LOG_LEVEL . ','
+            . 'opt=';
+
+        $command = $binExe . ' ' . escapeshellarg('-h') . ' ' . escapeshellarg($args);
+
+        return (string) exec($command);
+    }
+
+    /**
+     * KCP CLI 바이너리의 실행 권한 자가 복구.
+     *
+     * plugin:update 가 _bundled 의 0664 권한을 활성 디렉토리로 그대로 복사해
+     * 실행 권한이 사라지면 exec() 가 빈 결과를 반환 → executeCli() 가 res_cd=9502
+     * fallback 으로 떨어진다. 결제 진입 직전 호출하여 권한이 부족하면 chmod 0755
+     * 로 복구, stat 캐시 무효화 후 재검증한다.
+     *
+     * 복구 실패 시 (PHP-FPM 이 파일 소유자가 아닌 sudo 환경 등) NhnKcpApiException
+     * 으로 fail-fast — exec() 가 9502 로 끝나기 전에 운영자가 원인 (sudo chmod 필요)
+     * 을 명확히 알 수 있다.
+     *
+     * @param  string  $binPath  KCP CLI 바이너리 절대 경로
+     * @return void
+     *
+     * @throws NhnKcpApiException 바이너리 누락 또는 실행 권한 복구 실패 시
+     */
+    private function ensureCliExecutable(string $binPath): void
+    {
+        if (! is_file($binPath)) {
+            throw new NhnKcpApiException(__('sirsoft-pay_nhnkcp::messages.errors.cli_binary_missing', [
+                'path' => $binPath,
+            ]));
+        }
+
+        clearstatcache(true, $binPath);
+        if (is_executable($binPath)) {
+            return;
+        }
+
+        $beforeMode = substr(sprintf('%o', fileperms($binPath)), -4);
+        $chmodOk = @chmod($binPath, 0755);
+        clearstatcache(true, $binPath);
+
+        if ($chmodOk && is_executable($binPath)) {
+            Log::info('KCP: CLI 바이너리 실행 권한 자가 복구', [
+                'path' => $binPath,
+                'before' => $beforeMode,
+                'after' => '0755',
+            ]);
+
+            return;
+        }
+
+        Log::error('KCP: CLI 실행 권한 자가 복구 실패 — sudo chmod 필요', [
+            'path' => $binPath,
+            'mode' => $beforeMode,
+            'owner' => fileowner($binPath),
+            'php_uid' => function_exists('posix_geteuid') ? posix_geteuid() : null,
+        ]);
+
+        throw new NhnKcpApiException(
+            __('sirsoft-pay_nhnkcp::messages.errors.cli_binary_not_executable', ['path' => $binPath])
+        );
+    }
+
+    /**
+     * CLI args 의 단일 값에 shell injection 위험 문자가 없는지 검증.
+     *
+     * 거부 대상:
+     *  - 큰따옴표 (`"`) — Windows cmd.exe 의 args quoting 깨짐
+     *  - 제어문자 (개행 / 캐리지리턴 / NUL / TAB) — argv 분리/명령 종료 위험
+     *  - 백틱 (`` ` ``) — 일부 셸에서 명령 치환
+     *
+     * KCP CLI 의 정상 입력 (alphanumeric, base64, IP, URL, Windows path 등) 은
+     * 모두 통과하며, 비정상 페이로드만 차단한다.
+     *
+     * @param  string  $value  검증할 값
+     * @param  string  $key  필드 이름 (예외 메시지용)
+     *
+     * @throws NhnKcpApiException 위험 문자 발견 시
+     */
+    private function assertSafeCliValue(string $value, string $key, bool $allowKcpFieldSeparator = false): void
+    {
+        // 큰따옴표 / 백틱 — 명시적 위험
+        if (preg_match('/["`]/', $value) === 1) {
+            throw new NhnKcpApiException(
+                "KCP CLI rejected unsafe value for {$key} (contains quote/backtick)."
+            );
+        }
+
+        // 제어문자 (NUL / LF / CR / TAB 등 0x00-0x1F + 0x7F).
+        // KCP CLI mod_data 자체에는 필드 구분자 chr(31)가 필요하므로 내부에서
+        // buildModData()로 개별 값 검증을 마친 조립 문자열에 한해 chr(31)만 허용한다.
+        $controlPattern = $allowKcpFieldSeparator ? '/[\x00-\x1E\x7F]/' : '/[\x00-\x1F\x7F]/';
+        if (preg_match($controlPattern, $value) === 1) {
+            throw new NhnKcpApiException(
+                "KCP CLI rejected unsafe value for {$key} (contains control character)."
+            );
+        }
+    }
+
+    /**
+     * KCP CLI mod_data 문자열을 안전하게 조립한다.
+     *
+     * 개별 value 에 KCP 필드 구분자(chr(31))나 쉘 인자 위험 문자가 들어가면 먼저
+     * 거부한 뒤, 내부 구분자만 포함한 mod_data 를 만든다.
+     *
+     * @param array<string, string|int> $fields
+     */
+    private function buildModData(array $fields): string
+    {
+        $parts = [];
+
+        foreach ($fields as $key => $value) {
+            $value = (string) $value;
+            $this->assertSafeCliValue($key, 'mod_data_key');
+            $this->assertSafeCliValue($value, $key);
+            $parts[] = $key . '=' . $value;
+        }
+
+        return implode(chr(31), $parts) . chr(31);
+    }
+
+    private function apiBaseUrl(): string
+    {
+        return $this->isTest ? self::API_URL_TEST : self::API_URL_LIVE;
+    }
+
+    /**
+     * 플러그인 설정과 선택 모드 기준으로 KCP 인증 정보를 적용한다.
+     */
+    private function applyCredentials(array $settings, bool $isTestMode, string $siteCdOverride = ''): void
+    {
+        $this->isTest = $isTestMode;
+
+        if ($this->isTest) {
+            $this->siteCd = $siteCdOverride !== '' ? $siteCdOverride : ($settings['test_site_cd'] ?? 'T0000');
+            $escrowTestSiteCd = trim((string) ($settings['escrow_test_site_cd'] ?? ''));
+            $this->escrowSiteCd = $escrowTestSiteCd !== '' ? $escrowTestSiteCd : $this->siteCd;
+            $this->siteKey = $settings['test_site_key'] ?? '';
+
+            return;
+        }
+
+        $liveSiteCd = $siteCdOverride !== '' ? $siteCdOverride : ($settings['live_site_cd'] ?? '');
+        $this->siteCd = $this->buildLiveSiteCd($liveSiteCd);
+        $this->escrowSiteCd = $this->siteCd;
+        $this->siteKey = $settings['live_site_key'] ?? '';
+    }
+
+    private function buildLiveSiteCd(string $suffix): string
+    {
+        return str_starts_with($suffix, self::LIVE_SITE_CD_PREFIX) ? $suffix : self::LIVE_SITE_CD_PREFIX . $suffix;
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/routes/api.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/routes/api.php
new file mode 100644
index 00000000..6817d9c4
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/routes/api.php
@@ -0,0 +1,82 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+use Plugins\Sirsoft\PayNhnkcp\Controllers\AdminEscrowDeliveryController;
+use Plugins\Sirsoft\PayNhnkcp\Controllers\AdminOrderListController;
+use Plugins\Sirsoft\PayNhnkcp\Controllers\AdminSettingsStatusController;
+use Plugins\Sirsoft\PayNhnkcp\Controllers\AdminTransactionController;
+use Plugins\Sirsoft\PayNhnkcp\Controllers\HealthCheckController;
+use Plugins\Sirsoft\PayNhnkcp\Controllers\MobileApprovalController;
+use Plugins\Sirsoft\PayNhnkcp\Controllers\PaymentCloseReportController;
+use Plugins\Sirsoft\PayNhnkcp\Controllers\PaymentRetryController;
+use Plugins\Sirsoft\PayNhnkcp\Controllers\UserReceiptController;
+use Plugins\Sirsoft\PayNhnkcp\Controllers\UserVbankMockDepositController;
+
+/*
+|--------------------------------------------------------------------------
+| NHN KCP Plugin API Routes
+|--------------------------------------------------------------------------
+|
+| 프리픽스: /api/plugins/sirsoft-pay_nhnkcp (PluginRouteServiceProvider 자동 적용)
+| 미들웨어: api (PluginRouteServiceProvider 자동 적용)
+|
+*/
+
+// PC 결제창 닫힘 보고 — 주문 컨텍스트 검증 후 결제 실패/취소 이력 기록
+Route::post('/payment/close-report', [PaymentCloseReportController::class, 'store'])
+    ->name('payment.close-report');
+
+// 결제 재시도 준비 — 이전 실패/취소 주문을 검증 후 같은 주문번호로 재결제 가능 상태로 복구
+Route::post('/payment/retry', [PaymentRetryController::class, 'store'])
+    ->name('payment.retry');
+
+Route::get('/user/orders/{orderNumber}/receipt', [UserReceiptController::class, 'show'])
+    ->middleware('optional.sanctum')
+    ->name('user.orders.receipt');
+
+Route::middleware(['auth:sanctum'])->group(function () {
+    // 테스트 모드 가상계좌 모의입금 정보 (입금대기 상태일 때만 데이터 반환)
+    Route::get('/user/orders/{orderNumber}/vbank-mock-deposit-info', [UserVbankMockDepositController::class, 'show'])
+        ->name('user.orders.vbank-mock-deposit-info');
+
+    // 모바일 결제 승인키 획득 (KCP SmartPhone Pay SOAP)
+    Route::post('/mobile/approval-key', [MobileApprovalController::class, 'getApprovalKey'])
+        ->name('mobile.approval-key');
+});
+
+Route::prefix('admin')->name('admin.')->middleware(['auth:sanctum', 'admin'])->group(function () {
+    // 가상계좌 입금통보 URL 조회 (관리자 설정 페이지 표시용)
+    Route::get('/vbank-notify-url', fn () => response()->json([
+        'success' => true,
+        'data' => [
+            'url' => url('/plugins/sirsoft-pay_nhnkcp/payment/vbank-notify'),
+            'escrow_common_notify_url' => url('/plugins/sirsoft-pay_nhnkcp/payment/escrow-common-notify'),
+        ],
+    ]))->name('vbank.notify.url');
+
+    Route::get('/settings/test-mode-status', [AdminSettingsStatusController::class, 'testMode'])
+        ->middleware('permission:admin,sirsoft-ecommerce.settings.read')
+        ->name('settings.test-mode-status');
+
+    // 테스트 모드 주문 맵 (관리자 주문목록 배지 표시용)
+    Route::get('/orders/test-mode-map', [AdminOrderListController::class, 'testModeMap'])
+        ->name('orders.test-mode-map');
+
+    // 간편결제 원 결제수단 표시 맵 (관리자 주문목록 보강용)
+    Route::get('/orders/easy-pay-display-map', [AdminOrderListController::class, 'easyPayDisplayMap'])
+        ->name('orders.easy-pay-display-map');
+
+    // 주문번호로 거래 정보 조회 (레이아웃 확장 자동 로드용)
+    Route::get('/orders/{orderNumber}/transaction-status', [AdminTransactionController::class, 'queryByOrder'])
+        ->name('orders.transaction-status');
+
+    // 에스크로 배송 등록
+    Route::get('/orders/{orderNumber}/escrow-delivery', [AdminEscrowDeliveryController::class, 'formData'])
+        ->name('orders.escrow-delivery.form');
+    Route::post('/orders/{orderNumber}/escrow-delivery', [AdminEscrowDeliveryController::class, 'register'])
+        ->name('orders.escrow-delivery.register');
+
+    // 시스템 점검 (PC/모바일 결제 사전조건 진단 + 자동 chmod +x 복구)
+    Route::get('/health', [HealthCheckController::class, 'check'])
+        ->name('health');
+});
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/src/routes/web.php b/plugins/_bundled/sirsoft-pay_nhnkcp/src/routes/web.php
new file mode 100644
index 00000000..00736fda
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/src/routes/web.php
@@ -0,0 +1,40 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+use Plugins\Sirsoft\PayNhnkcp\Controllers\EscrowCommonNotifyController;
+use Plugins\Sirsoft\PayNhnkcp\Controllers\PaymentCallbackController;
+use Plugins\Sirsoft\PayNhnkcp\Http\Middleware\RestrictKcpIp;
+
+/*
+|--------------------------------------------------------------------------
+| NHN KCP Plugin Web Routes
+|--------------------------------------------------------------------------
+|
+| 프리픽스: /plugins/sirsoft-pay_nhnkcp (PluginRouteServiceProvider 자동 적용)
+| 미들웨어: web (PluginRouteServiceProvider 자동 적용)
+|
+| KCP Standard Pay는 브라우저 POST 콜백 방식이므로 CSRF 미들웨어를 제외합니다.
+|
+| IP 검증:
+|   - authCallback: 브라우저 POST (사용자 IP) → IP 검증 안 함
+|   - vbank-notify, escrow-common-notify: KCP 서버 직접 POST → RestrictKcpIp 가드
+|     (테스트 모드 시 우회. 그누보드5 settle_kcp_common.php 동일 패턴)
+|
+*/
+
+Route::withoutMiddleware([\Illuminate\Foundation\Http\Middleware\ValidateCsrfToken::class])->group(function () {
+    // 결제 승인 콜백 (KCP → 브라우저 POST)
+    Route::post('/payment/callback', [PaymentCallbackController::class, 'authCallback'])
+        ->name('payment.callback');
+
+    // KCP 서버 발신 webhook 그룹 (IP 화이트리스트 가드)
+    Route::middleware(RestrictKcpIp::class)->group(function () {
+        // 가상계좌 입금 통보 (KCP 서버 → 우리 서버 POST)
+        Route::post('/payment/vbank-notify', [PaymentCallbackController::class, 'vbankNotify'])
+            ->name('payment.vbank-notify');
+
+        // 에스크로 공통통보 (KCP 서버 → 우리 서버 POST: TX02 구매확인/취소, TX03 배송시작)
+        Route::post('/payment/escrow-common-notify', [EscrowCommonNotifyController::class, 'handle'])
+            ->name('payment.escrow-common-notify');
+    });
+});
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Concerns/PreventsReplayCallbackTest.php b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Concerns/PreventsReplayCallbackTest.php
new file mode 100644
index 00000000..9024c8af
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Concerns/PreventsReplayCallbackTest.php
@@ -0,0 +1,141 @@
+<?php
+
+namespace Plugins\Sirsoft\PayNhnkcp\Tests\Feature\Concerns;
+
+use App\Models\User;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderFactory;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderPaymentFactory;
+use Modules\Sirsoft\Ecommerce\Enums\OrderStatusEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentMethodEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentStatusEnum;
+use Plugins\Sirsoft\PayNhnkcp\Concerns\PreventsReplayCallback;
+use Plugins\Sirsoft\PayNhnkcp\Tests\PluginTestCase;
+
+/**
+ * Phase 3 PoC (Feature) — NHN KCP PreventsReplayCallback trait 동작 검증
+ *
+ * trait 의 wasAlreadyPaid() 가 다음 시나리오에서 올바르게 분기:
+ *   1. transaction_id null/empty → false (early return)
+ *   2. paid 상태 + 동일 tno → true (replay detected)
+ *   3. ready 상태만 존재 → false
+ *   4. paid 상태이지만 다른 tno → false
+ *   5. failed 상태 + 동일 tno → false
+ */
+class PreventsReplayCallbackTest extends PluginTestCase
+{
+    private object $traitSubject;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        $this->traitSubject = new class {
+            use PreventsReplayCallback {
+                wasAlreadyPaid as public;
+            }
+        };
+    }
+
+    private function seedPayment(string $tno, PaymentStatusEnum $status, int $amount = 50000): void
+    {
+        $user = User::factory()->create();
+
+        $order = OrderFactory::new()->create([
+            'user_id' => $user->id,
+            'order_number' => 'ORD-RC-' . random_int(10000, 99999),
+            'order_status' => $status === PaymentStatusEnum::PAID
+                ? OrderStatusEnum::PAYMENT_COMPLETE
+                : OrderStatusEnum::PENDING_ORDER,
+            'subtotal_amount' => $amount,
+            'total_discount_amount' => 0,
+            'total_coupon_discount_amount' => 0,
+            'total_product_coupon_discount_amount' => 0,
+            'total_order_coupon_discount_amount' => 0,
+            'total_code_discount_amount' => 0,
+            'base_shipping_amount' => 0,
+            'extra_shipping_amount' => 0,
+            'shipping_discount_amount' => 0,
+            'total_shipping_amount' => 0,
+            'total_amount' => $amount,
+            'total_due_amount' => $amount,
+            'total_points_used_amount' => 0,
+            'total_deposit_used_amount' => 0,
+            'total_paid_amount' => $status === PaymentStatusEnum::PAID ? $amount : 0,
+        ]);
+
+        OrderPaymentFactory::new()->create([
+            'order_id' => $order->id,
+            'payment_status' => $status,
+            'payment_method' => PaymentMethodEnum::CARD,
+            'pg_provider' => 'nhnkcp',
+            'paid_amount_local' => $status === PaymentStatusEnum::PAID ? $amount : 0,
+            'paid_at' => $status === PaymentStatusEnum::PAID ? now() : null,
+            'transaction_id' => $tno,
+        ]);
+    }
+
+    /**
+     * @scenario context=paymentCallback_card, threat=replay, callback_state=first_arrival
+     * @effects replay_first_arrival_proceeds_normally
+     */
+    public function test_null_transaction_id_returns_false(): void
+    {
+        $this->assertFalse($this->traitSubject->wasAlreadyPaid(null));
+    }
+
+    /**
+     * @scenario context=paymentCallback_card, threat=replay, callback_state=first_arrival
+     * @effects replay_first_arrival_proceeds_normally
+     */
+    public function test_empty_transaction_id_returns_false(): void
+    {
+        $this->assertFalse($this->traitSubject->wasAlreadyPaid(''));
+    }
+
+    /**
+     * @scenario context=paymentCallback_card, threat=replay, callback_state=second_arrival_same_tno
+     * @effects replay_detected_on_second_arrival
+     */
+    public function test_paid_payment_with_same_tno_returns_true(): void
+    {
+        $tno = 'TNO_PAID_001';
+        $this->seedPayment($tno, PaymentStatusEnum::PAID);
+
+        $this->assertTrue($this->traitSubject->wasAlreadyPaid($tno));
+    }
+
+    /**
+     * @scenario context=paymentCallback_card, threat=replay, callback_state=first_arrival
+     * @effects replay_first_arrival_proceeds_normally
+     */
+    public function test_ready_status_payment_returns_false(): void
+    {
+        $tno = 'TNO_READY_001';
+        $this->seedPayment($tno, PaymentStatusEnum::READY);
+
+        $this->assertFalse($this->traitSubject->wasAlreadyPaid($tno));
+    }
+
+    /**
+     * @scenario context=paymentCallback_card, threat=replay, callback_state=first_arrival
+     * @effects replay_first_arrival_proceeds_normally
+     */
+    public function test_paid_with_different_tno_returns_false(): void
+    {
+        $this->seedPayment('TNO_OTHER_001', PaymentStatusEnum::PAID);
+
+        $this->assertFalse($this->traitSubject->wasAlreadyPaid('TNO_QUERY_001'));
+    }
+
+    /**
+     * @scenario context=paymentCallback_card, threat=replay, callback_state=first_arrival
+     * @effects replay_first_arrival_proceeds_normally
+     */
+    public function test_failed_payment_with_same_tno_returns_false(): void
+    {
+        $tno = 'TNO_FAILED_001';
+        $this->seedPayment($tno, PaymentStatusEnum::FAILED);
+
+        $this->assertFalse($this->traitSubject->wasAlreadyPaid($tno));
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Concerns/SerializesPaymentCallbacksTest.php b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Concerns/SerializesPaymentCallbacksTest.php
new file mode 100644
index 00000000..14725fc0
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Concerns/SerializesPaymentCallbacksTest.php
@@ -0,0 +1,74 @@
+<?php
+
+namespace Plugins\Sirsoft\PayNhnkcp\Tests\Feature\Concerns;
+
+use Illuminate\Contracts\Cache\LockTimeoutException;
+use Plugins\Sirsoft\PayNhnkcp\Concerns\SerializesPaymentCallbacks;
+use Plugins\Sirsoft\PayNhnkcp\Tests\PluginTestCase;
+
+class SerializesPaymentCallbacksTest extends PluginTestCase
+{
+    private object $traitSubject;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        $this->traitSubject = new class {
+            use SerializesPaymentCallbacks {
+                acquireOrderCallbackLock as public;
+                releaseOrderCallbackLock as public;
+                callbackLockKey as public;
+            }
+
+            protected function callbackLockWaitSeconds(): int
+            {
+                return 0;
+            }
+
+            protected function callbackLockTtlSeconds(): int
+            {
+                return 5;
+            }
+        };
+    }
+
+    public function test_same_context_and_order_are_serialized(): void
+    {
+        $orderNumber = 'ORD-KCP-LOCK-' . random_int(10000, 99999);
+        $firstLock = $this->traitSubject->acquireOrderCallbackLock('authCallback', $orderNumber);
+
+        try {
+            $this->expectException(LockTimeoutException::class);
+
+            $this->traitSubject->acquireOrderCallbackLock('authCallback', $orderNumber);
+        } finally {
+            $this->traitSubject->releaseOrderCallbackLock($firstLock);
+        }
+    }
+
+    public function test_released_lock_allows_next_callback(): void
+    {
+        $orderNumber = 'ORD-KCP-LOCK-' . random_int(10000, 99999);
+        $firstLock = $this->traitSubject->acquireOrderCallbackLock('authCallback', $orderNumber);
+        $this->traitSubject->releaseOrderCallbackLock($firstLock);
+
+        $secondLock = $this->traitSubject->acquireOrderCallbackLock('authCallback', $orderNumber);
+
+        $this->assertNotNull($secondLock);
+        $this->traitSubject->releaseOrderCallbackLock($secondLock);
+    }
+
+    public function test_lock_key_is_scoped_by_context_and_order(): void
+    {
+        $this->assertNotSame(
+            $this->traitSubject->callbackLockKey('authCallback', 'ORD-KCP-LOCK-A'),
+            $this->traitSubject->callbackLockKey('vbankNotify', 'ORD-KCP-LOCK-A'),
+        );
+
+        $this->assertNotSame(
+            $this->traitSubject->callbackLockKey('authCallback', 'ORD-KCP-LOCK-A'),
+            $this->traitSubject->callbackLockKey('authCallback', 'ORD-KCP-LOCK-B'),
+        );
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/AdminEscrowDeliveryControllerTest.php b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/AdminEscrowDeliveryControllerTest.php
new file mode 100644
index 00000000..82467961
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/AdminEscrowDeliveryControllerTest.php
@@ -0,0 +1,95 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Tests\Feature\Controllers;
+
+use App\Models\User;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderFactory;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderPaymentFactory;
+use Modules\Sirsoft\Ecommerce\Enums\OrderStatusEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentMethodEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentStatusEnum;
+use Modules\Sirsoft\Ecommerce\Models\Order;
+use Plugins\Sirsoft\PayNhnkcp\Services\NhnKcpApiService;
+use Plugins\Sirsoft\PayNhnkcp\Tests\PluginTestCase;
+
+class AdminEscrowDeliveryControllerTest extends PluginTestCase
+{
+    private function createEscrowOrder(string $tno = 'KCP_ESCROW_TNO_DELIVERY'): Order
+    {
+        $user = User::factory()->create();
+        $order = OrderFactory::new()->create([
+            'user_id' => $user->id,
+            'order_status' => OrderStatusEnum::PAYMENT_COMPLETE,
+            'subtotal_amount' => 30000,
+            'total_amount' => 30000,
+            'total_due_amount' => 0,
+            'total_paid_amount' => 30000,
+            'paid_at' => now(),
+        ]);
+
+        OrderPaymentFactory::new()->create([
+            'order_id' => $order->id,
+            'payment_status' => PaymentStatusEnum::PAID,
+            'payment_method' => PaymentMethodEnum::CARD,
+            'pg_provider' => 'nhnkcp',
+            'transaction_id' => $tno,
+            'paid_amount_local' => 30000,
+            'paid_at' => now(),
+            'is_escrow' => true,
+            'payment_meta' => [
+                'site_cd' => 'T0000',
+                'is_test_mode' => true,
+                'escw_yn' => 'Y',
+            ],
+        ]);
+
+        return $order;
+    }
+
+    private function mockEscrowDeliveryApi(array $response): void
+    {
+        $mock = $this->createMock(NhnKcpApiService::class);
+        $mock->method('registerEscrowDelivery')->willReturn($response);
+        $this->app->instance(NhnKcpApiService::class, $mock);
+    }
+
+    public function test_register_stores_sanitized_pg_response_only(): void
+    {
+        $admin = $this->createAdminUser(['sirsoft-ecommerce.orders.update']);
+        $order = $this->createEscrowOrder();
+        $this->mockEscrowDeliveryApi([
+            'res_cd' => '0000',
+            'res_msg' => '정상처리',
+            'tno' => 'KCP_ESCROW_TNO_DELIVERY',
+            'deli_numb' => '1234567890',
+            'deli_corp' => '04',
+            'recv_name' => '수령자',
+            'recv_tel' => '01012345678',
+            'recv_addr' => '서울시 테스트구',
+            'unexpected_sensitive' => 'store-me-not',
+        ]);
+
+        $response = $this->actingAs($admin)
+            ->postJson("/api/plugins/sirsoft-pay_nhnkcp/admin/orders/{$order->order_number}/escrow-delivery", [
+                'deli_numb' => '1234567890',
+                'deli_corp' => '04',
+            ]);
+
+        $response->assertOk()->assertJsonPath('success', true);
+
+        $payment = $order->payment;
+        $payment->refresh();
+        $deliveryMeta = $payment->payment_meta['escrow_delivery'] ?? [];
+        $pgResponse = $deliveryMeta['pg_response'] ?? [];
+
+        $this->assertTrue($deliveryMeta['pg_response_sanitized'] ?? false);
+        $this->assertSame('0000', $pgResponse['res_cd'] ?? null);
+        $this->assertSame('KCP_ESCROW_TNO_DELIVERY', $pgResponse['tno'] ?? null);
+        $this->assertArrayNotHasKey('recv_name', $pgResponse);
+        $this->assertArrayNotHasKey('recv_tel', $pgResponse);
+        $this->assertArrayNotHasKey('recv_addr', $pgResponse);
+        $this->assertArrayNotHasKey('unexpected_sensitive', $pgResponse);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/AdminOrderListControllerTest.php b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/AdminOrderListControllerTest.php
new file mode 100644
index 00000000..2cd0c53a
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/AdminOrderListControllerTest.php
@@ -0,0 +1,63 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Tests\Feature\Controllers;
+
+use App\Models\User;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderFactory;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderPaymentFactory;
+use Modules\Sirsoft\Ecommerce\Enums\OrderStatusEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentMethodEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentStatusEnum;
+use Plugins\Sirsoft\PayNhnkcp\Tests\PluginTestCase;
+
+class AdminOrderListControllerTest extends PluginTestCase
+{
+    public function test_easy_pay_display_map_returns_order_payment_display_labels(): void
+    {
+        app()->setLocale('ko');
+
+        $admin = $this->createAdminUser(['sirsoft-ecommerce.orders.read']);
+        $order = OrderFactory::new()->create([
+            'user_id' => User::factory()->create()->id,
+            'order_number' => 'ORD-KCP-LIST-' . random_int(10000, 99999),
+            'order_status' => OrderStatusEnum::PAYMENT_COMPLETE,
+            'total_amount' => 50000,
+            'total_due_amount' => 0,
+            'total_paid_amount' => 50000,
+            'paid_at' => now(),
+        ]);
+
+        OrderPaymentFactory::new()->create([
+            'order_id' => $order->id,
+            'payment_status' => PaymentStatusEnum::PAID,
+            'payment_method' => PaymentMethodEnum::CARD,
+            'pg_provider' => 'nhnkcp',
+            'transaction_id' => 'KCP_TNO_PAYCO',
+            'embedded_pg_provider' => 'payco',
+            'paid_amount_local' => 50000,
+            'paid_at' => now(),
+            'payment_meta' => [
+                'nhnkcp_easy_pay_method' => 'nhnkcp_payco',
+                'nhnkcp_easy_pay_provider' => 'payco',
+                'nhnkcp_easy_pay_label' => [
+                    'ko' => 'PAYCO (페이코)',
+                    'en' => 'PAYCO',
+                ],
+            ],
+        ]);
+
+        $response = $this->actingAs($admin)
+            ->getJson('/api/plugins/sirsoft-pay_nhnkcp/admin/orders/easy-pay-display-map');
+
+        $response->assertOk();
+
+        $display = $response->json("data.{$order->order_number}");
+        $this->assertContains($display['embedded_pg_provider_label'] ?? null, ['PAYCO (페이코)', 'PAYCO']);
+        $this->assertSame(
+            ($display['embedded_pg_provider_label'] ?? '') . ' (' . ($display['payment_method_label'] ?? '') . ')',
+            $display['payment_method_display_label'] ?? null,
+        );
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/AdminSettingsStatusControllerTest.php b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/AdminSettingsStatusControllerTest.php
new file mode 100644
index 00000000..65531499
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/AdminSettingsStatusControllerTest.php
@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Tests\Feature\Controllers;
+
+use App\Services\PluginSettingsService;
+use Plugins\Sirsoft\PayNhnkcp\Tests\PluginTestCase;
+
+class AdminSettingsStatusControllerTest extends PluginTestCase
+{
+    public function test_test_mode_status_returns_current_setting(): void
+    {
+        $settings = $this->createMock(PluginSettingsService::class);
+        $settings->expects($this->once())
+            ->method('get')
+            ->with('sirsoft-pay_nhnkcp', 'is_test_mode', true)
+            ->willReturn(true);
+        $this->app->instance(PluginSettingsService::class, $settings);
+
+        $admin = $this->createAdminUser(['sirsoft-ecommerce.settings.read']);
+
+        $response = $this->actingAs($admin)
+            ->getJson('/api/plugins/sirsoft-pay_nhnkcp/admin/settings/test-mode-status');
+
+        $response->assertOk()
+            ->assertJsonPath('data.is_test_mode', true);
+
+        $data = $response->json('data');
+        $this->assertArrayNotHasKey('test_site_cd', $data);
+        $this->assertArrayNotHasKey('live_site_cd', $data);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/AdminTransactionControllerTest.php b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/AdminTransactionControllerTest.php
new file mode 100644
index 00000000..e139aa9e
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/AdminTransactionControllerTest.php
@@ -0,0 +1,141 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Tests\Feature\Controllers;
+
+use App\Models\User;
+use Illuminate\Support\Facades\DB;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderFactory;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderPaymentFactory;
+use Modules\Sirsoft\Ecommerce\Enums\OrderStatusEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentMethodEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentStatusEnum;
+use Modules\Sirsoft\Ecommerce\Enums\RefundStatusEnum;
+use Plugins\Sirsoft\PayNhnkcp\Tests\PluginTestCase;
+
+class AdminTransactionControllerTest extends PluginTestCase
+{
+    public function test_transaction_status_includes_easy_pay_display_label(): void
+    {
+        app()->setLocale('ko');
+
+        $admin = $this->createAdminUser(['sirsoft-ecommerce.orders.read']);
+        $order = OrderFactory::new()->create([
+            'user_id' => User::factory()->create()->id,
+            'order_number' => 'ORD-KCP-ADMIN-' . random_int(10000, 99999),
+            'order_status' => OrderStatusEnum::PAYMENT_COMPLETE,
+            'total_amount' => 50000,
+            'total_due_amount' => 0,
+            'total_paid_amount' => 50000,
+            'paid_at' => now(),
+        ]);
+
+        OrderPaymentFactory::new()->create([
+            'order_id' => $order->id,
+            'payment_status' => PaymentStatusEnum::PAID,
+            'payment_method' => PaymentMethodEnum::CARD,
+            'pg_provider' => 'nhnkcp',
+            'transaction_id' => 'KCP_TNO_KAKAOPAY',
+            'embedded_pg_provider' => 'kakaopay',
+            'paid_amount_local' => 50000,
+            'paid_at' => now(),
+            'payment_meta' => [
+                'nhnkcp_easy_pay_method' => 'nhnkcp_kakaopay',
+                'nhnkcp_easy_pay_provider' => 'kakaopay',
+                'nhnkcp_easy_pay_label' => [
+                    'ko' => '카카오페이',
+                    'en' => 'KakaoPay',
+                ],
+                'pg_raw_response' => [
+                    'app_no' => 'APP12345',
+                    'use_pay_method' => 'CARD',
+                ],
+            ],
+        ]);
+
+        $response = $this->actingAs($admin)
+            ->getJson("/api/plugins/sirsoft-pay_nhnkcp/admin/orders/{$order->order_number}/transaction-status");
+
+        $response->assertOk()
+            ->assertJsonPath('data._embedded_pg_provider', 'kakaopay');
+
+        $data = $response->json('data');
+        $this->assertContains($data['_embedded_pg_provider_label'] ?? null, ['카카오페이', 'KakaoPay']);
+        $this->assertSame(
+            ($data['_embedded_pg_provider_label'] ?? '') . ' (' . ($data['_base_pay_method_label'] ?? '') . ')',
+            $data['_pay_method_label'] ?? null,
+        );
+    }
+
+    public function test_transaction_status_exposes_current_cancelled_payment_and_refund_state(): void
+    {
+        app()->setLocale('ko');
+
+        $admin = $this->createAdminUser(['sirsoft-ecommerce.orders.read']);
+        $order = OrderFactory::new()->create([
+            'user_id' => User::factory()->create()->id,
+            'order_number' => 'ORD-KCP-CANCELLED-' . random_int(10000, 99999),
+            'order_status' => OrderStatusEnum::CANCELLED,
+            'total_amount' => 1100,
+            'total_due_amount' => 0,
+            'total_paid_amount' => 0,
+            'total_refunded_amount' => 1100,
+            'paid_at' => now()->subMinute(),
+            'cancelled_at' => now(),
+        ]);
+
+        OrderPaymentFactory::new()->create([
+            'order_id' => $order->id,
+            'payment_status' => PaymentStatusEnum::CANCELLED,
+            'payment_method' => PaymentMethodEnum::CARD,
+            'pg_provider' => 'nhnkcp',
+            'transaction_id' => '26438048818473',
+            'paid_amount_local' => 1100,
+            'paid_amount_base' => 1100,
+            'cancelled_amount' => 1100,
+            'cancelled_at' => now(),
+            'payment_meta' => [
+                'res_cd' => '0000',
+                'app_time' => '20260707122519',
+                'pg_raw_response' => [
+                    'res_cd' => '0000',
+                    'tno' => '26438048818473',
+                    'app_no' => '37420127',
+                    'app_time' => '20260707122519',
+                    'card_name' => '롯데카드',
+                ],
+            ],
+        ]);
+
+        DB::table('ecommerce_order_refunds')->insert([
+            'order_id' => $order->id,
+            'order_cancel_id' => null,
+            'refund_number' => 'RF-KCP-' . random_int(10000, 99999),
+            'refund_status' => RefundStatusEnum::COMPLETED->value,
+            'refund_method' => 'pg',
+            'refund_amount' => 1100,
+            'refund_points_amount' => 0,
+            'refund_shipping_amount' => 0,
+            'pg_transaction_id' => '26438048818473',
+            'refunded_at' => now(),
+            'created_at' => now(),
+            'updated_at' => now(),
+        ]);
+
+        $response = $this->actingAs($admin)
+            ->getJson("/api/plugins/sirsoft-pay_nhnkcp/admin/orders/{$order->order_number}/transaction-status");
+
+        $response->assertOk()
+            ->assertJsonPath('data.res_cd', '0000')
+            ->assertJsonPath('data.payment_status', PaymentStatusEnum::CANCELLED->value)
+            ->assertJsonPath('data.cancelled_amount', 1100)
+            ->assertJsonPath('data.cancelled_amount_formatted', '1,100원')
+            ->assertJsonPath('data.refund_status', RefundStatusEnum::COMPLETED->value)
+            ->assertJsonPath('data.refund_pg_transaction_id', '26438048818473');
+
+        $data = $response->json('data');
+        $this->assertContains($data['payment_status_label'] ?? null, ['결제취소', 'Cancelled']);
+        $this->assertContains($data['refund_status_label'] ?? null, ['환불완료', 'Refunded', 'Refund Completed']);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/EscrowCommonNotifyControllerTest.php b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/EscrowCommonNotifyControllerTest.php
new file mode 100644
index 00000000..f18e32f3
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/EscrowCommonNotifyControllerTest.php
@@ -0,0 +1,153 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Tests\Feature\Controllers;
+
+use App\Extension\HookManager;
+use App\Models\User;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderFactory;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderPaymentFactory;
+use Modules\Sirsoft\Ecommerce\Enums\OrderStatusEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentMethodEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentStatusEnum;
+use Modules\Sirsoft\Ecommerce\Models\Order;
+use Plugins\Sirsoft\PayNhnkcp\Tests\PluginTestCase;
+
+class EscrowCommonNotifyControllerTest extends PluginTestCase
+{
+    protected function tearDown(): void
+    {
+        HookManager::resetAll();
+        parent::tearDown();
+    }
+
+    private function createEscrowOrder(string $tno = 'KCP_ESCROW_TNO_REAL'): Order
+    {
+        $user = User::factory()->create();
+        $order = OrderFactory::new()->create([
+            'user_id' => $user->id,
+            'order_status' => OrderStatusEnum::PAYMENT_COMPLETE,
+            'subtotal_amount' => 30000,
+            'total_amount' => 30000,
+            'total_due_amount' => 0,
+            'total_paid_amount' => 30000,
+            'paid_at' => now(),
+        ]);
+
+        OrderPaymentFactory::new()->create([
+            'order_id' => $order->id,
+            'payment_status' => PaymentStatusEnum::PAID,
+            'payment_method' => PaymentMethodEnum::CARD,
+            'pg_provider' => 'nhnkcp',
+            'transaction_id' => $tno,
+            'paid_amount_local' => 30000,
+            'paid_at' => now(),
+            'is_escrow' => true,
+            'payment_meta' => [
+                'site_cd' => 'T0000',
+                'is_test_mode' => true,
+                'escw_yn' => 'Y',
+            ],
+        ]);
+
+        return $order;
+    }
+
+    private function postEscrowNotify(array $payload): \Illuminate\Testing\TestResponse
+    {
+        return $this->withServerVariables(['REMOTE_ADDR' => '203.238.36.58'])
+            ->post('/plugins/sirsoft-pay_nhnkcp/payment/escrow-common-notify', $payload);
+    }
+
+    private function assertKcpNotifyRetry(\Illuminate\Testing\TestResponse $response): void
+    {
+        $response->assertOk();
+        $this->assertStringContainsString('name="result"', $response->getContent());
+        $this->assertStringNotContainsString('value="0000"', $response->getContent());
+    }
+
+    private function assertKcpNotifyOk(\Illuminate\Testing\TestResponse $response): void
+    {
+        $response->assertOk();
+        $this->assertStringContainsString('name="result"', $response->getContent());
+        $this->assertStringContainsString('value="0000"', $response->getContent());
+    }
+
+    public function test_escrow_common_notify_retries_on_tno_mismatch_before_hooks(): void
+    {
+        $order = $this->createEscrowOrder('KCP_ESCROW_TNO_REAL');
+        $hookCalled = false;
+
+        HookManager::addAction(
+            'sirsoft-pay_nhnkcp.escrow.purchase_confirmed',
+            function () use (&$hookCalled): void {
+                $hookCalled = true;
+            }
+        );
+
+        $response = $this->postEscrowNotify([
+            'site_cd' => 'T0000',
+            'tno' => 'ATTACKER_ESCROW_TNO',
+            'order_no' => $order->order_number,
+            'tx_cd' => 'TX02',
+            'cl_status' => '2',
+        ]);
+
+        $this->assertKcpNotifyRetry($response);
+        $this->assertFalse($hookCalled, '검증 실패한 에스크로 통보는 hook 을 발행하지 않아야 합니다.');
+    }
+
+    public function test_escrow_common_notify_processes_matching_tno(): void
+    {
+        $order = $this->createEscrowOrder('KCP_ESCROW_TNO_REAL');
+        $hookCalled = false;
+
+        HookManager::addAction(
+            'sirsoft-pay_nhnkcp.escrow.purchase_confirmed',
+            function () use (&$hookCalled): void {
+                $hookCalled = true;
+            }
+        );
+
+        $response = $this->postEscrowNotify([
+            'site_cd' => 'T0000',
+            'tno' => 'KCP_ESCROW_TNO_REAL',
+            'order_no' => $order->order_number,
+            'tx_cd' => 'TX02',
+            'cl_status' => '2',
+        ]);
+
+        $this->assertKcpNotifyOk($response);
+        $this->assertTrue($hookCalled);
+    }
+
+    public function test_escrow_common_notify_does_not_dispatch_duplicate_payload_twice(): void
+    {
+        $order = $this->createEscrowOrder('KCP_ESCROW_TNO_REAL');
+        $hookCount = 0;
+
+        HookManager::addAction(
+            'sirsoft-pay_nhnkcp.escrow.purchase_confirmed',
+            function () use (&$hookCount): void {
+                $hookCount++;
+            }
+        );
+
+        $payload = [
+            'site_cd' => 'T0000',
+            'tno' => 'KCP_ESCROW_TNO_REAL',
+            'order_no' => $order->order_number,
+            'tx_cd' => 'TX02',
+            'tx_tm' => '20260624164000',
+            'cl_status' => '2',
+        ];
+
+        $first = $this->postEscrowNotify($payload);
+        $second = $this->postEscrowNotify($payload);
+
+        $this->assertKcpNotifyOk($first);
+        $this->assertKcpNotifyOk($second);
+        $this->assertSame(1, $hookCount, '동일 에스크로 통보 replay 는 hook 을 한 번만 발행해야 합니다.');
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/MobileApprovalControllerTest.php b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/MobileApprovalControllerTest.php
new file mode 100644
index 00000000..570df6ed
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/MobileApprovalControllerTest.php
@@ -0,0 +1,458 @@
+<?php
+
+namespace Plugins\Sirsoft\PayNhnkcp\Tests\Feature\Controllers;
+
+use App\Models\User;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderFactory;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderPaymentFactory;
+use Modules\Sirsoft\Ecommerce\Enums\OrderStatusEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentMethodEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentStatusEnum;
+use Modules\Sirsoft\Ecommerce\Models\Order;
+use Plugins\Sirsoft\PayNhnkcp\Services\KcpSoapService;
+use Plugins\Sirsoft\PayNhnkcp\Tests\PluginTestCase;
+
+class MobileApprovalControllerTest extends PluginTestCase
+{
+    private const APPROVAL_KEY_ENDPOINT = '/api/plugins/sirsoft-pay_nhnkcp/mobile/approval-key';
+
+    private const TEST_PAY_URL = 'https://testpay.kcp.co.kr/php/mobile/mc_pay_form.php';
+
+    // ===== 헬퍼 =====
+
+    /**
+     * @param array{taxable?: int, vat?: int, taxFree?: int} $tax
+     */
+    private function createOrder(int $totalAmount = 10000, array $tax = []): Order
+    {
+        $taxable = $tax['taxable'] ?? $totalAmount;
+        $vat     = $tax['vat']     ?? (int) round($taxable * 10 / 110);
+        $taxFree = $tax['taxFree'] ?? 0;
+
+        $user  = User::factory()->create();
+        $order = OrderFactory::new()->create([
+            'user_id'              => $user->id,
+            'order_number'         => 'ORD-MOB-' . random_int(10000, 99999),
+            'order_status'         => OrderStatusEnum::PENDING_ORDER,
+            'subtotal_amount'      => $totalAmount,
+            'total_amount'         => $totalAmount,
+            'total_due_amount'     => $totalAmount,
+            'total_paid_amount'    => 0,
+            'total_tax_amount'     => $taxable,
+            'total_vat_amount'     => $vat,
+            'total_tax_free_amount'=> $taxFree,
+            'currency'             => 'KRW',
+            'currency_snapshot'    => self::krwCurrencySnapshot(),
+        ]);
+
+        OrderPaymentFactory::new()->create([
+            'order_id'       => $order->id,
+            'payment_status' => PaymentStatusEnum::READY,
+            'payment_method' => PaymentMethodEnum::CARD,
+            'pg_provider'    => 'nhnkcp',
+        ]);
+
+        return $order;
+    }
+
+    private static function krwCurrencySnapshot(): array
+    {
+        return [
+            'base_currency' => 'KRW',
+            'order_currency' => 'KRW',
+            'base_unit' => 1,
+            'exchange_rates' => [
+                'KRW' => [
+                    'rate' => 1,
+                    'rounding_unit' => '1',
+                    'rounding_method' => 'round',
+                    'decimal_places' => 0,
+                    'base_unit' => 1,
+                ],
+            ],
+        ];
+    }
+
+    private static function invalidUsdCurrencySnapshot(): array
+    {
+        return [
+            'base_currency' => 'KRW',
+            'order_currency' => 'USD',
+            'base_unit' => 1000,
+            'exchange_rates' => [
+                'KRW' => [
+                    'rate' => 1,
+                    'rounding_unit' => '1',
+                    'rounding_method' => 'round',
+                    'decimal_places' => 0,
+                    'base_unit' => 1000,
+                ],
+                'USD' => [
+                    'rate' => 0,
+                    'rounding_unit' => '0.01',
+                    'rounding_method' => 'round',
+                    'decimal_places' => 2,
+                    'base_unit' => 1,
+                ],
+            ],
+        ];
+    }
+
+    private function mockSoapService(string $approvalKey = 'TEST_APPROVAL_KEY'): void
+    {
+        $mock = $this->createMock(KcpSoapService::class);
+        $mock->method('getApprovalKey')->willReturn([
+            'approval_key' => $approvalKey,
+            'pay_url'      => self::TEST_PAY_URL,
+        ]);
+        $mock->method('getSiteCd')->willReturn('T0000');
+        $mock->method('getEscrowSiteCd')->willReturn('T0000');
+        $this->app->instance(KcpSoapService::class, $mock);
+    }
+
+    private function expectSoapServiceNotCalled(): void
+    {
+        $mock = $this->createMock(KcpSoapService::class);
+        $mock->expects($this->never())->method('getApprovalKey');
+        $this->app->instance(KcpSoapService::class, $mock);
+    }
+
+    private function mockPluginSettings(): void
+    {
+        $mock = $this->createMock(\App\Services\PluginSettingsService::class);
+        $mock->method('get')->willReturn([
+            'is_test_mode'  => true,
+            'test_site_cd'  => 'T0000',
+            'test_site_key' => 'TEST_KEY',
+        ]);
+        $this->app->instance(\App\Services\PluginSettingsService::class, $mock);
+    }
+
+    private function approvalKeyPayload(Order $order, array $overrides = []): array
+    {
+        return array_merge([
+            'order_number' => $order->order_number,
+            'amount'       => (int) $order->total_due_amount,
+            'good_name'    => '테스트 상품',
+            'pay_method'   => 'card',
+            'buyr_name'    => '홍길동',
+            'buyr_mail'    => 'test@test.com',
+            'buyr_tel1'    => '01012345678',
+            'ret_url'      => 'https://example.com/callback',
+        ], $overrides);
+    }
+
+    // ===== 기본 승인키 획득 =====
+
+    public function test_get_approval_key_returns_pay_url_and_fields(): void
+    {
+        $order = $this->createOrder(10000);
+        $this->mockSoapService('APPROVAL_001');
+        $this->mockPluginSettings();
+        $user = $order->user;
+
+        $response = $this->actingAs($user)
+            ->postJson(self::APPROVAL_KEY_ENDPOINT, $this->approvalKeyPayload($order));
+
+        $response->assertOk()
+            ->assertJsonPath('success', true)
+            ->assertJsonPath('data.pay_url', self::TEST_PAY_URL)
+            ->assertJsonPath('data.fields.approval_key', 'APPROVAL_001')
+            ->assertJsonPath('data.fields.ordr_idxx', $order->order_number)
+            ->assertJsonPath('data.fields.good_mny', (string) (int) $order->total_due_amount);
+    }
+
+    public function test_get_approval_key_restores_retryable_cancelled_order(): void
+    {
+        $order = $this->createOrder(10000);
+        $order->update([
+            'order_status' => OrderStatusEnum::CANCELLED,
+            'order_meta' => [
+                'payment_failure_code' => 'USER_CANCEL',
+                'payment_failure_message' => '사용자 취소',
+                'payment_failed_at' => now()->subMinute()->toIso8601String(),
+            ],
+        ]);
+        $order->payment->update([
+            'payment_status' => PaymentStatusEnum::CANCELLED,
+            'cancelled_at' => now()->subMinute(),
+            'paid_at' => null,
+            'transaction_id' => null,
+            'card_approval_number' => null,
+            'payment_meta' => [
+                'failure_source' => 'nhnkcp',
+                'failure_code' => 'USER_CANCEL',
+                'failure_message' => '사용자 취소',
+                'failure_stage' => 'window_closed',
+                'failed_at' => now()->subMinute()->toIso8601String(),
+            ],
+        ]);
+
+        $this->mockSoapService('APPROVAL_RETRY');
+        $this->mockPluginSettings();
+
+        $response = $this->actingAs($order->user)
+            ->postJson(self::APPROVAL_KEY_ENDPOINT, $this->approvalKeyPayload($order));
+
+        $response->assertOk()
+            ->assertJsonPath('data.fields.approval_key', 'APPROVAL_RETRY');
+
+        $order->refresh();
+        $payment = $order->payment;
+        $payment->refresh();
+
+        $this->assertEquals(OrderStatusEnum::PENDING_ORDER, $order->order_status);
+        $this->assertEquals(PaymentStatusEnum::READY, $payment->payment_status);
+        $this->assertNull($payment->cancelled_at);
+    }
+
+    public function test_get_approval_key_returns_422_on_soap_failure(): void
+    {
+        $order = $this->createOrder(10000);
+        $this->mockPluginSettings();
+
+        $mock = $this->createMock(KcpSoapService::class);
+        $mock->method('getApprovalKey')
+            ->willThrowException(new \Plugins\Sirsoft\PayNhnkcp\Exceptions\NhnKcpApiException('KCP SOAP 오류'));
+        $mock->method('getSiteCd')->willReturn('T0000');
+        $this->app->instance(KcpSoapService::class, $mock);
+
+        $response = $this->actingAs($order->user)
+            ->postJson(self::APPROVAL_KEY_ENDPOINT, $this->approvalKeyPayload($order));
+
+        $response->assertStatus(422)
+            ->assertJsonPath('success', false);
+    }
+
+    public function test_get_approval_key_requires_authentication(): void
+    {
+        $order = $this->createOrder(10000);
+        $this->mockSoapService();
+        $this->mockPluginSettings();
+
+        $response = $this->postJson(self::APPROVAL_KEY_ENDPOINT, $this->approvalKeyPayload($order));
+
+        $response->assertUnauthorized();
+    }
+
+    public function test_get_approval_key_rejects_other_users_order(): void
+    {
+        $order = $this->createOrder(10000);
+        $otherUser = User::factory()->create();
+        $this->expectSoapServiceNotCalled();
+        $this->mockPluginSettings();
+
+        $response = $this->actingAs($otherUser)
+            ->postJson(self::APPROVAL_KEY_ENDPOINT, $this->approvalKeyPayload($order));
+
+        $response->assertForbidden()
+            ->assertJsonPath('success', false);
+    }
+
+    public function test_get_approval_key_rejects_amount_mismatch(): void
+    {
+        $order = $this->createOrder(10000);
+        $this->expectSoapServiceNotCalled();
+        $this->mockPluginSettings();
+
+        $response = $this->actingAs($order->user)
+            ->postJson(self::APPROVAL_KEY_ENDPOINT, $this->approvalKeyPayload($order, ['amount' => 9900]));
+
+        $response->assertUnprocessable()
+            ->assertJsonPath('success', false);
+    }
+
+    public function test_get_approval_key_rejects_invalid_payment_currency_without_server_error(): void
+    {
+        $order = $this->createOrder(10000);
+        $order->update([
+            'currency' => 'USD',
+            'currency_snapshot' => self::invalidUsdCurrencySnapshot(),
+        ]);
+        $this->expectSoapServiceNotCalled();
+        $this->mockPluginSettings();
+
+        $response = $this->actingAs($order->user)
+            ->postJson(self::APPROVAL_KEY_ENDPOINT, $this->approvalKeyPayload($order, ['currency' => 'USD']));
+
+        $response->assertUnprocessable()
+            ->assertJsonPath('success', false)
+            ->assertJsonPath('error', 'Payment currency is not chargeable.');
+    }
+
+    public function test_get_approval_key_rejects_non_krw_order(): void
+    {
+        $order = $this->createOrder(10000);
+        $order->currency = 'USD';
+        $order->save();
+        $this->expectSoapServiceNotCalled();
+        $this->mockPluginSettings();
+
+        $response = $this->actingAs($order->user)
+            ->postJson(self::APPROVAL_KEY_ENDPOINT, $this->approvalKeyPayload($order, ['currency' => 'USD']));
+
+        $response->assertUnprocessable()
+            ->assertJsonPath('success', false);
+    }
+
+    public function test_get_approval_key_validates_required_fields(): void
+    {
+        $user = User::factory()->create();
+        $this->mockSoapService();
+        $this->mockPluginSettings();
+
+        $response = $this->actingAs($user)
+            ->postJson(self::APPROVAL_KEY_ENDPOINT, []);
+
+        $response->assertUnprocessable();
+    }
+
+    // ===== 간편결제 direct 파라미터 =====
+
+    public function test_naverpay_easy_pay_includes_direct_field(): void
+    {
+        $order = $this->createOrder(10000);
+        $this->mockSoapService();
+        $this->mockPluginSettings();
+
+        $response = $this->actingAs($order->user)
+            ->postJson(self::APPROVAL_KEY_ENDPOINT, $this->approvalKeyPayload($order, ['pay_method' => 'nhnkcp_naverpay']));
+
+        $response->assertOk()
+            ->assertJsonPath('data.fields.naverpay_direct', 'Y')
+            ->assertJsonPath('data.fields.param_opt_1', 'nhnkcp_naverpay')
+            ->assertJsonPath('data.fields.nhnkcp_easy_pay_method', 'nhnkcp_naverpay');
+    }
+
+    public function test_kakaopay_easy_pay_includes_direct_field(): void
+    {
+        $order = $this->createOrder(10000);
+        $this->mockSoapService();
+        $this->mockPluginSettings();
+
+        $response = $this->actingAs($order->user)
+            ->postJson(self::APPROVAL_KEY_ENDPOINT, $this->approvalKeyPayload($order, ['pay_method' => 'nhnkcp_kakaopay']));
+
+        $response->assertOk()
+            ->assertJsonPath('data.fields.kakaopay_direct', 'Y');
+    }
+
+    // ===== 과세/비과세 분할 필드 =====
+
+    public function test_fully_taxable_order_does_not_include_tax_flag(): void
+    {
+        // 전액 과세 → 복합과세 필드 불필요. KCP가 내부 계산
+        $amount = 11000;
+        $vat    = (int) round($amount * 10 / 110);
+        $order  = $this->createOrder($amount, ['taxable' => $amount, 'vat' => $vat, 'taxFree' => 0]);
+        $this->mockSoapService();
+        $this->mockPluginSettings();
+
+        $response = $this->actingAs($order->user)
+            ->postJson(self::APPROVAL_KEY_ENDPOINT, $this->approvalKeyPayload($order));
+
+        $response->assertOk();
+        $fields = $response->json('data.fields');
+
+        $this->assertArrayNotHasKey('tax_flag', $fields, '전액 과세 시 tax_flag 포함 불필요');
+        $this->assertArrayNotHasKey('comm_tax_mny', $fields);
+        $this->assertArrayNotHasKey('comm_free_mny', $fields);
+    }
+
+    public function test_fully_tax_free_order_includes_comm_free_mny(): void
+    {
+        // 10,000원 전액 비과세 (면세 상품)
+        $amount = 10000;
+        $order  = $this->createOrder($amount, ['taxable' => 0, 'vat' => 0, 'taxFree' => $amount]);
+        $this->mockSoapService();
+        $this->mockPluginSettings();
+
+        $response = $this->actingAs($order->user)
+            ->postJson(self::APPROVAL_KEY_ENDPOINT, $this->approvalKeyPayload($order));
+
+        $response->assertOk();
+        $fields = $response->json('data.fields');
+
+        $this->assertArrayHasKey('tax_flag', $fields);
+        $this->assertEquals('TG03', $fields['tax_flag']);
+        $this->assertEquals('0', $fields['comm_tax_mny'], '공급가액은 0');
+        $this->assertEquals('0', $fields['comm_vat_mny'], '부가세는 0');
+        $this->assertEquals((string) $amount, $fields['comm_free_mny'], '비과세 금액 일치');
+    }
+
+    public function test_mixed_tax_order_includes_all_tax_fields(): void
+    {
+        // 21,000원 = 과세 11,000(공급가 10,000 + 부가세 1,000) + 비과세 10,000
+        $taxable = 11000;
+        $taxFree = 10000;
+        $total   = $taxable + $taxFree;
+        $vat     = (int) round($taxable * 10 / 110); // 1,000
+        $supplyAmt = $taxable - $vat;               // 10,000
+
+        $order = $this->createOrder($total, ['taxable' => $taxable, 'vat' => $vat, 'taxFree' => $taxFree]);
+        $this->mockSoapService();
+        $this->mockPluginSettings();
+
+        $response = $this->actingAs($order->user)
+            ->postJson(self::APPROVAL_KEY_ENDPOINT, $this->approvalKeyPayload($order));
+
+        $response->assertOk();
+        $fields = $response->json('data.fields');
+
+        $this->assertEquals('TG03', $fields['tax_flag']);
+        $this->assertEquals((string) $supplyAmt, $fields['comm_tax_mny'], '공급가액 일치');
+        $this->assertEquals((string) $vat,        $fields['comm_vat_mny'], '부가세 일치');
+        $this->assertEquals((string) $taxFree,     $fields['comm_free_mny'], '비과세 금액 일치');
+
+        // 금액 검증: good_mny = comm_tax_mny + comm_vat_mny + comm_free_mny
+        $this->assertEquals(
+            (string) $total,
+            $fields['good_mny'],
+            'good_mny = 공급가액 + 부가세 + 비과세'
+        );
+    }
+
+    public function test_mixed_tax_fields_are_rebalanced_to_payment_amount(): void
+    {
+        // 원 상품 과세/비과세 합계 21,000원에서 쿠폰/마일리지 등으로 실결제액이 19,000원이 된 상황.
+        $taxable = 11000;
+        $taxFree = 10000;
+        $paymentAmount = 19000;
+        $vat = 1000;
+
+        $order = $this->createOrder($paymentAmount, ['taxable' => $taxable, 'vat' => $vat, 'taxFree' => $taxFree]);
+        $this->mockSoapService();
+        $this->mockPluginSettings();
+
+        $response = $this->actingAs($order->user)
+            ->postJson(self::APPROVAL_KEY_ENDPOINT, $this->approvalKeyPayload($order));
+
+        $response->assertOk();
+        $fields = $response->json('data.fields');
+
+        $this->assertEquals('TG03', $fields['tax_flag']);
+        $this->assertEquals('8182', $fields['comm_tax_mny']);
+        $this->assertEquals('818', $fields['comm_vat_mny']);
+        $this->assertEquals('10000', $fields['comm_free_mny']);
+        $this->assertSame(
+            (int) $fields['good_mny'],
+            (int) $fields['comm_tax_mny'] + (int) $fields['comm_vat_mny'] + (int) $fields['comm_free_mny'],
+            'KCP 복합과세 분할합은 good_mny와 반드시 일치해야 함'
+        );
+    }
+
+    public function test_get_approval_key_rejects_missing_order(): void
+    {
+        $order = $this->createOrder(10000);
+        $this->expectSoapServiceNotCalled();
+        $this->mockPluginSettings();
+
+        $payload = $this->approvalKeyPayload($order, ['order_number' => 'NON-EXISTENT-ORDER']);
+
+        $response = $this->actingAs($order->user)
+            ->postJson(self::APPROVAL_KEY_ENDPOINT, $payload);
+
+        $response->assertNotFound()
+            ->assertJsonPath('success', false);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/PaymentCallbackControllerTest.php b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/PaymentCallbackControllerTest.php
new file mode 100644
index 00000000..6250299b
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/PaymentCallbackControllerTest.php
@@ -0,0 +1,1196 @@
+<?php
+
+namespace Plugins\Sirsoft\PayNhnkcp\Tests\Feature\Controllers;
+
+use App\Models\User;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderFactory;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderPaymentFactory;
+use Modules\Sirsoft\Ecommerce\Enums\OrderStatusEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentMethodEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentStatusEnum;
+use Modules\Sirsoft\Ecommerce\Models\Order;
+use Plugins\Sirsoft\PayNhnkcp\Services\NhnKcpApiService;
+use Plugins\Sirsoft\PayNhnkcp\Tests\PluginTestCase;
+
+class PaymentCallbackControllerTest extends PluginTestCase
+{
+    private const TEST_SITE_CD = 'T0000';
+
+    private const TEST_SITE_KEY = 'TEST_SITE_KEY_0000';
+
+    // ===== 헬퍼 =====
+
+    private function makeCliResponse(string $tno, string $ordrIdxx, int $amount, string $resCd = '0000'): array
+    {
+        return [
+            'res_cd'          => $resCd,
+            'res_msg'         => $resCd === '0000' ? '정상처리' : '승인실패',
+            'tno'             => $tno,
+            'ordr_idxx'       => $ordrIdxx,
+            'good_mny'        => $amount,
+            'app_no'          => 'APP12345',
+            'card_no'         => '4330****1234',
+            'card_name'       => '신한카드',
+            'quota'           => '00',
+            'use_pay_method'  => 'CARD',
+            'app_time'        => now()->format('YmdHis'),
+        ];
+    }
+
+    /**
+     * @param array{taxable?: int, vat?: int, taxFree?: int} $tax
+     */
+    private function createTestOrder(
+        int $totalAmount = 50000,
+        array $tax = [],
+        PaymentMethodEnum $paymentMethod = PaymentMethodEnum::CARD,
+    ): Order {
+        $taxable = $tax['taxable'] ?? $totalAmount;
+        $vat     = $tax['vat']     ?? (int) round($taxable * 10 / 110);
+        $taxFree = $tax['taxFree'] ?? 0;
+
+        $user = User::factory()->create();
+
+        $order = OrderFactory::new()->create([
+            'user_id'                            => $user->id,
+            'order_number'                       => 'ORD-TEST-' . random_int(10000, 99999),
+            'order_status'                       => OrderStatusEnum::PENDING_ORDER,
+            'subtotal_amount'                    => $totalAmount,
+            'total_discount_amount'              => 0,
+            'total_coupon_discount_amount'       => 0,
+            'total_product_coupon_discount_amount' => 0,
+            'total_order_coupon_discount_amount' => 0,
+            'total_code_discount_amount'         => 0,
+            'base_shipping_amount'               => 0,
+            'extra_shipping_amount'              => 0,
+            'shipping_discount_amount'           => 0,
+            'total_shipping_amount'              => 0,
+            'total_amount'                       => $totalAmount,
+            'total_due_amount'                   => $totalAmount,
+            'total_points_used_amount'           => 0,
+            'total_deposit_used_amount'          => 0,
+            'total_paid_amount'                  => 0,
+            'total_tax_amount'                   => $taxable,
+            'total_vat_amount'                   => $vat,
+            'total_tax_free_amount'              => $taxFree,
+            'currency'                           => 'KRW',
+            'currency_snapshot'                  => self::krwCurrencySnapshot(),
+        ]);
+
+        OrderPaymentFactory::new()->create([
+            'order_id'             => $order->id,
+            'payment_status'       => PaymentStatusEnum::READY,
+            'payment_method'       => $paymentMethod,
+            'pg_provider'          => 'nhnkcp',
+            'paid_amount_local'    => 0,
+            'paid_at'              => null,
+            'transaction_id'       => null,
+            'card_approval_number' => null,
+        ]);
+
+        return $order;
+    }
+
+    private static function krwCurrencySnapshot(): array
+    {
+        return [
+            'base_currency' => 'KRW',
+            'order_currency' => 'KRW',
+            'base_unit' => 1,
+            'exchange_rates' => [
+                'KRW' => [
+                    'rate' => 1,
+                    'rounding_unit' => '1',
+                    'rounding_method' => 'round',
+                    'decimal_places' => 0,
+                    'base_unit' => 1,
+                ],
+            ],
+        ];
+    }
+
+    private static function invalidUsdCurrencySnapshot(): array
+    {
+        return [
+            'base_currency' => 'KRW',
+            'order_currency' => 'USD',
+            'base_unit' => 1000,
+            'exchange_rates' => [
+                'KRW' => [
+                    'rate' => 1,
+                    'rounding_unit' => '1',
+                    'rounding_method' => 'round',
+                    'decimal_places' => 0,
+                    'base_unit' => 1000,
+                ],
+                'USD' => [
+                    'rate' => 0,
+                    'rounding_unit' => '0.01',
+                    'rounding_method' => 'round',
+                    'decimal_places' => 2,
+                    'base_unit' => 1,
+                ],
+            ],
+        ];
+    }
+
+    private function mockPluginSettings(array $overrides = []): void
+    {
+        $defaults = [
+            'is_test_mode'         => true,
+            'test_site_cd'         => self::TEST_SITE_CD,
+            'test_site_key'        => self::TEST_SITE_KEY,
+            'live_site_cd'         => '',
+            'live_site_key'        => '',
+            'redirect_success_url' => '/shop/orders/{orderId}/complete',
+            'redirect_fail_url'    => '/shop/checkout',
+        ];
+
+        $mock = $this->createMock(\App\Services\PluginSettingsService::class);
+        $mock->method('get')->willReturn(array_merge($defaults, $overrides));
+        $this->app->instance(\App\Services\PluginSettingsService::class, $mock);
+    }
+
+    /**
+     * NhnKcpApiService::approvePayment() 를 exec() 없이 mock.
+     * 기존 테스트는 Http::fake()로 CLI exec를 막으려 했으나 동작하지 않음.
+     */
+    private function mockApiService(array $cliResponse, ?int $approveCalls = null): void
+    {
+        $mock = $this->createMock(NhnKcpApiService::class);
+        $expectation = $approveCalls === null
+            ? $mock->method('approvePayment')
+            : $mock->expects($this->exactly($approveCalls))->method('approvePayment');
+        $expectation->willReturn($cliResponse);
+        $this->app->instance(NhnKcpApiService::class, $mock);
+    }
+
+    private function makeCallbackParams(string $ordrIdxx, int $goodMny, array $overrides = []): array
+    {
+        return array_merge([
+            'res_cd'          => '0000',
+            'res_msg'         => '정상처리',
+            'tno'             => 'KCP_TNO_' . uniqid(),
+            'ordr_idxx'       => $ordrIdxx,
+            'good_mny'        => $goodMny,
+            'enc_data'        => base64_encode('encrypted_payment_data'),
+            'enc_info'        => base64_encode('encrypted_info'),
+            'use_pay_method'  => 'CARD',
+        ], $overrides);
+    }
+
+    private function markVbankIssued(
+        Order $order,
+        string $tno = 'KCP_VBANK_TNO_ISSUED',
+        string $account = 'T1234567890',
+    ): void {
+        $order->payment->update([
+            'transaction_id' => $tno,
+            'vbank_name' => '테스트은행',
+            'vbank_number' => $account,
+            'vbank_holder' => 'NHN KCP',
+            'vbank_issued_at' => now(),
+            'payment_meta' => [
+                'tno' => $tno,
+                'site_cd' => self::TEST_SITE_CD,
+                'is_test_mode' => true,
+                'pg_response_sanitized' => true,
+                'pg_raw_response' => [
+                    'res_cd' => 'V000',
+                    'tno' => $tno,
+                    'bankname' => '테스트은행',
+                ],
+            ],
+        ]);
+    }
+
+    // ===== 성공 콜백 =====
+
+    public function test_auth_callback_redirects_to_complete_page_on_valid_payment(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $this->mockPluginSettings();
+
+        $tno = 'KCP_TNO_' . uniqid();
+        $this->mockApiService($this->makeCliResponse($tno, $order->order_number, 50000));
+
+        $response = $this->post(
+            '/plugins/sirsoft-pay_nhnkcp/payment/callback',
+            $this->makeCallbackParams($order->order_number, 50000, ['tno' => $tno])
+        );
+
+        $response->assertRedirect("/shop/orders/{$order->order_number}/complete");
+        $order->refresh();
+        $this->assertEquals(OrderStatusEnum::PAYMENT_COMPLETE, $order->order_status);
+
+        $payment = $order->payment;
+        $payment->refresh();
+        $this->assertEquals($tno, $payment->transaction_id);
+        $this->assertEquals('APP12345', $payment->card_approval_number);
+    }
+
+    public function test_auth_callback_stores_easy_pay_method_meta(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $this->mockPluginSettings();
+
+        $tno = 'KCP_TNO_NAVERPAY';
+        $this->mockApiService($this->makeCliResponse($tno, $order->order_number, 50000));
+
+        $response = $this->post(
+            '/plugins/sirsoft-pay_nhnkcp/payment/callback',
+            $this->makeCallbackParams($order->order_number, 50000, [
+                'tno' => $tno,
+                'param_opt_1' => 'nhnkcp_naverpay',
+                'nhnkcp_easy_pay_method' => 'nhnkcp_naverpay',
+            ])
+        );
+
+        $response->assertRedirect("/shop/orders/{$order->order_number}/complete");
+
+        $payment = $order->payment;
+        $payment->refresh();
+        $meta = $payment->payment_meta;
+
+        $this->assertSame('naverpay', $payment->embedded_pg_provider);
+        $this->assertSame('nhnkcp_naverpay', $meta['nhnkcp_easy_pay_method'] ?? null);
+        $this->assertSame('naverpay', $meta['nhnkcp_easy_pay_provider'] ?? null);
+        $this->assertSame('네이버페이', $meta['nhnkcp_easy_pay_label']['ko'] ?? null);
+        $this->assertSame('NaverPay', $meta['nhnkcp_easy_pay_label']['en'] ?? null);
+    }
+
+    public function test_auth_callback_skips_cli_approval_when_order_already_paid(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $this->mockPluginSettings();
+
+        $existingTno = 'KCP_TNO_ALREADY_PAID';
+        $order->update([
+            'order_status' => OrderStatusEnum::PAYMENT_COMPLETE,
+            'paid_at' => now(),
+            'total_paid_amount' => 50000,
+            'total_due_amount' => 0,
+        ]);
+        $order->payment->update([
+            'payment_status' => PaymentStatusEnum::PAID,
+            'paid_at' => now(),
+            'paid_amount_local' => 50000,
+            'paid_amount_base' => 50000,
+            'transaction_id' => $existingTno,
+            'card_approval_number' => 'APP_ALREADY',
+        ]);
+
+        $this->mockApiService($this->makeCliResponse('KCP_TNO_SHOULD_NOT_APPROVE', $order->order_number, 50000), 0);
+
+        $response = $this->post(
+            '/plugins/sirsoft-pay_nhnkcp/payment/callback',
+            $this->makeCallbackParams($order->order_number, 50000, ['tno' => $existingTno])
+        );
+
+        $response->assertRedirect("/shop/orders/{$order->order_number}/complete");
+
+        $payment = $order->payment;
+        $payment->refresh();
+        $this->assertSame($existingTno, $payment->transaction_id);
+        $this->assertSame('APP_ALREADY', $payment->card_approval_number);
+    }
+
+    public function test_auth_callback_rejects_browser_amount_mismatch_before_cli_approval(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $this->mockPluginSettings();
+
+        $mock = $this->createMock(NhnKcpApiService::class);
+        $mock->expects($this->never())->method('approvePayment');
+        $this->app->instance(NhnKcpApiService::class, $mock);
+
+        $response = $this->post(
+            '/plugins/sirsoft-pay_nhnkcp/payment/callback',
+            $this->makeCallbackParams($order->order_number, 1)
+        );
+
+        $response->assertRedirect();
+        $this->assertStringContainsString('error=amount_mismatch', $response->headers->get('Location'));
+
+        $order->refresh();
+        $this->assertNotEquals(OrderStatusEnum::PAYMENT_COMPLETE, $order->order_status);
+    }
+
+    public function test_auth_callback_rejects_non_krw_order_before_cli_approval(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $order->currency = 'USD';
+        $order->save();
+        $this->mockPluginSettings();
+
+        $mock = $this->createMock(NhnKcpApiService::class);
+        $mock->expects($this->never())->method('approvePayment');
+        $this->app->instance(NhnKcpApiService::class, $mock);
+
+        $response = $this->post(
+            '/plugins/sirsoft-pay_nhnkcp/payment/callback',
+            $this->makeCallbackParams($order->order_number, 50000)
+        );
+
+        $response->assertRedirect();
+        $this->assertStringContainsString('error=currency_not_supported', $response->headers->get('Location'));
+
+        $order->refresh();
+        $this->assertEquals(OrderStatusEnum::PENDING_ORDER, $order->order_status);
+    }
+
+    public function test_auth_callback_rejects_invalid_payment_currency_before_cli_approval(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $order->update([
+            'currency' => 'USD',
+            'currency_snapshot' => self::invalidUsdCurrencySnapshot(),
+        ]);
+        $this->mockPluginSettings();
+
+        $mock = $this->createMock(NhnKcpApiService::class);
+        $mock->expects($this->never())->method('approvePayment');
+        $this->app->instance(NhnKcpApiService::class, $mock);
+
+        $response = $this->post(
+            '/plugins/sirsoft-pay_nhnkcp/payment/callback',
+            $this->makeCallbackParams($order->order_number, 50000)
+        );
+
+        $response->assertRedirect();
+        $this->assertStringContainsString('error=invalid_payment_currency', $response->headers->get('Location'));
+
+        $order->refresh();
+        $this->assertEquals(OrderStatusEnum::PENDING_ORDER, $order->order_status);
+        $this->assertEquals(PaymentStatusEnum::READY, $order->payment->payment_status);
+    }
+
+    public function test_auth_callback_stores_only_sanitized_pg_response_fields(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $this->mockPluginSettings();
+
+        $tno = 'KCP_TNO_SANITIZED';
+        $this->mockApiService(array_merge(
+            $this->makeCliResponse($tno, $order->order_number, 50000),
+            [
+                'buyr_name' => '홍길동',
+                'buyr_mail' => 'buyer@example.test',
+                'buyr_tel1' => '01012345678',
+                'account' => '1234567890123456',
+                'unexpected_sensitive' => 'store-me-not',
+            ]
+        ));
+
+        $response = $this->post(
+            '/plugins/sirsoft-pay_nhnkcp/payment/callback',
+            $this->makeCallbackParams($order->order_number, 50000, ['tno' => $tno])
+        );
+
+        $response->assertRedirect("/shop/orders/{$order->order_number}/complete");
+
+        $payment = $order->payment;
+        $payment->refresh();
+
+        $meta = $payment->payment_meta;
+        $this->assertTrue($meta['pg_response_sanitized'] ?? false);
+        $this->assertSame($tno, $meta['pg_raw_response']['tno'] ?? null);
+        $this->assertSame('APP12345', $meta['pg_raw_response']['app_no'] ?? null);
+        $this->assertArrayNotHasKey('card_no', $meta['pg_raw_response']);
+        $this->assertArrayNotHasKey('buyr_name', $meta['pg_raw_response']);
+        $this->assertArrayNotHasKey('buyr_mail', $meta['pg_raw_response']);
+        $this->assertArrayNotHasKey('buyr_tel1', $meta['pg_raw_response']);
+        $this->assertArrayNotHasKey('account', $meta['pg_raw_response']);
+        $this->assertArrayNotHasKey('unexpected_sensitive', $meta['pg_raw_response']);
+    }
+
+    // ===== 과세/비과세 시나리오 =====
+
+    public function test_fully_taxable_order_payment_completes(): void
+    {
+        // 11,000원 = 공급가 10,000 + 부가세 1,000 (전액 과세)
+        $amount = 11000;
+        $vat    = (int) round($amount * 10 / 110); // 1,000
+        $order  = $this->createTestOrder($amount, ['taxable' => $amount, 'vat' => $vat, 'taxFree' => 0]);
+        $this->mockPluginSettings();
+
+        $tno = 'KCP_TNO_TAXABLE';
+        $this->mockApiService($this->makeCliResponse($tno, $order->order_number, $amount));
+
+        $response = $this->post(
+            '/plugins/sirsoft-pay_nhnkcp/payment/callback',
+            $this->makeCallbackParams($order->order_number, $amount, ['tno' => $tno])
+        );
+
+        $response->assertRedirect("/shop/orders/{$order->order_number}/complete");
+        $order->refresh();
+        $this->assertEquals(OrderStatusEnum::PAYMENT_COMPLETE, $order->order_status);
+
+        $payment = $order->payment;
+        $payment->refresh();
+        $this->assertEquals($tno, $payment->transaction_id);
+    }
+
+    public function test_fully_tax_free_order_payment_completes(): void
+    {
+        // 10,000원 전액 비과세 (도서, 농산물, 의료 등 면세 상품)
+        $amount = 10000;
+        $order  = $this->createTestOrder($amount, ['taxable' => 0, 'vat' => 0, 'taxFree' => $amount]);
+        $this->mockPluginSettings();
+
+        $tno = 'KCP_TNO_TAXFREE';
+        $this->mockApiService($this->makeCliResponse($tno, $order->order_number, $amount));
+
+        $response = $this->post(
+            '/plugins/sirsoft-pay_nhnkcp/payment/callback',
+            $this->makeCallbackParams($order->order_number, $amount, ['tno' => $tno])
+        );
+
+        $response->assertRedirect("/shop/orders/{$order->order_number}/complete");
+        $order->refresh();
+        $this->assertEquals(OrderStatusEnum::PAYMENT_COMPLETE, $order->order_status);
+
+        // 비과세 주문도 paid_amount 가 올바르게 기록돼야 함
+        $payment = $order->payment;
+        $payment->refresh();
+        $this->assertEquals($tno, $payment->transaction_id);
+    }
+
+    public function test_mixed_tax_order_payment_completes(): void
+    {
+        // 21,000원 = 과세 11,000(공급가 10,000 + 부가세 1,000) + 비과세 10,000
+        $taxable = 11000;
+        $taxFree = 10000;
+        $total   = $taxable + $taxFree;
+        $vat     = (int) round($taxable * 10 / 110); // 1,000
+        $order   = $this->createTestOrder($total, ['taxable' => $taxable, 'vat' => $vat, 'taxFree' => $taxFree]);
+        $this->mockPluginSettings();
+
+        $tno = 'KCP_TNO_MIXED';
+        $this->mockApiService($this->makeCliResponse($tno, $order->order_number, $total));
+
+        $response = $this->post(
+            '/plugins/sirsoft-pay_nhnkcp/payment/callback',
+            $this->makeCallbackParams($order->order_number, $total, ['tno' => $tno])
+        );
+
+        $response->assertRedirect("/shop/orders/{$order->order_number}/complete");
+        $order->refresh();
+        $this->assertEquals(OrderStatusEnum::PAYMENT_COMPLETE, $order->order_status);
+    }
+
+    // ===== 실패/취소 =====
+
+    public function test_auth_callback_redirects_to_fail_on_res_cd_not_0000(): void
+    {
+        $this->mockPluginSettings();
+
+        $response = $this->post('/plugins/sirsoft-pay_nhnkcp/payment/callback', $this->makeCallbackParams('ORD-TEST-99999', 50000, [
+            'res_cd'  => '8001',
+            'res_msg' => '사용자 취소',
+        ]));
+
+        $response->assertRedirect();
+        $this->assertStringContainsString('error=8001', $response->headers->get('Location'));
+    }
+
+    public function test_auth_callback_silently_redirects_on_user_cancel_code_3001(): void
+    {
+        $this->mockPluginSettings();
+
+        $response = $this->post('/plugins/sirsoft-pay_nhnkcp/payment/callback', [
+            'res_cd'   => '3001',
+            'res_msg'  => '사용자취소',
+            'ordr_idxx' => 'ORD-TEST-CANCEL',
+        ]);
+
+        $response->assertRedirect('/shop/checkout');
+        $this->assertStringNotContainsString('error=', $response->headers->get('Location'));
+    }
+
+    public function test_auth_callback_does_not_mutate_order_on_browser_failure_result(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $this->mockPluginSettings();
+
+        $response = $this->post('/plugins/sirsoft-pay_nhnkcp/payment/callback', [
+            'res_cd' => '3001',
+            'res_msg' => '사용자취소',
+            'ordr_idxx' => $order->order_number,
+            'good_mny' => 50000,
+        ]);
+
+        $response->assertRedirect('/shop/checkout');
+        $this->assertStringNotContainsString('error=', $response->headers->get('Location'));
+
+        $order->refresh();
+        $this->assertEquals(OrderStatusEnum::PENDING_ORDER, $order->order_status);
+        $this->assertNull($order->order_meta['payment_failure_code'] ?? null);
+        $this->assertEquals(PaymentStatusEnum::READY, $order->payment->payment_status);
+        $this->assertNull($order->payment->cancelled_at);
+        $this->assertSame('nhnkcp', $order->payment->pg_provider);
+        $this->assertNull($order->payment->payment_meta['failure_source'] ?? null);
+        $this->assertNull($order->payment->payment_meta['failure_code'] ?? null);
+        $this->assertNull($order->payment->payment_meta['failure_stage'] ?? null);
+    }
+
+    public function test_auth_callback_silently_redirects_on_empty_res_cd(): void
+    {
+        $this->mockPluginSettings();
+
+        $response = $this->post('/plugins/sirsoft-pay_nhnkcp/payment/callback', [
+            'res_cd'    => '',
+            'ordr_idxx' => 'ORD-TEST-EMPTY',
+        ]);
+
+        $response->assertRedirect('/shop/checkout');
+        $this->assertStringNotContainsString('error=', $response->headers->get('Location'));
+    }
+
+    public function test_auth_callback_redirects_to_fail_on_order_not_found(): void
+    {
+        $this->mockPluginSettings();
+        $this->mockApiService($this->makeCliResponse('TNO_X', 'NON_EXISTENT', 50000));
+
+        $response = $this->post(
+            '/plugins/sirsoft-pay_nhnkcp/payment/callback',
+            $this->makeCallbackParams('NON_EXISTENT_ORDER', 50000)
+        );
+
+        $response->assertRedirect();
+        $this->assertStringContainsString('error=order_not_found', $response->headers->get('Location'));
+    }
+
+    public function test_auth_callback_redirects_to_fail_when_cli_approval_fails(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $this->mockPluginSettings();
+        $this->mockApiService($this->makeCliResponse('TNO_FAIL', $order->order_number, 50000, '9999'));
+
+        $response = $this->post(
+            '/plugins/sirsoft-pay_nhnkcp/payment/callback',
+            $this->makeCallbackParams($order->order_number, 50000)
+        );
+
+        $response->assertRedirect();
+        $this->assertStringContainsString('error=9999', $response->headers->get('Location'));
+
+        $order->refresh();
+        $payment = $order->payment;
+        $payment->refresh();
+
+        $this->assertEquals(OrderStatusEnum::CANCELLED, $order->order_status);
+        $this->assertEquals(PaymentStatusEnum::FAILED, $payment->payment_status);
+        $this->assertSame('nhnkcp', $payment->payment_meta['failure_source'] ?? null);
+        $this->assertSame('9999', $payment->payment_meta['failure_code'] ?? null);
+        $this->assertSame('approval_failed', $payment->payment_meta['failure_stage'] ?? null);
+    }
+
+    public function test_auth_callback_records_amount_mismatch_as_non_retryable_kcp_failure(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $this->mockPluginSettings();
+
+        $tno = 'KCP_TNO_AMOUNT_MISMATCH';
+        $this->mockApiService($this->makeCliResponse($tno, $order->order_number, 60000));
+
+        $response = $this->post(
+            '/plugins/sirsoft-pay_nhnkcp/payment/callback',
+            $this->makeCallbackParams($order->order_number, 60000, ['tno' => $tno])
+        );
+
+        $response->assertRedirect();
+        $this->assertStringContainsString('error=amount_mismatch', $response->headers->get('Location'));
+
+        $order->refresh();
+        $payment = $order->payment;
+        $payment->refresh();
+
+        $this->assertEquals(OrderStatusEnum::CANCELLED, $order->order_status);
+        $this->assertEquals(PaymentStatusEnum::FAILED, $payment->payment_status);
+        $this->assertSame('nhnkcp', $payment->payment_meta['failure_source'] ?? null);
+        $this->assertSame('AMOUNT_MISMATCH', $payment->payment_meta['failure_code'] ?? null);
+        $this->assertSame('amount_mismatch', $payment->payment_meta['failure_stage'] ?? null);
+    }
+
+    public function test_auth_callback_redirects_to_fail_url_on_missing_params(): void
+    {
+        $this->mockPluginSettings();
+
+        $response = $this->post('/plugins/sirsoft-pay_nhnkcp/payment/callback', [
+            'res_cd' => '0000',
+        ]);
+
+        $response->assertRedirect();
+        $this->assertStringContainsString('error=invalid_params', $response->headers->get('Location'));
+    }
+
+    public function test_auth_callback_redirects_to_custom_success_url(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $this->mockPluginSettings(['redirect_success_url' => '/custom/payment/{orderId}/done']);
+
+        $tno = 'KCP_TNO_CUSTOM';
+        $this->mockApiService($this->makeCliResponse($tno, $order->order_number, 50000));
+
+        $response = $this->post(
+            '/plugins/sirsoft-pay_nhnkcp/payment/callback',
+            $this->makeCallbackParams($order->order_number, 50000, ['tno' => $tno])
+        );
+
+        $response->assertRedirect("/custom/payment/{$order->order_number}/done");
+    }
+
+    public function test_auth_callback_detects_mobile_device(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $this->mockPluginSettings();
+
+        $tno = 'KCP_TNO_MOBILE';
+        $this->mockApiService($this->makeCliResponse($tno, $order->order_number, 50000));
+
+        $response = $this->post(
+            '/plugins/sirsoft-pay_nhnkcp/payment/callback',
+            $this->makeCallbackParams($order->order_number, 50000, ['tno' => $tno]),
+            ['User-Agent' => 'Mozilla/5.0 (iPhone; CPU iPhone OS 16_0 like Mac OS X)']
+        );
+
+        $response->assertRedirect("/shop/orders/{$order->order_number}/complete");
+        $payment = $order->payment;
+        $payment->refresh();
+        $this->assertEquals('mobile', $payment->payment_device);
+    }
+
+    // ===== 가상계좌 입금 통보 (KCP 공식 webhook 페이로드) =====
+    //
+    // 페이로드 키 (그누보드5 settle_kcp_common.php 참고):
+    //   tx_cd=TX00 + op_cd=50 (입금완료) / 01 (재전송) / 13 (망취소)
+    //   tno, order_no, ipgm_mnyx, ipgm_name, remitter, bank_code, account, noti_id
+    //
+    // 응답: <form><input name="result" value="0000"> HTML
+    //   - result=0000 → KCP 가 통보 성공으로 인정 (재시도 차단)
+    //   - 그 외 → KCP 재통보 (최대 10회)
+
+    private function assertKcpNotifyOk(\Illuminate\Testing\TestResponse $response): void
+    {
+        $response->assertOk();
+        $this->assertStringContainsString('name="result"', $response->getContent());
+        $this->assertStringContainsString('value="0000"', $response->getContent());
+    }
+
+    private function assertKcpNotifyRetry(\Illuminate\Testing\TestResponse $response): void
+    {
+        $response->assertOk();
+        $this->assertStringContainsString('name="result"', $response->getContent());
+        $this->assertStringNotContainsString('value="0000"', $response->getContent());
+    }
+
+    private function makeVbankNotifyPayload(string $orderNo, int $amount, array $overrides = []): array
+    {
+        return array_merge([
+            'site_cd'    => 'T0000',
+            'tno'        => 'KCP_VBANK_TNO_' . uniqid(),
+            'order_no'   => $orderNo,
+            'tx_cd'      => 'TX00',
+            'tx_tm'      => now()->format('YmdHis'),
+            'op_cd'      => '50',
+            'ipgm_mnyx'  => $amount,
+            'ipgm_name'  => '홍길동',
+            'remitter'   => '홍길동',
+            'bank_code'  => 'BK04',
+            'account'    => 'T1234567890',
+            'noti_id'    => uniqid('NOTI_'),
+        ], $overrides);
+    }
+
+    /**
+     * KCP 공식 발신 IP 로 vbank-notify POST.
+     * RestrictKcpIp 미들웨어가 항상 IP 검증하므로 화이트리스트 IP 필수.
+     */
+    private function postVbankNotify(array $payload, string $kcpIp = '203.238.36.58'): \Illuminate\Testing\TestResponse
+    {
+        return $this->withServerVariables(['REMOTE_ADDR' => $kcpIp])
+            ->post('/plugins/sirsoft-pay_nhnkcp/payment/vbank-notify', $payload);
+    }
+
+    public function test_vbank_notify_completes_payment_on_op_cd_50(): void
+    {
+        $order = $this->createTestOrder(30000, [], PaymentMethodEnum::VBANK);
+        $this->markVbankIssued($order, 'KCP_VBANK_TNO_50');
+
+        $response = $this->postVbankNotify(
+            $this->makeVbankNotifyPayload($order->order_number, 30000, [
+                'op_cd' => '50',
+                'tno' => 'KCP_VBANK_TNO_50',
+            ])
+        );
+
+        $this->assertKcpNotifyOk($response);
+
+        $order->refresh();
+        $this->assertEquals(OrderStatusEnum::PAYMENT_COMPLETE, $order->order_status);
+    }
+
+    /**
+     * 멱등성 — op_cd=01 (재전송) 시 이미 결제완료 상태이면 0000 응답으로 차단.
+     */
+    public function test_vbank_notify_idempotent_on_op_cd_01_resend(): void
+    {
+        $order = $this->createTestOrder(30000, [], PaymentMethodEnum::VBANK);
+        $this->markVbankIssued($order, 'KCP_VBANK_TNO_RESEND');
+
+        // 첫 통보 — 입금완료
+        $this->postVbankNotify(
+            $this->makeVbankNotifyPayload($order->order_number, 30000, [
+                'op_cd' => '50',
+                'tno' => 'KCP_VBANK_TNO_RESEND',
+            ])
+        );
+
+        // 두 번째 — 재전송 (op_cd=01), 동일 noti_id 가정
+        $response = $this->postVbankNotify(
+            $this->makeVbankNotifyPayload($order->order_number, 30000, [
+                'op_cd' => '01',
+                'tno' => 'KCP_VBANK_TNO_RESEND',
+            ])
+        );
+
+        $this->assertKcpNotifyOk($response);
+    }
+
+    /**
+     * KCP testadmin 모의입금 통보는 op_cd=18 을 발신 (KCP 공식 문서엔 명시 없음, 실제 운영 확인).
+     * 그누보드5 와 동일하게 op_cd=13 (망취소) 외에는 모두 입금완료 처리.
+     */
+    public function test_vbank_notify_completes_payment_on_op_cd_18_testadmin(): void
+    {
+        $order = $this->createTestOrder(30000, [], PaymentMethodEnum::VBANK);
+        $this->markVbankIssued($order, 'KCP_VBANK_TNO_TESTADMIN');
+
+        $response = $this->postVbankNotify(
+            $this->makeVbankNotifyPayload($order->order_number, 30000, [
+                'tno' => 'KCP_VBANK_TNO_TESTADMIN',
+                'op_cd' => '18',
+                'ipgm_stat' => 'STIY',
+            ])
+        );
+
+        $this->assertKcpNotifyOk($response);
+
+        $order->refresh();
+        $this->assertEquals(OrderStatusEnum::PAYMENT_COMPLETE, $order->order_status);
+    }
+
+    /**
+     * 망취소 — op_cd=13 시 로깅만 하고 0000 응답 (정책 미정, 자동 취소 안 함).
+     */
+    public function test_vbank_notify_logs_op_cd_13_cancel(): void
+    {
+        $order = $this->createTestOrder(30000, [], PaymentMethodEnum::VBANK);
+        $this->markVbankIssued($order, 'KCP_VBANK_TNO_CANCELLED');
+
+        $response = $this->postVbankNotify(
+            $this->makeVbankNotifyPayload($order->order_number, 30000, [
+                'op_cd' => '13',
+                'tno' => 'KCP_VBANK_TNO_CANCELLED',
+            ])
+        );
+
+        $this->assertKcpNotifyOk($response);
+
+        $order->refresh();
+        // 망취소는 결제완료로 전환하지 않음
+        $this->assertNotEquals(OrderStatusEnum::PAYMENT_COMPLETE, $order->order_status);
+    }
+
+    /**
+     * tx_cd 가 TX00 외 (예: TX01 환불, TX02 구매확인) 일 때 무시 + 0000 응답.
+     * KCP 가 단일 webhook URL 로 모든 tx_cd 를 보낼 가능성에 대비.
+     */
+    public function test_vbank_notify_ignores_non_tx00(): void
+    {
+        $response = $this->postVbankNotify(
+            $this->makeVbankNotifyPayload('ANY-ORDER', 30000, ['tx_cd' => 'TX01'])
+        );
+
+        $this->assertKcpNotifyOk($response);
+    }
+
+    /**
+     * 주문 없음 — 영구 실패라 재시도 의미 없음, 0000 응답으로 KCP 재통보 차단.
+     */
+    public function test_vbank_notify_returns_ok_on_order_not_found(): void
+    {
+        $response = $this->postVbankNotify(
+            $this->makeVbankNotifyPayload('NON_EXISTENT_ORDER', 30000)
+        );
+
+        $this->assertKcpNotifyOk($response);
+    }
+
+    /**
+     * 회귀: 그누보드5 settle_kcp_common.php 와 동일한 KCP 공식 페이로드(order_no/ipgm_mnyx/op_cd)
+     * 를 사용해야 함. 옛 키(ordr_idxx/good_mny/res_cd) 사용 시 FormRequest 단계 422 차단.
+     *
+     * 본 테스트는 실제 KCP 가 보낼 페이로드가 정상 처리됨을 보장.
+     */
+    public function test_vbank_notify_accepts_kcp_official_payload(): void
+    {
+        $order = $this->createTestOrder(50000, [], PaymentMethodEnum::VBANK);
+        $this->markVbankIssued($order, 'KCP_TNO_REAL', 'T9876543210');
+
+        $response = $this->postVbankNotify([
+            'site_cd'   => 'T0000',
+            'tno'       => 'KCP_TNO_REAL',
+            'order_no'  => $order->order_number,
+            'tx_cd'     => 'TX00',
+            'tx_tm'     => '20260514120000',
+            'op_cd'     => '50',
+            'ipgm_mnyx' => 50000,
+            'ipgm_name' => '홍길동',
+            'remitter'  => '실입금자',
+            'bank_code' => '04',
+            'account'   => 'T9876543210',
+            'noti_id'   => '26051412000018046532',
+        ]);
+
+        $this->assertKcpNotifyOk($response);
+
+        $order->refresh();
+        $this->assertEquals(OrderStatusEnum::PAYMENT_COMPLETE, $order->order_status);
+    }
+
+    public function test_vbank_notify_stores_only_sanitized_pg_response_fields(): void
+    {
+        $order = $this->createTestOrder(50000, [], PaymentMethodEnum::VBANK);
+        $this->markVbankIssued($order, 'KCP_VBANK_TNO_SANITIZED', 'T9876543210');
+
+        $response = $this->postVbankNotify(
+            $this->makeVbankNotifyPayload($order->order_number, 50000, [
+                'tno' => 'KCP_VBANK_TNO_SANITIZED',
+                'ipgm_name' => '실입금자',
+                'remitter' => '송금자',
+                'account' => 'T9876543210',
+                'unexpected_sensitive' => 'store-me-not',
+            ])
+        );
+
+        $this->assertKcpNotifyOk($response);
+
+        $payment = $order->payment;
+        $payment->refresh();
+
+        $meta = $payment->payment_meta;
+        $this->assertTrue($meta['pg_response_sanitized'] ?? false);
+        $this->assertSame('KCP_VBANK_TNO_SANITIZED', $meta['pg_raw_response']['tno'] ?? null);
+        $this->assertSame($order->order_number, $meta['pg_raw_response']['order_no'] ?? null);
+        $this->assertArrayNotHasKey('ipgm_name', $meta['pg_raw_response']);
+        $this->assertArrayNotHasKey('remitter', $meta['pg_raw_response']);
+        $this->assertArrayNotHasKey('account', $meta['pg_raw_response']);
+        $this->assertArrayNotHasKey('unexpected_sensitive', $meta['pg_raw_response']);
+    }
+
+    public function test_vbank_notify_retries_when_payment_was_not_issued_by_kcp(): void
+    {
+        $order = $this->createTestOrder(30000, [], PaymentMethodEnum::VBANK);
+
+        $response = $this->postVbankNotify(
+            $this->makeVbankNotifyPayload($order->order_number, 30000, [
+                'tno' => 'ATTACKER_TNO_WITHOUT_ISSUE',
+            ])
+        );
+
+        $this->assertKcpNotifyRetry($response);
+
+        $order->refresh();
+        $this->assertNotEquals(OrderStatusEnum::PAYMENT_COMPLETE, $order->order_status);
+    }
+
+    public function test_vbank_notify_retries_on_tno_mismatch(): void
+    {
+        $order = $this->createTestOrder(30000, [], PaymentMethodEnum::VBANK);
+        $this->markVbankIssued($order, 'KCP_VBANK_REAL_TNO');
+
+        $response = $this->postVbankNotify(
+            $this->makeVbankNotifyPayload($order->order_number, 30000, [
+                'tno' => 'ATTACKER_TNO',
+            ])
+        );
+
+        $this->assertKcpNotifyRetry($response);
+
+        $order->refresh();
+        $this->assertNotEquals(OrderStatusEnum::PAYMENT_COMPLETE, $order->order_status);
+    }
+
+    public function test_vbank_notify_retries_on_account_mismatch(): void
+    {
+        $order = $this->createTestOrder(30000, [], PaymentMethodEnum::VBANK);
+        $this->markVbankIssued($order, 'KCP_VBANK_REAL_TNO', 'T1234567890');
+
+        $response = $this->postVbankNotify(
+            $this->makeVbankNotifyPayload($order->order_number, 30000, [
+                'tno' => 'KCP_VBANK_REAL_TNO',
+                'account' => 'T9999999999',
+            ])
+        );
+
+        $this->assertKcpNotifyRetry($response);
+
+        $order->refresh();
+        $this->assertNotEquals(OrderStatusEnum::PAYMENT_COMPLETE, $order->order_status);
+    }
+
+    public function test_vbank_notify_retries_on_site_cd_mismatch(): void
+    {
+        $order = $this->createTestOrder(30000, [], PaymentMethodEnum::VBANK);
+        $this->markVbankIssued($order, 'KCP_VBANK_REAL_TNO', 'T1234567890');
+
+        $response = $this->postVbankNotify(
+            $this->makeVbankNotifyPayload($order->order_number, 30000, [
+                'site_cd' => 'T9999',
+                'tno' => 'KCP_VBANK_REAL_TNO',
+            ])
+        );
+
+        $this->assertKcpNotifyRetry($response);
+
+        $order->refresh();
+        $this->assertNotEquals(OrderStatusEnum::PAYMENT_COMPLETE, $order->order_status);
+    }
+
+    public function test_vbank_notify_retries_on_missing_site_cd(): void
+    {
+        $order = $this->createTestOrder(30000, [], PaymentMethodEnum::VBANK);
+        $this->markVbankIssued($order, 'KCP_VBANK_REAL_TNO', 'T1234567890');
+
+        $payload = $this->makeVbankNotifyPayload($order->order_number, 30000, [
+            'tno' => 'KCP_VBANK_REAL_TNO',
+        ]);
+        unset($payload['site_cd']);
+
+        $response = $this->postVbankNotify($payload);
+
+        $this->assertKcpNotifyRetry($response);
+
+        $order->refresh();
+        $this->assertNotEquals(OrderStatusEnum::PAYMENT_COMPLETE, $order->order_status);
+    }
+
+    public function test_vbank_notify_retries_on_amount_mismatch(): void
+    {
+        $order = $this->createTestOrder(30000, [], PaymentMethodEnum::VBANK);
+        $this->markVbankIssued($order, 'KCP_VBANK_REAL_TNO', 'T1234567890');
+
+        $response = $this->postVbankNotify(
+            $this->makeVbankNotifyPayload($order->order_number, 29999, [
+                'tno' => 'KCP_VBANK_REAL_TNO',
+            ])
+        );
+
+        $this->assertKcpNotifyRetry($response);
+
+        $order->refresh();
+        $this->assertNotEquals(OrderStatusEnum::PAYMENT_COMPLETE, $order->order_status);
+    }
+
+    // ===== 가상계좌 발급 (handleVbankIssued) 성공 처리 =====
+
+    /**
+     * PC 가상계좌: KCP 가 res_cd=V000 ("가상계좌가 발급되었습니다.") + bankname/account 응답 시
+     * success URL 로 리다이렉트 + vbank 컬럼 정상 저장.
+     *
+     * 회귀: KCP 표준결제창은 결제수단별로 다른 정상 응답 코드를 사용한다
+     *      (card=0000, vbank=V000). SUCCESS_RES_CD='0000' 단일 비교만으로 검증하면
+     *      정상 가상계좌 발급도 fail URL 로 처리됨 — 실제 운영 회귀 발견 (주문 20260513-0846191476).
+     *      판정 기준을 res_cd 비교에서 핵심 필드(bankname/account) 존재 여부로 변경.
+     */
+    public function test_vbank_pc_succeeds_on_kcp_v000_with_issuance_data(): void
+    {
+        $order = $this->createTestOrder(30000, [], PaymentMethodEnum::VBANK);
+        $this->mockPluginSettings();
+
+        $tno = 'KCP_VBANK_V000';
+        $this->mockApiService([
+            'res_cd'    => 'V000',
+            'res_msg'   => '가상계좌가 발급되었습니다.',
+            'tno'       => $tno,
+            'bankname'  => 'NH농협',
+            'account'   => 'T1109260001455',
+            'depositor' => 'NHN KCP',
+            'va_date'   => '20260516235959',
+            'bankcode'  => 'BK11',
+            'app_time'  => '20260513174624',
+        ]);
+
+        $response = $this->post(
+            '/plugins/sirsoft-pay_nhnkcp/payment/callback',
+            $this->makeCallbackParams($order->order_number, 30000, [
+                'tno'            => $tno,
+                'use_pay_method' => 'VCNT',
+            ])
+        );
+
+        $response->assertRedirect("/shop/orders/{$order->order_number}/complete");
+
+        $order->refresh();
+        $this->assertNotEquals(OrderStatusEnum::CANCELLED, $order->order_status);
+
+        $payment = $order->payment;
+        $payment->refresh();
+        $this->assertEquals('NH농협', $payment->vbank_name);
+        $this->assertEquals('T1109260001455', $payment->vbank_number);
+        $this->assertEquals('NHN KCP', $payment->vbank_holder);
+        $this->assertNotNull($payment->vbank_due_at);
+        $this->assertNotNull($payment->vbank_issued_at);
+    }
+
+    public function test_vbank_issue_stores_only_sanitized_pg_response_fields(): void
+    {
+        $order = $this->createTestOrder(30000, [], PaymentMethodEnum::VBANK);
+        $this->mockPluginSettings();
+
+        $tno = 'KCP_VBANK_ISSUE_SANITIZED';
+        $this->mockApiService([
+            'res_cd' => 'V000',
+            'res_msg' => '가상계좌가 발급되었습니다.',
+            'tno' => $tno,
+            'bankname' => 'NH농협',
+            'account' => 'T1109260001455',
+            'depositor' => 'NHN KCP',
+            'va_date' => '20260516235959',
+            'bankcode' => 'BK11',
+            'app_time' => '20260513174624',
+            'buyr_name' => '홍길동',
+            'buyr_mail' => 'buyer@example.test',
+            'card_no' => '4330****1234',
+            'unexpected_sensitive' => 'store-me-not',
+        ]);
+
+        $response = $this->post(
+            '/plugins/sirsoft-pay_nhnkcp/payment/callback',
+            $this->makeCallbackParams($order->order_number, 30000, [
+                'tno' => $tno,
+                'use_pay_method' => 'VCNT',
+            ])
+        );
+
+        $response->assertRedirect("/shop/orders/{$order->order_number}/complete");
+
+        $payment = $order->payment;
+        $payment->refresh();
+
+        $meta = $payment->payment_meta;
+        $this->assertTrue($meta['pg_response_sanitized'] ?? false);
+        $this->assertSame($tno, $meta['pg_raw_response']['tno'] ?? null);
+        $this->assertSame('NH농협', $meta['pg_raw_response']['bankname'] ?? null);
+        $this->assertArrayNotHasKey('account', $meta['pg_raw_response']);
+        $this->assertArrayNotHasKey('depositor', $meta['pg_raw_response']);
+        $this->assertArrayNotHasKey('buyr_name', $meta['pg_raw_response']);
+        $this->assertArrayNotHasKey('buyr_mail', $meta['pg_raw_response']);
+        $this->assertArrayNotHasKey('card_no', $meta['pg_raw_response']);
+        $this->assertArrayNotHasKey('unexpected_sensitive', $meta['pg_raw_response']);
+    }
+
+    // ===== 가상계좌 발급 (handleVbankIssued) 실패 처리 =====
+
+    /**
+     * PC 가상계좌: CLI 가 res_cd != 정상 + bankname/account 결락 응답 시 (예: 9502 연동 모듈 호출 오류)
+     * fail URL 로 리다이렉트 + payment_status 가 결제 완료로 전환되지 않아야 함.
+     *
+     * 회귀: 기존 코드는 "계좌 발급 자체는 성공" 가정하에 success URL 로 보내
+     *      사용자에게 빈 가상계좌 정보의 complete 페이지를 노출했음 (운영 사고).
+     */
+    public function test_vbank_pc_redirects_to_fail_on_cli_non_0000(): void
+    {
+        $order = $this->createTestOrder(30000, [], PaymentMethodEnum::VBANK);
+        $this->mockPluginSettings();
+        $this->mockApiService($this->makeCliResponse('KCP_VBANK_FAIL', $order->order_number, 30000, '9502'));
+
+        $response = $this->post(
+            '/plugins/sirsoft-pay_nhnkcp/payment/callback',
+            $this->makeCallbackParams($order->order_number, 30000, ['use_pay_method' => 'VCNT'])
+        );
+
+        $response->assertRedirect();
+        $this->assertStringContainsString('error=9502', $response->headers->get('Location'));
+        $this->assertStringNotContainsString('/complete', $response->headers->get('Location'));
+
+        $order->refresh();
+        $this->assertNotEquals(OrderStatusEnum::PAYMENT_COMPLETE, $order->order_status);
+
+        $payment = $order->payment;
+        $payment->refresh();
+        $this->assertNull($payment->vbank_name);
+        $this->assertNull($payment->vbank_number);
+    }
+
+    /**
+     * PC 가상계좌: CLI 호출 자체가 예외(approvePayment throws) → fail URL.
+     */
+    public function test_vbank_pc_redirects_to_fail_on_cli_exception(): void
+    {
+        $order = $this->createTestOrder(30000, [], PaymentMethodEnum::VBANK);
+        $this->mockPluginSettings();
+
+        $mock = $this->createMock(NhnKcpApiService::class);
+        $mock->method('approvePayment')->willThrowException(new \RuntimeException('CLI exec failed'));
+        $this->app->instance(NhnKcpApiService::class, $mock);
+
+        $response = $this->post(
+            '/plugins/sirsoft-pay_nhnkcp/payment/callback',
+            $this->makeCallbackParams($order->order_number, 30000, ['use_pay_method' => 'VCNT'])
+        );
+
+        $response->assertRedirect();
+        $this->assertStringNotContainsString('/complete', $response->headers->get('Location'));
+
+        $order->refresh();
+        $this->assertNotEquals(OrderStatusEnum::PAYMENT_COMPLETE, $order->order_status);
+
+        $payment = $order->payment;
+        $payment->refresh();
+        $this->assertNull($payment->vbank_name);
+        $this->assertNull($payment->vbank_number);
+    }
+
+    /**
+     * 모바일 가상계좌: 콜백 POST 의 평문 필드를 그대로 응답으로 취급하는 경로에서
+     * res_cd != 0000 시 fail URL 로 리다이렉트.
+     *
+     * 모바일은 enc_data/enc_info 가 없어 CLI 미호출이므로, 콜백 res_cd 자체가 권위.
+     */
+    public function test_vbank_mobile_redirects_to_fail_on_callback_res_cd_non_0000(): void
+    {
+        $order = $this->createTestOrder(30000, [], PaymentMethodEnum::VBANK);
+        $this->mockPluginSettings();
+
+        // 모바일: enc_data/enc_info 없이 res_cd 가 비-0000.
+        // 단 authCallback() 의 1단계 res_cd 가드를 통과해야 handleVbankIssued() 가 호출되므로
+        // 시나리오 재현은 1단계 가드가 vbank 비-0000 도 동일하게 처리해야 한다는 의미.
+        // 여기서는 res_cd=0000 으로 진입하되 handleVbankIssued 모바일 분기에서
+        // 평문 필드 누락으로 발급 실패(bankname/account 모두 null)인 케이스를 검증.
+        $response = $this->post(
+            '/plugins/sirsoft-pay_nhnkcp/payment/callback',
+            [
+                'res_cd'         => '0000',
+                'ordr_idxx'      => $order->order_number,
+                'good_mny'       => 30000,
+                'tno'            => 'KCP_VBANK_MOBILE_FAIL',
+                'use_pay_method' => 'VCNT',
+                // bankname / account / depositor / va_date 모두 누락 → 발급 정보 없음
+            ]
+        );
+
+        $response->assertRedirect();
+        $this->assertStringNotContainsString('/complete', $response->headers->get('Location'));
+
+        $order->refresh();
+        $this->assertNotEquals(OrderStatusEnum::PAYMENT_COMPLETE, $order->order_status);
+
+        $payment = $order->payment;
+        $payment->refresh();
+        $this->assertNull($payment->vbank_name);
+        $this->assertNull($payment->vbank_number);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/PaymentCallbackOrderSideEffectsTest.php b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/PaymentCallbackOrderSideEffectsTest.php
new file mode 100644
index 00000000..0e72fc00
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/PaymentCallbackOrderSideEffectsTest.php
@@ -0,0 +1,411 @@
+<?php
+
+namespace Plugins\Sirsoft\PayNhnkcp\Tests\Feature\Controllers;
+
+use App\Extension\HookManager;
+use App\Models\User;
+use Modules\Sirsoft\Ecommerce\Database\Factories\CartFactory;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderFactory;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderOptionFactory;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderPaymentFactory;
+use Modules\Sirsoft\Ecommerce\Database\Factories\ProductFactory;
+use Modules\Sirsoft\Ecommerce\Database\Factories\ProductOptionFactory;
+use Modules\Sirsoft\Ecommerce\Enums\CouponDiscountType;
+use Modules\Sirsoft\Ecommerce\Enums\CouponIssueCondition;
+use Modules\Sirsoft\Ecommerce\Enums\CouponIssueMethod;
+use Modules\Sirsoft\Ecommerce\Enums\CouponIssueRecordStatus;
+use Modules\Sirsoft\Ecommerce\Enums\CouponIssueStatus;
+use Modules\Sirsoft\Ecommerce\Enums\CouponTargetScope;
+use Modules\Sirsoft\Ecommerce\Enums\CouponTargetType;
+use Modules\Sirsoft\Ecommerce\Enums\MileageTransactionTypeEnum;
+use Modules\Sirsoft\Ecommerce\Enums\OrderStatusEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentMethodEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentStatusEnum;
+use Modules\Sirsoft\Ecommerce\Listeners\MileageTransactionListener;
+use Modules\Sirsoft\Ecommerce\Models\Coupon;
+use Modules\Sirsoft\Ecommerce\Models\CouponIssue;
+use Modules\Sirsoft\Ecommerce\Models\MileageTransaction;
+use Modules\Sirsoft\Ecommerce\Models\Order;
+use Plugins\Sirsoft\PayNhnkcp\Services\NhnKcpApiService;
+use Plugins\Sirsoft\PayNhnkcp\Tests\PluginTestCase;
+
+class PaymentCallbackOrderSideEffectsTest extends PluginTestCase
+{
+    private const TEST_SITE_CD = 'T0000';
+
+    private const TEST_SITE_KEY = 'TEST_SITE_KEY_0000';
+
+    /**
+     * @var array{hooks: array, filters: array, dispatching: array}|null
+     */
+    private ?array $hookSnapshot = null;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        $this->snapshotHookManager();
+        $this->registerMileageTransactionListener();
+    }
+
+    protected function tearDown(): void
+    {
+        $this->restoreHookManager();
+
+        parent::tearDown();
+    }
+
+    public function test_auth_callback_completes_order_and_applies_ecommerce_side_effects(): void
+    {
+        $fixture = $this->createPendingCardOrderFixture();
+        $order = $fixture['order'];
+        $product = $fixture['product'];
+        $productOption = $fixture['productOption'];
+        $cart = $fixture['cart'];
+        $couponIssue = $fixture['couponIssue'];
+        $user = $fixture['user'];
+
+        $this->mockPluginSettings();
+
+        $tno = 'KCP_TNO_SIDE_EFFECTS';
+        $this->mockApiService($this->makeCliResponse($tno, $order->order_number, 55000));
+
+        $response = $this->post(
+            '/plugins/sirsoft-pay_nhnkcp/payment/callback',
+            $this->makeCallbackParams($order->order_number, 55000, ['tno' => $tno])
+        );
+
+        $response->assertRedirect("/shop/orders/{$order->order_number}/complete");
+
+        $order->refresh()->load('payment', 'options');
+        $this->assertEquals(OrderStatusEnum::PAYMENT_COMPLETE, $order->order_status);
+        $this->assertEquals(55000, (int) $order->total_paid_amount);
+        $this->assertEquals(0, (int) $order->total_due_amount);
+        $this->assertTrue((bool) $order->is_mileage_deducted);
+
+        $payment = $order->payment;
+        $payment->refresh();
+        $this->assertEquals(PaymentStatusEnum::PAID, $payment->payment_status);
+        $this->assertEquals($tno, $payment->transaction_id);
+        $this->assertEquals('APP12345', $payment->card_approval_number);
+        $this->assertEquals(55000, (int) $payment->paid_amount_local);
+        $this->assertEquals(55000, (int) $payment->paid_amount_base);
+
+        $productOption->refresh();
+        $product->refresh();
+        $this->assertEquals(8, (int) $productOption->stock_quantity);
+        $this->assertEquals(8, (int) $product->stock_quantity);
+        $this->assertTrue((bool) $order->options->first()->is_stock_deducted);
+        $this->assertEquals(OrderStatusEnum::PAYMENT_COMPLETE, $order->options->first()->option_status);
+
+        $couponIssue->refresh();
+        $this->assertEquals(CouponIssueRecordStatus::USED, $couponIssue->status);
+        $this->assertEquals($order->id, $couponIssue->order_id);
+        $this->assertNotNull($couponIssue->used_at);
+
+        $this->assertDatabaseMissing('ecommerce_carts', ['id' => $cart->id]);
+
+        $this->assertDatabaseHas('ecommerce_mileage_transactions', [
+            'user_id' => $user->id,
+            'order_id' => $order->id,
+            'type' => MileageTransactionTypeEnum::ORDER_USE->value,
+            'amount' => -2000,
+            'remaining_amount' => 0,
+        ]);
+        $this->assertEquals(0, (int) MileageTransaction::query()
+            ->where('user_id', $user->id)
+            ->where('type', MileageTransactionTypeEnum::PURCHASE_EARN->value)
+            ->sum('remaining_amount'));
+    }
+
+    /**
+     * @return array{
+     *     user: User,
+     *     order: Order,
+     *     product: \Modules\Sirsoft\Ecommerce\Models\Product,
+     *     productOption: \Modules\Sirsoft\Ecommerce\Models\ProductOption,
+     *     cart: \Modules\Sirsoft\Ecommerce\Models\Cart,
+     *     couponIssue: CouponIssue
+     * }
+     */
+    private function createPendingCardOrderFixture(): array
+    {
+        $user = User::factory()->create();
+        $product = ProductFactory::new()->create([
+            'name' => ['ko' => 'KCP 통합 테스트 상품', 'en' => 'KCP Integration Product'],
+            'list_price' => 30000,
+            'selling_price' => 30000,
+            'currency_code' => 'KRW',
+            'stock_quantity' => 10,
+            'has_options' => true,
+        ]);
+        $productOption = ProductOptionFactory::new()->forProduct($product)->create([
+            'option_code' => 'KCP-SIDE-EFFECTS-OPTION',
+            'option_name' => ['ko' => '기본', 'en' => 'Default'],
+            'price_adjustment' => 0,
+            'list_price' => 30000,
+            'selling_price' => 30000,
+            'currency_code' => 'KRW',
+            'stock_quantity' => 10,
+        ]);
+        $cart = CartFactory::new()->forUser($user)->forOption($productOption)->withQuantity(2)->create();
+        $couponIssue = $this->createUsedCouponIssue($user);
+
+        MileageTransaction::create([
+            'user_id' => $user->id,
+            'currency' => 'KRW',
+            'type' => MileageTransactionTypeEnum::PURCHASE_EARN->value,
+            'amount' => 2000,
+            'remaining_amount' => 2000,
+            'balance_after' => 2000,
+            'description' => 'NHN KCP callback side effect fixture',
+        ]);
+
+        $order = OrderFactory::new()->forUser($user)->create([
+            'order_number' => 'ORD-KCP-SIDE-' . random_int(10000, 99999),
+            'order_status' => OrderStatusEnum::PENDING_ORDER,
+            'currency' => 'KRW',
+            'currency_snapshot' => self::krwCurrencySnapshot(),
+            'subtotal_amount' => 60000,
+            'total_discount_amount' => 3000,
+            'total_product_coupon_discount_amount' => 0,
+            'total_order_coupon_discount_amount' => 3000,
+            'total_coupon_discount_amount' => 3000,
+            'total_code_discount_amount' => 0,
+            'base_shipping_amount' => 0,
+            'extra_shipping_amount' => 0,
+            'shipping_discount_amount' => 0,
+            'total_shipping_amount' => 0,
+            'total_amount' => 57000,
+            'total_tax_amount' => 55000,
+            'total_vat_amount' => 5000,
+            'total_tax_free_amount' => 0,
+            'total_points_used_amount' => 2000,
+            'is_mileage_deducted' => false,
+            'total_deposit_used_amount' => 0,
+            'total_paid_amount' => 0,
+            'total_due_amount' => 55000,
+            'total_earned_points_amount' => 0,
+            'item_count' => 1,
+            'order_meta' => [
+                'cart_items' => [
+                    [
+                        'cart_id' => $cart->id,
+                        'product_id' => $product->id,
+                        'product_option_id' => $productOption->id,
+                        'quantity' => 2,
+                    ],
+                ],
+                'promotions' => [
+                    'coupon_issue_ids' => [$couponIssue->id],
+                    'order_promotions' => [
+                        'coupons' => [[
+                            'coupon_issue_id' => $couponIssue->id,
+                            'applied_amount' => 3000,
+                        ]],
+                    ],
+                ],
+            ],
+        ]);
+
+        OrderOptionFactory::new()->forOrder($order)->create([
+            'product_id' => $product->id,
+            'product_option_id' => $productOption->id,
+            'option_status' => OrderStatusEnum::PENDING_ORDER,
+            'quantity' => 2,
+            'unit_price' => 30000,
+            'subtotal_price' => 60000,
+            'subtotal_discount_amount' => 3000,
+            'coupon_discount_amount' => 3000,
+            'product_coupon_discount_amount' => 0,
+            'order_coupon_discount_amount' => 3000,
+            'code_discount_amount' => 0,
+            'subtotal_points_used_amount' => 2000,
+            'subtotal_paid_amount' => 55000,
+            'subtotal_tax_amount' => 55000,
+            'subtotal_tax_free_amount' => 0,
+            'subtotal_earned_points_amount' => 0,
+            'is_stock_deducted' => false,
+        ]);
+
+        OrderPaymentFactory::new()->forOrder($order)->create([
+            'payment_status' => PaymentStatusEnum::READY,
+            'pg_provider' => 'nhnkcp',
+            'transaction_id' => null,
+            'merchant_order_id' => 'MO-' . $order->order_number,
+            'payment_method' => PaymentMethodEnum::CARD,
+            'paid_amount_local' => 0,
+            'paid_amount_base' => 0,
+            'vat_amount' => 5000,
+            'currency' => 'KRW',
+            'currency_snapshot' => self::krwCurrencySnapshot(),
+            'card_name' => null,
+            'card_number_masked' => null,
+            'card_approval_number' => null,
+            'receipt_url' => null,
+            'payment_meta' => null,
+            'paid_at' => null,
+        ]);
+
+        $couponIssue->update(['order_id' => $order->id]);
+
+        return compact('user', 'order', 'product', 'productOption', 'cart', 'couponIssue');
+    }
+
+    private function createUsedCouponIssue(User $user): CouponIssue
+    {
+        $coupon = Coupon::create([
+            'name' => ['ko' => 'KCP 통합 테스트 쿠폰', 'en' => 'KCP Integration Coupon'],
+            'description' => ['ko' => 'KCP 통합 테스트용', 'en' => 'For KCP integration test'],
+            'target_type' => CouponTargetType::ORDER_AMOUNT,
+            'discount_type' => CouponDiscountType::FIXED,
+            'discount_value' => 3000,
+            'discount_max_amount' => 3000,
+            'min_order_amount' => 0,
+            'issue_method' => CouponIssueMethod::DIRECT,
+            'issue_condition' => CouponIssueCondition::MANUAL,
+            'issue_status' => CouponIssueStatus::ISSUING,
+            'total_quantity' => 100,
+            'issued_count' => 1,
+            'per_user_limit' => 1,
+            'valid_type' => 'period',
+            'valid_from' => now()->subDay(),
+            'valid_to' => now()->addMonth(),
+            'issue_from' => now()->subDay(),
+            'issue_to' => now()->addMonth(),
+            'is_combinable' => true,
+            'target_scope' => CouponTargetScope::ALL,
+        ]);
+
+        return CouponIssue::create([
+            'coupon_id' => $coupon->id,
+            'user_id' => $user->id,
+            'coupon_code' => 'KCP-SIDE-' . strtoupper(uniqid()),
+            'status' => CouponIssueRecordStatus::USED,
+            'issued_at' => now()->subHour(),
+            'expired_at' => now()->addMonth(),
+            'used_at' => now(),
+            'discount_amount' => 3000,
+        ]);
+    }
+
+    private function mockPluginSettings(array $overrides = []): void
+    {
+        $defaults = [
+            'is_test_mode' => true,
+            'test_site_cd' => self::TEST_SITE_CD,
+            'test_site_key' => self::TEST_SITE_KEY,
+            'live_site_cd' => '',
+            'live_site_key' => '',
+            'redirect_success_url' => '/shop/orders/{orderId}/complete',
+            'redirect_fail_url' => '/shop/checkout',
+        ];
+
+        $mock = $this->createMock(\App\Services\PluginSettingsService::class);
+        $mock->method('get')->willReturn(array_merge($defaults, $overrides));
+        $this->app->instance(\App\Services\PluginSettingsService::class, $mock);
+    }
+
+    private function mockApiService(array $cliResponse): void
+    {
+        $mock = $this->createMock(NhnKcpApiService::class);
+        $mock->method('approvePayment')->willReturn($cliResponse);
+        $this->app->instance(NhnKcpApiService::class, $mock);
+    }
+
+    private function makeCliResponse(string $tno, string $ordrIdxx, int $amount): array
+    {
+        return [
+            'res_cd' => '0000',
+            'res_msg' => '정상처리',
+            'tno' => $tno,
+            'ordr_idxx' => $ordrIdxx,
+            'good_mny' => $amount,
+            'app_no' => 'APP12345',
+            'card_no' => '4330****1234',
+            'card_name' => '신한카드',
+            'quota' => '00',
+            'use_pay_method' => 'CARD',
+            'app_time' => now()->format('YmdHis'),
+        ];
+    }
+
+    private function makeCallbackParams(string $ordrIdxx, int $goodMny, array $overrides = []): array
+    {
+        return array_merge([
+            'res_cd' => '0000',
+            'res_msg' => '정상처리',
+            'tno' => 'KCP_TNO_' . uniqid(),
+            'ordr_idxx' => $ordrIdxx,
+            'good_mny' => $goodMny,
+            'enc_data' => base64_encode('encrypted_payment_data'),
+            'enc_info' => base64_encode('encrypted_info'),
+            'use_pay_method' => 'CARD',
+        ], $overrides);
+    }
+
+    private static function krwCurrencySnapshot(): array
+    {
+        return [
+            'base_currency' => 'KRW',
+            'order_currency' => 'KRW',
+            'base_unit' => 1,
+            'exchange_rates' => [
+                'KRW' => [
+                    'rate' => 1,
+                    'rounding_unit' => '1',
+                    'rounding_method' => 'round',
+                    'decimal_places' => 0,
+                    'base_unit' => 1,
+                ],
+            ],
+        ];
+    }
+
+    private function registerMileageTransactionListener(): void
+    {
+        $listener = app(MileageTransactionListener::class);
+        HookManager::addAction('sirsoft-ecommerce.mileage.use', [$listener, 'handleUse'], 10);
+    }
+
+    private function snapshotHookManager(): void
+    {
+        $ref = new \ReflectionClass(HookManager::class);
+
+        $hooks = $ref->getProperty('hooks');
+        $hooks->setAccessible(true);
+        $filters = $ref->getProperty('filters');
+        $filters->setAccessible(true);
+        $dispatching = $ref->getProperty('dispatching');
+        $dispatching->setAccessible(true);
+
+        $this->hookSnapshot = [
+            'hooks' => $hooks->getValue(),
+            'filters' => $filters->getValue(),
+            'dispatching' => $dispatching->getValue(),
+        ];
+    }
+
+    private function restoreHookManager(): void
+    {
+        if ($this->hookSnapshot === null) {
+            return;
+        }
+
+        $ref = new \ReflectionClass(HookManager::class);
+
+        $hooks = $ref->getProperty('hooks');
+        $hooks->setAccessible(true);
+        $hooks->setValue(null, $this->hookSnapshot['hooks']);
+
+        $filters = $ref->getProperty('filters');
+        $filters->setAccessible(true);
+        $filters->setValue(null, $this->hookSnapshot['filters']);
+
+        $dispatching = $ref->getProperty('dispatching');
+        $dispatching->setAccessible(true);
+        $dispatching->setValue(null, $this->hookSnapshot['dispatching']);
+
+        $this->hookSnapshot = null;
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/PaymentCloseReportControllerTest.php b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/PaymentCloseReportControllerTest.php
new file mode 100644
index 00000000..d518eb16
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/PaymentCloseReportControllerTest.php
@@ -0,0 +1,241 @@
+<?php
+
+namespace Plugins\Sirsoft\PayNhnkcp\Tests\Feature\Controllers;
+
+use Mockery;
+use Modules\Sirsoft\Ecommerce\Enums\OrderStatusEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentStatusEnum;
+use Modules\Sirsoft\Ecommerce\Models\Order;
+use Modules\Sirsoft\Ecommerce\Models\OrderAddress;
+use Modules\Sirsoft\Ecommerce\Models\OrderPayment;
+use Modules\Sirsoft\Ecommerce\Services\OrderProcessingService;
+use Plugins\Sirsoft\PayNhnkcp\Tests\PluginTestCase;
+
+class PaymentCloseReportControllerTest extends PluginTestCase
+{
+    public function test_close_report_marks_pending_order_failed_and_payment_cancelled(): void
+    {
+        $order = $this->makeOrder('ORD-KCP-CLOSE-001', 10000);
+        $order->setRelation('shippingAddress', new OrderAddress([
+            'address_type' => 'shipping',
+            'orderer_email' => 'buyer@example.com',
+            'orderer_phone' => '010-1234-5678',
+        ]));
+
+        $orderService = Mockery::mock(OrderProcessingService::class);
+        $orderService->shouldReceive('findByOrderNumber')
+            ->once()
+            ->with('ORD-KCP-CLOSE-001')
+            ->andReturn($order);
+        $orderService->shouldReceive('failPayment')
+            ->once()
+            ->with($order, 'USER_CANCEL', '사용자가 NHN KCP 결제창을 닫았습니다.')
+            ->andReturn($order);
+        $orderService->shouldReceive('recordPaymentCancellation')
+            ->once()
+            ->with($order, 'USER_CANCEL', 'kcp-window-closed')
+            ->andReturn($order);
+
+        $this->app->instance(OrderProcessingService::class, $orderService);
+
+        $response = $this->postJson('/api/plugins/sirsoft-pay_nhnkcp/payment/close-report', [
+            'oid' => 'ORD-KCP-CLOSE-001',
+            'price' => 10000,
+            'buyer_email' => 'BUYER@example.com',
+            'buyer_phone' => '01012345678',
+            'payment_method' => 'card',
+            'reason' => 'kcp-window-closed',
+        ]);
+
+        $response->assertOk()
+            ->assertJsonPath('data.status', 'recorded');
+    }
+
+    public function test_close_report_rejects_amount_mismatch(): void
+    {
+        $order = $this->makeOrder('ORD-KCP-CLOSE-002', 10000);
+
+        $orderService = Mockery::mock(OrderProcessingService::class);
+        $orderService->shouldReceive('findByOrderNumber')
+            ->once()
+            ->with('ORD-KCP-CLOSE-002')
+            ->andReturn($order);
+        $orderService->shouldNotReceive('failPayment');
+        $orderService->shouldNotReceive('recordPaymentCancellation');
+
+        $this->app->instance(OrderProcessingService::class, $orderService);
+
+        $response = $this->postJson('/api/plugins/sirsoft-pay_nhnkcp/payment/close-report', [
+            'oid' => 'ORD-KCP-CLOSE-002',
+            'price' => 9000,
+        ]);
+
+        $response->assertStatus(422)
+            ->assertJsonPath('errors.message.0', 'Payment amount does not match the order amount.');
+    }
+
+    public function test_close_report_rejects_invalid_payment_currency_without_server_error(): void
+    {
+        $order = $this->makeOrder('ORD-KCP-CLOSE-CURRENCY-001', 10000);
+        $order->currency = 'USD';
+        $order->currency_snapshot = self::invalidUsdCurrencySnapshot();
+
+        $orderService = Mockery::mock(OrderProcessingService::class);
+        $orderService->shouldReceive('findByOrderNumber')
+            ->once()
+            ->with('ORD-KCP-CLOSE-CURRENCY-001')
+            ->andReturn($order);
+        $orderService->shouldNotReceive('failPayment');
+        $orderService->shouldNotReceive('recordPaymentCancellation');
+
+        $this->app->instance(OrderProcessingService::class, $orderService);
+
+        $response = $this->postJson('/api/plugins/sirsoft-pay_nhnkcp/payment/close-report', [
+            'oid' => 'ORD-KCP-CLOSE-CURRENCY-001',
+            'price' => 10000,
+        ]);
+
+        $response->assertStatus(422)
+            ->assertJsonPath('errors.message.0', 'Payment currency is not chargeable.');
+    }
+
+    public function test_close_report_rejects_buyer_mismatch(): void
+    {
+        $order = $this->makeOrder('ORD-KCP-CLOSE-003', 10000);
+        $order->setRelation('shippingAddress', new OrderAddress([
+            'address_type' => 'shipping',
+            'orderer_email' => 'buyer@example.com',
+            'orderer_phone' => '010-1234-5678',
+        ]));
+
+        $orderService = Mockery::mock(OrderProcessingService::class);
+        $orderService->shouldReceive('findByOrderNumber')
+            ->once()
+            ->with('ORD-KCP-CLOSE-003')
+            ->andReturn($order);
+        $orderService->shouldNotReceive('failPayment');
+        $orderService->shouldNotReceive('recordPaymentCancellation');
+
+        $this->app->instance(OrderProcessingService::class, $orderService);
+
+        $response = $this->postJson('/api/plugins/sirsoft-pay_nhnkcp/payment/close-report', [
+            'oid' => 'ORD-KCP-CLOSE-003',
+            'price' => 10000,
+            'buyer_email' => 'attacker@example.com',
+            'buyer_phone' => '01012345678',
+        ]);
+
+        $response->assertStatus(403)
+            ->assertJsonPath('errors.message.0', 'Order buyer verification failed.');
+    }
+
+    public function test_close_report_ignores_order_that_is_no_longer_payable(): void
+    {
+        $order = $this->makeOrder('ORD-KCP-CLOSE-004', 10000);
+        $order->order_status = OrderStatusEnum::PAYMENT_COMPLETE;
+
+        $orderService = Mockery::mock(OrderProcessingService::class);
+        $orderService->shouldReceive('findByOrderNumber')
+            ->once()
+            ->with('ORD-KCP-CLOSE-004')
+            ->andReturn($order);
+        $orderService->shouldNotReceive('failPayment');
+        $orderService->shouldNotReceive('recordPaymentCancellation');
+
+        $this->app->instance(OrderProcessingService::class, $orderService);
+
+        $response = $this->postJson('/api/plugins/sirsoft-pay_nhnkcp/payment/close-report', [
+            'oid' => 'ORD-KCP-CLOSE-004',
+            'price' => 10000,
+        ]);
+
+        $response->assertOk()
+            ->assertJsonPath('data.status', 'ignored')
+            ->assertJsonPath('data.reason', 'order_not_payable');
+    }
+
+    public function test_close_report_ignores_order_when_payment_already_paid(): void
+    {
+        // race 재현: 승인 콜백이 payment 를 PAID 로 갱신했고 결제 예정액은 이미 0원이 됐으나,
+        // order_status 관계가 아직 PENDING_ORDER 로 관측되는 순간에도 close-report 는 금액 불일치가
+        // 아니라 결제 성공으로 판단해 무시해야 한다.
+        $order = $this->makeOrder('ORD-KCP-CLOSE-PAID-001', 0);
+        $order->setRelation('payment', new OrderPayment([
+            'payment_status' => PaymentStatusEnum::PAID,
+        ]));
+
+        $orderService = Mockery::mock(OrderProcessingService::class);
+        $orderService->shouldReceive('findByOrderNumber')
+            ->once()
+            ->with('ORD-KCP-CLOSE-PAID-001')
+            ->andReturn($order);
+        $orderService->shouldNotReceive('failPayment');
+        $orderService->shouldNotReceive('recordPaymentCancellation');
+
+        $this->app->instance(OrderProcessingService::class, $orderService);
+
+        $response = $this->postJson('/api/plugins/sirsoft-pay_nhnkcp/payment/close-report', [
+            'oid' => 'ORD-KCP-CLOSE-PAID-001',
+            'price' => 10000,
+        ]);
+
+        $response->assertOk()
+            ->assertJsonPath('data.status', 'ignored')
+            ->assertJsonPath('data.reason', 'payment_already_paid');
+    }
+
+    private function makeOrder(string $orderNumber, int $amount): Order
+    {
+        $order = new Order;
+        $order->order_number = $orderNumber;
+        $order->order_status = OrderStatusEnum::PENDING_ORDER;
+        $order->currency = 'KRW';
+        $order->currency_snapshot = self::krwCurrencySnapshot();
+        $order->total_due_amount = $amount;
+
+        return $order;
+    }
+
+    private static function krwCurrencySnapshot(): array
+    {
+        return [
+            'base_currency' => 'KRW',
+            'order_currency' => 'KRW',
+            'base_unit' => 1,
+            'exchange_rates' => [
+                'KRW' => [
+                    'rate' => 1,
+                    'rounding_unit' => '1',
+                    'rounding_method' => 'round',
+                    'decimal_places' => 0,
+                    'base_unit' => 1,
+                ],
+            ],
+        ];
+    }
+
+    private static function invalidUsdCurrencySnapshot(): array
+    {
+        return [
+            'base_currency' => 'KRW',
+            'order_currency' => 'USD',
+            'base_unit' => 1000,
+            'exchange_rates' => [
+                'KRW' => [
+                    'rate' => 1,
+                    'rounding_unit' => '1',
+                    'rounding_method' => 'round',
+                    'decimal_places' => 0,
+                    'base_unit' => 1000,
+                ],
+                'USD' => [
+                    'rate' => 0,
+                    'rounding_unit' => '0.01',
+                    'rounding_method' => 'round',
+                    'decimal_places' => 2,
+                    'base_unit' => 1,
+                ],
+            ],
+        ];
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/PaymentRetryControllerTest.php b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/PaymentRetryControllerTest.php
new file mode 100644
index 00000000..4149bef5
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/PaymentRetryControllerTest.php
@@ -0,0 +1,234 @@
+<?php
+
+namespace Plugins\Sirsoft\PayNhnkcp\Tests\Feature\Controllers;
+
+use App\Models\User;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderAddressFactory;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderFactory;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderPaymentFactory;
+use Modules\Sirsoft\Ecommerce\Enums\OrderStatusEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentMethodEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentStatusEnum;
+use Modules\Sirsoft\Ecommerce\Models\Order;
+use Plugins\Sirsoft\PayNhnkcp\Tests\PluginTestCase;
+
+class PaymentRetryControllerTest extends PluginTestCase
+{
+    private const ENDPOINT = '/api/plugins/sirsoft-pay_nhnkcp/payment/retry';
+
+    private function createOrder(
+        int $amount = 10000,
+        OrderStatusEnum $orderStatus = OrderStatusEnum::PENDING_ORDER,
+        PaymentStatusEnum $paymentStatus = PaymentStatusEnum::READY,
+        array $orderMeta = [],
+        array $paymentMeta = [],
+    ): Order {
+        $user = User::factory()->create();
+
+        $order = OrderFactory::new()->create([
+            'user_id' => $user->id,
+            'order_number' => 'ORD-KCP-RETRY-' . random_int(10000, 99999),
+            'order_status' => $orderStatus,
+            'subtotal_amount' => $amount,
+            'total_amount' => $amount,
+            'total_due_amount' => $amount,
+            'total_paid_amount' => 0,
+            'order_meta' => $orderMeta,
+            'currency' => 'KRW',
+            'currency_snapshot' => self::krwCurrencySnapshot(),
+        ]);
+
+        OrderPaymentFactory::new()->create([
+            'order_id' => $order->id,
+            'payment_status' => $paymentStatus,
+            'payment_method' => PaymentMethodEnum::CARD,
+            'pg_provider' => 'nhnkcp',
+            'paid_amount_local' => 0,
+            'paid_at' => null,
+            'cancelled_at' => $paymentStatus === PaymentStatusEnum::CANCELLED ? now() : null,
+            'transaction_id' => null,
+            'card_approval_number' => null,
+            'payment_meta' => $paymentMeta,
+        ]);
+
+        return $order;
+    }
+
+    private static function krwCurrencySnapshot(): array
+    {
+        return [
+            'base_currency' => 'KRW',
+            'order_currency' => 'KRW',
+            'base_unit' => 1,
+            'exchange_rates' => [
+                'KRW' => [
+                    'rate' => 1,
+                    'rounding_unit' => '1',
+                    'rounding_method' => 'round',
+                    'decimal_places' => 0,
+                    'base_unit' => 1,
+                ],
+            ],
+        ];
+    }
+
+    private static function invalidUsdCurrencySnapshot(): array
+    {
+        return [
+            'base_currency' => 'KRW',
+            'order_currency' => 'USD',
+            'base_unit' => 1000,
+            'exchange_rates' => [
+                'KRW' => [
+                    'rate' => 1,
+                    'rounding_unit' => '1',
+                    'rounding_method' => 'round',
+                    'decimal_places' => 0,
+                    'base_unit' => 1000,
+                ],
+                'USD' => [
+                    'rate' => 0,
+                    'rounding_unit' => '0.01',
+                    'rounding_method' => 'round',
+                    'decimal_places' => 2,
+                    'base_unit' => 1,
+                ],
+            ],
+        ];
+    }
+
+    public function test_retry_returns_ready_for_pending_order(): void
+    {
+        $order = $this->createOrder(10000);
+
+        $response = $this->postJson(self::ENDPOINT, [
+            'oid' => $order->order_number,
+            'price' => 10000,
+        ]);
+
+        $response->assertOk()
+            ->assertJsonPath('data.status', 'ready');
+
+        $order->refresh();
+        $this->assertEquals(OrderStatusEnum::PENDING_ORDER, $order->order_status);
+        $this->assertEquals(PaymentStatusEnum::READY, $order->payment->payment_status);
+    }
+
+    public function test_retry_rejects_invalid_payment_currency_without_server_error(): void
+    {
+        $order = $this->createOrder(10000);
+        $order->update([
+            'currency' => 'USD',
+            'currency_snapshot' => self::invalidUsdCurrencySnapshot(),
+        ]);
+
+        $response = $this->postJson(self::ENDPOINT, [
+            'oid' => $order->order_number,
+            'price' => 10000,
+        ]);
+
+        $response->assertStatus(422)
+            ->assertJsonPath('errors.message.0', 'Payment currency is not chargeable.');
+
+        $order->refresh();
+        $this->assertEquals(OrderStatusEnum::PENDING_ORDER, $order->order_status);
+        $this->assertEquals(PaymentStatusEnum::READY, $order->payment->payment_status);
+    }
+
+    public function test_retry_restores_cancelled_kcp_failure_order(): void
+    {
+        $order = $this->createOrder(
+            20000,
+            OrderStatusEnum::CANCELLED,
+            PaymentStatusEnum::CANCELLED,
+            [
+                'payment_failure_code' => 'USER_CANCEL',
+                'payment_failure_message' => '사용자가 NHN KCP 결제창을 닫았습니다.',
+                'payment_failed_at' => now()->subMinute()->toIso8601String(),
+            ],
+            [
+                'failure_source' => 'nhnkcp',
+                'failure_code' => 'USER_CANCEL',
+                'failure_message' => 'kcp-window-closed',
+                'failure_stage' => 'window_closed',
+                'failed_at' => now()->subMinute()->toIso8601String(),
+            ],
+        );
+
+        $response = $this->postJson(self::ENDPOINT, [
+            'oid' => $order->order_number,
+            'price' => 20000,
+        ]);
+
+        $response->assertOk()
+            ->assertJsonPath('data.status', 'restored');
+
+        $order->refresh();
+        $payment = $order->payment;
+        $payment->refresh();
+
+        $this->assertEquals(OrderStatusEnum::PENDING_ORDER, $order->order_status);
+        $this->assertArrayNotHasKey('payment_failure_code', $order->order_meta);
+        $this->assertSame(1, $order->order_meta['nhnkcp_retry_count'] ?? null);
+        $this->assertNotEmpty($order->order_meta['nhnkcp_retry_failures'] ?? []);
+
+        $this->assertEquals(PaymentStatusEnum::READY, $payment->payment_status);
+        $this->assertNull($payment->cancelled_at);
+        $this->assertArrayNotHasKey('failure_source', $payment->payment_meta);
+        $this->assertSame(1, $payment->payment_meta['retry_count'] ?? null);
+    }
+
+    public function test_retry_rejects_amount_mismatch_failure_order(): void
+    {
+        $order = $this->createOrder(
+            20000,
+            OrderStatusEnum::CANCELLED,
+            PaymentStatusEnum::FAILED,
+            [
+                'payment_failure_code' => 'AMOUNT_MISMATCH',
+                'payment_failure_message' => '금액 불일치',
+                'payment_failed_at' => now()->subMinute()->toIso8601String(),
+            ],
+            [
+                'failure_source' => 'nhnkcp',
+                'failure_code' => 'AMOUNT_MISMATCH',
+                'failure_message' => '금액 불일치',
+                'failure_stage' => 'amount_mismatch',
+                'failed_at' => now()->subMinute()->toIso8601String(),
+            ],
+        );
+
+        $response = $this->postJson(self::ENDPOINT, [
+            'oid' => $order->order_number,
+            'price' => 20000,
+        ]);
+
+        $response->assertStatus(409)
+            ->assertJsonPath('errors.message.0', 'Order is not retryable for NHN KCP payment.');
+
+        $order->refresh();
+        $this->assertEquals(OrderStatusEnum::CANCELLED, $order->order_status);
+        $this->assertEquals(PaymentStatusEnum::FAILED, $order->payment->payment_status);
+    }
+
+    public function test_retry_rejects_buyer_mismatch(): void
+    {
+        $order = $this->createOrder(20000);
+        OrderAddressFactory::new()->create([
+            'order_id' => $order->id,
+            'address_type' => 'shipping',
+            'orderer_email' => 'buyer@example.com',
+            'orderer_phone' => '010-1234-5678',
+        ]);
+
+        $response = $this->postJson(self::ENDPOINT, [
+            'oid' => $order->order_number,
+            'price' => 20000,
+            'buyer_email' => 'attacker@example.com',
+            'buyer_phone' => '01012345678',
+        ]);
+
+        $response->assertStatus(403)
+            ->assertJsonPath('errors.message.0', 'Order buyer verification failed.');
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/ShippingAndCouponCancellationTest.php b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/ShippingAndCouponCancellationTest.php
new file mode 100644
index 00000000..44cdfeae
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/ShippingAndCouponCancellationTest.php
@@ -0,0 +1,704 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Tests\Feature\Controllers;
+
+use App\Extension\HookListenerRegistrar;
+use App\Extension\HookManager;
+use App\Models\User;
+use Illuminate\Support\Facades\Cache;
+use Illuminate\Support\Facades\Queue;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderPaymentFactory;
+use Modules\Sirsoft\Ecommerce\Enums\CouponIssueRecordStatus;
+use Modules\Sirsoft\Ecommerce\Enums\OrderStatusEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentMethodEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentStatusEnum;
+use Modules\Sirsoft\Ecommerce\Enums\SequenceType;
+use Modules\Sirsoft\Ecommerce\Models\Coupon;
+use Modules\Sirsoft\Ecommerce\Models\CouponIssue;
+use Modules\Sirsoft\Ecommerce\Models\Order;
+use Modules\Sirsoft\Ecommerce\Models\OrderOption;
+use Modules\Sirsoft\Ecommerce\Models\OrderPayment;
+use Modules\Sirsoft\Ecommerce\Models\OrderRefund;
+use Modules\Sirsoft\Ecommerce\Models\OrderShipping;
+use Modules\Sirsoft\Ecommerce\Models\Sequence;
+use Plugins\Sirsoft\PayNhnkcp\Listeners\PaymentRefundListener;
+use Plugins\Sirsoft\PayNhnkcp\Services\NhnKcpApiService;
+use Plugins\Sirsoft\PayNhnkcp\Tests\PluginTestCase;
+
+/**
+ * NHN KCP 결제 플러그인 — 배송비·쿠폰 적용 취소 통합 테스트
+ *
+ * CLAUDE.local.md 의 "미검증 시나리오" 4건 (배송정책 + 전체/부분취소,
+ * 프로모션 + 전체/부분취소) 을 NHN KCP 결제 경로에 대해 검증.
+ * NicePayments / KG Inicis 와 동일한 시나리오 매트릭스를 따라
+ * OrderCancellationService → PaymentRefundListener → NhnKcpApiService 의
+ * 통합 경로를 점검한다.
+ */
+class ShippingAndCouponCancellationTest extends PluginTestCase
+{
+    private const TNO = 'TNO_KCP_TEST_001';
+
+    private const CANCEL_SUCCESS = [
+        'res_cd'  => '0000',
+        'res_msg' => '취소 성공',
+        'tno'     => 'TNO_CANCEL_KCP',
+    ];
+
+    protected User $adminUser;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        Queue::fake();
+
+        $this->adminUser = $this->createAdminUser(['sirsoft-ecommerce.orders.update']);
+        $this->createCancelSequences();
+
+        // 테스트 DB 시더가 plugin 레코드를 등록하지 않아
+        // PluginManager::registerPluginHookListeners() 의 active 가드에서 skip 되므로
+        // 테스트에서 직접 listener 를 등록한다.
+        HookListenerRegistrar::register(PaymentRefundListener::class, 'sirsoft-pay_nhnkcp');
+    }
+
+    protected function tearDown(): void
+    {
+        HookManager::resetAll();
+        HookListenerRegistrar::clear();
+        parent::tearDown();
+    }
+
+    // ────────────────────────────────────────────
+    // Mock 헬퍼
+    // ────────────────────────────────────────────
+
+    private function stubKcpCancelSuccess(): void
+    {
+        $mock = $this->createMock(NhnKcpApiService::class);
+        $mock->method('cancelPayment')->willReturn(self::CANCEL_SUCCESS);
+        $this->app->instance(NhnKcpApiService::class, $mock);
+    }
+
+    private function expectKcpCancelOnce(): \PHPUnit\Framework\MockObject\MockObject
+    {
+        $mock = $this->createMock(NhnKcpApiService::class);
+        $mock->expects($this->once())
+            ->method('cancelPayment')
+            ->willReturn(self::CANCEL_SUCCESS);
+        $this->app->instance(NhnKcpApiService::class, $mock);
+
+        return $mock;
+    }
+
+    private function expectKcpCancelNever(): void
+    {
+        $mock = $this->createMock(NhnKcpApiService::class);
+        $mock->expects($this->never())->method('cancelPayment');
+        $this->app->instance(NhnKcpApiService::class, $mock);
+    }
+
+    private function stubKcpCancelFailure(string $errorMsg = 'NHN KCP 취소 실패'): void
+    {
+        $mock = $this->createMock(NhnKcpApiService::class);
+        $mock->method('cancelPayment')->willThrowException(new \Exception($errorMsg));
+        $this->app->instance(NhnKcpApiService::class, $mock);
+    }
+
+    private function mockCouponRestore(): void
+    {
+        HookManager::addAction(
+            'sirsoft-ecommerce.coupon.restore',
+            function (Order $order, array $couponIssueIds) {
+                CouponIssue::whereIn('id', $couponIssueIds)->update([
+                    'status'   => CouponIssueRecordStatus::AVAILABLE->value,
+                    'used_at'  => null,
+                    'order_id' => null,
+                ]);
+            },
+            10
+        );
+    }
+
+    // ────────────────────────────────────────────
+    // 주문 생성 헬퍼
+    // ────────────────────────────────────────────
+
+    private function createCancelSequences(): void
+    {
+        foreach ([SequenceType::CANCEL, SequenceType::REFUND] as $type) {
+            $cfg = $type->getDefaultConfig();
+            Sequence::firstOrCreate(
+                ['type' => $type->value],
+                [
+                    'algorithm'     => $cfg['algorithm']->value,
+                    'prefix'        => $cfg['prefix'],
+                    'current_value' => 0,
+                    'increment'     => 1,
+                    'min_value'     => 1,
+                    'max_value'     => $cfg['max_value'],
+                    'cycle'         => false,
+                    'pad_length'    => $cfg['pad_length'],
+                ]
+            );
+        }
+    }
+
+    /**
+     * @return array{order: Order, options: OrderOption[], payment: OrderPayment, shipping: OrderShipping}
+     */
+    private function createKcpOrderWithShipping(
+        int $optionCount = 1,
+        int $unitPrice = 20000,
+        int $shippingFee = 3000,
+        string $tno = self::TNO,
+    ): array {
+        $user     = User::factory()->create();
+        $subtotal = $unitPrice * $optionCount;
+        $total    = $subtotal + $shippingFee;
+
+        $order = Order::factory()->create([
+            'user_id'                          => $user->id,
+            'order_status'                     => OrderStatusEnum::PAYMENT_COMPLETE,
+            'subtotal_amount'                  => $subtotal,
+            'total_shipping_amount'            => $shippingFee,
+            'total_amount'                     => $total,
+            'total_paid_amount'                => $total,
+            'total_due_amount'                 => 0,
+            'total_cancelled_amount'           => 0,
+            'cancellation_count'               => 0,
+            'paid_at'                          => now(),
+            'promotions_applied_snapshot'      => [],
+            'shipping_policy_applied_snapshot' => [],
+        ]);
+
+        $options = [];
+        for ($i = 0; $i < $optionCount; $i++) {
+            $options[] = OrderOption::factory()->forOrder($order)->create([
+                'quantity'                 => 1,
+                'unit_price'               => $unitPrice,
+                'subtotal_price'           => $unitPrice,
+                'subtotal_paid_amount'     => $unitPrice,
+                'subtotal_discount_amount' => 0,
+                'option_status'            => OrderStatusEnum::PAYMENT_COMPLETE,
+                'product_snapshot'         => [
+                    'id' => null, 'name' => ['ko' => '테스트상품', 'en' => 'Test Product'],
+                    'product_code' => null, 'sku' => null, 'brand_id' => null,
+                    'list_price' => $unitPrice, 'selling_price' => $unitPrice,
+                    'currency_code' => 'KRW', 'stock_quantity' => 100,
+                    'tax_status' => 'taxable', 'tax_rate' => 10,
+                    'has_options' => false, 'option_groups' => null, 'thumbnail_url' => null,
+                ],
+                'option_snapshot'          => [
+                    'id' => null, 'option_code' => null, 'option_values' => null,
+                    'option_name' => '기본', 'price_adjustment' => 0,
+                    'list_price' => $unitPrice, 'selling_price' => $unitPrice,
+                    'currency_code' => 'KRW', 'stock_quantity' => 100,
+                    'weight' => 0.5, 'volume' => 0.01, 'sku' => null, 'is_default' => true,
+                ],
+            ]);
+        }
+
+        $payment = OrderPaymentFactory::new()->forOrder($order)->create([
+            'payment_status'    => PaymentStatusEnum::PAID,
+            'payment_method'    => PaymentMethodEnum::CARD,
+            'pg_provider'       => 'nhnkcp',
+            'paid_amount_local' => $total,
+            'paid_amount_base'  => $total,
+            'cancelled_amount'  => 0,
+            'paid_at'           => now(),
+            'transaction_id'    => $tno,
+        ]);
+
+        $shipping = OrderShipping::factory()->forOrder($order)->create([
+            'order_option_id'       => $options[0]->id,
+            'base_shipping_amount'  => $shippingFee,
+            'total_shipping_amount' => $shippingFee,
+        ]);
+
+        return compact('order', 'options', 'payment', 'shipping');
+    }
+
+    /**
+     * @return array{order: Order, options: OrderOption[], payment: OrderPayment, couponIssue: CouponIssue}
+     */
+    private function createKcpOrderWithCoupon(
+        int $optionCount = 1,
+        int $unitPrice = 30000,
+        int $couponDiscount = 3000,
+        int $minOrderAmount = 0,
+        string $tno = self::TNO,
+    ): array {
+        $user     = User::factory()->create();
+        $subtotal = $unitPrice * $optionCount;
+        $paid     = $subtotal - $couponDiscount;
+
+        $order = Order::factory()->create([
+            'user_id'                            => $user->id,
+            'order_status'                       => OrderStatusEnum::PAYMENT_COMPLETE,
+            'subtotal_amount'                    => $subtotal,
+            'total_shipping_amount'              => 0,
+            'total_amount'                       => $subtotal,
+            'total_coupon_discount_amount'       => $couponDiscount,
+            'total_order_coupon_discount_amount' => $couponDiscount,
+            'total_paid_amount'                  => $paid,
+            'total_due_amount'                   => 0,
+            'total_cancelled_amount'             => 0,
+            'cancellation_count'                 => 0,
+            'paid_at'                            => now(),
+            'shipping_policy_applied_snapshot'   => [],
+        ]);
+
+        $options = [];
+        $perBase = (int) round($couponDiscount / $optionCount);
+        for ($i = 0; $i < $optionCount; $i++) {
+            $perDisc   = $i < ($optionCount - 1)
+                ? $perBase
+                : $couponDiscount - $perBase * ($optionCount - 1);
+            $options[] = OrderOption::factory()->forOrder($order)->create([
+                'quantity'                 => 1,
+                'unit_price'               => $unitPrice,
+                'subtotal_price'           => $unitPrice,
+                'subtotal_paid_amount'     => $unitPrice - $perDisc,
+                'subtotal_discount_amount' => $perDisc,
+                'option_status'            => OrderStatusEnum::PAYMENT_COMPLETE,
+                'product_snapshot'         => [
+                    'id' => null, 'name' => ['ko' => '테스트상품', 'en' => 'Test Product'],
+                    'product_code' => null, 'sku' => null, 'brand_id' => null,
+                    'list_price' => $unitPrice, 'selling_price' => $unitPrice,
+                    'currency_code' => 'KRW', 'stock_quantity' => 100,
+                    'tax_status' => 'taxable', 'tax_rate' => 10,
+                    'has_options' => false, 'option_groups' => null, 'thumbnail_url' => null,
+                ],
+                'option_snapshot'          => [
+                    'id' => null, 'option_code' => null, 'option_values' => null,
+                    'option_name' => '기본', 'price_adjustment' => 0,
+                    'list_price' => $unitPrice, 'selling_price' => $unitPrice,
+                    'currency_code' => 'KRW', 'stock_quantity' => 100,
+                    'weight' => 0.5, 'volume' => 0.01, 'sku' => null, 'is_default' => true,
+                ],
+            ]);
+        }
+
+        $payment = OrderPaymentFactory::new()->forOrder($order)->create([
+            'payment_status'    => PaymentStatusEnum::PAID,
+            'payment_method'    => PaymentMethodEnum::CARD,
+            'pg_provider'       => 'nhnkcp',
+            'paid_amount_local' => $paid,
+            'paid_amount_base'  => $paid,
+            'cancelled_amount'  => 0,
+            'paid_at'           => now(),
+            'transaction_id'    => $tno,
+        ]);
+
+        $coupon = Coupon::create([
+            'name'            => '검수용 테스트 쿠폰',
+            'target_type'     => 'order_amount',
+            'discount_type'   => 'fixed',
+            'discount_value'  => $couponDiscount,
+            'issue_method'    => 'direct',
+            'issue_condition' => 'manual',
+            'issue_status'    => 'issuing',
+            'total_quantity'  => 100,
+            'issued_count'    => 1,
+            'per_user_limit'  => 1,
+            'valid_type'      => 'period',
+            'is_combinable'   => false,
+        ]);
+
+        $couponIssue = CouponIssue::create([
+            'coupon_id'       => $coupon->id,
+            'user_id'         => $order->user_id,
+            'coupon_code'     => 'TEST-' . strtoupper(uniqid()),
+            'status'          => CouponIssueRecordStatus::USED->value,
+            'issued_at'       => now(),
+            'used_at'         => now(),
+            'order_id'        => $order->id,
+            'discount_amount' => $couponDiscount,
+        ]);
+
+        $order->update([
+            'promotions_applied_snapshot' => [
+                'coupon_issue_ids' => [$couponIssue->id],
+                'order_promotions' => [
+                    'coupons' => [[
+                        'coupon_issue_id'  => $couponIssue->id,
+                        'discount_type'    => 'fixed',
+                        'discount_value'   => $couponDiscount,
+                        'min_order_amount' => $minOrderAmount,
+                        'applied_amount'   => $couponDiscount,
+                    ]],
+                ],
+            ],
+        ]);
+
+        return compact('order', 'options', 'payment', 'couponIssue');
+    }
+
+    // ====================================================
+    // 1. 배송정책 + 전체취소
+    // ====================================================
+
+    public function test_full_cancel_with_shipping_calls_kcp_once_and_refunds_shipping(): void
+    {
+        $this->expectKcpCancelOnce();
+
+        $data  = $this->createKcpOrderWithShipping(optionCount: 1, unitPrice: 20000, shippingFee: 3000);
+        $order = $data['order'];
+
+        $response = $this->actingAs($this->adminUser)
+            ->postJson("/api/modules/sirsoft-ecommerce/admin/orders/{$order->order_number}/cancel", [
+                'type'      => 'full',
+                'reason'    => 'changed_mind',
+                'cancel_pg' => true,
+            ]);
+
+        $response->assertOk()->assertJsonPath('success', true);
+
+        $order->refresh();
+        $this->assertEquals(OrderStatusEnum::CANCELLED, $order->order_status);
+
+        $refund = OrderRefund::where('order_id', $order->id)->first();
+        $this->assertNotNull($refund);
+        $this->assertEquals(3000, (float) $refund->refund_shipping_amount, '배송비 3,000원이 환불 레코드에 포함되어야 합니다');
+        $this->assertEquals(23000, (float) $refund->refund_amount, '상품(20,000) + 배송비(3,000) = 23,000원 환불');
+    }
+
+    public function test_full_cancel_passes_full_amount_to_kcp_with_partial_flag_false(): void
+    {
+        // KCP cancelPayment 시그니처: (tno, ordrIdxx, cancelAmt, cancelMsg, isPartial, totalAmt)
+        $mock = $this->createMock(NhnKcpApiService::class);
+        $mock->expects($this->once())
+            ->method('cancelPayment')
+            ->with(
+                self::TNO,          // tno
+                $this->anything(),  // ordrIdxx (order_number)
+                23000,              // cancelAmt
+                $this->anything(),  // cancelMsg
+                $this->anything(),  // isPartial — listener 가 결정
+                $this->anything(),  // totalAmt
+            )
+            ->willReturn(self::CANCEL_SUCCESS);
+        $this->app->instance(NhnKcpApiService::class, $mock);
+
+        $data  = $this->createKcpOrderWithShipping(optionCount: 1, unitPrice: 20000, shippingFee: 3000);
+        $order = $data['order'];
+
+        $this->actingAs($this->adminUser)
+            ->postJson("/api/modules/sirsoft-ecommerce/admin/orders/{$order->order_number}/cancel", [
+                'type'      => 'full',
+                'reason'    => 'changed_mind',
+                'cancel_pg' => true,
+            ])->assertOk()->assertJsonPath('success', true);
+    }
+
+    public function test_cancel_restores_payment_time_credentials_before_kcp_refund(): void
+    {
+        $mock = $this->createMock(NhnKcpApiService::class);
+        $mock->expects($this->once())
+            ->method('useStoredCredentials')
+            ->with(false, 'SR123456');
+        $mock->expects($this->once())
+            ->method('cancelPayment')
+            ->willReturn(self::CANCEL_SUCCESS);
+        $this->app->instance(NhnKcpApiService::class, $mock);
+
+        $data = $this->createKcpOrderWithShipping(optionCount: 1, unitPrice: 20000, shippingFee: 3000);
+        $order = $data['order'];
+        $payment = $data['payment'];
+        $payment->update([
+            'payment_meta' => [
+                'is_test_mode' => false,
+                'site_cd' => 'SR123456',
+            ],
+        ]);
+
+        $this->actingAs($this->adminUser)
+            ->postJson("/api/modules/sirsoft-ecommerce/admin/orders/{$order->order_number}/cancel", [
+                'type'      => 'full',
+                'reason'    => 'changed_mind',
+                'cancel_pg' => true,
+            ])->assertOk()->assertJsonPath('success', true);
+    }
+
+    public function test_refund_returns_i18n_error_when_same_payment_is_already_refunding(): void
+    {
+        $data = $this->createKcpOrderWithShipping(optionCount: 1, unitPrice: 20000, shippingFee: 3000);
+        $order = $data['order'];
+        $payment = $data['payment'];
+        $lock = Cache::lock('nhnkcp:refund:' . $payment->id, 30);
+        $this->assertTrue($lock->get(), 'precondition: refund lock should be acquired');
+
+        try {
+            $listener = new PaymentRefundListener();
+
+            $result = $listener->processRefund([], $order, $payment, 23000, '동시 환불 테스트');
+
+            $this->assertFalse($result['success']);
+            $this->assertSame('REFUND_IN_PROGRESS', $result['error_code']);
+            $this->assertSame(
+                __('sirsoft-pay_nhnkcp::messages.refund.in_progress'),
+                $result['error_message']
+            );
+        } finally {
+            $lock->release();
+        }
+    }
+
+    public function test_full_cancel_free_shipping_refunds_only_product_amount(): void
+    {
+        $this->stubKcpCancelSuccess();
+
+        $data  = $this->createKcpOrderWithShipping(optionCount: 1, unitPrice: 30000, shippingFee: 0);
+        $order = $data['order'];
+
+        $response = $this->actingAs($this->adminUser)
+            ->postJson("/api/modules/sirsoft-ecommerce/admin/orders/{$order->order_number}/cancel", [
+                'type'      => 'full',
+                'reason'    => 'changed_mind',
+                'cancel_pg' => true,
+            ]);
+
+        $response->assertOk()->assertJsonPath('success', true);
+
+        $refund = OrderRefund::where('order_id', $order->id)->first();
+        $this->assertNotNull($refund);
+        $this->assertEquals(0, (float) $refund->refund_shipping_amount);
+        $this->assertEquals(30000, (float) $refund->refund_amount);
+    }
+
+    // ====================================================
+    // 2. 배송정책 + 부분취소
+    // ====================================================
+
+    public function test_partial_cancel_with_shipping_creates_refund_record(): void
+    {
+        $mock = $this->createMock(NhnKcpApiService::class);
+        $mock->expects($this->once())
+            ->method('cancelPayment')
+            ->with(
+                self::TNO,
+                $this->anything(),
+                23000,
+                $this->anything(),
+                true,
+                43000,
+            )
+            ->willReturn(self::CANCEL_SUCCESS);
+        $this->app->instance(NhnKcpApiService::class, $mock);
+
+        $data    = $this->createKcpOrderWithShipping(optionCount: 2, unitPrice: 20000, shippingFee: 3000);
+        $order   = $data['order'];
+        $options = $data['options'];
+
+        $response = $this->actingAs($this->adminUser)
+            ->postJson("/api/modules/sirsoft-ecommerce/admin/orders/{$order->order_number}/cancel", [
+                'type'      => 'partial',
+                'items'     => [['order_option_id' => $options[0]->id, 'cancel_quantity' => 1]],
+                'reason'    => 'changed_mind',
+                'cancel_pg' => true,
+            ]);
+
+        $response->assertOk()->assertJsonPath('success', true);
+
+        $order->refresh();
+        // 부분취소는 별도 주문 상태(partial_cancelled)를 두지 않는다 — 주문 상태는 진행 상태(결제완료)를
+        // 유지하고, 취소된 옵션만 CANCELLED 로 전이된다(OrderStatusEnum::PARTIAL_CANCELLED 폐기).
+        $this->assertEquals(OrderStatusEnum::PAYMENT_COMPLETE, $order->order_status);
+        $this->assertEquals(OrderStatusEnum::CANCELLED, $options[0]->refresh()->option_status);
+
+        $refund = OrderRefund::where('order_id', $order->id)->first();
+        $this->assertNotNull($refund, '부분취소 후 환불 레코드가 생성되어야 합니다');
+        $this->assertEquals(3000, (float) $refund->refund_shipping_amount, '부분취소 시 배송비 차액 3,000원이 포함되어야 합니다');
+        $this->assertEquals(23000, (float) $refund->refund_amount, '상품(20,000) + 배송비 차액(3,000) = 23,000원 환불');
+    }
+
+    public function test_partial_cancel_without_pg_never_calls_kcp_api(): void
+    {
+        $this->expectKcpCancelNever();
+
+        $data    = $this->createKcpOrderWithShipping(optionCount: 2, unitPrice: 20000, shippingFee: 3000);
+        $order   = $data['order'];
+        $options = $data['options'];
+        $originalPaid = (float) $order->total_paid_amount;
+
+        $response = $this->actingAs($this->adminUser)
+            ->postJson("/api/modules/sirsoft-ecommerce/admin/orders/{$order->order_number}/cancel", [
+                'type'      => 'partial',
+                'items'     => [['order_option_id' => $options[0]->id, 'cancel_quantity' => 1]],
+                'reason'    => 'changed_mind',
+                'cancel_pg' => false,
+            ]);
+
+        $response->assertOk()->assertJsonPath('success', true);
+
+        $refund = OrderRefund::where('order_id', $order->id)->first();
+        $this->assertNotNull($refund);
+        $this->assertGreaterThan(0, (float) $refund->refund_amount);
+        $this->assertLessThanOrEqual($originalPaid, (float) $refund->refund_amount);
+    }
+
+    // ====================================================
+    // 3. 쿠폰 적용 + 전체취소
+    // ====================================================
+
+    public function test_full_cancel_with_coupon_refunds_paid_amount_and_restores_coupon(): void
+    {
+        $this->stubKcpCancelSuccess();
+        $this->mockCouponRestore();
+
+        $data        = $this->createKcpOrderWithCoupon(optionCount: 1, unitPrice: 30000, couponDiscount: 3000);
+        $order       = $data['order'];
+        $couponIssue = $data['couponIssue'];
+
+        $response = $this->actingAs($this->adminUser)
+            ->postJson("/api/modules/sirsoft-ecommerce/admin/orders/{$order->order_number}/cancel", [
+                'type'      => 'full',
+                'reason'    => 'changed_mind',
+                'cancel_pg' => true,
+            ]);
+
+        $response->assertOk()->assertJsonPath('success', true);
+
+        $refund = OrderRefund::where('order_id', $order->id)->first();
+        $this->assertNotNull($refund);
+        $this->assertEquals(27000, (float) $refund->refund_amount, '쿠폰 할인 후 실결제금액(27,000원)이 환불되어야 합니다');
+
+        $couponIssue->refresh();
+        $this->assertEquals(CouponIssueRecordStatus::AVAILABLE, $couponIssue->status, '쿠폰이 AVAILABLE 로 복원되어야 합니다');
+        $this->assertNull($couponIssue->order_id, '복원된 쿠폰의 order_id 가 null 이어야 합니다');
+    }
+
+    public function test_full_cancel_with_coupon_passes_paid_amount_to_kcp(): void
+    {
+        // 쿠폰 할인 후 실결제금액(27,000원)이 PG cancelAmt 인자로 전달되어야 함
+        $mock = $this->createMock(NhnKcpApiService::class);
+        $mock->expects($this->once())
+            ->method('cancelPayment')
+            ->with(
+                self::TNO,
+                $this->anything(),
+                27000,              // cancelAmt = 쿠폰 차감 후 실결제금액
+                $this->anything(),
+                $this->anything(),
+                $this->anything(),
+            )
+            ->willReturn(self::CANCEL_SUCCESS);
+        $this->app->instance(NhnKcpApiService::class, $mock);
+
+        $this->mockCouponRestore();
+
+        $data  = $this->createKcpOrderWithCoupon(optionCount: 1, unitPrice: 30000, couponDiscount: 3000);
+        $order = $data['order'];
+
+        $this->actingAs($this->adminUser)
+            ->postJson("/api/modules/sirsoft-ecommerce/admin/orders/{$order->order_number}/cancel", [
+                'type'      => 'full',
+                'reason'    => 'changed_mind',
+                'cancel_pg' => true,
+            ])->assertOk()->assertJsonPath('success', true);
+    }
+
+    // ====================================================
+    // 4. 쿠폰 적용 + 부분취소
+    // ====================================================
+
+    public function test_partial_cancel_with_coupon_succeeds_when_min_amount_still_met(): void
+    {
+        $this->stubKcpCancelSuccess();
+        $this->mockCouponRestore();
+
+        $data    = $this->createKcpOrderWithCoupon(
+            optionCount: 2, unitPrice: 30000, couponDiscount: 3000, minOrderAmount: 20000
+        );
+        $order   = $data['order'];
+        $options = $data['options'];
+
+        $response = $this->actingAs($this->adminUser)
+            ->postJson("/api/modules/sirsoft-ecommerce/admin/orders/{$order->order_number}/cancel", [
+                'type'      => 'partial',
+                'items'     => [['order_option_id' => $options[0]->id, 'cancel_quantity' => 1]],
+                'reason'    => 'changed_mind',
+                'cancel_pg' => true,
+            ]);
+
+        $response->assertOk()->assertJsonPath('success', true);
+        $order->refresh();
+        // 부분취소는 주문 상태(결제완료)를 유지하고 취소된 옵션만 CANCELLED 로 전이된다(PARTIAL_CANCELLED 폐기).
+        $this->assertEquals(OrderStatusEnum::PAYMENT_COMPLETE, $order->order_status);
+        $this->assertEquals(OrderStatusEnum::CANCELLED, $options[0]->refresh()->option_status);
+    }
+
+    public function test_partial_cancel_rejected_when_coupon_condition_no_longer_met(): void
+    {
+        $this->expectKcpCancelNever();
+
+        $data    = $this->createKcpOrderWithCoupon(
+            optionCount: 2, unitPrice: 20000, couponDiscount: 22000, minOrderAmount: 30000
+        );
+        $order   = $data['order'];
+        $options = $data['options'];
+
+        $response = $this->actingAs($this->adminUser)
+            ->postJson("/api/modules/sirsoft-ecommerce/admin/orders/{$order->order_number}/cancel", [
+                'type'      => 'partial',
+                'items'     => [['order_option_id' => $options[0]->id, 'cancel_quantity' => 1]],
+                'reason'    => 'changed_mind',
+                'cancel_pg' => true,
+            ]);
+
+        $response->assertStatus(422)->assertJsonPath('success', false);
+    }
+
+    // ====================================================
+    // 5. NHN KCP API 오류
+    // ====================================================
+
+    public function test_cancel_fails_and_rolls_back_when_kcp_api_throws(): void
+    {
+        $this->stubKcpCancelFailure('NHN KCP 취소 실패: 거래가 만료되었습니다');
+
+        $data  = $this->createKcpOrderWithShipping(optionCount: 1, unitPrice: 20000, shippingFee: 3000);
+        $order = $data['order'];
+
+        $response = $this->actingAs($this->adminUser)
+            ->postJson("/api/modules/sirsoft-ecommerce/admin/orders/{$order->order_number}/cancel", [
+                'type'      => 'full',
+                'reason'    => 'changed_mind',
+                'cancel_pg' => true,
+            ]);
+
+        $response->assertStatus(422)->assertJsonPath('success', false);
+
+        $order->refresh();
+        $this->assertNotEquals(OrderStatusEnum::CANCELLED, $order->order_status, 'PG 환불 실패 시 주문 상태 변경이 롤백되어야 합니다');
+    }
+
+    // ====================================================
+    // 6. non-nhnkcp PG 주문에 대한 무간섭 검증
+    // ====================================================
+
+    public function test_listener_skips_non_nhnkcp_payment(): void
+    {
+        $this->expectKcpCancelNever();
+
+        $data    = $this->createKcpOrderWithShipping(optionCount: 1, unitPrice: 20000, shippingFee: 3000);
+        $order   = $data['order'];
+        $payment = $data['payment'];
+
+        $payment->update(['pg_provider' => 'other_pg']);
+
+        $response = $this->actingAs($this->adminUser)
+            ->postJson("/api/modules/sirsoft-ecommerce/admin/orders/{$order->order_number}/cancel", [
+                'type'      => 'full',
+                'reason'    => 'changed_mind',
+                'cancel_pg' => false,
+            ]);
+
+        $response->assertOk()->assertJsonPath('success', true);
+
+        $order->refresh();
+        $this->assertEquals(OrderStatusEnum::CANCELLED, $order->order_status);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/UserReceiptControllerTest.php b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/UserReceiptControllerTest.php
new file mode 100644
index 00000000..b31af577
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Controllers/UserReceiptControllerTest.php
@@ -0,0 +1,193 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Tests\Feature\Controllers;
+
+use App\Models\User;
+use Illuminate\Cookie\Middleware\EncryptCookies;
+use Illuminate\Support\Facades\Hash;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderFactory;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderPaymentFactory;
+use Modules\Sirsoft\Ecommerce\Enums\OrderStatusEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentMethodEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentStatusEnum;
+use Modules\Sirsoft\Ecommerce\Services\GuestOrderAuthService;
+use Plugins\Sirsoft\PayNhnkcp\Tests\PluginTestCase;
+
+class UserReceiptControllerTest extends PluginTestCase
+{
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        // 운영에서는 PayNhnkcpServiceProvider::boot 가 동일하게 등록한다.
+        EncryptCookies::except(['nhnkcp_receipt_token']);
+    }
+
+    public function test_receipt_response_includes_easy_pay_display_label(): void
+    {
+        app()->setLocale('ko');
+
+        $user = User::factory()->create();
+        $order = OrderFactory::new()->create([
+            'user_id' => $user->id,
+            'order_number' => 'ORD-KCP-RECEIPT-' . random_int(10000, 99999),
+            'order_status' => OrderStatusEnum::PAYMENT_COMPLETE,
+            'total_amount' => 50000,
+            'total_due_amount' => 0,
+            'total_paid_amount' => 50000,
+            'paid_at' => now(),
+        ]);
+
+        OrderPaymentFactory::new()->create([
+            'order_id' => $order->id,
+            'payment_status' => PaymentStatusEnum::PAID,
+            'payment_method' => PaymentMethodEnum::CARD,
+            'pg_provider' => 'nhnkcp',
+            'transaction_id' => 'KCP_TNO_NAVERPAY',
+            'embedded_pg_provider' => 'naverpay',
+            'paid_amount_local' => 50000,
+            'paid_at' => now(),
+            'payment_meta' => [
+                'nhnkcp_easy_pay_method' => 'nhnkcp_naverpay',
+                'nhnkcp_easy_pay_provider' => 'naverpay',
+                'nhnkcp_easy_pay_label' => [
+                    'ko' => '네이버페이',
+                    'en' => 'NaverPay',
+                ],
+            ],
+        ]);
+
+        $response = $this->actingAs($user)
+            ->getJson("/api/plugins/sirsoft-pay_nhnkcp/user/orders/{$order->order_number}/receipt");
+
+        $response->assertOk()
+            ->assertJsonPath('selected_payment_method', 'nhnkcp_naverpay')
+            ->assertJsonPath('embedded_pg_provider', 'naverpay');
+
+        $data = $response->json();
+        $this->assertContains($data['embedded_pg_provider_label'] ?? null, ['네이버페이', 'NaverPay']);
+        $this->assertSame(
+            ($data['embedded_pg_provider_label'] ?? '') . ' (' . ($data['payment_method_label'] ?? '') . ')',
+            $data['payment_method_display_label'] ?? null,
+        );
+    }
+
+    public function test_guest_receipt_requires_valid_token(): void
+    {
+        $order = $this->createGuestOrder();
+        $this->createKcpPayment($order, 'KCP_TNO_GUEST_001');
+
+        $this->getJson("/api/plugins/sirsoft-pay_nhnkcp/user/orders/{$order->order_number}/receipt")
+            ->assertNotFound();
+
+        $this->withHeader('X-Guest-Order-Token', (time() + 1800).'|'.str_repeat('0', 64))
+            ->getJson("/api/plugins/sirsoft-pay_nhnkcp/user/orders/{$order->order_number}/receipt")
+            ->assertNotFound();
+    }
+
+    public function test_guest_receipt_returns_receipt_url_with_valid_header_token(): void
+    {
+        app()->setLocale('ko');
+
+        $order = $this->createGuestOrder();
+        $this->createKcpPayment($order, 'KCP_TNO_GUEST_002');
+
+        $response = $this->withHeader('X-Guest-Order-Token', $this->issueGuestToken($order))
+            ->getJson("/api/plugins/sirsoft-pay_nhnkcp/user/orders/{$order->order_number}/receipt")
+            ->assertOk()
+            ->assertJsonPath('receipt_url', 'https://testadmin8.kcp.co.kr/assist/bill.BillActionNew.do?cmd=card_bill&tno=KCP_TNO_GUEST_002&order_no='.$order->order_number.'&trade_mony=1000');
+
+        $this->assertContains($response->json('payment_method_label'), ['신용카드', 'Credit Card']);
+    }
+
+    public function test_guest_receipt_returns_receipt_url_with_valid_cookie(): void
+    {
+        $order = $this->createGuestOrder();
+        $this->createKcpPayment($order, 'KCP_TNO_GUEST_003');
+
+        $this->withUnencryptedCookie('nhnkcp_receipt_token', $this->issueReceiptCookie($order->order_number))
+            ->withCredentials()
+            ->getJson("/api/plugins/sirsoft-pay_nhnkcp/user/orders/{$order->order_number}/receipt")
+            ->assertOk()
+            ->assertJsonPath('receipt_url', 'https://testadmin8.kcp.co.kr/assist/bill.BillActionNew.do?cmd=card_bill&tno=KCP_TNO_GUEST_003&order_no='.$order->order_number.'&trade_mony=1000');
+    }
+
+    public function test_guest_token_for_other_order_cannot_access_receipt(): void
+    {
+        $order1 = $this->createGuestOrder();
+        $order2 = $this->createGuestOrder();
+        $this->createKcpPayment($order1, 'KCP_TNO_GUEST_004');
+        $this->createKcpPayment($order2, 'KCP_TNO_GUEST_005');
+
+        $this->withHeader('X-Guest-Order-Token', $this->issueGuestToken($order1))
+            ->getJson("/api/plugins/sirsoft-pay_nhnkcp/user/orders/{$order2->order_number}/receipt")
+            ->assertNotFound();
+    }
+
+    public function test_authenticated_user_cannot_access_guest_order_receipt_via_token(): void
+    {
+        $user = User::factory()->create();
+        $order = $this->createGuestOrder();
+        $this->createKcpPayment($order, 'KCP_TNO_GUEST_006');
+
+        $this->actingAs($user)
+            ->withHeader('X-Guest-Order-Token', $this->issueGuestToken($order))
+            ->getJson("/api/plugins/sirsoft-pay_nhnkcp/user/orders/{$order->order_number}/receipt")
+            ->assertNotFound();
+    }
+
+    private function createGuestOrder()
+    {
+        return OrderFactory::new()->create([
+            'user_id' => null,
+            'guest_lookup_password_hash' => Hash::make('test1234'),
+            'order_number' => 'ORD-KCP-GUEST-' . random_int(10000, 99999),
+            'order_status' => OrderStatusEnum::PAYMENT_COMPLETE,
+            'total_amount' => 1000,
+            'total_due_amount' => 0,
+            'total_paid_amount' => 1000,
+            'paid_at' => now(),
+        ]);
+    }
+
+    private function createKcpPayment($order, string $transactionId): void
+    {
+        OrderPaymentFactory::new()->create([
+            'order_id' => $order->id,
+            'payment_status' => PaymentStatusEnum::PAID,
+            'payment_method' => PaymentMethodEnum::CARD,
+            'pg_provider' => 'nhnkcp',
+            'transaction_id' => $transactionId,
+            'paid_amount_local' => 1000,
+            'paid_at' => now(),
+            'payment_meta' => [],
+        ]);
+    }
+
+    private function issueGuestToken($order): string
+    {
+        $svc = app(GuestOrderAuthService::class);
+        $rc = new \ReflectionClass($svc);
+        $signMethod = $rc->getMethod('sign');
+        $signMethod->setAccessible(true);
+        $suffixMethod = $rc->getMethod('passwordHashSuffix');
+        $suffixMethod->setAccessible(true);
+
+        $expiresTs = time() + 1800;
+        $suffix = $suffixMethod->invoke($svc, $order);
+        $sig = $signMethod->invoke($svc, $order->order_number, (int) $order->id, $expiresTs, $suffix);
+
+        return $expiresTs.'|'.$sig;
+    }
+
+    private function issueReceiptCookie(string $orderNumber): string
+    {
+        $expiresTs = time() + 300;
+        $payload = $orderNumber.'|'.$expiresTs;
+        $signature = hash_hmac('sha256', $payload, (string) config('app.key', ''));
+
+        return $payload.'|'.$signature;
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Middleware/RestrictKcpIpTest.php b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Middleware/RestrictKcpIpTest.php
new file mode 100644
index 00000000..b33b4202
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Middleware/RestrictKcpIpTest.php
@@ -0,0 +1,135 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Tests\Feature\Middleware;
+
+use App\Services\PluginSettingsService;
+use Plugins\Sirsoft\PayNhnkcp\Tests\PluginTestCase;
+
+/**
+ * RestrictKcpIp 미들웨어 회귀 테스트
+ *
+ * 적용 라우트: vbank-notify, escrow-common-notify (KCP 서버 발신 webhook)
+ *   - 테스트 모드 (is_test_mode=true): 우회 — 개발/모의입금 흐름 허용
+ *   - 운영 모드 (is_test_mode=false): 화이트리스트 외 IP 403 차단
+ *
+ * 그누보드5 settle_kcp_common.php 의 $default['de_card_test'] 분기와 동일.
+ */
+class RestrictKcpIpTest extends PluginTestCase
+{
+    private const KCP_WHITELIST_IP = '203.238.36.58';
+
+    private const KCP_PANGYO_IP = '103.215.144.173';
+
+    private const UNAUTHORIZED_IP = '1.2.3.4';
+
+    private function mockSettings(bool $isTestMode): void
+    {
+        $mock = $this->createMock(PluginSettingsService::class);
+        $mock->method('get')->willReturn([
+            'is_test_mode' => $isTestMode,
+            'redirect_success_url' => '/shop/orders/{orderId}/complete',
+            'redirect_fail_url'    => '/shop/checkout',
+        ]);
+        $this->app->instance(PluginSettingsService::class, $mock);
+    }
+
+    private function mockSettingsWithoutMode(): void
+    {
+        $mock = $this->createMock(PluginSettingsService::class);
+        $mock->method('get')->willReturn([
+            'redirect_success_url' => '/shop/orders/{orderId}/complete',
+            'redirect_fail_url'    => '/shop/checkout',
+        ]);
+        $this->app->instance(PluginSettingsService::class, $mock);
+    }
+
+    private function postVbankNotify(string $remoteIp): \Illuminate\Testing\TestResponse
+    {
+        return $this->withServerVariables(['REMOTE_ADDR' => $remoteIp])
+            ->post('/plugins/sirsoft-pay_nhnkcp/payment/vbank-notify', [
+                'tno'       => 'KCP_TNO_TEST',
+                'order_no'  => 'ORD-IP-TEST',
+                'tx_cd'     => 'TX00',
+                'op_cd'     => '50',
+                'ipgm_mnyx' => 30000,
+            ]);
+    }
+
+    public function test_blocks_unauthorized_ip_in_live_mode(): void
+    {
+        $this->mockSettings(isTestMode: false);
+
+        $response = $this->postVbankNotify(self::UNAUTHORIZED_IP);
+
+        $response->assertForbidden();
+    }
+
+    public function test_missing_test_mode_setting_fails_closed_for_unauthorized_ip(): void
+    {
+        $this->mockSettingsWithoutMode();
+
+        $response = $this->postVbankNotify(self::UNAUTHORIZED_IP);
+
+        $response->assertForbidden();
+    }
+
+    public function test_allows_whitelisted_kcp_ip_in_live_mode(): void
+    {
+        $this->mockSettings(isTestMode: false);
+
+        $response = $this->postVbankNotify(self::KCP_WHITELIST_IP);
+
+        // 미들웨어 통과 후 컨트롤러까지 도달 → 200 + KCP result HTML 응답.
+        // (주문 미존재로 컨트롤러는 result=0000 응답하지만 핵심은 403 이 아니라는 것)
+        $response->assertOk();
+        $this->assertStringContainsString('name="result"', $response->getContent());
+    }
+
+    public function test_allows_pangyo_idc_ip_in_live_mode(): void
+    {
+        $this->mockSettings(isTestMode: false);
+
+        $response = $this->postVbankNotify(self::KCP_PANGYO_IP);
+
+        $response->assertOk();
+    }
+
+    /**
+     * 테스트 모드: 모든 IP 허용 — 개발 환경 + KCP testadmin 모의입금 webhook 흐름 보장
+     * (그누보드5 settle_kcp_common.php 의 $default['de_card_test'] 우회 동일).
+     */
+    public function test_bypasses_check_in_test_mode(): void
+    {
+        $this->mockSettings(isTestMode: true);
+
+        $response = $this->postVbankNotify(self::UNAUTHORIZED_IP);
+
+        $response->assertOk();
+    }
+
+    /**
+     * 화이트리스트 8개 IP 전수 통과 (운영 모드).
+     */
+    public function test_all_whitelisted_ips_pass_in_live_mode(): void
+    {
+        $this->mockSettings(isTestMode: false);
+
+        $whitelist = [
+            '203.238.36.58',
+            '203.238.36.160',
+            '203.238.36.161',
+            '203.238.36.173',
+            '203.238.36.178',
+            '103.215.144.173',
+            '103.215.144.174',
+            '103.215.145.30',
+        ];
+
+        foreach ($whitelist as $ip) {
+            $response = $this->postVbankNotify($ip);
+            $response->assertStatus(200, "Whitelisted IP {$ip} should not be blocked");
+        }
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/tests/PluginTestCase.php b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/PluginTestCase.php
new file mode 100644
index 00000000..67dcca48
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/PluginTestCase.php
@@ -0,0 +1,181 @@
+<?php
+
+namespace Plugins\Sirsoft\PayNhnkcp\Tests;
+
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Tests\TestCase;
+
+abstract class PluginTestCase extends TestCase
+{
+    use RefreshDatabase;
+
+    protected function shouldSeed(): bool
+    {
+        return true;
+    }
+
+    protected function seeder(): string
+    {
+        return \Modules\Sirsoft\Ecommerce\Database\Seeders\TestingSeeder::class;
+    }
+
+    protected function migrateFreshUsing(): array
+    {
+        return [
+            '--drop-views' => $this->shouldDropViews(),
+            '--drop-types' => $this->shouldDropTypes(),
+            '--seed' => $this->shouldSeed(),
+            '--seeder' => $this->seeder(),
+            '--path' => [
+                'database/migrations',
+                'modules/sirsoft-ecommerce/database/migrations',
+            ],
+        ];
+    }
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        $this->registerModuleAutoload();
+        $this->registerPluginAutoload();
+
+        $this->app->register(\Modules\Sirsoft\Ecommerce\Providers\EcommerceServiceProvider::class);
+
+        $this->registerModuleRoutes();
+        $this->registerPluginRoutes();
+
+        // SettingsServiceProvider 가 storage/app/settings/general.json 의 site_url 로
+        // app.url 을 override 하면 Laravel 의 assertRedirect (APP_URL 기반) 와 mismatch.
+        // 테스트 환경에서는 APP_URL 그대로 사용하도록 명시 리셋.
+        \Illuminate\Support\Facades\Config::set('app.url', env('APP_URL', 'http://localhost'));
+    }
+
+    protected function registerModuleAutoload(): void
+    {
+        $moduleBasePath = base_path('modules/sirsoft-ecommerce/src/');
+
+        spl_autoload_register(function ($class) use ($moduleBasePath) {
+            $prefix = 'Modules\\Sirsoft\\Ecommerce\\';
+            $len = strlen($prefix);
+
+            if (strncmp($prefix, $class, $len) !== 0) {
+                return;
+            }
+
+            $relativeClass = substr($class, $len);
+            $file = $moduleBasePath . str_replace('\\', '/', $relativeClass) . '.php';
+
+            if (file_exists($file)) {
+                require $file;
+            }
+        });
+
+        $helpersFile = $moduleBasePath . 'Helpers/helpers.php';
+        if (file_exists($helpersFile)) {
+            require_once $helpersFile;
+        }
+    }
+
+    protected function registerPluginAutoload(): void
+    {
+        $pluginBasePath = base_path('plugins/sirsoft-pay_nhnkcp/src/');
+
+        spl_autoload_register(function ($class) use ($pluginBasePath) {
+            $prefix = 'Plugins\\Sirsoft\\Nhnkcp\\';
+            $len = strlen($prefix);
+
+            if (strncmp($prefix, $class, $len) !== 0) {
+                return;
+            }
+
+            $relativeClass = substr($class, $len);
+            $file = $pluginBasePath . str_replace('\\', '/', $relativeClass) . '.php';
+
+            if (file_exists($file)) {
+                require $file;
+            }
+        });
+    }
+
+    protected function registerModuleRoutes(): void
+    {
+        $apiRoutesFile = base_path('modules/sirsoft-ecommerce/src/routes/api.php');
+
+        if (file_exists($apiRoutesFile)) {
+            \Illuminate\Support\Facades\Route::prefix('api/modules/sirsoft-ecommerce')
+                ->name('api.modules.sirsoft-ecommerce.')
+                ->middleware('api')
+                ->group($apiRoutesFile);
+        }
+    }
+
+    protected function registerPluginRoutes(): void
+    {
+        $webRoutesFile = base_path('plugins/sirsoft-pay_nhnkcp/src/routes/web.php');
+
+        if (file_exists($webRoutesFile)) {
+            \Illuminate\Support\Facades\Route::prefix('plugins/sirsoft-pay_nhnkcp')
+                ->name('plugins.sirsoft-pay_nhnkcp.')
+                ->middleware('web')
+                ->group($webRoutesFile);
+        }
+
+        $apiRoutesFile = base_path('plugins/sirsoft-pay_nhnkcp/src/routes/api.php');
+
+        if (file_exists($apiRoutesFile)) {
+            \Illuminate\Support\Facades\Route::prefix('api/plugins/sirsoft-pay_nhnkcp')
+                ->name('api.plugins.sirsoft-pay_nhnkcp.')
+                ->middleware('api')
+                ->group($apiRoutesFile);
+        }
+    }
+
+    protected function createAdminUser(array $permissions = []): \App\Models\User
+    {
+        $user = \App\Models\User::factory()->create();
+
+        $uniqueRoleIdentifier = 'admin-test-' . $user->id . '-' . time();
+        $userRole = \App\Models\Role::create([
+            'identifier' => $uniqueRoleIdentifier,
+            'name' => ['ko' => '테스트 관리자', 'en' => 'Test Admin'],
+        ]);
+        $user->roles()->attach($userRole->id);
+
+        $adminAccessPermission = \App\Models\Permission::firstOrCreate(
+            ['identifier' => 'admin.access'],
+            [
+                'name' => ['ko' => '관리자 접근', 'en' => 'Admin Access'],
+                'type' => \App\Enums\PermissionType::Admin,
+            ]
+        );
+        $userRole->permissions()->attach($adminAccessPermission->id);
+
+        if (! empty($permissions)) {
+            foreach ($permissions as $permissionIdentifier) {
+                $permission = \App\Models\Permission::firstOrCreate(
+                    ['identifier' => $permissionIdentifier],
+                    [
+                        'name' => ['ko' => $permissionIdentifier, 'en' => $permissionIdentifier],
+                        'type' => 'admin',
+                    ]
+                );
+                $userRole->permissions()->syncWithoutDetaching([$permission->id]);
+            }
+        }
+
+        return $user;
+    }
+
+    protected function createUser(): \App\Models\User
+    {
+        $userRole = \App\Models\Role::where('identifier', 'user')->first();
+        $user = \App\Models\User::factory()->create();
+
+        if ($userRole) {
+            $user->roles()->attach($userRole->id);
+        }
+
+        return $user;
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Unit/Concerns/IssuesReceiptCookieTest.php b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Unit/Concerns/IssuesReceiptCookieTest.php
new file mode 100644
index 00000000..e3f9f09f
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Unit/Concerns/IssuesReceiptCookieTest.php
@@ -0,0 +1,92 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Tests\Unit\Concerns;
+
+use Plugins\Sirsoft\PayNhnkcp\Concerns\IssuesReceiptCookie;
+use Plugins\Sirsoft\PayNhnkcp\Tests\PluginTestCase;
+
+/**
+ * 영수증 cookie HMAC 검증 로직 단위 테스트.
+ *
+ * HTTP 통합(callback → Set-Cookie → 후속 호출에서 cookie 자동 첨부) 검증은
+ * Playwright 시나리오로 다룬다 — Laravel 의 EncryptCookies 미들웨어와 PHPUnit
+ * HTTP 테스트 환경의 cookie 처리 흐름이 production 과 일부 다르기 때문.
+ */
+class IssuesReceiptCookieTest extends PluginTestCase
+{
+    private object $subject;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        // IssuesReceiptCookie 는 trait — 익명 클래스로 인스턴스화
+        $this->subject = new class {
+            use IssuesReceiptCookie {
+                verifyReceiptCookie as public;
+            }
+        };
+    }
+
+    public function test_verify_succeeds_with_fresh_token_matching_order_number(): void
+    {
+        $orderNumber = 'ORD-RECEIPT-12345';
+        $cookieValue = $this->buildToken($orderNumber, time() + 300);
+
+        $this->assertTrue($this->subject->verifyReceiptCookie($cookieValue, $orderNumber));
+    }
+
+    public function test_verify_fails_when_cookie_missing(): void
+    {
+        $this->assertFalse($this->subject->verifyReceiptCookie(null, 'ORD-RECEIPT-99999'));
+        $this->assertFalse($this->subject->verifyReceiptCookie('', 'ORD-RECEIPT-99999'));
+    }
+
+    public function test_verify_fails_when_token_format_invalid(): void
+    {
+        // 3-파트 미충족
+        $this->assertFalse($this->subject->verifyReceiptCookie('ORD-X|123', 'ORD-X'));
+        // 만료시각이 숫자 아님
+        $this->assertFalse($this->subject->verifyReceiptCookie('ORD-X|abc|'.str_repeat('0', 64), 'ORD-X'));
+        // 서명이 hex 아님
+        $this->assertFalse($this->subject->verifyReceiptCookie('ORD-X|'.(time() + 300).'|invalid_sig', 'ORD-X'));
+    }
+
+    public function test_verify_fails_when_token_expired(): void
+    {
+        $orderNumber = 'ORD-RECEIPT-EXPIRED';
+        $expiredCookie = $this->buildToken($orderNumber, time() - 60);
+
+        $this->assertFalse($this->subject->verifyReceiptCookie($expiredCookie, $orderNumber));
+    }
+
+    public function test_verify_fails_when_order_number_mismatched(): void
+    {
+        $tokenFor = 'ORD-RECEIPT-AAA';
+        $accessing = 'ORD-RECEIPT-BBB';
+        $cookieValue = $this->buildToken($tokenFor, time() + 300);
+
+        // cookie 의 payload 가 다른 주문번호이므로 reject
+        $this->assertFalse($this->subject->verifyReceiptCookie($cookieValue, $accessing));
+    }
+
+    public function test_verify_fails_when_signature_tampered(): void
+    {
+        $orderNumber = 'ORD-RECEIPT-TAMPER';
+        $expiresTs = time() + 300;
+        // 정상 서명 대신 0으로 가득 찬 위조 서명
+        $tampered = $orderNumber.'|'.$expiresTs.'|'.str_repeat('0', 64);
+
+        $this->assertFalse($this->subject->verifyReceiptCookie($tampered, $orderNumber));
+    }
+
+    private function buildToken(string $orderNumber, int $expiresTs): string
+    {
+        $payload = $orderNumber.'|'.$expiresTs;
+        $signature = hash_hmac('sha256', $payload, (string) config('app.key', ''));
+
+        return $orderNumber.'|'.$expiresTs.'|'.$signature;
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Unit/Controllers/HealthCheckControllerTest.php b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Unit/Controllers/HealthCheckControllerTest.php
new file mode 100644
index 00000000..a02d0906
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Unit/Controllers/HealthCheckControllerTest.php
@@ -0,0 +1,45 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Tests\Unit\Controllers;
+
+use Illuminate\Support\Facades\Http;
+use Plugins\Sirsoft\PayNhnkcp\Controllers\HealthCheckController;
+use Tests\TestCase;
+
+require_once dirname(__DIR__, 3) . '/src/Controllers/HealthCheckController.php';
+
+class HealthCheckControllerTest extends TestCase
+{
+    public function test_health_summary_exposes_public_cancel_server_ip(): void
+    {
+        Http::fake([
+            'api.ipify.org*' => Http::response(['ip' => '203.0.113.45']),
+        ]);
+
+        $response = (new HealthCheckController())->check();
+        $payload = $response->getData(true);
+
+        $this->assertSame('203.0.113.45', data_get($payload, 'data.summary.cancel_server_ip.address'));
+        $this->assertSame('public_outbound', data_get($payload, 'data.summary.cancel_server_ip.source'));
+        $this->assertSame('공인 송신 IP', data_get($payload, 'data.summary.cancel_server_ip.source_label'));
+    }
+
+    public function test_health_summary_falls_back_to_server_addr_when_public_ip_lookup_fails(): void
+    {
+        Http::fake([
+            'api.ipify.org*' => Http::response([], 500),
+        ]);
+
+        $this->app['request']->server->set('SERVER_ADDR', '198.51.100.7');
+        $_SERVER['SERVER_ADDR'] = '198.51.100.7';
+
+        $response = (new HealthCheckController())->check();
+        $payload = $response->getData(true);
+
+        $this->assertSame('198.51.100.7', data_get($payload, 'data.summary.cancel_server_ip.address'));
+        $this->assertSame('server_variable', data_get($payload, 'data.summary.cancel_server_ip.source'));
+        $this->assertSame('서버 IP 후보', data_get($payload, 'data.summary.cancel_server_ip.source_label'));
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Unit/Listeners/AdjustEcommercePaymentMethodsLayoutListenerTest.php b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Unit/Listeners/AdjustEcommercePaymentMethodsLayoutListenerTest.php
new file mode 100644
index 00000000..1ad3458e
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Unit/Listeners/AdjustEcommercePaymentMethodsLayoutListenerTest.php
@@ -0,0 +1,115 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Tests\Unit\Listeners;
+
+use PHPUnit\Framework\TestCase;
+use Plugins\Sirsoft\PayNhnkcp\Listeners\AdjustEcommercePaymentMethodsLayoutListener;
+
+class AdjustEcommercePaymentMethodsLayoutListenerTest extends TestCase
+{
+    public function test_subscribes_to_layout_after_apply_as_filter(): void
+    {
+        $hooks = AdjustEcommercePaymentMethodsLayoutListener::getSubscribedHooks();
+
+        $this->assertSame(
+            'filter',
+            $hooks['core.layout_extension.after_apply']['type'] ?? null
+        );
+        $this->assertSame(
+            'markEasyPayMethodsAsPgNotRequired',
+            $hooks['core.layout_extension.after_apply']['method'] ?? null
+        );
+    }
+
+    public function test_marks_nhnkcp_easy_pay_methods_as_pg_not_required_in_admin_ecommerce_settings(): void
+    {
+        $listener = new AdjustEcommercePaymentMethodsLayoutListener();
+
+        $layout = [
+            'layout_name' => 'admin_ecommerce_settings',
+            'components' => [
+                [
+                    'type' => 'basic',
+                    'name' => 'Select',
+                    'if' => "{{!['point','deposit','free','dbank'].includes(\$method.id) && (_local.form?.available_pg_providers ?? []).length > 0}}",
+                ],
+                [
+                    'type' => 'composite',
+                    'name' => 'Toggle',
+                    'props' => [
+                        'disabled' => "{{_computed.isReadOnly || !['point','deposit','free','dbank','kginicis_naverpay'].includes(\$method.id) && !\$method.pg_provider && !_local.form?.order_settings?.default_pg_provider}}",
+                    ],
+                ],
+            ],
+        ];
+
+        $result = $listener->markEasyPayMethodsAsPgNotRequired($layout, 1);
+        $json = json_encode($result, JSON_UNESCAPED_SLASHES);
+
+        $this->assertIsString($json);
+        $this->assertStringContainsString('kginicis_naverpay', $json);
+        $this->assertStringContainsString('nhnkcp_payco', $json);
+        $this->assertStringContainsString('nhnkcp_naverpay', $json);
+        $this->assertStringContainsString('nhnkcp_naverpay_point', $json);
+        $this->assertStringContainsString('nhnkcp_kakaopay', $json);
+        $this->assertStringContainsString('nhnkcp_applepay', $json);
+        $this->assertStringNotContainsString("['point','deposit','free','dbank'].includes", $json);
+    }
+
+    public function test_adds_test_mode_warning_to_order_settings_tab(): void
+    {
+        $listener = new AdjustEcommercePaymentMethodsLayoutListener();
+
+        $layout = [
+            'layout_name' => 'admin_ecommerce_settings',
+            'children' => [
+                [
+                    'id' => 'tab_content_order_settings',
+                    'children' => [
+                        ['id' => 'default_pg_card'],
+                        ['id' => 'payment_methods_card'],
+                    ],
+                ],
+            ],
+        ];
+
+        $result = $listener->markEasyPayMethodsAsPgNotRequired($layout, 1);
+        $result = $listener->markEasyPayMethodsAsPgNotRequired($result, 1);
+        $json = json_encode($result, JSON_UNESCAPED_SLASHES);
+
+        $this->assertIsString($json);
+        $this->assertStringContainsString('nhnkcp_test_mode_status', $json);
+        $this->assertStringContainsString('/api/plugins/sirsoft-pay_nhnkcp/admin/settings/test-mode-status', $json);
+        $this->assertStringContainsString('payment_test_mode_order_settings_notice', $json);
+        $this->assertStringContainsString('nhnkcp_test_mode_order_settings_notice', $json);
+        $this->assertStringNotContainsString('sirsoft-pay_nhnkcp.admin.test_mode_settings_summary_title', $json);
+        $this->assertStringNotContainsString('sirsoft-pay_nhnkcp.admin.test_mode_settings_summary_body', $json);
+        $this->assertStringContainsString('sirsoft-pay_nhnkcp.admin.test_mode_settings_warning_plugin', $json);
+        $this->assertStringContainsString('sirsoft-pay_nhnkcp.admin.test_mode_settings_warning_body', $json);
+        $this->assertStringContainsString('/admin/plugins/sirsoft-pay_nhnkcp/settings', $json);
+        $this->assertSame(1, substr_count($json, 'payment_test_mode_order_settings_notice'));
+        $this->assertSame(1, substr_count($json, 'nhnkcp_test_mode_order_settings_notice'));
+        $this->assertLessThan(
+            strpos($json, 'payment_methods_card'),
+            strpos($json, 'payment_test_mode_order_settings_notice')
+        );
+    }
+
+    public function test_leaves_other_layouts_unchanged(): void
+    {
+        $listener = new AdjustEcommercePaymentMethodsLayoutListener();
+
+        $layout = [
+            'layout_name' => 'shop/checkout',
+            'components' => [
+                [
+                    'if' => "{{!['point','deposit','free','dbank'].includes(\$method.id)}}",
+                ],
+            ],
+        ];
+
+        $this->assertSame($layout, $listener->markEasyPayMethodsAsPgNotRequired($layout, 1));
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Unit/Listeners/EnsureAdminOrderLayoutExtensionsListenerTest.php b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Unit/Listeners/EnsureAdminOrderLayoutExtensionsListenerTest.php
new file mode 100644
index 00000000..08ec72e4
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Unit/Listeners/EnsureAdminOrderLayoutExtensionsListenerTest.php
@@ -0,0 +1,270 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Tests\Unit\Listeners;
+
+use PHPUnit\Framework\TestCase;
+use Plugins\Sirsoft\PayNhnkcp\Listeners\EnsureAdminOrderDetailPaymentQueryLayoutListener;
+use Plugins\Sirsoft\PayNhnkcp\Listeners\EnsureAdminOrderListTestBadgeLayoutListener;
+
+class EnsureAdminOrderLayoutExtensionsListenerTest extends TestCase
+{
+    public function test_list_listener_ensures_test_mode_data_source_and_badge(): void
+    {
+        $listener = new EnsureAdminOrderListTestBadgeLayoutListener();
+
+        $result = $listener->ensureTestBadgeLayout($this->makeOrderListLayout(), 1);
+        $json = json_encode($result, JSON_UNESCAPED_SLASHES);
+
+        $this->assertSame(1, $this->countDataSources($result, 'nhnkcp_test_map'));
+        $this->assertSame(1, $this->countDataSources($result, 'nhnkcp_easy_pay_display_map'));
+        $this->assertSame(1, $this->countString($result, 'nhnkcp_test_map.data?.[row.order_number] === true'));
+        $this->assertSame(1, $this->countString($result, 'nhnkcp_easy_pay_display_map.data?.[row.order_number]?.payment_method_display_label ?? row.payment?.payment_method_label'));
+        $this->assertIsString($json);
+        $this->assertStringContainsString('/api/plugins/sirsoft-pay_nhnkcp/admin/orders/test-mode-map', $json);
+        $this->assertStringContainsString('/api/plugins/sirsoft-pay_nhnkcp/admin/orders/easy-pay-display-map', $json);
+        $this->assertStringContainsString('sirsoft-pay_nhnkcp.admin.test_mode_badge', $json);
+    }
+
+    public function test_list_listener_is_idempotent(): void
+    {
+        $listener = new EnsureAdminOrderListTestBadgeLayoutListener();
+
+        $once = $listener->ensureTestBadgeLayout($this->makeOrderListLayout(), 1);
+        $twice = $listener->ensureTestBadgeLayout($once, 1);
+
+        $this->assertSame(1, $this->countDataSources($twice, 'nhnkcp_test_map'));
+        $this->assertSame(1, $this->countDataSources($twice, 'nhnkcp_easy_pay_display_map'));
+        $this->assertSame(1, $this->countString($twice, 'nhnkcp_test_map.data?.[row.order_number] === true'));
+        $this->assertSame(1, $this->countString($twice, 'nhnkcp_easy_pay_display_map.data?.[row.order_number]?.payment_method_display_label ?? row.payment?.payment_method_label'));
+    }
+
+    public function test_detail_listener_ensures_test_notice_and_payment_panels(): void
+    {
+        $listener = new EnsureAdminOrderDetailPaymentQueryLayoutListener();
+
+        $result = $listener->ensurePaymentQueryLayout($this->makeOrderDetailLayout(), 1);
+        $header = $this->findNodeById($result, 'page_header_section');
+        $tabContent = $this->findNodeById($result, 'tab_content_area');
+        $wrapper = $this->findNodeById($result, 'order_detail_wrapper');
+        $json = json_encode($result, JSON_UNESCAPED_SLASHES);
+
+        $this->assertSame(1, $this->countDataSources($result, 'kcp_status'));
+        $this->assertSame(1, $this->countDataSources($result, 'kcp_escrow_delivery'));
+        $this->assertIsArray($header);
+        $this->assertIsArray($tabContent);
+        $this->assertIsArray($wrapper);
+        $this->assertSame(1, $this->countNodeId($header, 'nhnkcp_test_mode_notice'));
+        $this->assertSame(1, $this->countNodeId($tabContent, 'kcp_info_panel'));
+        $this->assertSame(1, $this->countNodeId($tabContent, 'kcp_escrow_delivery_panel'));
+        $this->assertSame(0, $this->countDirectChildId($wrapper, 'kcp_info_panel'));
+        $this->assertIsString($json);
+        $this->assertStringContainsString('kcp_status.data?._is_test_mode === true', $json);
+        $this->assertStringContainsString('sirsoft-pay_nhnkcp.admin.order_info_title', $json);
+        $this->assertStringContainsString("kcp_status.data?.payment_status === 'cancelled'", $json);
+        $this->assertStringContainsString("kcp_status.data?.refund_status === 'completed'", $json);
+        $this->assertStringContainsString('sirsoft-pay_nhnkcp.admin.pay_status_cancel_completed', $json);
+        $this->assertStringContainsString('sirsoft-pay_nhnkcp.admin.result_payment_status', $json);
+        $this->assertStringContainsString('sirsoft-pay_nhnkcp.admin.result_cancelled_amount', $json);
+        $this->assertStringContainsString('sirsoft-pay_nhnkcp.admin.result_refund_status', $json);
+    }
+
+    public function test_detail_listener_uses_wrapper_when_tab_content_area_is_renamed(): void
+    {
+        $listener = new EnsureAdminOrderDetailPaymentQueryLayoutListener();
+
+        $result = $listener->ensurePaymentQueryLayout($this->makeOrderDetailLayout(includeTabContentArea: false), 1);
+        $wrapper = $this->findNodeById($result, 'order_detail_wrapper');
+
+        $this->assertIsArray($wrapper);
+        $this->assertSame(1, $this->countDirectChildId($wrapper, 'kcp_info_panel'));
+    }
+
+    public function test_detail_listener_is_idempotent(): void
+    {
+        $listener = new EnsureAdminOrderDetailPaymentQueryLayoutListener();
+
+        $once = $listener->ensurePaymentQueryLayout($this->makeOrderDetailLayout(), 1);
+        $twice = $listener->ensurePaymentQueryLayout($once, 1);
+
+        $this->assertSame(1, $this->countDataSources($twice, 'kcp_status'));
+        $this->assertSame(1, $this->countNodeId($twice, 'nhnkcp_test_mode_notice'));
+        $this->assertSame(1, $this->countNodeId($twice, 'kcp_info_panel'));
+        $this->assertSame(1, $this->countNodeId($twice, 'kcp_escrow_delivery_panel'));
+    }
+
+    public function test_leaves_other_layouts_unchanged(): void
+    {
+        $listListener = new EnsureAdminOrderListTestBadgeLayoutListener();
+        $detailListener = new EnsureAdminOrderDetailPaymentQueryLayoutListener();
+        $layout = [
+            'layout_name' => 'shop/checkout',
+            'data_sources' => [],
+            'components' => [],
+        ];
+
+        $this->assertSame($layout, $listListener->ensureTestBadgeLayout($layout, 1));
+        $this->assertSame($layout, $detailListener->ensurePaymentQueryLayout($layout, 1));
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    private function makeOrderListLayout(): array
+    {
+        return [
+            'layout_name' => 'admin_ecommerce_order_list',
+            'data_sources' => [],
+            'components' => [
+                [
+                    'id' => 'order_datagrid',
+                    'type' => 'composite',
+                    'name' => 'DataGrid',
+                    'props' => [
+                        'columns' => [
+                            ['field' => 'order_number', 'cellChildren' => []],
+                            [
+                                'field' => 'payment_method',
+                                'cellChildren' => [
+                                    [
+                                        'type' => 'basic',
+                                        'name' => 'Div',
+                                        'children' => [
+                                            ['type' => 'basic', 'name' => 'Span', 'text' => '{{row.payment?.payment_method_label}}'],
+                                        ],
+                                    ],
+                                ],
+                            ],
+                        ],
+                    ],
+                ],
+            ],
+        ];
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    private function makeOrderDetailLayout(bool $includeTabContentArea = true): array
+    {
+        $children = [
+            [
+                'id' => 'page_header_section',
+                'type' => 'basic',
+                'name' => 'Div',
+                'children' => [
+                    ['id' => 'page_header', 'type' => 'basic', 'name' => 'Div'],
+                ],
+            ],
+        ];
+
+        if ($includeTabContentArea) {
+            $children[] = ['id' => 'tab_content_area', 'type' => 'basic', 'name' => 'Div', 'children' => []];
+        }
+
+        return [
+            'layout_name' => 'admin_ecommerce_order_detail',
+            'data_sources' => [],
+            'slots' => [
+                'content' => [
+                    [
+                        'id' => 'order_detail_wrapper',
+                        'type' => 'basic',
+                        'name' => 'Div',
+                        'children' => $children,
+                    ],
+                ],
+            ],
+        ];
+    }
+
+    /**
+     * @param array<string, mixed> $layout
+     */
+    private function countDataSources(array $layout, string $id): int
+    {
+        return count(array_filter(
+            $layout['data_sources'] ?? [],
+            static fn ($dataSource): bool => is_array($dataSource) && ($dataSource['id'] ?? null) === $id
+        ));
+    }
+
+    /**
+     * @param array<string|int, mixed> $node
+     */
+    private function countString(array $node, string $needle): int
+    {
+        $count = 0;
+
+        foreach ($node as $value) {
+            if (is_array($value)) {
+                $count += $this->countString($value, $needle);
+                continue;
+            }
+
+            if (is_string($value) && str_contains($value, $needle)) {
+                $count++;
+            }
+        }
+
+        return $count;
+    }
+
+    /**
+     * @param array<string|int, mixed> $node
+     */
+    private function countNodeId(array $node, string $id): int
+    {
+        $count = 0;
+
+        foreach ($node as $value) {
+            if (is_array($value)) {
+                $count += $this->countNodeId($value, $id);
+                continue;
+            }
+
+            if ($value === $id) {
+                $count++;
+            }
+        }
+
+        return $count;
+    }
+
+    /**
+     * @param array<string, mixed> $node
+     * @return array<string, mixed>|null
+     */
+    private function findNodeById(array $node, string $id): ?array
+    {
+        if (($node['id'] ?? null) === $id) {
+            return $node;
+        }
+
+        foreach ($node as $value) {
+            if (! is_array($value)) {
+                continue;
+            }
+
+            $found = $this->findNodeById($value, $id);
+
+            if (is_array($found)) {
+                return $found;
+            }
+        }
+
+        return null;
+    }
+
+    /**
+     * @param array<string, mixed> $node
+     */
+    private function countDirectChildId(array $node, string $id): int
+    {
+        return count(array_filter(
+            $node['children'] ?? [],
+            static fn ($child): bool => is_array($child) && ($child['id'] ?? null) === $id
+        ));
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Unit/Listeners/RegisterEasyPayMethodsListenerTest.php b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Unit/Listeners/RegisterEasyPayMethodsListenerTest.php
new file mode 100644
index 00000000..98349699
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Unit/Listeners/RegisterEasyPayMethodsListenerTest.php
@@ -0,0 +1,105 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Tests\Unit\Listeners;
+
+use Plugins\Sirsoft\PayNhnkcp\Listeners\RegisterEasyPayMethodsListener;
+use Plugins\Sirsoft\PayNhnkcp\Listeners\AdjustEcommercePaymentMethodsLayoutListener;
+use Plugins\Sirsoft\PayNhnkcp\Plugin;
+use Tests\TestCase;
+
+class RegisterEasyPayMethodsListenerTest extends TestCase
+{
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        $this->app['translator']->addNamespace(
+            'sirsoft-pay_nhnkcp',
+            base_path('plugins/_bundled/sirsoft-pay_nhnkcp/lang')
+        );
+    }
+
+    public function test_injects_easy_pay_methods_after_phone_and_existing_easy_pay_methods(): void
+    {
+        $listener = new RegisterEasyPayMethodsListener();
+
+        $methods = $listener->injectEasyPayMethods([
+            ['id' => 'card'],
+            ['id' => 'phone'],
+            ['id' => 'kginicis_samsung_pay'],
+            ['id' => 'kginicis_naverpay'],
+            ['id' => 'point'],
+            ['id' => 'deposit'],
+        ]);
+
+        $this->assertSame([
+            'card',
+            'phone',
+            'kginicis_samsung_pay',
+            'kginicis_naverpay',
+            'nhnkcp_payco',
+            'nhnkcp_naverpay',
+            'nhnkcp_naverpay_point',
+            'nhnkcp_kakaopay',
+            'nhnkcp_applepay',
+            'point',
+            'deposit',
+        ], array_column($methods, 'id'));
+    }
+
+    public function test_plugin_registers_easy_pay_hook_listeners(): void
+    {
+        $listeners = (new Plugin())->getHookListeners();
+
+        $this->assertContains(RegisterEasyPayMethodsListener::class, $listeners);
+        $this->assertContains(AdjustEcommercePaymentMethodsLayoutListener::class, $listeners);
+    }
+
+    public function test_easy_pay_methods_do_not_require_pg_provider_in_saved_defaults(): void
+    {
+        $listener = new RegisterEasyPayMethodsListener();
+
+        $methods = $listener->injectEasyPayMethods([
+            ['id' => 'phone'],
+            ['id' => 'point'],
+        ]);
+
+        $easyPayMethods = array_filter(
+            $methods,
+            fn (array $method): bool => str_starts_with((string) ($method['id'] ?? ''), 'nhnkcp_')
+        );
+
+        $this->assertCount(5, $easyPayMethods);
+
+        foreach ($easyPayMethods as $method) {
+            $this->assertArrayHasKey('defaults', $method);
+            $this->assertNull($method['defaults']['pg_provider'] ?? null);
+            $this->assertFalse($method['defaults']['is_active'] ?? true);
+            $this->assertSame('payment_complete', $method['defaults']['stock_deduction_timing'] ?? null);
+        }
+    }
+
+    public function test_easy_pay_method_labels_match_admin_payment_method_names(): void
+    {
+        $listener = new RegisterEasyPayMethodsListener();
+
+        $methods = $listener->injectEasyPayMethods([
+            ['id' => 'phone'],
+            ['id' => 'point'],
+        ]);
+
+        $naverpay = collect($methods)->firstWhere('id', 'nhnkcp_naverpay');
+        $payco = collect($methods)->firstWhere('id', 'nhnkcp_payco');
+        $applepay = collect($methods)->firstWhere('id', 'nhnkcp_applepay');
+
+        $this->assertSame('네이버페이 (카드)', $naverpay['name']['ko'] ?? null);
+        $this->assertSame('PAYCO', $payco['name']['ko'] ?? null);
+        $this->assertSame('Pay by Naver Pay credit card (NHN KCP)', $naverpay['description']['en'] ?? null);
+        $this->assertSame(
+            '애플페이로 결제 (NHN KCP) · 애플페이는 IOS 기기에 모바일결제만 가능합니다.',
+            $applepay['description']['ko'] ?? null,
+        );
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Unit/Listeners/RestoreLayoutExtensionsAfterUpdateListenerTest.php b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Unit/Listeners/RestoreLayoutExtensionsAfterUpdateListenerTest.php
new file mode 100644
index 00000000..c70c7af2
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Unit/Listeners/RestoreLayoutExtensionsAfterUpdateListenerTest.php
@@ -0,0 +1,111 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNhnkcp\Tests\Unit\Listeners;
+
+use App\Enums\LayoutExtensionType;
+use App\Enums\LayoutSourceType;
+use App\Models\LayoutExtension;
+use App\Models\Template;
+use App\Models\TemplateLayout;
+use Plugins\Sirsoft\PayNhnkcp\Listeners\RestoreLayoutExtensionsAfterUpdateListener;
+use Plugins\Sirsoft\PayNhnkcp\Plugin;
+use Plugins\Sirsoft\PayNhnkcp\Tests\PluginTestCase;
+
+class RestoreLayoutExtensionsAfterUpdateListenerTest extends PluginTestCase
+{
+    public function test_subscribes_to_plugin_updated_as_sync_action(): void
+    {
+        $hooks = RestoreLayoutExtensionsAfterUpdateListener::getSubscribedHooks();
+
+        $this->assertSame('action', $hooks['core.plugins.updated']['type'] ?? null);
+        $this->assertSame('restoreCurrentExtensionsAfterUpdate', $hooks['core.plugins.updated']['method'] ?? null);
+        $this->assertTrue($hooks['core.plugins.updated']['sync'] ?? false);
+    }
+
+    public function test_plugin_registers_layout_extension_restore_listener(): void
+    {
+        $this->assertContains(
+            RestoreLayoutExtensionsAfterUpdateListener::class,
+            (new Plugin())->getHookListeners()
+        );
+    }
+
+    public function test_restores_soft_deleted_current_extension_for_prefixed_module_layout(): void
+    {
+        $template = Template::factory()->create([
+            'identifier' => 'sirsoft-admin_basic',
+            'type' => 'admin',
+            'status' => 'active',
+        ]);
+
+        TemplateLayout::factory()->create([
+            'template_id' => $template->id,
+            'name' => 'sirsoft-ecommerce.admin_ecommerce_order_list',
+            'source_type' => LayoutSourceType::Module,
+            'source_identifier' => 'sirsoft-ecommerce',
+            'content' => [
+                'layout_name' => 'admin_ecommerce_order_list',
+                'components' => [],
+                'data_sources' => [],
+            ],
+        ]);
+
+        $extension = LayoutExtension::factory()
+            ->overlay()
+            ->fromPlugin('sirsoft-pay_nhnkcp')
+            ->targeting('admin_ecommerce_order_list')
+            ->create([
+                'template_id' => $template->id,
+                'content' => [
+                    'target_layout' => 'admin_ecommerce_order_list',
+                    'data_sources' => [],
+                    'injections' => [],
+                ],
+                'is_active' => true,
+            ]);
+        $extension->delete();
+
+        (new RestoreLayoutExtensionsAfterUpdateListener())
+            ->restoreCurrentExtensionsAfterUpdate('sirsoft-pay_nhnkcp');
+
+        $restored = LayoutExtension::withTrashed()->findOrFail($extension->id);
+
+        $this->assertFalse($restored->trashed());
+        $this->assertTrue($restored->is_active);
+        $this->assertSame(LayoutExtensionType::Overlay, $restored->extension_type);
+        $this->assertSame(LayoutSourceType::Plugin, $restored->source_type);
+        $this->assertSame('sirsoft-pay_nhnkcp', $restored->source_identifier);
+        $this->assertSame('admin_ecommerce_order_list', $restored->target_name);
+
+        $json = json_encode($restored->content, JSON_UNESCAPED_SLASHES);
+        $this->assertIsString($json);
+        $this->assertStringContainsString('nhnkcp_test_map', $json);
+    }
+
+    public function test_ignores_other_plugins(): void
+    {
+        $template = Template::factory()->create(['type' => 'admin']);
+
+        TemplateLayout::factory()->create([
+            'template_id' => $template->id,
+            'name' => 'sirsoft-ecommerce.admin_ecommerce_order_list',
+            'source_type' => LayoutSourceType::Module,
+            'source_identifier' => 'sirsoft-ecommerce',
+            'content' => ['layout_name' => 'admin_ecommerce_order_list'],
+        ]);
+
+        $extension = LayoutExtension::factory()
+            ->overlay()
+            ->fromPlugin('sirsoft-pay_nhnkcp')
+            ->targeting('admin_ecommerce_order_list')
+            ->create(['template_id' => $template->id]);
+        $extension->delete();
+
+        (new RestoreLayoutExtensionsAfterUpdateListener())
+            ->restoreCurrentExtensionsAfterUpdate('sirsoft-pay_nicepayments');
+
+        $this->assertTrue(LayoutExtension::withTrashed()->findOrFail($extension->id)->trashed());
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Unit/Services/CliInjectionDefenseTest.php b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Unit/Services/CliInjectionDefenseTest.php
new file mode 100644
index 00000000..2db5f0c1
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Unit/Services/CliInjectionDefenseTest.php
@@ -0,0 +1,165 @@
+<?php
+
+namespace Plugins\Sirsoft\PayNhnkcp\Tests\Unit\Services;
+
+use PHPUnit\Framework\TestCase;
+use Plugins\Sirsoft\PayNhnkcp\Exceptions\NhnKcpApiException;
+use Plugins\Sirsoft\PayNhnkcp\Services\NhnKcpApiService;
+
+/**
+ * Phase 3 PoC — NHN KCP CLI command injection 침투 시뮬레이션
+ *
+ * 본 테스트는 NhnKcpApiService::approvePayment 를 통해 흘러가는 사용자
+ * 제어 가능 인수에 셸 메타문자/제어문자를 주입했을 때 실제 CLI 가
+ * 실행되기 전에 NhnKcpApiException 으로 차단되는지 검증한다.
+ *
+ * 공격 시나리오:
+ *   1. encData 인수에 큰따옴표 + 명령 주입 시퀀스 삽입
+ *   2. encInfo 인수에 백틱 명령 치환 시퀀스 삽입
+ *   3. ordrIdxx 인수에 줄바꿈 (LF) 삽입 — 새 명령 인젝션 시도
+ *   4. custIp 인수에 NUL 바이트 삽입 — argv 절단 시도
+ *
+ * 기대 결과: 모든 케이스에서 assertSafeCliValue 가 NhnKcpApiException
+ * 을 throw 하여 exec() 호출이 일어나지 않는다.
+ *
+ * 정상 케이스: alphanumeric / URL / IP / base64-like 값은 통과.
+ */
+class CliInjectionDefenseTest extends TestCase
+{
+    /**
+     * Reflection 으로 private assertSafeCliValue 를 직접 호출.
+     * Laravel/Container 의존성 없이 순수 단위 테스트로 진행.
+     */
+    private function invokeAssertSafeCliValue(string $value, string $key = 'test_field'): void
+    {
+        // siteCd / siteKey 등의 NULL 체크를 우회하기 위해 ReflectionClass 로 인스턴스 생성
+        $reflection = new \ReflectionClass(NhnKcpApiService::class);
+        $instance = $reflection->newInstanceWithoutConstructor();
+
+        $method = $reflection->getMethod('assertSafeCliValue');
+        $method->setAccessible(true);
+        $method->invoke($instance, $value, $key);
+    }
+
+    /**
+     * @scenario context=approvePayment_encData, threat=cli_injection, callback_state=cli_arg_unsafe
+     * @effects cli_arg_rejects_double_quote, cli_arg_throws_runtime_exception_on_unsafe, cli_no_shell_executed_on_unsafe_input
+     */
+    public function test_double_quote_is_rejected(): void
+    {
+        $this->expectException(NhnKcpApiException::class);
+        $this->expectExceptionMessageMatches('/quote|backtick/');
+
+        $this->invokeAssertSafeCliValue('normalbase64data"; id > /tmp/g7_kcp_poc; #', 'enc_data');
+    }
+
+    /**
+     * @scenario context=approvePayment_encInfo, threat=cli_injection, callback_state=cli_arg_unsafe
+     * @effects cli_arg_rejects_backtick, cli_arg_throws_runtime_exception_on_unsafe
+     */
+    public function test_backtick_is_rejected(): void
+    {
+        $this->expectException(NhnKcpApiException::class);
+        $this->expectExceptionMessageMatches('/quote|backtick/');
+
+        $this->invokeAssertSafeCliValue('validinfo`whoami`', 'enc_info');
+    }
+
+    /**
+     * @scenario context=approvePayment_ordrIdxx, threat=cli_injection, callback_state=cli_arg_unsafe
+     * @effects cli_arg_rejects_control_char_low, cli_arg_throws_runtime_exception_on_unsafe
+     */
+    public function test_lf_is_rejected(): void
+    {
+        $this->expectException(NhnKcpApiException::class);
+        $this->expectExceptionMessageMatches('/control character/');
+
+        $this->invokeAssertSafeCliValue("ORD12345\nMALICIOUS_INJECT", 'ordr_idxx');
+    }
+
+    /**
+     * @scenario context=approvePayment_custIp, threat=cli_injection, callback_state=cli_arg_unsafe
+     * @effects cli_arg_rejects_null_byte, cli_arg_throws_runtime_exception_on_unsafe
+     */
+    public function test_null_byte_is_rejected(): void
+    {
+        $this->expectException(NhnKcpApiException::class);
+        $this->expectExceptionMessageMatches('/control character/');
+
+        $this->invokeAssertSafeCliValue("127.0.0.1\x00ATTACKER", 'cust_ip');
+    }
+
+    /**
+     * @scenario context=approvePayment_ordrIdxx, threat=cli_injection, callback_state=cli_arg_unsafe
+     * @effects cli_arg_rejects_control_char_low, cli_arg_throws_runtime_exception_on_unsafe
+     */
+    public function test_tab_is_rejected(): void
+    {
+        $this->expectException(NhnKcpApiException::class);
+        $this->expectExceptionMessageMatches('/control character/');
+
+        $this->invokeAssertSafeCliValue("ORD12345\tINJECT", 'ordr_idxx');
+    }
+
+    /**
+     * @scenario context=approvePayment_encData, threat=cli_injection, callback_state=cli_arg_unsafe
+     * @effects cli_arg_rejects_control_char_high, cli_arg_throws_runtime_exception_on_unsafe
+     */
+    public function test_del_char_0x7f_is_rejected(): void
+    {
+        $this->expectException(NhnKcpApiException::class);
+        $this->expectExceptionMessageMatches('/control character/');
+
+        $this->invokeAssertSafeCliValue("validdata\x7FINJECT", 'enc_data');
+    }
+
+    /**
+     * @scenario context=approvePayment_encData, threat=cli_injection, callback_state=cli_arg_unsafe
+     * @effects cli_arg_rejects_control_char_low, cli_arg_throws_runtime_exception_on_unsafe
+     */
+    public function test_cr_is_rejected(): void
+    {
+        $this->expectException(NhnKcpApiException::class);
+        $this->expectExceptionMessageMatches('/control character/');
+
+        $this->invokeAssertSafeCliValue("validdata\rINJECT", 'enc_data');
+    }
+
+    /**
+     * 추가 메타문자 케이스 — 큰따옴표/백틱 외 단일 변형
+     * @scenario context=approvePayment_encData, threat=cli_injection, callback_state=cli_arg_unsafe
+     * @effects cli_arg_rejects_double_quote, cli_arg_throws_runtime_exception_on_unsafe
+     */
+    public function test_simple_double_quote_alone_is_rejected(): void
+    {
+        $this->expectException(NhnKcpApiException::class);
+
+        $this->invokeAssertSafeCliValue('"', 'any');
+    }
+
+    /**
+     * 정상 케이스: alnum + base64 padding 통과
+     * @scenario context=approvePayment_normal, threat=cli_injection, callback_state=cli_arg_normal
+     * @effects cli_arg_accepts_alnum_only, cli_exec_uses_escapeshellarg
+     */
+    public function test_normal_alphanumeric_passes(): void
+    {
+        // 예외 미발생 = 통과
+        $this->invokeAssertSafeCliValue('YWJjZGVmMTIzNDU2Nzg5MA==', 'enc_data');
+        $this->invokeAssertSafeCliValue('ORD20260516001', 'ordr_idxx');
+        $this->invokeAssertSafeCliValue('127.0.0.1', 'cust_ip');
+        $this->invokeAssertSafeCliValue('https://example.com/path', 'pa_url');
+        $this->assertTrue(true, 'normal values passed sanitization');
+    }
+
+    /**
+     * Korean label 도 control char 아니므로 통과 (한글은 UTF-8 multibyte 로 0x80+)
+     * @scenario context=approvePayment_normal, threat=cli_injection, callback_state=cli_arg_normal
+     * @effects cli_arg_accepts_normal_korean_label
+     */
+    public function test_korean_label_passes(): void
+    {
+        $this->invokeAssertSafeCliValue('상품주문', 'cancel_msg');
+        $this->assertTrue(true);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Unit/Services/NhnKcpApiServiceTest.php b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Unit/Services/NhnKcpApiServiceTest.php
new file mode 100644
index 00000000..6fb596cd
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/Unit/Services/NhnKcpApiServiceTest.php
@@ -0,0 +1,508 @@
+<?php
+
+namespace Plugins\Sirsoft\PayNhnkcp\Tests\Unit\Services;
+
+use App\Services\PluginSettingsService;
+use Illuminate\Support\Facades\Http;
+use Plugins\Sirsoft\PayNhnkcp\Exceptions\NhnKcpApiException;
+use Plugins\Sirsoft\PayNhnkcp\Services\KcpSoapService;
+use Plugins\Sirsoft\PayNhnkcp\Services\NhnKcpApiService;
+use Plugins\Sirsoft\PayNhnkcp\Tests\PluginTestCase;
+
+class NhnKcpApiServiceTest extends PluginTestCase
+{
+    private const TEST_SITE_CD = 'T0000';
+
+    private const TEST_SITE_KEY = 'TEST_SITE_KEY_0000';
+
+    private function makeService(array $settingsOverrides = []): NhnKcpApiService
+    {
+        $defaults = [
+            'is_test_mode' => true,
+            'test_site_cd' => self::TEST_SITE_CD,
+            'test_site_key' => self::TEST_SITE_KEY,
+            'live_site_cd' => '',
+            'live_site_key' => '',
+        ];
+
+        $settingsMock = $this->createMock(PluginSettingsService::class);
+        $settingsMock->method('get')
+            ->willReturn(array_merge($defaults, $settingsOverrides));
+
+        return new NhnKcpApiService($settingsMock);
+    }
+
+    /**
+     * KCP CLI 실행을 외부 의존 없이 검증하기 위한 임시 바이너리 디렉터리 생성.
+     *
+     * @return array{service: NhnKcpApiService, dir: string, log: string}
+     */
+    private function makeServiceWithStubbedCli(string $response, array $settingsOverrides = []): array
+    {
+        $service = $this->makeService($settingsOverrides);
+        $dir = sys_get_temp_dir() . '/nhnkcp_cli_' . uniqid('', true);
+        $this->assertTrue(mkdir($dir), '임시 CLI 디렉터리 생성 실패');
+
+        $logPath = $dir . '/argv.log';
+        $responsePath = $dir . '/response.txt';
+        file_put_contents($responsePath, $response);
+
+        $script = "#!/bin/sh\n"
+            . "printf '%s\\n' \"\$@\" > " . escapeshellarg($logPath) . "\n"
+            . 'cat ' . escapeshellarg($responsePath) . "\n";
+
+        foreach (['pp_cli', 'pp_cli_x64'] as $binName) {
+            $binPath = $dir . '/' . $binName;
+            file_put_contents($binPath, $script);
+            chmod($binPath, 0755);
+        }
+
+        $reflection = new \ReflectionClass($service);
+        $property = $reflection->getProperty('binDir');
+        $property->setAccessible(true);
+        $property->setValue($service, $dir);
+
+        return [
+            'service' => $service,
+            'dir' => $dir,
+            'log' => $logPath,
+        ];
+    }
+
+    private function removeStubbedCliDirectory(string $dir): void
+    {
+        foreach (glob($dir . '/*') ?: [] as $path) {
+            @unlink($path);
+        }
+
+        @rmdir($dir);
+    }
+
+    private function capturedCliArgs(string $logPath): string
+    {
+        $lines = file($logPath, FILE_IGNORE_NEW_LINES);
+        $this->assertIsArray($lines, 'CLI 인자 로그를 읽을 수 있어야 함');
+
+        return $lines[1] ?? '';
+    }
+
+    public function test_get_site_cd_returns_test_site_cd_in_test_mode(): void
+    {
+        $service = $this->makeService();
+
+        $this->assertEquals(self::TEST_SITE_CD, $service->getSiteCd());
+    }
+
+    public function test_kcp_soap_service_falls_back_to_test_site_cd_when_escrow_test_site_cd_is_empty(): void
+    {
+        $settingsMock = $this->createMock(PluginSettingsService::class);
+        $settingsMock->method('get')->willReturn([
+            'is_test_mode' => true,
+            'test_site_cd' => self::TEST_SITE_CD,
+            'escrow_test_site_cd' => '',
+        ]);
+
+        $service = new KcpSoapService($settingsMock);
+
+        $this->assertSame(self::TEST_SITE_CD, $service->getEscrowSiteCd());
+    }
+
+    public function test_get_site_cd_returns_live_site_cd_in_live_mode(): void
+    {
+        $service = $this->makeService([
+            'is_test_mode' => false,
+            'live_site_cd' => 'SR123456',
+            'live_site_key' => 'live_site_key_value',
+        ]);
+
+        $this->assertEquals('SR123456', $service->getSiteCd());
+    }
+
+    public function test_use_stored_credentials_restores_payment_time_mode_and_site_cd(): void
+    {
+        $service = $this->makeService([
+            'is_test_mode' => true,
+            'test_site_cd' => 'T0000',
+            'live_site_cd' => 'SR999999',
+            'live_site_key' => 'live_key_value',
+        ]);
+
+        $service->useStoredCredentials(false, 'SR123456');
+
+        $this->assertEquals('SR123456', $service->getSiteCd());
+        $this->assertStringContainsString('pay.kcp.co.kr', $service->getJsUrl());
+        $this->assertStringNotContainsString('testpay', $service->getJsUrl());
+    }
+
+    public function test_get_js_url_returns_test_url_in_test_mode(): void
+    {
+        $service = $this->makeService();
+
+        $this->assertStringContainsString('testpay.kcp.co.kr', $service->getJsUrl());
+    }
+
+    public function test_get_js_url_returns_live_url_in_live_mode(): void
+    {
+        $service = $this->makeService([
+            'is_test_mode' => false,
+            'live_site_cd' => 'SR123456',
+            'live_site_key' => 'live_key',
+        ]);
+
+        $jsUrl = $service->getJsUrl();
+        $this->assertStringContainsString('pay.kcp.co.kr', $jsUrl);
+        $this->assertStringNotContainsString('testpay', $jsUrl);
+    }
+
+    public function test_get_transaction_calls_correct_url_with_auth_headers(): void
+    {
+        $service = $this->makeService();
+
+        $tno = 'KCP_TNO_TEST_001';
+        $ordrIdxx = 'ORD-TEST-12345';
+
+        Http::fake([
+            'stgapi.kcp.co.kr/*' => Http::response([
+                'res_cd' => '0000',
+                'res_msg' => '정상처리',
+                'tno' => $tno,
+                'ordr_idxx' => $ordrIdxx,
+                'app_no' => 'APP12345',
+            ], 200),
+        ]);
+
+        $result = $service->getTransaction($tno, $ordrIdxx);
+
+        $this->assertEquals('0000', $result['res_cd']);
+        $this->assertEquals($tno, $result['tno']);
+
+        Http::assertSent(function ($request) use ($tno, $ordrIdxx) {
+            return str_contains($request->url(), 'stgapi.kcp.co.kr')
+                && str_contains($request->url(), urlencode($tno))
+                && $request->hasHeader('Authorization')
+                && $request->hasHeader('X-Kcp-Site-Code')
+                && $request->hasHeader('X-Kcp-Timestamp')
+                && $request->hasHeader('X-Kcp-Signature')
+                && $request['ordr_idxx'] === $ordrIdxx;
+        });
+    }
+
+    public function test_get_transaction_uses_basic_auth_with_site_credentials(): void
+    {
+        $service = $this->makeService();
+
+        Http::fake([
+            'stgapi.kcp.co.kr/*' => Http::response(['res_cd' => '0000'], 200),
+        ]);
+
+        $service->getTransaction('TNO_001', 'ORD-001');
+
+        $expectedAuthValue = 'Basic ' . base64_encode(self::TEST_SITE_CD . ':' . self::TEST_SITE_KEY);
+
+        Http::assertSent(function ($request) use ($expectedAuthValue) {
+            return $request->header('Authorization')[0] === $expectedAuthValue;
+        });
+    }
+
+    public function test_get_transaction_throws_on_http_error(): void
+    {
+        $service = $this->makeService();
+
+        Http::fake([
+            'stgapi.kcp.co.kr/*' => Http::response(null, 500),
+        ]);
+
+        $this->expectException(\Exception::class);
+        $this->expectExceptionMessageMatches('/HTTP 500/');
+
+        $service->getTransaction('TNO_ERR', 'ORD-ERR');
+    }
+
+    public function test_cancel_payment_calls_cli_with_full_cancel_params(): void
+    {
+        $stub = $this->makeServiceWithStubbedCli(
+            'res_cd=0000' . chr(31) . 'res_msg=취소완료' . chr(31) . 'tno=KCP_TNO_CANCEL_001'
+        );
+        /** @var NhnKcpApiService $service */
+        $service = $stub['service'];
+
+        $tno = 'KCP_TNO_CANCEL_001';
+        $ordrIdxx = 'ORD-TEST-CANCEL';
+        $cancelAmt = 50000;
+        $cancelMsg = '고객 요청';
+
+        try {
+            $result = $service->cancelPayment($tno, $ordrIdxx, $cancelAmt, $cancelMsg, false);
+
+            $this->assertEquals('0000', $result['res_cd']);
+
+            $args = $this->capturedCliArgs($stub['log']);
+            $this->assertStringContainsString('tx_cd=00200000', $args);
+            $this->assertStringContainsString('ordr_idxx=' . $ordrIdxx, $args);
+            $this->assertStringContainsString('modx_data=mod_data=tno=' . $tno, $args);
+            $this->assertStringContainsString('mod_type=STSC', $args);
+            $this->assertStringContainsString('mod_desc=' . $cancelMsg, $args);
+            $this->assertStringNotContainsString('mod_mny=', $args);
+            $this->assertStringNotContainsString('rem_mny=', $args);
+        } finally {
+            $this->removeStubbedCliDirectory($stub['dir']);
+        }
+    }
+
+    public function test_cancel_payment_calls_cli_with_partial_cancel_params(): void
+    {
+        $stub = $this->makeServiceWithStubbedCli('res_cd=0000' . chr(31) . 'res_msg=부분취소완료');
+        /** @var NhnKcpApiService $service */
+        $service = $stub['service'];
+
+        try {
+            $service->cancelPayment('TNO_PART', 'ORD-PART', 10000, '부분취소', true, 50000);
+
+            $args = $this->capturedCliArgs($stub['log']);
+            $this->assertStringContainsString('mod_type=RN07', $args);
+            $this->assertStringContainsString('mod_mny=10000', $args);
+            $this->assertStringContainsString('rem_mny=50000', $args);
+        } finally {
+            $this->removeStubbedCliDirectory($stub['dir']);
+        }
+    }
+
+    public function test_register_escrow_delivery_uses_test_site_cd_when_escrow_test_site_cd_is_empty(): void
+    {
+        $stub = $this->makeServiceWithStubbedCli(
+            'res_cd=0000' . chr(31) . 'res_msg=배송등록완료',
+            ['escrow_test_site_cd' => '']
+        );
+        /** @var NhnKcpApiService $service */
+        $service = $stub['service'];
+
+        try {
+            $service->registerEscrowDelivery('TNO_ESCROW', 'ORD-ESCROW', '1234567890', '04');
+
+            $args = $this->capturedCliArgs($stub['log']);
+            $this->assertStringContainsString('site_cd=' . self::TEST_SITE_CD, $args);
+        } finally {
+            $this->removeStubbedCliDirectory($stub['dir']);
+        }
+    }
+
+    public function test_cancel_payment_throws_on_non_0000_res_cd(): void
+    {
+        $stub = $this->makeServiceWithStubbedCli('res_cd=9999' . chr(31) . 'res_msg=취소 실패');
+        /** @var NhnKcpApiService $service */
+        $service = $stub['service'];
+
+        try {
+            $this->expectException(NhnKcpApiException::class);
+            $this->expectExceptionMessage('취소 실패');
+
+            $service->cancelPayment('TNO_FAIL', 'ORD-FAIL', 50000, '고객 요청');
+        } finally {
+            $this->removeStubbedCliDirectory($stub['dir']);
+        }
+    }
+
+    public function test_cancel_payment_throws_on_cli_fallback_error(): void
+    {
+        $stub = $this->makeServiceWithStubbedCli('');
+        /** @var NhnKcpApiService $service */
+        $service = $stub['service'];
+
+        try {
+            $this->expectException(NhnKcpApiException::class);
+            $this->expectExceptionMessage('연동 모듈 호출 오류');
+
+            $service->cancelPayment('TNO_CLI_ERR', 'ORD-CLI-ERR', 50000, '오류');
+        } finally {
+            $this->removeStubbedCliDirectory($stub['dir']);
+        }
+    }
+
+    public function test_cli_debug_logs_do_not_include_raw_response_or_site_key(): void
+    {
+        $source = file_get_contents((new \ReflectionClass(NhnKcpApiService::class))->getFileName());
+        $this->assertIsString($source);
+
+        $this->assertStringNotContainsString("'res_data' =>", $source);
+        $this->assertStringNotContainsString("'output_lines' =>", $source);
+        $this->assertStringNotContainsString("['command' => \$command]", $source);
+        $this->assertStringContainsString("'res_cd' => \$result['res_cd'] ?? null", $source);
+    }
+
+    public function test_cancel_payment_rejects_unsafe_cancel_message_before_cli_exec(): void
+    {
+        $stub = $this->makeServiceWithStubbedCli('res_cd=0000');
+        /** @var NhnKcpApiService $service */
+        $service = $stub['service'];
+
+        try {
+            $this->expectException(NhnKcpApiException::class);
+            $this->expectExceptionMessageMatches('/control character/');
+
+            $service->cancelPayment('TNO_UNSAFE', 'ORD-UNSAFE', 50000, "고객 요청\nINJECT");
+        } finally {
+            $this->removeStubbedCliDirectory($stub['dir']);
+        }
+    }
+
+    public function test_get_transaction_uses_live_api_url_in_live_mode(): void
+    {
+        $service = $this->makeService([
+            'is_test_mode' => false,
+            'live_site_cd' => 'SR123456',
+            'live_site_key' => 'live_key_value',
+        ]);
+
+        Http::fake([
+            'api.kcp.co.kr/*' => Http::response(['res_cd' => '0000'], 200),
+        ]);
+
+        $service->getTransaction('TNO_LIVE', 'ORD-LIVE');
+
+        Http::assertSent(function ($request) {
+            return str_contains($request->url(), 'api.kcp.co.kr')
+                && ! str_contains($request->url(), 'stgapi');
+        });
+    }
+
+    /**
+     * 결제 직전 CLI 바이너리 실행 권한 자가 복구 (9502 회귀 차단).
+     *
+     * 시나리오: plugin:update 후 활성 디렉토리 pp_cli/pp_cli_x64 가 _bundled 권한 (0664) 으로
+     * 회귀해 실행 권한이 사라진 상태에서 결제 시도. ensureCliExecutable() 가 결제 직전
+     * 자동으로 chmod 0755 + stat 캐시 무효화를 수행하여 9502 발생을 차단해야 한다.
+     *
+     * 단위 테스트는 ensureCliExecutable() 만 reflection 으로 직접 호출하고
+     * (실제 KCP CLI 실행은 외부 의존이라 단위 범위 밖) 권한 변경 + 멱등성 + 실패 분기
+     * 3가지 동작을 검증한다.
+     */
+    public function test_ensure_cli_executable_promotes_0664_to_0755(): void
+    {
+        if (strtoupper(substr(PHP_OS, 0, 3)) === 'WIN') {
+            $this->markTestSkipped('파일 모드 비트가 Windows 와 호환되지 않음.');
+        }
+
+        $tmpFile = tempnam(sys_get_temp_dir(), 'kcp_cli_test_');
+        $this->assertNotFalse($tmpFile);
+        file_put_contents($tmpFile, '#!/bin/sh' . PHP_EOL . 'exit 0' . PHP_EOL);
+        chmod($tmpFile, 0664);
+        $this->assertFalse(is_executable($tmpFile), 'precondition: 0664 는 실행 권한 없음');
+
+        try {
+            $service = $this->makeService();
+            $method = (new \ReflectionClass($service))->getMethod('ensureCliExecutable');
+            $method->setAccessible(true);
+            $method->invoke($service, $tmpFile);
+
+            clearstatcache(true, $tmpFile);
+            $this->assertTrue(is_executable($tmpFile), 'chmod 0755 로 자가 복구되어야 함');
+            $mode = substr(sprintf('%o', fileperms($tmpFile)), -4);
+            $this->assertSame('0755', $mode, "권한이 0755 로 정확히 설정되어야 함 (현재: {$mode})");
+        } finally {
+            @unlink($tmpFile);
+        }
+    }
+
+    public function test_ensure_cli_executable_is_idempotent_when_already_executable(): void
+    {
+        if (strtoupper(substr(PHP_OS, 0, 3)) === 'WIN') {
+            $this->markTestSkipped('파일 모드 비트가 Windows 와 호환되지 않음.');
+        }
+
+        $tmpFile = tempnam(sys_get_temp_dir(), 'kcp_cli_test_');
+        $this->assertNotFalse($tmpFile);
+        file_put_contents($tmpFile, '#!/bin/sh' . PHP_EOL . 'exit 0' . PHP_EOL);
+        chmod($tmpFile, 0755);
+
+        try {
+            $service = $this->makeService();
+            $method = (new \ReflectionClass($service))->getMethod('ensureCliExecutable');
+            $method->setAccessible(true);
+            // 호출이 예외 없이 통과해야 하며, 권한도 그대로여야 함.
+            $method->invoke($service, $tmpFile);
+
+            clearstatcache(true, $tmpFile);
+            $mode = substr(sprintf('%o', fileperms($tmpFile)), -4);
+            $this->assertSame('0755', $mode, '이미 실행 가능한 파일의 권한은 변경되지 않아야 함');
+        } finally {
+            @unlink($tmpFile);
+        }
+    }
+
+    public function test_ensure_cli_executable_throws_when_binary_missing(): void
+    {
+        $service = $this->makeService();
+        $method = (new \ReflectionClass($service))->getMethod('ensureCliExecutable');
+        $method->setAccessible(true);
+
+        $this->expectException(\Plugins\Sirsoft\PayNhnkcp\Exceptions\NhnKcpApiException::class);
+        $this->expectExceptionMessageMatches('/CLI 바이너리/');
+
+        $method->invoke($service, '/tmp/nonexistent_kcp_cli_' . uniqid());
+    }
+
+    /**
+     * KCP CLI 가 디스크에 결제 로그를 남기지 않도록 (PCI DSS 평문 카드번호 저장 방지) 보장.
+     *
+     * 기존 동작: log_path 가 빈 문자열 → CLI 가 기본 경로(bin/log/)에 verbose 로그 작성.
+     *   TX_ENDED 라인에 card_no, app_no, tno 등 결제 메타 평문 누적.
+     * 수정 동작: gnuboard5 검증 패턴 — 의도적으로 존재하지 않는 경로(/home100/kcp)를
+     *   전달하면 CLI 가 디렉토리 생성 실패 → 로그 작성 단계 silent skip.
+     *   추가로 log_level=1 (오류만) 로 낮춰 미래에 누가 log_path 를 살려도 카드번호 같은
+     *   verbose 페이로드가 자동으로 차단되도록 이중 안전장치.
+     */
+    public function test_log_path_is_intentionally_nonexistent_to_disable_disk_logging(): void
+    {
+        $reflection = new \ReflectionClass(NhnKcpApiService::class);
+        $this->assertTrue(
+            $reflection->hasConstant('LOG_DISABLED_PATH'),
+            'LOG_DISABLED_PATH 상수가 정의되어 있어야 함 (디스크 로깅 차단 의도 명시)',
+        );
+        $this->assertEquals(
+            '/home100/kcp',
+            $reflection->getConstant('LOG_DISABLED_PATH'),
+            'gnuboard5 의 검증된 패턴(/home100/kcp) 과 일치해야 함',
+        );
+        $this->assertFalse(
+            is_dir($reflection->getConstant('LOG_DISABLED_PATH')),
+            '경로가 실제 시스템에 존재하지 않아야 (로그 작성 silent skip 보장)',
+        );
+    }
+
+    public function test_log_level_is_minimal_to_prevent_pii_leak(): void
+    {
+        $reflection = new \ReflectionClass(NhnKcpApiService::class);
+        $logLevel = $reflection->getConstant('LOG_LEVEL');
+
+        $this->assertSame(
+            '1',
+            $logLevel,
+            'LOG_LEVEL=1 (오류만) 이어야 함 — verbose(3) 는 응답 페이로드에 카드번호 평문 포함하므로 PCI DSS 위반 위험',
+        );
+    }
+
+    public function test_cli_args_include_disabled_log_path_constant(): void
+    {
+        if (strtoupper(substr(PHP_OS, 0, 3)) === 'WIN') {
+            $this->markTestSkipped('Linux CLI 경로 테스트 — Windows 분기 별도 검증.');
+        }
+
+        $reflection = new \ReflectionClass(NhnKcpApiService::class);
+        $source = file_get_contents($reflection->getFileName());
+
+        // executeCliLinux 와 executeCliWindows 모두 LOG_DISABLED_PATH 참조해야 함.
+        $logPathReferences = substr_count($source, "'log_path=' . self::LOG_DISABLED_PATH");
+        $this->assertGreaterThanOrEqual(
+            2,
+            $logPathReferences,
+            '두 OS 분기(executeCliLinux + executeCliWindows) 모두 LOG_DISABLED_PATH 를 사용해야 함',
+        );
+
+        // 기존 빈 값 패턴(log_path=,)이 남아있지 않아야 함.
+        $this->assertStringNotContainsString(
+            "'log_path=,'",
+            $source,
+            '빈 log_path 패턴이 남아있으면 CLI 가 기본 경로(bin/log/)에 로그 작성 회귀',
+        );
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/tests/scenarios/example_pg_payment.yaml.example b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/scenarios/example_pg_payment.yaml.example
new file mode 100644
index 00000000..b54d3cae
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/scenarios/example_pg_payment.yaml.example
@@ -0,0 +1,93 @@
+# 시나리오 매니페스트 예시 (실제 적용 아님 — .yaml.example 확장자)
+# 실제 매니페스트로 채택할 때 .yaml 로 이름 변경 + test_files 의 실재 경로 매핑
+#
+# 참조: docs/testing-guide.md "기능 단위 시나리오 매트릭스"
+
+feature: order_payment_pg_nhnkcp
+description: NHN KCP Standard Pay 를 통한 주문 결제 흐름 (회원/비회원, 결제 수단, 가상계좌 등 도메인 변수 cross product)
+
+test_files:
+  - plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Payment/KcpAuthCallbackTest.php
+  - plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Payment/VbankNotifyTest.php
+  - plugins/_bundled/sirsoft-pay_nhnkcp/tests/Feature/Payment/CancelTest.php
+
+coverage_strategy: pairwise
+
+# 입력 axis — 결제 흐름에 영향을 주는 도메인 변수
+axes:
+  user_type: [member, guest]
+  payment_method: [card, bank_transfer, virtual_account, mobile]
+  is_test_mode: [true, false]
+  os_platform: [windows, linux]   # KCP CLI 바이너리가 OS 별로 다름
+  product_options: [single, multi_option, bundle]
+  shipping_region: [domestic, jeju, remote_island]
+  shipping_policy: [free, fixed, range_based, conditional_free]
+  coupon_applied: [none, product, category, all]
+  rounding_unit: [1, 10, 100]
+
+# 의미 없는 조합 컷 — 사유 명시 필수
+exclusions:
+  - { payment_method: virtual_account, user_type: guest, reason: "비회원 가상계좌는 환불 계좌 등록 불가" }
+
+# 후속 효과 체인 — 결제 후 모든 부수효과
+effects:
+  - auth_callback_received
+  - cli_approve_called             # KCP CLI 서버 승인
+  - res_cd_zero_check
+  - payment_completed              # card / mobile / bank_transfer
+  - vbank_issued                   # virtual_account 1단계
+  - vbank_notification_received    # virtual_account 2단계
+  - vbank_deposit_completed        # res_cd 0000 입금완료
+  - notification_sent_to_user
+  - notification_amount_matches_total
+  - vat_calculated
+  - tax_free_amount_split
+  - coupon_marked_used
+  - inventory_decremented
+  - order_status_transitioned_to_paid
+
+# 보조 흐름 — 취소/환불/통보 등
+sub_flows:
+  - id: partial_cancel_card
+    description: 카드 결제 부분 취소 (mod_type=RN07, rem_mny 계산)
+    effects:
+      - before_cancel_hook_invoked     # plugin action hook
+      - cli_cancel_called
+      - after_cancel_hook_invoked
+      - shipping_policy_recalculated
+      - discount_recalculated
+      - mileage_partial_refunded
+      - vat_recalculated
+
+  - id: full_cancel_card
+    description: 카드 결제 전액 취소 (mod_type=STSC)
+    effects:
+      - before_cancel_hook_invoked
+      - cli_cancel_called
+      - after_cancel_hook_invoked
+      - mileage_fully_refunded
+      - coupon_unused
+      - inventory_restored
+      - order_status_transitioned_to_cancelled
+
+  - id: user_cancel_at_pg_dialog
+    description: 사용자가 결제창에서 취소 (m_Completepayment res_cd != '0000')
+    effects:
+      - kcp_cancelled_error_thrown
+      - silent_cleanup_no_toast
+      - no_payment_record_created
+
+  - id: vbank_repeat_notification
+    description: 동일 tno 입금 통보 재발송 시 중복 처리 방지
+    effects:
+      - row_lock_acquired
+      - already_paid_short_circuited
+      - ok_response_returned
+
+notes: |
+  이 매니페스트는 예시이며 실제 채택 시 다음을 갱신하세요:
+   1. test_files 경로
+   2. axes 값 목록 (특히 KCP CLI OS 분기는 Windows/Linux 모두 검증 필요)
+   3. effects 명명 (테스트 docblock @effects 와 1:1 매칭)
+   4. before_cancel / after_cancel 훅은 sirsoft-pay_nhnkcp.payment.before_cancel / after_cancel
+  pairwise 전략 케이스 수: 약 30 (full 일 경우 2*4*2*2*3*3*4*4*3 = 6,912)
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/tests/scenarios/security-callback-defense.yaml b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/scenarios/security-callback-defense.yaml
new file mode 100644
index 00000000..6034bea6
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/tests/scenarios/security-callback-defense.yaml
@@ -0,0 +1,107 @@
+# audit:allow test-scenario-coverage reason: Phase 2 SSoT — 본 매니페스트는 NHN KCP 콜백 보안 매트릭스의 명세 문서. CLI sanitization 단위 테스트가 핵심 경로를 커버하며, replay/net-cancel 의 cross product 전체 자동 검증은 Phase 3 (침투 PoC) 에서 처리.
+
+feature: 콜백 보안 방어 (replay attack / CLI command injection / post-approve net cancel)
+
+description: |
+  NHN KCP 결제 콜백 처리 경로의 3가지 핵심 보안 위협에 대한 방어 매트릭스.
+
+  방어 대상 위협:
+    1. Replay attack — PG 거래 ID (tno) 로 콜백 재전송 시 두 번 결제 처리되어
+       알림/마일리지/재고 중복. PreventsReplayCallback trait + DB unique index
+       (ecommerce module beta.5) 로 이중 방어.
+    2. CLI command injection — NHN KCP 가 제공하는 결제 모듈 CLI 바이너리 호출 시
+       MID/금액/거래번호 등을 인수로 전달. 메타문자/제어문자가 포함되면 셸 인젝션
+       위험. assertSafeCliValue() allowlist + escapeshellarg() 이중 방어.
+    3. Post-approve 실패 시 net cancel 누락 — CLI 가 PG 승인 성공 응답을 반환했으나
+       이후 도메인 처리 (금액 검증, 주문 상태 전이) 가 실패하면 PG 측은 승인 상태이지만
+       G7 주문은 미생성. autoCancelIfApproved() 헬퍼로 PG 승인 자동 취소.
+
+axes:
+  context: [paymentCallback_card, paymentCallback_vbank, mobileApproval]
+  threat: [replay, cli_injection, post_approve_failure]
+  callback_state: [first_arrival, second_arrival_same_tno, cli_arg_normal, cli_arg_unsafe, domain_succeeds, domain_fails]
+
+exclusions:
+  - { threat: replay, callback_state: cli_arg_normal, reason: "replay 는 CLI 단계 이전 분기" }
+  - { threat: replay, callback_state: cli_arg_unsafe, reason: "replay 는 CLI 단계 이전 분기" }
+  - { threat: replay, callback_state: domain_succeeds, reason: "replay 는 domain 처리 이전 단계" }
+  - { threat: replay, callback_state: domain_fails, reason: "replay 는 domain 처리 이전 단계" }
+  - { threat: cli_injection, callback_state: first_arrival, reason: "CLI 단계는 도착 차수 무관" }
+  - { threat: cli_injection, callback_state: second_arrival_same_tno, reason: "CLI 단계는 도착 차수 무관" }
+  - { threat: cli_injection, callback_state: domain_succeeds, reason: "CLI 인젝션은 CLI 실행 단계 분기" }
+  - { threat: cli_injection, callback_state: domain_fails, reason: "CLI 인젝션은 CLI 실행 단계 분기" }
+  - { threat: cli_injection, context: mobileApproval, reason: "모바일 승인은 별도 callback flow 로 CLI 직접 호출 아님" }
+  - { threat: post_approve_failure, callback_state: first_arrival, reason: "post-approve 실패는 도메인 결과 분기" }
+  - { threat: post_approve_failure, callback_state: second_arrival_same_tno, reason: "post-approve 실패는 도메인 결과 분기" }
+  - { threat: post_approve_failure, callback_state: cli_arg_normal, reason: "post-approve 실패는 CLI 와 무관" }
+  - { threat: post_approve_failure, callback_state: cli_arg_unsafe, reason: "post-approve 실패는 CLI 와 무관" }
+  - { threat: post_approve_failure, context: paymentCallback_vbank, reason: "vbank 통보는 PG 측 비동기 입금 — post-approve 단계 없음" }
+
+effects:
+  # Replay defense — PreventsReplayCallback trait
+  - replay_detected_on_second_arrival
+  - replay_response_is_idempotent_ok
+  - replay_no_double_completion
+  - replay_logged_with_context
+  - replay_first_arrival_proceeds_normally
+  - replay_db_unique_blocks_concurrent_insert
+
+  # CLI sanitization — assertSafeCliValue + escapeshellarg
+  - cli_arg_rejects_double_quote
+  - cli_arg_rejects_backtick
+  - cli_arg_rejects_dollar_paren
+  - cli_arg_rejects_pipe
+  - cli_arg_rejects_redirect
+  - cli_arg_rejects_semicolon
+  - cli_arg_rejects_null_byte
+  - cli_arg_rejects_control_char_low
+  - cli_arg_rejects_control_char_high
+  - cli_arg_accepts_alnum_only
+  - cli_arg_accepts_normal_korean_label
+  - cli_arg_throws_runtime_exception_on_unsafe
+  - cli_exec_uses_escapeshellarg
+  - cli_no_shell_executed_on_unsafe_input
+
+  # Post-approve net cancel
+  - post_approve_failure_triggers_auto_cancel
+  - net_cancel_sends_pg_cancel_api_call
+  - net_cancel_passes_approved_tno
+  - net_cancel_passes_full_amount
+
+test_files: []
+
+manual_verification:
+  - description: "Replay PoC — paymentCallback 두 번 전송"
+    steps:
+      - "정상 카드 콜백 1차 전송 → 200 OK, payment_status=paid"
+      - "동일 페이로드 (tno 동일) 2차 전송 → 200 OK (멱등 응답)"
+      - "Log 에 'NHN KCP: replay detected' 확인"
+      - "DB: g7_ecommerce_order_payments 에 동일 tno row 1건만 존재"
+  - description: "CLI injection PoC — MID 위장"
+    steps:
+      - "관리자 PG 설정에서 site_cd (MID) 를 `SR_shop_001\"; id > /tmp/g7_kcp_poc; #` 로 설정 시도"
+      - "또는 KCP CLI 호출 시 amt 인수에 `1000;id>/tmp/g7_kcp_poc;echo` 전달"
+      - "assertSafeCliValue 가 RuntimeException throw → CLI 미실행"
+      - "/tmp/g7_kcp_poc 미생성 확인"
+  - description: "Post-approve 실패 net cancel PoC"
+    steps:
+      - "정상 carrier card 결제로 paymentCallback 진입"
+      - "PG CLI 응답: 승인 성공 (res_cd=0000), tno 발급됨"
+      - "이후 OrderProcessingService 에서 PaymentAmountMismatchException 발생 시뮬"
+      - "autoCancelIfApproved 가 NhnKcpApiService::cancelPayment(tno, amount) 호출"
+      - "PG 측 거래 상태: 승인 후 취소 (정산 영향 없음)"
+      - "G7 주문: 미생성 상태 유지"
+
+notes: |
+  본 매니페스트는 Phase 2 보안 강화 작업의 SSoT.
+
+  관련 코드:
+   - src/Concerns/PreventsReplayCallback.php (replay 가드)
+   - src/Controllers/PaymentCallbackController.php (paymentCallback + autoCancelIfApproved)
+   - src/Services/NhnKcpApiService.php (assertSafeCliValue + escapeshellarg)
+   - src/Exceptions/NhnKcpApiException.php (도메인 예외)
+
+  관련 modules (참고 — plugin scope 외):
+   - modules/_bundled/sirsoft-ecommerce/database/migrations/2026_05_16_000001_add_unique_index_to_transaction_id_on_ecommerce_order_payments_table.php
+
+  Phase 3 침투 PoC 에서 본 manual_verification 항목을 자동화 PoC 스크립트로 변환 예정.
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/tsconfig.json b/plugins/_bundled/sirsoft-pay_nhnkcp/tsconfig.json
new file mode 100644
index 00000000..f50d72bd
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/tsconfig.json
@@ -0,0 +1,18 @@
+{
+    "compilerOptions": {
+        "target": "ES2020",
+        "module": "ESNext",
+        "lib": ["ES2020", "DOM", "DOM.Iterable"],
+        "strict": true,
+        "moduleResolution": "bundler",
+        "noEmit": true,
+        "noUnusedLocals": true,
+        "noUnusedParameters": true,
+        "noFallthroughCasesInSwitch": true,
+        "baseUrl": ".",
+        "paths": {
+            "@/*": ["resources/js/*"]
+        }
+    },
+    "include": ["resources/js/**/*.ts"]
+}
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/vite.config.ts b/plugins/_bundled/sirsoft-pay_nhnkcp/vite.config.ts
new file mode 100644
index 00000000..50eb40ba
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/vite.config.ts
@@ -0,0 +1,27 @@
+import { defineConfig } from 'vite';
+import { resolve } from 'path';
+
+export default defineConfig({
+    build: {
+        lib: {
+            entry: resolve(__dirname, 'resources/js/index.ts'),
+            name: 'SirsoftNhnkcp',
+            formats: ['iife'],
+        },
+        outDir: 'dist',
+        rollupOptions: {
+            output: {
+                entryFileNames: 'js/plugin.iife.js',
+            },
+        },
+        sourcemap: true,
+        minify: 'esbuild',
+        target: 'es2020',
+        chunkSizeWarningLimit: 500,
+    },
+    resolve: {
+        alias: {
+            '@': resolve(__dirname, 'resources/js'),
+        },
+    },
+});
diff --git a/plugins/_bundled/sirsoft-pay_nhnkcp/vitest.config.ts b/plugins/_bundled/sirsoft-pay_nhnkcp/vitest.config.ts
new file mode 100644
index 00000000..b66c6912
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nhnkcp/vitest.config.ts
@@ -0,0 +1,17 @@
+import { defineConfig } from 'vitest/config';
+import path from 'path';
+
+export default defineConfig({
+    test: {
+        globals: true,
+        environment: 'jsdom',
+        include: ['resources/js/**/*.{test,spec}.{ts,tsx}'],
+        exclude: ['node_modules/', 'dist/'],
+    },
+    resolve: {
+        alias: {
+            '@': path.resolve(__dirname, 'resources/js'),
+            '@core': path.resolve(__dirname, '../../resources/js/core'),
+        },
+    },
+});
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/CHANGELOG.md b/plugins/_bundled/sirsoft-pay_nicepayments/CHANGELOG.md
new file mode 100644
index 00000000..3df77c45
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/CHANGELOG.md
@@ -0,0 +1,104 @@
+# Changelog
+
+이 프로젝트의 모든 주요 변경사항을 기록합니다.
+형식은 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/)를 따르며,
+[Semantic Versioning](https://semver.org/lang/ko/)을 준수합니다.
+
+## [Unreleased]
+
+### Security
+
+- SignData 발급 요청에 주문번호+IP 단위 rate limit과 구매자 이메일/전화번호 대조를 추가해 공개 서명 엔드포인트의 주문번호/금액 프로빙 가능성을 줄였습니다.
+- 콜백 URL 생성 시 요청 헤더 대신 `config('app.url')`을 기준으로 절대 URL을 만들도록 고정해 프록시 환경 오동작과 헤더 기반 리다이렉트 변조 위험을 줄였습니다.
+- 카드 승인 콜백과 결제창 닫힘 통보 처리에 주문/결제 행잠금 후 재검증을 추가해 동시 콜백에서 마일리지, 재고, 결제 상태가 중복 반영되지 않도록 보강했습니다.
+- 에스크로 배송등록 시 결제된 에스크로 거래의 저장 TID와만 바인딩하고, 결제 당시 MID와 테스트/운영 모드로 API 컨텍스트를 복원하도록 수정했습니다.
+- 가상계좌 입금통보가 결제 당시 저장된 TID, MID, 계좌번호, 금액, 입금대기 상태와 일치할 때만 결제완료 처리되도록 교차검증을 강화했습니다.
+- 관리자 금융 API에 주문 조회/수정 권한을 세분화해 낮은 권한의 관리자 계정이 환불·에스크로 등 자금 이동 작업을 호출하지 못하도록 보강했습니다.
+- 가상계좌 입금자명과 전체 계좌번호가 애플리케이션 로그에 남지 않도록 민감정보 기록을 줄였습니다.
+
+### Fixed
+
+- 나이스페이먼츠 가상계좌 발급 후 뒤늦게 PC 결제창 닫힘 보고가 들어와도 입금대기 주문이 결제실패/취소로 덮이지 않도록 보강했습니다.
+- 이미 부분취소된 나이스페이먼츠 거래의 남은 잔액을 다시 취소할 때 PG 취소 요청이 전액취소로 잘못 전달되어 실패하던 문제를 수정했습니다.
+- 비회원 나이스페이먼츠 주문완료/주문상세에서 매출전표 조회가 인증 사용자 전용 라우트에 막히지 않도록 게스트 주문 토큰과 결제 성공 후 임시 영수증 쿠키 접근을 지원했습니다.
+- 나이스페이먼츠 인증 단계 실패(`AuthResultCode != 0000`)는 실제 PG 승인 전이므로 주문/결제/주문옵션을 취소 상태로 바꾸지 않고 체크아웃 재시도가 가능하도록 수정했습니다.
+- 다통화 주문의 환율 스냅샷이 누락되거나 0인 경우 SignData, 결제 승인 콜백, 결제창 닫힘 보고에서 예외가 일반 승인 오류로 뭉개지지 않도록 결제 통화 설정 오류로 명시 처리했습니다.
+- 나이스페이먼츠 간편결제 주문이 주문완료, 마이페이지 주문상세, 관리자 주문목록/상세에서 실제 간편결제 수단 대신 `신용카드`로만 표시되던 문제를 수정했습니다.
+- 관리자 주문목록과 주문상세 레이아웃이 리뉴얼되거나 플러그인 업데이트 과정에서 나이스페이먼츠 테스트결제 배지, 테스트 모드 안내, 결제 조회/결제 정보 패널이 누락될 수 있던 문제를 수정했습니다.
+- 운영 모드에서 live MID가 비어 있으면 `SR` 같은 잘못된 MID로 결제창을 만들지 않고 서명 요청 단계에서 실패하도록 보강했습니다.
+- 환불 요청 시 현재 설정값이 아니라 결제 당시 MID와 테스트/운영 모드로 나이스페이먼츠 API 서명 컨텍스트를 복원하도록 수정했습니다.
+- 관리자 가상계좌 환불이 PG 취소만 호출하고 주문/결제/환불 장부를 갱신하지 않던 문제를 수정했습니다.
+- 결제완료 커밋 후 후속 처리 예외가 발생한 경우 이미 결제완료 상태인 거래에 망취소를 보내지 않도록 보상 처리 가드를 추가했습니다.
+- 이커머스 주문설정 화면에서 나이스페이먼츠 플러그인이 테스트 모드일 때 운영 전환 경고와 설정 이동 버튼을 표시하도록 보강했습니다.
+
+## [1.0.0-beta.4] - 2026-06-03
+
+### Added
+
+- 레이아웃 편집기에서 이 플러그인의 설정 화면을 테스트 모드/운영 모드 상태로 전환해 미리볼 수 있도록 했습니다.
+- 레이아웃 편집기 데이터 소스 목록에서 이 확장이 제공하는 데이터 소스가 친화 명칭으로 표시되고, 어느 확장이 제공했는지 출처가 함께 표시됩니다.
+
+### Fixed
+
+- 이커머스 관리자 주문설정 결제수단 목록에서 나이스페이먼츠 간편결제 항목이 브랜드 텍스트 배지로 표시되도록 보강했습니다.
+- 이커머스 관리자 주문설정 결제수단 목록에 나이스페이먼츠 간편결제 항목이 노출되지 않던 문제를 수정했습니다.
+- 체크아웃에서 나이스페이먼츠 간편결제 일부 항목이 다른 PG 간편결제 보정 로직에 잘못 잡혀 아이콘/문구가 뒤섞여 표시되던 문제를 수정했습니다.
+- 체크아웃의 나이스페이먼츠 간편결제 항목이 NHN KCP 간편결제처럼 브랜드 아이콘과 제목/설명 텍스트가 함께 보이도록 표시를 보강했습니다.
+- 활성 관리자 테마에 최신 시맨틱 CSS가 없어도 플러그인 설정 화면의 여백, 카드 경계, 하단 저장 영역이 깨지지 않도록 보강했습니다.
+- 나이스페이먼츠 PC 결제창을 사용자가 닫거나 인증 단계 취소 콜백이 들어온 경우 임시 주문이 `pending_order` / `ready` 상태로 남지 않고 결제실패/취소 상태로 기록되도록 보강했습니다.
+- 비회원 체크아웃에서 나이스페이먼츠 결제창 호출 직전 SignData 생성 요청이 인증 미들웨어에 막혀 401로 실패하던 문제를 수정했습니다.
+- 나이스페이먼츠 승인 실패, 금액 불일치, 결제창 닫기 흐름에서 결제 레코드가 `failed` 상태로 남도록 정합성을 보강했습니다.
+- 실제 PG 승인 이력이 없는 나이스페이먼츠 결제실패 주문은 동일 주문으로 재시도할 수 있도록 SignData 발급 단계에서 안전하게 결제대기 상태로 복구하도록 보강했습니다.
+- 간편결제 fallback 경로에서도 쿠폰/마일리지 반영 후 실결제 금액을 PG 요청 금액으로 사용하도록 수정했습니다.
+
+### Changed
+
+- 환경설정 / 주문 화면 결제 / 마이페이지 영수증 영역 외형을 sirsoft-admin_basic 표준 시맨틱과 정합 — 다른 화면과 같은 결로 통일.
+- 관리자 화면 좌우 정렬 컨테이너(섹션 헤더 · 액션바 · 카드 상단부 등) 외형을 표준 시맨틱(.flex-between)으로 정리 — 시각 변경 없음, 향후 톤 조정이 한 곳에서 가능.
+- 플러그인 환경설정 화면의 폼 라벨 / 보조 설명 / 에러 메시지 시각 시맨틱을 sirsoft-admin_basic 표준 시맨틱과 정합 — 다른 관리자 화면과 같은 결로 통일.
+- 플러그인 환경설정 화면 곳곳의 텍스트 톤 (보조 설명 · 라벨 · 본문 · 강조 · 작은 보조) 시각 시맨틱을 관리자 표준 시맨틱과 정합 — 같은 결의 글자 톤이 한 곳에서 일괄 조정 가능.
+- 플러그인 환경설정 화면의 세로 정렬 컨테이너 / 입력 박스를 sirsoft-admin_basic 표준 시맨틱 (.row-stack / .input) 과 정합 — 입력 행 사이에 옅은 회색 구분선(1px) 이 자동 적용되어 행 묶음 가독성이 개선되고, 입력 박스 외형이 일관 표시되도록 정리.
+
+## [1.0.0-beta.3] - 2026-05-20
+
+### Security
+
+- 결제 승인/가상계좌 통보 응답 저장을 blacklist 제거 방식에서 whitelist 저장 방식으로 변경 — PG 응답에 새 민감 필드가 추가되어도 메타에 자동 저장되지 않도록 강화했습니다.
+
+## [1.0.0-beta.2] - 2026-05-20
+
+### Added
+
+- PG 측 결제 취소가 확인된 시점에 활동 로그가 별도로 기록되도록 보강 — 운영자가 PG 응답 시각 / 취소 TID 등 사후 추적에 활용 가능.
+- 마이페이지 주문 상세에 가상계좌 입금 안내 표시 — 결제수단이 가상계좌인 주문은 은행/계좌번호/예금주/입금 금액/입금 기한이 함께 노출되어 사용자가 입금 정보를 다시 확인할 수 있습니다.
+
+### Changed
+
+- 플러그인 환경설정 화면의 하단 저장 버튼이 스크롤 중에도 화면에 고정되도록 개선.
+- 모바일 결제창에서 사용자가 취소하거나 인증이 실패한 경우 "결제 처리 중 오류가 발생했습니다" 같은 강한 에러 메시지 없이 체크아웃 화면으로 조용히 복귀하도록 변경 — 인증 단계는 실제 결제 승인 전이라 사용자가 다시 시도하면 되는 상황이므로 불필요한 경고 노출을 제거.
+
+### Fixed
+
+- 체크아웃에서 신용카드 외 결제수단(가상계좌/계좌이체/휴대폰)을 선택해도 PG 결제창이 열리지 않고 곧바로 주문 완료로 이동하던 문제 수정.
+
+### Security
+
+- 결제 콜백 중복 처리 방어 추가 — 동일 거래번호로 카드 결제 콜백이 두 번 도착해도 결제완료/마일리지 적립 등이 중복 실행되지 않도록 멱등 응답 처리
+- 인증 콜백의 짧은 시간 내 중복 시도 방어 추가 — 동일 인증 토큰이 60초 안에 두 번 수신되면 재시도(replay) 의심으로 차단
+- 결제 승인 실패 시 자동 취소 보강 — PG 측에 잔존할 수 있는 미완료 승인을 즉시 망취소로 해제하여 사용자 환불 누락 방지
+
+## [1.0.0-beta.1] - 2026-04-22
+
+### Changed
+
+- 플러그인 식별자를 `sirsoft-pay-nicepayments`에서 `sirsoft-pay_nicepayments`로 변경 — G7 코어가 권장하는 `vendor-name` 2-part 명명 규칙에 맞추기 위함
+- 사용자 노출 에러/환불 메시지를 한국어/영어 다국어로 분리 — 운영 언어에 따라 자동 노출
+- PG 프로바이더 표시명을 다국어 키로 분리 — 활성 언어팩으로 자동 보강되어 다른 PG 플러그인과 동일한 컨벤션으로 정렬
+
+### Added
+
+- 오픈 베타 릴리즈
+- `sirsoft-pay_nicepayments.payment.before_cancel` / `after_cancel` 액션 훅 — 외부 소비자가 결제 취소 지점에 본인인증 등 확장 로직을 붙일 수 있도록 확장점 제공
+- 가상계좌 입금통보 IP 화이트리스트 검증 강화 — 공식 발송 IP 외 요청은 라우트 진입 단계에서 차단
+- PG 도메인 전용 예외 도입 — 외부 소비자가 나이스페이먼츠 도메인 오류만 선택적으로 처리할 수 있도록 개선
+- 다크 모드 지원 보강 — 결제 설정 폼 입력 필드의 포커스 링이 다크 모드에서도 정상 표시
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/LICENSE b/plugins/_bundled/sirsoft-pay_nicepayments/LICENSE
new file mode 100644
index 00000000..6cd9c0ff
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/LICENSE
@@ -0,0 +1,47 @@
+프로그램 명칭 : 그누보드7용 나이스페이먼츠 플러그인 (sirsoft-pay-nicepayments)
+
+저작자 : (주)에스아이알소프트
+
+----- MIT 라이선스 (한국어 번역) --------------------------------------------------------
+
+MIT 라이선스
+
+Copyright (c) 2026 (주)에스아이알소프트
+
+이 소프트웨어와 관련 문서 파일(이하 "소프트웨어")의 복사본을 취득하는 모든 사람에게
+소프트웨어를 제한 없이 사용, 복사, 수정, 병합, 출판, 배포, 서브라이선스 허여 및/또는
+판매할 수 있는 권리를 무상으로 부여합니다. 다만, 소프트웨어를 제공받은 사람은 다음
+조건을 따라야 합니다:
+
+위 저작권 고지와 본 허가 고지는 소프트웨어의 모든 복사본 또는 상당 부분에 포함되어야
+합니다.
+
+소프트웨어는 "있는 그대로" 제공되며, 명시적이든 묵시적이든 어떠한 종류의 보증도 하지
+않습니다. 여기에는 상품성, 특정 목적에의 적합성 및 비침해에 대한 보증이 포함되나 이에
+국한되지 않습니다. 어떠한 경우에도 저작자 또는 저작권자는 소프트웨어나 소프트웨어의
+사용 또는 기타 거래로 인해 발생하는 계약, 불법행위 또는 기타 청구, 손해 또는 기타
+책임에 대해 책임을 지지 않습니다.
+
+----- MIT License (English Original) --------------------------------------------------------
+
+The MIT License (MIT)
+
+Copyright (c) 2026 SIRSOFT
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/README.md b/plugins/_bundled/sirsoft-pay_nicepayments/README.md
new file mode 100644
index 00000000..74e4d83e
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/README.md
@@ -0,0 +1,147 @@
+# NicePayments Plugin for G7
+
+나이스페이먼츠(NicePayments) PG 연동 플러그인입니다. G7 플랫폼의 sirsoft-ecommerce 모듈과 함께 동작합니다.
+
+## 지원 결제 수단
+
+| 결제 수단 | PayMethod |
+|-----------|-----------|
+| 신용카드 | CARD |
+| 가상계좌 | VBANK |
+| 계좌이체 | BANK |
+| 휴대폰결제 | CELLPHONE |
+
+## 설치
+
+```bash
+# 플러그인 디렉토리에 배치 후
+composer install
+npm install && npm run build
+```
+
+## 설정
+
+관리자 → 플러그인 → NicePayments 설정에서 구성합니다.
+
+| 항목 | 설명 |
+|------|------|
+| 테스트 모드 | 활성화 시 나이스페이먼츠 공용 테스트 MID를 사용합니다. 실제 카드 승인/출금 알림이 발생할 수 있으며, 테스트 계정 결제는 당일 23:30경 일괄 자동 취소됩니다. |
+| 테스트 MID | 테스트 가맹점 ID (`nicepay00m` 기본값) |
+| 테스트 가맹점 키 | 나이스페이 공용 테스트 키 |
+| 라이브 MID | 실서비스 가맹점 ID |
+| 라이브 가맹점 키 | 실서비스 가맹점 키 (외부 노출 금지) |
+| 결제 성공 URL | 결제 완료 후 리다이렉트 경로 (`{orderId}` 치환 지원) |
+| 결제 실패 URL | 결제 실패 후 리다이렉트 경로 |
+
+테스트 모드 주문은 실제 배송하지 마세요. 실제 카드 승인/출금 알림이 발생할 수 있으며, 테스트 계정 결제는 당일 23:30경 일괄 자동 취소됩니다.
+
+## 웹훅 (가상계좌 입금 통보)
+
+나이스페이먼츠 관리자에서 가상계좌 입금 통보 URL을 아래로 설정하세요:
+
+```
+https://your-domain.com/plugins/sirsoft-pay_nicepayments/payment/vbank-notify
+```
+
+### IP 화이트리스트
+
+나이스페이먼츠 서버 IP만 허용됩니다. 로컬/테스트 환경에서는 자동으로 우회됩니다.
+
+| IP |
+|----|
+| 121.133.126.10 |
+| 121.133.126.11 |
+| 211.33.136.39 |
+
+## 결제 흐름
+
+### PC / 모바일 결제 (인증 + 승인 2단계)
+
+```
+브라우저  →  goPay(form) / 모바일 결제창 form POST
+결제창    →  POST /payment/callback  →  authCallback() (1단계 인증)
+서버      →  POST NextAppURL  →  승인 API 호출 (2단계)
+승인 완료 →  completePayment()  →  성공 페이지 리다이렉트
+```
+
+### 결제창 취소 / 인증 실패
+
+모바일 결제창에서 사용자가 취소버튼을 누르거나 PG 가 인증을 거부하면 (AuthResultCode != '0000') 결제 승인 (NextAppURL 호출) 이전이므로 사용자에게 generic 오류 메시지를 띄우지 않고 체크아웃으로 silent redirect 합니다. 운영 가시성은 로그(`auth_result_code` / `auth_result_msg`) 로 보존됩니다. 2단계 이후 hard failure (signature / mid / amount / authorize) 는 종전대로 `?error=` 쿼리 부착하여 안내합니다.
+
+### 결제 취소 / 부분취소
+
+```text
+관리자 주문 취소 요청 (cancel_pg=true)
+→ 코어가 sirsoft-ecommerce.payment.refund 필터 훅 발화
+→ PaymentRefundListener 가 NicePayments cancelPayment API 호출
+   · 전액취소: isPartial=0
+   · 부분취소: isPartial=1
+→ 코어가 환불 레코드 생성 + 쿠폰 / 마일리지 / 재고 복원
+→ CancelActivityLogListener 가 PG 응답 시각·취소 TID를 활동 로그에 기록
+```
+
+배송비가 포함된 주문은 전체취소 시 배송비도 함께 환불 레코드에 반영되고, 쿠폰이 적용된 주문은 실결제금액(쿠폰 차감 후) 이 PG cancelAmt 로 전달됩니다. 부분취소 시 쿠폰 최소 주문금액 조건을 더 이상 충족하지 못하면 코어가 취소 자체를 거부 (422) 하여 PG 호출이 발생하지 않습니다. 가상계좌 입금 완료 건은 환불 계좌 정보가 필요해 일반 취소 API 가 아닌 별도 어드민 환불 계좌 API 경로로 처리됩니다.
+
+## 가용 훅 (Hook)
+
+다른 플러그인이나 리스너에서 아래 훅에 연결할 수 있습니다.
+
+### 액션 훅
+
+| 훅 이름 | 시점 | 인수 |
+|---------|------|------|
+| `sirsoft-pay_nicepayments.payment.before_authorize` | 서버 승인 API 호출 직전 | `Order $order, array $pgParams` |
+| `sirsoft-pay_nicepayments.payment.after_authorize` | 서버 승인 API 응답 직후 | `Order $order, array $pgResponse` |
+| `sirsoft-pay_nicepayments.payment.before_cancel` | NicePayments 취소 API 호출 직전 | `Order $order, OrderPayment $payment, float $refundAmount` |
+| `sirsoft-pay_nicepayments.payment.after_cancel` | NicePayments 취소 API 호출 직후 | `Order $order, OrderPayment $payment, array $pgResponse` |
+| `sirsoft-pay_nicepayments.payment.refund_failed` | 환불 API 호출 실패 시 | `Order $order, OrderPayment $payment, array $context` |
+
+#### `refund_failed` context 구조
+
+```php
+[
+    'tid'        => string,  // 나이스페이 거래번호
+    'cancel_amt' => int,     // 환불 시도 금액 (원)
+    'error'      => string,  // 오류 메시지
+]
+```
+
+### 훅 등록 예시
+
+```php
+use App\Extension\HookManager;
+
+HookManager::addAction(
+    'sirsoft-pay_nicepayments.payment.refund_failed',
+    function (Order $order, OrderPayment $payment, array $context) {
+        // 예: Slack 알림 발송
+        SlackNotifier::send("환불 실패: 주문 #{$order->order_number}, 오류: {$context['error']}");
+    },
+    priority: 10
+);
+```
+
+## API 단건 조회
+
+`NicePaymentsApiService::queryTransaction(string $tid): array` 메서드로 거래 상태를 조회할 수 있습니다.
+
+```php
+$apiService = app(\Plugins\Sirsoft\PayNicepayments\Services\NicePaymentsApiService::class);
+$result = $apiService->queryTransaction('NICE_TID_12345');
+// $result['ResultCode'], $result['Amt'], ...
+```
+
+## 과세 처리
+
+결제 요청 시 주문의 `total_tax_amount`, `total_vat_amount`, `total_tax_free_amount` 값을 자동으로 나이스페이 폼에 포함합니다. 세 값이 모두 0이면 과세 필드를 생략합니다.
+
+## 테스트 실행
+
+```bash
+cd c:/g7
+php artisan test --filter=Nicepayments
+```
+
+## 라이선스
+
+MIT
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/composer.json b/plugins/_bundled/sirsoft-pay_nicepayments/composer.json
new file mode 100644
index 00000000..98a85846
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/composer.json
@@ -0,0 +1,20 @@
+{
+    "name": "plugins/sirsoft-pay_nicepayments",
+    "description": "NicePayments PG Plugin for G7 platform",
+    "version": "1.0.0-beta.4",
+    "type": "library",
+    "authors": [
+        {
+            "name": "sirsoft",
+            "email": "contact@sirsoft.com"
+        }
+    ],
+    "require": {
+        "php": "^8.2"
+    },
+    "autoload": {
+        "psr-4": {
+            "Plugins\\Sirsoft\\PayNicepayments\\": ["src/", "./"]
+        }
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/composer.lock b/plugins/_bundled/sirsoft-pay_nicepayments/composer.lock
new file mode 100644
index 00000000..c29a16db
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/composer.lock
@@ -0,0 +1,20 @@
+{
+    "_readme": [
+        "This file locks the dependencies of your project to a known state",
+        "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
+        "This file is @generated automatically"
+    ],
+    "content-hash": "1fce8e0d8388bbc1df8b2d62fdc98b7e",
+    "packages": [],
+    "packages-dev": [],
+    "aliases": [],
+    "minimum-stability": "stable",
+    "stability-flags": {},
+    "prefer-stable": false,
+    "prefer-lowest": false,
+    "platform": {
+        "php": "^8.2"
+    },
+    "platform-dev": {},
+    "plugin-api-version": "2.6.0"
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/config/settings/defaults.json b/plugins/_bundled/sirsoft-pay_nicepayments/config/settings/defaults.json
new file mode 100644
index 00000000..f46b1963
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/config/settings/defaults.json
@@ -0,0 +1,24 @@
+{
+    "_meta": {
+        "version": "1.0.0",
+        "description": "나이스페이먼츠 PG 플러그인 환경설정"
+    },
+    "defaults": {
+        "is_test_mode": true,
+        "test_mid": "nicepay00m",
+        "test_merchant_key": "EYzu8jGGMfqaDEp76gSckuvnaHHu+bC4opsSN6lHv3b2lurNYkVXrZ7Z1AoqQnXI3eLuaUFyoRNC6FkrzVjceg==",
+        "live_mid": "",
+        "live_merchant_key": "",
+        "redirect_success_url": "/shop/orders/{orderId}/complete",
+        "redirect_fail_url": "/shop/checkout"
+    },
+    "frontend_schema": {
+        "is_test_mode": { "expose": false },
+        "test_mid": { "expose": false },
+        "test_merchant_key": { "expose": false },
+        "live_mid": { "expose": false },
+        "live_merchant_key": { "expose": false },
+        "redirect_success_url": { "expose": false },
+        "redirect_fail_url": { "expose": false }
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/dist/js/plugin.iife.js b/plugins/_bundled/sirsoft-pay_nicepayments/dist/js/plugin.iife.js
new file mode 100644
index 00000000..0683927a
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/dist/js/plugin.iife.js
@@ -0,0 +1,2 @@
+(function(){"use strict";function Oe(e){return/^https?:\/\//i.test(e)||e.startsWith("/api/")?e:e.startsWith("/plugins/")?`/api${e}`:e.startsWith("plugins/")?`/api/${e}`:e}function De(e){return e.trim().slice(0,160)}async function Be(e,t="nicepay-window-closed"){if(!e.closeReportUrl)return;const n={oid:e.oid,price:Number(e.price),buyer_email:e.buyer_email??"",buyer_phone:e.buyer_phone??"",payment_method:e.payment_method??"",reason:De(t)||"nicepay-window-closed"};try{const a=window.G7Core?.api;if(typeof a?.post=="function"){await a.post(e.closeReportUrl,n);return}await fetch(Oe(e.closeReportUrl),{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(n),keepalive:!0})}catch(a){console.warn("[sirsoft-pay_nicepayments] failed to report payment window close",a)}}function Ge(e){return new Promise((t,n)=>{if(document.querySelector(`script[src="${e}"]`)){t();return}const a=document.createElement("script");a.src=e,a.onload=()=>t(),a.onerror=()=>n(new Error(`Failed to load script: ${e}`)),document.head.appendChild(a)})}function je(e,t){const n=document.createElement("form");n.id="nicepayForm",n.method="post",n.action=e,n.acceptCharset="utf-8";for(const[a,o]of Object.entries(t)){const r=document.createElement("input");r.type="hidden",r.name=a,r.value=o,n.appendChild(r)}return document.body.appendChild(n),n}const qe="/plugins/sirsoft-pay_nicepayments/payment/callback",Fe="https://web.nicepay.co.kr/v3/v3Payment.jsp";function Ye(){if(typeof navigator>"u")return!1;const e=navigator;if(e.userAgentData?.mobile!==void 0)return e.userAgentData.mobile;const t=(navigator.userAgent||"").toLowerCase();return!!(/android|iphone|ipod|windows phone|iemobile|blackberry|opera mini|mobile safari/.test(t)||(navigator.maxTouchPoints??0)>1&&!t.includes("windows")&&!t.includes("macintosh"))}async function J(e,t){const{pgPaymentData:n,paymentMethod:a}=e.params??{},o=window.__templateApp?.globalState?._local,r=a??o?.paymentMethod??"card";if(!n){console.error("[sirsoft-pay_nicepayments] pgPaymentData is required");return}const i=window.G7Core;try{const s=await i.api.get("/modules/sirsoft-ecommerce/payments/client-config/nicepayments");if(!s.data){console.error("[sirsoft-pay_nicepayments] Failed to fetch client config",s);return}const l=s.data,u=Ye();if(!u&&(await Ge(l.sdk_url),typeof window.goPay!="function")){i?.toast?.error?.("나이스페이먼츠 SDK를 불러올 수 없습니다. 잠시 후 다시 시도해주세요."),i?.state?.setLocal?.({isSubmittingOrder:!1,paymentMethod:r});return}const b=window.location.origin+l.sign_data_url,m=typeof localStorage<"u"?localStorage.getItem("auth_token"):null,p={"Content-Type":"application/json","X-Requested-With":"XMLHttpRequest",Accept:"application/json"};m&&(p.Authorization=`Bearer ${m}`);const P=await fetch(b,{method:"POST",credentials:"include",headers:p,body:JSON.stringify({amt:n.amount,moid:n.order_number,buyer_email:n.customer_email??"",buyer_phone:n.customer_phone??""})});if(!P.ok)throw new Error("SignData 생성에 실패했습니다.");const g=await P.json(),I=window.location.origin+qe,f=typeof r=="string"&&r.startsWith("nicepay_"),C=f?"CARD":{card:"CARD",vbank:"VBANK",bank:"BANK",phone:"CELLPHONE"}[r??"card"]??"CARD",d={PayMethod:C,GoodsName:n.order_name,Amt:String(n.amount),MID:g.mid,Moid:n.order_number,BuyerName:n.customer_name??"",BuyerEmail:n.customer_email??"",BuyerTel:n.customer_phone??"",ReturnURL:I,EdiDate:g.ediDate,SignData:g.signData,CharSet:"utf-8",GoodsCl:"1",DirectShowOpt:"",DirectEasyPay:"",NicepayReserved:"",EasyPayMethod:"",MallReserved:"",MallReserved1:""};C==="CELLPHONE"&&(d.GoodsCl=n.goods_cl??"1");const c=l.useEscrow&&!f;if(d.TransType=c?"1":"0",f)switch(d.DirectShowOpt="CARD",d.MallReserved=`nicepay_easy_pay_method=${encodeURIComponent(r)}`,d.MallReserved1=r,r){case"nicepay_naverpay":d.DirectEasyPay="E020",d.EasyPayMethod="E020=CARD";break;case"nicepay_kakaopay":d.NicepayReserved="DirectKakao=Y";break;case"nicepay_samsungpay":d.DirectEasyPay="E021";break;case"nicepay_applepay":d.DirectEasyPay="E025";break;case"nicepay_payco":d.NicepayReserved="DirectPayco=Y";break;case"nicepay_skpay":d.NicepayReserved="DirectPay11=Y";break;case"nicepay_ssgpay":d.DirectEasyPay="E007";break;case"nicepay_lpay":d.DirectEasyPay="E018";break}try{const w=(await i.api.get(`/modules/sirsoft-ecommerce/user/orders/${n.order_number}`))?.data;if(w){const T=Number(w.total_tax_amount??0),E=Number(w.total_vat_amount??0),$e=Number(w.total_tax_free_amount??0);(T>0||E>0||$e>0)&&(d.TaxAmt=String(T),d.VatAmt=String(E),d.TaxFreeAmt=String($e))}}catch{}const y=je(I,d);if(u){y.action=Fe,y.acceptCharset="euc-kr";const S=y.querySelector('input[name="CharSet"]');S&&(S.value="euc-kr"),y.submit();return}window.nicepaySubmit=()=>{y.submit()};let k=!1;const z=new Set(document.body.children),Re=(S,w)=>{if(k)return;k=!0;const T=[S,w].filter(Boolean).join(": ")||"nicepay-window-closed";Be({closeReportUrl:l.close_report_url,oid:n.order_number,price:Number(n.amount),buyer_email:n.customer_email??"",buyer_phone:n.customer_phone??"",payment_method:r},T),window.removeEventListener("popstate",Me),Array.from(document.body.children).forEach(E=>{z.has(E)||E.remove()}),y.parentNode&&y.parentNode.removeChild(y),window.__sirsoftNicepayPaymentInProgress=!1,i?.state?.setLocal?.({isSubmittingOrder:!1,paymentMethod:r}),w&&i?.toast?.error?.(w)};window.nicepayClose=Re;const Me=()=>Re("","");window.history.pushState({nicepayOpen:!0},""),window.addEventListener("popstate",Me),window.goPay(y)}catch(s){console.error("[sirsoft-pay_nicepayments] requestPayment error",s),window.__sirsoftNicepayPaymentInProgress=!1,i?.state?.setLocal?.({isSubmittingOrder:!1,paymentMethod:r}),i?.toast?.error?.("결제 중 오류가 발생했습니다. 잠시 후 다시 시도해주세요.")}}const He={nicepay_naverpay:"네이버페이",nicepay_kakaopay:"카카오페이",nicepay_samsungpay:"삼성페이",nicepay_applepay:"애플페이",nicepay_payco:"PAYCO",nicepay_skpay:"11pay",nicepay_ssgpay:"SSG페이",nicepay_lpay:"L.pay"},Ue="0 0 0 2px #ffffff, 0 0 0 5px rgba(0,0,0,0.55)";function X(){const e=document.getElementById("nicepay_checkout_payment_section");if(!e)return null;const t=e.querySelectorAll("p");for(const n of t)if(n.textContent?.includes("간편결제"))return n.nextElementSibling;return null}function Q(){const e=X();e&&e.querySelectorAll("button").forEach(t=>{t.style.boxShadow="",t.style.outline=""})}function Ke(e){const t=X();if(!t)return;const n=He[e];t.querySelectorAll("button").forEach(a=>{a.textContent?.trim()===n?(a.style.boxShadow=Ue,a.style.outline="none"):(a.style.boxShadow="",a.style.outline="")})}function We(e){const t=e.params?.paymentMethod;if(!t)return;const n=typeof t=="string"&&t.indexOf("nicepay_")===0;window.G7Core?.state?.setLocal?.({paymentMethod:t,serverPaymentMethod:n?"card":t}),n?Ke(t):Q()}function Z(){const e=window.__templateApp;typeof e?.onGlobalStateChange=="function"&&e.onGlobalStateChange(t=>{const n=t?._local?.paymentMethod;typeof n=="string"&&(n.startsWith("nicepay_")||Q())})}const ee={requestPayment:J,setPaymentMethod:We},te="/user/orders",Ve="sirsoft-nicepayments",R="sirsoft-pay_nicepayments",ne="__sirsoftNicepayFetchInterceptorInstalled",ae="/api/modules/sirsoft-ecommerce/checkout",M="__sirsoftNicepayPaymentInProgress",_="__sirsoftNicepayCheckoutCache",h={info:(...e)=>console.info(`[${R}]`,...e),warn:(...e)=>console.warn(`[${R}]`,...e),error:(...e)=>console.error(`[${R}]`,...e)};function ze(){return window.location.pathname+window.location.search+window.location.hash}function Je(e,t){if(t.toUpperCase()!=="POST")return!1;const n=(e??"").split("?")[0].split("#")[0];return n===te||n.endsWith(te)}function $(e,t){if(t.toUpperCase()!=="GET")return!1;const n=(e??"").split("?")[0].split("#")[0];return n===ae||n.endsWith(ae)}function Xe(e){if(!e)return;let t=null;if(typeof e=="string")try{t=JSON.parse(e)}catch{return}else typeof e=="object"&&(t=e);if(!t)return;const n=t.payment_method;return typeof n=="string"&&n.length>0?n:void 0}function Qe(e,t){try{const n=JSON.parse(e);if("payment_method"in n)return JSON.stringify({...n,payment_method:t})}catch{}return e}function Ze(e){const t=[e.total_due_amount,e.total_amount];for(const n of t){const a=Number(n??0);if(Number.isFinite(a)&&a>0)return Math.floor(a)}return 0}function et(){const e=window;if(e[ne])return;e[ne]=!0;const t="__sirsoftPgOriginalFetch";e[t]||(e[t]=window.fetch.bind(window));const n=e[t],a=window.fetch.bind(window);window.fetch=async(o,r)=>{const i=typeof o=="string"?o:o instanceof URL?o.href:o.url,s=r?.method??(o instanceof Request?o.method:"GET");if($(i,s)){if(e[M]&&e[_])return h.info("payment in progress — serving cached checkout response"),new Response(e[_],{status:200,headers:{"Content-Type":"application/json"}});const c=await a(o,r);if(c.ok){const y=await c.text();return e[_]=y,new Response(y,{status:c.status,statusText:c.statusText,headers:c.headers})}return c}if(!Je(i,s))return a(o,r);let l,u=!1,b=r;if(r?.body&&typeof r.body=="string"){const c=Xe(r.body);typeof c=="string"&&c.length>0&&(l=c,c.startsWith("nicepay_")&&(u=!0,b={...r,body:Qe(r.body,"card")},h.info(`easy pay detected: replacing payment_method '${c}' → 'card'`)))}const p=await(u?n:a)(o,b);if(!p.ok)return p;let P=null;try{P=await p.clone().json()}catch{return p}const g=P?.data??P;if(!g?.requires_pg_payment&&!u)return p;const I=g.pg_provider===Ve;if(!u&&!I)return p;let f=g.pg_payment_data;if(!f&&u){const c=g.order;if(c){const y=c.options,k=y?.[0]?.product_name??String(c.order_number??""),z=(y?.length??0)>1?`${k} 외 ${(y?.length??0)-1}건`:k;f={order_number:c.order_number,order_name:z,amount:Ze(c),currency:"KRW",customer_name:c.orderer_name??null,customer_email:c.orderer_email??null,customer_phone:String(c.orderer_phone??"").replace(/[^0-9]/g,""),customer_key:c.user_id??null},h.info("pg_payment_data constructed from order (기본 PG 미설정)",{order_number:f.order_number,amount:f.amount})}}if(!f)return h.warn("nicepayments order detected but pg_payment_data missing"),p;const V=l??"card";h.info("intercepted order create response — opening PG popup",{paymentMethod:V}),J({params:{pgPaymentData:f,paymentMethod:V}}),e[M]=!0;const C={...g,requires_pg_payment:!1,redirect_url:ze()},d=P?.data?{...P,data:C}:C;return new Response(JSON.stringify(d),{status:p.status,statusText:p.statusText,headers:p.headers})},h.info("fetch order interceptor installed"),oe(e,15)}const re="__sirsoftNicepayAxiosCheckoutInterceptorInstalled";function oe(e,t){const n=window?.G7Core?.api?.client;if(!n?.interceptors){t>0&&setTimeout(()=>oe(e,t-1),300);return}e[re]||(e[re]=!0,n.interceptors.response.use(a=>{const o=(a?.config?.method??"").toLowerCase(),r=String((a?.config?.baseURL??"")+(a?.config?.url??""));return o==="get"&&$(r,"GET")&&a?.status===200&&(e[_]=JSON.stringify(a.data),h.info("checkout response cached (axios)")),a}),n.interceptors.request.use(a=>{const o=(a?.method??"").toLowerCase(),r=String((a?.baseURL??"")+(a?.url??""));return o==="get"&&$(r,"GET")&&e[M]&&e[_]&&(h.info("payment in progress — serving cached checkout response (axios)"),a.adapter=()=>Promise.resolve({data:JSON.parse(e[_]),status:200,statusText:"OK (cached)",headers:{"content-type":"application/json"},config:a,request:{}})),a}),h.info("axios checkout interceptor installed"),e[_]||(async()=>{try{await window?.G7Core?.api?.get?.("/modules/sirsoft-ecommerce/checkout")}catch{}})())}const tt="sirsoft-pay_nicepayments",ie="__nicepayCheckoutEasyPayInjectorInstalled",nt=/^\/shop\/checkout\/?$/,se="__nicepayCheckoutEasyPaySyncListenerAttached",at=200,rt=120,ot="nicepay_checkout_payment_section",ce=[{id:"nicepay_naverpay",labels:["네이버페이 (나이스페이먼츠)","네이버페이로 결제 (나이스페이먼츠)","Naver Pay (NicePayments)","Pay with Naver Pay (NicePayments)"],ko:{heading:"네이버페이 (나이스페이먼츠)",description:"네이버페이로 결제 (나이스페이먼츠)",title:"네이버페이로 결제 (나이스페이먼츠)"},en:{heading:"Naver Pay (NicePayments)",description:"Pay with Naver Pay (NicePayments)",title:"Pay with Naver Pay (NicePayments)"},markText:"N",markClassName:"bg-green-500 text-white"},{id:"nicepay_kakaopay",labels:["카카오페이 (나이스페이먼츠)","카카오페이로 결제 (나이스페이먼츠)","Kakao Pay (NicePayments)","Pay with Kakao Pay (NicePayments)"],ko:{heading:"카카오페이 (나이스페이먼츠)",description:"카카오페이로 결제 (나이스페이먼츠)",title:"카카오페이로 결제 (나이스페이먼츠)"},en:{heading:"Kakao Pay (NicePayments)",description:"Pay with Kakao Pay (NicePayments)",title:"Pay with Kakao Pay (NicePayments)"},markText:"K",markClassName:"bg-yellow-400 text-gray-950"},{id:"nicepay_samsungpay",labels:["삼성페이 (나이스페이먼츠)","삼성페이로 결제 (나이스페이먼츠)","Samsung Pay (NicePayments)","Pay with Samsung Pay (NicePayments)"],ko:{heading:"삼성페이 (나이스페이먼츠)",description:"삼성페이로 결제 (나이스페이먼츠)",title:"삼성페이로 결제 (나이스페이먼츠)"},en:{heading:"Samsung Pay (NicePayments)",description:"Pay with Samsung Pay (NicePayments)",title:"Pay with Samsung Pay (NicePayments)"},markText:"S",markClassName:"bg-blue-600 text-white"},{id:"nicepay_applepay",labels:["애플페이 (나이스페이먼츠)","애플페이로 결제 (나이스페이먼츠)","Apple Pay (NicePayments)","Pay with Apple Pay (NicePayments)"],ko:{heading:"애플페이 (나이스페이먼츠)",description:"애플페이로 결제 (나이스페이먼츠)",title:"애플페이로 결제 (나이스페이먼츠)"},en:{heading:"Apple Pay (NicePayments)",description:"Pay with Apple Pay (NicePayments)",title:"Pay with Apple Pay (NicePayments)"},markText:"A",markClassName:"bg-gray-900 text-white"},{id:"nicepay_payco",labels:["PAYCO (나이스페이먼츠)","PAYCO로 결제 (나이스페이먼츠)","PAYCO (NicePayments)","Pay with PAYCO (NicePayments)"],ko:{heading:"PAYCO (나이스페이먼츠)",description:"PAYCO로 결제 (나이스페이먼츠)",title:"PAYCO로 결제 (나이스페이먼츠)"},en:{heading:"PAYCO (NicePayments)",description:"Pay with PAYCO (NicePayments)",title:"Pay with PAYCO (NicePayments)"},markText:"P",markClassName:"bg-red-500 text-white"},{id:"nicepay_skpay",labels:["11pay (나이스페이먼츠)","11pay로 결제 (나이스페이먼츠)","11pay (NicePayments)","Pay with 11pay (NicePayments)"],ko:{heading:"11pay (나이스페이먼츠)",description:"11pay로 결제 (나이스페이먼츠)",title:"11pay로 결제 (나이스페이먼츠)"},en:{heading:"11pay (NicePayments)",description:"Pay with 11pay (NicePayments)",title:"Pay with 11pay (NicePayments)"},markText:"11",markClassName:"bg-orange-500 text-white"},{id:"nicepay_ssgpay",labels:["SSG페이 (나이스페이먼츠)","SSG페이로 결제 (나이스페이먼츠)","SSG Pay (NicePayments)","Pay with SSG Pay (NicePayments)"],ko:{heading:"SSG페이 (나이스페이먼츠)",description:"SSG페이로 결제 (나이스페이먼츠)",title:"SSG페이로 결제 (나이스페이먼츠)"},en:{heading:"SSG Pay (NicePayments)",description:"Pay with SSG Pay (NicePayments)",title:"Pay with SSG Pay (NicePayments)"},markText:"SSG",markClassName:"bg-red-700 text-white"},{id:"nicepay_lpay",labels:["L.pay (나이스페이먼츠)","L.pay로 결제 (나이스페이먼츠)","L.pay (NicePayments)","Pay with L.pay (NicePayments)"],ko:{heading:"L.pay (나이스페이먼츠)",description:"L.pay로 결제 (나이스페이먼츠)",title:"L.pay로 결제 (나이스페이먼츠)"},en:{heading:"L.pay (NicePayments)",description:"Pay with L.pay (NicePayments)",title:"Pay with L.pay (NicePayments)"},markText:"L",markClassName:"bg-purple-600 text-white"}];let le=null,x=null,O=!1;function it(){return window}function D(){return nt.test(window.location.pathname)}function st(e){return(e??"").replace(/\s+/g," ").trim()}function ct(e){return st(e).replace(/\u200B/g,"")}function lt(){return(document.documentElement.lang||navigator.language||"").toLowerCase().startsWith("ko")}function dt(e){return lt()?e.ko:e.en}function de(e){return e.replaceAll("네이버페이","네이​버페이").replaceAll("카카오페이","카카​오페이").replaceAll("삼성페이","삼성​페이").replaceAll("Naver Pay","Naver​ Pay").replaceAll("Kakao Pay","Kakao​ Pay").replaceAll("Samsung Pay","Samsung​ Pay").replaceAll("L.pay","L.​pay")}function ut(e){return ce.find(t=>t.id===e)??null}function yt(e){const t=ut(e.dataset.nicepayEasyPayMethod);if(t)return t;const n=ct(e.textContent);return ce.find(a=>a.labels.some(o=>n.includes(o)))??null}function ue(e){return e.querySelector(".flex.items-center.gap-2, .flex.items-center.gap-3")??e.querySelector(".flex.items-center")}function pt(e,t,n){e.style.textAlign="left";const a=ue(e);a&&(a.style.justifyContent="flex-start",a.style.textAlign="left",a.style.width="100%");const o=t?.parentElement??n?.parentElement;o instanceof HTMLElement&&(o.style.textAlign="left",o.style.minWidth="0")}function mt(e){const t=document.createElement("span");return t.dataset.nicepayEasyPayMark="true",t.dataset.nicepayEasyPayMethod=e.id,t.setAttribute("aria-hidden","true"),t.className=`inline-flex items-center justify-center rounded-lg text-xs font-bold ${e.markClassName}`,t.style.width="32px",t.style.height="32px",t.style.flex="0 0 32px",t.textContent=e.markText,t}function ft(e){delete e.dataset.kginicisBrandPaymentButton,delete e.dataset.kginicisBrandPaymentMethod,delete e.dataset.kginicisNaverpayBrandButton,delete e.dataset.nhnkcpEasyPayMethod,delete e.dataset.nhnkcpEasyPayVisible,delete e.dataset.nhnkcpEasyPayHidden,e.querySelectorAll('[data-kginicis-brand-payment-mark="true"], [data-kginicis-naverpay-mark="true"], [data-nhnkcp-easy-pay-mark="true"]').forEach(t=>{t.remove()})}function ht(e){return e.querySelector('[data-nicepay-easy-pay-mark="true"]')??e.querySelector('[data-kginicis-brand-payment-mark="true"], [data-kginicis-naverpay-mark="true"], [data-nhnkcp-easy-pay-mark="true"]')??e.querySelector("svg")??e.querySelector('i[class*="fa-"], i[role="img"], i')}function gt(e,t){const n=e.querySelector('[data-nicepay-easy-pay-mark="true"]');if(n){n.dataset.nicepayEasyPayMethod=t.id,n.className=`inline-flex items-center justify-center rounded-lg text-xs font-bold ${t.markClassName}`,n.textContent=t.markText;return}const a=mt(t),o=ht(e);if(o&&o.parentElement){o.replaceWith(a);return}ue(e)?.prepend(a)}function Pt(e,t){const n=Array.from(e.querySelectorAll("p")),a=dt(t),o=de(a.heading),r=de(a.description),i=n[0],s=n[1];i&&i.textContent!==o&&(i.textContent=o),i&&(i.setAttribute("aria-label",a.heading),i.style.textAlign="left",i.style.whiteSpace="normal",i.style.wordBreak="keep-all",i.style.overflowWrap="anywhere"),s&&s.textContent!==r&&(s.textContent=r),s&&(s.style.textAlign="left",s.style.fontSize="12px",s.style.lineHeight="1rem",s.style.whiteSpace="normal",s.style.wordBreak="keep-all",s.style.overflowWrap="anywhere"),pt(e,i,s),e.title=a.title}function wt(e,t){e.hidden&&(e.hidden=!1),e.disabled&&(e.disabled=!1),e.style.display==="none"&&e.style.removeProperty("display"),e.removeAttribute("aria-hidden"),e.dataset.nicepayEasyPayMethod=t.id,e.dataset.nicepayEasyPayVisible="true",ft(e),gt(e,t),Pt(e,t)}function _t(){const e=document.getElementById(ot);return e?(e.remove(),!0):!1}async function B(e=document){if(typeof window>"u"||typeof document>"u"||!D())return!1;let t=_t();return e.querySelectorAll("button").forEach(n=>{const a=yt(n);a&&(wt(n,a),t=!0)}),t}function bt(){O||(O=!0,window.setTimeout(()=>{O=!1,B()},0))}function ye(){x!==null&&(window.clearInterval(x),x=null)}function G(){if(!D())return;ye(),B();let e=0;x=window.setInterval(()=>{e+=1,B(),e>=rt&&ye()},at);const t=document.body;t[se]||(t[se]=!0,le=new MutationObserver(()=>bt()),le.observe(document.body,{childList:!0,subtree:!0,characterData:!0}))}function pe(){D()&&G()}function Nt(){if(typeof window>"u"||typeof document>"u")return;const e=it();if(e[ie])return;e[ie]=!0,console.info(`[${tt}] checkout easy pay method sync installed`),document.readyState==="loading"?document.addEventListener("DOMContentLoaded",()=>G()):G();const t=history.pushState.bind(history);history.pushState=(...n)=>{t(...n),window.setTimeout(()=>pe(),200)},window.addEventListener("popstate",()=>window.setTimeout(()=>pe(),200))}const j="sirsoft-pay_nicepayments",me="__nicepayOcReceiptInjectorInstalled",fe="nicepay-oc-receipt-btn",Ct=/^\/shop\/orders\/([^/]+)\/complete$/;function he(){return localStorage.getItem("auth_token")}async function kt(e){const t=he();if(!t)return null;try{const n=await fetch(`/api/modules/sirsoft-ecommerce/user/orders/${e}`,{headers:{Authorization:`Bearer ${t}`,Accept:"application/json"}});return n.ok?(await n.json())?.data?.payment??null:null}catch{return null}}async function ge(e){const t=he();if(!t)return null;try{const n=await fetch(`/api/plugins/${j}/user/orders/${e}/receipt`,{headers:{Authorization:`Bearer ${t}`,Accept:"application/json"}});return n.ok?await n.json():null}catch{return null}}function St(e){if(!e)return!1;const t=Array.from(document.querySelectorAll("div"));for(const n of t){const a=Array.from(n.children).filter(i=>i instanceof HTMLElement&&i.tagName==="SPAN");if(a.length<2)continue;const o=a[0].textContent?.trim();if(o!=="결제 방법"&&o!=="결제수단"&&o!=="결제 방식")continue;const r=a[a.length-1];return r.textContent?.trim()!==e&&(r.textContent=e,r.dataset.nicepayPaymentMethodPatched="true"),n.dataset.nicepayPaymentMethodRow="true",!0}return!1}async function Et(e){if(document.getElementById(fe))return;const t=await kt(e);if(!t||t.pg_provider!=="nicepayments"||!t.transaction_id||!t.paid_at)return;const n=Array.from(document.querySelectorAll('button[type="button"]')).find(s=>s.className.includes("bg-blue-600"));if(!n?.parentElement)return;const a=await ge(e);St(a?.payment_method_display_label);const o=n.parentElement,r=document.createElement("button");r.id=fe,r.type="button",r.className=n.className.replace(/bg-blue-\d+/g,"bg-green-600").replace(/hover:bg-blue-\d+/g,"hover:bg-green-700"),r.textContent="영수증 조회",r.addEventListener("click",async()=>{r.disabled=!0,r.textContent="로딩 중...";const s=await ge(e);r.disabled=!1,r.textContent="영수증 조회";const l=s?.receipt_url??null;l&&window.open(l,"nicepay_receipt","width=800,height=600,scrollbars=yes,resizable=yes")});const i=o.lastElementChild;o.insertBefore(r,i),console.info(`[${j}] receipt button injected on order complete page`)}function xt(){const e=location.pathname.match(Ct);e&&Et(e[1])}function At(){if(typeof window>"u")return;const e=window;if(e[me])return;e[me]=!0,console.info(`[${j}] order complete receipt injector installed`);const t=(a=1200)=>setTimeout(xt,a);document.readyState==="loading"?document.addEventListener("DOMContentLoaded",()=>t()):t();const n=history.pushState.bind(history);history.pushState=(...a)=>{n(...a),t()},window.addEventListener("popstate",()=>t(500))}const A="sirsoft-pay_nicepayments",Pe="__nicepayOrderShowInjectorInstalled",we="nicepay-mp-receipt-row",_e="nicepay-mp-vbank-info",vt=/^\/mypage\/orders\/([^/]+)$/;function Lt(e){try{const n=window.G7Core?.getState,r=n?.()?.currentDataContext?.order?.data;return!r||r.order_number!==e?null:r}catch{return null}}function It(){return localStorage.getItem("auth_token")}async function be(e){const t=It();if(!t)return null;try{const n=await fetch(`/api/plugins/${A}/user/orders/${e}/receipt`,{headers:{Authorization:`Bearer ${t}`,Accept:"application/json"}});return n.ok?await n.json():null}catch{return null}}function Tt(e,t){if(!t)return!1;const n=Array.from(e.querySelectorAll("div"));for(const a of n){const o=Array.from(a.children).filter(s=>s instanceof HTMLElement&&s.tagName==="SPAN");if(o.length<2)continue;const r=o[0].textContent?.trim();if(r!=="결제 방법"&&r!=="결제수단"&&r!=="Payment Method")continue;const i=o[o.length-1];return i.textContent?.trim()!==t&&(i.textContent=t,i.dataset.nicepayPaymentMethodPatched="true"),a.dataset.nicepayPaymentMethodRow="true",!0}return!1}function Rt(){const e=document.getElementById("order_payment_info_panel");if(e)return Array.from(e.children).find(a=>a.className?.includes("space-y"))??e;const t=Array.from(document.querySelectorAll("h3")).find(a=>a.textContent?.includes("결제 정보"));if(!t)return null;const n=t.parentElement?.parentElement;return n?Array.from(n.children).find(a=>a.className?.includes("space-y"))??n:null}function Mt(e){const t=document.createElement("div");t.id=we,t.className="flex items-center justify-between";const n=document.createElement("span");n.className="text-gray-500 dark:text-gray-400 text-sm",n.textContent="영수증";const a=document.createElement("button");return a.type="button",a.className="inline-flex items-center gap-1 text-sm text-blue-600 dark:text-blue-400 hover:underline disabled:opacity-50",a.textContent="영수증 조회",a.addEventListener("click",async()=>{a.disabled=!0,a.textContent="로딩 중...";const o=await be(e);a.disabled=!1,a.textContent="영수증 조회";const r=o?.receipt_url??null;r&&window.open(r,"nicepay_receipt","width=800,height=600,scrollbars=yes,resizable=yes")}),t.appendChild(n),t.appendChild(a),t}function $t(e){if(!e)return"";try{const t=new Date(e);if(Number.isNaN(t.getTime()))return e;const n=a=>String(a).padStart(2,"0");return`${t.getFullYear()}-${n(t.getMonth()+1)}-${n(t.getDate())} ${n(t.getHours())}:${n(t.getMinutes())}:${n(t.getSeconds())}`}catch{return e}}function v(e,t,n="font-medium text-gray-900 dark:text-white"){const a=document.createElement("div");a.className="flex justify-between text-sm";const o=document.createElement("span");o.className="text-gray-600 dark:text-gray-400",o.textContent=e;const r=document.createElement("span");return r.className=n,r.textContent=t,a.appendChild(o),a.appendChild(r),a}function Ot(e){const t=e.payment??{},n=document.createElement("div");n.id=_e,n.className="pt-4 mt-2 border-t border-gray-200 dark:border-gray-700";const a=document.createElement("div");a.className="bg-blue-50 dark:bg-blue-900/30 border border-blue-200 dark:border-blue-700 rounded-lg p-4";const o=document.createElement("h3");o.className="text-sm font-semibold text-blue-800 dark:text-blue-300 mb-3",o.textContent="가상계좌 입금 안내";const r=document.createElement("div");r.className="space-y-2",r.appendChild(v("은행",t.vbank_name??"")),r.appendChild(v("계좌번호",t.vbank_number??"","font-medium font-mono text-gray-900 dark:text-white")),r.appendChild(v("예금주",t.vbank_holder??"")),r.appendChild(v("입금 금액",e.total_amount_formatted??"","font-bold text-blue-600 dark:text-blue-400"));const i=t.vbank_due_at;if(i){const s=document.createElement("div");s.className="flex justify-between text-sm pt-2 border-t border-blue-200 dark:border-blue-700 mt-2";const l=document.createElement("span");l.className="text-gray-600 dark:text-gray-400",l.textContent="입금 기한";const u=document.createElement("span");u.className="font-medium text-red-600 dark:text-red-400",u.textContent=$t(i),s.appendChild(l),s.appendChild(u),r.appendChild(s)}if(a.appendChild(o),a.appendChild(r),!t.paid_at){const s=document.createElement("p");s.className="text-xs text-blue-700 dark:text-blue-300 mt-3",s.textContent="입금 기한 내에 입금이 완료되지 않으면 주문이 자동 취소됩니다.",a.appendChild(s)}return n.appendChild(a),n}async function Dt(e){const t=Lt(e);if(!t)return!1;const{payment:n}=t;if(!n||n.pg_provider!=="nicepayments")return!0;const a=Rt();if(!a)return!1;const o=await be(e);return Tt(a,o?.payment_method_display_label),n.payment_method==="vbank"&&n.vbank_number&&!document.getElementById(_e)&&(a.appendChild(Ot(t)),console.info(`[${A}] vbank info injected on mypage order show`)),!n.transaction_id||!n.paid_at||document.getElementById(we)||(a.appendChild(Mt(e)),console.info(`[${A}] receipt button injected on mypage order show`)),!0}function Bt(e){let t=0;const n=setInterval(()=>{t++,Dt(e).then(a=>{(a||t>=30)&&clearInterval(n)})},400)}function Gt(){const e=location.pathname.match(vt);e&&Bt(e[1])}function jt(){if(typeof window>"u")return;const e=window;if(e[Pe])return;e[Pe]=!0,console.info(`[${A}] mypage order show injector installed`);const t=(a=1500)=>setTimeout(Gt,a);document.readyState==="loading"?document.addEventListener("DOMContentLoaded",()=>t()):t();const n=history.pushState.bind(history);history.pushState=(...a)=>{n(...a),t(600)},window.addEventListener("popstate",()=>t(500))}const qt="sirsoft-pay_nicepayments",Ne="__nicepayAdminPaymentMethodBrandInjectorInstalled",Ce="__nicepayAdminPaymentMethodBrandSyncListenerAttached",Ft=/^\/admin\/ecommerce\/settings\/?$/,ke='[data-nicepay-admin-payment-brand-mark="true"]',Yt=200,Ht=120,Ut=[{id:"nicepay_naverpay",labels:["네이버페이 (나이스페이먼츠)","네이버페이로 결제 (나이스페이먼츠)","Naver Pay (NicePayments)","Pay with Naver Pay (NicePayments)"],shortLabels:[],markLines:["N"],markClassName:"bg-green-500 text-white"},{id:"nicepay_kakaopay",labels:["카카오페이 (나이스페이먼츠)","카카오페이로 결제 (나이스페이먼츠)","Kakao Pay (NicePayments)","Pay with Kakao Pay (NicePayments)"],shortLabels:[],markLines:["K"],markClassName:"bg-yellow-400 text-gray-950"},{id:"nicepay_samsungpay",labels:["삼성페이 (나이스페이먼츠)","삼성페이로 결제 (나이스페이먼츠)","Samsung Pay (NicePayments)","Pay with Samsung Pay (NicePayments)"],shortLabels:[],markLines:["S"],markClassName:"bg-blue-600 text-white"},{id:"nicepay_applepay",labels:["애플페이 (나이스페이먼츠)","애플페이로 결제 (나이스페이먼츠)","Apple Pay (NicePayments)","Pay with Apple Pay (NicePayments)"],shortLabels:[],markLines:["A"],markClassName:"bg-gray-900 text-white"},{id:"nicepay_payco",labels:["PAYCO (나이스페이먼츠)","PAYCO로 결제 (나이스페이먼츠)","PAYCO (NicePayments)","Pay with PAYCO (NicePayments)"],shortLabels:[],markLines:["P"],markClassName:"bg-red-500 text-white"},{id:"nicepay_skpay",labels:["11pay (나이스페이먼츠)","11pay로 결제 (나이스페이먼츠)","11pay (NicePayments)","Pay with 11pay (NicePayments)"],shortLabels:[],markLines:["11"],markClassName:"bg-orange-500 text-white"},{id:"nicepay_ssgpay",labels:["SSG페이 (나이스페이먼츠)","SSG페이로 결제 (나이스페이먼츠)","SSG Pay (NicePayments)","Pay with SSG Pay (NicePayments)"],shortLabels:[],markLines:["SSG"],markClassName:"bg-red-700 text-white"},{id:"nicepay_lpay",labels:["L.pay (나이스페이먼츠)","L.pay로 결제 (나이스페이먼츠)","L.pay (NicePayments)","Pay with L.pay (NicePayments)"],shortLabels:[],markLines:["L"],markClassName:"bg-purple-600 text-white"}];let Se=null,L=null,q=!1;function Kt(){return window}function F(){if(!Ft.test(window.location.pathname))return!1;const e=new URLSearchParams(window.location.search).get("tab");return e===null||e===""||e==="order_settings"}function Wt(e){return e instanceof HTMLElement?e.className:""}function Ee(e){return(e??"").replace(/\u200B/g,"").replace(/\s+/g," ").trim()}function Vt(e){const t=Wt(e);return t.includes("excel-card")||t.includes("flex-center")&&t.includes("border")&&t.includes("gap-4")}function xe(e){return e.querySelector(".font-medium")}function zt(e){const t=Ee(xe(e)?.textContent),n=Ee(e.textContent);return Ut.find(a=>a.shortLabels.some(o=>t===o)||a.labels.some(o=>n.includes(o)))??null}function Jt(e){return Array.from(e.querySelectorAll("div")).filter(Vt)}function Xt(e){return Array.from(e.querySelectorAll("svg, [data-icon], i")).find(n=>!n.closest("[data-drag-handle]")&&!n.closest(ke)&&!n.closest('.row-stack, .excel-card-body, button, select, [role="switch"]'))??null}function Ae(e,t){e.dataset.nicepayAdminPaymentBrandMark="true",e.dataset.nicepayAdminPaymentMethod=t.id,e.setAttribute("aria-hidden","true"),e.className=`inline-flex items-center justify-center rounded-lg font-bold ${t.markClassName}`,e.style.width="32px",e.style.height="32px",e.style.flex="0 0 32px",e.style.lineHeight="1",e.style.fontSize=t.markLines.join("").length>2?"9px":"12px";const n=t.markLines.join("");e.textContent!==n&&(e.textContent=t.markLines[0]??"")}function Qt(e){const t=document.createElement("span");return Ae(t,e),t}function Zt(e,t){const n=e.querySelector(ke);if(n instanceof HTMLSpanElement)return e.dataset.nicepayAdminPaymentMethod=t.id,Ae(n,t),!0;const a=Qt(t),o=Xt(e);if(o&&o.parentElement)return e.dataset.nicepayAdminPaymentMethod=t.id,o.replaceWith(a),!0;const r=xe(e);return r&&r.parentElement?(e.dataset.nicepayAdminPaymentMethod=t.id,r.parentElement.insertBefore(a,r),!0):!1}function Y(e=document){if(typeof window>"u"||typeof document>"u"||!F())return!1;let t=!1;return Jt(e).forEach(n=>{const a=zt(n);a&&Zt(n,a)&&(t=!0)}),t}function en(){q||(q=!0,window.setTimeout(()=>{q=!1,Y()},0))}function H(){L!==null&&(window.clearInterval(L),L=null)}function U(){if(!F())return;H(),Y();let e=0;L=window.setInterval(()=>{e+=1,Y(),e>=Ht&&H()},Yt);const t=document.body;t[Ce]||(t[Ce]=!0,Se=new MutationObserver(()=>en()),Se.observe(document.body,{childList:!0,subtree:!0,characterData:!0}))}function ve(){if(F()){U();return}H()}function tn(){if(typeof window>"u"||typeof document>"u")return;const e=Kt();if(e[Ne])return;e[Ne]=!0,console.info(`[${qt}] admin payment method brand sync installed`),document.readyState==="loading"?document.addEventListener("DOMContentLoaded",()=>U()):U();const t=history.pushState.bind(history);history.pushState=(...n)=>{t(...n),window.setTimeout(()=>ve(),200)},window.addEventListener("popstate",()=>window.setTimeout(()=>ve(),200))}const K="sirsoft-pay_nicepayments",Le="__nicepayAdminPaymentDisplayInjectorInstalled",nn=/^\/admin\/ecommerce\/orders\/([^/]+)$/;function an(){return localStorage.getItem("auth_token")}async function rn(e){const t=an();if(!t)return null;try{const n=await fetch(`/api/plugins/${K}/admin/orders/${e}/transaction-status`,{headers:{Authorization:`Bearer ${t}`,Accept:"application/json"}});if(!n.ok)return null;const a=await n.json();return("data"in a?a.data:a)??null}catch{return null}}function on(e){return Array.from(e.children).filter(t=>t instanceof HTMLElement)}function sn(e,t){let n=!1;const a=Array.from(e.querySelectorAll("div"));for(const o of a){const r=on(o),i=r.findIndex(m=>m.textContent?.trim()==="결제수단");if(i<0)continue;const s=r.slice(i+1).find(m=>m.textContent?.trim()&&m.textContent.trim()!=="결제수단");if(!s)continue;const l=r.slice(i+2).find(m=>/^\(.+\)$/.test(m.textContent?.trim()??"")),u=l?.textContent?.trim().replace(/^\(|\)$/g,"")??"",b=u&&t.endsWith(")")?t.replace(/\)$/,`, ${u})`):t;s.textContent?.trim()!==b&&(s.textContent=b,s.dataset.nicepayPaymentMethodPatched="true"),o.dataset.nicepayPaymentMethodRow="admin-order",l&&u&&(l.textContent="",l.style.display="none",l.dataset.nicepayPaymentInstallmentHidden="true"),n=!0}return n}function cn(e,t,n){const o=Array.from(e.querySelectorAll("span")).filter(r=>r.textContent?.trim()===t).find(r=>{const i=typeof r.className=="string"?r.className:"";return i.includes("rounded-full")||i.includes("font-medium")});return o?(o.textContent=n,o.dataset.nicepayPaymentMethodPatched="true",o.dataset.nicepayPaymentMethodBadge="admin-order",!0):!1}function ln(e,t){const n=t?._pay_method_label,a=t?._embedded_pg_provider_label,o=t?._base_pay_method_label;if(!n||!a)return!1;const r=sn(e,n),i=o?cn(e,o,a):!1;return r||i}async function dn(e){const t=document.getElementById("section_payment_info")??document.getElementById("payment_info_card");if(!t)return!1;const n=await rn(e);return n&&ln(t,n)&&console.info(`[${K}] payment method display patched on admin order detail`),!0}function un(e){let t=0;const n=setInterval(()=>{t++,dn(e).then(a=>{(a||t>=30)&&clearInterval(n)})},400)}function yn(){const e=location.pathname.match(nn);e&&un(e[1])}function pn(){if(typeof window>"u")return;const e=window;if(e[Le])return;e[Le]=!0,console.info(`[${K}] admin order payment display injector installed`);const t=(a=1500)=>setTimeout(yn,a);document.readyState==="loading"?document.addEventListener("DOMContentLoaded",()=>t()):t();const n=history.pushState.bind(history);history.pushState=(...a)=>{n(...a),t(600)},window.addEventListener("popstate",()=>t(500))}const N="sirsoft-pay_nicepayments",W={info:(...e)=>console.info(`[${N}]`,...e),warn:(...e)=>console.warn(`[${N}]`,...e),error:(...e)=>console.error(`[${N}]`,...e)};function Ie(){const e=window.G7Core;if(!e)return 0;const t=e.getActionDispatcher;if(typeof t!="function")return 0;const n=t();if(!n||typeof n.registerHandler!="function")return 0;let a=0;for(const[o,r]of Object.entries(ee)){const i=`${N}.${o}`;n.registerHandler(i,r,{category:"plugin",source:N}),a++}return a}function Te(){et(),Nt(),At(),jt(),tn(),pn();const e=()=>{const t=Ie();if(t>0){W.info(`${t} handler(s) registered`),Z();return}let n=0;const a=50,o=setInterval(()=>{n++;const r=Ie();if(r>0){clearInterval(o),W.info(`${r} handler(s) registered (after ${n} retries)`),Z();return}n>=a&&(clearInterval(o),W.warn("ActionDispatcher not available after timeout"))},100)};document.readyState==="loading"?document.addEventListener("DOMContentLoaded",e):e()}Te(),window.__SirsoftNicepayments={identifier:N,handlers:Object.keys(ee),initPlugin:Te}})();
+//# sourceMappingURL=plugin.iife.js.map
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/dist/js/plugin.iife.js.map b/plugins/_bundled/sirsoft-pay_nicepayments/dist/js/plugin.iife.js.map
new file mode 100644
index 00000000..524423d7
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/dist/js/plugin.iife.js.map
@@ -0,0 +1 @@
+{"version":3,"file":"plugin.iife.js","sources":["../../resources/js/paymentCloseReport.ts","../../resources/js/handlers/requestPayment.ts","../../resources/js/handlers/setPaymentMethod.ts","../../resources/js/handlers/index.ts","../../resources/js/orderResponseInterceptor.ts","../../resources/js/checkoutEasyPayInjector.ts","../../resources/js/orderCompleteReceiptInjector.ts","../../resources/js/mypageOrderShowInjector.ts","../../resources/js/adminPaymentMethodBrandInjector.ts","../../resources/js/adminOrderPaymentDisplayInjector.ts","../../resources/js/index.ts"],"sourcesContent":["export interface PaymentCloseReportContext {\n    closeReportUrl?: string;\n    oid: string;\n    price: number;\n    buyer_email?: string;\n    buyer_phone?: string;\n    payment_method?: string;\n}\n\nfunction resolveApiUrl(url: string): string {\n    if (/^https?:\\/\\//i.test(url) || url.startsWith('/api/')) {\n        return url;\n    }\n\n    if (url.startsWith('/plugins/')) {\n        return `/api${url}`;\n    }\n\n    if (url.startsWith('plugins/')) {\n        return `/api/${url}`;\n    }\n\n    return url;\n}\n\nfunction trimReason(reason: string): string {\n    return reason.trim().slice(0, 160);\n}\n\nexport async function reportPaymentWindowClosed(\n    context: PaymentCloseReportContext,\n    reason = 'nicepay-window-closed',\n): Promise<void> {\n    if (!context.closeReportUrl) {\n        return;\n    }\n\n    const payload = {\n        oid: context.oid,\n        price: Number(context.price),\n        buyer_email: context.buyer_email ?? '',\n        buyer_phone: context.buyer_phone ?? '',\n        payment_method: context.payment_method ?? '',\n        reason: trimReason(reason) || 'nicepay-window-closed',\n    };\n\n    try {\n        const apiClient = ((window as any).G7Core)?.api;\n        if (typeof apiClient?.post === 'function') {\n            await apiClient.post(context.closeReportUrl, payload);\n            return;\n        }\n\n        await fetch(resolveApiUrl(context.closeReportUrl), {\n            method: 'POST',\n            headers: { 'Content-Type': 'application/json' },\n            body: JSON.stringify(payload),\n            keepalive: true,\n        });\n    } catch (error) {\n        console.warn('[sirsoft-pay_nicepayments] failed to report payment window close', error);\n    }\n}\n","import { reportPaymentWindowClosed } from '../paymentCloseReport';\n\ninterface G7ApiResponse {\n    data?: unknown;\n}\n\ninterface G7CoreApi {\n    get: (url: string) => Promise<G7ApiResponse>;\n    post?: (url: string, data?: Record<string, unknown>) => Promise<G7ApiResponse>;\n}\n\ninterface G7CoreToast {\n    error: (message: string) => void;\n}\n\ninterface G7CoreStateApi {\n    setLocal: (state: Record<string, unknown>) => void;\n}\n\ninterface G7Core {\n    api: G7CoreApi;\n    toast?: G7CoreToast;\n    state?: G7CoreStateApi;\n}\n\ninterface TemplateLocalState {\n    paymentMethod?: string;\n}\n\ninterface TemplateApp {\n    globalState?: {\n        _local?: TemplateLocalState;\n    };\n}\n\ninterface PgPaymentData {\n    order_number: string;\n    order_name: string;\n    amount: number;\n    currency?: string;\n    customer_name?: string;\n    customer_email?: string;\n    customer_phone?: string;\n    goods_cl?: string; // 휴대폰결제 상품 유형: '0'=디지털컨텐츠, '1'=실물\n}\n\ninterface RequestPaymentParams {\n    pgPaymentData: PgPaymentData;\n    paymentMethod?: string;\n}\n\ninterface ClientConfig {\n    mid: string;\n    sdk_url: string;\n    sign_data_url: string;\n    close_report_url?: string;\n    useEscrow?: boolean;\n}\n\ninterface SignDataResponse {\n    ediDate: string;\n    signData: string;\n    mid: string;\n}\n\ninterface PaymentAction {\n    params?: RequestPaymentParams;\n}\n\ndeclare global {\n    interface Window {\n        nicepaySubmit: () => void;\n        nicepayClose: (resultCode: string, resultMsg: string) => void;\n        goPay: (form: HTMLFormElement) => void;\n        G7Core: G7Core;\n        __templateApp?: TemplateApp;\n    }\n}\n\nfunction loadScript(src: string): Promise<void> {\n    return new Promise((resolve, reject) => {\n        if (document.querySelector(`script[src=\"${src}\"]`)) {\n            resolve();\n            return;\n        }\n\n        const script = document.createElement('script');\n        script.src = src;\n        script.onload = () => resolve();\n        script.onerror = () => reject(new Error(`Failed to load script: ${src}`));\n        document.head.appendChild(script);\n    });\n}\n\nfunction createPaymentForm(action: string, fields: Record<string, string>): HTMLFormElement {\n    const form = document.createElement('form');\n    form.id = 'nicepayForm';\n    form.method = 'post';\n    form.action = action;\n    // CharSet 필드와 일치 — 모바일은 form.acceptCharset 으로 charset 결정\n    form.acceptCharset = 'utf-8';\n\n    for (const [name, value] of Object.entries(fields)) {\n        const input = document.createElement('input');\n        input.type = 'hidden';\n        input.name = name;\n        input.value = value;\n        form.appendChild(input);\n    }\n\n    document.body.appendChild(form);\n    return form;\n}\n\nconst CALLBACK_PATH = '/plugins/sirsoft-pay_nicepayments/payment/callback';\n\n// 나이스페이 v3 모바일 결제창 endpoint — 폼을 직접 POST 하면 NicePay 모바일 페이지로 전체 redirect.\n// PC 와 달리 SDK 불필요. 결제 완료 후 ReturnURL 로 redirect.\nconst NICEPAY_MOBILE_ENDPOINT = 'https://web.nicepay.co.kr/v3/v3Payment.jsp';\n\n/**\n * 모바일 환경 판별.\n *\n * 판별 우선순위:\n * 1. navigator.userAgentData.mobile — 브라우저가 직접 판단하는 표준 API (Chrome/Edge 90+)\n * 2. UA 문자열 정규식 — iOS/Android/Windows Phone 및 주요 인앱 브라우저\n * 3. maxTouchPoints 보조 판단 — iPadOS처럼 데스크탑 UA를 보내는 터치 기기 처리\n *    (Windows/Mac 데스크탑 터치스크린 오탐 방지를 위해 플랫폼 확인 병행)\n */\nfunction isMobileDevice(): boolean {\n    if (typeof navigator === 'undefined') return false;\n\n    // 1단계: User Agent Client Hints (가장 정확, 브라우저가 직접 판단)\n    const nav = navigator as Navigator & { userAgentData?: { mobile: boolean } };\n    if (nav.userAgentData?.mobile !== undefined) {\n        return nav.userAgentData.mobile;\n    }\n\n    // 2단계: UA 문자열 파싱\n    const ua = (navigator.userAgent || '').toLowerCase();\n    const mobileUA = /android|iphone|ipod|windows phone|iemobile|blackberry|opera mini|mobile safari/;\n    if (mobileUA.test(ua)) return true;\n\n    // 3단계: iPadOS 등 데스크탑 UA를 보내는 터치 기기 판별\n    // maxTouchPoints > 1 이면 실제 멀티터치 기기 (터치스크린 노트북은 보통 1)\n    // Windows/Mac 플랫폼이면 데스크탑으로 간주하여 오탐 방지\n    const touchPoints = (navigator as Navigator & { maxTouchPoints?: number }).maxTouchPoints ?? 0;\n    if (touchPoints > 1 && !ua.includes('windows') && !ua.includes('macintosh')) {\n        return true;\n    }\n\n    return false;\n}\n\n/**\n * 나이스페이먼츠 결제창 호출 핸들러 (나이스페이 구형 API, goPay 방식)\n *\n * 체크아웃 레이아웃에서 주문 생성 API 성공 후 호출됩니다:\n *   handler: \"sirsoft-pay_nicepayments.requestPayment\"\n *   params: { pgPaymentData: response.data.pg_payment_data }\n *\n * 호출 순서:\n *   1. Client Config API 호출 → MID, SDK URL, SignData URL 획득\n *   2. 환경 분기: PC 면 SDK 동적 로드 / 모바일 은 SDK 생략\n *   3. 서버에서 EdiDate + SignData 생성\n *   4. 결제 폼 생성:\n *      - PC: 폼 action=ReturnURL → goPay(form) 으로 iframe 팝업\n *      - 모바일: 폼 action=https://web.nicepay.co.kr/v3/v3Payment.jsp → 직접 submit (전체 페이지 redirect)\n *   5. 결제 완료 시 나이스페이먼츠가 ReturnURL(POST)로 인증값 전달\n *\n * NicePay 의 PC SDK 는 모바일 자동 감지를 하지 않으므로 UA 기반 분기가 필수.\n * 잘못 분기하면 모바일에서도 PC 팝업이 떠 사용성이 매우 나빠짐.\n */\nexport async function requestPaymentHandler(action: PaymentAction, _context?: unknown): Promise<void> {\n    const { pgPaymentData, paymentMethod: paramPaymentMethod } = action.params ?? {};\n\n    const localState = window.__templateApp?.globalState?._local;\n    const paymentMethod = paramPaymentMethod ?? localState?.paymentMethod ?? 'card';\n\n    if (!pgPaymentData) {\n        console.error('[sirsoft-pay_nicepayments] pgPaymentData is required');\n        return;\n    }\n\n    const G7Core = window.G7Core;\n\n    try {\n        // 1. Client Config 가져오기\n        const configJson = await G7Core.api.get('/modules/sirsoft-ecommerce/payments/client-config/nicepayments');\n\n        if (!configJson.data) {\n            console.error('[sirsoft-pay_nicepayments] Failed to fetch client config', configJson);\n            return;\n        }\n\n        const config = configJson.data as ClientConfig;\n        const isMobile = isMobileDevice();\n\n        // 2. PC 인 경우에만 SDK 로드 (모바일 은 직접 form submit 으로 NicePay 모바일 페이지로 이동)\n        if (!isMobile) {\n            await loadScript(config.sdk_url);\n\n            if (typeof window.goPay !== 'function') {\n                G7Core?.toast?.error?.('나이스페이먼츠 SDK를 불러올 수 없습니다. 잠시 후 다시 시도해주세요.');\n                G7Core?.state?.setLocal?.({ isSubmittingOrder: false, paymentMethod });\n                return;\n            }\n        }\n\n        // 3. 서버에서 EdiDate + SignData 생성\n        //    공개 엔드포인트지만 서버에서 주문번호, 결제 전 상태, 금액, 구매자 컨텍스트를 검증한다.\n        const signDataUrl = window.location.origin + config.sign_data_url;\n        const authToken = (typeof localStorage !== 'undefined') ? localStorage.getItem('auth_token') : null;\n        const signDataHeaders: Record<string, string> = {\n            'Content-Type': 'application/json',\n            'X-Requested-With': 'XMLHttpRequest',\n            'Accept': 'application/json',\n        };\n        if (authToken) {\n            signDataHeaders['Authorization'] = `Bearer ${authToken}`;\n        }\n        const signDataRes = await fetch(signDataUrl, {\n            method: 'POST',\n            credentials: 'include',\n            headers: signDataHeaders,\n            body: JSON.stringify({\n                amt: pgPaymentData.amount,\n                moid: pgPaymentData.order_number,\n                buyer_email: pgPaymentData.customer_email ?? '',\n                buyer_phone: pgPaymentData.customer_phone ?? '',\n            }),\n        });\n\n        if (!signDataRes.ok) {\n            throw new Error('SignData 생성에 실패했습니다.');\n        }\n\n        const signData: SignDataResponse = await signDataRes.json();\n        const callbackUrl = window.location.origin + CALLBACK_PATH;\n\n        // 4. 결제 폼 생성\n        // 간편결제는 PayMethod='CARD' + DirectShowOpt='CARD' + 방식별 directive 필드 조합.\n        // PayMethod에 'KAKAOPAY' 등을 직접 넣으면 [W004] 발생 — gnu5 orderform.js 동일 방식.\n        const isEasyPay = typeof paymentMethod === 'string' && paymentMethod.startsWith('nicepay_');\n\n        const payMethodMap: Record<string, string> = {\n            card: 'CARD',\n            vbank: 'VBANK',\n            bank: 'BANK',\n            phone: 'CELLPHONE',\n        };\n        const payMethod = isEasyPay ? 'CARD' : (payMethodMap[paymentMethod ?? 'card'] ?? 'CARD');\n\n        const formFields: Record<string, string> = {\n            PayMethod: payMethod,\n            GoodsName: pgPaymentData.order_name,\n            Amt: String(pgPaymentData.amount),\n            MID: signData.mid,\n            Moid: pgPaymentData.order_number,\n            BuyerName: pgPaymentData.customer_name ?? '',\n            BuyerEmail: pgPaymentData.customer_email ?? '',\n            BuyerTel: pgPaymentData.customer_phone ?? '',\n            ReturnURL: callbackUrl,\n            EdiDate: signData.ediDate,\n            SignData: signData.signData,\n            CharSet: 'utf-8',\n            GoodsCl: '1',\n            DirectShowOpt: '',\n            DirectEasyPay: '',\n            NicepayReserved: '',\n            EasyPayMethod: '',\n            MallReserved: '',\n            MallReserved1: '',\n        };\n\n        // 휴대폰결제: 상품 유형 덮어쓰기 (0:디지털컨텐츠, 1:실물)\n        if (payMethod === 'CELLPHONE') {\n            formFields.GoodsCl = pgPaymentData.goods_cl ?? '1';\n        }\n\n        // TransType: 에스크로 활성 + 일반결제 → '1', 그 외(간편결제 포함) → '0'\n        const useEscrow = config.useEscrow && !isEasyPay;\n        formFields.TransType = useEscrow ? '1' : '0';\n\n        // 간편결제 directive 필드 설정 — gnu5 orderform.js switch(settle_method==='간편결제') 동일\n        if (isEasyPay) {\n            formFields.DirectShowOpt = 'CARD';\n            formFields.MallReserved = `nicepay_easy_pay_method=${encodeURIComponent(paymentMethod)}`;\n            formFields.MallReserved1 = paymentMethod;\n            switch (paymentMethod) {\n                case 'nicepay_naverpay':\n                    formFields.DirectEasyPay = 'E020';\n                    formFields.EasyPayMethod = 'E020=CARD';\n                    break;\n                case 'nicepay_kakaopay':\n                    formFields.NicepayReserved = 'DirectKakao=Y';\n                    break;\n                case 'nicepay_samsungpay':\n                    formFields.DirectEasyPay = 'E021';\n                    break;\n                case 'nicepay_applepay':\n                    formFields.DirectEasyPay = 'E025';\n                    break;\n                case 'nicepay_payco':\n                    formFields.NicepayReserved = 'DirectPayco=Y';\n                    break;\n                case 'nicepay_skpay':\n                    formFields.NicepayReserved = 'DirectPay11=Y';\n                    break;\n                case 'nicepay_ssgpay':\n                    formFields.DirectEasyPay = 'E007';\n                    break;\n                case 'nicepay_lpay':\n                    formFields.DirectEasyPay = 'E018';\n                    break;\n            }\n        }\n\n        // 4-2. 과세/비과세 금액 조회 (optional — 실패해도 결제 진행)\n        try {\n            const orderRes = await G7Core.api.get(`/modules/sirsoft-ecommerce/user/orders/${pgPaymentData.order_number}`);\n            const od = orderRes?.data as Record<string, unknown> | null | undefined;\n            if (od) {\n                const taxAmt = Number(od['total_tax_amount'] ?? 0);\n                const vatAmt = Number(od['total_vat_amount'] ?? 0);\n                const taxFreeAmt = Number(od['total_tax_free_amount'] ?? 0);\n                if (taxAmt > 0 || vatAmt > 0 || taxFreeAmt > 0) {\n                    formFields.TaxAmt = String(taxAmt);\n                    formFields.VatAmt = String(vatAmt);\n                    formFields.TaxFreeAmt = String(taxFreeAmt);\n                }\n            }\n        } catch {\n            // 과세 필드는 선택 사항 — 조회 실패 시 미포함 상태로 진행\n        }\n\n        const form = createPaymentForm(callbackUrl, formFields);\n\n        if (isMobile) {\n            // 모바일 결제창 호출:\n            //   - form.action = NicePay 모바일 endpoint\n            //   - acceptCharset = 'euc-kr' : NicePay v3 mobile 은 EUC-KR 로 form 데이터를 받음\n            //     (NicePay 공식 샘플과 동일). 브라우저가 자동으로 UTF-8 → EUC-KR 변환.\n            //   - CharSet 입력값도 'euc-kr' 로 일치 — NicePay 가 같은 인코딩으로 디코딩하도록.\n            //     (utf-8 그대로 두면 GoodsName/BuyerName 한글이 mojibake \"遺?瑜?\" 로 깨짐)\n            //   결제 완료 후 NicePay 가 ReturnURL 로 redirect.\n            form.action = NICEPAY_MOBILE_ENDPOINT;\n            form.acceptCharset = 'euc-kr';\n            const charsetInput = form.querySelector('input[name=\"CharSet\"]') as HTMLInputElement | null;\n            if (charsetInput) {\n                charsetInput.value = 'euc-kr';\n            }\n            form.submit();\n            // 페이지 자체가 redirect 되므로 정리 로직 불필요. submit 후 이 함수의 후속 코드는 실행되지 않음.\n            return;\n        }\n\n        // 이하 PC 전용 — iframe 팝업 + nicepaySubmit / nicepayClose 콜백 처리\n\n        // 5. 나이스페이 전역 콜백 정의\n        window.nicepaySubmit = () => {\n            form.submit();\n        };\n\n        let paymentClosed = false;\n\n        // goPay() 전 body 자식 스냅샷 — SDK가 추가하는 오버레이/iframe 식별용\n        const bodySnapshot = new Set(document.body.children);\n\n        const closePayment = (_resultCode: string, resultMsg: string) => {\n            if (paymentClosed) return;\n            paymentClosed = true;\n            const closeReason = [_resultCode, resultMsg].filter(Boolean).join(': ') || 'nicepay-window-closed';\n            void reportPaymentWindowClosed({\n                closeReportUrl: config.close_report_url,\n                oid: pgPaymentData.order_number,\n                price: Number(pgPaymentData.amount),\n                buyer_email: pgPaymentData.customer_email ?? '',\n                buyer_phone: pgPaymentData.customer_phone ?? '',\n                payment_method: paymentMethod,\n            }, closeReason);\n            window.removeEventListener('popstate', handlePopState);\n            // SDK가 body에 추가한 오버레이/iframe 등 제거\n            Array.from(document.body.children).forEach(el => {\n                if (!bodySnapshot.has(el)) el.remove();\n            });\n            if (form.parentNode) form.parentNode.removeChild(form);\n            (window as unknown as Record<string, unknown>)['__sirsoftNicepayPaymentInProgress'] = false;\n            G7Core?.state?.setLocal?.({ isSubmittingOrder: false, paymentMethod });\n            if (resultMsg) G7Core?.toast?.error?.(resultMsg);\n        };\n\n        window.nicepayClose = closePayment;\n\n        // 뒤로가기(popstate) 감지 → 결제창 정리\n        const handlePopState = () => closePayment('', '');\n\n        // 결제창 열기 전 history state 추가 → 뒤로가기 시 popstate 발생\n        window.history.pushState({ nicepayOpen: true }, '');\n        window.addEventListener('popstate', handlePopState);\n\n        // 6. PC 결제창 호출 (iframe 팝업)\n        window.goPay(form);\n\n    } catch (error: unknown) {\n        console.error('[sirsoft-pay_nicepayments] requestPayment error', error);\n        (window as unknown as Record<string, unknown>)['__sirsoftNicepayPaymentInProgress'] = false;\n        G7Core?.state?.setLocal?.({ isSubmittingOrder: false, paymentMethod });\n        G7Core?.toast?.error?.('결제 중 오류가 발생했습니다. 잠시 후 다시 시도해주세요.');\n    }\n}\n","/* eslint-disable @typescript-eslint/no-explicit-any */\n\nconst METHOD_TO_TEXT: Record<string, string> = {\n    nicepay_naverpay:   '네이버페이',\n    nicepay_kakaopay:   '카카오페이',\n    nicepay_samsungpay: '삼성페이',\n    nicepay_applepay:   '애플페이',\n    nicepay_payco:      'PAYCO',\n    nicepay_skpay:      '11pay',\n    nicepay_ssgpay:     'SSG페이',\n    nicepay_lpay:       'L.pay',\n};\n\n// 흰색 내부 ring + 어두운 외부 ring으로 어떤 버튼 배경색에도 선택 상태가 확실히 보임\nconst SELECTED_SHADOW = '0 0 0 2px #ffffff, 0 0 0 5px rgba(0,0,0,0.55)';\n\nfunction getEasyPayButtonContainer(): Element | null {\n    const section = document.getElementById('nicepay_checkout_payment_section');\n    if (!section) return null;\n    const paras = section.querySelectorAll('p');\n    for (const p of paras) {\n        if (p.textContent?.includes('간편결제')) {\n            return p.nextElementSibling;\n        }\n    }\n    return null;\n}\n\nfunction clearEasyPayButtonStyles(): void {\n    const container = getEasyPayButtonContainer();\n    if (!container) return;\n    container.querySelectorAll<HTMLButtonElement>('button').forEach(btn => {\n        btn.style.boxShadow = '';\n        btn.style.outline = '';\n    });\n}\n\nfunction updateEasyPayButtonStyles(selectedMethod: string): void {\n    const container = getEasyPayButtonContainer();\n    if (!container) return;\n\n    const selectedText = METHOD_TO_TEXT[selectedMethod];\n    container.querySelectorAll<HTMLButtonElement>('button').forEach(btn => {\n        if (btn.textContent?.trim() === selectedText) {\n            btn.style.boxShadow = SELECTED_SHADOW;\n            btn.style.outline = 'none';\n        } else {\n            btn.style.boxShadow = '';\n            btn.style.outline = '';\n        }\n    });\n}\n\nexport function setPaymentMethodHandler(action: any): void {\n    const paymentMethod = action.params?.paymentMethod;\n    if (!paymentMethod) return;\n\n    const isEasyPay = typeof paymentMethod === 'string' && paymentMethod.indexOf('nicepay_') === 0;\n    (window as any).G7Core?.state?.setLocal?.({\n        paymentMethod,\n        serverPaymentMethod: isEasyPay ? 'card' : paymentMethod,\n    });\n\n    if (isEasyPay) {\n        updateEasyPayButtonStyles(paymentMethod);\n    } else {\n        clearEasyPayButtonStyles();\n    }\n}\n\n// 코어 결제 버튼(신용카드 등) 클릭 시에도 간편결제 선택 표시 해제\nexport function initEasyPayWatcher(): void {\n    const templateApp = (window as any).__templateApp;\n    if (typeof templateApp?.onGlobalStateChange !== 'function') return;\n\n    templateApp.onGlobalStateChange((state: any) => {\n        const paymentMethod = state?._local?.paymentMethod;\n        if (typeof paymentMethod !== 'string') return;\n        if (!paymentMethod.startsWith('nicepay_')) {\n            clearEasyPayButtonStyles();\n        }\n    });\n}\n","import { requestPaymentHandler } from './requestPayment';\nimport { setPaymentMethodHandler } from './setPaymentMethod';\n\nexport const handlerMap: Record<string, (...args: unknown[]) => unknown> = {\n    requestPayment: requestPaymentHandler,\n    setPaymentMethod: setPaymentMethodHandler,\n} as const;\n","/**\n * 주문 생성 API 요청/응답 인터셉터\n *\n * G7Core 템플릿 엔진의 apiCall 핸들러는 window.fetch 를 직접 사용하므로\n * window.fetch 를 래핑하는 방식으로 동작한다.\n *\n *   1. POST /api/modules/sirsoft-ecommerce/user/orders 요청을 가로챈다\n *   2. payment_method 가 'nicepay_*' 이면 'card' 로 교체해 서버에 전송\n *      (서버의 PaymentMethodEnum 에 nicepay_* 가 없어서 422 발생 방지)\n *   3. 응답에서 pg_provider === 'sirsoft-nicepayments' 이면 requestPayment 핸들러를 직접 호출\n *   4. 원래 nicepay 방식(paymentMethod)을 requestPayment 에 전달해 올바른 결제창 호출\n *   5. requires_pg_payment → false, redirect_url → 현재 URL 로 교체\n *      → 템플릿 조건 분기가 !requires_pg_payment 쪽으로 떨어져 navigate-to-self 가 됨\n */\n\nimport { requestPaymentHandler } from './handlers/requestPayment';\n\nconst ORDER_CREATE_PATH = '/user/orders';\nconst TARGET_PG_PROVIDER = 'sirsoft-nicepayments';\nconst PLUGIN_IDENTIFIER = 'sirsoft-pay_nicepayments';\nconst FETCH_FLAG = '__sirsoftNicepayFetchInterceptorInstalled';\nconst CHECKOUT_ENDPOINT_PATH = '/api/modules/sirsoft-ecommerce/checkout';\nconst PAYMENT_IN_PROGRESS_FLAG = '__sirsoftNicepayPaymentInProgress';\nconst CHECKOUT_CACHE_KEY = '__sirsoftNicepayCheckoutCache';\n\nconst logger = {\n    info: (...args: unknown[]) => console.info(`[${PLUGIN_IDENTIFIER}]`, ...args),\n    warn: (...args: unknown[]) => console.warn(`[${PLUGIN_IDENTIFIER}]`, ...args),\n    error: (...args: unknown[]) => console.error(`[${PLUGIN_IDENTIFIER}]`, ...args),\n};\n\nfunction buildNoOpRedirectUrl(): string {\n    return window.location.pathname + window.location.search + window.location.hash;\n}\n\nfunction isTargetOrderEndpoint(url: string, method: string): boolean {\n    if (method.toUpperCase() !== 'POST') return false;\n    const path = (url ?? '').split('?')[0].split('#')[0];\n    return path === ORDER_CREATE_PATH || path.endsWith(ORDER_CREATE_PATH);\n}\n\nfunction isCheckoutEndpoint(url: string, method: string): boolean {\n    if (method.toUpperCase() !== 'GET') return false;\n    const path = (url ?? '').split('?')[0].split('#')[0];\n    return path === CHECKOUT_ENDPOINT_PATH || path.endsWith(CHECKOUT_ENDPOINT_PATH);\n}\n\nfunction extractPaymentMethodFromBody(body: unknown): string | undefined {\n    if (!body) return undefined;\n    let obj: Record<string, unknown> | null = null;\n    if (typeof body === 'string') {\n        try { obj = JSON.parse(body) as Record<string, unknown>; } catch { return undefined; }\n    } else if (typeof body === 'object') {\n        obj = body as Record<string, unknown>;\n    }\n    if (!obj) return undefined;\n    const v = obj['payment_method'];\n    return typeof v === 'string' && v.length > 0 ? v : undefined;\n}\n\nfunction replacePaymentMethodInBody(body: string, newMethod: string): string {\n    try {\n        const parsed = JSON.parse(body) as Record<string, unknown>;\n        if ('payment_method' in parsed) {\n            return JSON.stringify({ ...parsed, payment_method: newMethod });\n        }\n    } catch { /* fall through */ }\n    return body;\n}\n\nfunction resolveOrderPaymentAmount(orderData: Record<string, unknown>): number {\n    const candidates = [orderData.total_due_amount, orderData.total_amount];\n    for (const candidate of candidates) {\n        const amount = Number(candidate ?? 0);\n        if (Number.isFinite(amount) && amount > 0) {\n            return Math.floor(amount);\n        }\n    }\n\n    return 0;\n}\n\nexport function installOrderResponseInterceptor(): void {\n    const w = window as unknown as Record<string, unknown>;\n    if (w[FETCH_FLAG]) return;\n    w[FETCH_FLAG] = true;\n\n    // 최초 설치 플러그인이 원본 브라우저 fetch를 보존 (다른 PG 인터셉터가 쌓이기 전)\n    // easy pay 요청 시 이 fetch를 사용해 다른 PG 인터셉터(NHN KCP 등)의 간섭을 차단한다\n    const ORIGINAL_FETCH_KEY = '__sirsoftPgOriginalFetch';\n    if (!w[ORIGINAL_FETCH_KEY]) {\n        w[ORIGINAL_FETCH_KEY] = window.fetch.bind(window);\n    }\n    const browserFetch = w[ORIGINAL_FETCH_KEY] as typeof fetch;\n\n    const originalFetch = window.fetch.bind(window);\n\n    window.fetch = async (input: RequestInfo | URL, init?: RequestInit): Promise<Response> => {\n        const url =\n            typeof input === 'string'\n                ? input\n                : input instanceof URL\n                    ? input.href\n                    : (input as Request).url;\n        const method = init?.method ?? (input instanceof Request ? input.method : 'GET');\n\n        // GET checkout 캐싱 — 결제 진행 중 페이지 재초기화 시 \"주문서 없음\" 다이얼로그 억제\n        if (isCheckoutEndpoint(url, method)) {\n            if (w[PAYMENT_IN_PROGRESS_FLAG] && w[CHECKOUT_CACHE_KEY]) {\n                logger.info('payment in progress — serving cached checkout response');\n                return new Response(w[CHECKOUT_CACHE_KEY] as string, {\n                    status: 200,\n                    headers: { 'Content-Type': 'application/json' },\n                });\n            }\n            const checkoutResp = await originalFetch(input, init);\n            if (checkoutResp.ok) {\n                const text = await checkoutResp.text();\n                w[CHECKOUT_CACHE_KEY] = text;\n                return new Response(text, {\n                    status: checkoutResp.status,\n                    statusText: checkoutResp.statusText,\n                    headers: checkoutResp.headers,\n                });\n            }\n            return checkoutResp;\n        }\n\n        if (!isTargetOrderEndpoint(url, method)) {\n            return originalFetch(input, init);\n        }\n\n        // 요청 body에서 payment_method 추출. nicepay_* (간편결제) 만 'card' 로 교체.\n        // 일반 결제수단(card / vbank / bank / phone)도 그대로 보존해 requestPaymentHandler\n        // 호출 시 정확한 결제수단으로 결제창을 연다 (이전엔 nicepay_* 만 추적해서\n        // 가상계좌/계좌이체/휴대폰 선택 시 'card' 로 폴백되는 회귀가 있었음).\n        let originalPaymentMethod: string | undefined;\n        let isEasyPay = false;\n        let modifiedInit = init;\n\n        if (init?.body && typeof init.body === 'string') {\n            const pm = extractPaymentMethodFromBody(init.body);\n            if (typeof pm === 'string' && pm.length > 0) {\n                originalPaymentMethod = pm;\n                if (pm.startsWith('nicepay_')) {\n                    isEasyPay = true;\n                    modifiedInit = { ...init, body: replacePaymentMethodInBody(init.body, 'card') };\n                    logger.info(`easy pay detected: replacing payment_method '${pm}' → 'card'`);\n                }\n            }\n        }\n\n        // easy pay일 때는 browserFetch(원본)를 사용해 NHN KCP 등 다른 PG 인터셉터를 우회한다.\n        // \"타 PG와 사용가능함\"이 ON이고 기본 PG가 NHN KCP일 때 NHN KCP 결제창이 먼저 열리는 것을 방지.\n        const fetchFn = isEasyPay ? browserFetch : originalFetch;\n        const response = await fetchFn(input, modifiedInit);\n\n        // 2xx 응답만 처리 (4xx/5xx 오류 응답은 그대로 통과)\n        if (!response.ok) {\n            return response;\n        }\n\n        // 응답 파싱 (clone으로 원본 스트림 보호)\n        // 서버 응답 구조: { success, message, data: { order, requires_pg_payment, pg_provider, pg_payment_data, redirect_url } }\n        let envelope: Record<string, unknown> | null = null;\n        try {\n            envelope = (await response.clone().json()) as Record<string, unknown>;\n        } catch {\n            return response;\n        }\n\n        const responseData = (envelope?.data ?? envelope) as Record<string, unknown> | null;\n\n        // 일반 결제: PG 결제가 필요 없으면 통과\n        // 간편결제(nicepay_*): requires_pg_payment=false여도 계속 처리\n        //   → 기본 PG가 미설정이면 백엔드가 requires_pg_payment:false를 반환하지만\n        //     간편결제는 나이스페이먼츠 결제창을 열어야 하므로 통과시킴 (취약점 방어)\n        if (!responseData?.requires_pg_payment && !isEasyPay) {\n            return response;\n        }\n\n        // easy pay: pg_provider 무관하게 나이스페이 처리\n        // 일반 결제: pg_provider가 나이스페이인 경우에만 처리 (나이스페이가 기본 PG일 때)\n        const isNicepayPg = responseData.pg_provider === TARGET_PG_PROVIDER;\n\n        if (!isEasyPay && !isNicepayPg) {\n            return response;\n        }\n\n        // pg_payment_data: 백엔드 응답에 포함되거나,\n        // 간편결제 + 기본 PG 미설정 시 order 데이터에서 직접 구성\n        let pgPaymentData = responseData.pg_payment_data as Record<string, unknown> | undefined;\n        if (!pgPaymentData && isEasyPay) {\n            const orderData = responseData.order as Record<string, unknown> | undefined;\n            if (orderData) {\n                const options = orderData.options as Array<Record<string, unknown>> | undefined;\n                const firstName = (options?.[0]?.product_name as string | undefined) ?? String(orderData.order_number ?? '');\n                const orderName = (options?.length ?? 0) > 1\n                    ? `${firstName} 외 ${(options?.length ?? 0) - 1}건`\n                    : firstName;\n                pgPaymentData = {\n                    order_number: orderData.order_number,\n                    order_name: orderName,\n                    // PG 청구액 SSoT는 total_due_amount. 구형 응답 호환만 total_amount로 fallback.\n                    amount: resolveOrderPaymentAmount(orderData),\n                    currency: 'KRW',\n                    customer_name: orderData.orderer_name ?? null,\n                    customer_email: orderData.orderer_email ?? null,\n                    customer_phone: String(orderData.orderer_phone ?? '').replace(/[^0-9]/g, ''),\n                    customer_key: orderData.user_id ?? null,\n                };\n                logger.info('pg_payment_data constructed from order (기본 PG 미설정)', {\n                    order_number: pgPaymentData.order_number,\n                    amount: pgPaymentData.amount,\n                });\n            }\n        }\n\n        if (!pgPaymentData) {\n            logger.warn('nicepayments order detected but pg_payment_data missing');\n            return response;\n        }\n\n        const paymentMethod = originalPaymentMethod ?? 'card';\n\n        logger.info('intercepted order create response — opening PG popup', { paymentMethod });\n\n        void requestPaymentHandler({\n            // eslint-disable-next-line @typescript-eslint/no-explicit-any\n            params: { pgPaymentData: pgPaymentData as any, paymentMethod },\n        });\n\n        // 결제 진행 중 플래그 설정 — GET checkout 캐시 서빙으로 \"주문서 없음\" 다이얼로그 억제\n        w[PAYMENT_IN_PROGRESS_FLAG] = true;\n\n        // 결제창(팝업)이 열려 있는 동안 checkout 페이지에 머물도록\n        // redirect_url을 항상 현재 URL(navigate-to-self)로 교체한다.\n        // → 템플릿 fallback navigate가 무력화되어 \"결제 완료\" 페이지로 이동하지 않음\n        // → 실제 결제 완료 후 requestPaymentHandler 콜백이 complete 페이지로 이동시킴\n        // navigate-to-self로 checkout 재초기화 시 GET checkout 404 → \"주문서 없음\" 다이얼로그가\n        //   뜰 수 있으나, PAYMENT_IN_PROGRESS_FLAG + 캐시 서빙으로 억제된다.\n\n        // envelope.data 안에 있는 경우와 최상위에 있는 경우 모두 처리\n        const modifiedData = { ...responseData, requires_pg_payment: false, redirect_url: buildNoOpRedirectUrl() };\n        const modifiedBody = envelope?.data\n            ? { ...envelope, data: modifiedData }\n            : modifiedData;\n\n        return new Response(JSON.stringify(modifiedBody), {\n            status: response.status,\n            statusText: response.statusText,\n            headers: response.headers,\n        });\n    };\n\n    logger.info('fetch order interceptor installed');\n\n    // Axios 인터셉터 설치 — GET checkout 캐싱 및 결제 중 캐시 서빙\n    // G7Core.api.client(Axios)가 초기화된 후 설치해야 하므로 비동기로 재시도\n    tryInstallAxiosCheckoutInterceptor(w, 15);\n}\n\nconst AXIOS_CHECKOUT_FLAG = '__sirsoftNicepayAxiosCheckoutInterceptorInstalled';\n\nfunction tryInstallAxiosCheckoutInterceptor(w: Record<string, unknown>, retries: number): void {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const axiosClient = ((window as any)?.G7Core?.api?.client) as any;\n    if (!axiosClient?.interceptors) {\n        if (retries > 0) {\n            setTimeout(() => tryInstallAxiosCheckoutInterceptor(w, retries - 1), 300);\n        }\n        return;\n    }\n\n    if (w[AXIOS_CHECKOUT_FLAG]) return;\n    w[AXIOS_CHECKOUT_FLAG] = true;\n\n    // 응답 인터셉터: GET checkout 성공 시 캐시 저장\n    // Axios config.url은 baseURL을 포함하지 않으므로 (config.baseURL ?? '') + config.url 로 완성\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    axiosClient.interceptors.response.use((response: any) => {\n        const method = (response?.config?.method ?? '').toLowerCase();\n        const url = String((response?.config?.baseURL ?? '') + (response?.config?.url ?? ''));\n        if (method === 'get' && isCheckoutEndpoint(url, 'GET') && response?.status === 200) {\n            w[CHECKOUT_CACHE_KEY] = JSON.stringify(response.data);\n            logger.info('checkout response cached (axios)');\n        }\n        return response;\n    });\n\n    // 요청 인터셉터: 결제 진행 중 GET checkout을 캐시에서 반환\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    axiosClient.interceptors.request.use((config: any) => {\n        const method = (config?.method ?? '').toLowerCase();\n        const url = String((config?.baseURL ?? '') + (config?.url ?? ''));\n        if (method === 'get' && isCheckoutEndpoint(url, 'GET') && w[PAYMENT_IN_PROGRESS_FLAG] && w[CHECKOUT_CACHE_KEY]) {\n            logger.info('payment in progress — serving cached checkout response (axios)');\n            // adapter를 Promise.resolve로 교체해 실제 요청 없이 캐시 반환\n            config.adapter = () => Promise.resolve({\n                data: JSON.parse(w[CHECKOUT_CACHE_KEY] as string),\n                status: 200,\n                statusText: 'OK (cached)',\n                headers: { 'content-type': 'application/json' },\n                config,\n                request: {},\n            });\n        }\n        return config;\n    });\n\n    logger.info('axios checkout interceptor installed');\n\n    // 인터셉터 설치 직후 GET checkout 즉시 캐싱 — navigate-to-self 재초기화 대비\n    if (!w[CHECKOUT_CACHE_KEY]) {\n        void (async () => {\n            try {\n                // eslint-disable-next-line @typescript-eslint/no-explicit-any\n                const coreApi = ((window as any)?.G7Core?.api) as { get?: (url: string) => Promise<unknown> } | undefined;\n                await coreApi?.get?.('/modules/sirsoft-ecommerce/checkout');\n                // 응답은 Axios 응답 인터셉터가 자동으로 캐싱함\n            } catch { /* 체크아웃 세션 없으면 실패 — 무시 */ }\n        })();\n    }\n}\n\n/** @deprecated Axios 인터셉터 방식 — apiCall 핸들러가 window.fetch 를 사용하므로 동작하지 않음. installOrderResponseInterceptor 를 사용할 것. */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function installAxiosOrderInterceptor(_axiosClient: any): void {\n    // no-op\n}\n","const PLUGIN_ID = 'sirsoft-pay_nicepayments';\nconst FLAG = '__nicepayCheckoutEasyPayInjectorInstalled';\nconst CHECKOUT_RE = /^\\/shop\\/checkout\\/?$/;\nconst LISTENER_FLAG = '__nicepayCheckoutEasyPaySyncListenerAttached';\nconst SYNC_RETRY_INTERVAL_MS = 200;\nconst SYNC_RETRY_ATTEMPTS = 120;\nconst LEGACY_CONTAINER_ID = 'nicepay_checkout_payment_section';\n\ninterface EasyPayCopy {\n    heading: string;\n    description: string;\n    title: string;\n}\n\ninterface EasyPayDefinition {\n    id: string;\n    labels: string[];\n    ko: EasyPayCopy;\n    en: EasyPayCopy;\n    markText: string;\n    markClassName: string;\n}\n\nconst EASY_PAY_DEFINITIONS: EasyPayDefinition[] = [\n    {\n        id: 'nicepay_naverpay',\n        labels: [\n            '네이버페이 (나이스페이먼츠)',\n            '네이버페이로 결제 (나이스페이먼츠)',\n            'Naver Pay (NicePayments)',\n            'Pay with Naver Pay (NicePayments)',\n        ],\n        ko: {\n            heading: '네이버페이 (나이스페이먼츠)',\n            description: '네이버페이로 결제 (나이스페이먼츠)',\n            title: '네이버페이로 결제 (나이스페이먼츠)',\n        },\n        en: {\n            heading: 'Naver Pay (NicePayments)',\n            description: 'Pay with Naver Pay (NicePayments)',\n            title: 'Pay with Naver Pay (NicePayments)',\n        },\n        markText: 'N',\n        markClassName: 'bg-green-500 text-white',\n    },\n    {\n        id: 'nicepay_kakaopay',\n        labels: [\n            '카카오페이 (나이스페이먼츠)',\n            '카카오페이로 결제 (나이스페이먼츠)',\n            'Kakao Pay (NicePayments)',\n            'Pay with Kakao Pay (NicePayments)',\n        ],\n        ko: {\n            heading: '카카오페이 (나이스페이먼츠)',\n            description: '카카오페이로 결제 (나이스페이먼츠)',\n            title: '카카오페이로 결제 (나이스페이먼츠)',\n        },\n        en: {\n            heading: 'Kakao Pay (NicePayments)',\n            description: 'Pay with Kakao Pay (NicePayments)',\n            title: 'Pay with Kakao Pay (NicePayments)',\n        },\n        markText: 'K',\n        markClassName: 'bg-yellow-400 text-gray-950',\n    },\n    {\n        id: 'nicepay_samsungpay',\n        labels: [\n            '삼성페이 (나이스페이먼츠)',\n            '삼성페이로 결제 (나이스페이먼츠)',\n            'Samsung Pay (NicePayments)',\n            'Pay with Samsung Pay (NicePayments)',\n        ],\n        ko: {\n            heading: '삼성페이 (나이스페이먼츠)',\n            description: '삼성페이로 결제 (나이스페이먼츠)',\n            title: '삼성페이로 결제 (나이스페이먼츠)',\n        },\n        en: {\n            heading: 'Samsung Pay (NicePayments)',\n            description: 'Pay with Samsung Pay (NicePayments)',\n            title: 'Pay with Samsung Pay (NicePayments)',\n        },\n        markText: 'S',\n        markClassName: 'bg-blue-600 text-white',\n    },\n    {\n        id: 'nicepay_applepay',\n        labels: [\n            '애플페이 (나이스페이먼츠)',\n            '애플페이로 결제 (나이스페이먼츠)',\n            'Apple Pay (NicePayments)',\n            'Pay with Apple Pay (NicePayments)',\n        ],\n        ko: {\n            heading: '애플페이 (나이스페이먼츠)',\n            description: '애플페이로 결제 (나이스페이먼츠)',\n            title: '애플페이로 결제 (나이스페이먼츠)',\n        },\n        en: {\n            heading: 'Apple Pay (NicePayments)',\n            description: 'Pay with Apple Pay (NicePayments)',\n            title: 'Pay with Apple Pay (NicePayments)',\n        },\n        markText: 'A',\n        markClassName: 'bg-gray-900 text-white',\n    },\n    {\n        id: 'nicepay_payco',\n        labels: [\n            'PAYCO (나이스페이먼츠)',\n            'PAYCO로 결제 (나이스페이먼츠)',\n            'PAYCO (NicePayments)',\n            'Pay with PAYCO (NicePayments)',\n        ],\n        ko: {\n            heading: 'PAYCO (나이스페이먼츠)',\n            description: 'PAYCO로 결제 (나이스페이먼츠)',\n            title: 'PAYCO로 결제 (나이스페이먼츠)',\n        },\n        en: {\n            heading: 'PAYCO (NicePayments)',\n            description: 'Pay with PAYCO (NicePayments)',\n            title: 'Pay with PAYCO (NicePayments)',\n        },\n        markText: 'P',\n        markClassName: 'bg-red-500 text-white',\n    },\n    {\n        id: 'nicepay_skpay',\n        labels: [\n            '11pay (나이스페이먼츠)',\n            '11pay로 결제 (나이스페이먼츠)',\n            '11pay (NicePayments)',\n            'Pay with 11pay (NicePayments)',\n        ],\n        ko: {\n            heading: '11pay (나이스페이먼츠)',\n            description: '11pay로 결제 (나이스페이먼츠)',\n            title: '11pay로 결제 (나이스페이먼츠)',\n        },\n        en: {\n            heading: '11pay (NicePayments)',\n            description: 'Pay with 11pay (NicePayments)',\n            title: 'Pay with 11pay (NicePayments)',\n        },\n        markText: '11',\n        markClassName: 'bg-orange-500 text-white',\n    },\n    {\n        id: 'nicepay_ssgpay',\n        labels: [\n            'SSG페이 (나이스페이먼츠)',\n            'SSG페이로 결제 (나이스페이먼츠)',\n            'SSG Pay (NicePayments)',\n            'Pay with SSG Pay (NicePayments)',\n        ],\n        ko: {\n            heading: 'SSG페이 (나이스페이먼츠)',\n            description: 'SSG페이로 결제 (나이스페이먼츠)',\n            title: 'SSG페이로 결제 (나이스페이먼츠)',\n        },\n        en: {\n            heading: 'SSG Pay (NicePayments)',\n            description: 'Pay with SSG Pay (NicePayments)',\n            title: 'Pay with SSG Pay (NicePayments)',\n        },\n        markText: 'SSG',\n        markClassName: 'bg-red-700 text-white',\n    },\n    {\n        id: 'nicepay_lpay',\n        labels: [\n            'L.pay (나이스페이먼츠)',\n            'L.pay로 결제 (나이스페이먼츠)',\n            'L.pay (NicePayments)',\n            'Pay with L.pay (NicePayments)',\n        ],\n        ko: {\n            heading: 'L.pay (나이스페이먼츠)',\n            description: 'L.pay로 결제 (나이스페이먼츠)',\n            title: 'L.pay로 결제 (나이스페이먼츠)',\n        },\n        en: {\n            heading: 'L.pay (NicePayments)',\n            description: 'Pay with L.pay (NicePayments)',\n            title: 'Pay with L.pay (NicePayments)',\n        },\n        markText: 'L',\n        markClassName: 'bg-purple-600 text-white',\n    },\n];\n\nlet observer: MutationObserver | null = null;\nlet retryTimer: number | null = null;\nlet syncQueued = false;\n\nfunction windowRecord(): Record<string, unknown> {\n    return window as unknown as Record<string, unknown>;\n}\n\nfunction isCheckoutPage(): boolean {\n    return CHECKOUT_RE.test(window.location.pathname);\n}\n\nfunction normalizedText(value: string | null | undefined): string {\n    return (value ?? '').replace(/\\s+/g, ' ').trim();\n}\n\nfunction comparableText(value: string | null | undefined): string {\n    return normalizedText(value).replace(/\\u200B/g, '');\n}\n\nfunction isKoreanPage(): boolean {\n    const lang = document.documentElement.lang || navigator.language || '';\n\n    return lang.toLowerCase().startsWith('ko');\n}\n\nfunction copyFor(definition: EasyPayDefinition): EasyPayCopy {\n    return isKoreanPage() ? definition.ko : definition.en;\n}\n\nfunction displayText(value: string): string {\n    return value\n        .replaceAll('네이버페이', '네이\\u200B버페이')\n        .replaceAll('카카오페이', '카카\\u200B오페이')\n        .replaceAll('삼성페이', '삼성\\u200B페이')\n        .replaceAll('Naver Pay', 'Naver\\u200B Pay')\n        .replaceAll('Kakao Pay', 'Kakao\\u200B Pay')\n        .replaceAll('Samsung Pay', 'Samsung\\u200B Pay')\n        .replaceAll('L.pay', 'L.\\u200Bpay');\n}\n\nfunction findDefinitionById(id: string | undefined): EasyPayDefinition | null {\n    return EASY_PAY_DEFINITIONS.find((definition) => definition.id === id) ?? null;\n}\n\nfunction findDefinitionForButton(button: HTMLButtonElement): EasyPayDefinition | null {\n    const markedDefinition = findDefinitionById(button.dataset.nicepayEasyPayMethod);\n    if (markedDefinition) return markedDefinition;\n\n    const text = comparableText(button.textContent);\n\n    return EASY_PAY_DEFINITIONS.find((definition) => (\n        definition.labels.some((label) => text.includes(label))\n    )) ?? null;\n}\n\nfunction findPaymentRow(button: HTMLButtonElement): HTMLElement | null {\n    return button.querySelector<HTMLElement>('.flex.items-center.gap-2, .flex.items-center.gap-3')\n        ?? button.querySelector<HTMLElement>('.flex.items-center');\n}\n\nfunction alignPaymentTextLeft(button: HTMLButtonElement, heading?: HTMLElement, description?: HTMLElement): void {\n    button.style.textAlign = 'left';\n\n    const row = findPaymentRow(button);\n    if (row) {\n        row.style.justifyContent = 'flex-start';\n        row.style.textAlign = 'left';\n        row.style.width = '100%';\n    }\n\n    const textContainer = heading?.parentElement ?? description?.parentElement;\n    if (textContainer instanceof HTMLElement) {\n        textContainer.style.textAlign = 'left';\n        textContainer.style.minWidth = '0';\n    }\n}\n\nfunction createMark(definition: EasyPayDefinition): HTMLSpanElement {\n    const mark = document.createElement('span');\n    mark.dataset.nicepayEasyPayMark = 'true';\n    mark.dataset.nicepayEasyPayMethod = definition.id;\n    mark.setAttribute('aria-hidden', 'true');\n    mark.className = `inline-flex items-center justify-center rounded-lg text-xs font-bold ${definition.markClassName}`;\n    mark.style.width = '32px';\n    mark.style.height = '32px';\n    mark.style.flex = '0 0 32px';\n    mark.textContent = definition.markText;\n\n    return mark;\n}\n\nfunction removeOtherPgArtifacts(button: HTMLButtonElement): void {\n    delete button.dataset.kginicisBrandPaymentButton;\n    delete button.dataset.kginicisBrandPaymentMethod;\n    delete button.dataset.kginicisNaverpayBrandButton;\n    delete button.dataset.nhnkcpEasyPayMethod;\n    delete button.dataset.nhnkcpEasyPayVisible;\n    delete button.dataset.nhnkcpEasyPayHidden;\n\n    button.querySelectorAll<HTMLElement>('[data-kginicis-brand-payment-mark=\"true\"], [data-kginicis-naverpay-mark=\"true\"], [data-nhnkcp-easy-pay-mark=\"true\"]').forEach((element) => {\n        element.remove();\n    });\n}\n\nfunction findPaymentIcon(button: HTMLButtonElement): Element | null {\n    return button.querySelector('[data-nicepay-easy-pay-mark=\"true\"]')\n        ?? button.querySelector('[data-kginicis-brand-payment-mark=\"true\"], [data-kginicis-naverpay-mark=\"true\"], [data-nhnkcp-easy-pay-mark=\"true\"]')\n        ?? button.querySelector('svg')\n        ?? button.querySelector('i[class*=\"fa-\"], i[role=\"img\"], i');\n}\n\nfunction ensureMark(button: HTMLButtonElement, definition: EasyPayDefinition): void {\n    const existingMark = button.querySelector<HTMLElement>('[data-nicepay-easy-pay-mark=\"true\"]');\n    if (existingMark) {\n        existingMark.dataset.nicepayEasyPayMethod = definition.id;\n        existingMark.className = `inline-flex items-center justify-center rounded-lg text-xs font-bold ${definition.markClassName}`;\n        existingMark.textContent = definition.markText;\n        return;\n    }\n\n    const mark = createMark(definition);\n    const icon = findPaymentIcon(button);\n    if (icon && icon.parentElement) {\n        icon.replaceWith(mark);\n        return;\n    }\n\n    const row = findPaymentRow(button);\n    row?.prepend(mark);\n}\n\nfunction updatePaymentText(button: HTMLButtonElement, definition: EasyPayDefinition): void {\n    const paragraphs = Array.from(button.querySelectorAll<HTMLParagraphElement>('p'));\n    const copy = copyFor(definition);\n    const headingText = displayText(copy.heading);\n    const descriptionText = displayText(copy.description);\n\n    const heading = paragraphs[0];\n    const description = paragraphs[1];\n\n    if (heading && heading.textContent !== headingText) {\n        heading.textContent = headingText;\n    }\n    if (heading) {\n        heading.setAttribute('aria-label', copy.heading);\n        heading.style.textAlign = 'left';\n        heading.style.whiteSpace = 'normal';\n        heading.style.wordBreak = 'keep-all';\n        heading.style.overflowWrap = 'anywhere';\n    }\n\n    if (description && description.textContent !== descriptionText) {\n        description.textContent = descriptionText;\n    }\n    if (description) {\n        description.style.textAlign = 'left';\n        description.style.fontSize = '12px';\n        description.style.lineHeight = '1rem';\n        description.style.whiteSpace = 'normal';\n        description.style.wordBreak = 'keep-all';\n        description.style.overflowWrap = 'anywhere';\n    }\n\n    alignPaymentTextLeft(button, heading, description);\n    button.title = copy.title;\n}\n\nfunction showButton(button: HTMLButtonElement, definition: EasyPayDefinition): void {\n    if (button.hidden) button.hidden = false;\n    if (button.disabled) button.disabled = false;\n    if (button.style.display === 'none') button.style.removeProperty('display');\n    button.removeAttribute('aria-hidden');\n    button.dataset.nicepayEasyPayMethod = definition.id;\n    button.dataset.nicepayEasyPayVisible = 'true';\n\n    removeOtherPgArtifacts(button);\n    ensureMark(button, definition);\n    updatePaymentText(button, definition);\n}\n\nfunction removeLegacyInjectedSection(): boolean {\n    const legacySection = document.getElementById(LEGACY_CONTAINER_ID);\n    if (!legacySection) return false;\n\n    legacySection.remove();\n\n    return true;\n}\n\nexport async function syncRenderedCheckoutEasyPayMethods(\n    root: ParentNode = document,\n): Promise<boolean> {\n    if (typeof window === 'undefined' || typeof document === 'undefined') return false;\n    if (!isCheckoutPage()) return false;\n\n    let changed = removeLegacyInjectedSection();\n\n    root.querySelectorAll<HTMLButtonElement>('button').forEach((button) => {\n        const definition = findDefinitionForButton(button);\n        if (!definition) return;\n\n        showButton(button, definition);\n        changed = true;\n    });\n\n    return changed;\n}\n\nfunction queueSync(): void {\n    if (syncQueued) return;\n    syncQueued = true;\n\n    window.setTimeout(() => {\n        syncQueued = false;\n        void syncRenderedCheckoutEasyPayMethods();\n    }, 0);\n}\n\nfunction stopRetries(): void {\n    if (retryTimer === null) return;\n\n    window.clearInterval(retryTimer);\n    retryTimer = null;\n}\n\nfunction startSync(): void {\n    if (!isCheckoutPage()) return;\n\n    stopRetries();\n    void syncRenderedCheckoutEasyPayMethods();\n\n    let attempts = 0;\n    retryTimer = window.setInterval(() => {\n        attempts += 1;\n        void syncRenderedCheckoutEasyPayMethods();\n\n        if (attempts >= SYNC_RETRY_ATTEMPTS) {\n            stopRetries();\n        }\n    }, SYNC_RETRY_INTERVAL_MS);\n\n    const body = document.body as HTMLElement & Record<string, unknown>;\n    if (body[LISTENER_FLAG]) return;\n    body[LISTENER_FLAG] = true;\n\n    observer = new MutationObserver(() => queueSync());\n    observer.observe(document.body, { childList: true, subtree: true, characterData: true });\n}\n\nfunction onRouteChange(): void {\n    if (isCheckoutPage()) startSync();\n}\n\nexport function installCheckoutEasyPayInjector(): void {\n    if (typeof window === 'undefined' || typeof document === 'undefined') return;\n    const w = windowRecord();\n    if (w[FLAG]) return;\n    w[FLAG] = true;\n\n    console.info(`[${PLUGIN_ID}] checkout easy pay method sync installed`);\n\n    if (document.readyState === 'loading') {\n        document.addEventListener('DOMContentLoaded', () => startSync());\n    } else {\n        startSync();\n    }\n\n    const origPush = history.pushState.bind(history);\n    history.pushState = (...args: Parameters<typeof history.pushState>) => {\n        origPush(...args);\n        window.setTimeout(() => onRouteChange(), 200);\n    };\n    window.addEventListener('popstate', () => window.setTimeout(() => onRouteChange(), 200));\n}\n\nexport function resetCheckoutEasyPayInjectorForTests(): void {\n    observer?.disconnect();\n    observer = null;\n    stopRetries();\n    syncQueued = false;\n    delete windowRecord()[FLAG];\n    if (document.body) {\n        delete ((document.body as HTMLElement & Record<string, unknown>)[LISTENER_FLAG]);\n    }\n}\n","const PLUGIN_ID = 'sirsoft-pay_nicepayments';\nconst FLAG = '__nicepayOcReceiptInjectorInstalled';\nconst BTN_ID = 'nicepay-oc-receipt-btn';\n\nconst ORDER_COMPLETE_RE = /^\\/shop\\/orders\\/([^/]+)\\/complete$/;\n\ntype Payment = {\n    pg_provider: string;\n    transaction_id: string | null;\n    paid_at: string | null;\n    [key: string]: unknown;\n};\n\ninterface ReceiptInfo {\n    receipt_url?: string | null;\n    payment_method_display_label?: string | null;\n}\n\nfunction getToken(): string | null {\n    return localStorage.getItem('auth_token');\n}\n\nasync function fetchPayment(orderNumber: string): Promise<Payment | null> {\n    const token = getToken();\n    if (!token) return null;\n\n    try {\n        const res = await fetch(`/api/modules/sirsoft-ecommerce/user/orders/${orderNumber}`, {\n            headers: { Authorization: `Bearer ${token}`, Accept: 'application/json' },\n        });\n        if (!res.ok) return null;\n        const data = (await res.json()) as { data?: { payment?: Payment } };\n        return data?.data?.payment ?? null;\n    } catch {\n        return null;\n    }\n}\n\nasync function fetchReceiptInfo(orderNumber: string): Promise<ReceiptInfo | null> {\n    const token = getToken();\n    if (!token) return null;\n\n    try {\n        const res = await fetch(`/api/plugins/${PLUGIN_ID}/user/orders/${orderNumber}/receipt`, {\n            headers: { Authorization: `Bearer ${token}`, Accept: 'application/json' },\n        });\n        if (!res.ok) return null;\n        return (await res.json()) as ReceiptInfo;\n    } catch {\n        return null;\n    }\n}\n\nfunction patchPaymentMethodDisplay(displayLabel: string | null | undefined): boolean {\n    if (!displayLabel) return false;\n\n    const rows = Array.from(document.querySelectorAll<HTMLElement>('div'));\n    for (const row of rows) {\n        const spans = Array.from(row.children).filter(\n            (child): child is HTMLElement => child instanceof HTMLElement && child.tagName === 'SPAN',\n        );\n        if (spans.length < 2) continue;\n\n        const label = spans[0].textContent?.trim();\n        if (label !== '결제 방법' && label !== '결제수단' && label !== '결제 방식') continue;\n\n        const value = spans[spans.length - 1];\n        if (value.textContent?.trim() !== displayLabel) {\n            value.textContent = displayLabel;\n            value.dataset.nicepayPaymentMethodPatched = 'true';\n        }\n        row.dataset.nicepayPaymentMethodRow = 'true';\n        return true;\n    }\n\n    return false;\n}\n\nasync function injectOnOrderComplete(orderNumber: string): Promise<void> {\n    if (document.getElementById(BTN_ID)) return;\n\n    const payment = await fetchPayment(orderNumber);\n    // 입금완료(paid_at 채워짐) 시점에만 영수증 버튼 표시 — 가상계좌 입금대기 차단\n    if (!payment || payment.pg_provider !== 'nicepayments' || !payment.transaction_id || !payment.paid_at) return;\n\n    const blueBtn = Array.from(document.querySelectorAll<HTMLButtonElement>('button[type=\"button\"]'))\n        .find(b => b.className.includes('bg-blue-600'));\n\n    if (!blueBtn?.parentElement) return;\n\n    const receiptInfo = await fetchReceiptInfo(orderNumber);\n    patchPaymentMethodDisplay(receiptInfo?.payment_method_display_label);\n\n    const container = blueBtn.parentElement;\n\n    const receiptBtn = document.createElement('button');\n    receiptBtn.id = BTN_ID;\n    receiptBtn.type = 'button';\n    receiptBtn.className = blueBtn.className\n        .replace(/bg-blue-\\d+/g, 'bg-green-600')\n        .replace(/hover:bg-blue-\\d+/g, 'hover:bg-green-700');\n    receiptBtn.textContent = '영수증 조회';\n\n    receiptBtn.addEventListener('click', async () => {\n        receiptBtn.disabled = true;\n        receiptBtn.textContent = '로딩 중...';\n        const data = await fetchReceiptInfo(orderNumber);\n        receiptBtn.disabled = false;\n        receiptBtn.textContent = '영수증 조회';\n        const url = data?.receipt_url ?? null;\n        if (url) {\n            window.open(url, 'nicepay_receipt', 'width=800,height=600,scrollbars=yes,resizable=yes');\n        }\n    });\n\n    const lastBtn = container.lastElementChild;\n    container.insertBefore(receiptBtn, lastBtn);\n\n    console.info(`[${PLUGIN_ID}] receipt button injected on order complete page`);\n}\n\nfunction tryInject(): void {\n    const match = location.pathname.match(ORDER_COMPLETE_RE);\n    if (match) {\n        void injectOnOrderComplete(match[1]);\n    }\n}\n\nexport function installOrderCompleteReceiptInjector(): void {\n    if (typeof window === 'undefined') return;\n    const w = window as Record<string, unknown>;\n    if (w[FLAG]) return;\n    w[FLAG] = true;\n\n    console.info(`[${PLUGIN_ID}] order complete receipt injector installed`);\n\n    const schedule = (delay = 1200) => setTimeout(tryInject, delay);\n\n    if (document.readyState === 'loading') {\n        document.addEventListener('DOMContentLoaded', () => schedule());\n    } else {\n        schedule();\n    }\n\n    const origPush = history.pushState.bind(history);\n    history.pushState = (...args: Parameters<typeof history.pushState>) => {\n        origPush(...args);\n        schedule();\n    };\n    window.addEventListener('popstate', () => schedule(500));\n}\n","const PLUGIN_ID = 'sirsoft-pay_nicepayments';\nconst FLAG = '__nicepayOrderShowInjectorInstalled';\nconst ROW_ID = 'nicepay-mp-receipt-row';\nconst VBANK_BLOCK_ID = 'nicepay-mp-vbank-info';\n\nconst ORDER_SHOW_RE = /^\\/mypage\\/orders\\/([^/]+)$/;\n\ninterface Payment {\n    pg_provider?: string;\n    payment_method?: string;\n    transaction_id?: string | null;\n    paid_at?: string | null;\n    vbank_name?: string | null;\n    vbank_number?: string | null;\n    vbank_holder?: string | null;\n    vbank_due_at?: string | null;\n    [key: string]: unknown;\n}\n\ninterface OrderData {\n    order_number?: string;\n    total_amount_formatted?: string;\n    payment?: Payment;\n}\n\ninterface ReceiptInfo {\n    receipt_url?: string | null;\n    payment_method_display_label?: string | null;\n}\n\nfunction getOrderFromState(orderNumber: string): OrderData | null {\n    try {\n        const g7 = (window as Record<string, unknown>).G7Core as Record<string, unknown> | undefined;\n        const getState = g7?.getState as (() => Record<string, unknown>) | undefined;\n        const ctx = getState?.()?.currentDataContext as Record<string, unknown> | undefined;\n        const order = ctx?.order as { data?: OrderData } | undefined;\n        const data = order?.data;\n        if (!data || data.order_number !== orderNumber) return null;\n        return data;\n    } catch {\n        return null;\n    }\n}\n\nfunction getToken(): string | null {\n    return localStorage.getItem('auth_token');\n}\n\nasync function fetchReceiptInfo(orderNumber: string): Promise<ReceiptInfo | null> {\n    const token = getToken();\n    if (!token) return null;\n    try {\n        const res = await fetch(`/api/plugins/${PLUGIN_ID}/user/orders/${orderNumber}/receipt`, {\n            headers: { Authorization: `Bearer ${token}`, Accept: 'application/json' },\n        });\n        if (!res.ok) return null;\n        return (await res.json()) as ReceiptInfo;\n    } catch {\n        return null;\n    }\n}\n\nfunction patchPaymentMethodDisplay(container: Element, displayLabel: string | null | undefined): boolean {\n    if (!displayLabel) return false;\n\n    const rows = Array.from(container.querySelectorAll<HTMLElement>('div'));\n    for (const row of rows) {\n        const spans = Array.from(row.children).filter(\n            (child): child is HTMLElement => child instanceof HTMLElement && child.tagName === 'SPAN',\n        );\n        if (spans.length < 2) continue;\n\n        const label = spans[0].textContent?.trim();\n        if (label !== '결제 방법' && label !== '결제수단' && label !== 'Payment Method') continue;\n\n        const value = spans[spans.length - 1];\n        if (value.textContent?.trim() !== displayLabel) {\n            value.textContent = displayLabel;\n            value.dataset.nicepayPaymentMethodPatched = 'true';\n        }\n        row.dataset.nicepayPaymentMethodRow = 'true';\n        return true;\n    }\n\n    return false;\n}\n\nfunction findPaymentContainer(): Element | null {\n    const panel = document.getElementById('order_payment_info_panel');\n    if (panel) {\n        return Array.from(panel.children).find(el => el.className?.includes('space-y')) ?? panel;\n    }\n\n    const h3 = Array.from(document.querySelectorAll<HTMLElement>('h3')).find(\n        el => el.textContent?.includes('결제 정보'),\n    );\n    if (!h3) return null;\n\n    const panelDiv = h3.parentElement?.parentElement;\n    if (!panelDiv) return null;\n\n    return Array.from(panelDiv.children).find(el => el.className?.includes('space-y')) ?? panelDiv;\n}\n\nfunction buildReceiptRow(orderNumber: string): HTMLElement {\n    const row = document.createElement('div');\n    row.id = ROW_ID;\n    row.className = 'flex items-center justify-between';\n\n    const label = document.createElement('span');\n    label.className = 'text-gray-500 dark:text-gray-400 text-sm';\n    label.textContent = '영수증';\n\n    const btn = document.createElement('button');\n    btn.type = 'button';\n    btn.className =\n        'inline-flex items-center gap-1 text-sm text-blue-600 dark:text-blue-400 hover:underline disabled:opacity-50';\n    btn.textContent = '영수증 조회';\n\n    btn.addEventListener('click', async () => {\n        btn.disabled = true;\n        btn.textContent = '로딩 중...';\n        const data = await fetchReceiptInfo(orderNumber);\n        btn.disabled = false;\n        btn.textContent = '영수증 조회';\n        const url = data?.receipt_url ?? null;\n        if (url) {\n            window.open(url, 'nicepay_receipt', 'width=800,height=600,scrollbars=yes,resizable=yes');\n        }\n    });\n\n    row.appendChild(label);\n    row.appendChild(btn);\n    return row;\n}\n\nfunction formatVbankDueAt(raw: string | null | undefined): string {\n    if (!raw) return '';\n    try {\n        const d = new Date(raw);\n        if (Number.isNaN(d.getTime())) return raw;\n        const pad = (n: number) => String(n).padStart(2, '0');\n        return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`;\n    } catch {\n        return raw;\n    }\n}\n\nfunction buildVbankRow(label: string, value: string, valueClass = 'font-medium text-gray-900 dark:text-white'): HTMLElement {\n    const row = document.createElement('div');\n    row.className = 'flex justify-between text-sm';\n    const l = document.createElement('span');\n    l.className = 'text-gray-600 dark:text-gray-400';\n    l.textContent = label;\n    const v = document.createElement('span');\n    v.className = valueClass;\n    v.textContent = value;\n    row.appendChild(l);\n    row.appendChild(v);\n    return row;\n}\n\nfunction buildVbankBlock(orderData: OrderData): HTMLElement {\n    const p = orderData.payment ?? {};\n    const wrap = document.createElement('div');\n    wrap.id = VBANK_BLOCK_ID;\n    wrap.className = 'pt-4 mt-2 border-t border-gray-200 dark:border-gray-700';\n\n    const inner = document.createElement('div');\n    inner.className = 'bg-blue-50 dark:bg-blue-900/30 border border-blue-200 dark:border-blue-700 rounded-lg p-4';\n\n    const title = document.createElement('h3');\n    title.className = 'text-sm font-semibold text-blue-800 dark:text-blue-300 mb-3';\n    title.textContent = '가상계좌 입금 안내';\n\n    const rows = document.createElement('div');\n    rows.className = 'space-y-2';\n    rows.appendChild(buildVbankRow('은행', p.vbank_name ?? ''));\n    rows.appendChild(buildVbankRow('계좌번호', p.vbank_number ?? '', 'font-medium font-mono text-gray-900 dark:text-white'));\n    rows.appendChild(buildVbankRow('예금주', p.vbank_holder ?? ''));\n    rows.appendChild(buildVbankRow('입금 금액', orderData.total_amount_formatted ?? '', 'font-bold text-blue-600 dark:text-blue-400'));\n\n    const dueRaw = p.vbank_due_at;\n    if (dueRaw) {\n        const dueRow = document.createElement('div');\n        dueRow.className = 'flex justify-between text-sm pt-2 border-t border-blue-200 dark:border-blue-700 mt-2';\n        const dueLabel = document.createElement('span');\n        dueLabel.className = 'text-gray-600 dark:text-gray-400';\n        dueLabel.textContent = '입금 기한';\n        const dueValue = document.createElement('span');\n        dueValue.className = 'font-medium text-red-600 dark:text-red-400';\n        dueValue.textContent = formatVbankDueAt(dueRaw);\n        dueRow.appendChild(dueLabel);\n        dueRow.appendChild(dueValue);\n        rows.appendChild(dueRow);\n    }\n\n    inner.appendChild(title);\n    inner.appendChild(rows);\n\n    if (!p.paid_at) {\n        const notice = document.createElement('p');\n        notice.className = 'text-xs text-blue-700 dark:text-blue-300 mt-3';\n        notice.textContent = '입금 기한 내에 입금이 완료되지 않으면 주문이 자동 취소됩니다.';\n        inner.appendChild(notice);\n    }\n\n    wrap.appendChild(inner);\n    return wrap;\n}\n\nasync function tryInject(orderNumber: string): Promise<boolean> {\n    const orderData = getOrderFromState(orderNumber);\n    if (!orderData) return false;\n\n    const { payment } = orderData;\n    if (!payment || payment.pg_provider !== 'nicepayments') return true;\n\n    const container = findPaymentContainer();\n    if (!container) return false;\n    const receiptInfo = await fetchReceiptInfo(orderNumber);\n    patchPaymentMethodDisplay(container, receiptInfo?.payment_method_display_label);\n\n    // 가상계좌 입금 안내 — 결제수단이 vbank 이고 가상계좌 번호 발급된 경우 표시 (paid_at 무관: 입금 전후 모두 표시).\n    if (payment.payment_method === 'vbank' && payment.vbank_number && !document.getElementById(VBANK_BLOCK_ID)) {\n        container.appendChild(buildVbankBlock(orderData));\n        console.info(`[${PLUGIN_ID}] vbank info injected on mypage order show`);\n    }\n\n    if (!payment.transaction_id) return true;\n    // 영수증 버튼은 결제완료(paid_at 채워짐) 시점에만 표시 — 가상계좌 입금대기 차단\n    if (!payment.paid_at) return true;\n\n    if (document.getElementById(ROW_ID)) return true;\n\n    container.appendChild(buildReceiptRow(orderNumber));\n    console.info(`[${PLUGIN_ID}] receipt button injected on mypage order show`);\n    return true;\n}\n\nfunction startPolling(orderNumber: string): void {\n    let attempts = 0;\n    const id = setInterval(() => {\n        attempts++;\n        void tryInject(orderNumber).then(done => {\n            if (done || attempts >= 30) clearInterval(id);\n        });\n    }, 400);\n}\n\nfunction onRouteChange(): void {\n    const match = location.pathname.match(ORDER_SHOW_RE);\n    if (match) startPolling(match[1]);\n}\n\nexport function installMypageOrderShowInjector(): void {\n    if (typeof window === 'undefined') return;\n    const w = window as unknown as Record<string, unknown>;\n    if (w[FLAG]) return;\n    w[FLAG] = true;\n\n    console.info(`[${PLUGIN_ID}] mypage order show injector installed`);\n\n    const schedule = (delay = 1500) => setTimeout(onRouteChange, delay);\n\n    if (document.readyState === 'loading') {\n        document.addEventListener('DOMContentLoaded', () => schedule());\n    } else {\n        schedule();\n    }\n\n    const origPush = history.pushState.bind(history);\n    history.pushState = (...args: Parameters<typeof history.pushState>) => {\n        origPush(...args);\n        schedule(600);\n    };\n    window.addEventListener('popstate', () => schedule(500));\n}\n","const PLUGIN_ID = 'sirsoft-pay_nicepayments';\nconst FLAG = '__nicepayAdminPaymentMethodBrandInjectorInstalled';\nconst LISTENER_FLAG = '__nicepayAdminPaymentMethodBrandSyncListenerAttached';\nconst ADMIN_SETTINGS_RE = /^\\/admin\\/ecommerce\\/settings\\/?$/;\nconst MARK_SELECTOR = '[data-nicepay-admin-payment-brand-mark=\"true\"]';\nconst SYNC_RETRY_INTERVAL_MS = 200;\nconst SYNC_RETRY_ATTEMPTS = 120;\n\ninterface AdminPaymentBrandDefinition {\n    id: string;\n    labels: string[];\n    shortLabels: string[];\n    markLines: string[];\n    markClassName: string;\n}\n\nconst ADMIN_PAYMENT_BRAND_DEFINITIONS: AdminPaymentBrandDefinition[] = [\n    {\n        id: 'nicepay_naverpay',\n        labels: ['네이버페이 (나이스페이먼츠)', '네이버페이로 결제 (나이스페이먼츠)', 'Naver Pay (NicePayments)', 'Pay with Naver Pay (NicePayments)'],\n        shortLabels: [],\n        markLines: ['N'],\n        markClassName: 'bg-green-500 text-white',\n    },\n    {\n        id: 'nicepay_kakaopay',\n        labels: ['카카오페이 (나이스페이먼츠)', '카카오페이로 결제 (나이스페이먼츠)', 'Kakao Pay (NicePayments)', 'Pay with Kakao Pay (NicePayments)'],\n        shortLabels: [],\n        markLines: ['K'],\n        markClassName: 'bg-yellow-400 text-gray-950',\n    },\n    {\n        id: 'nicepay_samsungpay',\n        labels: ['삼성페이 (나이스페이먼츠)', '삼성페이로 결제 (나이스페이먼츠)', 'Samsung Pay (NicePayments)', 'Pay with Samsung Pay (NicePayments)'],\n        shortLabels: [],\n        markLines: ['S'],\n        markClassName: 'bg-blue-600 text-white',\n    },\n    {\n        id: 'nicepay_applepay',\n        labels: ['애플페이 (나이스페이먼츠)', '애플페이로 결제 (나이스페이먼츠)', 'Apple Pay (NicePayments)', 'Pay with Apple Pay (NicePayments)'],\n        shortLabels: [],\n        markLines: ['A'],\n        markClassName: 'bg-gray-900 text-white',\n    },\n    {\n        id: 'nicepay_payco',\n        labels: ['PAYCO (나이스페이먼츠)', 'PAYCO로 결제 (나이스페이먼츠)', 'PAYCO (NicePayments)', 'Pay with PAYCO (NicePayments)'],\n        shortLabels: [],\n        markLines: ['P'],\n        markClassName: 'bg-red-500 text-white',\n    },\n    {\n        id: 'nicepay_skpay',\n        labels: ['11pay (나이스페이먼츠)', '11pay로 결제 (나이스페이먼츠)', '11pay (NicePayments)', 'Pay with 11pay (NicePayments)'],\n        shortLabels: [],\n        markLines: ['11'],\n        markClassName: 'bg-orange-500 text-white',\n    },\n    {\n        id: 'nicepay_ssgpay',\n        labels: ['SSG페이 (나이스페이먼츠)', 'SSG페이로 결제 (나이스페이먼츠)', 'SSG Pay (NicePayments)', 'Pay with SSG Pay (NicePayments)'],\n        shortLabels: [],\n        markLines: ['SSG'],\n        markClassName: 'bg-red-700 text-white',\n    },\n    {\n        id: 'nicepay_lpay',\n        labels: ['L.pay (나이스페이먼츠)', 'L.pay로 결제 (나이스페이먼츠)', 'L.pay (NicePayments)', 'Pay with L.pay (NicePayments)'],\n        shortLabels: [],\n        markLines: ['L'],\n        markClassName: 'bg-purple-600 text-white',\n    },\n];\n\nlet observer: MutationObserver | null = null;\nlet retryTimer: number | null = null;\nlet syncQueued = false;\n\nfunction windowRecord(): Record<string, unknown> {\n    return window as unknown as Record<string, unknown>;\n}\n\nfunction isOrderSettingsPage(): boolean {\n    if (!ADMIN_SETTINGS_RE.test(window.location.pathname)) return false;\n\n    const tab = new URLSearchParams(window.location.search).get('tab');\n    return tab === null || tab === '' || tab === 'order_settings';\n}\n\nfunction classNameOf(element: Element): string {\n    return element instanceof HTMLElement ? element.className : '';\n}\n\nfunction comparableText(value: string | null | undefined): string {\n    return (value ?? '')\n        .replace(/\\u200B/g, '')\n        .replace(/\\s+/g, ' ')\n        .trim();\n}\n\nfunction isPaymentMethodItem(element: HTMLElement): boolean {\n    const className = classNameOf(element);\n\n    return className.includes('excel-card')\n        || (className.includes('flex-center') && className.includes('border') && className.includes('gap-4'));\n}\n\nfunction findTitleElement(item: HTMLElement): HTMLElement | null {\n    return item.querySelector<HTMLElement>('.font-medium');\n}\n\nfunction findDefinitionForItem(item: HTMLElement): AdminPaymentBrandDefinition | null {\n    const title = comparableText(findTitleElement(item)?.textContent);\n    const text = comparableText(item.textContent);\n\n    return ADMIN_PAYMENT_BRAND_DEFINITIONS.find((definition) => (\n        definition.shortLabels.some((label) => title === label)\n        || definition.labels.some((label) => text.includes(label))\n    )) ?? null;\n}\n\nfunction findPaymentMethodItems(root: ParentNode): HTMLElement[] {\n    return Array.from(root.querySelectorAll<HTMLElement>('div'))\n        .filter(isPaymentMethodItem);\n}\n\nfunction findPaymentIcon(item: HTMLElement): Element | null {\n    const icons = Array.from(item.querySelectorAll<Element>('svg, [data-icon], i'));\n\n    return icons.find((element) => (\n        !element.closest('[data-drag-handle]')\n        && !element.closest(MARK_SELECTOR)\n        && !element.closest('.row-stack, .excel-card-body, button, select, [role=\"switch\"]')\n    )) ?? null;\n}\n\nfunction applyBrandMarkContent(mark: HTMLSpanElement, definition: AdminPaymentBrandDefinition): void {\n    mark.dataset.nicepayAdminPaymentBrandMark = 'true';\n    mark.dataset.nicepayAdminPaymentMethod = definition.id;\n    mark.setAttribute('aria-hidden', 'true');\n    mark.className = `inline-flex items-center justify-center rounded-lg font-bold ${definition.markClassName}`;\n    mark.style.width = '32px';\n    mark.style.height = '32px';\n    mark.style.flex = '0 0 32px';\n    mark.style.lineHeight = '1';\n    mark.style.fontSize = definition.markLines.join('').length > 2 ? '9px' : '12px';\n\n    const expectedText = definition.markLines.join('');\n    if (mark.textContent !== expectedText) {\n        mark.textContent = definition.markLines[0] ?? '';\n    }\n}\n\nfunction createBrandMark(definition: AdminPaymentBrandDefinition): HTMLSpanElement {\n    const mark = document.createElement('span');\n    applyBrandMarkContent(mark, definition);\n\n    return mark;\n}\n\nfunction syncBrandMark(item: HTMLElement, definition: AdminPaymentBrandDefinition): boolean {\n    const existing = item.querySelector<HTMLElement>(MARK_SELECTOR);\n    if (existing instanceof HTMLSpanElement) {\n        item.dataset.nicepayAdminPaymentMethod = definition.id;\n        applyBrandMarkContent(existing, definition);\n        return true;\n    }\n\n    const mark = createBrandMark(definition);\n    const icon = findPaymentIcon(item);\n    if (icon && icon.parentElement) {\n        item.dataset.nicepayAdminPaymentMethod = definition.id;\n        icon.replaceWith(mark);\n        return true;\n    }\n\n    const title = findTitleElement(item);\n    if (title && title.parentElement) {\n        item.dataset.nicepayAdminPaymentMethod = definition.id;\n        title.parentElement.insertBefore(mark, title);\n        return true;\n    }\n\n    return false;\n}\n\nexport function syncRenderedAdminPaymentMethodBrands(root: ParentNode = document): boolean {\n    if (typeof window === 'undefined' || typeof document === 'undefined') return false;\n    if (!isOrderSettingsPage()) return false;\n\n    let matched = false;\n\n    findPaymentMethodItems(root).forEach((item) => {\n        const definition = findDefinitionForItem(item);\n        if (!definition) return;\n\n        if (syncBrandMark(item, definition)) {\n            matched = true;\n        }\n    });\n\n    return matched;\n}\n\nfunction queueSync(): void {\n    if (syncQueued) return;\n    syncQueued = true;\n\n    window.setTimeout(() => {\n        syncQueued = false;\n        syncRenderedAdminPaymentMethodBrands();\n    }, 0);\n}\n\nfunction stopRetries(): void {\n    if (retryTimer === null) return;\n\n    window.clearInterval(retryTimer);\n    retryTimer = null;\n}\n\nfunction startSync(): void {\n    if (!isOrderSettingsPage()) return;\n\n    stopRetries();\n    syncRenderedAdminPaymentMethodBrands();\n\n    let attempts = 0;\n    retryTimer = window.setInterval(() => {\n        attempts += 1;\n        syncRenderedAdminPaymentMethodBrands();\n\n        if (attempts >= SYNC_RETRY_ATTEMPTS) {\n            stopRetries();\n        }\n    }, SYNC_RETRY_INTERVAL_MS);\n\n    const body = document.body as HTMLElement & Record<string, unknown>;\n    if (body[LISTENER_FLAG]) return;\n    body[LISTENER_FLAG] = true;\n\n    observer = new MutationObserver(() => queueSync());\n    observer.observe(document.body, { childList: true, subtree: true, characterData: true });\n}\n\nfunction onRouteChange(): void {\n    if (isOrderSettingsPage()) {\n        startSync();\n        return;\n    }\n\n    stopRetries();\n}\n\nexport function installAdminPaymentMethodBrandInjector(): void {\n    if (typeof window === 'undefined' || typeof document === 'undefined') return;\n    const w = windowRecord();\n    if (w[FLAG]) return;\n    w[FLAG] = true;\n\n    console.info(`[${PLUGIN_ID}] admin payment method brand sync installed`);\n\n    if (document.readyState === 'loading') {\n        document.addEventListener('DOMContentLoaded', () => startSync());\n    } else {\n        startSync();\n    }\n\n    const origPush = history.pushState.bind(history);\n    history.pushState = (...args: Parameters<typeof history.pushState>) => {\n        origPush(...args);\n        window.setTimeout(() => onRouteChange(), 200);\n    };\n    window.addEventListener('popstate', () => window.setTimeout(() => onRouteChange(), 200));\n}\n\nexport function resetAdminPaymentMethodBrandInjectorForTests(): void {\n    observer?.disconnect();\n    observer = null;\n    stopRetries();\n    syncQueued = false;\n    delete windowRecord()[FLAG];\n    if (document.body) {\n        delete ((document.body as HTMLElement & Record<string, unknown>)[LISTENER_FLAG]);\n    }\n}\n","const PLUGIN_ID = 'sirsoft-pay_nicepayments';\nconst FLAG = '__nicepayAdminPaymentDisplayInjectorInstalled';\n\nconst ADMIN_ORDER_SHOW_RE = /^\\/admin\\/ecommerce\\/orders\\/([^/]+)$/;\n\ninterface AdminTransactionStatus {\n    _pay_method_label?: string | null;\n    _base_pay_method_label?: string | null;\n    _embedded_pg_provider_label?: string | null;\n}\n\nfunction getToken(): string | null {\n    return localStorage.getItem('auth_token');\n}\n\nasync function fetchAdminTransactionStatus(orderNumber: string): Promise<AdminTransactionStatus | null> {\n    const token = getToken();\n    if (!token) return null;\n\n    try {\n        const res = await fetch(`/api/plugins/${PLUGIN_ID}/admin/orders/${orderNumber}/transaction-status`, {\n            headers: { Authorization: `Bearer ${token}`, Accept: 'application/json' },\n        });\n        if (!res.ok) return null;\n\n        const json = (await res.json()) as { data?: AdminTransactionStatus | null } | AdminTransactionStatus;\n        return ('data' in json ? json.data : json) ?? null;\n    } catch {\n        return null;\n    }\n}\n\nfunction directElementChildren(el: Element): HTMLElement[] {\n    return Array.from(el.children).filter(\n        (child): child is HTMLElement => child instanceof HTMLElement,\n    );\n}\n\nfunction patchLabeledPaymentMethod(root: Element, displayLabel: string): boolean {\n    let patched = false;\n\n    const rows = Array.from(root.querySelectorAll<HTMLElement>('div'));\n    for (const row of rows) {\n        const children = directElementChildren(row);\n        const labelIndex = children.findIndex(child => child.textContent?.trim() === '결제수단');\n        if (labelIndex < 0) continue;\n\n        const value = children\n            .slice(labelIndex + 1)\n            .find(child => child.textContent?.trim() && child.textContent.trim() !== '결제수단');\n        if (!value) continue;\n\n        const installment = children\n            .slice(labelIndex + 2)\n            .find(child => /^\\(.+\\)$/.test(child.textContent?.trim() ?? ''));\n        const installmentText = installment?.textContent?.trim().replace(/^\\(|\\)$/g, '') ?? '';\n        const nextDisplayLabel = installmentText && displayLabel.endsWith(')')\n            ? displayLabel.replace(/\\)$/, `, ${installmentText})`)\n            : displayLabel;\n\n        if (value.textContent?.trim() !== nextDisplayLabel) {\n            value.textContent = nextDisplayLabel;\n            value.dataset.nicepayPaymentMethodPatched = 'true';\n        }\n        row.dataset.nicepayPaymentMethodRow = 'admin-order';\n        if (installment && installmentText) {\n            installment.textContent = '';\n            installment.style.display = 'none';\n            installment.dataset.nicepayPaymentInstallmentHidden = 'true';\n        }\n        patched = true;\n    }\n\n    return patched;\n}\n\nfunction patchPaymentMethodBadge(root: Element, baseLabel: string, embeddedLabel: string): boolean {\n    const candidates = Array.from(root.querySelectorAll<HTMLElement>('span')).filter(\n        el => el.textContent?.trim() === baseLabel,\n    );\n\n    const badge = candidates.find(el => {\n        const className = typeof el.className === 'string' ? el.className : '';\n        return className.includes('rounded-full') || className.includes('font-medium');\n    });\n\n    if (!badge) return false;\n\n    badge.textContent = embeddedLabel;\n    badge.dataset.nicepayPaymentMethodPatched = 'true';\n    badge.dataset.nicepayPaymentMethodBadge = 'admin-order';\n    return true;\n}\n\nexport function patchAdminPaymentMethodDisplay(\n    root: Element,\n    status: AdminTransactionStatus | null | undefined,\n): boolean {\n    const displayLabel = status?._pay_method_label;\n    const embeddedLabel = status?._embedded_pg_provider_label;\n    const baseLabel = status?._base_pay_method_label;\n\n    if (!displayLabel || !embeddedLabel) return false;\n\n    const labeled = patchLabeledPaymentMethod(root, displayLabel);\n    const badge = baseLabel ? patchPaymentMethodBadge(root, baseLabel, embeddedLabel) : false;\n\n    return labeled || badge;\n}\n\nasync function tryInject(orderNumber: string): Promise<boolean> {\n    const root = document.getElementById('section_payment_info') ?? document.getElementById('payment_info_card');\n    if (!root) return false;\n\n    const status = await fetchAdminTransactionStatus(orderNumber);\n    if (!status) return true;\n\n    const patched = patchAdminPaymentMethodDisplay(root, status);\n    if (patched) {\n        console.info(`[${PLUGIN_ID}] payment method display patched on admin order detail`);\n    }\n\n    return true;\n}\n\nfunction startPolling(orderNumber: string): void {\n    let attempts = 0;\n    const id = setInterval(() => {\n        attempts++;\n        void tryInject(orderNumber).then(done => {\n            if (done || attempts >= 30) clearInterval(id);\n        });\n    }, 400);\n}\n\nfunction onRouteChange(): void {\n    const match = location.pathname.match(ADMIN_ORDER_SHOW_RE);\n    if (match) startPolling(match[1]);\n}\n\nexport function installAdminOrderPaymentDisplayInjector(): void {\n    if (typeof window === 'undefined') return;\n    const w = window as unknown as Record<string, unknown>;\n    if (w[FLAG]) return;\n    w[FLAG] = true;\n\n    console.info(`[${PLUGIN_ID}] admin order payment display injector installed`);\n\n    const schedule = (delay = 1500) => setTimeout(onRouteChange, delay);\n\n    if (document.readyState === 'loading') {\n        document.addEventListener('DOMContentLoaded', () => schedule());\n    } else {\n        schedule();\n    }\n\n    const origPush = history.pushState.bind(history);\n    history.pushState = (...args: Parameters<typeof history.pushState>) => {\n        origPush(...args);\n        schedule(600);\n    };\n    window.addEventListener('popstate', () => schedule(500));\n}\n","import { handlerMap } from './handlers';\nimport { initEasyPayWatcher } from './handlers/setPaymentMethod';\nimport { installOrderResponseInterceptor } from './orderResponseInterceptor';\nimport { installCheckoutEasyPayInjector } from './checkoutEasyPayInjector';\nimport { installOrderCompleteReceiptInjector } from './orderCompleteReceiptInjector';\nimport { installMypageOrderShowInjector } from './mypageOrderShowInjector';\nimport { installAdminPaymentMethodBrandInjector } from './adminPaymentMethodBrandInjector';\nimport { installAdminOrderPaymentDisplayInjector } from './adminOrderPaymentDisplayInjector';\n\nconst PLUGIN_IDENTIFIER = 'sirsoft-pay_nicepayments';\n\nconst logger = {\n    info: (...args: unknown[]) => console.info(`[${PLUGIN_IDENTIFIER}]`, ...args),\n    warn: (...args: unknown[]) => console.warn(`[${PLUGIN_IDENTIFIER}]`, ...args),\n    error: (...args: unknown[]) => console.error(`[${PLUGIN_IDENTIFIER}]`, ...args),\n};\n\nfunction registerHandlers(): number {\n    const g7Core = (window as Record<string, unknown>).G7Core as Record<string, unknown> | undefined;\n\n    if (!g7Core) {\n        return 0;\n    }\n\n    const getDispatcher = g7Core.getActionDispatcher as (() => Record<string, unknown>) | undefined;\n\n    if (typeof getDispatcher !== 'function') {\n        return 0;\n    }\n\n    const dispatcher = getDispatcher() as Record<string, unknown> | undefined;\n\n    if (!dispatcher || typeof dispatcher.registerHandler !== 'function') {\n        return 0;\n    }\n\n    let count = 0;\n    for (const [name, handler] of Object.entries(handlerMap)) {\n        const fullName = `${PLUGIN_IDENTIFIER}.${name}`;\n        dispatcher.registerHandler(fullName, handler, {\n            category: 'plugin',\n            source: PLUGIN_IDENTIFIER,\n        });\n        count++;\n    }\n\n    return count;\n}\n\nfunction initPlugin(): void {\n    // fetch 인터셉터는 G7Core 초기화와 무관하게 즉시 설치\n    installOrderResponseInterceptor();\n    installCheckoutEasyPayInjector();\n    installOrderCompleteReceiptInjector();\n    installMypageOrderShowInjector();\n    installAdminPaymentMethodBrandInjector();\n    installAdminOrderPaymentDisplayInjector();\n\n    const doInit = () => {\n        const count = registerHandlers();\n\n        if (count > 0) {\n            logger.info(`${count} handler(s) registered`);\n            initEasyPayWatcher();\n            return;\n        }\n\n        let retries = 0;\n        const maxRetries = 50;\n        const interval = setInterval(() => {\n            retries++;\n            const result = registerHandlers();\n\n            if (result > 0) {\n                clearInterval(interval);\n                logger.info(`${result} handler(s) registered (after ${retries} retries)`);\n                initEasyPayWatcher();\n                return;\n            }\n\n            if (retries >= maxRetries) {\n                clearInterval(interval);\n                logger.warn('ActionDispatcher not available after timeout');\n            }\n        }, 100);\n    };\n\n    if (document.readyState === 'loading') {\n        document.addEventListener('DOMContentLoaded', doInit);\n    } else {\n        doInit();\n    }\n}\n\ninitPlugin();\n\n(window as Record<string, unknown>).__SirsoftNicepayments = {\n    identifier: PLUGIN_IDENTIFIER,\n    handlers: Object.keys(handlerMap),\n    initPlugin,\n};\n"],"names":["resolveApiUrl","url","trimReason","reason","reportPaymentWindowClosed","context","payload","apiClient","error","loadScript","src","resolve","reject","script","createPaymentForm","action","fields","form","name","value","input","CALLBACK_PATH","NICEPAY_MOBILE_ENDPOINT","isMobileDevice","nav","ua","requestPaymentHandler","_context","pgPaymentData","paramPaymentMethod","localState","paymentMethod","G7Core","configJson","config","isMobile","signDataUrl","authToken","signDataHeaders","signDataRes","signData","callbackUrl","isEasyPay","payMethod","formFields","useEscrow","od","taxAmt","vatAmt","taxFreeAmt","charsetInput","paymentClosed","bodySnapshot","closePayment","_resultCode","resultMsg","closeReason","handlePopState","el","METHOD_TO_TEXT","SELECTED_SHADOW","getEasyPayButtonContainer","section","paras","p","clearEasyPayButtonStyles","container","btn","updateEasyPayButtonStyles","selectedMethod","selectedText","setPaymentMethodHandler","initEasyPayWatcher","templateApp","state","handlerMap","ORDER_CREATE_PATH","TARGET_PG_PROVIDER","PLUGIN_IDENTIFIER","FETCH_FLAG","CHECKOUT_ENDPOINT_PATH","PAYMENT_IN_PROGRESS_FLAG","CHECKOUT_CACHE_KEY","logger","args","buildNoOpRedirectUrl","isTargetOrderEndpoint","method","path","isCheckoutEndpoint","extractPaymentMethodFromBody","body","obj","v","replacePaymentMethodInBody","newMethod","parsed","resolveOrderPaymentAmount","orderData","candidates","candidate","amount","installOrderResponseInterceptor","w","ORIGINAL_FETCH_KEY","browserFetch","originalFetch","init","checkoutResp","text","originalPaymentMethod","modifiedInit","pm","response","envelope","responseData","isNicepayPg","options","firstName","orderName","modifiedData","modifiedBody","tryInstallAxiosCheckoutInterceptor","AXIOS_CHECKOUT_FLAG","retries","axiosClient","PLUGIN_ID","FLAG","CHECKOUT_RE","LISTENER_FLAG","SYNC_RETRY_INTERVAL_MS","SYNC_RETRY_ATTEMPTS","LEGACY_CONTAINER_ID","EASY_PAY_DEFINITIONS","observer","retryTimer","syncQueued","windowRecord","isCheckoutPage","normalizedText","comparableText","isKoreanPage","copyFor","definition","displayText","findDefinitionById","id","findDefinitionForButton","button","markedDefinition","label","findPaymentRow","alignPaymentTextLeft","heading","description","row","textContainer","createMark","mark","removeOtherPgArtifacts","element","findPaymentIcon","ensureMark","existingMark","icon","updatePaymentText","paragraphs","copy","headingText","descriptionText","showButton","removeLegacyInjectedSection","legacySection","syncRenderedCheckoutEasyPayMethods","root","changed","queueSync","stopRetries","startSync","attempts","onRouteChange","installCheckoutEasyPayInjector","origPush","BTN_ID","ORDER_COMPLETE_RE","getToken","fetchPayment","orderNumber","token","res","fetchReceiptInfo","patchPaymentMethodDisplay","displayLabel","rows","spans","child","injectOnOrderComplete","payment","blueBtn","b","receiptInfo","receiptBtn","data","lastBtn","tryInject","match","installOrderCompleteReceiptInjector","schedule","delay","ROW_ID","VBANK_BLOCK_ID","ORDER_SHOW_RE","getOrderFromState","getState","findPaymentContainer","panel","h3","panelDiv","buildReceiptRow","formatVbankDueAt","raw","d","pad","n","buildVbankRow","valueClass","l","buildVbankBlock","wrap","inner","title","dueRaw","dueRow","dueLabel","dueValue","notice","startPolling","done","installMypageOrderShowInjector","ADMIN_SETTINGS_RE","MARK_SELECTOR","ADMIN_PAYMENT_BRAND_DEFINITIONS","isOrderSettingsPage","tab","classNameOf","isPaymentMethodItem","className","findTitleElement","item","findDefinitionForItem","findPaymentMethodItems","applyBrandMarkContent","expectedText","createBrandMark","syncBrandMark","existing","syncRenderedAdminPaymentMethodBrands","matched","installAdminPaymentMethodBrandInjector","ADMIN_ORDER_SHOW_RE","fetchAdminTransactionStatus","json","directElementChildren","patchLabeledPaymentMethod","patched","children","labelIndex","installment","installmentText","nextDisplayLabel","patchPaymentMethodBadge","baseLabel","embeddedLabel","badge","patchAdminPaymentMethodDisplay","status","labeled","installAdminOrderPaymentDisplayInjector","registerHandlers","g7Core","getDispatcher","dispatcher","count","handler","fullName","initPlugin","doInit","maxRetries","interval","result"],"mappings":"yBASA,SAASA,GAAcC,EAAqB,CACxC,MAAI,gBAAgB,KAAKA,CAAG,GAAKA,EAAI,WAAW,OAAO,EAC5CA,EAGPA,EAAI,WAAW,WAAW,EACnB,OAAOA,CAAG,GAGjBA,EAAI,WAAW,UAAU,EAClB,QAAQA,CAAG,GAGfA,CACX,CAEA,SAASC,GAAWC,EAAwB,CACxC,OAAOA,EAAO,KAAA,EAAO,MAAM,EAAG,GAAG,CACrC,CAEA,eAAsBC,GAClBC,EACAF,EAAS,wBACI,CACb,GAAI,CAACE,EAAQ,eACT,OAGJ,MAAMC,EAAU,CACZ,IAAKD,EAAQ,IACb,MAAO,OAAOA,EAAQ,KAAK,EAC3B,YAAaA,EAAQ,aAAe,GACpC,YAAaA,EAAQ,aAAe,GACpC,eAAgBA,EAAQ,gBAAkB,GAC1C,OAAQH,GAAWC,CAAM,GAAK,uBAAA,EAGlC,GAAI,CACA,MAAMI,EAAc,OAAe,QAAS,IAC5C,GAAI,OAAOA,GAAW,MAAS,WAAY,CACvC,MAAMA,EAAU,KAAKF,EAAQ,eAAgBC,CAAO,EACpD,MACJ,CAEA,MAAM,MAAMN,GAAcK,EAAQ,cAAc,EAAG,CAC/C,OAAQ,OACR,QAAS,CAAE,eAAgB,kBAAA,EAC3B,KAAM,KAAK,UAAUC,CAAO,EAC5B,UAAW,EAAA,CACd,CACL,OAASE,EAAO,CACZ,QAAQ,KAAK,mEAAoEA,CAAK,CAC1F,CACJ,CCiBA,SAASC,GAAWC,EAA4B,CAC5C,OAAO,IAAI,QAAQ,CAACC,EAASC,IAAW,CACpC,GAAI,SAAS,cAAc,eAAeF,CAAG,IAAI,EAAG,CAChDC,EAAA,EACA,MACJ,CAEA,MAAME,EAAS,SAAS,cAAc,QAAQ,EAC9CA,EAAO,IAAMH,EACbG,EAAO,OAAS,IAAMF,EAAA,EACtBE,EAAO,QAAU,IAAMD,EAAO,IAAI,MAAM,0BAA0BF,CAAG,EAAE,CAAC,EACxE,SAAS,KAAK,YAAYG,CAAM,CACpC,CAAC,CACL,CAEA,SAASC,GAAkBC,EAAgBC,EAAiD,CACxF,MAAMC,EAAO,SAAS,cAAc,MAAM,EAC1CA,EAAK,GAAK,cACVA,EAAK,OAAS,OACdA,EAAK,OAASF,EAEdE,EAAK,cAAgB,QAErB,SAAW,CAACC,EAAMC,CAAK,IAAK,OAAO,QAAQH,CAAM,EAAG,CAChD,MAAMI,EAAQ,SAAS,cAAc,OAAO,EAC5CA,EAAM,KAAO,SACbA,EAAM,KAAOF,EACbE,EAAM,MAAQD,EACdF,EAAK,YAAYG,CAAK,CAC1B,CAEA,gBAAS,KAAK,YAAYH,CAAI,EACvBA,CACX,CAEA,MAAMI,GAAgB,qDAIhBC,GAA0B,6CAWhC,SAASC,IAA0B,CAC/B,GAAI,OAAO,UAAc,IAAa,MAAO,GAG7C,MAAMC,EAAM,UACZ,GAAIA,EAAI,eAAe,SAAW,OAC9B,OAAOA,EAAI,cAAc,OAI7B,MAAMC,GAAM,UAAU,WAAa,IAAI,YAAA,EAQvC,MANI,GADa,iFACJ,KAAKA,CAAE,IAKC,UAAsD,gBAAkB,GAC3E,GAAK,CAACA,EAAG,SAAS,SAAS,GAAK,CAACA,EAAG,SAAS,WAAW,EAK9E,CAqBA,eAAsBC,EAAsBX,EAAuBY,EAAmC,CAClG,KAAM,CAAE,cAAAC,EAAe,cAAeC,GAAuBd,EAAO,QAAU,CAAA,EAExEe,EAAa,OAAO,eAAe,aAAa,OAChDC,EAAgBF,GAAsBC,GAAY,eAAiB,OAEzE,GAAI,CAACF,EAAe,CAChB,QAAQ,MAAM,sDAAsD,EACpE,MACJ,CAEA,MAAMI,EAAS,OAAO,OAEtB,GAAI,CAEA,MAAMC,EAAa,MAAMD,EAAO,IAAI,IAAI,gEAAgE,EAExG,GAAI,CAACC,EAAW,KAAM,CAClB,QAAQ,MAAM,2DAA4DA,CAAU,EACpF,MACJ,CAEA,MAAMC,EAASD,EAAW,KACpBE,EAAWZ,GAAA,EAGjB,GAAI,CAACY,IACD,MAAM1B,GAAWyB,EAAO,OAAO,EAE3B,OAAO,OAAO,OAAU,YAAY,CACpCF,GAAQ,OAAO,QAAQ,0CAA0C,EACjEA,GAAQ,OAAO,WAAW,CAAE,kBAAmB,GAAO,cAAAD,EAAe,EACrE,MACJ,CAKJ,MAAMK,EAAc,OAAO,SAAS,OAASF,EAAO,cAC9CG,EAAa,OAAO,aAAiB,IAAe,aAAa,QAAQ,YAAY,EAAI,KACzFC,EAA0C,CAC5C,eAAgB,mBAChB,mBAAoB,iBACpB,OAAU,kBAAA,EAEVD,IACAC,EAAgB,cAAmB,UAAUD,CAAS,IAE1D,MAAME,EAAc,MAAM,MAAMH,EAAa,CACzC,OAAQ,OACR,YAAa,UACb,QAASE,EACT,KAAM,KAAK,UAAU,CACjB,IAAKV,EAAc,OACnB,KAAMA,EAAc,aACpB,YAAaA,EAAc,gBAAkB,GAC7C,YAAaA,EAAc,gBAAkB,EAAA,CAChD,CAAA,CACJ,EAED,GAAI,CAACW,EAAY,GACb,MAAM,IAAI,MAAM,sBAAsB,EAG1C,MAAMC,EAA6B,MAAMD,EAAY,KAAA,EAC/CE,EAAc,OAAO,SAAS,OAASpB,GAKvCqB,EAAY,OAAOX,GAAkB,UAAYA,EAAc,WAAW,UAAU,EAQpFY,EAAYD,EAAY,OANe,CACzC,KAAM,OACN,MAAO,QACP,KAAM,OACN,MAAO,WAAA,EAE0CX,GAAiB,MAAM,GAAK,OAE3Ea,EAAqC,CACvC,UAAWD,EACX,UAAWf,EAAc,WACzB,IAAK,OAAOA,EAAc,MAAM,EAChC,IAAKY,EAAS,IACd,KAAMZ,EAAc,aACpB,UAAWA,EAAc,eAAiB,GAC1C,WAAYA,EAAc,gBAAkB,GAC5C,SAAUA,EAAc,gBAAkB,GAC1C,UAAWa,EACX,QAASD,EAAS,QAClB,SAAUA,EAAS,SACnB,QAAS,QACT,QAAS,IACT,cAAe,GACf,cAAe,GACf,gBAAiB,GACjB,cAAe,GACf,aAAc,GACd,cAAe,EAAA,EAIfG,IAAc,cACdC,EAAW,QAAUhB,EAAc,UAAY,KAInD,MAAMiB,EAAYX,EAAO,WAAa,CAACQ,EAIvC,GAHAE,EAAW,UAAYC,EAAY,IAAM,IAGrCH,EAIA,OAHAE,EAAW,cAAgB,OAC3BA,EAAW,aAAe,2BAA2B,mBAAmBb,CAAa,CAAC,GACtFa,EAAW,cAAgBb,EACnBA,EAAA,CACJ,IAAK,mBACDa,EAAW,cAAgB,OAC3BA,EAAW,cAAgB,YAC3B,MACJ,IAAK,mBACDA,EAAW,gBAAkB,gBAC7B,MACJ,IAAK,qBACDA,EAAW,cAAgB,OAC3B,MACJ,IAAK,mBACDA,EAAW,cAAgB,OAC3B,MACJ,IAAK,gBACDA,EAAW,gBAAkB,gBAC7B,MACJ,IAAK,gBACDA,EAAW,gBAAkB,gBAC7B,MACJ,IAAK,iBACDA,EAAW,cAAgB,OAC3B,MACJ,IAAK,eACDA,EAAW,cAAgB,OAC3B,KAAA,CAKZ,GAAI,CAEA,MAAME,GADW,MAAMd,EAAO,IAAI,IAAI,0CAA0CJ,EAAc,YAAY,EAAE,IACvF,KACrB,GAAIkB,EAAI,CACJ,MAAMC,EAAS,OAAOD,EAAG,kBAAuB,CAAC,EAC3CE,EAAS,OAAOF,EAAG,kBAAuB,CAAC,EAC3CG,GAAa,OAAOH,EAAG,uBAA4B,CAAC,GACtDC,EAAS,GAAKC,EAAS,GAAKC,GAAa,KACzCL,EAAW,OAAS,OAAOG,CAAM,EACjCH,EAAW,OAAS,OAAOI,CAAM,EACjCJ,EAAW,WAAa,OAAOK,EAAU,EAEjD,CACJ,MAAQ,CAER,CAEA,MAAMhC,EAAOH,GAAkB2B,EAAaG,CAAU,EAEtD,GAAIT,EAAU,CAQVlB,EAAK,OAASK,GACdL,EAAK,cAAgB,SACrB,MAAMiC,EAAejC,EAAK,cAAc,uBAAuB,EAC3DiC,IACAA,EAAa,MAAQ,UAEzBjC,EAAK,OAAA,EAEL,MACJ,CAKA,OAAO,cAAgB,IAAM,CACzBA,EAAK,OAAA,CACT,EAEA,IAAIkC,EAAgB,GAGpB,MAAMC,EAAe,IAAI,IAAI,SAAS,KAAK,QAAQ,EAE7CC,GAAe,CAACC,EAAqBC,IAAsB,CAC7D,GAAIJ,EAAe,OACnBA,EAAgB,GAChB,MAAMK,EAAc,CAACF,EAAaC,CAAS,EAAE,OAAO,OAAO,EAAE,KAAK,IAAI,GAAK,wBACtEnD,GAA0B,CAC3B,eAAgB8B,EAAO,iBACvB,IAAKN,EAAc,aACnB,MAAO,OAAOA,EAAc,MAAM,EAClC,YAAaA,EAAc,gBAAkB,GAC7C,YAAaA,EAAc,gBAAkB,GAC7C,eAAgBG,CAAA,EACjByB,CAAW,EACd,OAAO,oBAAoB,WAAYC,EAAc,EAErD,MAAM,KAAK,SAAS,KAAK,QAAQ,EAAE,QAAQC,GAAM,CACxCN,EAAa,IAAIM,CAAE,KAAM,OAAA,CAClC,CAAC,EACGzC,EAAK,YAAYA,EAAK,WAAW,YAAYA,CAAI,EACpD,OAA8C,kCAAuC,GACtFe,GAAQ,OAAO,WAAW,CAAE,kBAAmB,GAAO,cAAAD,EAAe,EACjEwB,GAAWvB,GAAQ,OAAO,QAAQuB,CAAS,CACnD,EAEA,OAAO,aAAeF,GAGtB,MAAMI,GAAiB,IAAMJ,GAAa,GAAI,EAAE,EAGhD,OAAO,QAAQ,UAAU,CAAE,YAAa,EAAA,EAAQ,EAAE,EAClD,OAAO,iBAAiB,WAAYI,EAAc,EAGlD,OAAO,MAAMxC,CAAI,CAErB,OAAST,EAAgB,CACrB,QAAQ,MAAM,kDAAmDA,CAAK,EACrE,OAA8C,kCAAuC,GACtFwB,GAAQ,OAAO,WAAW,CAAE,kBAAmB,GAAO,cAAAD,EAAe,EACrEC,GAAQ,OAAO,QAAQ,kCAAkC,CAC7D,CACJ,CCxZA,MAAM2B,GAAyC,CAC3C,iBAAoB,QACpB,iBAAoB,QACpB,mBAAoB,OACpB,iBAAoB,OACpB,cAAoB,QACpB,cAAoB,QACpB,eAAoB,QACpB,aAAoB,OACxB,EAGMC,GAAkB,gDAExB,SAASC,GAA4C,CACjD,MAAMC,EAAU,SAAS,eAAe,kCAAkC,EAC1E,GAAI,CAACA,EAAS,OAAO,KACrB,MAAMC,EAAQD,EAAQ,iBAAiB,GAAG,EAC1C,UAAWE,KAAKD,EACZ,GAAIC,EAAE,aAAa,SAAS,MAAM,EAC9B,OAAOA,EAAE,mBAGjB,OAAO,IACX,CAEA,SAASC,GAAiC,CACtC,MAAMC,EAAYL,EAAA,EACbK,GACLA,EAAU,iBAAoC,QAAQ,EAAE,QAAQC,GAAO,CACnEA,EAAI,MAAM,UAAY,GACtBA,EAAI,MAAM,QAAU,EACxB,CAAC,CACL,CAEA,SAASC,GAA0BC,EAA8B,CAC7D,MAAMH,EAAYL,EAAA,EAClB,GAAI,CAACK,EAAW,OAEhB,MAAMI,EAAeX,GAAeU,CAAc,EAClDH,EAAU,iBAAoC,QAAQ,EAAE,QAAQC,GAAO,CAC/DA,EAAI,aAAa,KAAA,IAAWG,GAC5BH,EAAI,MAAM,UAAYP,GACtBO,EAAI,MAAM,QAAU,SAEpBA,EAAI,MAAM,UAAY,GACtBA,EAAI,MAAM,QAAU,GAE5B,CAAC,CACL,CAEO,SAASI,GAAwBxD,EAAmB,CACvD,MAAMgB,EAAgBhB,EAAO,QAAQ,cACrC,GAAI,CAACgB,EAAe,OAEpB,MAAMW,EAAY,OAAOX,GAAkB,UAAYA,EAAc,QAAQ,UAAU,IAAM,EAC5F,OAAe,QAAQ,OAAO,WAAW,CACtC,cAAAA,EACA,oBAAqBW,EAAY,OAASX,CAAA,CAC7C,EAEGW,EACA0B,GAA0BrC,CAAa,EAEvCkC,EAAA,CAER,CAGO,SAASO,GAA2B,CACvC,MAAMC,EAAe,OAAe,cAChC,OAAOA,GAAa,qBAAwB,YAEhDA,EAAY,oBAAqBC,GAAe,CAC5C,MAAM3C,EAAgB2C,GAAO,QAAQ,cACjC,OAAO3C,GAAkB,WACxBA,EAAc,WAAW,UAAU,GACpCkC,EAAA,EAER,CAAC,CACL,CC/EO,MAAMU,GAA8D,CACvE,eAAgBjD,EAChB,iBAAkB6C,EACtB,ECWMK,GAAoB,eACpBC,GAAqB,uBACrBC,EAAoB,2BACpBC,GAAa,4CACbC,GAAyB,0CACzBC,EAA2B,oCAC3BC,EAAqB,gCAErBC,EAAS,CACX,KAAM,IAAIC,IAAoB,QAAQ,KAAK,IAAIN,CAAiB,IAAK,GAAGM,CAAI,EAC5E,KAAM,IAAIA,IAAoB,QAAQ,KAAK,IAAIN,CAAiB,IAAK,GAAGM,CAAI,EAC5E,MAAO,IAAIA,IAAoB,QAAQ,MAAM,IAAIN,CAAiB,IAAK,GAAGM,CAAI,CAClF,EAEA,SAASC,IAA+B,CACpC,OAAO,OAAO,SAAS,SAAW,OAAO,SAAS,OAAS,OAAO,SAAS,IAC/E,CAEA,SAASC,GAAsBrF,EAAasF,EAAyB,CACjE,GAAIA,EAAO,gBAAkB,OAAQ,MAAO,GAC5C,MAAMC,GAAQvF,GAAO,IAAI,MAAM,GAAG,EAAE,CAAC,EAAE,MAAM,GAAG,EAAE,CAAC,EACnD,OAAOuF,IAASZ,IAAqBY,EAAK,SAASZ,EAAiB,CACxE,CAEA,SAASa,EAAmBxF,EAAasF,EAAyB,CAC9D,GAAIA,EAAO,gBAAkB,MAAO,MAAO,GAC3C,MAAMC,GAAQvF,GAAO,IAAI,MAAM,GAAG,EAAE,CAAC,EAAE,MAAM,GAAG,EAAE,CAAC,EACnD,OAAOuF,IAASR,IAA0BQ,EAAK,SAASR,EAAsB,CAClF,CAEA,SAASU,GAA6BC,EAAmC,CACrE,GAAI,CAACA,EAAM,OACX,IAAIC,EAAsC,KAC1C,GAAI,OAAOD,GAAS,SAChB,GAAI,CAAEC,EAAM,KAAK,MAAMD,CAAI,CAA8B,MAAQ,CAAE,MAAkB,MAC9E,OAAOA,GAAS,WACvBC,EAAMD,GAEV,GAAI,CAACC,EAAK,OACV,MAAMC,EAAID,EAAI,eACd,OAAO,OAAOC,GAAM,UAAYA,EAAE,OAAS,EAAIA,EAAI,MACvD,CAEA,SAASC,GAA2BH,EAAcI,EAA2B,CACzE,GAAI,CACA,MAAMC,EAAS,KAAK,MAAML,CAAI,EAC9B,GAAI,mBAAoBK,EACpB,OAAO,KAAK,UAAU,CAAE,GAAGA,EAAQ,eAAgBD,EAAW,CAEtE,MAAQ,CAAqB,CAC7B,OAAOJ,CACX,CAEA,SAASM,GAA0BC,EAA4C,CAC3E,MAAMC,EAAa,CAACD,EAAU,iBAAkBA,EAAU,YAAY,EACtE,UAAWE,KAAaD,EAAY,CAChC,MAAME,EAAS,OAAOD,GAAa,CAAC,EACpC,GAAI,OAAO,SAASC,CAAM,GAAKA,EAAS,EACpC,OAAO,KAAK,MAAMA,CAAM,CAEhC,CAEA,MAAO,EACX,CAEO,SAASC,IAAwC,CACpD,MAAMC,EAAI,OACV,GAAIA,EAAExB,EAAU,EAAG,OACnBwB,EAAExB,EAAU,EAAI,GAIhB,MAAMyB,EAAqB,2BACtBD,EAAEC,CAAkB,IACrBD,EAAEC,CAAkB,EAAI,OAAO,MAAM,KAAK,MAAM,GAEpD,MAAMC,EAAeF,EAAEC,CAAkB,EAEnCE,EAAgB,OAAO,MAAM,KAAK,MAAM,EAE9C,OAAO,MAAQ,MAAOtF,EAA0BuF,IAA0C,CACtF,MAAM1G,EACF,OAAOmB,GAAU,SACXA,EACAA,aAAiB,IACbA,EAAM,KACLA,EAAkB,IAC3BmE,EAASoB,GAAM,SAAWvF,aAAiB,QAAUA,EAAM,OAAS,OAG1E,GAAIqE,EAAmBxF,EAAKsF,CAAM,EAAG,CACjC,GAAIgB,EAAEtB,CAAwB,GAAKsB,EAAErB,CAAkB,EACnDC,OAAAA,EAAO,KAAK,wDAAwD,EAC7D,IAAI,SAASoB,EAAErB,CAAkB,EAAa,CACjD,OAAQ,IACR,QAAS,CAAE,eAAgB,kBAAA,CAAmB,CACjD,EAEL,MAAM0B,EAAe,MAAMF,EAActF,EAAOuF,CAAI,EACpD,GAAIC,EAAa,GAAI,CACjB,MAAMC,EAAO,MAAMD,EAAa,KAAA,EAChC,OAAAL,EAAErB,CAAkB,EAAI2B,EACjB,IAAI,SAASA,EAAM,CACtB,OAAQD,EAAa,OACrB,WAAYA,EAAa,WACzB,QAASA,EAAa,OAAA,CACzB,CACL,CACA,OAAOA,CACX,CAEA,GAAI,CAACtB,GAAsBrF,EAAKsF,CAAM,EAClC,OAAOmB,EAActF,EAAOuF,CAAI,EAOpC,IAAIG,EACApE,EAAY,GACZqE,EAAeJ,EAEnB,GAAIA,GAAM,MAAQ,OAAOA,EAAK,MAAS,SAAU,CAC7C,MAAMK,EAAKtB,GAA6BiB,EAAK,IAAI,EAC7C,OAAOK,GAAO,UAAYA,EAAG,OAAS,IACtCF,EAAwBE,EACpBA,EAAG,WAAW,UAAU,IACxBtE,EAAY,GACZqE,EAAe,CAAE,GAAGJ,EAAM,KAAMb,GAA2Ba,EAAK,KAAM,MAAM,CAAA,EAC5ExB,EAAO,KAAK,gDAAgD6B,CAAE,YAAY,GAGtF,CAKA,MAAMC,EAAW,MADDvE,EAAY+D,EAAeC,GACZtF,EAAO2F,CAAY,EAGlD,GAAI,CAACE,EAAS,GACV,OAAOA,EAKX,IAAIC,EAA2C,KAC/C,GAAI,CACAA,EAAY,MAAMD,EAAS,MAAA,EAAQ,KAAA,CACvC,MAAQ,CACJ,OAAOA,CACX,CAEA,MAAME,EAAgBD,GAAU,MAAQA,EAMxC,GAAI,CAACC,GAAc,qBAAuB,CAACzE,EACvC,OAAOuE,EAKX,MAAMG,EAAcD,EAAa,cAAgBtC,GAEjD,GAAI,CAACnC,GAAa,CAAC0E,EACf,OAAOH,EAKX,IAAIrF,EAAgBuF,EAAa,gBACjC,GAAI,CAACvF,GAAiBc,EAAW,CAC7B,MAAMwD,EAAYiB,EAAa,MAC/B,GAAIjB,EAAW,CACX,MAAMmB,EAAUnB,EAAU,QACpBoB,EAAaD,IAAU,CAAC,GAAG,cAAuC,OAAOnB,EAAU,cAAgB,EAAE,EACrGqB,GAAaF,GAAS,QAAU,GAAK,EACrC,GAAGC,CAAS,OAAOD,GAAS,QAAU,GAAK,CAAC,IAC5CC,EACN1F,EAAgB,CACZ,aAAcsE,EAAU,aACxB,WAAYqB,EAEZ,OAAQtB,GAA0BC,CAAS,EAC3C,SAAU,MACV,cAAeA,EAAU,cAAgB,KACzC,eAAgBA,EAAU,eAAiB,KAC3C,eAAgB,OAAOA,EAAU,eAAiB,EAAE,EAAE,QAAQ,UAAW,EAAE,EAC3E,aAAcA,EAAU,SAAW,IAAA,EAEvCf,EAAO,KAAK,qDAAsD,CAC9D,aAAcvD,EAAc,aAC5B,OAAQA,EAAc,MAAA,CACzB,CACL,CACJ,CAEA,GAAI,CAACA,EACDuD,OAAAA,EAAO,KAAK,yDAAyD,EAC9D8B,EAGX,MAAMlF,EAAgB+E,GAAyB,OAE/C3B,EAAO,KAAK,uDAAwD,CAAE,cAAApD,CAAA,CAAe,EAEhFL,EAAsB,CAEvB,OAAQ,CAAE,cAAAE,EAAqC,cAAAG,CAAA,CAAc,CAChE,EAGDwE,EAAEtB,CAAwB,EAAI,GAU9B,MAAMuC,EAAe,CAAE,GAAGL,EAAc,oBAAqB,GAAO,aAAc9B,IAAqB,EACjGoC,EAAeP,GAAU,KACzB,CAAE,GAAGA,EAAU,KAAMM,GACrBA,EAEN,OAAO,IAAI,SAAS,KAAK,UAAUC,CAAY,EAAG,CAC9C,OAAQR,EAAS,OACjB,WAAYA,EAAS,WACrB,QAASA,EAAS,OAAA,CACrB,CACL,EAEA9B,EAAO,KAAK,mCAAmC,EAI/CuC,GAAmCnB,EAAG,EAAE,CAC5C,CAEA,MAAMoB,GAAsB,oDAE5B,SAASD,GAAmCnB,EAA4BqB,EAAuB,CAE3F,MAAMC,EAAgB,QAAgB,QAAQ,KAAK,OACnD,GAAI,CAACA,GAAa,aAAc,CACxBD,EAAU,GACV,WAAW,IAAMF,GAAmCnB,EAAGqB,EAAU,CAAC,EAAG,GAAG,EAE5E,MACJ,CAEIrB,EAAEoB,EAAmB,IACzBpB,EAAEoB,EAAmB,EAAI,GAKzBE,EAAY,aAAa,SAAS,IAAKZ,GAAkB,CACrD,MAAM1B,GAAU0B,GAAU,QAAQ,QAAU,IAAI,YAAA,EAC1ChH,EAAM,QAAQgH,GAAU,QAAQ,SAAW,KAAOA,GAAU,QAAQ,KAAO,GAAG,EACpF,OAAI1B,IAAW,OAASE,EAAmBxF,EAAK,KAAK,GAAKgH,GAAU,SAAW,MAC3EV,EAAErB,CAAkB,EAAI,KAAK,UAAU+B,EAAS,IAAI,EACpD9B,EAAO,KAAK,kCAAkC,GAE3C8B,CACX,CAAC,EAIDY,EAAY,aAAa,QAAQ,IAAK3F,GAAgB,CAClD,MAAMqD,GAAUrD,GAAQ,QAAU,IAAI,YAAA,EAChCjC,EAAM,QAAQiC,GAAQ,SAAW,KAAOA,GAAQ,KAAO,GAAG,EAChE,OAAIqD,IAAW,OAASE,EAAmBxF,EAAK,KAAK,GAAKsG,EAAEtB,CAAwB,GAAKsB,EAAErB,CAAkB,IACzGC,EAAO,KAAK,gEAAgE,EAE5EjD,EAAO,QAAU,IAAM,QAAQ,QAAQ,CACnC,KAAM,KAAK,MAAMqE,EAAErB,CAAkB,CAAW,EAChD,OAAQ,IACR,WAAY,cACZ,QAAS,CAAE,eAAgB,kBAAA,EAC3B,OAAAhD,EACA,QAAS,CAAA,CAAC,CACb,GAEEA,CACX,CAAC,EAEDiD,EAAO,KAAK,sCAAsC,EAG7CoB,EAAErB,CAAkB,IACf,SAAY,CACd,GAAI,CAGA,MADkB,QAAgB,QAAQ,KAC3B,MAAM,qCAAqC,CAE9D,MAAQ,CAA4B,CACxC,GAAA,EAER,CCnUA,MAAM4C,GAAY,2BACZC,GAAO,4CACPC,GAAc,wBACdC,GAAgB,+CAChBC,GAAyB,IACzBC,GAAsB,IACtBC,GAAsB,mCAiBtBC,GAA4C,CAC9C,CACI,GAAI,mBACJ,OAAQ,CACJ,kBACA,sBACA,2BACA,mCAAA,EAEJ,GAAI,CACA,QAAS,kBACT,YAAa,sBACb,MAAO,qBAAA,EAEX,GAAI,CACA,QAAS,2BACT,YAAa,oCACb,MAAO,mCAAA,EAEX,SAAU,IACV,cAAe,yBAAA,EAEnB,CACI,GAAI,mBACJ,OAAQ,CACJ,kBACA,sBACA,2BACA,mCAAA,EAEJ,GAAI,CACA,QAAS,kBACT,YAAa,sBACb,MAAO,qBAAA,EAEX,GAAI,CACA,QAAS,2BACT,YAAa,oCACb,MAAO,mCAAA,EAEX,SAAU,IACV,cAAe,6BAAA,EAEnB,CACI,GAAI,qBACJ,OAAQ,CACJ,iBACA,qBACA,6BACA,qCAAA,EAEJ,GAAI,CACA,QAAS,iBACT,YAAa,qBACb,MAAO,oBAAA,EAEX,GAAI,CACA,QAAS,6BACT,YAAa,sCACb,MAAO,qCAAA,EAEX,SAAU,IACV,cAAe,wBAAA,EAEnB,CACI,GAAI,mBACJ,OAAQ,CACJ,iBACA,qBACA,2BACA,mCAAA,EAEJ,GAAI,CACA,QAAS,iBACT,YAAa,qBACb,MAAO,oBAAA,EAEX,GAAI,CACA,QAAS,2BACT,YAAa,oCACb,MAAO,mCAAA,EAEX,SAAU,IACV,cAAe,wBAAA,EAEnB,CACI,GAAI,gBACJ,OAAQ,CACJ,kBACA,sBACA,uBACA,+BAAA,EAEJ,GAAI,CACA,QAAS,kBACT,YAAa,sBACb,MAAO,qBAAA,EAEX,GAAI,CACA,QAAS,uBACT,YAAa,gCACb,MAAO,+BAAA,EAEX,SAAU,IACV,cAAe,uBAAA,EAEnB,CACI,GAAI,gBACJ,OAAQ,CACJ,kBACA,sBACA,uBACA,+BAAA,EAEJ,GAAI,CACA,QAAS,kBACT,YAAa,sBACb,MAAO,qBAAA,EAEX,GAAI,CACA,QAAS,uBACT,YAAa,gCACb,MAAO,+BAAA,EAEX,SAAU,KACV,cAAe,0BAAA,EAEnB,CACI,GAAI,iBACJ,OAAQ,CACJ,kBACA,sBACA,yBACA,iCAAA,EAEJ,GAAI,CACA,QAAS,kBACT,YAAa,sBACb,MAAO,qBAAA,EAEX,GAAI,CACA,QAAS,yBACT,YAAa,kCACb,MAAO,iCAAA,EAEX,SAAU,MACV,cAAe,uBAAA,EAEnB,CACI,GAAI,eACJ,OAAQ,CACJ,kBACA,sBACA,uBACA,+BAAA,EAEJ,GAAI,CACA,QAAS,kBACT,YAAa,sBACb,MAAO,qBAAA,EAEX,GAAI,CACA,QAAS,uBACT,YAAa,gCACb,MAAO,+BAAA,EAEX,SAAU,IACV,cAAe,0BAAA,CAEvB,EAEA,IAAIC,GAAoC,KACpCC,EAA4B,KAC5BC,EAAa,GAEjB,SAASC,IAAwC,CAC7C,OAAO,MACX,CAEA,SAASC,GAA0B,CAC/B,OAAOV,GAAY,KAAK,OAAO,SAAS,QAAQ,CACpD,CAEA,SAASW,GAAexH,EAA0C,CAC9D,OAAQA,GAAS,IAAI,QAAQ,OAAQ,GAAG,EAAE,KAAA,CAC9C,CAEA,SAASyH,GAAezH,EAA0C,CAC9D,OAAOwH,GAAexH,CAAK,EAAE,QAAQ,UAAW,EAAE,CACtD,CAEA,SAAS0H,IAAwB,CAG7B,OAFa,SAAS,gBAAgB,MAAQ,UAAU,UAAY,IAExD,cAAc,WAAW,IAAI,CAC7C,CAEA,SAASC,GAAQC,EAA4C,CACzD,OAAOF,GAAA,EAAiBE,EAAW,GAAKA,EAAW,EACvD,CAEA,SAASC,GAAY7H,EAAuB,CACxC,OAAOA,EACF,WAAW,QAAS,QAAa,EACjC,WAAW,QAAS,QAAa,EACjC,WAAW,OAAQ,OAAY,EAC/B,WAAW,YAAa,YAAiB,EACzC,WAAW,YAAa,YAAiB,EACzC,WAAW,cAAe,cAAmB,EAC7C,WAAW,QAAS,QAAa,CAC1C,CAEA,SAAS8H,GAAmBC,EAAkD,CAC1E,OAAOb,GAAqB,KAAMU,GAAeA,EAAW,KAAOG,CAAE,GAAK,IAC9E,CAEA,SAASC,GAAwBC,EAAqD,CAClF,MAAMC,EAAmBJ,GAAmBG,EAAO,QAAQ,oBAAoB,EAC/E,GAAIC,EAAkB,OAAOA,EAE7B,MAAMxC,EAAO+B,GAAeQ,EAAO,WAAW,EAE9C,OAAOf,GAAqB,KAAMU,GAC9BA,EAAW,OAAO,KAAMO,GAAUzC,EAAK,SAASyC,CAAK,CAAC,CACzD,GAAK,IACV,CAEA,SAASC,GAAeH,EAA+C,CACnE,OAAOA,EAAO,cAA2B,oDAAoD,GACtFA,EAAO,cAA2B,oBAAoB,CACjE,CAEA,SAASI,GAAqBJ,EAA2BK,EAAuBC,EAAiC,CAC7GN,EAAO,MAAM,UAAY,OAEzB,MAAMO,EAAMJ,GAAeH,CAAM,EAC7BO,IACAA,EAAI,MAAM,eAAiB,aAC3BA,EAAI,MAAM,UAAY,OACtBA,EAAI,MAAM,MAAQ,QAGtB,MAAMC,EAAgBH,GAAS,eAAiBC,GAAa,cACzDE,aAAyB,cACzBA,EAAc,MAAM,UAAY,OAChCA,EAAc,MAAM,SAAW,IAEvC,CAEA,SAASC,GAAWd,EAAgD,CAChE,MAAMe,EAAO,SAAS,cAAc,MAAM,EAC1C,OAAAA,EAAK,QAAQ,mBAAqB,OAClCA,EAAK,QAAQ,qBAAuBf,EAAW,GAC/Ce,EAAK,aAAa,cAAe,MAAM,EACvCA,EAAK,UAAY,wEAAwEf,EAAW,aAAa,GACjHe,EAAK,MAAM,MAAQ,OACnBA,EAAK,MAAM,OAAS,OACpBA,EAAK,MAAM,KAAO,WAClBA,EAAK,YAAcf,EAAW,SAEvBe,CACX,CAEA,SAASC,GAAuBX,EAAiC,CAC7D,OAAOA,EAAO,QAAQ,2BACtB,OAAOA,EAAO,QAAQ,2BACtB,OAAOA,EAAO,QAAQ,4BACtB,OAAOA,EAAO,QAAQ,oBACtB,OAAOA,EAAO,QAAQ,qBACtB,OAAOA,EAAO,QAAQ,oBAEtBA,EAAO,iBAA8B,qHAAqH,EAAE,QAASY,GAAY,CAC7KA,EAAQ,OAAA,CACZ,CAAC,CACL,CAEA,SAASC,GAAgBb,EAA2C,CAChE,OAAOA,EAAO,cAAc,qCAAqC,GAC1DA,EAAO,cAAc,qHAAqH,GAC1IA,EAAO,cAAc,KAAK,GAC1BA,EAAO,cAAc,mCAAmC,CACnE,CAEA,SAASc,GAAWd,EAA2BL,EAAqC,CAChF,MAAMoB,EAAef,EAAO,cAA2B,qCAAqC,EAC5F,GAAIe,EAAc,CACdA,EAAa,QAAQ,qBAAuBpB,EAAW,GACvDoB,EAAa,UAAY,wEAAwEpB,EAAW,aAAa,GACzHoB,EAAa,YAAcpB,EAAW,SACtC,MACJ,CAEA,MAAMe,EAAOD,GAAWd,CAAU,EAC5BqB,EAAOH,GAAgBb,CAAM,EACnC,GAAIgB,GAAQA,EAAK,cAAe,CAC5BA,EAAK,YAAYN,CAAI,EACrB,MACJ,CAEYP,GAAeH,CAAM,GAC5B,QAAQU,CAAI,CACrB,CAEA,SAASO,GAAkBjB,EAA2BL,EAAqC,CACvF,MAAMuB,EAAa,MAAM,KAAKlB,EAAO,iBAAuC,GAAG,CAAC,EAC1EmB,EAAOzB,GAAQC,CAAU,EACzByB,EAAcxB,GAAYuB,EAAK,OAAO,EACtCE,EAAkBzB,GAAYuB,EAAK,WAAW,EAE9Cd,EAAUa,EAAW,CAAC,EACtBZ,EAAcY,EAAW,CAAC,EAE5Bb,GAAWA,EAAQ,cAAgBe,IACnCf,EAAQ,YAAce,GAEtBf,IACAA,EAAQ,aAAa,aAAcc,EAAK,OAAO,EAC/Cd,EAAQ,MAAM,UAAY,OAC1BA,EAAQ,MAAM,WAAa,SAC3BA,EAAQ,MAAM,UAAY,WAC1BA,EAAQ,MAAM,aAAe,YAG7BC,GAAeA,EAAY,cAAgBe,IAC3Cf,EAAY,YAAce,GAE1Bf,IACAA,EAAY,MAAM,UAAY,OAC9BA,EAAY,MAAM,SAAW,OAC7BA,EAAY,MAAM,WAAa,OAC/BA,EAAY,MAAM,WAAa,SAC/BA,EAAY,MAAM,UAAY,WAC9BA,EAAY,MAAM,aAAe,YAGrCF,GAAqBJ,EAAQK,EAASC,CAAW,EACjDN,EAAO,MAAQmB,EAAK,KACxB,CAEA,SAASG,GAAWtB,EAA2BL,EAAqC,CAC5EK,EAAO,SAAQA,EAAO,OAAS,IAC/BA,EAAO,WAAUA,EAAO,SAAW,IACnCA,EAAO,MAAM,UAAY,QAAQA,EAAO,MAAM,eAAe,SAAS,EAC1EA,EAAO,gBAAgB,aAAa,EACpCA,EAAO,QAAQ,qBAAuBL,EAAW,GACjDK,EAAO,QAAQ,sBAAwB,OAEvCW,GAAuBX,CAAM,EAC7Bc,GAAWd,EAAQL,CAAU,EAC7BsB,GAAkBjB,EAAQL,CAAU,CACxC,CAEA,SAAS4B,IAAuC,CAC5C,MAAMC,EAAgB,SAAS,eAAexC,EAAmB,EACjE,OAAKwC,GAELA,EAAc,OAAA,EAEP,IAJoB,EAK/B,CAEA,eAAsBC,EAClBC,EAAmB,SACH,CAEhB,GADI,OAAO,OAAW,KAAe,OAAO,SAAa,KACrD,CAACpC,EAAA,EAAkB,MAAO,GAE9B,IAAIqC,EAAUJ,GAAA,EAEd,OAAAG,EAAK,iBAAoC,QAAQ,EAAE,QAAS1B,GAAW,CACnE,MAAML,EAAaI,GAAwBC,CAAM,EAC5CL,IAEL2B,GAAWtB,EAAQL,CAAU,EAC7BgC,EAAU,GACd,CAAC,EAEMA,CACX,CAEA,SAASC,IAAkB,CACnBxC,IACJA,EAAa,GAEb,OAAO,WAAW,IAAM,CACpBA,EAAa,GACRqC,EAAA,CACT,EAAG,CAAC,EACR,CAEA,SAASI,IAAoB,CACrB1C,IAAe,OAEnB,OAAO,cAAcA,CAAU,EAC/BA,EAAa,KACjB,CAEA,SAAS2C,GAAkB,CACvB,GAAI,CAACxC,IAAkB,OAEvBuC,GAAA,EACKJ,EAAA,EAEL,IAAIM,EAAW,EACf5C,EAAa,OAAO,YAAY,IAAM,CAClC4C,GAAY,EACPN,EAAA,EAEDM,GAAYhD,IACZ8C,GAAA,CAER,EAAG/C,EAAsB,EAEzB,MAAMvC,EAAO,SAAS,KAClBA,EAAKsC,EAAa,IACtBtC,EAAKsC,EAAa,EAAI,GAEtBK,GAAW,IAAI,iBAAiB,IAAM0C,IAAW,EACjD1C,GAAS,QAAQ,SAAS,KAAM,CAAE,UAAW,GAAM,QAAS,GAAM,cAAe,EAAA,CAAM,EAC3F,CAEA,SAAS8C,IAAsB,CACvB1C,EAAA,GAAkBwC,EAAA,CAC1B,CAEO,SAASG,IAAuC,CACnD,GAAI,OAAO,OAAW,KAAe,OAAO,SAAa,IAAa,OACtE,MAAM9E,EAAIkC,GAAA,EACV,GAAIlC,EAAEwB,EAAI,EAAG,OACbxB,EAAEwB,EAAI,EAAI,GAEV,QAAQ,KAAK,IAAID,EAAS,2CAA2C,EAEjE,SAAS,aAAe,UACxB,SAAS,iBAAiB,mBAAoB,IAAMoD,EAAA,CAAW,EAE/DA,EAAA,EAGJ,MAAMI,EAAW,QAAQ,UAAU,KAAK,OAAO,EAC/C,QAAQ,UAAY,IAAIlG,IAA+C,CACnEkG,EAAS,GAAGlG,CAAI,EAChB,OAAO,WAAW,IAAMgG,GAAA,EAAiB,GAAG,CAChD,EACA,OAAO,iBAAiB,WAAY,IAAM,OAAO,WAAW,IAAMA,KAAiB,GAAG,CAAC,CAC3F,CCpdA,MAAMtD,EAAY,2BACZC,GAAO,sCACPwD,GAAS,yBAETC,GAAoB,sCAc1B,SAASC,IAA0B,CAC/B,OAAO,aAAa,QAAQ,YAAY,CAC5C,CAEA,eAAeC,GAAaC,EAA8C,CACtE,MAAMC,EAAQH,GAAA,EACd,GAAI,CAACG,EAAO,OAAO,KAEnB,GAAI,CACA,MAAMC,EAAM,MAAM,MAAM,8CAA8CF,CAAW,GAAI,CACjF,QAAS,CAAE,cAAe,UAAUC,CAAK,GAAI,OAAQ,kBAAA,CAAmB,CAC3E,EACD,OAAKC,EAAI,IACK,MAAMA,EAAI,KAAA,IACX,MAAM,SAAW,KAFV,IAGxB,MAAQ,CACJ,OAAO,IACX,CACJ,CAEA,eAAeC,GAAiBH,EAAkD,CAC9E,MAAMC,EAAQH,GAAA,EACd,GAAI,CAACG,EAAO,OAAO,KAEnB,GAAI,CACA,MAAMC,EAAM,MAAM,MAAM,gBAAgB/D,CAAS,gBAAgB6D,CAAW,WAAY,CACpF,QAAS,CAAE,cAAe,UAAUC,CAAK,GAAI,OAAQ,kBAAA,CAAmB,CAC3E,EACD,OAAKC,EAAI,GACD,MAAMA,EAAI,KAAA,EADE,IAExB,MAAQ,CACJ,OAAO,IACX,CACJ,CAEA,SAASE,GAA0BC,EAAkD,CACjF,GAAI,CAACA,EAAc,MAAO,GAE1B,MAAMC,EAAO,MAAM,KAAK,SAAS,iBAA8B,KAAK,CAAC,EACrE,UAAWtC,KAAOsC,EAAM,CACpB,MAAMC,EAAQ,MAAM,KAAKvC,EAAI,QAAQ,EAAE,OAClCwC,GAAgCA,aAAiB,aAAeA,EAAM,UAAY,MAAA,EAEvF,GAAID,EAAM,OAAS,EAAG,SAEtB,MAAM5C,EAAQ4C,EAAM,CAAC,EAAE,aAAa,KAAA,EACpC,GAAI5C,IAAU,SAAWA,IAAU,QAAUA,IAAU,QAAS,SAEhE,MAAMnI,EAAQ+K,EAAMA,EAAM,OAAS,CAAC,EACpC,OAAI/K,EAAM,aAAa,KAAA,IAAW6K,IAC9B7K,EAAM,YAAc6K,EACpB7K,EAAM,QAAQ,4BAA8B,QAEhDwI,EAAI,QAAQ,wBAA0B,OAC/B,EACX,CAEA,MAAO,EACX,CAEA,eAAeyC,GAAsBT,EAAoC,CACrE,GAAI,SAAS,eAAeJ,EAAM,EAAG,OAErC,MAAMc,EAAU,MAAMX,GAAaC,CAAW,EAE9C,GAAI,CAACU,GAAWA,EAAQ,cAAgB,gBAAkB,CAACA,EAAQ,gBAAkB,CAACA,EAAQ,QAAS,OAEvG,MAAMC,EAAU,MAAM,KAAK,SAAS,iBAAoC,uBAAuB,CAAC,EAC3F,KAAKC,GAAKA,EAAE,UAAU,SAAS,aAAa,CAAC,EAElD,GAAI,CAACD,GAAS,cAAe,OAE7B,MAAME,EAAc,MAAMV,GAAiBH,CAAW,EACtDI,GAA0BS,GAAa,4BAA4B,EAEnE,MAAMtI,EAAYoI,EAAQ,cAEpBG,EAAa,SAAS,cAAc,QAAQ,EAClDA,EAAW,GAAKlB,GAChBkB,EAAW,KAAO,SAClBA,EAAW,UAAYH,EAAQ,UAC1B,QAAQ,eAAgB,cAAc,EACtC,QAAQ,qBAAsB,oBAAoB,EACvDG,EAAW,YAAc,SAEzBA,EAAW,iBAAiB,QAAS,SAAY,CAC7CA,EAAW,SAAW,GACtBA,EAAW,YAAc,UACzB,MAAMC,EAAO,MAAMZ,GAAiBH,CAAW,EAC/Cc,EAAW,SAAW,GACtBA,EAAW,YAAc,SACzB,MAAMxM,EAAMyM,GAAM,aAAe,KAC7BzM,GACA,OAAO,KAAKA,EAAK,kBAAmB,mDAAmD,CAE/F,CAAC,EAED,MAAM0M,EAAUzI,EAAU,iBAC1BA,EAAU,aAAauI,EAAYE,CAAO,EAE1C,QAAQ,KAAK,IAAI7E,CAAS,kDAAkD,CAChF,CAEA,SAAS8E,IAAkB,CACvB,MAAMC,EAAQ,SAAS,SAAS,MAAMrB,EAAiB,EACnDqB,GACKT,GAAsBS,EAAM,CAAC,CAAC,CAE3C,CAEO,SAASC,IAA4C,CACxD,GAAI,OAAO,OAAW,IAAa,OACnC,MAAMvG,EAAI,OACV,GAAIA,EAAEwB,EAAI,EAAG,OACbxB,EAAEwB,EAAI,EAAI,GAEV,QAAQ,KAAK,IAAID,CAAS,6CAA6C,EAEvE,MAAMiF,EAAW,CAACC,EAAQ,OAAS,WAAWJ,GAAWI,CAAK,EAE1D,SAAS,aAAe,UACxB,SAAS,iBAAiB,mBAAoB,IAAMD,EAAA,CAAU,EAE9DA,EAAA,EAGJ,MAAMzB,EAAW,QAAQ,UAAU,KAAK,OAAO,EAC/C,QAAQ,UAAY,IAAIlG,IAA+C,CACnEkG,EAAS,GAAGlG,CAAI,EAChB2H,EAAA,CACJ,EACA,OAAO,iBAAiB,WAAY,IAAMA,EAAS,GAAG,CAAC,CAC3D,CCtJA,MAAMjF,EAAY,2BACZC,GAAO,sCACPkF,GAAS,yBACTC,GAAiB,wBAEjBC,GAAgB,8BAyBtB,SAASC,GAAkBzB,EAAuC,CAC9D,GAAI,CAEA,MAAM0B,EADM,OAAmC,QAC1B,SAGfX,EAFMW,OAAc,oBACP,OACC,KACpB,MAAI,CAACX,GAAQA,EAAK,eAAiBf,EAAoB,KAChDe,CACX,MAAQ,CACJ,OAAO,IACX,CACJ,CAEA,SAASjB,IAA0B,CAC/B,OAAO,aAAa,QAAQ,YAAY,CAC5C,CAEA,eAAeK,GAAiBH,EAAkD,CAC9E,MAAMC,EAAQH,GAAA,EACd,GAAI,CAACG,EAAO,OAAO,KACnB,GAAI,CACA,MAAMC,EAAM,MAAM,MAAM,gBAAgB/D,CAAS,gBAAgB6D,CAAW,WAAY,CACpF,QAAS,CAAE,cAAe,UAAUC,CAAK,GAAI,OAAQ,kBAAA,CAAmB,CAC3E,EACD,OAAKC,EAAI,GACD,MAAMA,EAAI,KAAA,EADE,IAExB,MAAQ,CACJ,OAAO,IACX,CACJ,CAEA,SAASE,GAA0B7H,EAAoB8H,EAAkD,CACrG,GAAI,CAACA,EAAc,MAAO,GAE1B,MAAMC,EAAO,MAAM,KAAK/H,EAAU,iBAA8B,KAAK,CAAC,EACtE,UAAWyF,KAAOsC,EAAM,CACpB,MAAMC,EAAQ,MAAM,KAAKvC,EAAI,QAAQ,EAAE,OAClCwC,GAAgCA,aAAiB,aAAeA,EAAM,UAAY,MAAA,EAEvF,GAAID,EAAM,OAAS,EAAG,SAEtB,MAAM5C,EAAQ4C,EAAM,CAAC,EAAE,aAAa,KAAA,EACpC,GAAI5C,IAAU,SAAWA,IAAU,QAAUA,IAAU,iBAAkB,SAEzE,MAAMnI,EAAQ+K,EAAMA,EAAM,OAAS,CAAC,EACpC,OAAI/K,EAAM,aAAa,KAAA,IAAW6K,IAC9B7K,EAAM,YAAc6K,EACpB7K,EAAM,QAAQ,4BAA8B,QAEhDwI,EAAI,QAAQ,wBAA0B,OAC/B,EACX,CAEA,MAAO,EACX,CAEA,SAAS2D,IAAuC,CAC5C,MAAMC,EAAQ,SAAS,eAAe,0BAA0B,EAChE,GAAIA,EACA,OAAO,MAAM,KAAKA,EAAM,QAAQ,EAAE,KAAK7J,GAAMA,EAAG,WAAW,SAAS,SAAS,CAAC,GAAK6J,EAGvF,MAAMC,EAAK,MAAM,KAAK,SAAS,iBAA8B,IAAI,CAAC,EAAE,KAChE9J,GAAMA,EAAG,aAAa,SAAS,OAAO,CAAA,EAE1C,GAAI,CAAC8J,EAAI,OAAO,KAEhB,MAAMC,EAAWD,EAAG,eAAe,cACnC,OAAKC,EAEE,MAAM,KAAKA,EAAS,QAAQ,EAAE,KAAK/J,GAAMA,EAAG,WAAW,SAAS,SAAS,CAAC,GAAK+J,EAFhE,IAG1B,CAEA,SAASC,GAAgB/B,EAAkC,CACvD,MAAMhC,EAAM,SAAS,cAAc,KAAK,EACxCA,EAAI,GAAKsD,GACTtD,EAAI,UAAY,oCAEhB,MAAML,EAAQ,SAAS,cAAc,MAAM,EAC3CA,EAAM,UAAY,2CAClBA,EAAM,YAAc,MAEpB,MAAMnF,EAAM,SAAS,cAAc,QAAQ,EAC3C,OAAAA,EAAI,KAAO,SACXA,EAAI,UACA,8GACJA,EAAI,YAAc,SAElBA,EAAI,iBAAiB,QAAS,SAAY,CACtCA,EAAI,SAAW,GACfA,EAAI,YAAc,UAClB,MAAMuI,EAAO,MAAMZ,GAAiBH,CAAW,EAC/CxH,EAAI,SAAW,GACfA,EAAI,YAAc,SAClB,MAAMlE,EAAMyM,GAAM,aAAe,KAC7BzM,GACA,OAAO,KAAKA,EAAK,kBAAmB,mDAAmD,CAE/F,CAAC,EAED0J,EAAI,YAAYL,CAAK,EACrBK,EAAI,YAAYxF,CAAG,EACZwF,CACX,CAEA,SAASgE,GAAiBC,EAAwC,CAC9D,GAAI,CAACA,EAAK,MAAO,GACjB,GAAI,CACA,MAAMC,EAAI,IAAI,KAAKD,CAAG,EACtB,GAAI,OAAO,MAAMC,EAAE,QAAA,CAAS,EAAG,OAAOD,EACtC,MAAME,EAAOC,GAAc,OAAOA,CAAC,EAAE,SAAS,EAAG,GAAG,EACpD,MAAO,GAAGF,EAAE,YAAA,CAAa,IAAIC,EAAID,EAAE,SAAA,EAAa,CAAC,CAAC,IAAIC,EAAID,EAAE,SAAS,CAAC,IAAIC,EAAID,EAAE,SAAA,CAAU,CAAC,IAAIC,EAAID,EAAE,WAAA,CAAY,CAAC,IAAIC,EAAID,EAAE,WAAA,CAAY,CAAC,EAC7I,MAAQ,CACJ,OAAOD,CACX,CACJ,CAEA,SAASI,EAAc1E,EAAenI,EAAe8M,EAAa,4CAA0D,CACxH,MAAMtE,EAAM,SAAS,cAAc,KAAK,EACxCA,EAAI,UAAY,+BAChB,MAAMuE,EAAI,SAAS,cAAc,MAAM,EACvCA,EAAE,UAAY,mCACdA,EAAE,YAAc5E,EAChB,MAAMzD,EAAI,SAAS,cAAc,MAAM,EACvC,OAAAA,EAAE,UAAYoI,EACdpI,EAAE,YAAc1E,EAChBwI,EAAI,YAAYuE,CAAC,EACjBvE,EAAI,YAAY9D,CAAC,EACV8D,CACX,CAEA,SAASwE,GAAgBjI,EAAmC,CACxD,MAAMlC,EAAIkC,EAAU,SAAW,CAAA,EACzBkI,EAAO,SAAS,cAAc,KAAK,EACzCA,EAAK,GAAKlB,GACVkB,EAAK,UAAY,0DAEjB,MAAMC,EAAQ,SAAS,cAAc,KAAK,EAC1CA,EAAM,UAAY,4FAElB,MAAMC,EAAQ,SAAS,cAAc,IAAI,EACzCA,EAAM,UAAY,8DAClBA,EAAM,YAAc,aAEpB,MAAMrC,EAAO,SAAS,cAAc,KAAK,EACzCA,EAAK,UAAY,YACjBA,EAAK,YAAY+B,EAAc,KAAMhK,EAAE,YAAc,EAAE,CAAC,EACxDiI,EAAK,YAAY+B,EAAc,OAAQhK,EAAE,cAAgB,GAAI,qDAAqD,CAAC,EACnHiI,EAAK,YAAY+B,EAAc,MAAOhK,EAAE,cAAgB,EAAE,CAAC,EAC3DiI,EAAK,YAAY+B,EAAc,QAAS9H,EAAU,wBAA0B,GAAI,4CAA4C,CAAC,EAE7H,MAAMqI,EAASvK,EAAE,aACjB,GAAIuK,EAAQ,CACR,MAAMC,EAAS,SAAS,cAAc,KAAK,EAC3CA,EAAO,UAAY,uFACnB,MAAMC,EAAW,SAAS,cAAc,MAAM,EAC9CA,EAAS,UAAY,mCACrBA,EAAS,YAAc,QACvB,MAAMC,EAAW,SAAS,cAAc,MAAM,EAC9CA,EAAS,UAAY,6CACrBA,EAAS,YAAcf,GAAiBY,CAAM,EAC9CC,EAAO,YAAYC,CAAQ,EAC3BD,EAAO,YAAYE,CAAQ,EAC3BzC,EAAK,YAAYuC,CAAM,CAC3B,CAKA,GAHAH,EAAM,YAAYC,CAAK,EACvBD,EAAM,YAAYpC,CAAI,EAElB,CAACjI,EAAE,QAAS,CACZ,MAAM2K,EAAS,SAAS,cAAc,GAAG,EACzCA,EAAO,UAAY,gDACnBA,EAAO,YAAc,sCACrBN,EAAM,YAAYM,CAAM,CAC5B,CAEA,OAAAP,EAAK,YAAYC,CAAK,EACfD,CACX,CAEA,eAAexB,GAAUjB,EAAuC,CAC5D,MAAMzF,EAAYkH,GAAkBzB,CAAW,EAC/C,GAAI,CAACzF,EAAW,MAAO,GAEvB,KAAM,CAAE,QAAAmG,GAAYnG,EACpB,GAAI,CAACmG,GAAWA,EAAQ,cAAgB,eAAgB,MAAO,GAE/D,MAAMnI,EAAYoJ,GAAA,EAClB,GAAI,CAACpJ,EAAW,MAAO,GACvB,MAAMsI,EAAc,MAAMV,GAAiBH,CAAW,EAatD,OAZAI,GAA0B7H,EAAWsI,GAAa,4BAA4B,EAG1EH,EAAQ,iBAAmB,SAAWA,EAAQ,cAAgB,CAAC,SAAS,eAAea,EAAc,IACrGhJ,EAAU,YAAYiK,GAAgBjI,CAAS,CAAC,EAChD,QAAQ,KAAK,IAAI4B,CAAS,4CAA4C,GAGtE,CAACuE,EAAQ,gBAET,CAACA,EAAQ,SAET,SAAS,eAAeY,EAAM,IAElC/I,EAAU,YAAYwJ,GAAgB/B,CAAW,CAAC,EAClD,QAAQ,KAAK,IAAI7D,CAAS,gDAAgD,GACnE,EACX,CAEA,SAAS8G,GAAajD,EAA2B,CAC7C,IAAIR,EAAW,EACf,MAAMjC,EAAK,YAAY,IAAM,CACzBiC,IACKyB,GAAUjB,CAAW,EAAE,KAAKkD,GAAQ,EACjCA,GAAQ1D,GAAY,KAAI,cAAcjC,CAAE,CAChD,CAAC,CACL,EAAG,GAAG,CACV,CAEA,SAASkC,IAAsB,CAC3B,MAAMyB,EAAQ,SAAS,SAAS,MAAMM,EAAa,EAC/CN,GAAO+B,GAAa/B,EAAM,CAAC,CAAC,CACpC,CAEO,SAASiC,IAAuC,CACnD,GAAI,OAAO,OAAW,IAAa,OACnC,MAAMvI,EAAI,OACV,GAAIA,EAAEwB,EAAI,EAAG,OACbxB,EAAEwB,EAAI,EAAI,GAEV,QAAQ,KAAK,IAAID,CAAS,wCAAwC,EAElE,MAAMiF,EAAW,CAACC,EAAQ,OAAS,WAAW5B,GAAe4B,CAAK,EAE9D,SAAS,aAAe,UACxB,SAAS,iBAAiB,mBAAoB,IAAMD,EAAA,CAAU,EAE9DA,EAAA,EAGJ,MAAMzB,EAAW,QAAQ,UAAU,KAAK,OAAO,EAC/C,QAAQ,UAAY,IAAIlG,IAA+C,CACnEkG,EAAS,GAAGlG,CAAI,EAChB2H,EAAS,GAAG,CAChB,EACA,OAAO,iBAAiB,WAAY,IAAMA,EAAS,GAAG,CAAC,CAC3D,CCrRA,MAAMjF,GAAY,2BACZC,GAAO,oDACPE,GAAgB,uDAChB8G,GAAoB,oCACpBC,GAAgB,iDAChB9G,GAAyB,IACzBC,GAAsB,IAUtB8G,GAAiE,CACnE,CACI,GAAI,mBACJ,OAAQ,CAAC,kBAAmB,sBAAuB,2BAA4B,mCAAmC,EAClH,YAAa,CAAA,EACb,UAAW,CAAC,GAAG,EACf,cAAe,yBAAA,EAEnB,CACI,GAAI,mBACJ,OAAQ,CAAC,kBAAmB,sBAAuB,2BAA4B,mCAAmC,EAClH,YAAa,CAAA,EACb,UAAW,CAAC,GAAG,EACf,cAAe,6BAAA,EAEnB,CACI,GAAI,qBACJ,OAAQ,CAAC,iBAAkB,qBAAsB,6BAA8B,qCAAqC,EACpH,YAAa,CAAA,EACb,UAAW,CAAC,GAAG,EACf,cAAe,wBAAA,EAEnB,CACI,GAAI,mBACJ,OAAQ,CAAC,iBAAkB,qBAAsB,2BAA4B,mCAAmC,EAChH,YAAa,CAAA,EACb,UAAW,CAAC,GAAG,EACf,cAAe,wBAAA,EAEnB,CACI,GAAI,gBACJ,OAAQ,CAAC,kBAAmB,sBAAuB,uBAAwB,+BAA+B,EAC1G,YAAa,CAAA,EACb,UAAW,CAAC,GAAG,EACf,cAAe,uBAAA,EAEnB,CACI,GAAI,gBACJ,OAAQ,CAAC,kBAAmB,sBAAuB,uBAAwB,+BAA+B,EAC1G,YAAa,CAAA,EACb,UAAW,CAAC,IAAI,EAChB,cAAe,0BAAA,EAEnB,CACI,GAAI,iBACJ,OAAQ,CAAC,kBAAmB,sBAAuB,yBAA0B,iCAAiC,EAC9G,YAAa,CAAA,EACb,UAAW,CAAC,KAAK,EACjB,cAAe,uBAAA,EAEnB,CACI,GAAI,eACJ,OAAQ,CAAC,kBAAmB,sBAAuB,uBAAwB,+BAA+B,EAC1G,YAAa,CAAA,EACb,UAAW,CAAC,GAAG,EACf,cAAe,0BAAA,CAEvB,EAEA,IAAI3G,GAAoC,KACpCC,EAA4B,KAC5BC,EAAa,GAEjB,SAASC,IAAwC,CAC7C,OAAO,MACX,CAEA,SAASyG,GAA+B,CACpC,GAAI,CAACH,GAAkB,KAAK,OAAO,SAAS,QAAQ,EAAG,MAAO,GAE9D,MAAMI,EAAM,IAAI,gBAAgB,OAAO,SAAS,MAAM,EAAE,IAAI,KAAK,EACjE,OAAOA,IAAQ,MAAQA,IAAQ,IAAMA,IAAQ,gBACjD,CAEA,SAASC,GAAYpF,EAA0B,CAC3C,OAAOA,aAAmB,YAAcA,EAAQ,UAAY,EAChE,CAEA,SAASpB,GAAezH,EAA0C,CAC9D,OAAQA,GAAS,IACZ,QAAQ,UAAW,EAAE,EACrB,QAAQ,OAAQ,GAAG,EACnB,KAAA,CACT,CAEA,SAASkO,GAAoBrF,EAA+B,CACxD,MAAMsF,EAAYF,GAAYpF,CAAO,EAErC,OAAOsF,EAAU,SAAS,YAAY,GAC9BA,EAAU,SAAS,aAAa,GAAKA,EAAU,SAAS,QAAQ,GAAKA,EAAU,SAAS,OAAO,CAC3G,CAEA,SAASC,GAAiBC,EAAuC,CAC7D,OAAOA,EAAK,cAA2B,cAAc,CACzD,CAEA,SAASC,GAAsBD,EAAuD,CAClF,MAAMlB,EAAQ1F,GAAe2G,GAAiBC,CAAI,GAAG,WAAW,EAC1D3I,EAAO+B,GAAe4G,EAAK,WAAW,EAE5C,OAAOP,GAAgC,KAAMlG,GACzCA,EAAW,YAAY,KAAMO,GAAUgF,IAAUhF,CAAK,GACnDP,EAAW,OAAO,KAAMO,GAAUzC,EAAK,SAASyC,CAAK,CAAC,CAC5D,GAAK,IACV,CAEA,SAASoG,GAAuB5E,EAAiC,CAC7D,OAAO,MAAM,KAAKA,EAAK,iBAA8B,KAAK,CAAC,EACtD,OAAOuE,EAAmB,CACnC,CAEA,SAASpF,GAAgBuF,EAAmC,CAGxD,OAFc,MAAM,KAAKA,EAAK,iBAA0B,qBAAqB,CAAC,EAEjE,KAAMxF,GACf,CAACA,EAAQ,QAAQ,oBAAoB,GAClC,CAACA,EAAQ,QAAQgF,EAAa,GAC9B,CAAChF,EAAQ,QAAQ,+DAA+D,CACtF,GAAK,IACV,CAEA,SAAS2F,GAAsB7F,EAAuBf,EAA+C,CACjGe,EAAK,QAAQ,6BAA+B,OAC5CA,EAAK,QAAQ,0BAA4Bf,EAAW,GACpDe,EAAK,aAAa,cAAe,MAAM,EACvCA,EAAK,UAAY,gEAAgEf,EAAW,aAAa,GACzGe,EAAK,MAAM,MAAQ,OACnBA,EAAK,MAAM,OAAS,OACpBA,EAAK,MAAM,KAAO,WAClBA,EAAK,MAAM,WAAa,IACxBA,EAAK,MAAM,SAAWf,EAAW,UAAU,KAAK,EAAE,EAAE,OAAS,EAAI,MAAQ,OAEzE,MAAM6G,EAAe7G,EAAW,UAAU,KAAK,EAAE,EAC7Ce,EAAK,cAAgB8F,IACrB9F,EAAK,YAAcf,EAAW,UAAU,CAAC,GAAK,GAEtD,CAEA,SAAS8G,GAAgB9G,EAA0D,CAC/E,MAAMe,EAAO,SAAS,cAAc,MAAM,EAC1C,OAAA6F,GAAsB7F,EAAMf,CAAU,EAE/Be,CACX,CAEA,SAASgG,GAAcN,EAAmBzG,EAAkD,CACxF,MAAMgH,EAAWP,EAAK,cAA2BR,EAAa,EAC9D,GAAIe,aAAoB,gBACpB,OAAAP,EAAK,QAAQ,0BAA4BzG,EAAW,GACpD4G,GAAsBI,EAAUhH,CAAU,EACnC,GAGX,MAAMe,EAAO+F,GAAgB9G,CAAU,EACjCqB,EAAOH,GAAgBuF,CAAI,EACjC,GAAIpF,GAAQA,EAAK,cACb,OAAAoF,EAAK,QAAQ,0BAA4BzG,EAAW,GACpDqB,EAAK,YAAYN,CAAI,EACd,GAGX,MAAMwE,EAAQiB,GAAiBC,CAAI,EACnC,OAAIlB,GAASA,EAAM,eACfkB,EAAK,QAAQ,0BAA4BzG,EAAW,GACpDuF,EAAM,cAAc,aAAaxE,EAAMwE,CAAK,EACrC,IAGJ,EACX,CAEO,SAAS0B,EAAqClF,EAAmB,SAAmB,CAEvF,GADI,OAAO,OAAW,KAAe,OAAO,SAAa,KACrD,CAACoE,EAAA,EAAuB,MAAO,GAEnC,IAAIe,EAAU,GAEd,OAAAP,GAAuB5E,CAAI,EAAE,QAAS0E,GAAS,CAC3C,MAAMzG,EAAa0G,GAAsBD,CAAI,EACxCzG,GAED+G,GAAcN,EAAMzG,CAAU,IAC9BkH,EAAU,GAElB,CAAC,EAEMA,CACX,CAEA,SAASjF,IAAkB,CACnBxC,IACJA,EAAa,GAEb,OAAO,WAAW,IAAM,CACpBA,EAAa,GACbwH,EAAA,CACJ,EAAG,CAAC,EACR,CAEA,SAAS/E,GAAoB,CACrB1C,IAAe,OAEnB,OAAO,cAAcA,CAAU,EAC/BA,EAAa,KACjB,CAEA,SAAS2C,GAAkB,CACvB,GAAI,CAACgE,IAAuB,OAE5BjE,EAAA,EACA+E,EAAA,EAEA,IAAI7E,EAAW,EACf5C,EAAa,OAAO,YAAY,IAAM,CAClC4C,GAAY,EACZ6E,EAAA,EAEI7E,GAAYhD,IACZ8C,EAAA,CAER,EAAG/C,EAAsB,EAEzB,MAAMvC,EAAO,SAAS,KAClBA,EAAKsC,EAAa,IACtBtC,EAAKsC,EAAa,EAAI,GAEtBK,GAAW,IAAI,iBAAiB,IAAM0C,IAAW,EACjD1C,GAAS,QAAQ,SAAS,KAAM,CAAE,UAAW,GAAM,QAAS,GAAM,cAAe,EAAA,CAAM,EAC3F,CAEA,SAAS8C,IAAsB,CAC3B,GAAI8D,IAAuB,CACvBhE,EAAA,EACA,MACJ,CAEAD,EAAA,CACJ,CAEO,SAASiF,IAA+C,CAC3D,GAAI,OAAO,OAAW,KAAe,OAAO,SAAa,IAAa,OACtE,MAAM3J,EAAIkC,GAAA,EACV,GAAIlC,EAAEwB,EAAI,EAAG,OACbxB,EAAEwB,EAAI,EAAI,GAEV,QAAQ,KAAK,IAAID,EAAS,6CAA6C,EAEnE,SAAS,aAAe,UACxB,SAAS,iBAAiB,mBAAoB,IAAMoD,EAAA,CAAW,EAE/DA,EAAA,EAGJ,MAAMI,EAAW,QAAQ,UAAU,KAAK,OAAO,EAC/C,QAAQ,UAAY,IAAIlG,IAA+C,CACnEkG,EAAS,GAAGlG,CAAI,EAChB,OAAO,WAAW,IAAMgG,GAAA,EAAiB,GAAG,CAChD,EACA,OAAO,iBAAiB,WAAY,IAAM,OAAO,WAAW,IAAMA,KAAiB,GAAG,CAAC,CAC3F,CCnRA,MAAMtD,EAAY,2BACZC,GAAO,gDAEPoI,GAAsB,wCAQ5B,SAAS1E,IAA0B,CAC/B,OAAO,aAAa,QAAQ,YAAY,CAC5C,CAEA,eAAe2E,GAA4BzE,EAA6D,CACpG,MAAMC,EAAQH,GAAA,EACd,GAAI,CAACG,EAAO,OAAO,KAEnB,GAAI,CACA,MAAMC,EAAM,MAAM,MAAM,gBAAgB/D,CAAS,iBAAiB6D,CAAW,sBAAuB,CAChG,QAAS,CAAE,cAAe,UAAUC,CAAK,GAAI,OAAQ,kBAAA,CAAmB,CAC3E,EACD,GAAI,CAACC,EAAI,GAAI,OAAO,KAEpB,MAAMwE,EAAQ,MAAMxE,EAAI,KAAA,EACxB,OAAQ,SAAUwE,EAAOA,EAAK,KAAOA,IAAS,IAClD,MAAQ,CACJ,OAAO,IACX,CACJ,CAEA,SAASC,GAAsB5M,EAA4B,CACvD,OAAO,MAAM,KAAKA,EAAG,QAAQ,EAAE,OAC1ByI,GAAgCA,aAAiB,WAAA,CAE1D,CAEA,SAASoE,GAA0BzF,EAAekB,EAA+B,CAC7E,IAAIwE,EAAU,GAEd,MAAMvE,EAAO,MAAM,KAAKnB,EAAK,iBAA8B,KAAK,CAAC,EACjE,UAAWnB,KAAOsC,EAAM,CACpB,MAAMwE,EAAWH,GAAsB3G,CAAG,EACpC+G,EAAaD,EAAS,UAAUtE,GAASA,EAAM,aAAa,KAAA,IAAW,MAAM,EACnF,GAAIuE,EAAa,EAAG,SAEpB,MAAMvP,EAAQsP,EACT,MAAMC,EAAa,CAAC,EACpB,KAAKvE,GAASA,EAAM,aAAa,QAAUA,EAAM,YAAY,KAAA,IAAW,MAAM,EACnF,GAAI,CAAChL,EAAO,SAEZ,MAAMwP,EAAcF,EACf,MAAMC,EAAa,CAAC,EACpB,KAAKvE,GAAS,WAAW,KAAKA,EAAM,aAAa,KAAA,GAAU,EAAE,CAAC,EAC7DyE,EAAkBD,GAAa,aAAa,KAAA,EAAO,QAAQ,WAAY,EAAE,GAAK,GAC9EE,EAAmBD,GAAmB5E,EAAa,SAAS,GAAG,EAC/DA,EAAa,QAAQ,MAAO,KAAK4E,CAAe,GAAG,EACnD5E,EAEF7K,EAAM,aAAa,KAAA,IAAW0P,IAC9B1P,EAAM,YAAc0P,EACpB1P,EAAM,QAAQ,4BAA8B,QAEhDwI,EAAI,QAAQ,wBAA0B,cAClCgH,GAAeC,IACfD,EAAY,YAAc,GAC1BA,EAAY,MAAM,QAAU,OAC5BA,EAAY,QAAQ,gCAAkC,QAE1DH,EAAU,EACd,CAEA,OAAOA,CACX,CAEA,SAASM,GAAwBhG,EAAeiG,EAAmBC,EAAgC,CAK/F,MAAMC,EAJa,MAAM,KAAKnG,EAAK,iBAA8B,MAAM,CAAC,EAAE,OACtEpH,GAAMA,EAAG,aAAa,KAAA,IAAWqN,CAAA,EAGZ,KAAKrN,GAAM,CAChC,MAAM4L,EAAY,OAAO5L,EAAG,WAAc,SAAWA,EAAG,UAAY,GACpE,OAAO4L,EAAU,SAAS,cAAc,GAAKA,EAAU,SAAS,aAAa,CACjF,CAAC,EAED,OAAK2B,GAELA,EAAM,YAAcD,EACpBC,EAAM,QAAQ,4BAA8B,OAC5CA,EAAM,QAAQ,0BAA4B,cACnC,IALY,EAMvB,CAEO,SAASC,GACZpG,EACAqG,EACO,CACP,MAAMnF,EAAemF,GAAQ,kBACvBH,EAAgBG,GAAQ,4BACxBJ,EAAYI,GAAQ,uBAE1B,GAAI,CAACnF,GAAgB,CAACgF,EAAe,MAAO,GAE5C,MAAMI,EAAUb,GAA0BzF,EAAMkB,CAAY,EACtDiF,EAAQF,EAAYD,GAAwBhG,EAAMiG,EAAWC,CAAa,EAAI,GAEpF,OAAOI,GAAWH,CACtB,CAEA,eAAerE,GAAUjB,EAAuC,CAC5D,MAAMb,EAAO,SAAS,eAAe,sBAAsB,GAAK,SAAS,eAAe,mBAAmB,EAC3G,GAAI,CAACA,EAAM,MAAO,GAElB,MAAMqG,EAAS,MAAMf,GAA4BzE,CAAW,EAC5D,OAAKwF,GAEWD,GAA+BpG,EAAMqG,CAAM,GAEvD,QAAQ,KAAK,IAAIrJ,CAAS,wDAAwD,EAG/E,EACX,CAEA,SAAS8G,GAAajD,EAA2B,CAC7C,IAAIR,EAAW,EACf,MAAMjC,EAAK,YAAY,IAAM,CACzBiC,IACKyB,GAAUjB,CAAW,EAAE,KAAKkD,GAAQ,EACjCA,GAAQ1D,GAAY,KAAI,cAAcjC,CAAE,CAChD,CAAC,CACL,EAAG,GAAG,CACV,CAEA,SAASkC,IAAsB,CAC3B,MAAMyB,EAAQ,SAAS,SAAS,MAAMsD,EAAmB,EACrDtD,GAAO+B,GAAa/B,EAAM,CAAC,CAAC,CACpC,CAEO,SAASwE,IAAgD,CAC5D,GAAI,OAAO,OAAW,IAAa,OACnC,MAAM9K,EAAI,OACV,GAAIA,EAAEwB,EAAI,EAAG,OACbxB,EAAEwB,EAAI,EAAI,GAEV,QAAQ,KAAK,IAAID,CAAS,kDAAkD,EAE5E,MAAMiF,EAAW,CAACC,EAAQ,OAAS,WAAW5B,GAAe4B,CAAK,EAE9D,SAAS,aAAe,UACxB,SAAS,iBAAiB,mBAAoB,IAAMD,EAAA,CAAU,EAE9DA,EAAA,EAGJ,MAAMzB,EAAW,QAAQ,UAAU,KAAK,OAAO,EAC/C,QAAQ,UAAY,IAAIlG,IAA+C,CACnEkG,EAAS,GAAGlG,CAAI,EAChB2H,EAAS,GAAG,CAChB,EACA,OAAO,iBAAiB,WAAY,IAAMA,EAAS,GAAG,CAAC,CAC3D,CCzJA,MAAMjI,EAAoB,2BAEpBK,EAAS,CACX,KAAM,IAAIC,IAAoB,QAAQ,KAAK,IAAIN,CAAiB,IAAK,GAAGM,CAAI,EAC5E,KAAM,IAAIA,IAAoB,QAAQ,KAAK,IAAIN,CAAiB,IAAK,GAAGM,CAAI,EAC5E,MAAO,IAAIA,IAAoB,QAAQ,MAAM,IAAIN,CAAiB,IAAK,GAAGM,CAAI,CAClF,EAEA,SAASkM,IAA2B,CAChC,MAAMC,EAAU,OAAmC,OAEnD,GAAI,CAACA,EACD,MAAO,GAGX,MAAMC,EAAgBD,EAAO,oBAE7B,GAAI,OAAOC,GAAkB,WACzB,MAAO,GAGX,MAAMC,EAAaD,EAAA,EAEnB,GAAI,CAACC,GAAc,OAAOA,EAAW,iBAAoB,WACrD,MAAO,GAGX,IAAIC,EAAQ,EACZ,SAAW,CAACxQ,EAAMyQ,CAAO,IAAK,OAAO,QAAQhN,EAAU,EAAG,CACtD,MAAMiN,EAAW,GAAG9M,CAAiB,IAAI5D,CAAI,GAC7CuQ,EAAW,gBAAgBG,EAAUD,EAAS,CAC1C,SAAU,SACV,OAAQ7M,CAAA,CACX,EACD4M,GACJ,CAEA,OAAOA,CACX,CAEA,SAASG,IAAmB,CAExBvL,GAAA,EACA+E,GAAA,EACAyB,GAAA,EACAgC,GAAA,EACAoB,GAAA,EACAmB,GAAA,EAEA,MAAMS,EAAS,IAAM,CACjB,MAAMJ,EAAQJ,GAAA,EAEd,GAAII,EAAQ,EAAG,CACXvM,EAAO,KAAK,GAAGuM,CAAK,wBAAwB,EAC5ClN,EAAA,EACA,MACJ,CAEA,IAAIoD,EAAU,EACd,MAAMmK,EAAa,GACbC,EAAW,YAAY,IAAM,CAC/BpK,IACA,MAAMqK,EAASX,GAAA,EAEf,GAAIW,EAAS,EAAG,CACZ,cAAcD,CAAQ,EACtB7M,EAAO,KAAK,GAAG8M,CAAM,iCAAiCrK,CAAO,WAAW,EACxEpD,EAAA,EACA,MACJ,CAEIoD,GAAWmK,IACX,cAAcC,CAAQ,EACtB7M,EAAO,KAAK,8CAA8C,EAElE,EAAG,GAAG,CACV,EAEI,SAAS,aAAe,UACxB,SAAS,iBAAiB,mBAAoB2M,CAAM,EAEpDA,EAAA,CAER,CAEAD,GAAA,EAEC,OAAmC,sBAAwB,CACxD,WAAY/M,EACZ,SAAU,OAAO,KAAKH,EAAU,EAChC,WAAAkN,EACJ"}
\ No newline at end of file
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/editor-spec.json b/plugins/_bundled/sirsoft-pay_nicepayments/editor-spec.json
new file mode 100644
index 00000000..9e63b7a4
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/editor-spec.json
@@ -0,0 +1,62 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$comment": "레이아웃 편집기 스펙 — 나이스페이먼츠 결제 플러그인 도메인 sampleData. plugin_settings 의 플러그인 고유 ID(vbank_info) 응답 shape 를 실제 바인딩(vbank_info.data.{notify_url,guide_steps,...}) 역추론. 공통 ID 'settings' 는 admin 템플릿 sampleData 가 커버(전역 고유 ID 병합)하므로 미포함.",
+    "pluginId": "sirsoft-pay_nicepayments",
+    "version": "1.0.0",
+    "description": "나이스페이먼츠 결제 플러그인 레이아웃 편집기 샘플 데이터 (가상계좌 입금통보 URL).",
+    "sampleData": {
+        "byDataSourceId": {
+            "vbank_info": {
+                "data": {
+                    "title": "가상계좌 입금통보 URL",
+                    "description": "아래 URL 을 PG 관리자에 등록하면 입금 완료 시 자동으로 주문이 처리됩니다.",
+                    "notify_url": "https://example.com/api/plugins/sirsoft-pay_nicepayments/vbank/notify",
+                    "copyable": true,
+                    "guide_url": "https://example.com/docs/vbank",
+                    "guide_steps": [
+                        "PG 관리자 페이지에 로그인합니다.",
+                        "가상계좌 입금통보 URL 설정 메뉴로 이동합니다.",
+                        "위 URL 을 붙여넣고 저장합니다."
+                    ]
+                }
+            }
+        }
+    },
+    "states": {
+        "comment": "플러그인 설정 변종.",
+        "groups": [
+            {
+                "comment": "결제/인증 플러그인 설정. _local.form.is_test_mode 로 운영모드 경고(live_mode_warning)를 if 분기한다.",
+                "scope": {
+                    "kind": "route",
+                    "match": "*/admin/plugins/sirsoft-pay_nicepayments/settings"
+                },
+                "items": [
+                    {
+                        "id": "test_mode_on",
+                        "label": "$t:editor.state.test_mode_on",
+                        "default": true,
+                        "initialState": {
+                            "local": {
+                                "form": {
+                                    "is_test_mode": true
+                                }
+                            }
+                        }
+                    },
+                    {
+                        "id": "test_mode_off",
+                        "label": "$t:editor.state.test_mode_off",
+                        "initialState": {
+                            "local": {
+                                "form": {
+                                    "is_test_mode": false
+                                }
+                            }
+                        }
+                    }
+                ]
+            }
+        ]
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/lang/en/activity_log.php b/plugins/_bundled/sirsoft-pay_nicepayments/lang/en/activity_log.php
new file mode 100644
index 00000000..3652135f
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/lang/en/activity_log.php
@@ -0,0 +1,10 @@
+<?php
+
+return [
+    'action' => [
+        'cancel' => 'PG Payment Cancellation',
+    ],
+    'description' => [
+        'payment_cancel' => 'NicePayments confirmed payment cancellation (order :order_number, refunded :refund_amount KRW).',
+    ],
+];
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/lang/en/messages.php b/plugins/_bundled/sirsoft-pay_nicepayments/lang/en/messages.php
new file mode 100644
index 00000000..abbc4c5b
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/lang/en/messages.php
@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+return [
+    'errors' => [
+        'tid_required' => 'Please enter the TID.',
+        'order_not_found' => 'Order not found.',
+        'invalid_request' => 'Invalid request.',
+        'invalid_amount' => 'The requested amount is invalid.',
+        'vbank_refund_required_fields' => 'Please provide all required fields: TID, order number, cancel amount, and refund account information (account number, bank code, account holder).',
+        'vbank_refund_order_not_found' => 'The order to refund could not be found.',
+        'vbank_refund_invalid_payment' => 'This is not a refundable completed NicePayments virtual-account payment.',
+        'vbank_refund_amount_mismatch' => 'The requested refund amount does not match the cancellable amount in the database.',
+        'vbank_refund_already_processing' => 'A virtual-account refund is already being processed.',
+        'vbank_completed_requires_bank_info' => 'Refund account information is required for completed virtual account deposits. Please process the refund through the admin API.',
+        'invalid_refund_amount' => 'The refund amount is invalid. (requested: :amount KRW)',
+    ],
+    'refund' => [
+        'missing_tid' => 'Cannot process refund: transaction ID (TID) is missing.',
+        'default_reason' => 'Buyer refund request',
+    ],
+    'defaults' => [
+        'vbank_refund_msg' => 'Virtual account refund',
+    ],
+];
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/lang/en/payment_methods.php b/plugins/_bundled/sirsoft-pay_nicepayments/lang/en/payment_methods.php
new file mode 100644
index 00000000..6f83bb4c
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/lang/en/payment_methods.php
@@ -0,0 +1,36 @@
+<?php
+
+return [
+    'naverpay' => [
+        'name' => 'Naver' . "\u{200B}" . ' Pay (NicePayments)',
+        'description' => 'Pay with Naver' . "\u{200B}" . ' Pay (NicePayments)',
+    ],
+    'kakaopay' => [
+        'name' => 'Kakao' . "\u{200B}" . ' Pay (NicePayments)',
+        'description' => 'Pay with Kakao' . "\u{200B}" . ' Pay (NicePayments)',
+    ],
+    'samsungpay' => [
+        'name' => 'Samsung' . "\u{200B}" . ' Pay (NicePayments)',
+        'description' => 'Pay with Samsung' . "\u{200B}" . ' Pay (NicePayments)',
+    ],
+    'applepay' => [
+        'name' => 'Apple Pay (NicePayments)',
+        'description' => 'Pay with Apple Pay (NicePayments)',
+    ],
+    'payco' => [
+        'name' => 'PAYCO (NicePayments)',
+        'description' => 'Pay with PAYCO (NicePayments)',
+    ],
+    'skpay' => [
+        'name' => '11pay (NicePayments)',
+        'description' => 'Pay with 11pay (NicePayments)',
+    ],
+    'ssgpay' => [
+        'name' => 'SSG Pay (NicePayments)',
+        'description' => 'Pay with SSG Pay (NicePayments)',
+    ],
+    'lpay' => [
+        'name' => 'L.' . "\u{200B}" . 'pay (NicePayments)',
+        'description' => 'Pay with L.' . "\u{200B}" . 'pay (NicePayments)',
+    ],
+];
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/lang/en/provider.php b/plugins/_bundled/sirsoft-pay_nicepayments/lang/en/provider.php
new file mode 100644
index 00000000..ecce079c
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/lang/en/provider.php
@@ -0,0 +1,13 @@
+<?php
+
+/**
+ * NicePayments PG provider meta (English)
+ *
+ * Label referenced by name_key in the
+ * `sirsoft-ecommerce.payment.registered_pg_providers` hook payload.
+ * Resolved via the active language pack at runtime.
+ */
+return [
+    'name' => 'NicePayments',
+    'description' => 'NicePayments (Korean PG) — card / bank transfer / virtual account / mobile + 7 easy-pay providers',
+];
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/lang/ko/activity_log.php b/plugins/_bundled/sirsoft-pay_nicepayments/lang/ko/activity_log.php
new file mode 100644
index 00000000..39e209bd
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/lang/ko/activity_log.php
@@ -0,0 +1,10 @@
+<?php
+
+return [
+    'action' => [
+        'cancel' => 'PG 결제 취소',
+    ],
+    'description' => [
+        'payment_cancel' => '나이스페이먼츠 결제 취소가 확인되었습니다 (주문 :order_number, 환불금액 :refund_amount원).',
+    ],
+];
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/lang/ko/messages.php b/plugins/_bundled/sirsoft-pay_nicepayments/lang/ko/messages.php
new file mode 100644
index 00000000..b01fb936
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/lang/ko/messages.php
@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+return [
+    'errors' => [
+        'tid_required' => 'TID를 입력하세요.',
+        'order_not_found' => '주문을 찾을 수 없습니다.',
+        'invalid_request' => '잘못된 요청입니다.',
+        'invalid_amount' => '요청 금액이 유효하지 않습니다.',
+        'vbank_refund_required_fields' => 'TID, 주문번호, 취소금액, 환불계좌 정보(계좌번호·은행코드·예금주)를 모두 입력해주세요.',
+        'vbank_refund_order_not_found' => '환불할 주문을 찾을 수 없습니다.',
+        'vbank_refund_invalid_payment' => '환불 가능한 나이스페이먼츠 가상계좌 입금완료 결제가 아닙니다.',
+        'vbank_refund_amount_mismatch' => '요청 환불 금액이 DB의 취소 가능 금액과 일치하지 않습니다.',
+        'vbank_refund_already_processing' => '이미 가상계좌 환불 처리가 진행 중입니다.',
+        'vbank_completed_requires_bank_info' => '가상계좌 입금 완료 건은 환불계좌 정보가 필요합니다. 관리자 API를 통해 환불을 진행해주세요.',
+        'invalid_refund_amount' => '환불 금액이 유효하지 않습니다. (요청: :amount원)',
+    ],
+    'refund' => [
+        'missing_tid' => '거래 ID(TID)가 없어 환불을 진행할 수 없습니다.',
+        'default_reason' => '구매자 환불 요청',
+    ],
+    'defaults' => [
+        'vbank_refund_msg' => '가상계좌 환불',
+    ],
+];
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/lang/ko/payment_methods.php b/plugins/_bundled/sirsoft-pay_nicepayments/lang/ko/payment_methods.php
new file mode 100644
index 00000000..1eb4deb0
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/lang/ko/payment_methods.php
@@ -0,0 +1,36 @@
+<?php
+
+return [
+    'naverpay' => [
+        'name' => '네이' . "\u{200B}" . '버페이 (나이스페이먼츠)',
+        'description' => '네이' . "\u{200B}" . '버페이로 결제 (나이스페이먼츠)',
+    ],
+    'kakaopay' => [
+        'name' => '카카' . "\u{200B}" . '오페이 (나이스페이먼츠)',
+        'description' => '카카' . "\u{200B}" . '오페이로 결제 (나이스페이먼츠)',
+    ],
+    'samsungpay' => [
+        'name' => '삼성' . "\u{200B}" . '페이 (나이스페이먼츠)',
+        'description' => '삼성' . "\u{200B}" . '페이로 결제 (나이스페이먼츠)',
+    ],
+    'applepay' => [
+        'name' => '애플페이 (나이스페이먼츠)',
+        'description' => '애플페이로 결제 (나이스페이먼츠)',
+    ],
+    'payco' => [
+        'name' => 'PAYCO (나이스페이먼츠)',
+        'description' => 'PAYCO로 결제 (나이스페이먼츠)',
+    ],
+    'skpay' => [
+        'name' => '11pay (나이스페이먼츠)',
+        'description' => '11pay로 결제 (나이스페이먼츠)',
+    ],
+    'ssgpay' => [
+        'name' => 'SSG페이 (나이스페이먼츠)',
+        'description' => 'SSG페이로 결제 (나이스페이먼츠)',
+    ],
+    'lpay' => [
+        'name' => 'L.' . "\u{200B}" . 'pay (나이스페이먼츠)',
+        'description' => 'L.' . "\u{200B}" . 'pay로 결제 (나이스페이먼츠)',
+    ],
+];
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/lang/ko/provider.php b/plugins/_bundled/sirsoft-pay_nicepayments/lang/ko/provider.php
new file mode 100644
index 00000000..b2904725
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/lang/ko/provider.php
@@ -0,0 +1,12 @@
+<?php
+
+/**
+ * 나이스페이먼츠 PG 프로바이더 메타 (Korean)
+ *
+ * `sirsoft-ecommerce.payment.registered_pg_providers` 훅 페이로드의
+ * name_key 가 가리키는 라벨. 활성 언어팩으로 자동 보강된다.
+ */
+return [
+    'name' => '나이스페이먼츠',
+    'description' => '국내 PG 사 나이스페이먼츠 결제 연동 (카드/계좌이체/가상계좌/휴대폰 + 7종 간편결제)',
+];
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/package-lock.json b/plugins/_bundled/sirsoft-pay_nicepayments/package-lock.json
new file mode 100644
index 00000000..d6e88772
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/package-lock.json
@@ -0,0 +1,3179 @@
+{
+    "name": "@g7/sirsoft-pay_nicepayments",
+    "version": "1.0.0-beta.4",
+    "lockfileVersion": 3,
+    "requires": true,
+    "packages": {
+        "": {
+            "name": "@g7/sirsoft-pay_nicepayments",
+            "version": "1.0.0-beta.4",
+            "devDependencies": {
+                "jsdom": "^27.4.0",
+                "typescript": "^5.3.3",
+                "vite": "^5.4.14",
+                "vitest": "^4.1.8"
+            }
+        },
+        "node_modules/@acemir/cssom": {
+            "version": "0.9.31",
+            "resolved": "https://registry.npmjs.org/@acemir/cssom/-/cssom-0.9.31.tgz",
+            "integrity": "sha512-ZnR3GSaH+/vJ0YlHau21FjfLYjMpYVIzTD8M8vIEQvIGxeOXyXdzCI140rrCY862p/C/BbzWsjc1dgnM9mkoTA==",
+            "dev": true
+        },
+        "node_modules/@asamuzakjp/css-color": {
+            "version": "4.1.2",
+            "resolved": "https://registry.npmjs.org/@asamuzakjp/css-color/-/css-color-4.1.2.tgz",
+            "integrity": "sha512-NfBUvBaYgKIuq6E/RBLY1m0IohzNHAYyaJGuTK79Z23uNwmz2jl1mPsC5ZxCCxylinKhT1Amn5oNTlx1wN8cQg==",
+            "dev": true,
+            "dependencies": {
+                "@csstools/css-calc": "^3.0.0",
+                "@csstools/css-color-parser": "^4.0.1",
+                "@csstools/css-parser-algorithms": "^4.0.0",
+                "@csstools/css-tokenizer": "^4.0.0",
+                "lru-cache": "^11.2.5"
+            }
+        },
+        "node_modules/@asamuzakjp/dom-selector": {
+            "version": "6.8.1",
+            "resolved": "https://registry.npmjs.org/@asamuzakjp/dom-selector/-/dom-selector-6.8.1.tgz",
+            "integrity": "sha512-MvRz1nCqW0fsy8Qz4dnLIvhOlMzqDVBabZx6lH+YywFDdjXhMY37SmpV1XFX3JzG5GWHn63j6HX6QPr3lZXHvQ==",
+            "dev": true,
+            "dependencies": {
+                "@asamuzakjp/nwsapi": "^2.3.9",
+                "bidi-js": "^1.0.3",
+                "css-tree": "^3.1.0",
+                "is-potential-custom-element-name": "^1.0.1",
+                "lru-cache": "^11.2.6"
+            }
+        },
+        "node_modules/@asamuzakjp/nwsapi": {
+            "version": "2.3.9",
+            "resolved": "https://registry.npmjs.org/@asamuzakjp/nwsapi/-/nwsapi-2.3.9.tgz",
+            "integrity": "sha512-n8GuYSrI9bF7FFZ/SjhwevlHc8xaVlb/7HmHelnc/PZXBD2ZR49NnN9sMMuDdEGPeeRQ5d0hqlSlEpgCX3Wl0Q==",
+            "dev": true
+        },
+        "node_modules/@csstools/color-helpers": {
+            "version": "6.0.2",
+            "resolved": "https://registry.npmjs.org/@csstools/color-helpers/-/color-helpers-6.0.2.tgz",
+            "integrity": "sha512-LMGQLS9EuADloEFkcTBR3BwV/CGHV7zyDxVRtVDTwdI2Ca4it0CCVTT9wCkxSgokjE5Ho41hEPgb8OEUwoXr6Q==",
+            "dev": true,
+            "funding": [
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/csstools"
+                },
+                {
+                    "type": "opencollective",
+                    "url": "https://opencollective.com/csstools"
+                }
+            ],
+            "engines": {
+                "node": ">=20.19.0"
+            }
+        },
+        "node_modules/@csstools/css-calc": {
+            "version": "3.2.0",
+            "resolved": "https://registry.npmjs.org/@csstools/css-calc/-/css-calc-3.2.0.tgz",
+            "integrity": "sha512-bR9e6o2BDB12jzN/gIbjHa5wLJ4UjD1CB9pM7ehlc0ddk6EBz+yYS1EV2MF55/HUxrHcB/hehAyt5vhsA3hx7w==",
+            "dev": true,
+            "funding": [
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/csstools"
+                },
+                {
+                    "type": "opencollective",
+                    "url": "https://opencollective.com/csstools"
+                }
+            ],
+            "engines": {
+                "node": ">=20.19.0"
+            },
+            "peerDependencies": {
+                "@csstools/css-parser-algorithms": "^4.0.0",
+                "@csstools/css-tokenizer": "^4.0.0"
+            }
+        },
+        "node_modules/@csstools/css-color-parser": {
+            "version": "4.1.0",
+            "resolved": "https://registry.npmjs.org/@csstools/css-color-parser/-/css-color-parser-4.1.0.tgz",
+            "integrity": "sha512-U0KhLYmy2GVj6q4T3WaAe6NPuFYCPQoE3b0dRGxejWDgcPp8TP7S5rVdM5ZrFaqu4N67X8YaPBw14dQSYx3IyQ==",
+            "dev": true,
+            "funding": [
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/csstools"
+                },
+                {
+                    "type": "opencollective",
+                    "url": "https://opencollective.com/csstools"
+                }
+            ],
+            "dependencies": {
+                "@csstools/color-helpers": "^6.0.2",
+                "@csstools/css-calc": "^3.2.0"
+            },
+            "engines": {
+                "node": ">=20.19.0"
+            },
+            "peerDependencies": {
+                "@csstools/css-parser-algorithms": "^4.0.0",
+                "@csstools/css-tokenizer": "^4.0.0"
+            }
+        },
+        "node_modules/@csstools/css-parser-algorithms": {
+            "version": "4.0.0",
+            "resolved": "https://registry.npmjs.org/@csstools/css-parser-algorithms/-/css-parser-algorithms-4.0.0.tgz",
+            "integrity": "sha512-+B87qS7fIG3L5h3qwJ/IFbjoVoOe/bpOdh9hAjXbvx0o8ImEmUsGXN0inFOnk2ChCFgqkkGFQ+TpM5rbhkKe4w==",
+            "dev": true,
+            "funding": [
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/csstools"
+                },
+                {
+                    "type": "opencollective",
+                    "url": "https://opencollective.com/csstools"
+                }
+            ],
+            "engines": {
+                "node": ">=20.19.0"
+            },
+            "peerDependencies": {
+                "@csstools/css-tokenizer": "^4.0.0"
+            }
+        },
+        "node_modules/@csstools/css-syntax-patches-for-csstree": {
+            "version": "1.1.3",
+            "resolved": "https://registry.npmjs.org/@csstools/css-syntax-patches-for-csstree/-/css-syntax-patches-for-csstree-1.1.3.tgz",
+            "integrity": "sha512-SH60bMfrRCJF3morcdk57WklujF4Jr/EsQUzqkarfHXEFcAR1gg7fS/chAE922Sehgzc1/+Tz5H3Ypa1HiEKrg==",
+            "dev": true,
+            "funding": [
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/csstools"
+                },
+                {
+                    "type": "opencollective",
+                    "url": "https://opencollective.com/csstools"
+                }
+            ],
+            "peerDependencies": {
+                "css-tree": "^3.2.1"
+            },
+            "peerDependenciesMeta": {
+                "css-tree": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/@csstools/css-tokenizer": {
+            "version": "4.0.0",
+            "resolved": "https://registry.npmjs.org/@csstools/css-tokenizer/-/css-tokenizer-4.0.0.tgz",
+            "integrity": "sha512-QxULHAm7cNu72w97JUNCBFODFaXpbDg+dP8b/oWFAZ2MTRppA3U00Y2L1HqaS4J6yBqxwa/Y3nMBaxVKbB/NsA==",
+            "dev": true,
+            "funding": [
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/csstools"
+                },
+                {
+                    "type": "opencollective",
+                    "url": "https://opencollective.com/csstools"
+                }
+            ],
+            "engines": {
+                "node": ">=20.19.0"
+            }
+        },
+        "node_modules/@emnapi/core": {
+            "version": "1.10.0",
+            "resolved": "https://registry.npmjs.org/@emnapi/core/-/core-1.10.0.tgz",
+            "integrity": "sha512-yq6OkJ4p82CAfPl0u9mQebQHKPJkY7WrIuk205cTYnYe+k2Z8YBh11FrbRG/H6ihirqcacOgl2BIO8oyMQLeXw==",
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "dependencies": {
+                "@emnapi/wasi-threads": "1.2.1",
+                "tslib": "^2.4.0"
+            }
+        },
+        "node_modules/@emnapi/runtime": {
+            "version": "1.10.0",
+            "resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.10.0.tgz",
+            "integrity": "sha512-ewvYlk86xUoGI0zQRNq/mC+16R1QeDlKQy21Ki3oSYXNgLb45GV1P6A0M+/s6nyCuNDqe5VpaY84BzXGwVbwFA==",
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "dependencies": {
+                "tslib": "^2.4.0"
+            }
+        },
+        "node_modules/@emnapi/wasi-threads": {
+            "version": "1.2.1",
+            "resolved": "https://registry.npmjs.org/@emnapi/wasi-threads/-/wasi-threads-1.2.1.tgz",
+            "integrity": "sha512-uTII7OYF+/Mes/MrcIOYp5yOtSMLBWSIoLPpcgwipoiKbli6k322tcoFsxoIIxPDqW01SQGAgko4EzZi2BNv2w==",
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "dependencies": {
+                "tslib": "^2.4.0"
+            }
+        },
+        "node_modules/@esbuild/aix-ppc64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.21.5.tgz",
+            "integrity": "sha512-1SDgH6ZSPTlggy1yI6+Dbkiz8xzpHJEVAlF/AM1tHPLsf5STom9rwtjE4hKAF20FfXXNTFqEYXyJNWh1GiZedQ==",
+            "cpu": [
+                "ppc64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "aix"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/android-arm": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.21.5.tgz",
+            "integrity": "sha512-vCPvzSjpPHEi1siZdlvAlsPxXl7WbOVUBBAowWug4rJHb68Ox8KualB+1ocNvT5fjv6wpkX6o/iEpbDrf68zcg==",
+            "cpu": [
+                "arm"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "android"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/android-arm64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.21.5.tgz",
+            "integrity": "sha512-c0uX9VAUBQ7dTDCjq+wdyGLowMdtR/GoC2U5IYk/7D1H1JYC0qseD7+11iMP2mRLN9RcCMRcjC4YMclCzGwS/A==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "android"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/android-x64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.21.5.tgz",
+            "integrity": "sha512-D7aPRUUNHRBwHxzxRvp856rjUHRFW1SdQATKXH2hqA0kAZb1hKmi02OpYRacl0TxIGz/ZmXWlbZgjwWYaCakTA==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "android"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/darwin-arm64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.21.5.tgz",
+            "integrity": "sha512-DwqXqZyuk5AiWWf3UfLiRDJ5EDd49zg6O9wclZ7kUMv2WRFr4HKjXp/5t8JZ11QbQfUS6/cRCKGwYhtNAY88kQ==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "darwin"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/darwin-x64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.21.5.tgz",
+            "integrity": "sha512-se/JjF8NlmKVG4kNIuyWMV/22ZaerB+qaSi5MdrXtd6R08kvs2qCN4C09miupktDitvh8jRFflwGFBQcxZRjbw==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "darwin"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/freebsd-arm64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.21.5.tgz",
+            "integrity": "sha512-5JcRxxRDUJLX8JXp/wcBCy3pENnCgBR9bN6JsY4OmhfUtIHe3ZW0mawA7+RDAcMLrMIZaf03NlQiX9DGyB8h4g==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "freebsd"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/freebsd-x64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.21.5.tgz",
+            "integrity": "sha512-J95kNBj1zkbMXtHVH29bBriQygMXqoVQOQYA+ISs0/2l3T9/kj42ow2mpqerRBxDJnmkUDCaQT/dfNXWX/ZZCQ==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "freebsd"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/linux-arm": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.21.5.tgz",
+            "integrity": "sha512-bPb5AHZtbeNGjCKVZ9UGqGwo8EUu4cLq68E95A53KlxAPRmUyYv2D6F0uUI65XisGOL1hBP5mTronbgo+0bFcA==",
+            "cpu": [
+                "arm"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/linux-arm64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.21.5.tgz",
+            "integrity": "sha512-ibKvmyYzKsBeX8d8I7MH/TMfWDXBF3db4qM6sy+7re0YXya+K1cem3on9XgdT2EQGMu4hQyZhan7TeQ8XkGp4Q==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/linux-ia32": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.21.5.tgz",
+            "integrity": "sha512-YvjXDqLRqPDl2dvRODYmmhz4rPeVKYvppfGYKSNGdyZkA01046pLWyRKKI3ax8fbJoK5QbxblURkwK/MWY18Tg==",
+            "cpu": [
+                "ia32"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/linux-loong64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.21.5.tgz",
+            "integrity": "sha512-uHf1BmMG8qEvzdrzAqg2SIG/02+4/DHB6a9Kbya0XDvwDEKCoC8ZRWI5JJvNdUjtciBGFQ5PuBlpEOXQj+JQSg==",
+            "cpu": [
+                "loong64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/linux-mips64el": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.21.5.tgz",
+            "integrity": "sha512-IajOmO+KJK23bj52dFSNCMsz1QP1DqM6cwLUv3W1QwyxkyIWecfafnI555fvSGqEKwjMXVLokcV5ygHW5b3Jbg==",
+            "cpu": [
+                "mips64el"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/linux-ppc64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.21.5.tgz",
+            "integrity": "sha512-1hHV/Z4OEfMwpLO8rp7CvlhBDnjsC3CttJXIhBi+5Aj5r+MBvy4egg7wCbe//hSsT+RvDAG7s81tAvpL2XAE4w==",
+            "cpu": [
+                "ppc64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/linux-riscv64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.21.5.tgz",
+            "integrity": "sha512-2HdXDMd9GMgTGrPWnJzP2ALSokE/0O5HhTUvWIbD3YdjME8JwvSCnNGBnTThKGEB91OZhzrJ4qIIxk/SBmyDDA==",
+            "cpu": [
+                "riscv64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/linux-s390x": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.21.5.tgz",
+            "integrity": "sha512-zus5sxzqBJD3eXxwvjN1yQkRepANgxE9lgOW2qLnmr8ikMTphkjgXu1HR01K4FJg8h1kEEDAqDcZQtbrRnB41A==",
+            "cpu": [
+                "s390x"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/linux-x64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.21.5.tgz",
+            "integrity": "sha512-1rYdTpyv03iycF1+BhzrzQJCdOuAOtaqHTWJZCWvijKD2N5Xu0TtVC8/+1faWqcP9iBCWOmjmhoH94dH82BxPQ==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/netbsd-arm64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.28.0.tgz",
+            "integrity": "sha512-CR/RYotgtCKwtftMwJlUU7xCVNg3lMYZ0RzTmAHSfLCXw3NtZtNpswLEj/Kkf6kEL3Gw+BpOekRX0BYCtklhUw==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "netbsd"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/@esbuild/netbsd-x64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.21.5.tgz",
+            "integrity": "sha512-Woi2MXzXjMULccIwMnLciyZH4nCIMpWQAs049KEeMvOcNADVxo0UBIQPfSmxB3CWKedngg7sWZdLvLczpe0tLg==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "netbsd"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/openbsd-arm64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.28.0.tgz",
+            "integrity": "sha512-cXb5vApOsRsxsEl4mcZ1XY3D4DzcoMxR/nnc4IyqYs0rTI8ZKmW6kyyg+11Z8yvgMfAEldKzP7AdP64HnSC/6g==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "openbsd"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/@esbuild/openbsd-x64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.21.5.tgz",
+            "integrity": "sha512-HLNNw99xsvx12lFBUwoT8EVCsSvRNDVxNpjZ7bPn947b8gJPzeHWyNVhFsaerc0n3TsbOINvRP2byTZ5LKezow==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "openbsd"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/openharmony-arm64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.28.0.tgz",
+            "integrity": "sha512-FLGfyizszcef5C3YtoyQDACyg95+dndv79i2EekILBofh5wpCa1KuBqOWKrEHZg3zrL3t5ouE5jgr94vA+Wb2w==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "openharmony"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/@esbuild/sunos-x64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.21.5.tgz",
+            "integrity": "sha512-6+gjmFpfy0BHU5Tpptkuh8+uw3mnrvgs+dSPQXQOv3ekbordwnzTVEb4qnIvQcYXq6gzkyTnoZ9dZG+D4garKg==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "sunos"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/win32-arm64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.21.5.tgz",
+            "integrity": "sha512-Z0gOTd75VvXqyq7nsl93zwahcTROgqvuAcYDUr+vOv8uHhNSKROyU961kgtCD1e95IqPKSQKH7tBTslnS3tA8A==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "win32"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/win32-ia32": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.21.5.tgz",
+            "integrity": "sha512-SWXFF1CL2RVNMaVs+BBClwtfZSvDgtL//G/smwAc5oVK/UPu2Gu9tIaRgFmYFFKrmg3SyAjSrElf0TiJ1v8fYA==",
+            "cpu": [
+                "ia32"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "win32"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@esbuild/win32-x64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.21.5.tgz",
+            "integrity": "sha512-tQd/1efJuzPC6rCFwEvLtci/xNFcTZknmXs98FYDfGE4wP9ClFV98nyKrzJKVPMhdDnjzLhdUyMX4PsQAPjwIw==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "win32"
+            ],
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@exodus/bytes": {
+            "version": "1.15.0",
+            "resolved": "https://registry.npmjs.org/@exodus/bytes/-/bytes-1.15.0.tgz",
+            "integrity": "sha512-UY0nlA+feH81UGSHv92sLEPLCeZFjXOuHhrIo0HQydScuQc8s0A7kL/UdgwgDq8g8ilksmuoF35YVTNphV2aBQ==",
+            "dev": true,
+            "engines": {
+                "node": "^20.19.0 || ^22.12.0 || >=24.0.0"
+            },
+            "peerDependencies": {
+                "@noble/hashes": "^1.8.0 || ^2.0.0"
+            },
+            "peerDependenciesMeta": {
+                "@noble/hashes": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/@jridgewell/sourcemap-codec": {
+            "version": "1.5.5",
+            "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz",
+            "integrity": "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==",
+            "dev": true,
+            "license": "MIT"
+        },
+        "node_modules/@napi-rs/wasm-runtime": {
+            "version": "1.1.4",
+            "resolved": "https://registry.npmjs.org/@napi-rs/wasm-runtime/-/wasm-runtime-1.1.4.tgz",
+            "integrity": "sha512-3NQNNgA1YSlJb/kMH1ildASP9HW7/7kYnRI2szWJaofaS1hWmbGI4H+d3+22aGzXXN9IJ+n+GiFVcGipJP18ow==",
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "dependencies": {
+                "@tybys/wasm-util": "^0.10.1"
+            },
+            "funding": {
+                "type": "github",
+                "url": "https://github.com/sponsors/Brooooooklyn"
+            },
+            "peerDependencies": {
+                "@emnapi/core": "^1.7.1",
+                "@emnapi/runtime": "^1.7.1"
+            }
+        },
+        "node_modules/@oxc-project/types": {
+            "version": "0.133.0",
+            "resolved": "https://registry.npmjs.org/@oxc-project/types/-/types-0.133.0.tgz",
+            "integrity": "sha512-KzkdCd6Uxqnf6l3HOw1xfatAlUURA0g14cvBYFyJ5SaNOQbOUvBr9PKArcPcrNIeRsBdgcUzOGrhKveVpvOIGA==",
+            "dev": true,
+            "license": "MIT",
+            "funding": {
+                "url": "https://github.com/sponsors/Boshen"
+            }
+        },
+        "node_modules/@rolldown/binding-android-arm64": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/@rolldown/binding-android-arm64/-/binding-android-arm64-1.0.3.tgz",
+            "integrity": "sha512-454rs7jHngixp/NMxd5srYD57OnzSlZ/eFTETjORQHLwJG1lRtmNOJcBerZlfu4GjKqeq8aCCIQrMdHyhI51Hw==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "android"
+            ],
+            "engines": {
+                "node": "^20.19.0 || >=22.12.0"
+            }
+        },
+        "node_modules/@rolldown/binding-darwin-arm64": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/@rolldown/binding-darwin-arm64/-/binding-darwin-arm64-1.0.3.tgz",
+            "integrity": "sha512-PcAhP+ynjURNyy8SKGl5DQP94aGuB/7JrXJb/t7P+hanXvQVMWzUvRRhBAcg/lNRadBhoUPqSoP4xw5tR/KBEA==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "darwin"
+            ],
+            "engines": {
+                "node": "^20.19.0 || >=22.12.0"
+            }
+        },
+        "node_modules/@rolldown/binding-darwin-x64": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/@rolldown/binding-darwin-x64/-/binding-darwin-x64-1.0.3.tgz",
+            "integrity": "sha512-9YpfeUvSE2RS7wysJ81uOZkXJz7f7Q55H2Gvp3VEw/EsahqDtrphrZ0EwDLK5vvKOzaCrBsjF8JmnMLcUt78Gg==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "darwin"
+            ],
+            "engines": {
+                "node": "^20.19.0 || >=22.12.0"
+            }
+        },
+        "node_modules/@rolldown/binding-freebsd-x64": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/@rolldown/binding-freebsd-x64/-/binding-freebsd-x64-1.0.3.tgz",
+            "integrity": "sha512-yB1IlAsSNHncV6SCTL27/MVGR5htvQsoGxIv5KMGXALp+Ll1wYsn+x98M9MW7qa+NdSbvrrY7ANI4wLJ0n1e6g==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "freebsd"
+            ],
+            "engines": {
+                "node": "^20.19.0 || >=22.12.0"
+            }
+        },
+        "node_modules/@rolldown/binding-linux-arm-gnueabihf": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm-gnueabihf/-/binding-linux-arm-gnueabihf-1.0.3.tgz",
+            "integrity": "sha512-Yi30IVAAfLUCy2MseFjbB1jAMDl1VMCAas5StnYp8da9+CKvMd2H2cbEjWcw5NPaPqzvYkVIaF1nNUG+b7u/sw==",
+            "cpu": [
+                "arm"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": "^20.19.0 || >=22.12.0"
+            }
+        },
+        "node_modules/@rolldown/binding-linux-arm64-gnu": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm64-gnu/-/binding-linux-arm64-gnu-1.0.3.tgz",
+            "integrity": "sha512-jsO7R8To+AdlYgUmN5sHSCZbfhtMBkO0WUx8iORQnPcMMdgr7qM2DQmMwgabs3GhNztdmoKkMKQFHD6DTMCIQw==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": "^20.19.0 || >=22.12.0"
+            }
+        },
+        "node_modules/@rolldown/binding-linux-arm64-musl": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm64-musl/-/binding-linux-arm64-musl-1.0.3.tgz",
+            "integrity": "sha512-VWkUHwWriDciit80wleYwKILoR/KMvxh/IdwS/paX+ZgpuRpCrKLUdadJbc0NpBEiyhpYawsJ73j9aCvOH+f7Q==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": "^20.19.0 || >=22.12.0"
+            }
+        },
+        "node_modules/@rolldown/binding-linux-ppc64-gnu": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-ppc64-gnu/-/binding-linux-ppc64-gnu-1.0.3.tgz",
+            "integrity": "sha512-5f1laC0SlIR0yDbFCd8acUhvJIag6N3zC5P7oUPN6wX0aOma+uKJ0wBDH5aq7I1PVI2ttTlhJwzwRIBnLiSGEg==",
+            "cpu": [
+                "ppc64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": "^20.19.0 || >=22.12.0"
+            }
+        },
+        "node_modules/@rolldown/binding-linux-s390x-gnu": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-s390x-gnu/-/binding-linux-s390x-gnu-1.0.3.tgz",
+            "integrity": "sha512-Iq4ko0r4XsgbrF/LunNgHtAGLRRVE2kXonAXQ/MV0mC6jQpMOhW1SvtZja2EhC/kd05++bP78dsqBeIQyYJ6Yg==",
+            "cpu": [
+                "s390x"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": "^20.19.0 || >=22.12.0"
+            }
+        },
+        "node_modules/@rolldown/binding-linux-x64-gnu": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-x64-gnu/-/binding-linux-x64-gnu-1.0.3.tgz",
+            "integrity": "sha512-B8m6tD5+/N5FeNQFbKlLA/2yVq9ycQP1SeedyEYYKWBNR3ZQbkvIUcNnDNM03lO1l5F2roiiFJGgvoLLyZXtSg==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": "^20.19.0 || >=22.12.0"
+            }
+        },
+        "node_modules/@rolldown/binding-linux-x64-musl": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-x64-musl/-/binding-linux-x64-musl-1.0.3.tgz",
+            "integrity": "sha512-pSdpdUJHkuCxun9LE7jvgUB9qsRgaiyNNCX7m/AvHTcq67AiT/Yhoxvw5zPfhrM8k/BfP8ce/hMOpthKDpEUow==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": "^20.19.0 || >=22.12.0"
+            }
+        },
+        "node_modules/@rolldown/binding-openharmony-arm64": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/@rolldown/binding-openharmony-arm64/-/binding-openharmony-arm64-1.0.3.tgz",
+            "integrity": "sha512-OXXS3RKJgX2uLwM+gYyuH5omcH8fL1LJs96pZGgtetVCahON57+d4SJHzTgZiOjxgGkSnpXpOsWuPDGAKAigEg==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "openharmony"
+            ],
+            "engines": {
+                "node": "^20.19.0 || >=22.12.0"
+            }
+        },
+        "node_modules/@rolldown/binding-wasm32-wasi": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/@rolldown/binding-wasm32-wasi/-/binding-wasm32-wasi-1.0.3.tgz",
+            "integrity": "sha512-JTtb8BWFynicNSoPrehsCzBtOKjZ6jhMiPFEmOiuXg1Fl8dn2KHQob+GuPSGR0dryQa1PQJbzjF3dqO/whhjLg==",
+            "cpu": [
+                "wasm32"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "dependencies": {
+                "@emnapi/core": "1.10.0",
+                "@emnapi/runtime": "1.10.0",
+                "@napi-rs/wasm-runtime": "^1.1.4"
+            },
+            "engines": {
+                "node": "^20.19.0 || >=22.12.0"
+            }
+        },
+        "node_modules/@rolldown/binding-win32-arm64-msvc": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/@rolldown/binding-win32-arm64-msvc/-/binding-win32-arm64-msvc-1.0.3.tgz",
+            "integrity": "sha512-gEdFFEN70A/jxb2svrWsN3aDL7OUtmvlOy+6fa2jxG8K0wQ1ZbdeLGnidov6Yu5/733dI5ySfzFlQ/cb0bSz1g==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "win32"
+            ],
+            "engines": {
+                "node": "^20.19.0 || >=22.12.0"
+            }
+        },
+        "node_modules/@rolldown/binding-win32-x64-msvc": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/@rolldown/binding-win32-x64-msvc/-/binding-win32-x64-msvc-1.0.3.tgz",
+            "integrity": "sha512-eXB7CHuaQdqmJcc3koCNtNPmT/bj2gc999kUFgBxG8Ac0NdgXc4rkCHhqrgrhN3zddvvvrgzj1e90SuSfmyIXA==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "win32"
+            ],
+            "engines": {
+                "node": "^20.19.0 || >=22.12.0"
+            }
+        },
+        "node_modules/@rolldown/pluginutils": {
+            "version": "1.0.1",
+            "resolved": "https://registry.npmjs.org/@rolldown/pluginutils/-/pluginutils-1.0.1.tgz",
+            "integrity": "sha512-2j9bGt5Jh8hj+vPtgzPtl72j0yRxHAyumoo6TNfAjsLB04UtpSvPbPcDcBMxz7n+9CYB0c1GxQFxYRg2jimqGw==",
+            "dev": true,
+            "license": "MIT"
+        },
+        "node_modules/@rollup/rollup-android-arm-eabi": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.60.2.tgz",
+            "integrity": "sha512-dnlp69efPPg6Uaw2dVqzWRfAWRnYVb1XJ8CyyhIbZeaq4CA5/mLeZ1IEt9QqQxmbdvagjLIm2ZL8BxXv5lH4Yw==",
+            "cpu": [
+                "arm"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "android"
+            ]
+        },
+        "node_modules/@rollup/rollup-android-arm64": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.60.2.tgz",
+            "integrity": "sha512-OqZTwDRDchGRHHm/hwLOL7uVPB9aUvI0am/eQuWMNyFHf5PSEQmyEeYYheA0EPPKUO/l0uigCp+iaTjoLjVoHg==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "android"
+            ]
+        },
+        "node_modules/@rollup/rollup-darwin-arm64": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.60.2.tgz",
+            "integrity": "sha512-UwRE7CGpvSVEQS8gUMBe1uADWjNnVgP3Iusyda1nSRwNDCsRjnGc7w6El6WLQsXmZTbLZx9cecegumcitNfpmA==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "darwin"
+            ]
+        },
+        "node_modules/@rollup/rollup-darwin-x64": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.60.2.tgz",
+            "integrity": "sha512-gjEtURKLCC5VXm1I+2i1u9OhxFsKAQJKTVB8WvDAHF+oZlq0GTVFOlTlO1q3AlCTE/DF32c16ESvfgqR7343/g==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "darwin"
+            ]
+        },
+        "node_modules/@rollup/rollup-freebsd-arm64": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.60.2.tgz",
+            "integrity": "sha512-Bcl6CYDeAgE70cqZaMojOi/eK63h5Me97ZqAQoh77VPjMysA/4ORQBRGo3rRy45x4MzVlU9uZxs8Uwy7ZaKnBw==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "freebsd"
+            ]
+        },
+        "node_modules/@rollup/rollup-freebsd-x64": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.60.2.tgz",
+            "integrity": "sha512-LU+TPda3mAE2QB0/Hp5VyeKJivpC6+tlOXd1VMoXV/YFMvk/MNk5iXeBfB4MQGRWyOYVJ01625vjkr0Az98OJQ==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "freebsd"
+            ]
+        },
+        "node_modules/@rollup/rollup-linux-arm-gnueabihf": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.60.2.tgz",
+            "integrity": "sha512-2QxQrM+KQ7DAW4o22j+XZ6RKdxjLD7BOWTP0Bv0tmjdyhXSsr2Ul1oJDQqh9Zf5qOwTuTc7Ek83mOFaKnodPjg==",
+            "cpu": [
+                "arm"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ]
+        },
+        "node_modules/@rollup/rollup-linux-arm-musleabihf": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.60.2.tgz",
+            "integrity": "sha512-TbziEu2DVsTEOPif2mKWkMeDMLoYjx95oESa9fkQQK7r/Orta0gnkcDpzwufEcAO2BLBsD7mZkXGFqEdMRRwfw==",
+            "cpu": [
+                "arm"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ]
+        },
+        "node_modules/@rollup/rollup-linux-arm64-gnu": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.60.2.tgz",
+            "integrity": "sha512-bO/rVDiDUuM2YfuCUwZ1t1cP+/yqjqz+Xf2VtkdppefuOFS2OSeAfgafaHNkFn0t02hEyXngZkxtGqXcXwO8Rg==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ]
+        },
+        "node_modules/@rollup/rollup-linux-arm64-musl": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.60.2.tgz",
+            "integrity": "sha512-hr26p7e93Rl0Za+JwW7EAnwAvKkehh12BU1Llm9Ykiibg4uIr2rbpxG9WCf56GuvidlTG9KiiQT/TXT1yAWxTA==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ]
+        },
+        "node_modules/@rollup/rollup-linux-loong64-gnu": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.60.2.tgz",
+            "integrity": "sha512-pOjB/uSIyDt+ow3k/RcLvUAOGpysT2phDn7TTUB3n75SlIgZzM6NKAqlErPhoFU+npgY3/n+2HYIQVbF70P9/A==",
+            "cpu": [
+                "loong64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ]
+        },
+        "node_modules/@rollup/rollup-linux-loong64-musl": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-musl/-/rollup-linux-loong64-musl-4.60.2.tgz",
+            "integrity": "sha512-2/w+q8jszv9Ww1c+6uJT3OwqhdmGP2/4T17cu8WuwyUuuaCDDJ2ojdyYwZzCxx0GcsZBhzi3HmH+J5pZNXnd+Q==",
+            "cpu": [
+                "loong64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ]
+        },
+        "node_modules/@rollup/rollup-linux-ppc64-gnu": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.60.2.tgz",
+            "integrity": "sha512-11+aL5vKheYgczxtPVVRhdptAM2H7fcDR5Gw4/bTcteuZBlH4oP9f5s9zYO9aGZvoGeBpqXI/9TZZihZ609wKw==",
+            "cpu": [
+                "ppc64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ]
+        },
+        "node_modules/@rollup/rollup-linux-ppc64-musl": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-musl/-/rollup-linux-ppc64-musl-4.60.2.tgz",
+            "integrity": "sha512-i16fokAGK46IVZuV8LIIwMdtqhin9hfYkCh8pf8iC3QU3LpwL+1FSFGej+O7l3E/AoknL6Dclh2oTdnRMpTzFQ==",
+            "cpu": [
+                "ppc64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ]
+        },
+        "node_modules/@rollup/rollup-linux-riscv64-gnu": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.60.2.tgz",
+            "integrity": "sha512-49FkKS6RGQoriDSK/6E2GkAsAuU5kETFCh7pG4yD/ylj9rKhTmO3elsnmBvRD4PgJPds5W2PkhC82aVwmUcJ7A==",
+            "cpu": [
+                "riscv64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ]
+        },
+        "node_modules/@rollup/rollup-linux-riscv64-musl": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.60.2.tgz",
+            "integrity": "sha512-mjYNkHPfGpUR00DuM1ZZIgs64Hpf4bWcz9Z41+4Q+pgDx73UwWdAYyf6EG/lRFldmdHHzgrYyge5akFUW0D3mQ==",
+            "cpu": [
+                "riscv64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ]
+        },
+        "node_modules/@rollup/rollup-linux-s390x-gnu": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.60.2.tgz",
+            "integrity": "sha512-ALyvJz965BQk8E9Al/JDKKDLH2kfKFLTGMlgkAbbYtZuJt9LU8DW3ZoDMCtQpXAltZxwBHevXz5u+gf0yA0YoA==",
+            "cpu": [
+                "s390x"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ]
+        },
+        "node_modules/@rollup/rollup-linux-x64-gnu": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.60.2.tgz",
+            "integrity": "sha512-UQjrkIdWrKI626Du8lCQ6MJp/6V1LAo2bOK9OTu4mSn8GGXIkPXk/Vsp4bLHCd9Z9Iz2OTEaokUE90VweJgIYQ==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ]
+        },
+        "node_modules/@rollup/rollup-linux-x64-musl": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.60.2.tgz",
+            "integrity": "sha512-bTsRGj6VlSdn/XD4CGyzMnzaBs9bsRxy79eTqTCBsA8TMIEky7qg48aPkvJvFe1HyzQ5oMZdg7AnVlWQSKLTnw==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ]
+        },
+        "node_modules/@rollup/rollup-openbsd-x64": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-openbsd-x64/-/rollup-openbsd-x64-4.60.2.tgz",
+            "integrity": "sha512-6d4Z3534xitaA1FcMWP7mQPq5zGwBmGbhphh2DwaA1aNIXUu3KTOfwrWpbwI4/Gr0uANo7NTtaykFyO2hPuFLg==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "openbsd"
+            ]
+        },
+        "node_modules/@rollup/rollup-openharmony-arm64": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.60.2.tgz",
+            "integrity": "sha512-NetAg5iO2uN7eB8zE5qrZ3CSil+7IJt4WDFLcC75Ymywq1VZVD6qJ6EvNLjZ3rEm6gB7XW5JdT60c6MN35Z85Q==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "openharmony"
+            ]
+        },
+        "node_modules/@rollup/rollup-win32-arm64-msvc": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.60.2.tgz",
+            "integrity": "sha512-NCYhOotpgWZ5kdxCZsv6Iudx0wX8980Q/oW4pNFNihpBKsDbEA1zpkfxJGC0yugsUuyDZ7gL37dbzwhR0VI7pQ==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "win32"
+            ]
+        },
+        "node_modules/@rollup/rollup-win32-ia32-msvc": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.60.2.tgz",
+            "integrity": "sha512-RXsaOqXxfoUBQoOgvmmijVxJnW2IGB0eoMO7F8FAjaj0UTywUO/luSqimWBJn04WNgUkeNhh7fs7pESXajWmkg==",
+            "cpu": [
+                "ia32"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "win32"
+            ]
+        },
+        "node_modules/@rollup/rollup-win32-x64-gnu": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.60.2.tgz",
+            "integrity": "sha512-qdAzEULD+/hzObedtmV6iBpdL5TIbKVztGiK7O3/KYSf+HIzU257+MX1EXJcyIiDbMAqmbwaufcYPvyRryeZtA==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "win32"
+            ]
+        },
+        "node_modules/@rollup/rollup-win32-x64-msvc": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.60.2.tgz",
+            "integrity": "sha512-Nd/SgG27WoA9e+/TdK74KnHz852TLa94ovOYySo/yMPuTmpckK/jIF2jSwS3g7ELSKXK13/cVdmg1Z/DaCWKxA==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "win32"
+            ]
+        },
+        "node_modules/@standard-schema/spec": {
+            "version": "1.1.0",
+            "resolved": "https://registry.npmjs.org/@standard-schema/spec/-/spec-1.1.0.tgz",
+            "integrity": "sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w==",
+            "dev": true,
+            "license": "MIT"
+        },
+        "node_modules/@tybys/wasm-util": {
+            "version": "0.10.2",
+            "resolved": "https://registry.npmjs.org/@tybys/wasm-util/-/wasm-util-0.10.2.tgz",
+            "integrity": "sha512-RoBvJ2X0wuKlWFIjrwffGw1IqZHKQqzIchKaadZZfnNpsAYp2mM0h36JtPCjNDAHGgYez/15uMBpfGwchhiMgg==",
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "dependencies": {
+                "tslib": "^2.4.0"
+            }
+        },
+        "node_modules/@types/chai": {
+            "version": "5.2.3",
+            "resolved": "https://registry.npmjs.org/@types/chai/-/chai-5.2.3.tgz",
+            "integrity": "sha512-Mw558oeA9fFbv65/y4mHtXDs9bPnFMZAL/jxdPFUpOHHIXX91mcgEHbS5Lahr+pwZFR8A7GQleRWeI6cGFC2UA==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "@types/deep-eql": "*",
+                "assertion-error": "^2.0.1"
+            }
+        },
+        "node_modules/@types/deep-eql": {
+            "version": "4.0.2",
+            "resolved": "https://registry.npmjs.org/@types/deep-eql/-/deep-eql-4.0.2.tgz",
+            "integrity": "sha512-c9h9dVVMigMPc4bwTvC5dxqtqJZwQPePsWjPlpSOnojbor6pGqdk541lfA7AqFQr5pB1BRdq0juY9db81BwyFw==",
+            "dev": true,
+            "license": "MIT"
+        },
+        "node_modules/@types/estree": {
+            "version": "1.0.8",
+            "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.8.tgz",
+            "integrity": "sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==",
+            "dev": true
+        },
+        "node_modules/@vitest/expect": {
+            "version": "4.1.8",
+            "resolved": "https://registry.npmjs.org/@vitest/expect/-/expect-4.1.8.tgz",
+            "integrity": "sha512-h3nDO677RDLEGlBxyQ5CW8RlMThSKSRLUePLOx09gNIWRL40edgA1GCZSZgf1W55MFAG6/Sw14KeaAnqv0NKdQ==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "@standard-schema/spec": "^1.1.0",
+                "@types/chai": "^5.2.2",
+                "@vitest/spy": "4.1.8",
+                "@vitest/utils": "4.1.8",
+                "chai": "^6.2.2",
+                "tinyrainbow": "^3.1.0"
+            },
+            "funding": {
+                "url": "https://opencollective.com/vitest"
+            }
+        },
+        "node_modules/@vitest/pretty-format": {
+            "version": "4.1.8",
+            "resolved": "https://registry.npmjs.org/@vitest/pretty-format/-/pretty-format-4.1.8.tgz",
+            "integrity": "sha512-9GasEBxpZ1VYIpqHf/0+YGg121uSNwCKOJqIrTwWP/TB7DmFCiaBpNl3aPZzoLWfWkuqhbH8vJIVobZkvdo2cA==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "tinyrainbow": "^3.1.0"
+            },
+            "funding": {
+                "url": "https://opencollective.com/vitest"
+            }
+        },
+        "node_modules/@vitest/runner": {
+            "version": "4.1.8",
+            "resolved": "https://registry.npmjs.org/@vitest/runner/-/runner-4.1.8.tgz",
+            "integrity": "sha512-EmVxeBAfMJvycdjd6Hm+RbFBbA9fKvo0Kx37hNpBYoYeavH3RNsBXWDooR1mgD52dCrxIIuP7UotpfiwOikvcg==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "@vitest/utils": "4.1.8",
+                "pathe": "^2.0.3"
+            },
+            "funding": {
+                "url": "https://opencollective.com/vitest"
+            }
+        },
+        "node_modules/@vitest/snapshot": {
+            "version": "4.1.8",
+            "resolved": "https://registry.npmjs.org/@vitest/snapshot/-/snapshot-4.1.8.tgz",
+            "integrity": "sha512-acfZboRmAIf05DEKcBQy33VXojFJjtUdLyo7oOmV9kebb2xdU01UknNiPuPZoJZQyO7DF0gZdTGTpeAzET9QPQ==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "@vitest/pretty-format": "4.1.8",
+                "@vitest/utils": "4.1.8",
+                "magic-string": "^0.30.21",
+                "pathe": "^2.0.3"
+            },
+            "funding": {
+                "url": "https://opencollective.com/vitest"
+            }
+        },
+        "node_modules/@vitest/spy": {
+            "version": "4.1.8",
+            "resolved": "https://registry.npmjs.org/@vitest/spy/-/spy-4.1.8.tgz",
+            "integrity": "sha512-6EevtBp6OZOPF7bmz36HrGMeP3txgVSrgebWxHOafDXGkhIzfXK14f8KF6MuFfgXXUeHxmpD3BQxkV00/3s5mA==",
+            "dev": true,
+            "license": "MIT",
+            "funding": {
+                "url": "https://opencollective.com/vitest"
+            }
+        },
+        "node_modules/@vitest/utils": {
+            "version": "4.1.8",
+            "resolved": "https://registry.npmjs.org/@vitest/utils/-/utils-4.1.8.tgz",
+            "integrity": "sha512-uOJamYALNhfJ6iolExyQM40yIQwDqYnkKtQ5VCiSe17E33H0aQ/u+1GlRuz4LZBk6Mm3sg90G9hEbmEt37C1Zg==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "@vitest/pretty-format": "4.1.8",
+                "convert-source-map": "^2.0.0",
+                "tinyrainbow": "^3.1.0"
+            },
+            "funding": {
+                "url": "https://opencollective.com/vitest"
+            }
+        },
+        "node_modules/agent-base": {
+            "version": "7.1.4",
+            "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-7.1.4.tgz",
+            "integrity": "sha512-MnA+YT8fwfJPgBx3m60MNqakm30XOkyIoH1y6huTQvC0PwZG7ki8NacLBcrPbNoo8vEZy7Jpuk7+jMO+CUovTQ==",
+            "dev": true,
+            "engines": {
+                "node": ">= 14"
+            }
+        },
+        "node_modules/assertion-error": {
+            "version": "2.0.1",
+            "resolved": "https://registry.npmjs.org/assertion-error/-/assertion-error-2.0.1.tgz",
+            "integrity": "sha512-Izi8RQcffqCeNVgFigKli1ssklIbpHnCYc6AknXGYoB6grJqyeby7jv12JUQgmTAnIDnbck1uxksT4dzN3PWBA==",
+            "dev": true,
+            "license": "MIT",
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/bidi-js": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/bidi-js/-/bidi-js-1.0.3.tgz",
+            "integrity": "sha512-RKshQI1R3YQ+n9YJz2QQ147P66ELpa1FQEg20Dk8oW9t2KgLbpDLLp9aGZ7y8WHSshDknG0bknqGw5/tyCs5tw==",
+            "dev": true,
+            "dependencies": {
+                "require-from-string": "^2.0.2"
+            }
+        },
+        "node_modules/chai": {
+            "version": "6.2.2",
+            "resolved": "https://registry.npmjs.org/chai/-/chai-6.2.2.tgz",
+            "integrity": "sha512-NUPRluOfOiTKBKvWPtSD4PhFvWCqOi0BGStNWs57X9js7XGTprSmFoz5F0tWhR4WPjNeR9jXqdC7/UpSJTnlRg==",
+            "dev": true,
+            "license": "MIT",
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/convert-source-map": {
+            "version": "2.0.0",
+            "resolved": "https://registry.npmjs.org/convert-source-map/-/convert-source-map-2.0.0.tgz",
+            "integrity": "sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==",
+            "dev": true,
+            "license": "MIT"
+        },
+        "node_modules/css-tree": {
+            "version": "3.2.1",
+            "resolved": "https://registry.npmjs.org/css-tree/-/css-tree-3.2.1.tgz",
+            "integrity": "sha512-X7sjQzceUhu1u7Y/ylrRZFU2FS6LRiFVp6rKLPg23y3x3c3DOKAwuXGDp+PAGjh6CSnCjYeAul8pcT8bAl+lSA==",
+            "dev": true,
+            "dependencies": {
+                "mdn-data": "2.27.1",
+                "source-map-js": "^1.2.1"
+            },
+            "engines": {
+                "node": "^10 || ^12.20.0 || ^14.13.0 || >=15.0.0"
+            }
+        },
+        "node_modules/cssstyle": {
+            "version": "5.3.7",
+            "resolved": "https://registry.npmjs.org/cssstyle/-/cssstyle-5.3.7.tgz",
+            "integrity": "sha512-7D2EPVltRrsTkhpQmksIu+LxeWAIEk6wRDMJ1qljlv+CKHJM+cJLlfhWIzNA44eAsHXSNe3+vO6DW1yCYx8SuQ==",
+            "dev": true,
+            "dependencies": {
+                "@asamuzakjp/css-color": "^4.1.1",
+                "@csstools/css-syntax-patches-for-csstree": "^1.0.21",
+                "css-tree": "^3.1.0",
+                "lru-cache": "^11.2.4"
+            },
+            "engines": {
+                "node": ">=20"
+            }
+        },
+        "node_modules/data-urls": {
+            "version": "6.0.1",
+            "resolved": "https://registry.npmjs.org/data-urls/-/data-urls-6.0.1.tgz",
+            "integrity": "sha512-euIQENZg6x8mj3fO6o9+fOW8MimUI4PpD/fZBhJfeioZVy9TUpM4UY7KjQNVZFlqwJ0UdzRDzkycB997HEq1BQ==",
+            "dev": true,
+            "dependencies": {
+                "whatwg-mimetype": "^5.0.0",
+                "whatwg-url": "^15.1.0"
+            },
+            "engines": {
+                "node": ">=20"
+            }
+        },
+        "node_modules/data-urls/node_modules/whatwg-mimetype": {
+            "version": "5.0.0",
+            "resolved": "https://registry.npmjs.org/whatwg-mimetype/-/whatwg-mimetype-5.0.0.tgz",
+            "integrity": "sha512-sXcNcHOC51uPGF0P/D4NVtrkjSU2fNsm9iog4ZvZJsL3rjoDAzXZhkm2MWt1y+PUdggKAYVoMAIYcs78wJ51Cw==",
+            "dev": true,
+            "engines": {
+                "node": ">=20"
+            }
+        },
+        "node_modules/debug": {
+            "version": "4.4.3",
+            "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz",
+            "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==",
+            "dev": true,
+            "dependencies": {
+                "ms": "^2.1.3"
+            },
+            "engines": {
+                "node": ">=6.0"
+            },
+            "peerDependenciesMeta": {
+                "supports-color": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/decimal.js": {
+            "version": "10.6.0",
+            "resolved": "https://registry.npmjs.org/decimal.js/-/decimal.js-10.6.0.tgz",
+            "integrity": "sha512-YpgQiITW3JXGntzdUmyUR1V812Hn8T1YVXhCu+wO3OpS4eU9l4YdD3qjyiKdV6mvV29zapkMeD390UVEf2lkUg==",
+            "dev": true
+        },
+        "node_modules/detect-libc": {
+            "version": "2.1.2",
+            "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz",
+            "integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==",
+            "dev": true,
+            "license": "Apache-2.0",
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/entities": {
+            "version": "8.0.0",
+            "resolved": "https://registry.npmjs.org/entities/-/entities-8.0.0.tgz",
+            "integrity": "sha512-zwfzJecQ/Uej6tusMqwAqU/6KL2XaB2VZ2Jg54Je6ahNBGNH6Ek6g3jjNCF0fG9EWQKGZNddNjU5F1ZQn/sBnA==",
+            "dev": true,
+            "engines": {
+                "node": ">=20.19.0"
+            },
+            "funding": {
+                "url": "https://github.com/fb55/entities?sponsor=1"
+            }
+        },
+        "node_modules/es-module-lexer": {
+            "version": "2.1.0",
+            "resolved": "https://registry.npmjs.org/es-module-lexer/-/es-module-lexer-2.1.0.tgz",
+            "integrity": "sha512-n27zTYMjYu1aj4MjCWzSP7G9r75utsaoc8m61weK+W8JMBGGQybd43GstCXZ3WNmSFtGT9wi59qQTW6mhTR5LQ==",
+            "dev": true,
+            "license": "MIT"
+        },
+        "node_modules/esbuild": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.21.5.tgz",
+            "integrity": "sha512-mg3OPMV4hXywwpoDxu3Qda5xCKQi+vCTZq8S9J/EpkhB2HzKXq4SNFZE3+NK93JYxc8VMSep+lOUSC/RVKaBqw==",
+            "dev": true,
+            "hasInstallScript": true,
+            "bin": {
+                "esbuild": "bin/esbuild"
+            },
+            "engines": {
+                "node": ">=12"
+            },
+            "optionalDependencies": {
+                "@esbuild/aix-ppc64": "0.21.5",
+                "@esbuild/android-arm": "0.21.5",
+                "@esbuild/android-arm64": "0.21.5",
+                "@esbuild/android-x64": "0.21.5",
+                "@esbuild/darwin-arm64": "0.21.5",
+                "@esbuild/darwin-x64": "0.21.5",
+                "@esbuild/freebsd-arm64": "0.21.5",
+                "@esbuild/freebsd-x64": "0.21.5",
+                "@esbuild/linux-arm": "0.21.5",
+                "@esbuild/linux-arm64": "0.21.5",
+                "@esbuild/linux-ia32": "0.21.5",
+                "@esbuild/linux-loong64": "0.21.5",
+                "@esbuild/linux-mips64el": "0.21.5",
+                "@esbuild/linux-ppc64": "0.21.5",
+                "@esbuild/linux-riscv64": "0.21.5",
+                "@esbuild/linux-s390x": "0.21.5",
+                "@esbuild/linux-x64": "0.21.5",
+                "@esbuild/netbsd-x64": "0.21.5",
+                "@esbuild/openbsd-x64": "0.21.5",
+                "@esbuild/sunos-x64": "0.21.5",
+                "@esbuild/win32-arm64": "0.21.5",
+                "@esbuild/win32-ia32": "0.21.5",
+                "@esbuild/win32-x64": "0.21.5"
+            }
+        },
+        "node_modules/estree-walker": {
+            "version": "3.0.3",
+            "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-3.0.3.tgz",
+            "integrity": "sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "@types/estree": "^1.0.0"
+            }
+        },
+        "node_modules/expect-type": {
+            "version": "1.3.0",
+            "resolved": "https://registry.npmjs.org/expect-type/-/expect-type-1.3.0.tgz",
+            "integrity": "sha512-knvyeauYhqjOYvQ66MznSMs83wmHrCycNEN6Ao+2AeYEfxUIkuiVxdEa1qlGEPK+We3n0THiDciYSsCcgW/DoA==",
+            "dev": true,
+            "engines": {
+                "node": ">=12.0.0"
+            }
+        },
+        "node_modules/fdir": {
+            "version": "6.5.0",
+            "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz",
+            "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==",
+            "dev": true,
+            "license": "MIT",
+            "engines": {
+                "node": ">=12.0.0"
+            },
+            "peerDependencies": {
+                "picomatch": "^3 || ^4"
+            },
+            "peerDependenciesMeta": {
+                "picomatch": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/fsevents": {
+            "version": "2.3.3",
+            "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
+            "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==",
+            "dev": true,
+            "hasInstallScript": true,
+            "optional": true,
+            "os": [
+                "darwin"
+            ],
+            "engines": {
+                "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
+            }
+        },
+        "node_modules/html-encoding-sniffer": {
+            "version": "6.0.0",
+            "resolved": "https://registry.npmjs.org/html-encoding-sniffer/-/html-encoding-sniffer-6.0.0.tgz",
+            "integrity": "sha512-CV9TW3Y3f8/wT0BRFc1/KAVQ3TUHiXmaAb6VW9vtiMFf7SLoMd1PdAc4W3KFOFETBJUb90KatHqlsZMWV+R9Gg==",
+            "dev": true,
+            "dependencies": {
+                "@exodus/bytes": "^1.6.0"
+            },
+            "engines": {
+                "node": "^20.19.0 || ^22.12.0 || >=24.0.0"
+            }
+        },
+        "node_modules/http-proxy-agent": {
+            "version": "7.0.2",
+            "resolved": "https://registry.npmjs.org/http-proxy-agent/-/http-proxy-agent-7.0.2.tgz",
+            "integrity": "sha512-T1gkAiYYDWYx3V5Bmyu7HcfcvL7mUrTWiM6yOfa3PIphViJ/gFPbvidQ+veqSOHci/PxBcDabeUNCzpOODJZig==",
+            "dev": true,
+            "dependencies": {
+                "agent-base": "^7.1.0",
+                "debug": "^4.3.4"
+            },
+            "engines": {
+                "node": ">= 14"
+            }
+        },
+        "node_modules/https-proxy-agent": {
+            "version": "7.0.6",
+            "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-7.0.6.tgz",
+            "integrity": "sha512-vK9P5/iUfdl95AI+JVyUuIcVtd4ofvtrOr3HNtM2yxC9bnMbEdp3x01OhQNnjb8IJYi38VlTE3mBXwcfvywuSw==",
+            "dev": true,
+            "dependencies": {
+                "agent-base": "^7.1.2",
+                "debug": "4"
+            },
+            "engines": {
+                "node": ">= 14"
+            }
+        },
+        "node_modules/is-potential-custom-element-name": {
+            "version": "1.0.1",
+            "resolved": "https://registry.npmjs.org/is-potential-custom-element-name/-/is-potential-custom-element-name-1.0.1.tgz",
+            "integrity": "sha512-bCYeRA2rVibKZd+s2625gGnGF/t7DSqDs4dP7CrLA1m7jKWz6pps0LpYLJN8Q64HtmPKJ1hrN3nzPNKFEKOUiQ==",
+            "dev": true
+        },
+        "node_modules/jsdom": {
+            "version": "27.4.0",
+            "resolved": "https://registry.npmjs.org/jsdom/-/jsdom-27.4.0.tgz",
+            "integrity": "sha512-mjzqwWRD9Y1J1KUi7W97Gja1bwOOM5Ug0EZ6UDK3xS7j7mndrkwozHtSblfomlzyB4NepioNt+B2sOSzczVgtQ==",
+            "dev": true,
+            "dependencies": {
+                "@acemir/cssom": "^0.9.28",
+                "@asamuzakjp/dom-selector": "^6.7.6",
+                "@exodus/bytes": "^1.6.0",
+                "cssstyle": "^5.3.4",
+                "data-urls": "^6.0.0",
+                "decimal.js": "^10.6.0",
+                "html-encoding-sniffer": "^6.0.0",
+                "http-proxy-agent": "^7.0.2",
+                "https-proxy-agent": "^7.0.6",
+                "is-potential-custom-element-name": "^1.0.1",
+                "parse5": "^8.0.0",
+                "saxes": "^6.0.0",
+                "symbol-tree": "^3.2.4",
+                "tough-cookie": "^6.0.0",
+                "w3c-xmlserializer": "^5.0.0",
+                "webidl-conversions": "^8.0.0",
+                "whatwg-mimetype": "^4.0.0",
+                "whatwg-url": "^15.1.0",
+                "ws": "^8.18.3",
+                "xml-name-validator": "^5.0.0"
+            },
+            "engines": {
+                "node": "^20.19.0 || ^22.12.0 || >=24.0.0"
+            },
+            "peerDependencies": {
+                "canvas": "^3.0.0"
+            },
+            "peerDependenciesMeta": {
+                "canvas": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/lightningcss": {
+            "version": "1.32.0",
+            "resolved": "https://registry.npmjs.org/lightningcss/-/lightningcss-1.32.0.tgz",
+            "integrity": "sha512-NXYBzinNrblfraPGyrbPoD19C1h9lfI/1mzgWYvXUTe414Gz/X1FD2XBZSZM7rRTrMA8JL3OtAaGifrIKhQ5yQ==",
+            "dev": true,
+            "license": "MPL-2.0",
+            "dependencies": {
+                "detect-libc": "^2.0.3"
+            },
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            },
+            "optionalDependencies": {
+                "lightningcss-android-arm64": "1.32.0",
+                "lightningcss-darwin-arm64": "1.32.0",
+                "lightningcss-darwin-x64": "1.32.0",
+                "lightningcss-freebsd-x64": "1.32.0",
+                "lightningcss-linux-arm-gnueabihf": "1.32.0",
+                "lightningcss-linux-arm64-gnu": "1.32.0",
+                "lightningcss-linux-arm64-musl": "1.32.0",
+                "lightningcss-linux-x64-gnu": "1.32.0",
+                "lightningcss-linux-x64-musl": "1.32.0",
+                "lightningcss-win32-arm64-msvc": "1.32.0",
+                "lightningcss-win32-x64-msvc": "1.32.0"
+            }
+        },
+        "node_modules/lightningcss-android-arm64": {
+            "version": "1.32.0",
+            "resolved": "https://registry.npmjs.org/lightningcss-android-arm64/-/lightningcss-android-arm64-1.32.0.tgz",
+            "integrity": "sha512-YK7/ClTt4kAK0vo6w3X+Pnm0D2cf2vPHbhOXdoNti1Ga0al1P4TBZhwjATvjNwLEBCnKvjJc2jQgHXH0NEwlAg==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MPL-2.0",
+            "optional": true,
+            "os": [
+                "android"
+            ],
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            }
+        },
+        "node_modules/lightningcss-darwin-arm64": {
+            "version": "1.32.0",
+            "resolved": "https://registry.npmjs.org/lightningcss-darwin-arm64/-/lightningcss-darwin-arm64-1.32.0.tgz",
+            "integrity": "sha512-RzeG9Ju5bag2Bv1/lwlVJvBE3q6TtXskdZLLCyfg5pt+HLz9BqlICO7LZM7VHNTTn/5PRhHFBSjk5lc4cmscPQ==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MPL-2.0",
+            "optional": true,
+            "os": [
+                "darwin"
+            ],
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            }
+        },
+        "node_modules/lightningcss-darwin-x64": {
+            "version": "1.32.0",
+            "resolved": "https://registry.npmjs.org/lightningcss-darwin-x64/-/lightningcss-darwin-x64-1.32.0.tgz",
+            "integrity": "sha512-U+QsBp2m/s2wqpUYT/6wnlagdZbtZdndSmut/NJqlCcMLTWp5muCrID+K5UJ6jqD2BFshejCYXniPDbNh73V8w==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MPL-2.0",
+            "optional": true,
+            "os": [
+                "darwin"
+            ],
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            }
+        },
+        "node_modules/lightningcss-freebsd-x64": {
+            "version": "1.32.0",
+            "resolved": "https://registry.npmjs.org/lightningcss-freebsd-x64/-/lightningcss-freebsd-x64-1.32.0.tgz",
+            "integrity": "sha512-JCTigedEksZk3tHTTthnMdVfGf61Fky8Ji2E4YjUTEQX14xiy/lTzXnu1vwiZe3bYe0q+SpsSH/CTeDXK6WHig==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MPL-2.0",
+            "optional": true,
+            "os": [
+                "freebsd"
+            ],
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            }
+        },
+        "node_modules/lightningcss-linux-arm-gnueabihf": {
+            "version": "1.32.0",
+            "resolved": "https://registry.npmjs.org/lightningcss-linux-arm-gnueabihf/-/lightningcss-linux-arm-gnueabihf-1.32.0.tgz",
+            "integrity": "sha512-x6rnnpRa2GL0zQOkt6rts3YDPzduLpWvwAF6EMhXFVZXD4tPrBkEFqzGowzCsIWsPjqSK+tyNEODUBXeeVHSkw==",
+            "cpu": [
+                "arm"
+            ],
+            "dev": true,
+            "license": "MPL-2.0",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            }
+        },
+        "node_modules/lightningcss-linux-arm64-gnu": {
+            "version": "1.32.0",
+            "resolved": "https://registry.npmjs.org/lightningcss-linux-arm64-gnu/-/lightningcss-linux-arm64-gnu-1.32.0.tgz",
+            "integrity": "sha512-0nnMyoyOLRJXfbMOilaSRcLH3Jw5z9HDNGfT/gwCPgaDjnx0i8w7vBzFLFR1f6CMLKF8gVbebmkUN3fa/kQJpQ==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MPL-2.0",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            }
+        },
+        "node_modules/lightningcss-linux-arm64-musl": {
+            "version": "1.32.0",
+            "resolved": "https://registry.npmjs.org/lightningcss-linux-arm64-musl/-/lightningcss-linux-arm64-musl-1.32.0.tgz",
+            "integrity": "sha512-UpQkoenr4UJEzgVIYpI80lDFvRmPVg6oqboNHfoH4CQIfNA+HOrZ7Mo7KZP02dC6LjghPQJeBsvXhJod/wnIBg==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MPL-2.0",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            }
+        },
+        "node_modules/lightningcss-linux-x64-gnu": {
+            "version": "1.32.0",
+            "resolved": "https://registry.npmjs.org/lightningcss-linux-x64-gnu/-/lightningcss-linux-x64-gnu-1.32.0.tgz",
+            "integrity": "sha512-V7Qr52IhZmdKPVr+Vtw8o+WLsQJYCTd8loIfpDaMRWGUZfBOYEJeyJIkqGIDMZPwPx24pUMfwSxxI8phr/MbOA==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MPL-2.0",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            }
+        },
+        "node_modules/lightningcss-linux-x64-musl": {
+            "version": "1.32.0",
+            "resolved": "https://registry.npmjs.org/lightningcss-linux-x64-musl/-/lightningcss-linux-x64-musl-1.32.0.tgz",
+            "integrity": "sha512-bYcLp+Vb0awsiXg/80uCRezCYHNg1/l3mt0gzHnWV9XP1W5sKa5/TCdGWaR/zBM2PeF/HbsQv/j2URNOiVuxWg==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MPL-2.0",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            }
+        },
+        "node_modules/lightningcss-win32-arm64-msvc": {
+            "version": "1.32.0",
+            "resolved": "https://registry.npmjs.org/lightningcss-win32-arm64-msvc/-/lightningcss-win32-arm64-msvc-1.32.0.tgz",
+            "integrity": "sha512-8SbC8BR40pS6baCM8sbtYDSwEVQd4JlFTOlaD3gWGHfThTcABnNDBda6eTZeqbofalIJhFx0qKzgHJmcPTnGdw==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MPL-2.0",
+            "optional": true,
+            "os": [
+                "win32"
+            ],
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            }
+        },
+        "node_modules/lightningcss-win32-x64-msvc": {
+            "version": "1.32.0",
+            "resolved": "https://registry.npmjs.org/lightningcss-win32-x64-msvc/-/lightningcss-win32-x64-msvc-1.32.0.tgz",
+            "integrity": "sha512-Amq9B/SoZYdDi1kFrojnoqPLxYhQ4Wo5XiL8EVJrVsB8ARoC1PWW6VGtT0WKCemjy8aC+louJnjS7U18x3b06Q==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MPL-2.0",
+            "optional": true,
+            "os": [
+                "win32"
+            ],
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            }
+        },
+        "node_modules/lru-cache": {
+            "version": "11.3.5",
+            "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-11.3.5.tgz",
+            "integrity": "sha512-NxVFwLAnrd9i7KUBxC4DrUhmgjzOs+1Qm50D3oF1/oL+r1NpZ4gA7xvG0/zJ8evR7zIKn4vLf7qTNduWFtCrRw==",
+            "dev": true,
+            "engines": {
+                "node": "20 || >=22"
+            }
+        },
+        "node_modules/magic-string": {
+            "version": "0.30.21",
+            "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.21.tgz",
+            "integrity": "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "@jridgewell/sourcemap-codec": "^1.5.5"
+            }
+        },
+        "node_modules/mdn-data": {
+            "version": "2.27.1",
+            "resolved": "https://registry.npmjs.org/mdn-data/-/mdn-data-2.27.1.tgz",
+            "integrity": "sha512-9Yubnt3e8A0OKwxYSXyhLymGW4sCufcLG6VdiDdUGVkPhpqLxlvP5vl1983gQjJl3tqbrM731mjaZaP68AgosQ==",
+            "dev": true
+        },
+        "node_modules/ms": {
+            "version": "2.1.3",
+            "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
+            "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
+            "dev": true
+        },
+        "node_modules/nanoid": {
+            "version": "3.3.12",
+            "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.12.tgz",
+            "integrity": "sha512-ZB9RH/39qpq5Vu6Y+NmUaFhQR6pp+M2Xt76XBnEwDaGcVAqhlvxrl3B2bKS5D3NH3QR76v3aSrKaF/Kiy7lEtQ==",
+            "dev": true,
+            "funding": [
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/ai"
+                }
+            ],
+            "license": "MIT",
+            "bin": {
+                "nanoid": "bin/nanoid.cjs"
+            },
+            "engines": {
+                "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1"
+            }
+        },
+        "node_modules/obug": {
+            "version": "2.1.1",
+            "resolved": "https://registry.npmjs.org/obug/-/obug-2.1.1.tgz",
+            "integrity": "sha512-uTqF9MuPraAQ+IsnPf366RG4cP9RtUi7MLO1N3KEc+wb0a6yKpeL0lmk2IB1jY5KHPAlTc6T/JRdC/YqxHNwkQ==",
+            "dev": true,
+            "funding": [
+                "https://github.com/sponsors/sxzz",
+                "https://opencollective.com/debug"
+            ],
+            "license": "MIT"
+        },
+        "node_modules/parse5": {
+            "version": "8.0.1",
+            "resolved": "https://registry.npmjs.org/parse5/-/parse5-8.0.1.tgz",
+            "integrity": "sha512-z1e/HMG90obSGeidlli3hj7cbocou0/wa5HacvI3ASx34PecNjNQeaHNo5WIZpWofN9kgkqV1q5YvXe3F0FoPw==",
+            "dev": true,
+            "dependencies": {
+                "entities": "^8.0.0"
+            },
+            "funding": {
+                "url": "https://github.com/inikulin/parse5?sponsor=1"
+            }
+        },
+        "node_modules/pathe": {
+            "version": "2.0.3",
+            "resolved": "https://registry.npmjs.org/pathe/-/pathe-2.0.3.tgz",
+            "integrity": "sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w==",
+            "dev": true,
+            "license": "MIT"
+        },
+        "node_modules/picocolors": {
+            "version": "1.1.1",
+            "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
+            "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==",
+            "dev": true
+        },
+        "node_modules/picomatch": {
+            "version": "4.0.4",
+            "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.4.tgz",
+            "integrity": "sha512-QP88BAKvMam/3NxH6vj2o21R6MjxZUAd6nlwAS/pnGvN9IVLocLHxGYIzFhg6fUQ+5th6P4dv4eW9jX3DSIj7A==",
+            "dev": true,
+            "license": "MIT",
+            "engines": {
+                "node": ">=12"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/jonschlinkert"
+            }
+        },
+        "node_modules/postcss": {
+            "version": "8.5.15",
+            "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.15.tgz",
+            "integrity": "sha512-FfR8sjd4em2T6fb3I2MwAJU7HWVMr9zba+enmQeeWFfCbm+UOC/0X4DS8XtpUTMwWMGbjKYP7xjfNekzyGmB3A==",
+            "dev": true,
+            "funding": [
+                {
+                    "type": "opencollective",
+                    "url": "https://opencollective.com/postcss/"
+                },
+                {
+                    "type": "tidelift",
+                    "url": "https://tidelift.com/funding/github/npm/postcss"
+                },
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/ai"
+                }
+            ],
+            "license": "MIT",
+            "dependencies": {
+                "nanoid": "^3.3.12",
+                "picocolors": "^1.1.1",
+                "source-map-js": "^1.2.1"
+            },
+            "engines": {
+                "node": "^10 || ^12 || >=14"
+            }
+        },
+        "node_modules/punycode": {
+            "version": "2.3.1",
+            "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz",
+            "integrity": "sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==",
+            "dev": true,
+            "engines": {
+                "node": ">=6"
+            }
+        },
+        "node_modules/require-from-string": {
+            "version": "2.0.2",
+            "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz",
+            "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==",
+            "dev": true,
+            "engines": {
+                "node": ">=0.10.0"
+            }
+        },
+        "node_modules/rolldown": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/rolldown/-/rolldown-1.0.3.tgz",
+            "integrity": "sha512-i00lAJ2ks1BYr7rjNjKC7BcqAS7nVfiT3QX1SI5aY+AFHblCmaUf9OE9dbdzDvW6dJxbi2ZCZiy9v3CcwOiX3g==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "@oxc-project/types": "=0.133.0",
+                "@rolldown/pluginutils": "^1.0.0"
+            },
+            "bin": {
+                "rolldown": "bin/cli.mjs"
+            },
+            "engines": {
+                "node": "^20.19.0 || >=22.12.0"
+            },
+            "optionalDependencies": {
+                "@rolldown/binding-android-arm64": "1.0.3",
+                "@rolldown/binding-darwin-arm64": "1.0.3",
+                "@rolldown/binding-darwin-x64": "1.0.3",
+                "@rolldown/binding-freebsd-x64": "1.0.3",
+                "@rolldown/binding-linux-arm-gnueabihf": "1.0.3",
+                "@rolldown/binding-linux-arm64-gnu": "1.0.3",
+                "@rolldown/binding-linux-arm64-musl": "1.0.3",
+                "@rolldown/binding-linux-ppc64-gnu": "1.0.3",
+                "@rolldown/binding-linux-s390x-gnu": "1.0.3",
+                "@rolldown/binding-linux-x64-gnu": "1.0.3",
+                "@rolldown/binding-linux-x64-musl": "1.0.3",
+                "@rolldown/binding-openharmony-arm64": "1.0.3",
+                "@rolldown/binding-wasm32-wasi": "1.0.3",
+                "@rolldown/binding-win32-arm64-msvc": "1.0.3",
+                "@rolldown/binding-win32-x64-msvc": "1.0.3"
+            }
+        },
+        "node_modules/rollup": {
+            "version": "4.60.2",
+            "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.60.2.tgz",
+            "integrity": "sha512-J9qZyW++QK/09NyN/zeO0dG/1GdGfyp9lV8ajHnRVLfo/uFsbji5mHnDgn/qYdUHyCkM2N+8VyspgZclfAh0eQ==",
+            "dev": true,
+            "dependencies": {
+                "@types/estree": "1.0.8"
+            },
+            "bin": {
+                "rollup": "dist/bin/rollup"
+            },
+            "engines": {
+                "node": ">=18.0.0",
+                "npm": ">=8.0.0"
+            },
+            "optionalDependencies": {
+                "@rollup/rollup-android-arm-eabi": "4.60.2",
+                "@rollup/rollup-android-arm64": "4.60.2",
+                "@rollup/rollup-darwin-arm64": "4.60.2",
+                "@rollup/rollup-darwin-x64": "4.60.2",
+                "@rollup/rollup-freebsd-arm64": "4.60.2",
+                "@rollup/rollup-freebsd-x64": "4.60.2",
+                "@rollup/rollup-linux-arm-gnueabihf": "4.60.2",
+                "@rollup/rollup-linux-arm-musleabihf": "4.60.2",
+                "@rollup/rollup-linux-arm64-gnu": "4.60.2",
+                "@rollup/rollup-linux-arm64-musl": "4.60.2",
+                "@rollup/rollup-linux-loong64-gnu": "4.60.2",
+                "@rollup/rollup-linux-loong64-musl": "4.60.2",
+                "@rollup/rollup-linux-ppc64-gnu": "4.60.2",
+                "@rollup/rollup-linux-ppc64-musl": "4.60.2",
+                "@rollup/rollup-linux-riscv64-gnu": "4.60.2",
+                "@rollup/rollup-linux-riscv64-musl": "4.60.2",
+                "@rollup/rollup-linux-s390x-gnu": "4.60.2",
+                "@rollup/rollup-linux-x64-gnu": "4.60.2",
+                "@rollup/rollup-linux-x64-musl": "4.60.2",
+                "@rollup/rollup-openbsd-x64": "4.60.2",
+                "@rollup/rollup-openharmony-arm64": "4.60.2",
+                "@rollup/rollup-win32-arm64-msvc": "4.60.2",
+                "@rollup/rollup-win32-ia32-msvc": "4.60.2",
+                "@rollup/rollup-win32-x64-gnu": "4.60.2",
+                "@rollup/rollup-win32-x64-msvc": "4.60.2",
+                "fsevents": "~2.3.2"
+            }
+        },
+        "node_modules/saxes": {
+            "version": "6.0.0",
+            "resolved": "https://registry.npmjs.org/saxes/-/saxes-6.0.0.tgz",
+            "integrity": "sha512-xAg7SOnEhrm5zI3puOOKyy1OMcMlIJZYNJY7xLBwSze0UjhPLnWfj2GF2EpT0jmzaJKIWKHLsaSSajf35bcYnA==",
+            "dev": true,
+            "dependencies": {
+                "xmlchars": "^2.2.0"
+            },
+            "engines": {
+                "node": ">=v12.22.7"
+            }
+        },
+        "node_modules/siginfo": {
+            "version": "2.0.0",
+            "resolved": "https://registry.npmjs.org/siginfo/-/siginfo-2.0.0.tgz",
+            "integrity": "sha512-ybx0WO1/8bSBLEWXZvEd7gMW3Sn3JFlW3TvX1nREbDLRNQNaeNN8WK0meBwPdAaOI7TtRRRJn/Es1zhrrCHu7g==",
+            "dev": true
+        },
+        "node_modules/source-map-js": {
+            "version": "1.2.1",
+            "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz",
+            "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==",
+            "dev": true,
+            "engines": {
+                "node": ">=0.10.0"
+            }
+        },
+        "node_modules/stackback": {
+            "version": "0.0.2",
+            "resolved": "https://registry.npmjs.org/stackback/-/stackback-0.0.2.tgz",
+            "integrity": "sha512-1XMJE5fQo1jGH6Y/7ebnwPOBEkIEnT4QF32d5R1+VXdXveM0IBMJt8zfaxX1P3QhVwrYe+576+jkANtSS2mBbw==",
+            "dev": true
+        },
+        "node_modules/std-env": {
+            "version": "4.1.0",
+            "resolved": "https://registry.npmjs.org/std-env/-/std-env-4.1.0.tgz",
+            "integrity": "sha512-Rq7ybcX2RuC55r9oaPVEW7/xu3tj8u4GeBYHBWCychFtzMIr86A7e3PPEBPT37sHStKX3+TiX/Fr/ACmJLVlLQ==",
+            "dev": true,
+            "license": "MIT"
+        },
+        "node_modules/symbol-tree": {
+            "version": "3.2.4",
+            "resolved": "https://registry.npmjs.org/symbol-tree/-/symbol-tree-3.2.4.tgz",
+            "integrity": "sha512-9QNk5KwDF+Bvz+PyObkmSYjI5ksVUYtjW7AU22r2NKcfLJcXp96hkDWU3+XndOsUb+AQ9QhfzfCT2O+CNWT5Tw==",
+            "dev": true
+        },
+        "node_modules/tinybench": {
+            "version": "2.9.0",
+            "resolved": "https://registry.npmjs.org/tinybench/-/tinybench-2.9.0.tgz",
+            "integrity": "sha512-0+DUvqWMValLmha6lr4kD8iAMK1HzV0/aKnCtWb9v9641TnP/MFb7Pc2bxoxQjTXAErryXVgUOfv2YqNllqGeg==",
+            "dev": true
+        },
+        "node_modules/tinyexec": {
+            "version": "1.2.4",
+            "resolved": "https://registry.npmjs.org/tinyexec/-/tinyexec-1.2.4.tgz",
+            "integrity": "sha512-SHf/r48b7vOrjve9PxJo3MN5v5yuyjHvdUcrQffT3WXMUfnGmHDVbC4k3sHJaJTgZCwpUplIaAo5ANtMyp3YHg==",
+            "dev": true,
+            "license": "MIT",
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/tinyglobby": {
+            "version": "0.2.17",
+            "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.17.tgz",
+            "integrity": "sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "fdir": "^6.5.0",
+                "picomatch": "^4.0.4"
+            },
+            "engines": {
+                "node": ">=12.0.0"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/SuperchupuDev"
+            }
+        },
+        "node_modules/tinyrainbow": {
+            "version": "3.1.0",
+            "resolved": "https://registry.npmjs.org/tinyrainbow/-/tinyrainbow-3.1.0.tgz",
+            "integrity": "sha512-Bf+ILmBgretUrdJxzXM0SgXLZ3XfiaUuOj/IKQHuTXip+05Xn+uyEYdVg0kYDipTBcLrCVyUzAPz7QmArb0mmw==",
+            "dev": true,
+            "license": "MIT",
+            "engines": {
+                "node": ">=14.0.0"
+            }
+        },
+        "node_modules/tldts": {
+            "version": "7.0.28",
+            "resolved": "https://registry.npmjs.org/tldts/-/tldts-7.0.28.tgz",
+            "integrity": "sha512-+Zg3vWhRUv8B1maGSTFdev9mjoo8Etn2Ayfs4cnjlD3CsGkxXX4QyW3j2WJ0wdjYcYmy7Lx2RDsZMhgCWafKIw==",
+            "dev": true,
+            "dependencies": {
+                "tldts-core": "^7.0.28"
+            },
+            "bin": {
+                "tldts": "bin/cli.js"
+            }
+        },
+        "node_modules/tldts-core": {
+            "version": "7.0.28",
+            "resolved": "https://registry.npmjs.org/tldts-core/-/tldts-core-7.0.28.tgz",
+            "integrity": "sha512-7W5Efjhsc3chVdFhqtaU0KtK32J37Zcr9RKtID54nG+tIpcY79CQK/veYPODxtD/LJ4Lue66jvrQzIX2Z2/pUQ==",
+            "dev": true
+        },
+        "node_modules/tough-cookie": {
+            "version": "6.0.1",
+            "resolved": "https://registry.npmjs.org/tough-cookie/-/tough-cookie-6.0.1.tgz",
+            "integrity": "sha512-LktZQb3IeoUWB9lqR5EWTHgW/VTITCXg4D21M+lvybRVdylLrRMnqaIONLVb5mav8vM19m44HIcGq4qASeu2Qw==",
+            "dev": true,
+            "dependencies": {
+                "tldts": "^7.0.5"
+            },
+            "engines": {
+                "node": ">=16"
+            }
+        },
+        "node_modules/tr46": {
+            "version": "6.0.0",
+            "resolved": "https://registry.npmjs.org/tr46/-/tr46-6.0.0.tgz",
+            "integrity": "sha512-bLVMLPtstlZ4iMQHpFHTR7GAGj2jxi8Dg0s2h2MafAE4uSWF98FC/3MomU51iQAMf8/qDUbKWf5GxuvvVcXEhw==",
+            "dev": true,
+            "dependencies": {
+                "punycode": "^2.3.1"
+            },
+            "engines": {
+                "node": ">=20"
+            }
+        },
+        "node_modules/tslib": {
+            "version": "2.8.1",
+            "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz",
+            "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==",
+            "dev": true,
+            "license": "0BSD",
+            "optional": true
+        },
+        "node_modules/typescript": {
+            "version": "5.9.3",
+            "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
+            "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==",
+            "dev": true,
+            "bin": {
+                "tsc": "bin/tsc",
+                "tsserver": "bin/tsserver"
+            },
+            "engines": {
+                "node": ">=14.17"
+            }
+        },
+        "node_modules/vite": {
+            "version": "5.4.21",
+            "resolved": "https://registry.npmjs.org/vite/-/vite-5.4.21.tgz",
+            "integrity": "sha512-o5a9xKjbtuhY6Bi5S3+HvbRERmouabWbyUcpXXUA1u+GNUKoROi9byOJ8M0nHbHYHkYICiMlqxkg1KkYmm25Sw==",
+            "dev": true,
+            "dependencies": {
+                "esbuild": "^0.21.3",
+                "postcss": "^8.4.43",
+                "rollup": "^4.20.0"
+            },
+            "bin": {
+                "vite": "bin/vite.js"
+            },
+            "engines": {
+                "node": "^18.0.0 || >=20.0.0"
+            },
+            "funding": {
+                "url": "https://github.com/vitejs/vite?sponsor=1"
+            },
+            "optionalDependencies": {
+                "fsevents": "~2.3.3"
+            },
+            "peerDependencies": {
+                "@types/node": "^18.0.0 || >=20.0.0",
+                "less": "*",
+                "lightningcss": "^1.21.0",
+                "sass": "*",
+                "sass-embedded": "*",
+                "stylus": "*",
+                "sugarss": "*",
+                "terser": "^5.4.0"
+            },
+            "peerDependenciesMeta": {
+                "@types/node": {
+                    "optional": true
+                },
+                "less": {
+                    "optional": true
+                },
+                "lightningcss": {
+                    "optional": true
+                },
+                "sass": {
+                    "optional": true
+                },
+                "sass-embedded": {
+                    "optional": true
+                },
+                "stylus": {
+                    "optional": true
+                },
+                "sugarss": {
+                    "optional": true
+                },
+                "terser": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/vitest": {
+            "version": "4.1.8",
+            "resolved": "https://registry.npmjs.org/vitest/-/vitest-4.1.8.tgz",
+            "integrity": "sha512-flY6ScbCIt9HThs+C5HS7jvGOB560DJtk/Z15IQROTA6zEy49Nh8T/dofWTQL+n3vswqn87sbJNiuqw1SDp5Ig==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "@vitest/expect": "4.1.8",
+                "@vitest/mocker": "4.1.8",
+                "@vitest/pretty-format": "4.1.8",
+                "@vitest/runner": "4.1.8",
+                "@vitest/snapshot": "4.1.8",
+                "@vitest/spy": "4.1.8",
+                "@vitest/utils": "4.1.8",
+                "es-module-lexer": "^2.0.0",
+                "expect-type": "^1.3.0",
+                "magic-string": "^0.30.21",
+                "obug": "^2.1.1",
+                "pathe": "^2.0.3",
+                "picomatch": "^4.0.3",
+                "std-env": "^4.0.0-rc.1",
+                "tinybench": "^2.9.0",
+                "tinyexec": "^1.0.2",
+                "tinyglobby": "^0.2.15",
+                "tinyrainbow": "^3.1.0",
+                "vite": "^6.0.0 || ^7.0.0 || ^8.0.0",
+                "why-is-node-running": "^2.3.0"
+            },
+            "bin": {
+                "vitest": "vitest.mjs"
+            },
+            "engines": {
+                "node": "^20.0.0 || ^22.0.0 || >=24.0.0"
+            },
+            "funding": {
+                "url": "https://opencollective.com/vitest"
+            },
+            "peerDependencies": {
+                "@edge-runtime/vm": "*",
+                "@opentelemetry/api": "^1.9.0",
+                "@types/node": "^20.0.0 || ^22.0.0 || >=24.0.0",
+                "@vitest/browser-playwright": "4.1.8",
+                "@vitest/browser-preview": "4.1.8",
+                "@vitest/browser-webdriverio": "4.1.8",
+                "@vitest/coverage-istanbul": "4.1.8",
+                "@vitest/coverage-v8": "4.1.8",
+                "@vitest/ui": "4.1.8",
+                "happy-dom": "*",
+                "jsdom": "*",
+                "vite": "^6.0.0 || ^7.0.0 || ^8.0.0"
+            },
+            "peerDependenciesMeta": {
+                "@edge-runtime/vm": {
+                    "optional": true
+                },
+                "@opentelemetry/api": {
+                    "optional": true
+                },
+                "@types/node": {
+                    "optional": true
+                },
+                "@vitest/browser-playwright": {
+                    "optional": true
+                },
+                "@vitest/browser-preview": {
+                    "optional": true
+                },
+                "@vitest/browser-webdriverio": {
+                    "optional": true
+                },
+                "@vitest/coverage-istanbul": {
+                    "optional": true
+                },
+                "@vitest/coverage-v8": {
+                    "optional": true
+                },
+                "@vitest/ui": {
+                    "optional": true
+                },
+                "happy-dom": {
+                    "optional": true
+                },
+                "jsdom": {
+                    "optional": true
+                },
+                "vite": {
+                    "optional": false
+                }
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/aix-ppc64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.28.0.tgz",
+            "integrity": "sha512-lhRUCeuOyJQURhTxl4WkpFTjIsbDayJHih5kZC1giwE+MhIzAb7mEsQMqMf18rHLsrb5qI1tafG20mLxEWcWlA==",
+            "cpu": [
+                "ppc64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "aix"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/android-arm": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.28.0.tgz",
+            "integrity": "sha512-wqh0ByljabXLKHeWXYLqoJ5jKC4XBaw6Hk08OfMrCRd2nP2ZQ5eleDZC41XHyCNgktBGYMbqnrJKq/K/lzPMSQ==",
+            "cpu": [
+                "arm"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "android"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/android-arm64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.28.0.tgz",
+            "integrity": "sha512-+WzIXQOSaGs33tLEgYPYe/yQHf0WTU0X42Jca3y8NWMbUVhp7rUnw+vAsRC/QiDrdD31IszMrZy+qwPOPjd+rw==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "android"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/android-x64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.28.0.tgz",
+            "integrity": "sha512-+VJggoaKhk2VNNqVL7f6S189UzShHC/mR9EE8rDdSkdpN0KflSwWY/gWjDrNxxisg8Fp1ZCD9jLMo4m0OUfeUA==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "android"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/darwin-arm64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.28.0.tgz",
+            "integrity": "sha512-0T+A9WZm+bZ84nZBtk1ckYsOvyA3x7e2Acj1KdVfV4/2tdG4fzUp91YHx+GArWLtwqp77pBXVCPn2We7Letr0Q==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "darwin"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/darwin-x64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.28.0.tgz",
+            "integrity": "sha512-fyzLm/DLDl/84OCfp2f/XQ4flmORsjU7VKt8HLjvIXChJoFFOIL6pLJPH4Yhd1n1gGFF9mPwtlN5Wf82DZs+LQ==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "darwin"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/freebsd-arm64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.28.0.tgz",
+            "integrity": "sha512-l9GeW5UZBT9k9brBYI+0WDffcRxgHQD8ShN2Ur4xWq/NFzUKm3k5lsH4PdaRgb2w7mI9u61nr2gI2mLI27Nh3Q==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "freebsd"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/freebsd-x64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.28.0.tgz",
+            "integrity": "sha512-BXoQai/A0wPO6Es3yFJ7APCiKGc1tdAEOgeTNy3SsB491S3aHn4S4r3e976eUnPdU+NbdtmBuLncYir2tMU9Nw==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "freebsd"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/linux-arm": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.28.0.tgz",
+            "integrity": "sha512-CjaaREJagqJp7iTaNQjjidaNbCKYcd4IDkzbwwxtSvjI7NZm79qiHc8HqciMddQ6CKvJT6aBd8lO9kN/ZudLlw==",
+            "cpu": [
+                "arm"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/linux-arm64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.28.0.tgz",
+            "integrity": "sha512-RVyzfb3FWsGA55n6WY0MEIEPURL1FcbhFE6BffZEMEekfCzCIMtB5yyDcFnVbTnwk+CLAgTujmV/Lgvih56W+A==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/linux-ia32": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.28.0.tgz",
+            "integrity": "sha512-KBnSTt1kxl9x70q+ydterVdl+Cn0H18ngRMRCEQfrbqdUuntQQ0LoMZv47uB97NljZFzY6HcfqEZ2SAyIUTQBQ==",
+            "cpu": [
+                "ia32"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/linux-loong64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.28.0.tgz",
+            "integrity": "sha512-zpSlUce1mnxzgBADvxKXX5sl8aYQHo2ezvMNI8I0lbblJtp8V4odlm3Yzlj7gPyt3T8ReksE6bK+pT3WD+aJRg==",
+            "cpu": [
+                "loong64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/linux-mips64el": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.28.0.tgz",
+            "integrity": "sha512-2jIfP6mmjkdmeTlsX/9vmdmhBmKADrWqN7zcdtHIeNSCH1SqIoNI63cYsjQR8J+wGa4Y5izRcSHSm8K3QWmk3w==",
+            "cpu": [
+                "mips64el"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/linux-ppc64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.28.0.tgz",
+            "integrity": "sha512-bc0FE9wWeC0WBm49IQMPSPILRocGTQt3j5KPCA8os6VprfuJ7KD+5PzESSrJ6GmPIPJK965ZJHTUlSA6GNYEhg==",
+            "cpu": [
+                "ppc64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/linux-riscv64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.28.0.tgz",
+            "integrity": "sha512-SQPZOwoTTT/HXFXQJG/vBX8sOFagGqvZyXcgLA3NhIqcBv1BJU1d46c0rGcrij2B56Z2rNiSLaZOYW5cUk7yLQ==",
+            "cpu": [
+                "riscv64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/linux-s390x": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.28.0.tgz",
+            "integrity": "sha512-SCfR0HN8CEEjnYnySJTd2cw0k9OHB/YFzt5zgJEwa+wL/T/raGWYMBqwDNAC6dqFKmJYZoQBRfHjgwLHGSrn3Q==",
+            "cpu": [
+                "s390x"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/linux-x64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.28.0.tgz",
+            "integrity": "sha512-us0dSb9iFxIi8srnpl931Nvs65it/Jd2a2K3qs7fz2WfGPHqzfzZTfec7oxZJRNPXPnNYZtanmRc4AL/JwVzHQ==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/netbsd-x64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.28.0.tgz",
+            "integrity": "sha512-nU1yhmYutL+fQ71Kxnhg8uEOdC0pwEW9entHykTgEbna2pw2dkbFSMeqjjyHZoCmt8SBkOSvV+yNmm94aUrrqw==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "netbsd"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/openbsd-x64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.28.0.tgz",
+            "integrity": "sha512-8wZM2qqtv9UP3mzy7HiGYNH/zjTA355mpeuA+859TyR+e+Tc08IHYpLJuMsfpDJwoLo1ikIJI8jC3GFjnRClzA==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "openbsd"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/sunos-x64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.28.0.tgz",
+            "integrity": "sha512-1ZgjUoEdHZZl/YlV76TSCz9Hqj9h9YmMGAgAPYd+q4SicWNX3G5GCyx9uhQWSLcbvPW8Ni7lj4gDa1T40akdlw==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "sunos"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/win32-arm64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.28.0.tgz",
+            "integrity": "sha512-Q9StnDmQ/enxnpxCCLSg0oo4+34B9TdXpuyPeTedN/6+iXBJ4J+zwfQI28u/Jl40nOYAxGoNi7mFP40RUtkmUA==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "win32"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/win32-ia32": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.28.0.tgz",
+            "integrity": "sha512-zF3ag/gfiCe6U2iczcRzSYJKH1DCI+ByzSENHlM2FcDbEeo5Zd2C86Aq0tKUYAJJ1obRP84ymxIAksZUcdztHA==",
+            "cpu": [
+                "ia32"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "win32"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@esbuild/win32-x64": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.28.0.tgz",
+            "integrity": "sha512-pEl1bO9mfAmIC+tW5btTmrKaujg3zGtUmWNdCw/xs70FBjwAL3o9OEKNHvNmnyylD6ubxUERiEhdsL0xBQ9efw==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "os": [
+                "win32"
+            ],
+            "peer": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/vitest/node_modules/@vitest/mocker": {
+            "version": "4.1.8",
+            "resolved": "https://registry.npmjs.org/@vitest/mocker/-/mocker-4.1.8.tgz",
+            "integrity": "sha512-LEiN/xe4OSIbKe9HQIp5OC24agGD9J5CnmMgsLohVVoOPWL9a2sBoR6VBx43jQZb7Kr1l4RCuyCJzcAa0+dojw==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "@vitest/spy": "4.1.8",
+                "estree-walker": "^3.0.3",
+                "magic-string": "^0.30.21"
+            },
+            "funding": {
+                "url": "https://opencollective.com/vitest"
+            },
+            "peerDependencies": {
+                "msw": "^2.4.9",
+                "vite": "^6.0.0 || ^7.0.0 || ^8.0.0"
+            },
+            "peerDependenciesMeta": {
+                "msw": {
+                    "optional": true
+                },
+                "vite": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/vitest/node_modules/esbuild": {
+            "version": "0.28.0",
+            "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.28.0.tgz",
+            "integrity": "sha512-sNR9MHpXSUV/XB4zmsFKN+QgVG82Cc7+/aaxJ8Adi8hyOac+EXptIp45QBPaVyX3N70664wRbTcLTOemCAnyqw==",
+            "dev": true,
+            "hasInstallScript": true,
+            "license": "MIT",
+            "optional": true,
+            "peer": true,
+            "bin": {
+                "esbuild": "bin/esbuild"
+            },
+            "engines": {
+                "node": ">=18"
+            },
+            "optionalDependencies": {
+                "@esbuild/aix-ppc64": "0.28.0",
+                "@esbuild/android-arm": "0.28.0",
+                "@esbuild/android-arm64": "0.28.0",
+                "@esbuild/android-x64": "0.28.0",
+                "@esbuild/darwin-arm64": "0.28.0",
+                "@esbuild/darwin-x64": "0.28.0",
+                "@esbuild/freebsd-arm64": "0.28.0",
+                "@esbuild/freebsd-x64": "0.28.0",
+                "@esbuild/linux-arm": "0.28.0",
+                "@esbuild/linux-arm64": "0.28.0",
+                "@esbuild/linux-ia32": "0.28.0",
+                "@esbuild/linux-loong64": "0.28.0",
+                "@esbuild/linux-mips64el": "0.28.0",
+                "@esbuild/linux-ppc64": "0.28.0",
+                "@esbuild/linux-riscv64": "0.28.0",
+                "@esbuild/linux-s390x": "0.28.0",
+                "@esbuild/linux-x64": "0.28.0",
+                "@esbuild/netbsd-arm64": "0.28.0",
+                "@esbuild/netbsd-x64": "0.28.0",
+                "@esbuild/openbsd-arm64": "0.28.0",
+                "@esbuild/openbsd-x64": "0.28.0",
+                "@esbuild/openharmony-arm64": "0.28.0",
+                "@esbuild/sunos-x64": "0.28.0",
+                "@esbuild/win32-arm64": "0.28.0",
+                "@esbuild/win32-ia32": "0.28.0",
+                "@esbuild/win32-x64": "0.28.0"
+            }
+        },
+        "node_modules/vitest/node_modules/vite": {
+            "version": "8.0.16",
+            "resolved": "https://registry.npmjs.org/vite/-/vite-8.0.16.tgz",
+            "integrity": "sha512-h9bXPmJichP5fLmVQo3PyaGSDE2n3aPuomeAlVRm0JLmt4rY6zmPKd59HYI4LNW8oTK7tlTsuC7l/m7awx9Jcw==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "lightningcss": "^1.32.0",
+                "picomatch": "^4.0.4",
+                "postcss": "^8.5.15",
+                "rolldown": "1.0.3",
+                "tinyglobby": "^0.2.17"
+            },
+            "bin": {
+                "vite": "bin/vite.js"
+            },
+            "engines": {
+                "node": "^20.19.0 || >=22.12.0"
+            },
+            "funding": {
+                "url": "https://github.com/vitejs/vite?sponsor=1"
+            },
+            "optionalDependencies": {
+                "fsevents": "~2.3.3"
+            },
+            "peerDependencies": {
+                "@types/node": "^20.19.0 || >=22.12.0",
+                "@vitejs/devtools": "^0.1.18",
+                "esbuild": "^0.27.0 || ^0.28.0",
+                "jiti": ">=1.21.0",
+                "less": "^4.0.0",
+                "sass": "^1.70.0",
+                "sass-embedded": "^1.70.0",
+                "stylus": ">=0.54.8",
+                "sugarss": "^5.0.0",
+                "terser": "^5.16.0",
+                "tsx": "^4.8.1",
+                "yaml": "^2.4.2"
+            },
+            "peerDependenciesMeta": {
+                "@types/node": {
+                    "optional": true
+                },
+                "@vitejs/devtools": {
+                    "optional": true
+                },
+                "esbuild": {
+                    "optional": true
+                },
+                "jiti": {
+                    "optional": true
+                },
+                "less": {
+                    "optional": true
+                },
+                "sass": {
+                    "optional": true
+                },
+                "sass-embedded": {
+                    "optional": true
+                },
+                "stylus": {
+                    "optional": true
+                },
+                "sugarss": {
+                    "optional": true
+                },
+                "terser": {
+                    "optional": true
+                },
+                "tsx": {
+                    "optional": true
+                },
+                "yaml": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/w3c-xmlserializer": {
+            "version": "5.0.0",
+            "resolved": "https://registry.npmjs.org/w3c-xmlserializer/-/w3c-xmlserializer-5.0.0.tgz",
+            "integrity": "sha512-o8qghlI8NZHU1lLPrpi2+Uq7abh4GGPpYANlalzWxyWteJOCsr/P+oPBA49TOLu5FTZO4d3F9MnWJfiMo4BkmA==",
+            "dev": true,
+            "dependencies": {
+                "xml-name-validator": "^5.0.0"
+            },
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/webidl-conversions": {
+            "version": "8.0.1",
+            "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-8.0.1.tgz",
+            "integrity": "sha512-BMhLD/Sw+GbJC21C/UgyaZX41nPt8bUTg+jWyDeg7e7YN4xOM05YPSIXceACnXVtqyEw/LMClUQMtMZ+PGGpqQ==",
+            "dev": true,
+            "engines": {
+                "node": ">=20"
+            }
+        },
+        "node_modules/whatwg-mimetype": {
+            "version": "4.0.0",
+            "resolved": "https://registry.npmjs.org/whatwg-mimetype/-/whatwg-mimetype-4.0.0.tgz",
+            "integrity": "sha512-QaKxh0eNIi2mE9p2vEdzfagOKHCcj1pJ56EEHGQOVxp8r9/iszLUUV7v89x9O1p/T+NlTM5W7jW6+cz4Fq1YVg==",
+            "dev": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/whatwg-url": {
+            "version": "15.1.0",
+            "resolved": "https://registry.npmjs.org/whatwg-url/-/whatwg-url-15.1.0.tgz",
+            "integrity": "sha512-2ytDk0kiEj/yu90JOAp44PVPUkO9+jVhyf+SybKlRHSDlvOOZhdPIrr7xTH64l4WixO2cP+wQIcgujkGBPPz6g==",
+            "dev": true,
+            "dependencies": {
+                "tr46": "^6.0.0",
+                "webidl-conversions": "^8.0.0"
+            },
+            "engines": {
+                "node": ">=20"
+            }
+        },
+        "node_modules/why-is-node-running": {
+            "version": "2.3.0",
+            "resolved": "https://registry.npmjs.org/why-is-node-running/-/why-is-node-running-2.3.0.tgz",
+            "integrity": "sha512-hUrmaWBdVDcxvYqnyh09zunKzROWjbZTiNy8dBEjkS7ehEDQibXJ7XvlmtbwuTclUiIyN+CyXQD4Vmko8fNm8w==",
+            "dev": true,
+            "dependencies": {
+                "siginfo": "^2.0.0",
+                "stackback": "0.0.2"
+            },
+            "bin": {
+                "why-is-node-running": "cli.js"
+            },
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/ws": {
+            "version": "8.20.0",
+            "resolved": "https://registry.npmjs.org/ws/-/ws-8.20.0.tgz",
+            "integrity": "sha512-sAt8BhgNbzCtgGbt2OxmpuryO63ZoDk/sqaB/znQm94T4fCEsy/yV+7CdC1kJhOU9lboAEU7R3kquuycDoibVA==",
+            "dev": true,
+            "engines": {
+                "node": ">=10.0.0"
+            },
+            "peerDependencies": {
+                "bufferutil": "^4.0.1",
+                "utf-8-validate": ">=5.0.2"
+            },
+            "peerDependenciesMeta": {
+                "bufferutil": {
+                    "optional": true
+                },
+                "utf-8-validate": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/xml-name-validator": {
+            "version": "5.0.0",
+            "resolved": "https://registry.npmjs.org/xml-name-validator/-/xml-name-validator-5.0.0.tgz",
+            "integrity": "sha512-EvGK8EJ3DhaHfbRlETOWAS5pO9MZITeauHKJyb8wyajUfQUenkIg2MvLDTZ4T/TgIcm3HU0TFBgWWboAZ30UHg==",
+            "dev": true,
+            "engines": {
+                "node": ">=18"
+            }
+        },
+        "node_modules/xmlchars": {
+            "version": "2.2.0",
+            "resolved": "https://registry.npmjs.org/xmlchars/-/xmlchars-2.2.0.tgz",
+            "integrity": "sha512-JZnDKK8B0RCDw84FNdDAIpZK+JuJw+s7Lz8nksI7SIuU3UXJJslUthsi+uWBUYOwPFwW7W7PRLRfUKpxjtjFCw==",
+            "dev": true
+        }
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/package.json b/plugins/_bundled/sirsoft-pay_nicepayments/package.json
new file mode 100644
index 00000000..d1eaff24
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/package.json
@@ -0,0 +1,19 @@
+{
+    "name": "@g7/sirsoft-pay_nicepayments",
+    "version": "1.0.0-beta.4",
+    "type": "module",
+    "private": true,
+    "scripts": {
+        "dev": "vite",
+        "build": "vite build",
+        "preview": "vite preview",
+        "test": "vitest",
+        "test:run": "vitest run"
+    },
+    "devDependencies": {
+        "jsdom": "^27.4.0",
+        "typescript": "^5.3.3",
+        "vite": "^5.4.14",
+        "vitest": "^4.1.8"
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/plugin.json b/plugins/_bundled/sirsoft-pay_nicepayments/plugin.json
new file mode 100644
index 00000000..5e84fd04
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/plugin.json
@@ -0,0 +1,34 @@
+{
+    "identifier": "sirsoft-pay_nicepayments",
+    "vendor": "sirsoft",
+    "name": {
+        "ko": "나이스페이먼츠",
+        "en": "NicePayments"
+    },
+    "version": "1.0.0-beta.4",
+    "license": "MIT",
+    "github_url": "https://github.com/gnuboard/g7-plugin-sirsoft-pay_nicepayments",
+    "github_changelog_url": "https://github.com/gnuboard/g7-plugin-sirsoft-pay_nicepayments/blob/main/CHANGELOG.md",
+    "description": {
+        "ko": "나이스페이먼츠 결제 게이트웨이 (통합결제창 연동)",
+        "en": "NicePayments gateway (integrated payment window)"
+    },
+    "g7_version": ">=7.0.0-beta.2",
+    "dependencies": {
+        "modules": {
+            "sirsoft-ecommerce": ">=1.0.0-beta.5"
+        },
+        "plugins": {}
+    },
+    "assets": {
+        "js": {
+            "entry": "resources/js/index.ts",
+            "output": "dist/js/plugin.iife.js"
+        },
+        "handlers": true
+    },
+    "loading": {
+        "strategy": "global",
+        "priority": 100
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/plugin.php b/plugins/_bundled/sirsoft-pay_nicepayments/plugin.php
new file mode 100644
index 00000000..3464316c
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/plugin.php
@@ -0,0 +1,232 @@
+<?php
+
+namespace Plugins\Sirsoft\PayNicepayments;
+
+use App\Extension\AbstractPlugin;
+
+/**
+ * 나이스페이먼츠 PG 플러그인
+ *
+ * 나이스페이먼츠 통합결제창(카드/계좌이체/가상계좌/휴대폰) 연동을 제공합니다.
+ * sirsoft-ecommerce 모듈 전용 플러그인입니다.
+ */
+class Plugin extends AbstractPlugin
+{
+    public function getMetadata(): array
+    {
+        return [
+            'author' => 'Sirsoft',
+            'license' => 'MIT',
+            'homepage' => 'https://sir.kr',
+            'keywords' => ['payment', 'nicepayments', 'nicepay', 'pg', 'card', 'ecommerce'],
+        ];
+    }
+
+    public function getSettingsSchema(): array
+    {
+        return [
+            'is_test_mode' => [
+                'type' => 'boolean',
+                'default' => true,
+                'label' => ['ko' => '테스트 모드', 'en' => 'Test Mode'],
+                'hint' => [
+                    'ko' => '테스트 모드에서는 실제 결제가 발생하지 않습니다.',
+                    'en' => 'No real payments occur in test mode.',
+                ],
+            ],
+            'test_mid' => [
+                'type' => 'string',
+                'default' => 'nicepay00m',
+                'label' => ['ko' => '테스트 가맹점 ID (MID)', 'en' => 'Test Merchant ID (MID)'],
+                'hint' => [
+                    'ko' => '나이스페이먼츠 공용 테스트 MID입니다. 테스트 전용이며 변경하지 않아도 됩니다.',
+                    'en' => 'NicePayments shared test MID. No change needed for testing.',
+                ],
+            ],
+            'test_merchant_key' => [
+                'type' => 'string',
+                'default' => 'EYzu8jGGMfqaDEp76gSckuvnaHHu+bC4opsSN6lHv3b2lurNYkVXrZ7Z1AoqQnXI3eLuaUFyoRNC6FkrzVjceg==',
+                'sensitive' => true,
+                'label' => ['ko' => '테스트 가맹점 키', 'en' => 'Test Merchant Key'],
+                'hint' => [
+                    'ko' => '나이스페이먼츠 공용 테스트 키입니다. 테스트 전용이며 변경하지 않아도 됩니다.',
+                    'en' => 'NicePayments shared test key. No change needed for testing.',
+                ],
+            ],
+            'live_mid' => [
+                'type' => 'string',
+                'default' => '',
+                'label' => ['ko' => '라이브 가맹점 ID (MID)', 'en' => 'Live Merchant ID (MID)'],
+            ],
+            'live_merchant_key' => [
+                'type' => 'string',
+                'default' => '',
+                'sensitive' => true,
+                'label' => ['ko' => '라이브 가맹점 키', 'en' => 'Live Merchant Key'],
+                'hint' => [
+                    'ko' => '외부에 노출되지 않도록 주의하세요.',
+                    'en' => 'Keep this key secret.',
+                ],
+            ],
+            'redirect_success_url' => [
+                'type' => 'string',
+                'default' => '/shop/orders/{orderId}/complete',
+                'label' => ['ko' => '결제 성공 리다이렉트 URL', 'en' => 'Payment Success Redirect URL'],
+                'hint' => [
+                    'ko' => '상대 경로(/shop/...) 또는 전체 URL(https://...) 모두 가능합니다. {orderId}는 주문번호로 자동 치환됩니다.',
+                    'en' => 'Supports relative paths (/shop/...) or full URLs (https://...). {orderId} will be replaced with the actual order number.',
+                ],
+            ],
+            'redirect_fail_url' => [
+                'type' => 'string',
+                'default' => '/shop/checkout',
+                'label' => ['ko' => '결제 실패 리다이렉트 URL', 'en' => 'Payment Failure Redirect URL'],
+                'hint' => [
+                    'ko' => '상대 경로 또는 전체 URL 모두 가능합니다. 오류 정보는 쿼리 파라미터로 자동 추가됩니다.',
+                    'en' => 'Supports relative paths or full URLs. Error details are appended as query parameters.',
+                ],
+            ],
+            'use_escrow' => [
+                'type' => 'boolean',
+                'default' => false,
+                'label' => ['ko' => '에스크로 결제 사용', 'en' => 'Enable Escrow Payment'],
+                'hint' => [
+                    'ko' => '실물 상품 판매 시 구매자 보호를 위한 에스크로 결제를 활성화합니다. 에스크로 결제 후 배송 등록이 필요합니다.',
+                    'en' => 'Enables escrow payment for buyer protection when selling physical goods. Delivery registration is required after escrow payment.',
+                ],
+            ],
+            'easy_pay_allow_with_other_pg' => [
+                'type' => 'boolean',
+                'default' => false,
+                'label' => ['ko' => '타 PG와 사용가능함', 'en' => 'Allow with other PG'],
+                'hint' => [
+                    'ko' => '활성화하면, 다른 PG사가 기본 결제수단으로 설정된 경우에도 체크아웃 페이지에 나이스페이 간편결제 버튼이 표시됩니다.',
+                    'en' => 'When enabled, NicePay easy pay buttons will appear on the checkout page even when another PG is set as the default payment provider.',
+                ],
+            ],
+            'easy_pay_naverpay' => [
+                'type' => 'boolean',
+                'default' => false,
+                'label' => ['ko' => '네이버페이 간편결제', 'en' => 'Naver Pay'],
+                'hint' => [
+                    'ko' => '테스트 모드에서도 사용 가능합니다.',
+                    'en' => 'Available in test mode.',
+                ],
+            ],
+            'easy_pay_kakaopay' => [
+                'type' => 'boolean',
+                'default' => false,
+                'label' => ['ko' => '카카오페이 간편결제', 'en' => 'Kakao Pay'],
+            ],
+            'easy_pay_samsungpay' => [
+                'type' => 'boolean',
+                'default' => false,
+                'label' => ['ko' => '삼성페이 간편결제', 'en' => 'Samsung Pay'],
+            ],
+            'easy_pay_applepay' => [
+                'type' => 'boolean',
+                'default' => false,
+                'label' => ['ko' => '애플페이 간편결제', 'en' => 'Apple Pay'],
+                'hint' => [
+                    'ko' => 'Safari 브라우저 및 Apple 기기에서만 사용 가능합니다.',
+                    'en' => 'Available on Safari browser and Apple devices only.',
+                ],
+            ],
+            'easy_pay_payco' => [
+                'type' => 'boolean',
+                'default' => false,
+                'label' => ['ko' => 'PAYCO 간편결제', 'en' => 'PAYCO'],
+            ],
+            'easy_pay_skpay' => [
+                'type' => 'boolean',
+                'default' => false,
+                'label' => ['ko' => '11pay (SK페이) 간편결제', 'en' => '11pay (SK Pay)'],
+            ],
+            'easy_pay_ssgpay' => [
+                'type' => 'boolean',
+                'default' => false,
+                'label' => ['ko' => 'SSG페이 간편결제', 'en' => 'SSG Pay'],
+            ],
+            'easy_pay_lpay' => [
+                'type' => 'boolean',
+                'default' => false,
+                'label' => ['ko' => 'L.pay 간편결제', 'en' => 'L.pay'],
+            ],
+        ];
+    }
+
+    public function getConfigValues(): array
+    {
+        return [
+            'is_test_mode' => true,
+            'test_mid' => 'nicepay00m',
+            'test_merchant_key' => 'EYzu8jGGMfqaDEp76gSckuvnaHHu+bC4opsSN6lHv3b2lurNYkVXrZ7Z1AoqQnXI3eLuaUFyoRNC6FkrzVjceg==',
+            'live_mid' => '',
+            'live_merchant_key' => '',
+            'redirect_success_url' => '/shop/orders/{orderId}/complete',
+            'redirect_fail_url' => '/shop/checkout',
+            'use_escrow' => false,
+            'easy_pay_allow_with_other_pg' => false,
+            'easy_pay_naverpay' => false,
+            'easy_pay_kakaopay' => false,
+            'easy_pay_samsungpay' => false,
+            'easy_pay_applepay' => false,
+            'easy_pay_payco' => false,
+            'easy_pay_skpay' => false,
+            'easy_pay_ssgpay' => false,
+            'easy_pay_lpay' => false,
+        ];
+    }
+
+    public function getHookListeners(): array
+    {
+        return [
+            Listeners\RegisterPgProviderListener::class,
+            Listeners\PaymentRefundListener::class,
+            Listeners\CancelActivityLogListener::class,
+            Listeners\RegisterEasyPayMethodsListener::class,
+            Listeners\AdjustEcommercePaymentMethodsLayoutListener::class,
+            Listeners\EnsureAdminOrderListTestBadgeLayoutListener::class,
+            Listeners\EnsureAdminOrderDetailPaymentQueryLayoutListener::class,
+            Listeners\RestoreLayoutExtensionsAfterUpdateListener::class,
+        ];
+    }
+
+    public function getHooks(): array
+    {
+        return [
+            [
+                'name' => 'sirsoft-pay_nicepayments.payment.before_authorize',
+                'type' => 'action',
+                'description' => [
+                    'ko' => '나이스페이먼츠 서버 승인 API 호출 전',
+                    'en' => 'Before NicePayments server authorization API call',
+                ],
+            ],
+            [
+                'name' => 'sirsoft-pay_nicepayments.payment.after_authorize',
+                'type' => 'action',
+                'description' => [
+                    'ko' => '나이스페이먼츠 서버 승인 완료 후',
+                    'en' => 'After NicePayments server authorization completed',
+                ],
+            ],
+            [
+                'name' => 'sirsoft-pay_nicepayments.payment.before_cancel',
+                'type' => 'action',
+                'description' => [
+                    'ko' => '나이스페이먼츠 결제 취소 API 호출 전 (본인인증 등 확장 지점)',
+                    'en' => 'Before NicePayments cancel API call (extension point for re-auth, etc.)',
+                ],
+            ],
+            [
+                'name' => 'sirsoft-pay_nicepayments.payment.after_cancel',
+                'type' => 'action',
+                'description' => [
+                    'ko' => '나이스페이먼츠 결제 취소 완료 후',
+                    'en' => 'After NicePayments cancel completed',
+                ],
+            ],
+        ];
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/resources/extensions/admin_order_list_test_badge.json b/plugins/_bundled/sirsoft-pay_nicepayments/resources/extensions/admin_order_list_test_badge.json
new file mode 100644
index 00000000..15aaa8bd
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/resources/extensions/admin_order_list_test_badge.json
@@ -0,0 +1,266 @@
+{
+    "target_layout": "admin_ecommerce_order_list",
+    "data_sources": [
+        {
+            "id": "nicepay_test_map",
+            "label_key": "$t:sirsoft-pay_nicepayments.editor.data_source.nicepay_test_map",
+            "type": "api",
+            "endpoint": "/api/plugins/sirsoft-pay_nicepayments/admin/orders/test-mode-map",
+            "method": "GET",
+            "auto_fetch": true,
+            "auth_required": true,
+            "loading_strategy": "progressive"
+        }
+    ],
+    "injections": [
+        {
+            "target_id": "order_datagrid",
+            "position": "inject_props",
+            "props": {
+                "columns": [
+                    {
+                        "field": "no",
+                        "header": "NO",
+                        "width": "60px",
+                        "sortable": false,
+                        "required": false,
+                        "cellChildren": [
+                            { "type": "basic", "name": "Span", "text": "{{row.no}}" }
+                        ]
+                    },
+                    {
+                        "field": "ordered_at",
+                        "header": "$t:sirsoft-ecommerce.admin.order.column.order_date",
+                        "width": "140px",
+                        "sortable": true,
+                        "required": true,
+                        "cellChildren": [
+                            { "type": "basic", "name": "Span", "text": "{{row.ordered_at_formatted}}" }
+                        ]
+                    },
+                    {
+                        "field": "order_number",
+                        "header": "$t:sirsoft-ecommerce.admin.order.column.order_number",
+                        "width": "140px",
+                        "sortable": true,
+                        "required": true,
+                        "cellChildren": [
+                            {
+                                "type": "basic",
+                                "name": "Span",
+                                "props": { "className": "font-medium text-blue-600 dark:text-blue-400 cursor-pointer hover:underline" },
+                                "text": "{{row.order_number}}",
+                                "actions": [
+                                    { "type": "click", "handler": "navigate", "params": { "path": "/admin/ecommerce/orders/{{row.order_number}}" } }
+                                ]
+                            }
+                        ]
+                    },
+                    {
+                        "field": "product",
+                        "header": "$t:sirsoft-ecommerce.admin.order.column.product",
+                        "width": "auto",
+                        "sortable": false,
+                        "required": false,
+                        "cellChildren": [
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": { "className": "flex items-start gap-2" },
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "Img",
+                                        "props": { "src": "{{row.first_option?.thumbnail_url}}", "alt": "{{row.first_option?.product_name}}", "className": "w-10 h-10 rounded object-cover flex-shrink-0 bg-gray-100 dark:bg-gray-700" },
+                                        "if": "{{row.first_option?.thumbnail_url}}"
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": { "className": "space-y-0.5 min-w-0" },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "props": { "className": "font-medium" },
+                                                "children": [
+                                                    { "type": "basic", "name": "A", "props": { "className": "hover:underline hover:text-blue-600 dark:text-blue-400 dark:hover:text-blue-400 cursor-pointer", "href": "{{'\/admin\/ecommerce\/products\/' + row.first_option?.product_code + '\/edit'}}", "target": "_blank" }, "text": "{{row.first_option?.product_name}}", "if": "{{row.first_option?.product_code}}" },
+                                                    { "type": "basic", "name": "Span", "text": "{{row.first_option?.product_name}}", "if": "{{!row.first_option?.product_code}}" },
+                                                    { "type": "basic", "name": "Span", "props": { "className": "text-gray-500 dark:text-gray-400 font-normal ml-1" }, "text": "$t:defer:sirsoft-ecommerce.admin.order.product.more|count={{row.options_count - 1}}", "if": "{{row.options_count > 1}}" }
+                                                ]
+                                            },
+                                            { "type": "basic", "name": "Div", "props": { "className": "text-tertiary" }, "text": "{{row.first_option?.product_option_name}}", "if": "{{row.first_option?.product_option_name}}" }
+                                        ]
+                                    }
+                                ]
+                            }
+                        ]
+                    },
+                    {
+                        "field": "order_amount",
+                        "header": "$t:sirsoft-ecommerce.admin.order.column.order_amount",
+                        "width": "140px",
+                        "sortable": true,
+                        "required": true,
+                        "cellChildren": [
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": { "className": "row-stack" },
+                                "children": [
+                                    { "type": "basic", "name": "Span", "props": { "className": "font-medium" }, "text": "{{row.total_amount_formatted}}" },
+                                    { "type": "basic", "name": "Span", "props": { "className": "text-xs text-gray-400 dark:text-gray-500" }, "text": "$t:defer:sirsoft-ecommerce.admin.order.column.shipping_fee_short|amount={{row.total_shipping_amount_formatted}}", "if": "{{row.total_shipping_amount > 0}}" },
+                                    { "type": "basic", "name": "Span", "props": { "className": "text-xs text-green-600 dark:text-green-400" }, "text": "$t:defer:sirsoft-ecommerce.admin.order.column.paid_short|amount={{row.total_paid_amount_formatted}}", "if": "{{row.total_paid_amount > 0}}" },
+                                    { "type": "basic", "name": "Span", "props": { "className": "text-xs text-red-600 dark:text-red-400" }, "text": "$t:defer:sirsoft-ecommerce.admin.order.column.unpaid_short|amount={{row.total_unpaid_amount_formatted}}", "if": "{{row.total_unpaid_amount > 0}}" }
+                                ]
+                            }
+                        ]
+                    },
+                    {
+                        "field": "order_status",
+                        "header": "$t:sirsoft-ecommerce.admin.order.column.order_status",
+                        "width": "100px",
+                        "sortable": false,
+                        "required": false,
+                        "cellChildren": [
+                            { "type": "composite", "name": "StatusBadge", "props": { "status": "{{row.order_status_variant || 'default'}}", "label": "{{row.order_status_label}}", "showIcon": false } }
+                        ]
+                    },
+                    {
+                        "field": "orderer",
+                        "header": "$t:sirsoft-ecommerce.admin.order.column.orderer",
+                        "width": "140px",
+                        "sortable": false,
+                        "required": false,
+                        "cellChildren": [
+                            { "type": "basic", "name": "Span", "props": { "className": "text-gray-500 dark:text-gray-400" }, "text": "-", "if": "{{!row.address?.orderer_name && !row.user?.name}}" },
+                            {
+                                "type": "composite",
+                                "name": "ActionMenu",
+                                "if": "{{!!row.address?.orderer_name || !!row.user?.name}}",
+                                "props": {
+                                    "position": "right",
+                                    "items": [
+                                        { "id": "view_member", "label": "$t:sirsoft-ecommerce.admin.order.action.view_member", "iconName": "user", "if": "{{!!row.user?.uuid}}" },
+                                        { "id": "search_by_orderer_member", "label": "$t:sirsoft-ecommerce.admin.order.action.search_by_orderer", "iconName": "magnifying-glass", "if": "{{!!row.user?.uuid}}" },
+                                        { "id": "search_by_orderer_guest", "label": "$t:sirsoft-ecommerce.admin.order.action.search_by_orderer", "iconName": "magnifying-glass", "if": "{{!row.user?.uuid}}" }
+                                    ]
+                                },
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": { "className": "flex-center gap-2 hover:bg-gray-50 dark:bg-gray-800 dark:hover:bg-gray-700 rounded-lg px-1 py-0.5 transition-colors" },
+                                        "children": [
+                                            { "type": "basic", "name": "Icon", "if": "{{!!row.user?.uuid}}", "props": { "name": "fa-regular fa-user", "className": "text-gray-400 dark:text-gray-500 flex-shrink-0" } },
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "props": { "className": "min-w-0 flex-1" },
+                                                "children": [
+                                                    { "type": "basic", "name": "Span", "if": "{{!!row.user?.uuid}}", "props": { "className": "font-medium text-gray-900 dark:text-gray-100 truncate block" }, "text": "{{row.address?.orderer_name || row.user?.name}}" },
+                                                    { "type": "basic", "name": "Span", "if": "{{!row.user?.uuid}}", "props": { "className": "text-gray-600 dark:text-gray-400 truncate block" }, "text": "{{row.address?.orderer_name || row.user?.name}}" },
+                                                    { "type": "basic", "name": "Span", "comment": "첫구매 표시", "if": "{{row.is_first_order}}", "props": { "className": "text-xs text-emerald-500 dark:text-emerald-400" }, "text": "$t:sirsoft-ecommerce.admin.order.column.first_order" }
+                                                ]
+                                            }
+                                        ]
+                                    }
+                                ],
+                                "actions": [
+                                    {
+                                        "event": "onItemClick",
+                                        "handler": "switch",
+                                        "value": "{{$args[0]}}",
+                                        "cases": {
+                                            "view_member": { "handler": "openWindow", "params": { "path": "/admin/users/{{row.user?.uuid}}" } },
+                                            "search_by_orderer_member": {
+                                                "handler": "sequence",
+                                                "actions": [
+                                                    { "handler": "setState", "params": { "target": "_local", "filter.ordererUuid": "{{row.user?.uuid}}", "filter.searchField": "all", "filter.searchKeyword": "", "ordererSearchResults": "{{[{ uuid: row.user?.uuid, name: row.user?.name || row.address?.orderer_name, email: row.user?.email || '' }]}}" } },
+                                                    { "handler": "navigate", "params": { "path": "/admin/ecommerce/orders", "query": { "orderer_uuid": "{{row.user?.uuid}}", "page": 1 }, "transition_overlay_target": "order_datagrid__body" } }
+                                                ]
+                                            },
+                                            "search_by_orderer_guest": {
+                                                "handler": "sequence",
+                                                "actions": [
+                                                    { "handler": "setState", "params": { "target": "_local", "filter.searchField": "orderer_name", "filter.searchKeyword": "{{row.address?.orderer_name || row.user?.name}}" } },
+                                                    { "handler": "navigate", "params": { "path": "/admin/ecommerce/orders", "query": { "search_field": "orderer_name", "search_keyword": "{{row.address?.orderer_name || row.user?.name}}", "page": 1 }, "transition_overlay_target": "order_datagrid__body" } }
+                                                ]
+                                            }
+                                        }
+                                    }
+                                ]
+                            }
+                        ]
+                    },
+                    {
+                        "field": "payment_method",
+                        "header": "$t:sirsoft-ecommerce.admin.order.column.payment_method",
+                        "width": "100px",
+                        "sortable": false,
+                        "required": false,
+                        "cellChildren": [
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": { "className": "row-stack" },
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "Span",
+                                        "text": "{{row.payment?.payment_method_label}}"
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "Span",
+                                        "if": "{{nicepay_test_map.data?.[row.order_number] === true}}",
+                                        "props": { "className": "text-xs font-medium text-orange-500 dark:text-orange-400 leading-tight" },
+                                        "text": "($t:sirsoft-pay_nicepayments.admin.test_mode_badge)"
+                                    }
+                                ]
+                            }
+                        ]
+                    },
+                    {
+                        "field": "delivery_method",
+                        "header": "$t:sirsoft-ecommerce.admin.order.column.delivery_method",
+                        "width": "100px",
+                        "sortable": false,
+                        "required": false,
+                        "cellChildren": [
+                            { "type": "basic", "name": "Span", "text": "{{row.shipping?.shipping_type_label}}" }
+                        ]
+                    },
+                    {
+                        "field": "country",
+                        "header": "$t:sirsoft-ecommerce.admin.order.column.country",
+                        "width": "80px",
+                        "sortable": false,
+                        "required": false,
+                        "cellChildren": [
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": { "className": "flex-center gap-2" },
+                                "children": [
+                                    { "type": "basic", "name": "Span", "props": { "className": "fi fi-{{row.address?.recipient_country_code?.toLowerCase()}} flex-shrink-0" }, "if": "{{row.address?.recipient_country_code}}" },
+                                    { "type": "basic", "name": "Span", "text": "{{$localized(row.address?.recipient_country_name) ?? row.address?.recipient_country_code}}", "if": "{{row.address?.recipient_country_code}}" }
+                                ]
+                            }
+                        ]
+                    },
+                    {
+                        "field": "device",
+                        "header": "$t:sirsoft-ecommerce.admin.order.column.device",
+                        "width": "80px",
+                        "sortable": false,
+                        "required": false,
+                        "cellChildren": [
+                            { "type": "basic", "name": "Span", "text": "{{row.order_device_label}}" }
+                        ]
+                    }
+                ]
+            }
+        }
+    ]
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/resources/extensions/admin_order_payment_query.json b/plugins/_bundled/sirsoft-pay_nicepayments/resources/extensions/admin_order_payment_query.json
new file mode 100644
index 00000000..855f99db
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/resources/extensions/admin_order_payment_query.json
@@ -0,0 +1,828 @@
+{
+    "target_layout": "admin_ecommerce_order_detail",
+    "data_sources": [
+        {
+            "id": "nicepay_escrow",
+            "label_key": "$t:sirsoft-pay_nicepayments.editor.data_source.nicepay_escrow",
+            "type": "api",
+            "endpoint": "/api/plugins/sirsoft-pay_nicepayments/admin/orders/{{route.orderNumber}}/escrow-payments",
+            "method": "GET",
+            "auto_fetch": true,
+            "auth_required": true
+        },
+        {
+            "id": "nicepay_status",
+            "label_key": "$t:sirsoft-pay_nicepayments.editor.data_source.nicepay_status",
+            "type": "api",
+            "endpoint": "/api/plugins/sirsoft-pay_nicepayments/admin/orders/{{route.orderNumber}}/transaction-status",
+            "method": "GET",
+            "auto_fetch": true,
+            "auth_required": true
+        }
+    ],
+    "injections": [
+        {
+            "target_id": "sticky_header_container",
+            "position": "append_child",
+            "components": [
+                {
+                    "type": "basic",
+                    "name": "Div",
+                    "if": "{{nicepay_status.data?._is_test_mode === true}}",
+                    "props": { "className": "mx-6 mb-3 px-3 py-2 bg-orange-50 dark:bg-orange-900/20 border border-orange-200 dark:border-orange-700 rounded-lg flex-center gap-2" },
+                    "children": [
+                        {
+                            "type": "basic",
+                            "name": "Icon",
+                            "props": { "name": "flask-conical", "className": "w-4 h-4 text-orange-600 dark:text-orange-400 flex-shrink-0" }
+                        },
+                        {
+                            "type": "basic",
+                            "name": "Span",
+                            "props": { "className": "text-sm font-semibold text-orange-800 dark:text-orange-300" },
+                            "text": "$t:sirsoft-pay_nicepayments.admin.test_mode_badge"
+                        },
+                        {
+                            "type": "basic",
+                            "name": "Span",
+                            "props": { "className": "text-sm text-orange-700 dark:text-orange-400" },
+                            "text": "$t:sirsoft-pay_nicepayments.admin.test_mode_order_notice"
+                        }
+                    ]
+                }
+            ]
+        },
+        {
+            "target_id": "tab_content_area",
+            "position": "prepend_child",
+            "components": [
+                {
+                    "type": "basic",
+                    "name": "Div",
+                    "if": "{{(nicepay_escrow.data?.escrow_payments ?? []).length > 0}}",
+                    "props": { "className": "alert-success" },
+                    "children": [
+                        {
+                            "type": "basic",
+                            "name": "Span",
+                            "props": { "className": "inline-flex items-center px-2 py-0.5 rounded text-xs font-semibold bg-emerald-500 text-white flex-shrink-0" },
+                            "text": "$t:sirsoft-pay_nicepayments.admin.escrow_badge"
+                        },
+                        {
+                            "type": "basic",
+                            "name": "Span",
+                            "props": { "className": "text-success-soft" },
+                            "text": "$t:sirsoft-pay_nicepayments.admin.escrow_payment_notice"
+                        }
+                    ]
+                }
+            ]
+        },
+        {
+            "target_id": "tab_content_area",
+            "position": "append_child",
+            "components": [
+                {
+                    "id": "nicepay_escrow_panel",
+                    "type": "basic",
+                    "name": "Div",
+                    "if": "{{(nicepay_escrow.data?.escrow_payments ?? []).length > 0}}",
+                    "props": {
+                        "className": "admin-card"
+                    },
+                    "children": [
+                        {
+                            "id": "nicepay_escrow_header",
+                            "type": "basic",
+                            "name": "Div",
+                            "props": { "className": "flex-center gap-2 mb-4" },
+                            "children": [
+                                {
+                                    "type": "basic",
+                                    "name": "Div",
+                                    "props": { "className": "w-1.5 h-4 bg-emerald-500 rounded-full flex-shrink-0" }
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "H3",
+                                    "props": { "className": "text-sm font-semibold text-gray-800 dark:text-gray-200" },
+                                    "text": "$t:sirsoft-pay_nicepayments.admin.escrow_delivery_title"
+                                }
+                            ]
+                        },
+                        {
+                            "id": "nicepay_escrow_payments",
+                            "type": "basic",
+                            "name": "Div",
+                            "props": { "className": "space-y-4" },
+                            "iteration": {
+                                "source": "{{nicepay_escrow.data?.escrow_payments?.filter(p => p.transaction_id) ?? []}}",
+                                "item_var": "payment",
+                                "index_var": "eIdx"
+                            },
+                            "children": [
+                                {
+                                    "type": "basic",
+                                    "name": "Div",
+                                    "props": { "className": "rounded-lg border border-gray-100 dark:border-gray-700 p-4 bg-gray-50 dark:bg-gray-800/50 space-y-4" },
+                                    "children": [
+                                        {
+                                            "type": "basic",
+                                            "name": "Div",
+                                            "props": { "className": "flex-center gap-2" },
+                                            "children": [
+                                                {
+                                                    "type": "basic",
+                                                    "name": "Span",
+                                                    "props": { "className": "text-tertiary" },
+                                                    "text": "TID:"
+                                                },
+                                                {
+                                                    "type": "basic",
+                                                    "name": "Span",
+                                                    "props": { "className": "font-mono text-xs text-gray-900 dark:text-gray-100" },
+                                                    "text": "{{payment.transaction_id}}"
+                                                }
+                                            ]
+                                        },
+                                        {
+                                            "type": "basic",
+                                            "name": "Div",
+                                            "props": { "className": "grid grid-cols-1 sm:grid-cols-2 gap-3" },
+                                            "children": [
+                                                {
+                                                    "type": "basic",
+                                                    "name": "Div",
+                                                    "children": [
+                                                        {
+                                                            "type": "basic",
+                                                            "name": "Label",
+                                                            "props": { "className": "text-secondary block text-xs font-medium mb-1" },
+                                                            "text": "$t:sirsoft-pay_nicepayments.admin.escrow_delivery_company"
+                                                        },
+                                                        {
+                                                            "type": "basic",
+                                                            "name": "Input",
+                                                            "props": {
+                                                                "type": "text",
+                                                                "placeholder": "$t:sirsoft-pay_nicepayments.admin.escrow_delivery_company_placeholder",
+                                                                "className": "text-primary w-full px-3 py-2 border border-gray-300 dark:border-gray-600 rounded-lg bg-white dark:bg-gray-700 text-sm focus:ring-2 focus:ring-emerald-500 focus:border-transparent"
+                                                            },
+                                                            "bindLocal": "_escrow_delivery_name"
+                                                        }
+                                                    ]
+                                                },
+                                                {
+                                                    "type": "basic",
+                                                    "name": "Div",
+                                                    "children": [
+                                                        {
+                                                            "type": "basic",
+                                                            "name": "Label",
+                                                            "props": { "className": "text-secondary block text-xs font-medium mb-1" },
+                                                            "text": "$t:sirsoft-pay_nicepayments.admin.escrow_tracking_number"
+                                                        },
+                                                        {
+                                                            "type": "basic",
+                                                            "name": "Input",
+                                                            "props": {
+                                                                "type": "text",
+                                                                "placeholder": "$t:sirsoft-pay_nicepayments.admin.escrow_tracking_number_placeholder",
+                                                                "className": "text-primary w-full px-3 py-2 border border-gray-300 dark:border-gray-600 rounded-lg bg-white dark:bg-gray-700 text-sm font-mono focus:ring-2 focus:ring-emerald-500 focus:border-transparent"
+                                                            },
+                                                            "bindLocal": "_escrow_tracking_number"
+                                                        }
+                                                    ]
+                                                },
+                                                {
+                                                    "type": "basic",
+                                                    "name": "Div",
+                                                    "children": [
+                                                        {
+                                                            "type": "basic",
+                                                            "name": "Label",
+                                                            "props": { "className": "text-secondary block text-xs font-medium mb-1" },
+                                                            "text": "$t:sirsoft-pay_nicepayments.admin.escrow_register_name"
+                                                        },
+                                                        {
+                                                            "type": "basic",
+                                                            "name": "Input",
+                                                            "props": {
+                                                                "type": "text",
+                                                                "className": "text-primary w-full px-3 py-2 border border-gray-300 dark:border-gray-600 rounded-lg bg-white dark:bg-gray-700 text-sm focus:ring-2 focus:ring-emerald-500 focus:border-transparent"
+                                                            },
+                                                            "bindLocal": "_escrow_register_name"
+                                                        }
+                                                    ]
+                                                },
+                                                {
+                                                    "type": "basic",
+                                                    "name": "Div",
+                                                    "props": { "className": "sm:col-span-2" },
+                                                    "children": [
+                                                        {
+                                                            "type": "basic",
+                                                            "name": "Label",
+                                                            "props": { "className": "text-secondary block text-xs font-medium mb-1" },
+                                                            "text": "$t:sirsoft-pay_nicepayments.admin.escrow_buyer_address"
+                                                        },
+                                                        {
+                                                            "type": "basic",
+                                                            "name": "Input",
+                                                            "props": {
+                                                                "type": "text",
+                                                                "className": "text-primary w-full px-3 py-2 border border-gray-300 dark:border-gray-600 rounded-lg bg-white dark:bg-gray-700 text-sm focus:ring-2 focus:ring-emerald-500 focus:border-transparent"
+                                                            },
+                                                            "bindLocal": "_escrow_buyer_address"
+                                                        }
+                                                    ]
+                                                }
+                                            ]
+                                        },
+                                        {
+                                            "type": "basic",
+                                            "name": "Div",
+                                            "if": "{{_local._escrowError}}",
+                                            "props": { "className": "text-xs text-red-600 dark:text-red-400 bg-red-50 dark:bg-red-900/20 rounded px-2 py-1.5" },
+                                            "text": "{{_local._escrowError}}"
+                                        },
+                                        {
+                                            "type": "basic",
+                                            "name": "Div",
+                                            "props": { "className": "flex justify-end" },
+                                            "children": [
+                                                {
+                                                    "type": "basic",
+                                                    "name": "Button",
+                                                    "props": {
+                                                        "disabled": "{{_local._escrowSubmitting}}",
+                                                        "className": "flex-center gap-1.5 px-4 py-2 text-sm font-medium bg-emerald-600 hover:bg-emerald-700 text-white rounded-lg transition-colors disabled:opacity-50 disabled:cursor-not-allowed"
+                                                    },
+                                                    "actions": [
+                                                        {
+                                                            "type": "click",
+                                                            "handler": "sequence",
+                                                            "actions": [
+                                                                {
+                                                                    "handler": "setState",
+                                                                    "params": {
+                                                                        "target": "local",
+                                                                        "_escrowSubmitting": true,
+                                                                        "_escrowError": null
+                                                                    }
+                                                                },
+                                                                {
+                                                                    "handler": "apiCall",
+                                                                    "auth_required": true,
+                                                                    "target": "/api/plugins/sirsoft-pay_nicepayments/admin/escrow/register-delivery",
+                                                                    "params": {
+                                                                        "method": "POST",
+                                                                        "body": {
+                                                                            "tid": "{{payment.transaction_id}}",
+                                                                            "delivery_name": "{{_local._escrow_delivery_name}}",
+                                                                            "tracking_number": "{{_local._escrow_tracking_number}}",
+                                                                            "buyer_address": "{{_local._escrow_buyer_address}}",
+                                                                            "register_name": "{{_local._escrow_register_name}}"
+                                                                        }
+                                                                    },
+                                                                    "onSuccess": [
+                                                                        {
+                                                                            "handler": "setState",
+                                                                            "params": {
+                                                                                "target": "local",
+                                                                                "_escrowSubmitting": false
+                                                                            }
+                                                                        },
+                                                                        {
+                                                                            "handler": "toast",
+                                                                            "params": {
+                                                                                "type": "success",
+                                                                                "message": "$t:sirsoft-pay_nicepayments.admin.escrow_register_success"
+                                                                            }
+                                                                        }
+                                                                    ],
+                                                                    "onError": [
+                                                                        {
+                                                                            "handler": "setState",
+                                                                            "params": {
+                                                                                "target": "local",
+                                                                                "_escrowSubmitting": false,
+                                                                                "_escrowError": "$t:sirsoft-pay_nicepayments.admin.escrow_register_error"
+                                                                            }
+                                                                        }
+                                                                    ]
+                                                                }
+                                                            ]
+                                                        }
+                                                    ],
+                                                    "children": [
+                                                        {
+                                                            "type": "basic",
+                                                            "name": "Icon",
+                                                            "if": "{{_local._escrowSubmitting}}",
+                                                            "props": { "name": "spinner", "className": "spinner-sm" }
+                                                        },
+                                                        {
+                                                            "type": "basic",
+                                                            "name": "Span",
+                                                            "text": "$t:sirsoft-pay_nicepayments.admin.escrow_register_button"
+                                                        }
+                                                    ]
+                                                }
+                                            ]
+                                        }
+                                    ]
+                                }
+                            ]
+                        }
+                    ]
+                },
+                {
+                    "id": "nicepay_verify_panel",
+                    "type": "basic",
+                    "name": "Div",
+                    "if": "{{(order.data?.payments?.filter(p => p.transaction_id && p.pg_provider === 'nicepayments') ?? []).length > 0}}",
+                    "props": {
+                        "className": "admin-card"
+                    },
+                    "children": [
+                        {
+                            "id": "nicepay_verify_header",
+                            "type": "basic",
+                            "name": "Div",
+                            "props": { "className": "flex-center gap-2 mb-4" },
+                            "children": [
+                                {
+                                    "type": "basic",
+                                    "name": "Div",
+                                    "props": { "className": "w-1.5 h-4 bg-blue-500 rounded-full flex-shrink-0" }
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "H3",
+                                    "props": { "className": "text-sm font-semibold text-gray-800 dark:text-gray-200" },
+                                    "text": "$t:sirsoft-pay_nicepayments.admin.order_verify_title"
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "Span",
+                                    "props": { "className": "text-hint hidden sm:inline" },
+                                    "text": "$t:sirsoft-pay_nicepayments.admin.order_verify_description"
+                                }
+                            ]
+                        },
+                        {
+                            "id": "nicepay_payments_list",
+                            "type": "basic",
+                            "name": "Div",
+                            "props": { "className": "space-y-3" },
+                            "iteration": {
+                                "source": "{{order.data?.payments?.filter(p => p.transaction_id) ?? []}}",
+                                "item_var": "payment",
+                                "index_var": "pIdx"
+                            },
+                            "children": [
+                                {
+                                    "type": "basic",
+                                    "name": "Div",
+                                    "props": { "className": "rounded-lg border border-gray-100 dark:border-gray-700 p-3 bg-gray-50 dark:bg-gray-800/50" },
+                                    "children": [
+                                        {
+                                            "type": "basic",
+                                            "name": "Div",
+                                            "props": { "className": "flex-center flex-wrap gap-3" },
+                                            "children": [
+                                                {
+                                                    "type": "basic",
+                                                    "name": "Div",
+                                                    "props": { "className": "flex-1 min-w-0" },
+                                                    "children": [
+                                                        {
+                                                            "type": "basic",
+                                                            "name": "Span",
+                                                            "props": { "className": "text-tertiary block mb-0.5" },
+                                                            "text": "TID"
+                                                        },
+                                                        {
+                                                            "type": "basic",
+                                                            "name": "Span",
+                                                            "props": { "className": "font-mono text-xs text-gray-900 dark:text-gray-100 break-all block" },
+                                                            "text": "{{payment.transaction_id}}"
+                                                        }
+                                                    ]
+                                                },
+                                                {
+                                                    "type": "basic",
+                                                    "name": "Button",
+                                                    "props": {
+                                                        "disabled": "{{_local._nicepayQuerying && _local._nicepayActiveTid === payment.transaction_id}}",
+                                                        "className": "flex-center gap-1.5 px-3 py-1.5 text-xs font-medium bg-blue-600 hover:bg-blue-700 text-white rounded-md transition-colors disabled:opacity-50 disabled:cursor-not-allowed whitespace-nowrap flex-shrink-0"
+                                                    },
+                                                    "actions": [
+                                                        {
+                                                            "type": "click",
+                                                            "handler": "sequence",
+                                                            "actions": [
+                                                                {
+                                                                    "handler": "setState",
+                                                                    "params": {
+                                                                        "target": "local",
+                                                                        "_nicepayQuerying": true,
+                                                                        "_nicepayActiveTid": "{{payment.transaction_id}}",
+                                                                        "_nicepayResult": null,
+                                                                        "_nicepayError": null
+                                                                    }
+                                                                },
+                                                                {
+                                                                    "handler": "apiCall",
+                                                                    "auth_required": true,
+                                                                    "target": "/api/plugins/sirsoft-pay_nicepayments/admin/transaction/query",
+                                                                    "params": {
+                                                                        "method": "POST",
+                                                                        "body": {
+                                                                            "tid": "{{_local._nicepayActiveTid}}"
+                                                                        }
+                                                                    },
+                                                                    "onSuccess": [
+                                                                        {
+                                                                            "handler": "setState",
+                                                                            "params": {
+                                                                                "target": "local",
+                                                                                "_nicepayQuerying": false,
+                                                                                "_nicepayResult": "{{response.data}}"
+                                                                            }
+                                                                        }
+                                                                    ],
+                                                                    "onError": [
+                                                                        {
+                                                                            "handler": "setState",
+                                                                            "params": {
+                                                                                "target": "local",
+                                                                                "_nicepayQuerying": false,
+                                                                                "_nicepayError": "$t:sirsoft-pay_nicepayments.admin.order_verify_error"
+                                                                            }
+                                                                        }
+                                                                    ]
+                                                                }
+                                                            ]
+                                                        }
+                                                    ],
+                                                    "children": [
+                                                        {
+                                                            "type": "basic",
+                                                            "name": "Icon",
+                                                            "if": "{{_local._nicepayQuerying && _local._nicepayActiveTid === payment.transaction_id}}",
+                                                            "props": { "name": "spinner", "className": "w-3 h-3 animate-spin" }
+                                                        },
+                                                        {
+                                                            "type": "basic",
+                                                            "name": "Span",
+                                                            "text": "$t:sirsoft-pay_nicepayments.admin.order_verify_button"
+                                                        }
+                                                    ]
+                                                }
+                                            ]
+                                        },
+                                        {
+                                            "type": "basic",
+                                            "name": "Div",
+                                            "if": "{{_local._nicepayActiveTid === payment.transaction_id && _local._nicepayError}}",
+                                            "props": { "className": "mt-2 text-xs text-red-600 dark:text-red-400 bg-red-50 dark:bg-red-900/20 rounded px-2 py-1.5" },
+                                            "text": "{{_local._nicepayError}}"
+                                        },
+                                        {
+                                            "id": "nicepay_verify_result",
+                                            "type": "basic",
+                                            "name": "Div",
+                                            "if": "{{(_local._nicepayActiveTid === payment.transaction_id && _local._nicepayResult) || nicepay_status.data}}",
+                                            "props": { "className": "mt-3 pt-3" },
+                                            "children": [
+                                                {
+                                                    "type": "basic",
+                                                    "name": "Div",
+                                                    "props": { "className": "flex-center flex-wrap gap-2 mb-3" },
+                                                    "children": [
+                                                        {
+                                                            "type": "basic",
+                                                            "name": "Span",
+                                                            "if": "{{(_local._nicepayResult ?? nicepay_status.data).Status === '0'}}",
+                                                            "props": { "className": "inline-flex items-center px-2 py-0.5 rounded-full text-xs font-semibold bg-green-100 text-green-800 dark:bg-green-900/30 dark:text-green-300" },
+                                                            "text": "$t:sirsoft-pay_nicepayments.admin.pay_status_approved"
+                                                        },
+                                                        {
+                                                            "type": "basic",
+                                                            "name": "Span",
+                                                            "if": "{{(_local._nicepayResult ?? nicepay_status.data).Status === '1'}}",
+                                                            "props": { "className": "inline-flex items-center px-2 py-0.5 rounded-full text-xs font-semibold bg-gray-100 text-gray-700 dark:bg-gray-700 dark:text-gray-300" },
+                                                            "text": "$t:sirsoft-pay_nicepayments.admin.pay_status_cancelled"
+                                                        },
+                                                        {
+                                                            "type": "basic",
+                                                            "name": "Span",
+                                                            "if": "{{(_local._nicepayResult ?? nicepay_status.data).Status !== '0' && (_local._nicepayResult ?? nicepay_status.data).Status !== '1'}}",
+                                                            "props": { "className": "inline-flex items-center px-2 py-0.5 rounded-full text-xs font-semibold bg-amber-100 text-amber-800 dark:bg-amber-900/30 dark:text-amber-300" },
+                                                            "text": "$t:sirsoft-pay_nicepayments.admin.pay_status_unknown"
+                                                        },
+                                                        {
+                                                            "type": "basic",
+                                                            "name": "Span",
+                                                            "if": "{{(_local._nicepayResult ?? nicepay_status.data).EscrowYN === 'Y' || (_local._nicepayResult ?? nicepay_status.data)._local_is_escrow === true}}",
+                                                            "props": { "className": "inline-flex items-center gap-1 px-2 py-0.5 rounded-full text-xs font-semibold bg-blue-100 text-blue-800 dark:bg-blue-900/30 dark:text-blue-300" },
+                                                            "children": [
+                                                                {
+                                                                    "type": "basic",
+                                                                    "name": "Icon",
+                                                                    "props": { "name": "shield-check", "className": "w-3 h-3" }
+                                                                },
+                                                                {
+                                                                    "type": "basic",
+                                                                    "name": "Span",
+                                                                    "text": "$t:sirsoft-pay_nicepayments.admin.escrow_badge"
+                                                                }
+                                                            ]
+                                                        },
+                                                        {
+                                                            "type": "basic",
+                                                            "name": "Span",
+                                                            "if": "{{(_local._nicepayResult ?? nicepay_status.data)?._is_test_mode === true}}",
+                                                            "props": { "className": "inline-flex items-center px-2 py-0.5 rounded-full text-xs font-semibold bg-orange-100 text-orange-800 dark:bg-orange-900/30 dark:text-orange-300" },
+                                                            "text": "$t:sirsoft-pay_nicepayments.admin.test_mode_badge"
+                                                        }
+                                                    ]
+                                                },
+                                                {
+                                                    "type": "basic",
+                                                    "name": "Div",
+                                                    "props": { "className": "grid grid-cols-2 gap-x-4 gap-y-1.5 text-xs" },
+                                                    "children": [
+                                                        {
+                                                            "type": "basic",
+                                                            "name": "Span",
+                                                            "props": { "className": "text-gray-500 dark:text-gray-400" },
+                                                            "text": "$t:sirsoft-pay_nicepayments.admin.result_auth_code"
+                                                        },
+                                                        {
+                                                            "type": "basic",
+                                                            "name": "Span",
+                                                            "props": { "className": "text-gray-900 dark:text-gray-100 font-mono" },
+                                                            "text": "{{(_local._nicepayResult ?? nicepay_status.data).AuthCode ?? '-'}}"
+                                                        },
+                                                        {
+                                                            "type": "basic",
+                                                            "name": "Span",
+                                                            "props": { "className": "text-gray-500 dark:text-gray-400" },
+                                                            "text": "$t:sirsoft-pay_nicepayments.admin.result_auth_date"
+                                                        },
+                                                        {
+                                                            "type": "basic",
+                                                            "name": "Span",
+                                                            "props": { "className": "text-gray-900 dark:text-gray-100 font-mono" },
+                                                            "text": "{{(_local._nicepayResult ?? nicepay_status.data).AuthDate ?? '-'}}"
+                                                        },
+                                                        {
+                                                            "type": "basic",
+                                                            "name": "Span",
+                                                            "props": { "className": "text-gray-500 dark:text-gray-400" },
+                                                            "text": "$t:sirsoft-pay_nicepayments.admin.result_escrow"
+                                                        },
+                                                        {
+                                                            "type": "basic",
+                                                            "name": "Span",
+                                                            "props": { "className": "text-gray-900 dark:text-gray-100" },
+                                                            "text": "{{((_local._nicepayResult ?? nicepay_status.data).EscrowYN === 'Y' || (_local._nicepayResult ?? nicepay_status.data)._local_is_escrow) ? '$t:sirsoft-pay_nicepayments.admin.escrow_yes' : '$t:sirsoft-pay_nicepayments.admin.escrow_no'}}"
+                                                        },
+                                                        {
+                                                            "type": "basic",
+                                                            "name": "Span",
+                                                            "props": { "className": "text-gray-500 dark:text-gray-400" },
+                                                            "text": "$t:sirsoft-pay_nicepayments.admin.result_result_code"
+                                                        },
+                                                        {
+                                                            "type": "basic",
+                                                            "name": "Span",
+                                                            "props": { "className": "font-mono text-gray-900 dark:text-gray-100" },
+                                                            "text": "{{((_local._nicepayResult ?? nicepay_status.data).ResultCode ?? '') + ' ' + ((_local._nicepayResult ?? nicepay_status.data).ResultMsg ?? '')}}"
+                                                        }
+                                                    ]
+                                                }
+                                            ]
+                                        }
+                                    ]
+                                }
+                            ]
+                        }
+                    ]
+                },
+                {
+                    "id": "nicepay_vbank_notifications_panel",
+                    "type": "basic",
+                    "name": "Div",
+                    "if": "{{(order.data?.payments?.filter(p => p.payment_method === 'vbank' && p.pg_provider === 'nicepayments') ?? []).length > 0}}",
+                    "props": { "className": "admin-card mt-4" },
+                    "children": [
+                        {
+                            "type": "basic",
+                            "name": "Div",
+                            "props": { "className": "flex-center gap-2 mb-4" },
+                            "children": [
+                                { "type": "basic", "name": "Div", "props": { "className": "w-1.5 h-4 bg-emerald-500 rounded-full flex-shrink-0" } },
+                                {
+                                    "type": "basic", "name": "H3",
+                                    "props": { "className": "text-sm font-semibold text-gray-800 dark:text-gray-200" },
+                                    "text": "$t:sirsoft-pay_nicepayments.admin.vbank_noti_title"
+                                },
+                                {
+                                    "type": "basic", "name": "Span",
+                                    "props": { "className": "text-hint hidden sm:inline" },
+                                    "text": "$t:sirsoft-pay_nicepayments.admin.vbank_noti_description"
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "Button",
+                                    "props": {
+                                        "disabled": "{{_local._vbankNotiLoading === true}}",
+                                        "className": "flex-center ml-auto gap-1.5 px-3 py-1.5 text-xs font-medium bg-emerald-600 hover:bg-emerald-700 text-white rounded transition-colors disabled:opacity-50 disabled:cursor-not-allowed"
+                                    },
+                                    "children": [
+                                        {
+                                            "type": "basic", "name": "Icon",
+                                            "if": "{{_local._vbankNotiLoading === true}}",
+                                            "props": { "name": "spinner", "className": "w-3 h-3 animate-spin" }
+                                        },
+                                        { "type": "basic", "name": "Span", "text": "$t:sirsoft-pay_nicepayments.admin.vbank_noti_query_button" }
+                                    ],
+                                    "actions": [
+                                        {
+                                            "type": "click",
+                                            "handler": "sequence",
+                                            "actions": [
+                                                {
+                                                    "handler": "setState",
+                                                    "params": { "target": "local", "_vbankNotiLoading": true, "_vbankNotiError": null }
+                                                },
+                                                {
+                                                    "handler": "apiCall",
+                                                    "auth_required": true,
+                                                    "target": "/api/plugins/sirsoft-pay_nicepayments/admin/orders/{{order.data?.order_number}}/vbank-notifications",
+                                                    "params": { "method": "GET" },
+                                                    "onSuccess": [
+                                                        {
+                                                            "handler": "setState",
+                                                            "params": {
+                                                                "target": "local",
+                                                                "_vbankNotiLoading": false,
+                                                                "_vbankNotiData": "{{$response.data}}"
+                                                            }
+                                                        }
+                                                    ],
+                                                    "onError": [
+                                                        {
+                                                            "handler": "setState",
+                                                            "params": {
+                                                                "target": "local",
+                                                                "_vbankNotiLoading": false,
+                                                                "_vbankNotiError": "$t:sirsoft-pay_nicepayments.admin.vbank_noti_load_error"
+                                                            }
+                                                        }
+                                                    ]
+                                                }
+                                            ]
+                                        }
+                                    ]
+                                }
+                            ]
+                        },
+                        {
+                            "type": "basic",
+                            "name": "P",
+                            "if": "{{!_local._vbankNotiData && !_local._vbankNotiLoading && !_local._vbankNotiError}}",
+                            "props": { "className": "text-tertiary italic" },
+                            "text": "$t:sirsoft-pay_nicepayments.admin.vbank_noti_not_loaded"
+                        },
+                        {
+                            "type": "basic",
+                            "name": "P",
+                            "if": "{{_local._vbankNotiError}}",
+                            "props": { "className": "text-xs text-rose-600 dark:text-rose-400" },
+                            "text": "{{_local._vbankNotiError}}"
+                        },
+                        {
+                            "type": "basic",
+                            "name": "P",
+                            "if": "{{_local._vbankNotiData && (_local._vbankNotiData.notifications ?? []).length === 0}}",
+                            "props": { "className": "text-tertiary italic" },
+                            "text": "$t:sirsoft-pay_nicepayments.admin.vbank_noti_empty"
+                        },
+                        {
+                            "type": "basic",
+                            "name": "Div",
+                            "if": "{{_local._vbankNotiData && (_local._vbankNotiData.notifications ?? []).length > 0}}",
+                            "props": { "className": "border border-gray-200 dark:border-gray-700 rounded-lg p-3" },
+                            "children": [
+                                {
+                                    "type": "basic",
+                                    "name": "Dl",
+                                    "props": { "className": "grid grid-cols-2 gap-x-4 gap-y-1.5 text-xs mb-3" },
+                                    "children": [
+                                        { "type": "basic", "name": "Dt", "props": { "className": "text-gray-500 dark:text-gray-400" }, "text": "$t:sirsoft-pay_nicepayments.admin.vbank_noti_count" },
+                                        { "type": "basic", "name": "Dd", "props": { "className": "text-gray-900 dark:text-gray-100 font-semibold" }, "text": "{{(_local._vbankNotiData.summary?.count ?? 0) + '회'}}" },
+                                        { "type": "basic", "name": "Dt", "props": { "className": "text-gray-500 dark:text-gray-400" }, "text": "$t:sirsoft-pay_nicepayments.admin.vbank_noti_first_at" },
+                                        { "type": "basic", "name": "Dd", "props": { "className": "text-gray-900 dark:text-gray-100 font-mono" }, "text": "{{$formatDate(_local._vbankNotiData.summary?.first_received_at, 'YYYY-MM-DD HH:mm:ss') ?? '-'}}" },
+                                        { "type": "basic", "name": "Dt", "props": { "className": "text-gray-500 dark:text-gray-400" }, "text": "$t:sirsoft-pay_nicepayments.admin.vbank_noti_last_at" },
+                                        { "type": "basic", "name": "Dd", "props": { "className": "text-gray-900 dark:text-gray-100 font-mono" }, "text": "{{$formatDate(_local._vbankNotiData.summary?.last_received_at, 'YYYY-MM-DD HH:mm:ss') ?? '-'}}" },
+                                        { "type": "basic", "name": "Dt", "props": { "className": "text-gray-500 dark:text-gray-400" }, "text": "$t:sirsoft-pay_nicepayments.admin.vbank_noti_deposited_at" },
+                                        { "type": "basic", "name": "Dd", "props": { "className": "text-emerald-700 dark:text-emerald-400 font-mono" }, "text": "{{$formatDate(_local._vbankNotiData.summary?.deposited_at, 'YYYY-MM-DD HH:mm:ss') ?? '-'}}" },
+                                        {
+                                            "type": "basic", "name": "Dt",
+                                            "if": "{{!!_local._vbankNotiData.summary?.cancelled_at}}",
+                                            "props": { "className": "text-gray-500 dark:text-gray-400" },
+                                            "text": "$t:sirsoft-pay_nicepayments.admin.vbank_noti_cancelled_at"
+                                        },
+                                        {
+                                            "type": "basic", "name": "Dd",
+                                            "if": "{{!!_local._vbankNotiData.summary?.cancelled_at}}",
+                                            "props": { "className": "text-rose-700 dark:text-rose-400 font-mono" },
+                                            "text": "{{$formatDate(_local._vbankNotiData.summary?.cancelled_at, 'YYYY-MM-DD HH:mm:ss')}}"
+                                        },
+                                        { "type": "basic", "name": "Dt", "props": { "className": "text-gray-500 dark:text-gray-400" }, "text": "$t:sirsoft-pay_nicepayments.admin.vbank_noti_depositor" },
+                                        { "type": "basic", "name": "Dd", "props": { "className": "text-gray-900 dark:text-gray-100" }, "text": "{{_local._vbankNotiData.summary?.last_depositor ?? '-'}}" }
+                                    ]
+                                },
+                                {
+                                    "type": "basic",
+                                    "name": "Div",
+                                    "props": { "className": "border-t border-gray-200 dark:border-gray-700 pt-3" },
+                                    "children": [
+                                        {
+                                            "type": "basic", "name": "P",
+                                            "props": { "className": "text-xs font-semibold text-gray-700 dark:text-gray-300 mb-2" },
+                                            "text": "$t:sirsoft-pay_nicepayments.admin.vbank_noti_history"
+                                        },
+                                        {
+                                            "type": "basic",
+                                            "name": "Div",
+                                            "props": { "className": "space-y-1.5 text-xs" },
+                                            "iteration": {
+                                                "source": "{{_local._vbankNotiData.notifications ?? []}}",
+                                                "item_var": "noti",
+                                                "index_var": "nIdx"
+                                            },
+                                            "children": [
+                                                {
+                                                    "type": "basic",
+                                                    "name": "Div",
+                                                    "props": { "className": "flex-center gap-2 py-1 border-b border-gray-100 dark:border-gray-800 last:border-0" },
+                                                    "children": [
+                                                        {
+                                                            "type": "basic", "name": "Span",
+                                                            "if": "{{noti.type === 'deposited'}}",
+                                                            "props": { "className": "inline-flex items-center px-2 py-0.5 rounded text-[10px] font-semibold bg-emerald-100 text-emerald-800 dark:bg-emerald-900/30 dark:text-emerald-300 flex-shrink-0" },
+                                                            "text": "$t:sirsoft-pay_nicepayments.admin.vbank_noti_type_deposited"
+                                                        },
+                                                        {
+                                                            "type": "basic", "name": "Span",
+                                                            "if": "{{noti.type === 'cancelled'}}",
+                                                            "props": { "className": "inline-flex items-center px-2 py-0.5 rounded text-[10px] font-semibold bg-rose-100 text-rose-800 dark:bg-rose-900/30 dark:text-rose-300 flex-shrink-0" },
+                                                            "text": "$t:sirsoft-pay_nicepayments.admin.vbank_noti_type_cancelled"
+                                                        },
+                                                        {
+                                                            "type": "basic", "name": "Span",
+                                                            "if": "{{noti.type !== 'deposited' && noti.type !== 'cancelled'}}",
+                                                            "props": { "className": "inline-flex items-center px-2 py-0.5 rounded text-[10px] font-semibold bg-gray-100 text-gray-700 dark:bg-gray-700 dark:text-gray-300 flex-shrink-0" },
+                                                            "text": "$t:sirsoft-pay_nicepayments.admin.vbank_noti_type_other"
+                                                        },
+                                                        {
+                                                            "type": "basic", "name": "Span",
+                                                            "props": { "className": "font-mono text-gray-700 dark:text-gray-300" },
+                                                            "text": "{{$formatDate(noti.received_at, 'YYYY-MM-DD HH:mm:ss')}}"
+                                                        },
+                                                        {
+                                                            "type": "basic", "name": "Span",
+                                                            "props": { "className": "text-gray-500 dark:text-gray-400 font-mono" },
+                                                            "text": "{{noti.result_code ?? '-'}}"
+                                                        },
+                                                        {
+                                                            "type": "basic", "name": "Span",
+                                                            "props": { "className": "text-gray-700 dark:text-gray-300" },
+                                                            "text": "{{noti.result_msg ?? ''}}"
+                                                        },
+                                                        {
+                                                            "type": "basic", "name": "Span",
+                                                            "if": "{{noti.depositor}}",
+                                                            "props": { "className": "text-secondary ml-auto" },
+                                                            "text": "{{noti.depositor + ' / ' + (noti.amt ?? 0).toLocaleString() + '원'}}"
+                                                        }
+                                                    ]
+                                                }
+                                            ]
+                                        }
+                                    ]
+                                }
+                            ]
+                        }
+                    ]
+                }
+            ]
+        }
+    ]
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/resources/extensions/checkout_easy_pay.json b/plugins/_bundled/sirsoft-pay_nicepayments/resources/extensions/checkout_easy_pay.json
new file mode 100644
index 00000000..ab19744b
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/resources/extensions/checkout_easy_pay.json
@@ -0,0 +1,223 @@
+{
+    "target_layout": "shop/checkout",
+    "data_sources": [
+        {
+            "id": "nicepay_easy_pay_config",
+            "label_key": "$t:sirsoft-pay_nicepayments.editor.data_source.nicepay_easy_pay_config",
+            "type": "api",
+            "endpoint": "/api/modules/sirsoft-ecommerce/payments/client-config/nicepayments",
+            "method": "GET",
+            "auto_fetch": true
+        }
+    ],
+    "injections": [
+        {
+            "target_id": "nicepay_checkout_payment_section",
+            "position": "append_child",
+            "components": [
+                {
+                    "comment": "간편결제 섹션 - enabled_easy_pays 가 하나 이상인 경우에만 표시",
+                    "type": "basic",
+                    "name": "Div",
+                    "if": "{{(nicepay_easy_pay_config.data?.enabled_easy_pays ?? []).length > 0}}",
+                    "props": {
+                        "className": "mt-4 pt-4"
+                    },
+                    "responsive": {
+                        "portable": {
+                            "props": {
+                                "className": "mt-3 pt-3"
+                            }
+                        }
+                    },
+                    "children": [
+                        {
+                            "type": "basic",
+                            "name": "P",
+                            "props": {
+                                "className": "text-body font-medium mb-3"
+                            },
+                            "responsive": {
+                                "portable": {
+                                    "props": {
+                                        "className": "text-body font-medium mb-2"
+                                    }
+                                }
+                            },
+                            "text": "$t:sirsoft-pay_nicepayments.easy_pay.section_title"
+                        },
+                        {
+                            "type": "basic",
+                            "name": "Div",
+                            "props": {
+                                "className": "nicepay-easy-pay-btns flex flex-wrap gap-2"
+                            },
+                            "children": [
+                                {
+                                    "comment": "네이버페이",
+                                    "type": "basic",
+                                    "name": "Button",
+                                    "if": "{{(nicepay_easy_pay_config.data?.enabled_easy_pays ?? []).includes('NAVERPAY')}}",
+                                    "props": {
+                                        "type": "button",
+                                        "className": "px-4 py-2 rounded-lg text-sm font-bold bg-green-500 text-white hover:opacity-90"
+                                    },
+                                    "text": "네이버페이",
+                                    "actions": [
+                                        {
+                                            "type": "click",
+                                            "handler": "sirsoft-pay_nicepayments.setPaymentMethod",
+                                            "params": {
+                                                "paymentMethod": "nicepay_naverpay"
+                                            }
+                                        }
+                                    ]
+                                },
+                                {
+                                    "comment": "카카오페이",
+                                    "type": "basic",
+                                    "name": "Button",
+                                    "if": "{{(nicepay_easy_pay_config.data?.enabled_easy_pays ?? []).includes('KAKAOPAY')}}",
+                                    "props": {
+                                        "type": "button",
+                                        "className": "px-4 py-2 rounded-lg text-sm font-bold bg-yellow-400 text-gray-900 hover:opacity-90"
+                                    },
+                                    "text": "카카오페이",
+                                    "actions": [
+                                        {
+                                            "type": "click",
+                                            "handler": "sirsoft-pay_nicepayments.setPaymentMethod",
+                                            "params": {
+                                                "paymentMethod": "nicepay_kakaopay"
+                                            }
+                                        }
+                                    ]
+                                },
+                                {
+                                    "comment": "삼성페이",
+                                    "type": "basic",
+                                    "name": "Button",
+                                    "if": "{{(nicepay_easy_pay_config.data?.enabled_easy_pays ?? []).includes('SAMSUNGPAY')}}",
+                                    "props": {
+                                        "type": "button",
+                                        "className": "px-4 py-2 rounded-lg text-sm font-bold bg-blue-700 text-white hover:opacity-90"
+                                    },
+                                    "text": "삼성페이",
+                                    "actions": [
+                                        {
+                                            "type": "click",
+                                            "handler": "sirsoft-pay_nicepayments.setPaymentMethod",
+                                            "params": {
+                                                "paymentMethod": "nicepay_samsungpay"
+                                            }
+                                        }
+                                    ]
+                                },
+                                {
+                                    "comment": "애플페이",
+                                    "type": "basic",
+                                    "name": "Button",
+                                    "if": "{{(nicepay_easy_pay_config.data?.enabled_easy_pays ?? []).includes('APPLEPAY')}}",
+                                    "props": {
+                                        "type": "button",
+                                        "className": "px-4 py-2 rounded-lg text-sm font-bold bg-gray-900 dark:bg-gray-950 text-white hover:opacity-90"
+                                    },
+                                    "text": "애플페이",
+                                    "actions": [
+                                        {
+                                            "type": "click",
+                                            "handler": "sirsoft-pay_nicepayments.setPaymentMethod",
+                                            "params": {
+                                                "paymentMethod": "nicepay_applepay"
+                                            }
+                                        }
+                                    ]
+                                },
+                                {
+                                    "comment": "PAYCO",
+                                    "type": "basic",
+                                    "name": "Button",
+                                    "if": "{{(nicepay_easy_pay_config.data?.enabled_easy_pays ?? []).includes('PAYCO')}}",
+                                    "props": {
+                                        "type": "button",
+                                        "className": "px-4 py-2 rounded-lg text-sm font-bold bg-red-500 text-white hover:opacity-90"
+                                    },
+                                    "text": "PAYCO",
+                                    "actions": [
+                                        {
+                                            "type": "click",
+                                            "handler": "sirsoft-pay_nicepayments.setPaymentMethod",
+                                            "params": {
+                                                "paymentMethod": "nicepay_payco"
+                                            }
+                                        }
+                                    ]
+                                },
+                                {
+                                    "comment": "11pay (SKpay)",
+                                    "type": "basic",
+                                    "name": "Button",
+                                    "if": "{{(nicepay_easy_pay_config.data?.enabled_easy_pays ?? []).includes('SKPAY')}}",
+                                    "props": {
+                                        "type": "button",
+                                        "className": "px-4 py-2 rounded-lg text-sm font-bold bg-orange-500 text-white hover:opacity-90"
+                                    },
+                                    "text": "11pay",
+                                    "actions": [
+                                        {
+                                            "type": "click",
+                                            "handler": "sirsoft-pay_nicepayments.setPaymentMethod",
+                                            "params": {
+                                                "paymentMethod": "nicepay_skpay"
+                                            }
+                                        }
+                                    ]
+                                },
+                                {
+                                    "comment": "SSG페이",
+                                    "type": "basic",
+                                    "name": "Button",
+                                    "if": "{{(nicepay_easy_pay_config.data?.enabled_easy_pays ?? []).includes('SSGPAY')}}",
+                                    "props": {
+                                        "type": "button",
+                                        "className": "px-4 py-2 rounded-lg text-sm font-bold bg-red-600 text-white hover:opacity-90"
+                                    },
+                                    "text": "SSG페이",
+                                    "actions": [
+                                        {
+                                            "type": "click",
+                                            "handler": "sirsoft-pay_nicepayments.setPaymentMethod",
+                                            "params": {
+                                                "paymentMethod": "nicepay_ssgpay"
+                                            }
+                                        }
+                                    ]
+                                },
+                                {
+                                    "comment": "L.pay",
+                                    "type": "basic",
+                                    "name": "Button",
+                                    "if": "{{(nicepay_easy_pay_config.data?.enabled_easy_pays ?? []).includes('LPAY')}}",
+                                    "props": {
+                                        "type": "button",
+                                        "className": "px-4 py-2 rounded-lg text-sm font-bold bg-pink-700 text-white hover:opacity-90"
+                                    },
+                                    "text": "L.pay",
+                                    "actions": [
+                                        {
+                                            "type": "click",
+                                            "handler": "sirsoft-pay_nicepayments.setPaymentMethod",
+                                            "params": {
+                                                "paymentMethod": "nicepay_lpay"
+                                            }
+                                        }
+                                    ]
+                                }
+                            ]
+                        }
+                    ]
+                }
+            ]
+        }
+    ]
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/resources/extensions/user_mypage_order_receipt.json b/plugins/_bundled/sirsoft-pay_nicepayments/resources/extensions/user_mypage_order_receipt.json
new file mode 100644
index 00000000..c2f6f179
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/resources/extensions/user_mypage_order_receipt.json
@@ -0,0 +1,462 @@
+{
+  "target_layout": "mypage/orders/show",
+  "injections": [
+    {
+      "target_id": "order_payment_info_panel",
+      "position": "append_child",
+      "components": [
+        {
+          "comment": "가상계좌 입금 안내 — 결제수단 vbank + 나이스페이먼츠 결제 건. shop/order_complete 페이지와 동일한 정보를 표시해 사용자가 마이페이지에서도 입금 정보 확인 가능.",
+          "type": "basic",
+          "name": "Div",
+          "if": "{{order.data.payment?.pg_provider === 'nicepayments' && order.data.payment?.payment_method === 'vbank' && order.data.payment?.vbank_number}}",
+          "props": {
+            "className": "pt-4 mt-2 border-t border-gray-200 dark:border-gray-700"
+          },
+          "children": [
+            {
+              "type": "basic",
+              "name": "Div",
+              "props": {
+                "className": "bg-blue-50 dark:bg-blue-900/30 border border-blue-200 dark:border-blue-700 rounded-lg p-4"
+              },
+              "children": [
+                {
+                  "type": "basic",
+                  "name": "H3",
+                  "props": {
+                    "className": "text-sm font-semibold text-info-soft mb-3"
+                  },
+                  "text": "$t:sirsoft-pay_nicepayments.user.vbank_deposit_info"
+                },
+                {
+                  "type": "basic",
+                  "name": "Div",
+                  "props": {
+                    "className": "space-y-2"
+                  },
+                  "children": [
+                    {
+                      "type": "basic",
+                      "name": "Div",
+                      "props": {
+                        "className": "flex justify-between text-sm"
+                      },
+                      "children": [
+                        {
+                          "type": "basic",
+                          "name": "Span",
+                          "props": {
+                            "className": "text-secondary"
+                          },
+                          "text": "$t:sirsoft-pay_nicepayments.user.vbank_bank"
+                        },
+                        {
+                          "type": "basic",
+                          "name": "Span",
+                          "props": {
+                            "className": "text-primary font-medium"
+                          },
+                          "text": "{{order.data.payment?.vbank_name}}"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "basic",
+                      "name": "Div",
+                      "props": {
+                        "className": "flex justify-between text-sm"
+                      },
+                      "children": [
+                        {
+                          "type": "basic",
+                          "name": "Span",
+                          "props": {
+                            "className": "text-secondary"
+                          },
+                          "text": "$t:sirsoft-pay_nicepayments.user.vbank_account"
+                        },
+                        {
+                          "type": "basic",
+                          "name": "Span",
+                          "props": {
+                            "className": "text-primary font-medium font-mono"
+                          },
+                          "text": "{{order.data.payment?.vbank_number}}"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "basic",
+                      "name": "Div",
+                      "props": {
+                        "className": "flex justify-between text-sm"
+                      },
+                      "children": [
+                        {
+                          "type": "basic",
+                          "name": "Span",
+                          "props": {
+                            "className": "text-secondary"
+                          },
+                          "text": "$t:sirsoft-pay_nicepayments.user.vbank_holder"
+                        },
+                        {
+                          "type": "basic",
+                          "name": "Span",
+                          "props": {
+                            "className": "text-primary font-medium"
+                          },
+                          "text": "{{order.data.payment?.vbank_holder}}"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "basic",
+                      "name": "Div",
+                      "props": {
+                        "className": "flex justify-between text-sm"
+                      },
+                      "children": [
+                        {
+                          "type": "basic",
+                          "name": "Span",
+                          "props": {
+                            "className": "text-secondary"
+                          },
+                          "text": "$t:sirsoft-pay_nicepayments.user.vbank_amount"
+                        },
+                        {
+                          "type": "basic",
+                          "name": "Span",
+                          "props": {
+                            "className": "font-bold text-blue-600 dark:text-blue-400"
+                          },
+                          "text": "{{order.data.total_amount_formatted}}"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "basic",
+                      "name": "Div",
+                      "if": "{{order.data.payment?.vbank_due_at}}",
+                      "props": {
+                        "className": "flex justify-between text-sm pt-2 border-t border-blue-200 dark:border-blue-700 mt-2"
+                      },
+                      "children": [
+                        {
+                          "type": "basic",
+                          "name": "Span",
+                          "props": {
+                            "className": "text-secondary"
+                          },
+                          "text": "$t:sirsoft-pay_nicepayments.user.vbank_due"
+                        },
+                        {
+                          "type": "basic",
+                          "name": "Span",
+                          "props": {
+                            "className": "font-medium text-red-600 dark:text-red-400"
+                          },
+                          "text": "{{order.data.payment?.vbank_due_at}}"
+                        }
+                      ]
+                    }
+                  ]
+                },
+                {
+                  "type": "basic",
+                  "name": "P",
+                  "if": "{{!order.data.payment?.paid_at}}",
+                  "props": {
+                    "className": "text-info-soft mt-3"
+                  },
+                  "text": "$t:sirsoft-pay_nicepayments.user.vbank_notice"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "type": "basic",
+          "name": "Div",
+          "if": "{{order.data.payment?.pg_provider === 'nicepayments' && (order.data.total_vat_amount > 0 || order.data.total_tax_free_amount > 0)}}",
+          "props": {
+            "className": "pt-4 mt-2 border-t border-gray-200 dark:border-gray-700 space-y-1.5"
+          },
+          "children": [
+            {
+              "type": "basic",
+              "name": "P",
+              "props": {
+                "className": "text-sm font-semibold text-gray-800 dark:text-gray-200 mb-1"
+              },
+              "text": "$t:sirsoft-pay_nicepayments.user.tax_breakdown_title"
+            },
+            {
+              "type": "basic",
+              "name": "Div",
+              "props": {
+                "className": "flex-between text-sm"
+              },
+              "children": [
+                {
+                  "type": "basic",
+                  "name": "Span",
+                  "props": {
+                    "className": "text-gray-500 dark:text-gray-400"
+                  },
+                  "text": "$t:sirsoft-pay_nicepayments.user.supply_amount"
+                },
+                {
+                  "type": "basic",
+                  "name": "Span",
+                  "props": {
+                    "className": "text-primary font-medium"
+                  },
+                  "text": "{{order.data.total_taxable_supply_amount_formatted}}"
+                }
+              ]
+            },
+            {
+              "type": "basic",
+              "name": "Div",
+              "props": {
+                "className": "flex-between text-sm"
+              },
+              "children": [
+                {
+                  "type": "basic",
+                  "name": "Span",
+                  "props": {
+                    "className": "text-gray-500 dark:text-gray-400"
+                  },
+                  "text": "$t:sirsoft-pay_nicepayments.user.vat_amount"
+                },
+                {
+                  "type": "basic",
+                  "name": "Span",
+                  "props": {
+                    "className": "text-primary font-medium"
+                  },
+                  "text": "{{order.data.total_vat_amount_formatted}}"
+                }
+              ]
+            },
+            {
+              "type": "basic",
+              "name": "Div",
+              "if": "{{order.data.total_tax_free_amount > 0}}",
+              "props": {
+                "className": "flex-between text-sm"
+              },
+              "children": [
+                {
+                  "type": "basic",
+                  "name": "Span",
+                  "props": {
+                    "className": "text-gray-500 dark:text-gray-400"
+                  },
+                  "text": "$t:sirsoft-pay_nicepayments.user.tax_free_amount"
+                },
+                {
+                  "type": "basic",
+                  "name": "Span",
+                  "props": {
+                    "className": "text-primary font-medium"
+                  },
+                  "text": "{{order.data.total_tax_free_amount_formatted}}"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "type": "basic",
+          "name": "Div",
+          "if": "{{order.data.payment?.pg_provider === 'nicepayments' && order.data.payment?.transaction_id && order.data.payment?.paid_at}}",
+          "props": {
+            "className": "pt-4 mt-2 border-t border-gray-200 dark:border-gray-700"
+          },
+          "children": [
+            {
+              "comment": "간편결제 서비스명 표시",
+              "type": "basic",
+              "name": "Div",
+              "if": "{{(['NAVERPAY','KAKAOPAY','SAMSUNGPAY','APPLEPAY','PAYCO','SKPAY','SSGPAY','LPAY']).includes(order.data.payment?.payment_meta?.PayMethod)}}",
+              "props": {
+                "className": "flex-between mb-2"
+              },
+              "children": [
+                {
+                  "type": "basic",
+                  "name": "Span",
+                  "props": {
+                    "className": "text-label-subtle"
+                  },
+                  "text": "$t:sirsoft-pay_nicepayments.user.easy_pay_label"
+                },
+                {
+                  "type": "basic",
+                  "name": "Span",
+                  "props": {
+                    "className": "text-heading"
+                  },
+                  "text": "{{({'NAVERPAY':'네이버페이','KAKAOPAY':'카카오페이','SAMSUNGPAY':'삼성페이','APPLEPAY':'애플페이','PAYCO':'PAYCO','SKPAY':'11pay','SSGPAY':'SSG페이','LPAY':'L.pay'})[order.data.payment?.payment_meta?.PayMethod] ?? order.data.payment?.payment_meta?.PayMethod}}"
+                }
+              ]
+            },
+            {
+              "comment": "영수증 링크 행",
+              "type": "basic",
+              "name": "Div",
+              "props": {
+                "className": "flex-between"
+              },
+              "children": [
+                {
+                  "type": "basic",
+                  "name": "Span",
+                  "props": {
+                    "className": "text-label-subtle"
+                  },
+                  "text": "$t:sirsoft-pay_nicepayments.user.receipt_label"
+                },
+                {
+                  "type": "basic",
+                  "name": "Div",
+                  "props": {
+                    "className": "flex-center gap-3"
+                  },
+                  "children": [
+                    {
+                      "comment": "결제 영수증",
+                      "type": "basic",
+                      "name": "A",
+                      "props": {
+                        "href": "https://npg.nicepay.co.kr/issue/IssueLoader.do?type=2&TID={{order.data.payment?.transaction_id}}",
+                        "target": "_blank",
+                        "rel": "noopener noreferrer",
+                        "className": "inline-flex items-center gap-1 text-sm text-blue-600 dark:text-blue-400 hover:underline"
+                      },
+                      "children": [
+                        {
+                          "type": "basic",
+                          "name": "Icon",
+                          "props": {
+                            "name": "file-text",
+                            "className": "w-3.5 h-3.5"
+                          }
+                        },
+                        {
+                          "type": "basic",
+                          "name": "Span",
+                          "text": "$t:sirsoft-pay_nicepayments.user.view_receipt"
+                        }
+                      ]
+                    },
+                    {
+                      "comment": "현금영수증 조회 버튼",
+                      "type": "basic",
+                      "name": "Button",
+                      "if": "{{order.data.payment?.cash_receipt_type && !_local._npMpReceiptLoaded}}",
+                      "props": {
+                        "type": "button",
+                        "className": "inline-flex items-center gap-1 text-sm text-green-600 dark:text-green-400 hover:underline disabled:opacity-50"
+                      },
+                      "actions": [
+                        {
+                          "type": "click",
+                          "handler": "sequence",
+                          "actions": [
+                            {
+                              "handler": "setState",
+                              "params": {
+                                "target": "local",
+                                "_npMpReceiptLoading": true
+                              }
+                            },
+                            {
+                              "handler": "apiCall",
+                              "auth_required": true,
+                              "target": "/api/plugins/sirsoft-pay_nicepayments/user/orders/{{route.order_number}}/receipt",
+                              "params": {
+                                "method": "GET"
+                              },
+                              "onSuccess": [
+                                {
+                                  "handler": "setState",
+                                  "params": {
+                                    "target": "local",
+                                    "_npMpReceiptLoading": false,
+                                    "_npMpReceiptLoaded": true,
+                                    "_npMpCashReceiptUrl": "{{$response.cash_receipt_url}}"
+                                  }
+                                }
+                              ],
+                              "onError": [
+                                {
+                                  "handler": "setState",
+                                  "params": {
+                                    "target": "local",
+                                    "_npMpReceiptLoading": false
+                                  }
+                                }
+                              ]
+                            }
+                          ]
+                        }
+                      ],
+                      "children": [
+                        {
+                          "type": "basic",
+                          "name": "Icon",
+                          "props": {
+                            "name": "receipt",
+                            "className": "w-3.5 h-3.5"
+                          }
+                        },
+                        {
+                          "type": "basic",
+                          "name": "Span",
+                          "text": "$t:sirsoft-pay_nicepayments.user.view_cash_receipt"
+                        }
+                      ]
+                    },
+                    {
+                      "comment": "현금영수증 링크 (조회 후)",
+                      "type": "basic",
+                      "name": "A",
+                      "if": "{{_local._npMpReceiptLoaded && _local._npMpCashReceiptUrl}}",
+                      "props": {
+                        "href": "{{_local._npMpCashReceiptUrl}}",
+                        "target": "_blank",
+                        "rel": "noopener noreferrer",
+                        "className": "inline-flex items-center gap-1 text-sm text-green-600 dark:text-green-400 hover:underline"
+                      },
+                      "children": [
+                        {
+                          "type": "basic",
+                          "name": "Icon",
+                          "props": {
+                            "name": "receipt",
+                            "className": "w-3.5 h-3.5"
+                          }
+                        },
+                        {
+                          "type": "basic",
+                          "name": "Span",
+                          "text": "$t:sirsoft-pay_nicepayments.user.view_cash_receipt"
+                        }
+                      ]
+                    }
+                  ]
+                }
+              ]
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/resources/extensions/user_order_complete_receipt.json b/plugins/_bundled/sirsoft-pay_nicepayments/resources/extensions/user_order_complete_receipt.json
new file mode 100644
index 00000000..bc3797ae
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/resources/extensions/user_order_complete_receipt.json
@@ -0,0 +1,196 @@
+{
+  "target_layout": "shop/order_complete",
+  "injections": [
+    {
+      "target_id": "order_complete_payment_summary",
+      "position": "append_child",
+      "components": [
+        {
+          "type": "basic",
+          "name": "Div",
+          "if": "{{orderData?.data?.payment?.pg_provider === 'nicepayments' && orderData?.data?.payment?.transaction_id && orderData?.data?.payment?.paid_at}}",
+          "props": {
+            "className": "pt-4 mt-2 border-t border-gray-200 dark:border-gray-700"
+          },
+          "children": [
+            {
+              "comment": "간편결제 서비스명 표시",
+              "type": "basic",
+              "name": "Div",
+              "if": "{{(['NAVERPAY','KAKAOPAY','SAMSUNGPAY','APPLEPAY','PAYCO','SKPAY','SSGPAY','LPAY']).includes(orderData?.data?.payment?.payment_meta?.PayMethod)}}",
+              "props": {
+                "className": "flex-between mb-2"
+              },
+              "children": [
+                {
+                  "type": "basic",
+                  "name": "Span",
+                  "props": {
+                    "className": "text-secondary text-sm"
+                  },
+                  "text": "$t:sirsoft-pay_nicepayments.user.easy_pay_label"
+                },
+                {
+                  "type": "basic",
+                  "name": "Span",
+                  "props": {
+                    "className": "text-heading"
+                  },
+                  "text": "{{({'NAVERPAY':'네이버페이','KAKAOPAY':'카카오페이','SAMSUNGPAY':'삼성페이','APPLEPAY':'애플페이','PAYCO':'PAYCO','SKPAY':'11pay','SSGPAY':'SSG페이','LPAY':'L.pay'})[orderData?.data?.payment?.payment_meta?.PayMethod] ?? orderData?.data?.payment?.payment_meta?.PayMethod}}"
+                }
+              ]
+            },
+            {
+              "comment": "영수증 링크 행",
+              "type": "basic",
+              "name": "Div",
+              "props": {
+                "className": "flex-between"
+              },
+              "children": [
+                {
+                  "type": "basic",
+                  "name": "Span",
+                  "props": {
+                    "className": "text-secondary text-sm"
+                  },
+                  "text": "$t:sirsoft-pay_nicepayments.user.receipt_label"
+                },
+                {
+                  "type": "basic",
+                  "name": "Div",
+                  "props": {
+                    "className": "flex-center gap-3"
+                  },
+                  "children": [
+                    {
+                      "comment": "결제 영수증",
+                      "type": "basic",
+                      "name": "A",
+                      "props": {
+                        "href": "https://npg.nicepay.co.kr/issue/IssueLoader.do?type=2&TID={{orderData?.data?.payment?.transaction_id}}",
+                        "target": "_blank",
+                        "rel": "noopener noreferrer",
+                        "className": "inline-flex items-center gap-1 text-sm text-blue-600 dark:text-blue-400 hover:underline"
+                      },
+                      "children": [
+                        {
+                          "type": "basic",
+                          "name": "Icon",
+                          "props": {
+                            "name": "file-text",
+                            "className": "w-3.5 h-3.5"
+                          }
+                        },
+                        {
+                          "type": "basic",
+                          "name": "Span",
+                          "text": "$t:sirsoft-pay_nicepayments.user.view_receipt"
+                        }
+                      ]
+                    },
+                    {
+                      "comment": "현금영수증 조회 버튼",
+                      "type": "basic",
+                      "name": "Button",
+                      "if": "{{orderData?.data?.payment?.cash_receipt_type && !_local._npOcReceiptLoaded}}",
+                      "props": {
+                        "type": "button",
+                        "className": "inline-flex items-center gap-1 text-sm text-green-600 dark:text-green-400 hover:underline disabled:opacity-50"
+                      },
+                      "actions": [
+                        {
+                          "type": "click",
+                          "handler": "sequence",
+                          "actions": [
+                            {
+                              "handler": "setState",
+                              "params": {
+                                "target": "local",
+                                "_npOcReceiptLoading": true
+                              }
+                            },
+                            {
+                              "handler": "apiCall",
+                              "auth_required": true,
+                              "target": "/api/plugins/sirsoft-pay_nicepayments/user/orders/{{route.id}}/receipt",
+                              "params": {
+                                "method": "GET"
+                              },
+                              "onSuccess": [
+                                {
+                                  "handler": "setState",
+                                  "params": {
+                                    "target": "local",
+                                    "_npOcReceiptLoading": false,
+                                    "_npOcReceiptLoaded": true,
+                                    "_npOcCashReceiptUrl": "{{$response.cash_receipt_url}}"
+                                  }
+                                }
+                              ],
+                              "onError": [
+                                {
+                                  "handler": "setState",
+                                  "params": {
+                                    "target": "local",
+                                    "_npOcReceiptLoading": false
+                                  }
+                                }
+                              ]
+                            }
+                          ]
+                        }
+                      ],
+                      "children": [
+                        {
+                          "type": "basic",
+                          "name": "Icon",
+                          "props": {
+                            "name": "receipt",
+                            "className": "w-3.5 h-3.5"
+                          }
+                        },
+                        {
+                          "type": "basic",
+                          "name": "Span",
+                          "text": "$t:sirsoft-pay_nicepayments.user.view_cash_receipt"
+                        }
+                      ]
+                    },
+                    {
+                      "comment": "현금영수증 링크 (조회 후)",
+                      "type": "basic",
+                      "name": "A",
+                      "if": "{{_local._npOcReceiptLoaded && _local._npOcCashReceiptUrl}}",
+                      "props": {
+                        "href": "{{_local._npOcCashReceiptUrl}}",
+                        "target": "_blank",
+                        "rel": "noopener noreferrer",
+                        "className": "inline-flex items-center gap-1 text-sm text-green-600 dark:text-green-400 hover:underline"
+                      },
+                      "children": [
+                        {
+                          "type": "basic",
+                          "name": "Icon",
+                          "props": {
+                            "name": "receipt",
+                            "className": "w-3.5 h-3.5"
+                          }
+                        },
+                        {
+                          "type": "basic",
+                          "name": "Span",
+                          "text": "$t:sirsoft-pay_nicepayments.user.view_cash_receipt"
+                        }
+                      ]
+                    }
+                  ]
+                }
+              ]
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/__tests__/adminPaymentMethodBrandInjector.test.ts b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/__tests__/adminPaymentMethodBrandInjector.test.ts
new file mode 100644
index 00000000..2303f9ff
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/__tests__/adminPaymentMethodBrandInjector.test.ts
@@ -0,0 +1,87 @@
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import {
+    resetAdminPaymentMethodBrandInjectorForTests,
+    syncRenderedAdminPaymentMethodBrands,
+} from '../adminPaymentMethodBrandInjector';
+
+function desktopItem(testId: string, title: string, description: string): string {
+    return `
+        <div class="flex-center border rounded-lg p-3 gap-4" data-test-item="${testId}">
+            <div data-drag-handle="true"><svg data-drag-icon="true"></svg></div>
+            <svg data-original-icon="true"></svg>
+            <div class="flex-1 min-w-0">
+                <div class="flex-center gap-2">
+                    <span class="font-medium text-gray-900 dark:text-gray-100">${title}</span>
+                </div>
+                <span class="text-label-subtle">${description}</span>
+            </div>
+            <div class="row-stack">
+                <span>PG사</span>
+                <select></select>
+            </div>
+        </div>
+    `;
+}
+
+function mobileItem(testId: string, title: string): string {
+    return `
+        <div class="excel-card" data-test-item="${testId}">
+            <div class="excel-card-header">
+                <div class="flex-center gap-3 flex-1 min-w-0">
+                    <div data-drag-handle="true"><svg data-drag-icon="true"></svg></div>
+                    <svg data-original-icon="true"></svg>
+                    <span class="font-medium text-gray-900 dark:text-gray-100 truncate">${title}</span>
+                </div>
+            </div>
+            <div class="excel-card-body">
+                <div class="row-stack"><label>PG사</label><select></select></div>
+            </div>
+        </div>
+    `;
+}
+
+describe('adminPaymentMethodBrandInjector', () => {
+    beforeEach(() => {
+        document.documentElement.lang = 'ko';
+        window.history.pushState({}, '', '/admin/ecommerce/settings?tab=order_settings');
+        document.body.innerHTML = `
+            ${desktopItem('naverpay', '네이버페이 (나이스페이먼츠)', '네이버페이로 결제 (나이스페이먼츠)')}
+            ${mobileItem('payco', 'PAYCO (나이스페이먼츠)')}
+            ${desktopItem('nhn-payco', 'PAYCO', 'PAYCO로 결제 (NHN KCP)')}
+            ${desktopItem('card', '신용카드', '신용카드로 결제')}
+        `;
+    });
+
+    afterEach(() => {
+        resetAdminPaymentMethodBrandInjectorForTests();
+        document.body.innerHTML = '';
+    });
+
+    it('나이스페이먼츠 간편결제 행의 기본 아이콘을 브랜드 텍스트 배지로 바꾼다', () => {
+        expect(syncRenderedAdminPaymentMethodBrands()).toBe(true);
+
+        const naverPay = document.querySelector<HTMLElement>('[data-test-item="naverpay"]');
+        const payco = document.querySelector<HTMLElement>('[data-test-item="payco"]');
+        const nhnPayco = document.querySelector<HTMLElement>('[data-test-item="nhn-payco"]');
+        const card = document.querySelector<HTMLElement>('[data-test-item="card"]');
+
+        expect(naverPay?.dataset.nicepayAdminPaymentMethod).toBe('nicepay_naverpay');
+        expect(naverPay?.querySelector('[data-nicepay-admin-payment-brand-mark="true"]')?.textContent).toBe('N');
+        expect(naverPay?.querySelector('[data-original-icon="true"]')).toBeNull();
+        expect(naverPay?.querySelector('[data-drag-icon="true"]')).not.toBeNull();
+
+        expect(payco?.dataset.nicepayAdminPaymentMethod).toBe('nicepay_payco');
+        expect(payco?.querySelector('[data-nicepay-admin-payment-brand-mark="true"]')?.textContent).toBe('P');
+
+        expect(nhnPayco?.dataset.nicepayAdminPaymentMethod).toBeUndefined();
+        expect(nhnPayco?.querySelector('[data-original-icon="true"]')).not.toBeNull();
+        expect(card?.querySelector('[data-original-icon="true"]')).not.toBeNull();
+    });
+
+    it('주문설정 화면이 아니면 관리자 결제수단 아이콘을 바꾸지 않는다', () => {
+        window.history.pushState({}, '', '/admin/ecommerce/settings?tab=shipping');
+
+        expect(syncRenderedAdminPaymentMethodBrands()).toBe(false);
+        expect(document.querySelector('[data-nicepay-admin-payment-brand-mark="true"]')).toBeNull();
+    });
+});
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/__tests__/checkoutEasyPayInjector.test.ts b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/__tests__/checkoutEasyPayInjector.test.ts
new file mode 100644
index 00000000..6d7d1b80
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/__tests__/checkoutEasyPayInjector.test.ts
@@ -0,0 +1,83 @@
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import {
+    resetCheckoutEasyPayInjectorForTests,
+    syncRenderedCheckoutEasyPayMethods,
+} from '../checkoutEasyPayInjector';
+
+function paymentButton(label: string, description: string): string {
+    return `
+        <button type="button">
+            <div class="flex items-center gap-3">
+                <i class="fas fa-wallet" role="img"></i>
+                <div>
+                    <p>${label}</p>
+                    <p>${description}</p>
+                </div>
+            </div>
+        </button>
+    `;
+}
+
+function plainText(element: Element | null | undefined): string {
+    return (element?.textContent ?? '').replace(/\u200B/g, '').replace(/\s+/g, ' ').trim();
+}
+
+describe('checkoutEasyPayInjector', () => {
+    beforeEach(() => {
+        document.documentElement.lang = 'ko';
+        window.history.pushState({}, '', '/shop/checkout');
+        document.body.innerHTML = `
+            ${paymentButton('네이\u200B버페이 (나이스페이먼츠)', '네이\u200B버페이로 결제 (나이스페이먼츠)')}
+            ${paymentButton('카카\u200B오페이 (나이스페이먼츠)', '카카\u200B오페이로 결제 (나이스페이먼츠)')}
+            ${paymentButton('삼성\u200B페이 (나이스페이먼츠)', '삼성\u200B페이로 결제 (나이스페이먼츠)')}
+            ${paymentButton('애플페이 (나이스페이먼츠)', '애플페이로 결제 (나이스페이먼츠)')}
+            ${paymentButton('PAYCO (나이스페이먼츠)', 'PAYCO로 결제 (나이스페이먼츠)')}
+            ${paymentButton('11pay (나이스페이먼츠)', '11pay로 결제 (나이스페이먼츠)')}
+            ${paymentButton('SSG페이 (나이스페이먼츠)', 'SSG페이로 결제 (나이스페이먼츠)')}
+            ${paymentButton('L.\u200Bpay (나이스페이먼츠)', 'L.\u200Bpay로 결제 (나이스페이먼츠)')}
+        `;
+    });
+
+    afterEach(() => {
+        resetCheckoutEasyPayInjectorForTests();
+        document.body.innerHTML = '';
+    });
+
+    it('나이스페이먼츠 간편결제를 NHN KCP처럼 아이콘과 텍스트가 있는 버튼으로 보정한다', async () => {
+        await syncRenderedCheckoutEasyPayMethods();
+
+        const buttons = Array.from(document.querySelectorAll<HTMLButtonElement>('button[data-nicepay-easy-pay-method]'));
+
+        expect(buttons.map((button) => button.dataset.nicepayEasyPayMethod)).toEqual([
+            'nicepay_naverpay',
+            'nicepay_kakaopay',
+            'nicepay_samsungpay',
+            'nicepay_applepay',
+            'nicepay_payco',
+            'nicepay_skpay',
+            'nicepay_ssgpay',
+            'nicepay_lpay',
+        ]);
+
+        expect(buttons.map((button) => plainText(button))).toEqual([
+            'N 네이버페이 (나이스페이먼츠) 네이버페이로 결제 (나이스페이먼츠)',
+            'K 카카오페이 (나이스페이먼츠) 카카오페이로 결제 (나이스페이먼츠)',
+            'S 삼성페이 (나이스페이먼츠) 삼성페이로 결제 (나이스페이먼츠)',
+            'A 애플페이 (나이스페이먼츠) 애플페이로 결제 (나이스페이먼츠)',
+            'P PAYCO (나이스페이먼츠) PAYCO로 결제 (나이스페이먼츠)',
+            '11 11pay (나이스페이먼츠) 11pay로 결제 (나이스페이먼츠)',
+            'SSG SSG페이 (나이스페이먼츠) SSG페이로 결제 (나이스페이먼츠)',
+            'L L.pay (나이스페이먼츠) L.pay로 결제 (나이스페이먼츠)',
+        ]);
+
+        for (const button of buttons) {
+            const row = button.querySelector<HTMLElement>('.flex.items-center');
+
+            expect(button.querySelector('[data-nicepay-easy-pay-mark="true"]')).not.toBeNull();
+            expect(button.style.textAlign).toBe('left');
+            expect(row?.style.justifyContent).toBe('flex-start');
+            expect(button.dataset.kginicisBrandPaymentMethod).toBeUndefined();
+            expect(button.dataset.nhnkcpEasyPayMethod).toBeUndefined();
+        }
+    });
+});
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/__tests__/handlers/requestPayment.test.ts b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/__tests__/handlers/requestPayment.test.ts
new file mode 100644
index 00000000..011ee941
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/__tests__/handlers/requestPayment.test.ts
@@ -0,0 +1,285 @@
+/**
+ * requestPayment 핸들러 테스트
+ *
+ * 나이스페이먼츠 결제창 호출 핸들러의 입력 검증 및 에러 경로 동작을 검증합니다.
+ * SDK 로드/goPay 호출/모바일 redirect 등 외부 부수효과 의존 흐름은
+ * tests/scenarios 매니페스트(통합 시나리오)에서 다루며, 본 단위 테스트는
+ * "초기 가드 + catch 블록 정상 호출" 두 축에 집중합니다.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { requestPaymentHandler } from '../../handlers/requestPayment';
+
+const PG_PAYMENT = {
+    order_number: 'ORD-001',
+    order_name: 'Test Order',
+    amount: 10000,
+    customer_email: 'buyer@example.com',
+    customer_phone: '01012345678',
+};
+
+describe('requestPaymentHandler', () => {
+    let apiGet: ReturnType<typeof vi.fn>;
+    let setLocalSpy: ReturnType<typeof vi.fn>;
+    let toastErrorSpy: ReturnType<typeof vi.fn>;
+
+    beforeEach(() => {
+        apiGet = vi.fn();
+        setLocalSpy = vi.fn();
+        toastErrorSpy = vi.fn();
+        (window as Record<string, unknown>).G7Core = {
+            api: { get: apiGet },
+            state: { setLocal: setLocalSpy },
+            toast: { error: toastErrorSpy },
+        };
+    });
+
+    afterEach(() => {
+        delete (window as Record<string, unknown>).G7Core;
+        vi.restoreAllMocks();
+    });
+
+    it('pgPaymentData가 없으면 console.error 후 조기 반환', async () => {
+        const consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => {});
+
+        await requestPaymentHandler({ params: {} });
+
+        expect(consoleSpy).toHaveBeenCalledWith(
+            expect.stringContaining('pgPaymentData is required')
+        );
+        expect(apiGet).not.toHaveBeenCalled();
+        expect(setLocalSpy).not.toHaveBeenCalled();
+    });
+
+    it('client config 응답에 data 가 없으면 console.error 후 조기 반환', async () => {
+        const consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => {});
+        apiGet.mockResolvedValue({}); // data 누락
+
+        await requestPaymentHandler({ params: { pgPaymentData: PG_PAYMENT } });
+
+        expect(consoleSpy).toHaveBeenCalledWith(
+            expect.stringContaining('Failed to fetch client config'),
+            expect.anything()
+        );
+        expect(setLocalSpy).not.toHaveBeenCalled();
+    });
+
+    it('client config API 자체가 throw 하면 catch 블록에서 toast.error + setLocal 복구', async () => {
+        const consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => {});
+        apiGet.mockRejectedValue(new Error('Network error'));
+
+        await requestPaymentHandler({ params: { pgPaymentData: PG_PAYMENT } });
+
+        expect(consoleSpy).toHaveBeenCalledWith(
+            expect.stringContaining('requestPayment error'),
+            expect.any(Error)
+        );
+        // catch 블록은 paymentMethod 기본값 'card' 로 setLocal 복구
+        expect(setLocalSpy).toHaveBeenCalledWith({
+            isSubmittingOrder: false,
+            paymentMethod: 'card',
+        });
+        expect(toastErrorSpy).toHaveBeenCalledWith(
+            expect.stringContaining('결제 중 오류가 발생')
+        );
+    });
+
+    it('paramPaymentMethod 가 명시되면 catch 시 그 값으로 복구', async () => {
+        vi.spyOn(console, 'error').mockImplementation(() => {});
+        apiGet.mockRejectedValue(new Error('boom'));
+
+        await requestPaymentHandler({
+            params: {
+                pgPaymentData: PG_PAYMENT,
+                paymentMethod: 'nicepay_kakaopay',
+            },
+        });
+
+        expect(setLocalSpy).toHaveBeenCalledWith({
+            isSubmittingOrder: false,
+            paymentMethod: 'nicepay_kakaopay',
+        });
+    });
+
+    it('catch 블록은 결제 진행 플래그를 반드시 false 로 리셋', async () => {
+        vi.spyOn(console, 'error').mockImplementation(() => {});
+        apiGet.mockRejectedValue(new Error('fail'));
+        (window as unknown as Record<string, unknown>).__sirsoftNicepayPaymentInProgress = true;
+
+        await requestPaymentHandler({ params: { pgPaymentData: PG_PAYMENT } });
+
+        expect(
+            (window as unknown as Record<string, unknown>).__sirsoftNicepayPaymentInProgress
+        ).toBe(false);
+    });
+
+    /**
+     * 모바일 환경에서 카드 외 결제수단 선택 시 PayMethod 회귀 차단.
+     *
+     * 증상 (회귀 시): 모바일에서 가상계좌/계좌이체/휴대폰결제를 선택해도
+     *   NicePay 모바일 결제창이 카드결제 화면으로 열림.
+     * 원인 후보: requestPaymentHandler 의 paymentMethod → payMethodMap 매핑이
+     *   isMobile 분기 진입 전에 적용되어야 하는데, 누락되거나 모바일 코드 경로에서
+     *   덮어쓰이면 PayMethod 가 항상 CARD 로 고정.
+     *
+     * 검증 전략: navigator.userAgentData.mobile = true 로 모바일 판정 강제.
+     *   fetch (signData) 와 apiGet (client-config + order) 을 mock 한 뒤,
+     *   HTMLFormElement.prototype.submit 를 spy 로 가로채 form 의 hidden input
+     *   PayMethod 값을 검증한다 (실제 NicePay 모바일 endpoint 로 redirect 되지 않음).
+     */
+    describe('모바일 환경 일반 결제수단 PayMethod 매핑', () => {
+        const NICEPAY_MOBILE_HOST = 'web.nicepay.co.kr';
+
+        let submitSpy: ReturnType<typeof vi.spyOn>;
+        let fetchSpy: ReturnType<typeof vi.fn>;
+        let originalUserAgentData: PropertyDescriptor | undefined;
+
+        beforeEach(() => {
+            originalUserAgentData = Object.getOwnPropertyDescriptor(navigator, 'userAgentData');
+            Object.defineProperty(navigator, 'userAgentData', {
+                value: { mobile: true },
+                configurable: true,
+            });
+
+            apiGet.mockImplementation((url: string) => {
+                if (url.includes('client-config/nicepayments')) {
+                    return Promise.resolve({
+                        data: {
+                            mid: 'SRpaytestm',
+                            sdk_url: 'https://example/sdk.js',
+                            sign_data_url: '/api/plugins/sirsoft-pay_nicepayments/sign-data',
+                            useEscrow: false,
+                        },
+                    });
+                }
+                if (url.includes('/user/orders/')) {
+                    return Promise.resolve({ data: {} });
+                }
+                return Promise.resolve({});
+            });
+
+            fetchSpy = vi.fn().mockResolvedValue({
+                ok: true,
+                json: async () => ({
+                    ediDate: '20260101000000',
+                    signData: 'fake-sig',
+                    mid: 'SRpaytestm',
+                }),
+            });
+            (window as unknown as Record<string, unknown>).fetch = fetchSpy;
+
+            submitSpy = vi.spyOn(HTMLFormElement.prototype, 'submit').mockImplementation(() => {});
+        });
+
+        afterEach(() => {
+            if (originalUserAgentData) {
+                Object.defineProperty(navigator, 'userAgentData', originalUserAgentData);
+            } else {
+                delete (navigator as unknown as Record<string, unknown>).userAgentData;
+            }
+            submitSpy.mockRestore();
+            delete (window as unknown as Record<string, unknown>).fetch;
+        });
+
+        function getSubmittedPayMethod(): string | null {
+            const form = submitSpy.mock.instances[0] as HTMLFormElement;
+            const input = form.querySelector('input[name="PayMethod"]') as HTMLInputElement | null;
+            return input?.value ?? null;
+        }
+
+        function getSubmittedFormAction(): string {
+            const form = submitSpy.mock.instances[0] as HTMLFormElement;
+            return form.action;
+        }
+
+        it("가상계좌(vbank)는 PayMethod='VBANK' 로 모바일 endpoint 에 POST", async () => {
+            await requestPaymentHandler({
+                params: { pgPaymentData: PG_PAYMENT, paymentMethod: 'vbank' },
+            });
+
+            expect(submitSpy).toHaveBeenCalledTimes(1);
+            expect(getSubmittedPayMethod()).toBe('VBANK');
+            expect(getSubmittedFormAction()).toContain(NICEPAY_MOBILE_HOST);
+        });
+
+        it("계좌이체(bank)는 PayMethod='BANK' 로 모바일 endpoint 에 POST", async () => {
+            await requestPaymentHandler({
+                params: { pgPaymentData: PG_PAYMENT, paymentMethod: 'bank' },
+            });
+
+            expect(submitSpy).toHaveBeenCalledTimes(1);
+            expect(getSubmittedPayMethod()).toBe('BANK');
+            expect(getSubmittedFormAction()).toContain(NICEPAY_MOBILE_HOST);
+        });
+
+        it("휴대폰결제(phone)는 PayMethod='CELLPHONE' 로 모바일 endpoint 에 POST", async () => {
+            await requestPaymentHandler({
+                params: { pgPaymentData: PG_PAYMENT, paymentMethod: 'phone' },
+            });
+
+            expect(submitSpy).toHaveBeenCalledTimes(1);
+            expect(getSubmittedPayMethod()).toBe('CELLPHONE');
+            expect(getSubmittedFormAction()).toContain(NICEPAY_MOBILE_HOST);
+        });
+
+        it("신용카드(card)는 PayMethod='CARD'", async () => {
+            await requestPaymentHandler({
+                params: { pgPaymentData: PG_PAYMENT, paymentMethod: 'card' },
+            });
+
+            expect(submitSpy).toHaveBeenCalledTimes(1);
+            expect(getSubmittedPayMethod()).toBe('CARD');
+        });
+
+        it('SignData 요청은 주문자 이메일과 전화번호를 함께 전송', async () => {
+            await requestPaymentHandler({
+                params: { pgPaymentData: PG_PAYMENT, paymentMethod: 'card' },
+            });
+
+            expect(fetchSpy).toHaveBeenCalledTimes(1);
+            const [, init] = fetchSpy.mock.calls[0];
+            expect(JSON.parse(String(init?.body))).toEqual({
+                amt: PG_PAYMENT.amount,
+                moid: PG_PAYMENT.order_number,
+                buyer_email: PG_PAYMENT.customer_email,
+                buyer_phone: PG_PAYMENT.customer_phone,
+            });
+        });
+
+        it("paymentMethod 미명시 시 _local.paymentMethod 로 fallback", async () => {
+            (window as unknown as Record<string, unknown>).__templateApp = {
+                globalState: { _local: { paymentMethod: 'vbank' } },
+            };
+
+            await requestPaymentHandler({ params: { pgPaymentData: PG_PAYMENT } });
+
+            expect(getSubmittedPayMethod()).toBe('VBANK');
+
+            delete (window as unknown as Record<string, unknown>).__templateApp;
+        });
+
+        it("간편결제(nicepay_kakaopay)는 PayMethod='CARD' + DirectKakao=Y", async () => {
+            await requestPaymentHandler({
+                params: { pgPaymentData: PG_PAYMENT, paymentMethod: 'nicepay_kakaopay' },
+            });
+
+            const form = submitSpy.mock.instances[0] as HTMLFormElement;
+            const reservedInput = form.querySelector('input[name="NicepayReserved"]') as HTMLInputElement | null;
+            const mallReservedInput = form.querySelector('input[name="MallReserved"]') as HTMLInputElement | null;
+            const mallReserved1Input = form.querySelector('input[name="MallReserved1"]') as HTMLInputElement | null;
+
+            expect(getSubmittedPayMethod()).toBe('CARD');
+            expect(reservedInput?.value).toBe('DirectKakao=Y');
+            expect(mallReservedInput?.value).toBe('nicepay_easy_pay_method=nicepay_kakaopay');
+            expect(mallReserved1Input?.value).toBe('nicepay_kakaopay');
+        });
+
+        it('모바일 form 은 acceptCharset=euc-kr', async () => {
+            await requestPaymentHandler({
+                params: { pgPaymentData: PG_PAYMENT, paymentMethod: 'vbank' },
+            });
+
+            const form = submitSpy.mock.instances[0] as HTMLFormElement;
+            expect(form.acceptCharset).toBe('euc-kr');
+        });
+    });
+});
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/__tests__/handlers/setPaymentMethod.test.ts b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/__tests__/handlers/setPaymentMethod.test.ts
new file mode 100644
index 00000000..e01eddb6
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/__tests__/handlers/setPaymentMethod.test.ts
@@ -0,0 +1,82 @@
+/**
+ * setPaymentMethod 핸들러 테스트
+ *
+ * 결제수단 선택 시 _local 상태에 paymentMethod / serverPaymentMethod 를 분리 저장하는
+ * 동작을 검증합니다. 간편결제(`nicepay_*`)는 G7 내부적으로 카드로 취급되어
+ * `serverPaymentMethod = 'card'` 가 되어야 합니다.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { setPaymentMethodHandler } from '../../handlers/setPaymentMethod';
+
+describe('setPaymentMethodHandler', () => {
+    let setLocalSpy: ReturnType<typeof vi.fn>;
+
+    beforeEach(() => {
+        setLocalSpy = vi.fn();
+        (window as Record<string, unknown>).G7Core = {
+            state: { setLocal: setLocalSpy },
+        };
+    });
+
+    afterEach(() => {
+        delete (window as Record<string, unknown>).G7Core;
+    });
+
+    it('paymentMethod가 없으면 setLocal을 호출하지 않는다', () => {
+        setPaymentMethodHandler({ params: {} });
+        expect(setLocalSpy).not.toHaveBeenCalled();
+    });
+
+    it('일반 결제수단(card)은 paymentMethod와 serverPaymentMethod에 동일 값 저장', () => {
+        setPaymentMethodHandler({ params: { paymentMethod: 'card' } });
+
+        expect(setLocalSpy).toHaveBeenCalledWith({
+            paymentMethod: 'card',
+            serverPaymentMethod: 'card',
+        });
+    });
+
+    it('가상계좌(vbank)도 그대로 분리 저장', () => {
+        setPaymentMethodHandler({ params: { paymentMethod: 'vbank' } });
+
+        expect(setLocalSpy).toHaveBeenCalledWith({
+            paymentMethod: 'vbank',
+            serverPaymentMethod: 'vbank',
+        });
+    });
+
+    describe('간편결제 (nicepay_*)', () => {
+        it('네이버페이는 serverPaymentMethod=card 로 정규화', () => {
+            setPaymentMethodHandler({ params: { paymentMethod: 'nicepay_naverpay' } });
+
+            expect(setLocalSpy).toHaveBeenCalledWith({
+                paymentMethod: 'nicepay_naverpay',
+                serverPaymentMethod: 'card',
+            });
+        });
+
+        it('카카오페이도 serverPaymentMethod=card', () => {
+            setPaymentMethodHandler({ params: { paymentMethod: 'nicepay_kakaopay' } });
+
+            expect(setLocalSpy).toHaveBeenCalledWith({
+                paymentMethod: 'nicepay_kakaopay',
+                serverPaymentMethod: 'card',
+            });
+        });
+
+        it('애플페이도 serverPaymentMethod=card', () => {
+            setPaymentMethodHandler({ params: { paymentMethod: 'nicepay_applepay' } });
+
+            expect(setLocalSpy).toHaveBeenCalledWith({
+                paymentMethod: 'nicepay_applepay',
+                serverPaymentMethod: 'card',
+            });
+        });
+    });
+
+    it('G7Core가 없으면 조용히 무시 (optional chaining)', () => {
+        delete (window as Record<string, unknown>).G7Core;
+        // 던지지 않고 정상 종료해야 함
+        expect(() => setPaymentMethodHandler({ params: { paymentMethod: 'card' } })).not.toThrow();
+    });
+});
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/__tests__/layouts/pluginSettingsSticky.test.tsx b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/__tests__/layouts/pluginSettingsSticky.test.tsx
new file mode 100644
index 00000000..61dd2828
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/__tests__/layouts/pluginSettingsSticky.test.tsx
@@ -0,0 +1,83 @@
+/**
+ * @file pluginSettingsSticky.test.tsx
+ * @description sirsoft-pay_nicepayments 플러그인 환경설정 화면 하단 저장 버튼 sticky 고정 테스트
+ *
+ * 플러그인 환경설정(plugin_settings.json)의 하단 저장/취소 버튼 영역이
+ * 긴 콘텐츠를 스크롤하는 동안에도 화면 하단에 고정되도록 sticky 클래스가
+ * 적용되어 있는지 검증한다.
+ */
+
+import { describe, it, expect } from 'vitest';
+import pluginSettingsLayout from '../../../layouts/admin/plugin_settings.json';
+
+/** 레이아웃 트리에서 주어진 id 의 노드를 찾는다. */
+function findById(node: unknown, id: string): Record<string, unknown> | undefined {
+  if (!node || typeof node !== 'object') {
+    return undefined;
+  }
+  const value = node as Record<string, unknown>;
+  if (value.id === id) {
+    return value;
+  }
+  for (const child of Object.values(value)) {
+    const found = findById(child, id);
+    if (found) {
+      return found;
+    }
+  }
+  return undefined;
+}
+
+function classNameOf(node: Record<string, unknown> | undefined): string {
+  const props = (node?.props ?? {}) as Record<string, unknown>;
+  return typeof props.className === 'string' ? props.className : '';
+}
+
+function collectClassNames(node: unknown, classNames: string[] = []): string[] {
+  if (!node || typeof node !== 'object') {
+    return classNames;
+  }
+  const value = node as Record<string, unknown>;
+  const props = (value.props ?? {}) as Record<string, unknown>;
+  if (typeof props.className === 'string') {
+    classNames.push(props.className);
+  }
+  for (const child of Object.values(value)) {
+    collectClassNames(child, classNames);
+  }
+
+  return classNames;
+}
+
+describe('plugin_settings 하단 버튼 sticky 고정', () => {
+  it('footer_buttons 에 sticky bottom 고정 클래스가 존재해야 한다', () => {
+    const footer = findById(pluginSettingsLayout, 'footer_buttons');
+    expect(footer).toBeDefined();
+
+    const className = classNameOf(footer);
+    expect(className).toContain('sticky');
+    expect(className).toContain('bottom-0');
+    expect(className).toContain('z-10');
+  });
+
+  it('활성 테마의 신규 시맨틱 CSS 없이도 설정 화면 기본 레이아웃이 적용되어야 한다', () => {
+    const root = findById(pluginSettingsLayout, 'plugin_settings_content');
+    expect(root).toBeDefined();
+
+    const rootClassName = classNameOf(root);
+    expect(rootClassName).toContain('p-4');
+    expect(rootClassName).toContain('sm:p-6');
+    expect(rootClassName).toContain('lg:p-8');
+    expect(rootClassName).toContain('min-h-screen');
+    expect(rootClassName).toContain('bg-gray-50');
+    expect(rootClassName).toContain('dark:bg-gray-900');
+
+    const classNames = collectClassNames(pluginSettingsLayout);
+    for (const className of classNames) {
+      expect(className).not.toContain('admin-page-content-responsive');
+      expect(className).not.toContain('flex-between');
+      expect(className).not.toContain('sticky-footer-buttons');
+      expect(className).not.toContain('row-stack');
+    }
+  });
+});
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/__tests__/orderPaymentDisplayInjectors.test.ts b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/__tests__/orderPaymentDisplayInjectors.test.ts
new file mode 100644
index 00000000..7873c069
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/__tests__/orderPaymentDisplayInjectors.test.ts
@@ -0,0 +1,47 @@
+import { describe, expect, it } from 'vitest';
+import { patchAdminPaymentMethodDisplay } from '../adminOrderPaymentDisplayInjector';
+
+describe('NicePayments order payment display injectors', () => {
+    it('관리자 주문상세 결제수단 행을 간편결제 표시명으로 교체한다', () => {
+        document.body.innerHTML = `
+            <section id="section_payment_info">
+                <div>
+                    <div>결제수단</div>
+                    <div>신용카드</div>
+                    <div>(일시불)</div>
+                </div>
+            </section>
+        `;
+
+        const root = document.getElementById('section_payment_info');
+
+        const patched = patchAdminPaymentMethodDisplay(root!, {
+            _pay_method_label: '카카오페이 (신용카드)',
+            _base_pay_method_label: '신용카드',
+            _embedded_pg_provider_label: '카카오페이',
+        });
+
+        expect(patched).toBe(true);
+        expect(root?.textContent).toContain('카카오페이 (신용카드, 일시불)');
+        expect(root?.textContent).not.toContain('(일시불)');
+    });
+
+    it('관리자 주문상세 결제수단 배지를 간편결제 라벨로 교체한다', () => {
+        document.body.innerHTML = `
+            <section id="section_payment_info">
+                <span class="rounded-full font-medium">신용카드</span>
+            </section>
+        `;
+
+        const root = document.getElementById('section_payment_info');
+
+        const patched = patchAdminPaymentMethodDisplay(root!, {
+            _pay_method_label: '네이버페이 (신용카드)',
+            _base_pay_method_label: '신용카드',
+            _embedded_pg_provider_label: '네이버페이',
+        });
+
+        expect(patched).toBe(true);
+        expect(root?.querySelector('span')?.textContent).toBe('네이버페이');
+    });
+});
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/__tests__/orderResponseInterceptor.test.ts b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/__tests__/orderResponseInterceptor.test.ts
new file mode 100644
index 00000000..2d3d9e50
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/__tests__/orderResponseInterceptor.test.ts
@@ -0,0 +1,107 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { installOrderResponseInterceptor } from '../orderResponseInterceptor';
+import { requestPaymentHandler } from '../handlers/requestPayment';
+
+vi.mock('../handlers/requestPayment', () => ({
+    requestPaymentHandler: vi.fn(),
+}));
+
+const requestPaymentMock = vi.mocked(requestPaymentHandler);
+
+function resetNicepayWindowFlags(): void {
+    const w = window as unknown as Record<string, unknown>;
+    delete w.__sirsoftNicepayFetchInterceptorInstalled;
+    delete w.__sirsoftPgOriginalFetch;
+    delete w.__sirsoftNicepayPaymentInProgress;
+    delete w.__sirsoftNicepayCheckoutCache;
+}
+
+function buildOrderResponse(order: Record<string, unknown>): Response {
+    return new Response(JSON.stringify({
+        success: true,
+        data: {
+            order,
+            requires_pg_payment: false,
+            redirect_url: '/shop/orders/ORD-NICE-001/complete',
+        },
+    }), {
+        status: 200,
+        headers: { 'Content-Type': 'application/json' },
+    });
+}
+
+describe('installOrderResponseInterceptor', () => {
+    let originalFetch: typeof window.fetch;
+    let fetchSpy: ReturnType<typeof vi.fn>;
+
+    beforeEach(() => {
+        originalFetch = window.fetch;
+        fetchSpy = vi.fn();
+        (window as unknown as Record<string, unknown>).fetch = fetchSpy;
+        resetNicepayWindowFlags();
+        requestPaymentMock.mockClear();
+    });
+
+    afterEach(() => {
+        window.fetch = originalFetch;
+        resetNicepayWindowFlags();
+        vi.restoreAllMocks();
+    });
+
+    it('간편결제 fallback pg_payment_data 금액은 total_due_amount를 우선 사용', async () => {
+        fetchSpy.mockResolvedValue(buildOrderResponse({
+            order_number: 'ORD-NICE-001',
+            total_amount: '57000.00',
+            total_due_amount: '53000.00',
+            options: [{ product_name: '테스트 상품' }],
+            orderer_name: '홍길동',
+            orderer_email: 'buyer@example.com',
+            orderer_phone: '010-1234-5678',
+            user_id: 7,
+        }));
+
+        installOrderResponseInterceptor();
+
+        await window.fetch('/api/modules/sirsoft-ecommerce/user/orders', {
+            method: 'POST',
+            body: JSON.stringify({ payment_method: 'nicepay_kakaopay' }),
+        });
+
+        expect(requestPaymentMock).toHaveBeenCalledWith({
+            params: {
+                pgPaymentData: expect.objectContaining({
+                    order_number: 'ORD-NICE-001',
+                    order_name: '테스트 상품',
+                    amount: 53000,
+                    customer_phone: '01012345678',
+                }),
+                paymentMethod: 'nicepay_kakaopay',
+            },
+        });
+    });
+
+    it('total_due_amount가 없는 구형 응답은 total_amount로 fallback', async () => {
+        fetchSpy.mockResolvedValue(buildOrderResponse({
+            order_number: 'ORD-NICE-002',
+            total_amount: '57000.00',
+            options: [{ product_name: '테스트 상품' }],
+        }));
+
+        installOrderResponseInterceptor();
+
+        await window.fetch('/api/modules/sirsoft-ecommerce/user/orders', {
+            method: 'POST',
+            body: JSON.stringify({ payment_method: 'nicepay_naverpay' }),
+        });
+
+        expect(requestPaymentMock).toHaveBeenCalledWith({
+            params: {
+                pgPaymentData: expect.objectContaining({
+                    order_number: 'ORD-NICE-002',
+                    amount: 57000,
+                }),
+                paymentMethod: 'nicepay_naverpay',
+            },
+        });
+    });
+});
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/__tests__/paymentCloseReport.test.ts b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/__tests__/paymentCloseReport.test.ts
new file mode 100644
index 00000000..89834ab2
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/__tests__/paymentCloseReport.test.ts
@@ -0,0 +1,53 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { reportPaymentWindowClosed } from '../paymentCloseReport';
+
+function windowRecord(): Record<string, any> {
+    return window as unknown as Record<string, any>;
+}
+
+describe('paymentCloseReport', () => {
+    afterEach(() => {
+        delete windowRecord().G7Core;
+        vi.restoreAllMocks();
+    });
+
+    it('G7Core API로 나이스페이먼츠 결제창 닫힘을 보고한다', async () => {
+        const apiPost = vi.fn().mockResolvedValue({ success: true });
+        windowRecord().G7Core = {
+            api: { post: apiPost },
+        };
+
+        await reportPaymentWindowClosed({
+            closeReportUrl: '/plugins/sirsoft-pay_nicepayments/payment/close-report',
+            oid: 'ORD-NICE-CLOSE-001',
+            price: 10000,
+            buyer_email: 'buyer@example.com',
+            buyer_phone: '01012345678',
+            payment_method: 'card',
+        }, 'nicepay-window-closed');
+
+        expect(apiPost).toHaveBeenCalledWith('/plugins/sirsoft-pay_nicepayments/payment/close-report', {
+            oid: 'ORD-NICE-CLOSE-001',
+            price: 10000,
+            buyer_email: 'buyer@example.com',
+            buyer_phone: '01012345678',
+            payment_method: 'card',
+            reason: 'nicepay-window-closed',
+        });
+    });
+
+    it('G7Core API가 없으면 /plugins 경로를 /api/plugins 경로로 변환해 fetch 한다', async () => {
+        const fetchSpy = vi.spyOn(globalThis, 'fetch').mockResolvedValue(new Response('{}'));
+
+        await reportPaymentWindowClosed({
+            closeReportUrl: '/plugins/sirsoft-pay_nicepayments/payment/close-report',
+            oid: 'ORD-NICE-CLOSE-002',
+            price: 15000,
+        });
+
+        expect(fetchSpy).toHaveBeenCalledWith('/api/plugins/sirsoft-pay_nicepayments/payment/close-report', expect.objectContaining({
+            method: 'POST',
+            keepalive: true,
+        }));
+    });
+});
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/adminOrderPaymentDisplayInjector.ts b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/adminOrderPaymentDisplayInjector.ts
new file mode 100644
index 00000000..dbc08a54
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/adminOrderPaymentDisplayInjector.ts
@@ -0,0 +1,163 @@
+const PLUGIN_ID = 'sirsoft-pay_nicepayments';
+const FLAG = '__nicepayAdminPaymentDisplayInjectorInstalled';
+
+const ADMIN_ORDER_SHOW_RE = /^\/admin\/ecommerce\/orders\/([^/]+)$/;
+
+interface AdminTransactionStatus {
+    _pay_method_label?: string | null;
+    _base_pay_method_label?: string | null;
+    _embedded_pg_provider_label?: string | null;
+}
+
+function getToken(): string | null {
+    return localStorage.getItem('auth_token');
+}
+
+async function fetchAdminTransactionStatus(orderNumber: string): Promise<AdminTransactionStatus | null> {
+    const token = getToken();
+    if (!token) return null;
+
+    try {
+        const res = await fetch(`/api/plugins/${PLUGIN_ID}/admin/orders/${orderNumber}/transaction-status`, {
+            headers: { Authorization: `Bearer ${token}`, Accept: 'application/json' },
+        });
+        if (!res.ok) return null;
+
+        const json = (await res.json()) as { data?: AdminTransactionStatus | null } | AdminTransactionStatus;
+        return ('data' in json ? json.data : json) ?? null;
+    } catch {
+        return null;
+    }
+}
+
+function directElementChildren(el: Element): HTMLElement[] {
+    return Array.from(el.children).filter(
+        (child): child is HTMLElement => child instanceof HTMLElement,
+    );
+}
+
+function patchLabeledPaymentMethod(root: Element, displayLabel: string): boolean {
+    let patched = false;
+
+    const rows = Array.from(root.querySelectorAll<HTMLElement>('div'));
+    for (const row of rows) {
+        const children = directElementChildren(row);
+        const labelIndex = children.findIndex(child => child.textContent?.trim() === '결제수단');
+        if (labelIndex < 0) continue;
+
+        const value = children
+            .slice(labelIndex + 1)
+            .find(child => child.textContent?.trim() && child.textContent.trim() !== '결제수단');
+        if (!value) continue;
+
+        const installment = children
+            .slice(labelIndex + 2)
+            .find(child => /^\(.+\)$/.test(child.textContent?.trim() ?? ''));
+        const installmentText = installment?.textContent?.trim().replace(/^\(|\)$/g, '') ?? '';
+        const nextDisplayLabel = installmentText && displayLabel.endsWith(')')
+            ? displayLabel.replace(/\)$/, `, ${installmentText})`)
+            : displayLabel;
+
+        if (value.textContent?.trim() !== nextDisplayLabel) {
+            value.textContent = nextDisplayLabel;
+            value.dataset.nicepayPaymentMethodPatched = 'true';
+        }
+        row.dataset.nicepayPaymentMethodRow = 'admin-order';
+        if (installment && installmentText) {
+            installment.textContent = '';
+            installment.style.display = 'none';
+            installment.dataset.nicepayPaymentInstallmentHidden = 'true';
+        }
+        patched = true;
+    }
+
+    return patched;
+}
+
+function patchPaymentMethodBadge(root: Element, baseLabel: string, embeddedLabel: string): boolean {
+    const candidates = Array.from(root.querySelectorAll<HTMLElement>('span')).filter(
+        el => el.textContent?.trim() === baseLabel,
+    );
+
+    const badge = candidates.find(el => {
+        const className = typeof el.className === 'string' ? el.className : '';
+        return className.includes('rounded-full') || className.includes('font-medium');
+    });
+
+    if (!badge) return false;
+
+    badge.textContent = embeddedLabel;
+    badge.dataset.nicepayPaymentMethodPatched = 'true';
+    badge.dataset.nicepayPaymentMethodBadge = 'admin-order';
+    return true;
+}
+
+export function patchAdminPaymentMethodDisplay(
+    root: Element,
+    status: AdminTransactionStatus | null | undefined,
+): boolean {
+    const displayLabel = status?._pay_method_label;
+    const embeddedLabel = status?._embedded_pg_provider_label;
+    const baseLabel = status?._base_pay_method_label;
+
+    if (!displayLabel || !embeddedLabel) return false;
+
+    const labeled = patchLabeledPaymentMethod(root, displayLabel);
+    const badge = baseLabel ? patchPaymentMethodBadge(root, baseLabel, embeddedLabel) : false;
+
+    return labeled || badge;
+}
+
+async function tryInject(orderNumber: string): Promise<boolean> {
+    const root = document.getElementById('section_payment_info') ?? document.getElementById('payment_info_card');
+    if (!root) return false;
+
+    const status = await fetchAdminTransactionStatus(orderNumber);
+    if (!status) return true;
+
+    const patched = patchAdminPaymentMethodDisplay(root, status);
+    if (patched) {
+        console.info(`[${PLUGIN_ID}] payment method display patched on admin order detail`);
+    }
+
+    return true;
+}
+
+function startPolling(orderNumber: string): void {
+    let attempts = 0;
+    const id = setInterval(() => {
+        attempts++;
+        void tryInject(orderNumber).then(done => {
+            if (done || attempts >= 30) clearInterval(id);
+        });
+    }, 400);
+}
+
+function onRouteChange(): void {
+    const match = location.pathname.match(ADMIN_ORDER_SHOW_RE);
+    if (match) startPolling(match[1]);
+}
+
+export function installAdminOrderPaymentDisplayInjector(): void {
+    if (typeof window === 'undefined') return;
+    const w = window as unknown as Record<string, unknown>;
+    if (w[FLAG]) return;
+    w[FLAG] = true;
+
+    console.info(`[${PLUGIN_ID}] admin order payment display injector installed`);
+
+    const schedule = (delay = 1500) => setTimeout(onRouteChange, delay);
+
+    if (document.readyState === 'loading') {
+        document.addEventListener('DOMContentLoaded', () => schedule());
+    } else {
+        schedule();
+    }
+
+    const origPush = history.pushState.bind(history);
+    history.pushState = (...args: Parameters<typeof history.pushState>) => {
+        origPush(...args);
+        schedule(600);
+    };
+    window.addEventListener('popstate', () => schedule(500));
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/adminPaymentMethodBrandInjector.ts b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/adminPaymentMethodBrandInjector.ts
new file mode 100644
index 00000000..6c265ef0
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/adminPaymentMethodBrandInjector.ts
@@ -0,0 +1,287 @@
+const PLUGIN_ID = 'sirsoft-pay_nicepayments';
+const FLAG = '__nicepayAdminPaymentMethodBrandInjectorInstalled';
+const LISTENER_FLAG = '__nicepayAdminPaymentMethodBrandSyncListenerAttached';
+const ADMIN_SETTINGS_RE = /^\/admin\/ecommerce\/settings\/?$/;
+const MARK_SELECTOR = '[data-nicepay-admin-payment-brand-mark="true"]';
+const SYNC_RETRY_INTERVAL_MS = 200;
+const SYNC_RETRY_ATTEMPTS = 120;
+
+interface AdminPaymentBrandDefinition {
+    id: string;
+    labels: string[];
+    shortLabels: string[];
+    markLines: string[];
+    markClassName: string;
+}
+
+const ADMIN_PAYMENT_BRAND_DEFINITIONS: AdminPaymentBrandDefinition[] = [
+    {
+        id: 'nicepay_naverpay',
+        labels: ['네이버페이 (나이스페이먼츠)', '네이버페이로 결제 (나이스페이먼츠)', 'Naver Pay (NicePayments)', 'Pay with Naver Pay (NicePayments)'],
+        shortLabels: [],
+        markLines: ['N'],
+        markClassName: 'bg-green-500 text-white',
+    },
+    {
+        id: 'nicepay_kakaopay',
+        labels: ['카카오페이 (나이스페이먼츠)', '카카오페이로 결제 (나이스페이먼츠)', 'Kakao Pay (NicePayments)', 'Pay with Kakao Pay (NicePayments)'],
+        shortLabels: [],
+        markLines: ['K'],
+        markClassName: 'bg-yellow-400 text-gray-950',
+    },
+    {
+        id: 'nicepay_samsungpay',
+        labels: ['삼성페이 (나이스페이먼츠)', '삼성페이로 결제 (나이스페이먼츠)', 'Samsung Pay (NicePayments)', 'Pay with Samsung Pay (NicePayments)'],
+        shortLabels: [],
+        markLines: ['S'],
+        markClassName: 'bg-blue-600 text-white',
+    },
+    {
+        id: 'nicepay_applepay',
+        labels: ['애플페이 (나이스페이먼츠)', '애플페이로 결제 (나이스페이먼츠)', 'Apple Pay (NicePayments)', 'Pay with Apple Pay (NicePayments)'],
+        shortLabels: [],
+        markLines: ['A'],
+        markClassName: 'bg-gray-900 text-white',
+    },
+    {
+        id: 'nicepay_payco',
+        labels: ['PAYCO (나이스페이먼츠)', 'PAYCO로 결제 (나이스페이먼츠)', 'PAYCO (NicePayments)', 'Pay with PAYCO (NicePayments)'],
+        shortLabels: [],
+        markLines: ['P'],
+        markClassName: 'bg-red-500 text-white',
+    },
+    {
+        id: 'nicepay_skpay',
+        labels: ['11pay (나이스페이먼츠)', '11pay로 결제 (나이스페이먼츠)', '11pay (NicePayments)', 'Pay with 11pay (NicePayments)'],
+        shortLabels: [],
+        markLines: ['11'],
+        markClassName: 'bg-orange-500 text-white',
+    },
+    {
+        id: 'nicepay_ssgpay',
+        labels: ['SSG페이 (나이스페이먼츠)', 'SSG페이로 결제 (나이스페이먼츠)', 'SSG Pay (NicePayments)', 'Pay with SSG Pay (NicePayments)'],
+        shortLabels: [],
+        markLines: ['SSG'],
+        markClassName: 'bg-red-700 text-white',
+    },
+    {
+        id: 'nicepay_lpay',
+        labels: ['L.pay (나이스페이먼츠)', 'L.pay로 결제 (나이스페이먼츠)', 'L.pay (NicePayments)', 'Pay with L.pay (NicePayments)'],
+        shortLabels: [],
+        markLines: ['L'],
+        markClassName: 'bg-purple-600 text-white',
+    },
+];
+
+let observer: MutationObserver | null = null;
+let retryTimer: number | null = null;
+let syncQueued = false;
+
+function windowRecord(): Record<string, unknown> {
+    return window as unknown as Record<string, unknown>;
+}
+
+function isOrderSettingsPage(): boolean {
+    if (!ADMIN_SETTINGS_RE.test(window.location.pathname)) return false;
+
+    const tab = new URLSearchParams(window.location.search).get('tab');
+    return tab === null || tab === '' || tab === 'order_settings';
+}
+
+function classNameOf(element: Element): string {
+    return element instanceof HTMLElement ? element.className : '';
+}
+
+function comparableText(value: string | null | undefined): string {
+    return (value ?? '')
+        .replace(/\u200B/g, '')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+
+function isPaymentMethodItem(element: HTMLElement): boolean {
+    const className = classNameOf(element);
+
+    return className.includes('excel-card')
+        || (className.includes('flex-center') && className.includes('border') && className.includes('gap-4'));
+}
+
+function findTitleElement(item: HTMLElement): HTMLElement | null {
+    return item.querySelector<HTMLElement>('.font-medium');
+}
+
+function findDefinitionForItem(item: HTMLElement): AdminPaymentBrandDefinition | null {
+    const title = comparableText(findTitleElement(item)?.textContent);
+    const text = comparableText(item.textContent);
+
+    return ADMIN_PAYMENT_BRAND_DEFINITIONS.find((definition) => (
+        definition.shortLabels.some((label) => title === label)
+        || definition.labels.some((label) => text.includes(label))
+    )) ?? null;
+}
+
+function findPaymentMethodItems(root: ParentNode): HTMLElement[] {
+    return Array.from(root.querySelectorAll<HTMLElement>('div'))
+        .filter(isPaymentMethodItem);
+}
+
+function findPaymentIcon(item: HTMLElement): Element | null {
+    const icons = Array.from(item.querySelectorAll<Element>('svg, [data-icon], i'));
+
+    return icons.find((element) => (
+        !element.closest('[data-drag-handle]')
+        && !element.closest(MARK_SELECTOR)
+        && !element.closest('.row-stack, .excel-card-body, button, select, [role="switch"]')
+    )) ?? null;
+}
+
+function applyBrandMarkContent(mark: HTMLSpanElement, definition: AdminPaymentBrandDefinition): void {
+    mark.dataset.nicepayAdminPaymentBrandMark = 'true';
+    mark.dataset.nicepayAdminPaymentMethod = definition.id;
+    mark.setAttribute('aria-hidden', 'true');
+    mark.className = `inline-flex items-center justify-center rounded-lg font-bold ${definition.markClassName}`;
+    mark.style.width = '32px';
+    mark.style.height = '32px';
+    mark.style.flex = '0 0 32px';
+    mark.style.lineHeight = '1';
+    mark.style.fontSize = definition.markLines.join('').length > 2 ? '9px' : '12px';
+
+    const expectedText = definition.markLines.join('');
+    if (mark.textContent !== expectedText) {
+        mark.textContent = definition.markLines[0] ?? '';
+    }
+}
+
+function createBrandMark(definition: AdminPaymentBrandDefinition): HTMLSpanElement {
+    const mark = document.createElement('span');
+    applyBrandMarkContent(mark, definition);
+
+    return mark;
+}
+
+function syncBrandMark(item: HTMLElement, definition: AdminPaymentBrandDefinition): boolean {
+    const existing = item.querySelector<HTMLElement>(MARK_SELECTOR);
+    if (existing instanceof HTMLSpanElement) {
+        item.dataset.nicepayAdminPaymentMethod = definition.id;
+        applyBrandMarkContent(existing, definition);
+        return true;
+    }
+
+    const mark = createBrandMark(definition);
+    const icon = findPaymentIcon(item);
+    if (icon && icon.parentElement) {
+        item.dataset.nicepayAdminPaymentMethod = definition.id;
+        icon.replaceWith(mark);
+        return true;
+    }
+
+    const title = findTitleElement(item);
+    if (title && title.parentElement) {
+        item.dataset.nicepayAdminPaymentMethod = definition.id;
+        title.parentElement.insertBefore(mark, title);
+        return true;
+    }
+
+    return false;
+}
+
+export function syncRenderedAdminPaymentMethodBrands(root: ParentNode = document): boolean {
+    if (typeof window === 'undefined' || typeof document === 'undefined') return false;
+    if (!isOrderSettingsPage()) return false;
+
+    let matched = false;
+
+    findPaymentMethodItems(root).forEach((item) => {
+        const definition = findDefinitionForItem(item);
+        if (!definition) return;
+
+        if (syncBrandMark(item, definition)) {
+            matched = true;
+        }
+    });
+
+    return matched;
+}
+
+function queueSync(): void {
+    if (syncQueued) return;
+    syncQueued = true;
+
+    window.setTimeout(() => {
+        syncQueued = false;
+        syncRenderedAdminPaymentMethodBrands();
+    }, 0);
+}
+
+function stopRetries(): void {
+    if (retryTimer === null) return;
+
+    window.clearInterval(retryTimer);
+    retryTimer = null;
+}
+
+function startSync(): void {
+    if (!isOrderSettingsPage()) return;
+
+    stopRetries();
+    syncRenderedAdminPaymentMethodBrands();
+
+    let attempts = 0;
+    retryTimer = window.setInterval(() => {
+        attempts += 1;
+        syncRenderedAdminPaymentMethodBrands();
+
+        if (attempts >= SYNC_RETRY_ATTEMPTS) {
+            stopRetries();
+        }
+    }, SYNC_RETRY_INTERVAL_MS);
+
+    const body = document.body as HTMLElement & Record<string, unknown>;
+    if (body[LISTENER_FLAG]) return;
+    body[LISTENER_FLAG] = true;
+
+    observer = new MutationObserver(() => queueSync());
+    observer.observe(document.body, { childList: true, subtree: true, characterData: true });
+}
+
+function onRouteChange(): void {
+    if (isOrderSettingsPage()) {
+        startSync();
+        return;
+    }
+
+    stopRetries();
+}
+
+export function installAdminPaymentMethodBrandInjector(): void {
+    if (typeof window === 'undefined' || typeof document === 'undefined') return;
+    const w = windowRecord();
+    if (w[FLAG]) return;
+    w[FLAG] = true;
+
+    console.info(`[${PLUGIN_ID}] admin payment method brand sync installed`);
+
+    if (document.readyState === 'loading') {
+        document.addEventListener('DOMContentLoaded', () => startSync());
+    } else {
+        startSync();
+    }
+
+    const origPush = history.pushState.bind(history);
+    history.pushState = (...args: Parameters<typeof history.pushState>) => {
+        origPush(...args);
+        window.setTimeout(() => onRouteChange(), 200);
+    };
+    window.addEventListener('popstate', () => window.setTimeout(() => onRouteChange(), 200));
+}
+
+export function resetAdminPaymentMethodBrandInjectorForTests(): void {
+    observer?.disconnect();
+    observer = null;
+    stopRetries();
+    syncQueued = false;
+    delete windowRecord()[FLAG];
+    if (document.body) {
+        delete ((document.body as HTMLElement & Record<string, unknown>)[LISTENER_FLAG]);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/checkoutEasyPayInjector.ts b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/checkoutEasyPayInjector.ts
new file mode 100644
index 00000000..372219c3
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/checkoutEasyPayInjector.ts
@@ -0,0 +1,480 @@
+const PLUGIN_ID = 'sirsoft-pay_nicepayments';
+const FLAG = '__nicepayCheckoutEasyPayInjectorInstalled';
+const CHECKOUT_RE = /^\/shop\/checkout\/?$/;
+const LISTENER_FLAG = '__nicepayCheckoutEasyPaySyncListenerAttached';
+const SYNC_RETRY_INTERVAL_MS = 200;
+const SYNC_RETRY_ATTEMPTS = 120;
+const LEGACY_CONTAINER_ID = 'nicepay_checkout_payment_section';
+
+interface EasyPayCopy {
+    heading: string;
+    description: string;
+    title: string;
+}
+
+interface EasyPayDefinition {
+    id: string;
+    labels: string[];
+    ko: EasyPayCopy;
+    en: EasyPayCopy;
+    markText: string;
+    markClassName: string;
+}
+
+const EASY_PAY_DEFINITIONS: EasyPayDefinition[] = [
+    {
+        id: 'nicepay_naverpay',
+        labels: [
+            '네이버페이 (나이스페이먼츠)',
+            '네이버페이로 결제 (나이스페이먼츠)',
+            'Naver Pay (NicePayments)',
+            'Pay with Naver Pay (NicePayments)',
+        ],
+        ko: {
+            heading: '네이버페이 (나이스페이먼츠)',
+            description: '네이버페이로 결제 (나이스페이먼츠)',
+            title: '네이버페이로 결제 (나이스페이먼츠)',
+        },
+        en: {
+            heading: 'Naver Pay (NicePayments)',
+            description: 'Pay with Naver Pay (NicePayments)',
+            title: 'Pay with Naver Pay (NicePayments)',
+        },
+        markText: 'N',
+        markClassName: 'bg-green-500 text-white',
+    },
+    {
+        id: 'nicepay_kakaopay',
+        labels: [
+            '카카오페이 (나이스페이먼츠)',
+            '카카오페이로 결제 (나이스페이먼츠)',
+            'Kakao Pay (NicePayments)',
+            'Pay with Kakao Pay (NicePayments)',
+        ],
+        ko: {
+            heading: '카카오페이 (나이스페이먼츠)',
+            description: '카카오페이로 결제 (나이스페이먼츠)',
+            title: '카카오페이로 결제 (나이스페이먼츠)',
+        },
+        en: {
+            heading: 'Kakao Pay (NicePayments)',
+            description: 'Pay with Kakao Pay (NicePayments)',
+            title: 'Pay with Kakao Pay (NicePayments)',
+        },
+        markText: 'K',
+        markClassName: 'bg-yellow-400 text-gray-950',
+    },
+    {
+        id: 'nicepay_samsungpay',
+        labels: [
+            '삼성페이 (나이스페이먼츠)',
+            '삼성페이로 결제 (나이스페이먼츠)',
+            'Samsung Pay (NicePayments)',
+            'Pay with Samsung Pay (NicePayments)',
+        ],
+        ko: {
+            heading: '삼성페이 (나이스페이먼츠)',
+            description: '삼성페이로 결제 (나이스페이먼츠)',
+            title: '삼성페이로 결제 (나이스페이먼츠)',
+        },
+        en: {
+            heading: 'Samsung Pay (NicePayments)',
+            description: 'Pay with Samsung Pay (NicePayments)',
+            title: 'Pay with Samsung Pay (NicePayments)',
+        },
+        markText: 'S',
+        markClassName: 'bg-blue-600 text-white',
+    },
+    {
+        id: 'nicepay_applepay',
+        labels: [
+            '애플페이 (나이스페이먼츠)',
+            '애플페이로 결제 (나이스페이먼츠)',
+            'Apple Pay (NicePayments)',
+            'Pay with Apple Pay (NicePayments)',
+        ],
+        ko: {
+            heading: '애플페이 (나이스페이먼츠)',
+            description: '애플페이로 결제 (나이스페이먼츠)',
+            title: '애플페이로 결제 (나이스페이먼츠)',
+        },
+        en: {
+            heading: 'Apple Pay (NicePayments)',
+            description: 'Pay with Apple Pay (NicePayments)',
+            title: 'Pay with Apple Pay (NicePayments)',
+        },
+        markText: 'A',
+        markClassName: 'bg-gray-900 text-white',
+    },
+    {
+        id: 'nicepay_payco',
+        labels: [
+            'PAYCO (나이스페이먼츠)',
+            'PAYCO로 결제 (나이스페이먼츠)',
+            'PAYCO (NicePayments)',
+            'Pay with PAYCO (NicePayments)',
+        ],
+        ko: {
+            heading: 'PAYCO (나이스페이먼츠)',
+            description: 'PAYCO로 결제 (나이스페이먼츠)',
+            title: 'PAYCO로 결제 (나이스페이먼츠)',
+        },
+        en: {
+            heading: 'PAYCO (NicePayments)',
+            description: 'Pay with PAYCO (NicePayments)',
+            title: 'Pay with PAYCO (NicePayments)',
+        },
+        markText: 'P',
+        markClassName: 'bg-red-500 text-white',
+    },
+    {
+        id: 'nicepay_skpay',
+        labels: [
+            '11pay (나이스페이먼츠)',
+            '11pay로 결제 (나이스페이먼츠)',
+            '11pay (NicePayments)',
+            'Pay with 11pay (NicePayments)',
+        ],
+        ko: {
+            heading: '11pay (나이스페이먼츠)',
+            description: '11pay로 결제 (나이스페이먼츠)',
+            title: '11pay로 결제 (나이스페이먼츠)',
+        },
+        en: {
+            heading: '11pay (NicePayments)',
+            description: 'Pay with 11pay (NicePayments)',
+            title: 'Pay with 11pay (NicePayments)',
+        },
+        markText: '11',
+        markClassName: 'bg-orange-500 text-white',
+    },
+    {
+        id: 'nicepay_ssgpay',
+        labels: [
+            'SSG페이 (나이스페이먼츠)',
+            'SSG페이로 결제 (나이스페이먼츠)',
+            'SSG Pay (NicePayments)',
+            'Pay with SSG Pay (NicePayments)',
+        ],
+        ko: {
+            heading: 'SSG페이 (나이스페이먼츠)',
+            description: 'SSG페이로 결제 (나이스페이먼츠)',
+            title: 'SSG페이로 결제 (나이스페이먼츠)',
+        },
+        en: {
+            heading: 'SSG Pay (NicePayments)',
+            description: 'Pay with SSG Pay (NicePayments)',
+            title: 'Pay with SSG Pay (NicePayments)',
+        },
+        markText: 'SSG',
+        markClassName: 'bg-red-700 text-white',
+    },
+    {
+        id: 'nicepay_lpay',
+        labels: [
+            'L.pay (나이스페이먼츠)',
+            'L.pay로 결제 (나이스페이먼츠)',
+            'L.pay (NicePayments)',
+            'Pay with L.pay (NicePayments)',
+        ],
+        ko: {
+            heading: 'L.pay (나이스페이먼츠)',
+            description: 'L.pay로 결제 (나이스페이먼츠)',
+            title: 'L.pay로 결제 (나이스페이먼츠)',
+        },
+        en: {
+            heading: 'L.pay (NicePayments)',
+            description: 'Pay with L.pay (NicePayments)',
+            title: 'Pay with L.pay (NicePayments)',
+        },
+        markText: 'L',
+        markClassName: 'bg-purple-600 text-white',
+    },
+];
+
+let observer: MutationObserver | null = null;
+let retryTimer: number | null = null;
+let syncQueued = false;
+
+function windowRecord(): Record<string, unknown> {
+    return window as unknown as Record<string, unknown>;
+}
+
+function isCheckoutPage(): boolean {
+    return CHECKOUT_RE.test(window.location.pathname);
+}
+
+function normalizedText(value: string | null | undefined): string {
+    return (value ?? '').replace(/\s+/g, ' ').trim();
+}
+
+function comparableText(value: string | null | undefined): string {
+    return normalizedText(value).replace(/\u200B/g, '');
+}
+
+function isKoreanPage(): boolean {
+    const lang = document.documentElement.lang || navigator.language || '';
+
+    return lang.toLowerCase().startsWith('ko');
+}
+
+function copyFor(definition: EasyPayDefinition): EasyPayCopy {
+    return isKoreanPage() ? definition.ko : definition.en;
+}
+
+function displayText(value: string): string {
+    return value
+        .replaceAll('네이버페이', '네이\u200B버페이')
+        .replaceAll('카카오페이', '카카\u200B오페이')
+        .replaceAll('삼성페이', '삼성\u200B페이')
+        .replaceAll('Naver Pay', 'Naver\u200B Pay')
+        .replaceAll('Kakao Pay', 'Kakao\u200B Pay')
+        .replaceAll('Samsung Pay', 'Samsung\u200B Pay')
+        .replaceAll('L.pay', 'L.\u200Bpay');
+}
+
+function findDefinitionById(id: string | undefined): EasyPayDefinition | null {
+    return EASY_PAY_DEFINITIONS.find((definition) => definition.id === id) ?? null;
+}
+
+function findDefinitionForButton(button: HTMLButtonElement): EasyPayDefinition | null {
+    const markedDefinition = findDefinitionById(button.dataset.nicepayEasyPayMethod);
+    if (markedDefinition) return markedDefinition;
+
+    const text = comparableText(button.textContent);
+
+    return EASY_PAY_DEFINITIONS.find((definition) => (
+        definition.labels.some((label) => text.includes(label))
+    )) ?? null;
+}
+
+function findPaymentRow(button: HTMLButtonElement): HTMLElement | null {
+    return button.querySelector<HTMLElement>('.flex.items-center.gap-2, .flex.items-center.gap-3')
+        ?? button.querySelector<HTMLElement>('.flex.items-center');
+}
+
+function alignPaymentTextLeft(button: HTMLButtonElement, heading?: HTMLElement, description?: HTMLElement): void {
+    button.style.textAlign = 'left';
+
+    const row = findPaymentRow(button);
+    if (row) {
+        row.style.justifyContent = 'flex-start';
+        row.style.textAlign = 'left';
+        row.style.width = '100%';
+    }
+
+    const textContainer = heading?.parentElement ?? description?.parentElement;
+    if (textContainer instanceof HTMLElement) {
+        textContainer.style.textAlign = 'left';
+        textContainer.style.minWidth = '0';
+    }
+}
+
+function createMark(definition: EasyPayDefinition): HTMLSpanElement {
+    const mark = document.createElement('span');
+    mark.dataset.nicepayEasyPayMark = 'true';
+    mark.dataset.nicepayEasyPayMethod = definition.id;
+    mark.setAttribute('aria-hidden', 'true');
+    mark.className = `inline-flex items-center justify-center rounded-lg text-xs font-bold ${definition.markClassName}`;
+    mark.style.width = '32px';
+    mark.style.height = '32px';
+    mark.style.flex = '0 0 32px';
+    mark.textContent = definition.markText;
+
+    return mark;
+}
+
+function removeOtherPgArtifacts(button: HTMLButtonElement): void {
+    delete button.dataset.kginicisBrandPaymentButton;
+    delete button.dataset.kginicisBrandPaymentMethod;
+    delete button.dataset.kginicisNaverpayBrandButton;
+    delete button.dataset.nhnkcpEasyPayMethod;
+    delete button.dataset.nhnkcpEasyPayVisible;
+    delete button.dataset.nhnkcpEasyPayHidden;
+
+    button.querySelectorAll<HTMLElement>('[data-kginicis-brand-payment-mark="true"], [data-kginicis-naverpay-mark="true"], [data-nhnkcp-easy-pay-mark="true"]').forEach((element) => {
+        element.remove();
+    });
+}
+
+function findPaymentIcon(button: HTMLButtonElement): Element | null {
+    return button.querySelector('[data-nicepay-easy-pay-mark="true"]')
+        ?? button.querySelector('[data-kginicis-brand-payment-mark="true"], [data-kginicis-naverpay-mark="true"], [data-nhnkcp-easy-pay-mark="true"]')
+        ?? button.querySelector('svg')
+        ?? button.querySelector('i[class*="fa-"], i[role="img"], i');
+}
+
+function ensureMark(button: HTMLButtonElement, definition: EasyPayDefinition): void {
+    const existingMark = button.querySelector<HTMLElement>('[data-nicepay-easy-pay-mark="true"]');
+    if (existingMark) {
+        existingMark.dataset.nicepayEasyPayMethod = definition.id;
+        existingMark.className = `inline-flex items-center justify-center rounded-lg text-xs font-bold ${definition.markClassName}`;
+        existingMark.textContent = definition.markText;
+        return;
+    }
+
+    const mark = createMark(definition);
+    const icon = findPaymentIcon(button);
+    if (icon && icon.parentElement) {
+        icon.replaceWith(mark);
+        return;
+    }
+
+    const row = findPaymentRow(button);
+    row?.prepend(mark);
+}
+
+function updatePaymentText(button: HTMLButtonElement, definition: EasyPayDefinition): void {
+    const paragraphs = Array.from(button.querySelectorAll<HTMLParagraphElement>('p'));
+    const copy = copyFor(definition);
+    const headingText = displayText(copy.heading);
+    const descriptionText = displayText(copy.description);
+
+    const heading = paragraphs[0];
+    const description = paragraphs[1];
+
+    if (heading && heading.textContent !== headingText) {
+        heading.textContent = headingText;
+    }
+    if (heading) {
+        heading.setAttribute('aria-label', copy.heading);
+        heading.style.textAlign = 'left';
+        heading.style.whiteSpace = 'normal';
+        heading.style.wordBreak = 'keep-all';
+        heading.style.overflowWrap = 'anywhere';
+    }
+
+    if (description && description.textContent !== descriptionText) {
+        description.textContent = descriptionText;
+    }
+    if (description) {
+        description.style.textAlign = 'left';
+        description.style.fontSize = '12px';
+        description.style.lineHeight = '1rem';
+        description.style.whiteSpace = 'normal';
+        description.style.wordBreak = 'keep-all';
+        description.style.overflowWrap = 'anywhere';
+    }
+
+    alignPaymentTextLeft(button, heading, description);
+    button.title = copy.title;
+}
+
+function showButton(button: HTMLButtonElement, definition: EasyPayDefinition): void {
+    if (button.hidden) button.hidden = false;
+    if (button.disabled) button.disabled = false;
+    if (button.style.display === 'none') button.style.removeProperty('display');
+    button.removeAttribute('aria-hidden');
+    button.dataset.nicepayEasyPayMethod = definition.id;
+    button.dataset.nicepayEasyPayVisible = 'true';
+
+    removeOtherPgArtifacts(button);
+    ensureMark(button, definition);
+    updatePaymentText(button, definition);
+}
+
+function removeLegacyInjectedSection(): boolean {
+    const legacySection = document.getElementById(LEGACY_CONTAINER_ID);
+    if (!legacySection) return false;
+
+    legacySection.remove();
+
+    return true;
+}
+
+export async function syncRenderedCheckoutEasyPayMethods(
+    root: ParentNode = document,
+): Promise<boolean> {
+    if (typeof window === 'undefined' || typeof document === 'undefined') return false;
+    if (!isCheckoutPage()) return false;
+
+    let changed = removeLegacyInjectedSection();
+
+    root.querySelectorAll<HTMLButtonElement>('button').forEach((button) => {
+        const definition = findDefinitionForButton(button);
+        if (!definition) return;
+
+        showButton(button, definition);
+        changed = true;
+    });
+
+    return changed;
+}
+
+function queueSync(): void {
+    if (syncQueued) return;
+    syncQueued = true;
+
+    window.setTimeout(() => {
+        syncQueued = false;
+        void syncRenderedCheckoutEasyPayMethods();
+    }, 0);
+}
+
+function stopRetries(): void {
+    if (retryTimer === null) return;
+
+    window.clearInterval(retryTimer);
+    retryTimer = null;
+}
+
+function startSync(): void {
+    if (!isCheckoutPage()) return;
+
+    stopRetries();
+    void syncRenderedCheckoutEasyPayMethods();
+
+    let attempts = 0;
+    retryTimer = window.setInterval(() => {
+        attempts += 1;
+        void syncRenderedCheckoutEasyPayMethods();
+
+        if (attempts >= SYNC_RETRY_ATTEMPTS) {
+            stopRetries();
+        }
+    }, SYNC_RETRY_INTERVAL_MS);
+
+    const body = document.body as HTMLElement & Record<string, unknown>;
+    if (body[LISTENER_FLAG]) return;
+    body[LISTENER_FLAG] = true;
+
+    observer = new MutationObserver(() => queueSync());
+    observer.observe(document.body, { childList: true, subtree: true, characterData: true });
+}
+
+function onRouteChange(): void {
+    if (isCheckoutPage()) startSync();
+}
+
+export function installCheckoutEasyPayInjector(): void {
+    if (typeof window === 'undefined' || typeof document === 'undefined') return;
+    const w = windowRecord();
+    if (w[FLAG]) return;
+    w[FLAG] = true;
+
+    console.info(`[${PLUGIN_ID}] checkout easy pay method sync installed`);
+
+    if (document.readyState === 'loading') {
+        document.addEventListener('DOMContentLoaded', () => startSync());
+    } else {
+        startSync();
+    }
+
+    const origPush = history.pushState.bind(history);
+    history.pushState = (...args: Parameters<typeof history.pushState>) => {
+        origPush(...args);
+        window.setTimeout(() => onRouteChange(), 200);
+    };
+    window.addEventListener('popstate', () => window.setTimeout(() => onRouteChange(), 200));
+}
+
+export function resetCheckoutEasyPayInjectorForTests(): void {
+    observer?.disconnect();
+    observer = null;
+    stopRetries();
+    syncQueued = false;
+    delete windowRecord()[FLAG];
+    if (document.body) {
+        delete ((document.body as HTMLElement & Record<string, unknown>)[LISTENER_FLAG]);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/handlers/index.ts b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/handlers/index.ts
new file mode 100644
index 00000000..f9161f74
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/handlers/index.ts
@@ -0,0 +1,7 @@
+import { requestPaymentHandler } from './requestPayment';
+import { setPaymentMethodHandler } from './setPaymentMethod';
+
+export const handlerMap: Record<string, (...args: unknown[]) => unknown> = {
+    requestPayment: requestPaymentHandler,
+    setPaymentMethod: setPaymentMethodHandler,
+} as const;
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/handlers/requestPayment.ts b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/handlers/requestPayment.ts
new file mode 100644
index 00000000..801c08b6
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/handlers/requestPayment.ts
@@ -0,0 +1,411 @@
+import { reportPaymentWindowClosed } from '../paymentCloseReport';
+
+interface G7ApiResponse {
+    data?: unknown;
+}
+
+interface G7CoreApi {
+    get: (url: string) => Promise<G7ApiResponse>;
+    post?: (url: string, data?: Record<string, unknown>) => Promise<G7ApiResponse>;
+}
+
+interface G7CoreToast {
+    error: (message: string) => void;
+}
+
+interface G7CoreStateApi {
+    setLocal: (state: Record<string, unknown>) => void;
+}
+
+interface G7Core {
+    api: G7CoreApi;
+    toast?: G7CoreToast;
+    state?: G7CoreStateApi;
+}
+
+interface TemplateLocalState {
+    paymentMethod?: string;
+}
+
+interface TemplateApp {
+    globalState?: {
+        _local?: TemplateLocalState;
+    };
+}
+
+interface PgPaymentData {
+    order_number: string;
+    order_name: string;
+    amount: number;
+    currency?: string;
+    customer_name?: string;
+    customer_email?: string;
+    customer_phone?: string;
+    goods_cl?: string; // 휴대폰결제 상품 유형: '0'=디지털컨텐츠, '1'=실물
+}
+
+interface RequestPaymentParams {
+    pgPaymentData: PgPaymentData;
+    paymentMethod?: string;
+}
+
+interface ClientConfig {
+    mid: string;
+    sdk_url: string;
+    sign_data_url: string;
+    close_report_url?: string;
+    useEscrow?: boolean;
+}
+
+interface SignDataResponse {
+    ediDate: string;
+    signData: string;
+    mid: string;
+}
+
+interface PaymentAction {
+    params?: RequestPaymentParams;
+}
+
+declare global {
+    interface Window {
+        nicepaySubmit: () => void;
+        nicepayClose: (resultCode: string, resultMsg: string) => void;
+        goPay: (form: HTMLFormElement) => void;
+        G7Core: G7Core;
+        __templateApp?: TemplateApp;
+    }
+}
+
+function loadScript(src: string): Promise<void> {
+    return new Promise((resolve, reject) => {
+        if (document.querySelector(`script[src="${src}"]`)) {
+            resolve();
+            return;
+        }
+
+        const script = document.createElement('script');
+        script.src = src;
+        script.onload = () => resolve();
+        script.onerror = () => reject(new Error(`Failed to load script: ${src}`));
+        document.head.appendChild(script);
+    });
+}
+
+function createPaymentForm(action: string, fields: Record<string, string>): HTMLFormElement {
+    const form = document.createElement('form');
+    form.id = 'nicepayForm';
+    form.method = 'post';
+    form.action = action;
+    // CharSet 필드와 일치 — 모바일은 form.acceptCharset 으로 charset 결정
+    form.acceptCharset = 'utf-8';
+
+    for (const [name, value] of Object.entries(fields)) {
+        const input = document.createElement('input');
+        input.type = 'hidden';
+        input.name = name;
+        input.value = value;
+        form.appendChild(input);
+    }
+
+    document.body.appendChild(form);
+    return form;
+}
+
+const CALLBACK_PATH = '/plugins/sirsoft-pay_nicepayments/payment/callback';
+
+// 나이스페이 v3 모바일 결제창 endpoint — 폼을 직접 POST 하면 NicePay 모바일 페이지로 전체 redirect.
+// PC 와 달리 SDK 불필요. 결제 완료 후 ReturnURL 로 redirect.
+const NICEPAY_MOBILE_ENDPOINT = 'https://web.nicepay.co.kr/v3/v3Payment.jsp';
+
+/**
+ * 모바일 환경 판별.
+ *
+ * 판별 우선순위:
+ * 1. navigator.userAgentData.mobile — 브라우저가 직접 판단하는 표준 API (Chrome/Edge 90+)
+ * 2. UA 문자열 정규식 — iOS/Android/Windows Phone 및 주요 인앱 브라우저
+ * 3. maxTouchPoints 보조 판단 — iPadOS처럼 데스크탑 UA를 보내는 터치 기기 처리
+ *    (Windows/Mac 데스크탑 터치스크린 오탐 방지를 위해 플랫폼 확인 병행)
+ */
+function isMobileDevice(): boolean {
+    if (typeof navigator === 'undefined') return false;
+
+    // 1단계: User Agent Client Hints (가장 정확, 브라우저가 직접 판단)
+    const nav = navigator as Navigator & { userAgentData?: { mobile: boolean } };
+    if (nav.userAgentData?.mobile !== undefined) {
+        return nav.userAgentData.mobile;
+    }
+
+    // 2단계: UA 문자열 파싱
+    const ua = (navigator.userAgent || '').toLowerCase();
+    const mobileUA = /android|iphone|ipod|windows phone|iemobile|blackberry|opera mini|mobile safari/;
+    if (mobileUA.test(ua)) return true;
+
+    // 3단계: iPadOS 등 데스크탑 UA를 보내는 터치 기기 판별
+    // maxTouchPoints > 1 이면 실제 멀티터치 기기 (터치스크린 노트북은 보통 1)
+    // Windows/Mac 플랫폼이면 데스크탑으로 간주하여 오탐 방지
+    const touchPoints = (navigator as Navigator & { maxTouchPoints?: number }).maxTouchPoints ?? 0;
+    if (touchPoints > 1 && !ua.includes('windows') && !ua.includes('macintosh')) {
+        return true;
+    }
+
+    return false;
+}
+
+/**
+ * 나이스페이먼츠 결제창 호출 핸들러 (나이스페이 구형 API, goPay 방식)
+ *
+ * 체크아웃 레이아웃에서 주문 생성 API 성공 후 호출됩니다:
+ *   handler: "sirsoft-pay_nicepayments.requestPayment"
+ *   params: { pgPaymentData: response.data.pg_payment_data }
+ *
+ * 호출 순서:
+ *   1. Client Config API 호출 → MID, SDK URL, SignData URL 획득
+ *   2. 환경 분기: PC 면 SDK 동적 로드 / 모바일 은 SDK 생략
+ *   3. 서버에서 EdiDate + SignData 생성
+ *   4. 결제 폼 생성:
+ *      - PC: 폼 action=ReturnURL → goPay(form) 으로 iframe 팝업
+ *      - 모바일: 폼 action=https://web.nicepay.co.kr/v3/v3Payment.jsp → 직접 submit (전체 페이지 redirect)
+ *   5. 결제 완료 시 나이스페이먼츠가 ReturnURL(POST)로 인증값 전달
+ *
+ * NicePay 의 PC SDK 는 모바일 자동 감지를 하지 않으므로 UA 기반 분기가 필수.
+ * 잘못 분기하면 모바일에서도 PC 팝업이 떠 사용성이 매우 나빠짐.
+ */
+export async function requestPaymentHandler(action: PaymentAction, _context?: unknown): Promise<void> {
+    const { pgPaymentData, paymentMethod: paramPaymentMethod } = action.params ?? {};
+
+    const localState = window.__templateApp?.globalState?._local;
+    const paymentMethod = paramPaymentMethod ?? localState?.paymentMethod ?? 'card';
+
+    if (!pgPaymentData) {
+        console.error('[sirsoft-pay_nicepayments] pgPaymentData is required');
+        return;
+    }
+
+    const G7Core = window.G7Core;
+
+    try {
+        // 1. Client Config 가져오기
+        const configJson = await G7Core.api.get('/modules/sirsoft-ecommerce/payments/client-config/nicepayments');
+
+        if (!configJson.data) {
+            console.error('[sirsoft-pay_nicepayments] Failed to fetch client config', configJson);
+            return;
+        }
+
+        const config = configJson.data as ClientConfig;
+        const isMobile = isMobileDevice();
+
+        // 2. PC 인 경우에만 SDK 로드 (모바일 은 직접 form submit 으로 NicePay 모바일 페이지로 이동)
+        if (!isMobile) {
+            await loadScript(config.sdk_url);
+
+            if (typeof window.goPay !== 'function') {
+                G7Core?.toast?.error?.('나이스페이먼츠 SDK를 불러올 수 없습니다. 잠시 후 다시 시도해주세요.');
+                G7Core?.state?.setLocal?.({ isSubmittingOrder: false, paymentMethod });
+                return;
+            }
+        }
+
+        // 3. 서버에서 EdiDate + SignData 생성
+        //    공개 엔드포인트지만 서버에서 주문번호, 결제 전 상태, 금액, 구매자 컨텍스트를 검증한다.
+        const signDataUrl = window.location.origin + config.sign_data_url;
+        const authToken = (typeof localStorage !== 'undefined') ? localStorage.getItem('auth_token') : null;
+        const signDataHeaders: Record<string, string> = {
+            'Content-Type': 'application/json',
+            'X-Requested-With': 'XMLHttpRequest',
+            'Accept': 'application/json',
+        };
+        if (authToken) {
+            signDataHeaders['Authorization'] = `Bearer ${authToken}`;
+        }
+        const signDataRes = await fetch(signDataUrl, {
+            method: 'POST',
+            credentials: 'include',
+            headers: signDataHeaders,
+            body: JSON.stringify({
+                amt: pgPaymentData.amount,
+                moid: pgPaymentData.order_number,
+                buyer_email: pgPaymentData.customer_email ?? '',
+                buyer_phone: pgPaymentData.customer_phone ?? '',
+            }),
+        });
+
+        if (!signDataRes.ok) {
+            throw new Error('SignData 생성에 실패했습니다.');
+        }
+
+        const signData: SignDataResponse = await signDataRes.json();
+        const callbackUrl = window.location.origin + CALLBACK_PATH;
+
+        // 4. 결제 폼 생성
+        // 간편결제는 PayMethod='CARD' + DirectShowOpt='CARD' + 방식별 directive 필드 조합.
+        // PayMethod에 'KAKAOPAY' 등을 직접 넣으면 [W004] 발생 — gnu5 orderform.js 동일 방식.
+        const isEasyPay = typeof paymentMethod === 'string' && paymentMethod.startsWith('nicepay_');
+
+        const payMethodMap: Record<string, string> = {
+            card: 'CARD',
+            vbank: 'VBANK',
+            bank: 'BANK',
+            phone: 'CELLPHONE',
+        };
+        const payMethod = isEasyPay ? 'CARD' : (payMethodMap[paymentMethod ?? 'card'] ?? 'CARD');
+
+        const formFields: Record<string, string> = {
+            PayMethod: payMethod,
+            GoodsName: pgPaymentData.order_name,
+            Amt: String(pgPaymentData.amount),
+            MID: signData.mid,
+            Moid: pgPaymentData.order_number,
+            BuyerName: pgPaymentData.customer_name ?? '',
+            BuyerEmail: pgPaymentData.customer_email ?? '',
+            BuyerTel: pgPaymentData.customer_phone ?? '',
+            ReturnURL: callbackUrl,
+            EdiDate: signData.ediDate,
+            SignData: signData.signData,
+            CharSet: 'utf-8',
+            GoodsCl: '1',
+            DirectShowOpt: '',
+            DirectEasyPay: '',
+            NicepayReserved: '',
+            EasyPayMethod: '',
+            MallReserved: '',
+            MallReserved1: '',
+        };
+
+        // 휴대폰결제: 상품 유형 덮어쓰기 (0:디지털컨텐츠, 1:실물)
+        if (payMethod === 'CELLPHONE') {
+            formFields.GoodsCl = pgPaymentData.goods_cl ?? '1';
+        }
+
+        // TransType: 에스크로 활성 + 일반결제 → '1', 그 외(간편결제 포함) → '0'
+        const useEscrow = config.useEscrow && !isEasyPay;
+        formFields.TransType = useEscrow ? '1' : '0';
+
+        // 간편결제 directive 필드 설정 — gnu5 orderform.js switch(settle_method==='간편결제') 동일
+        if (isEasyPay) {
+            formFields.DirectShowOpt = 'CARD';
+            formFields.MallReserved = `nicepay_easy_pay_method=${encodeURIComponent(paymentMethod)}`;
+            formFields.MallReserved1 = paymentMethod;
+            switch (paymentMethod) {
+                case 'nicepay_naverpay':
+                    formFields.DirectEasyPay = 'E020';
+                    formFields.EasyPayMethod = 'E020=CARD';
+                    break;
+                case 'nicepay_kakaopay':
+                    formFields.NicepayReserved = 'DirectKakao=Y';
+                    break;
+                case 'nicepay_samsungpay':
+                    formFields.DirectEasyPay = 'E021';
+                    break;
+                case 'nicepay_applepay':
+                    formFields.DirectEasyPay = 'E025';
+                    break;
+                case 'nicepay_payco':
+                    formFields.NicepayReserved = 'DirectPayco=Y';
+                    break;
+                case 'nicepay_skpay':
+                    formFields.NicepayReserved = 'DirectPay11=Y';
+                    break;
+                case 'nicepay_ssgpay':
+                    formFields.DirectEasyPay = 'E007';
+                    break;
+                case 'nicepay_lpay':
+                    formFields.DirectEasyPay = 'E018';
+                    break;
+            }
+        }
+
+        // 4-2. 과세/비과세 금액 조회 (optional — 실패해도 결제 진행)
+        try {
+            const orderRes = await G7Core.api.get(`/modules/sirsoft-ecommerce/user/orders/${pgPaymentData.order_number}`);
+            const od = orderRes?.data as Record<string, unknown> | null | undefined;
+            if (od) {
+                const taxAmt = Number(od['total_tax_amount'] ?? 0);
+                const vatAmt = Number(od['total_vat_amount'] ?? 0);
+                const taxFreeAmt = Number(od['total_tax_free_amount'] ?? 0);
+                if (taxAmt > 0 || vatAmt > 0 || taxFreeAmt > 0) {
+                    formFields.TaxAmt = String(taxAmt);
+                    formFields.VatAmt = String(vatAmt);
+                    formFields.TaxFreeAmt = String(taxFreeAmt);
+                }
+            }
+        } catch {
+            // 과세 필드는 선택 사항 — 조회 실패 시 미포함 상태로 진행
+        }
+
+        const form = createPaymentForm(callbackUrl, formFields);
+
+        if (isMobile) {
+            // 모바일 결제창 호출:
+            //   - form.action = NicePay 모바일 endpoint
+            //   - acceptCharset = 'euc-kr' : NicePay v3 mobile 은 EUC-KR 로 form 데이터를 받음
+            //     (NicePay 공식 샘플과 동일). 브라우저가 자동으로 UTF-8 → EUC-KR 변환.
+            //   - CharSet 입력값도 'euc-kr' 로 일치 — NicePay 가 같은 인코딩으로 디코딩하도록.
+            //     (utf-8 그대로 두면 GoodsName/BuyerName 한글이 mojibake "遺?瑜?" 로 깨짐)
+            //   결제 완료 후 NicePay 가 ReturnURL 로 redirect.
+            form.action = NICEPAY_MOBILE_ENDPOINT;
+            form.acceptCharset = 'euc-kr';
+            const charsetInput = form.querySelector('input[name="CharSet"]') as HTMLInputElement | null;
+            if (charsetInput) {
+                charsetInput.value = 'euc-kr';
+            }
+            form.submit();
+            // 페이지 자체가 redirect 되므로 정리 로직 불필요. submit 후 이 함수의 후속 코드는 실행되지 않음.
+            return;
+        }
+
+        // 이하 PC 전용 — iframe 팝업 + nicepaySubmit / nicepayClose 콜백 처리
+
+        // 5. 나이스페이 전역 콜백 정의
+        window.nicepaySubmit = () => {
+            form.submit();
+        };
+
+        let paymentClosed = false;
+
+        // goPay() 전 body 자식 스냅샷 — SDK가 추가하는 오버레이/iframe 식별용
+        const bodySnapshot = new Set(document.body.children);
+
+        const closePayment = (_resultCode: string, resultMsg: string) => {
+            if (paymentClosed) return;
+            paymentClosed = true;
+            const closeReason = [_resultCode, resultMsg].filter(Boolean).join(': ') || 'nicepay-window-closed';
+            void reportPaymentWindowClosed({
+                closeReportUrl: config.close_report_url,
+                oid: pgPaymentData.order_number,
+                price: Number(pgPaymentData.amount),
+                buyer_email: pgPaymentData.customer_email ?? '',
+                buyer_phone: pgPaymentData.customer_phone ?? '',
+                payment_method: paymentMethod,
+            }, closeReason);
+            window.removeEventListener('popstate', handlePopState);
+            // SDK가 body에 추가한 오버레이/iframe 등 제거
+            Array.from(document.body.children).forEach(el => {
+                if (!bodySnapshot.has(el)) el.remove();
+            });
+            if (form.parentNode) form.parentNode.removeChild(form);
+            (window as unknown as Record<string, unknown>)['__sirsoftNicepayPaymentInProgress'] = false;
+            G7Core?.state?.setLocal?.({ isSubmittingOrder: false, paymentMethod });
+            if (resultMsg) G7Core?.toast?.error?.(resultMsg);
+        };
+
+        window.nicepayClose = closePayment;
+
+        // 뒤로가기(popstate) 감지 → 결제창 정리
+        const handlePopState = () => closePayment('', '');
+
+        // 결제창 열기 전 history state 추가 → 뒤로가기 시 popstate 발생
+        window.history.pushState({ nicepayOpen: true }, '');
+        window.addEventListener('popstate', handlePopState);
+
+        // 6. PC 결제창 호출 (iframe 팝업)
+        window.goPay(form);
+
+    } catch (error: unknown) {
+        console.error('[sirsoft-pay_nicepayments] requestPayment error', error);
+        (window as unknown as Record<string, unknown>)['__sirsoftNicepayPaymentInProgress'] = false;
+        G7Core?.state?.setLocal?.({ isSubmittingOrder: false, paymentMethod });
+        G7Core?.toast?.error?.('결제 중 오류가 발생했습니다. 잠시 후 다시 시도해주세요.');
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/handlers/setPaymentMethod.ts b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/handlers/setPaymentMethod.ts
new file mode 100644
index 00000000..c264133d
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/handlers/setPaymentMethod.ts
@@ -0,0 +1,83 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+
+const METHOD_TO_TEXT: Record<string, string> = {
+    nicepay_naverpay:   '네이버페이',
+    nicepay_kakaopay:   '카카오페이',
+    nicepay_samsungpay: '삼성페이',
+    nicepay_applepay:   '애플페이',
+    nicepay_payco:      'PAYCO',
+    nicepay_skpay:      '11pay',
+    nicepay_ssgpay:     'SSG페이',
+    nicepay_lpay:       'L.pay',
+};
+
+// 흰색 내부 ring + 어두운 외부 ring으로 어떤 버튼 배경색에도 선택 상태가 확실히 보임
+const SELECTED_SHADOW = '0 0 0 2px #ffffff, 0 0 0 5px rgba(0,0,0,0.55)';
+
+function getEasyPayButtonContainer(): Element | null {
+    const section = document.getElementById('nicepay_checkout_payment_section');
+    if (!section) return null;
+    const paras = section.querySelectorAll('p');
+    for (const p of paras) {
+        if (p.textContent?.includes('간편결제')) {
+            return p.nextElementSibling;
+        }
+    }
+    return null;
+}
+
+function clearEasyPayButtonStyles(): void {
+    const container = getEasyPayButtonContainer();
+    if (!container) return;
+    container.querySelectorAll<HTMLButtonElement>('button').forEach(btn => {
+        btn.style.boxShadow = '';
+        btn.style.outline = '';
+    });
+}
+
+function updateEasyPayButtonStyles(selectedMethod: string): void {
+    const container = getEasyPayButtonContainer();
+    if (!container) return;
+
+    const selectedText = METHOD_TO_TEXT[selectedMethod];
+    container.querySelectorAll<HTMLButtonElement>('button').forEach(btn => {
+        if (btn.textContent?.trim() === selectedText) {
+            btn.style.boxShadow = SELECTED_SHADOW;
+            btn.style.outline = 'none';
+        } else {
+            btn.style.boxShadow = '';
+            btn.style.outline = '';
+        }
+    });
+}
+
+export function setPaymentMethodHandler(action: any): void {
+    const paymentMethod = action.params?.paymentMethod;
+    if (!paymentMethod) return;
+
+    const isEasyPay = typeof paymentMethod === 'string' && paymentMethod.indexOf('nicepay_') === 0;
+    (window as any).G7Core?.state?.setLocal?.({
+        paymentMethod,
+        serverPaymentMethod: isEasyPay ? 'card' : paymentMethod,
+    });
+
+    if (isEasyPay) {
+        updateEasyPayButtonStyles(paymentMethod);
+    } else {
+        clearEasyPayButtonStyles();
+    }
+}
+
+// 코어 결제 버튼(신용카드 등) 클릭 시에도 간편결제 선택 표시 해제
+export function initEasyPayWatcher(): void {
+    const templateApp = (window as any).__templateApp;
+    if (typeof templateApp?.onGlobalStateChange !== 'function') return;
+
+    templateApp.onGlobalStateChange((state: any) => {
+        const paymentMethod = state?._local?.paymentMethod;
+        if (typeof paymentMethod !== 'string') return;
+        if (!paymentMethod.startsWith('nicepay_')) {
+            clearEasyPayButtonStyles();
+        }
+    });
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/index.ts b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/index.ts
new file mode 100644
index 00000000..6f2075e0
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/index.ts
@@ -0,0 +1,101 @@
+import { handlerMap } from './handlers';
+import { initEasyPayWatcher } from './handlers/setPaymentMethod';
+import { installOrderResponseInterceptor } from './orderResponseInterceptor';
+import { installCheckoutEasyPayInjector } from './checkoutEasyPayInjector';
+import { installOrderCompleteReceiptInjector } from './orderCompleteReceiptInjector';
+import { installMypageOrderShowInjector } from './mypageOrderShowInjector';
+import { installAdminPaymentMethodBrandInjector } from './adminPaymentMethodBrandInjector';
+import { installAdminOrderPaymentDisplayInjector } from './adminOrderPaymentDisplayInjector';
+
+const PLUGIN_IDENTIFIER = 'sirsoft-pay_nicepayments';
+
+const logger = {
+    info: (...args: unknown[]) => console.info(`[${PLUGIN_IDENTIFIER}]`, ...args),
+    warn: (...args: unknown[]) => console.warn(`[${PLUGIN_IDENTIFIER}]`, ...args),
+    error: (...args: unknown[]) => console.error(`[${PLUGIN_IDENTIFIER}]`, ...args),
+};
+
+function registerHandlers(): number {
+    const g7Core = (window as Record<string, unknown>).G7Core as Record<string, unknown> | undefined;
+
+    if (!g7Core) {
+        return 0;
+    }
+
+    const getDispatcher = g7Core.getActionDispatcher as (() => Record<string, unknown>) | undefined;
+
+    if (typeof getDispatcher !== 'function') {
+        return 0;
+    }
+
+    const dispatcher = getDispatcher() as Record<string, unknown> | undefined;
+
+    if (!dispatcher || typeof dispatcher.registerHandler !== 'function') {
+        return 0;
+    }
+
+    let count = 0;
+    for (const [name, handler] of Object.entries(handlerMap)) {
+        const fullName = `${PLUGIN_IDENTIFIER}.${name}`;
+        dispatcher.registerHandler(fullName, handler, {
+            category: 'plugin',
+            source: PLUGIN_IDENTIFIER,
+        });
+        count++;
+    }
+
+    return count;
+}
+
+function initPlugin(): void {
+    // fetch 인터셉터는 G7Core 초기화와 무관하게 즉시 설치
+    installOrderResponseInterceptor();
+    installCheckoutEasyPayInjector();
+    installOrderCompleteReceiptInjector();
+    installMypageOrderShowInjector();
+    installAdminPaymentMethodBrandInjector();
+    installAdminOrderPaymentDisplayInjector();
+
+    const doInit = () => {
+        const count = registerHandlers();
+
+        if (count > 0) {
+            logger.info(`${count} handler(s) registered`);
+            initEasyPayWatcher();
+            return;
+        }
+
+        let retries = 0;
+        const maxRetries = 50;
+        const interval = setInterval(() => {
+            retries++;
+            const result = registerHandlers();
+
+            if (result > 0) {
+                clearInterval(interval);
+                logger.info(`${result} handler(s) registered (after ${retries} retries)`);
+                initEasyPayWatcher();
+                return;
+            }
+
+            if (retries >= maxRetries) {
+                clearInterval(interval);
+                logger.warn('ActionDispatcher not available after timeout');
+            }
+        }, 100);
+    };
+
+    if (document.readyState === 'loading') {
+        document.addEventListener('DOMContentLoaded', doInit);
+    } else {
+        doInit();
+    }
+}
+
+initPlugin();
+
+(window as Record<string, unknown>).__SirsoftNicepayments = {
+    identifier: PLUGIN_IDENTIFIER,
+    handlers: Object.keys(handlerMap),
+    initPlugin,
+};
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/mypageOrderShowInjector.ts b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/mypageOrderShowInjector.ts
new file mode 100644
index 00000000..9d161951
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/mypageOrderShowInjector.ts
@@ -0,0 +1,278 @@
+const PLUGIN_ID = 'sirsoft-pay_nicepayments';
+const FLAG = '__nicepayOrderShowInjectorInstalled';
+const ROW_ID = 'nicepay-mp-receipt-row';
+const VBANK_BLOCK_ID = 'nicepay-mp-vbank-info';
+
+const ORDER_SHOW_RE = /^\/mypage\/orders\/([^/]+)$/;
+
+interface Payment {
+    pg_provider?: string;
+    payment_method?: string;
+    transaction_id?: string | null;
+    paid_at?: string | null;
+    vbank_name?: string | null;
+    vbank_number?: string | null;
+    vbank_holder?: string | null;
+    vbank_due_at?: string | null;
+    [key: string]: unknown;
+}
+
+interface OrderData {
+    order_number?: string;
+    total_amount_formatted?: string;
+    payment?: Payment;
+}
+
+interface ReceiptInfo {
+    receipt_url?: string | null;
+    payment_method_display_label?: string | null;
+}
+
+function getOrderFromState(orderNumber: string): OrderData | null {
+    try {
+        const g7 = (window as Record<string, unknown>).G7Core as Record<string, unknown> | undefined;
+        const getState = g7?.getState as (() => Record<string, unknown>) | undefined;
+        const ctx = getState?.()?.currentDataContext as Record<string, unknown> | undefined;
+        const order = ctx?.order as { data?: OrderData } | undefined;
+        const data = order?.data;
+        if (!data || data.order_number !== orderNumber) return null;
+        return data;
+    } catch {
+        return null;
+    }
+}
+
+function getToken(): string | null {
+    return localStorage.getItem('auth_token');
+}
+
+async function fetchReceiptInfo(orderNumber: string): Promise<ReceiptInfo | null> {
+    const token = getToken();
+    if (!token) return null;
+    try {
+        const res = await fetch(`/api/plugins/${PLUGIN_ID}/user/orders/${orderNumber}/receipt`, {
+            headers: { Authorization: `Bearer ${token}`, Accept: 'application/json' },
+        });
+        if (!res.ok) return null;
+        return (await res.json()) as ReceiptInfo;
+    } catch {
+        return null;
+    }
+}
+
+function patchPaymentMethodDisplay(container: Element, displayLabel: string | null | undefined): boolean {
+    if (!displayLabel) return false;
+
+    const rows = Array.from(container.querySelectorAll<HTMLElement>('div'));
+    for (const row of rows) {
+        const spans = Array.from(row.children).filter(
+            (child): child is HTMLElement => child instanceof HTMLElement && child.tagName === 'SPAN',
+        );
+        if (spans.length < 2) continue;
+
+        const label = spans[0].textContent?.trim();
+        if (label !== '결제 방법' && label !== '결제수단' && label !== 'Payment Method') continue;
+
+        const value = spans[spans.length - 1];
+        if (value.textContent?.trim() !== displayLabel) {
+            value.textContent = displayLabel;
+            value.dataset.nicepayPaymentMethodPatched = 'true';
+        }
+        row.dataset.nicepayPaymentMethodRow = 'true';
+        return true;
+    }
+
+    return false;
+}
+
+function findPaymentContainer(): Element | null {
+    const panel = document.getElementById('order_payment_info_panel');
+    if (panel) {
+        return Array.from(panel.children).find(el => el.className?.includes('space-y')) ?? panel;
+    }
+
+    const h3 = Array.from(document.querySelectorAll<HTMLElement>('h3')).find(
+        el => el.textContent?.includes('결제 정보'),
+    );
+    if (!h3) return null;
+
+    const panelDiv = h3.parentElement?.parentElement;
+    if (!panelDiv) return null;
+
+    return Array.from(panelDiv.children).find(el => el.className?.includes('space-y')) ?? panelDiv;
+}
+
+function buildReceiptRow(orderNumber: string): HTMLElement {
+    const row = document.createElement('div');
+    row.id = ROW_ID;
+    row.className = 'flex items-center justify-between';
+
+    const label = document.createElement('span');
+    label.className = 'text-gray-500 dark:text-gray-400 text-sm';
+    label.textContent = '영수증';
+
+    const btn = document.createElement('button');
+    btn.type = 'button';
+    btn.className =
+        'inline-flex items-center gap-1 text-sm text-blue-600 dark:text-blue-400 hover:underline disabled:opacity-50';
+    btn.textContent = '영수증 조회';
+
+    btn.addEventListener('click', async () => {
+        btn.disabled = true;
+        btn.textContent = '로딩 중...';
+        const data = await fetchReceiptInfo(orderNumber);
+        btn.disabled = false;
+        btn.textContent = '영수증 조회';
+        const url = data?.receipt_url ?? null;
+        if (url) {
+            window.open(url, 'nicepay_receipt', 'width=800,height=600,scrollbars=yes,resizable=yes');
+        }
+    });
+
+    row.appendChild(label);
+    row.appendChild(btn);
+    return row;
+}
+
+function formatVbankDueAt(raw: string | null | undefined): string {
+    if (!raw) return '';
+    try {
+        const d = new Date(raw);
+        if (Number.isNaN(d.getTime())) return raw;
+        const pad = (n: number) => String(n).padStart(2, '0');
+        return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`;
+    } catch {
+        return raw;
+    }
+}
+
+function buildVbankRow(label: string, value: string, valueClass = 'font-medium text-gray-900 dark:text-white'): HTMLElement {
+    const row = document.createElement('div');
+    row.className = 'flex justify-between text-sm';
+    const l = document.createElement('span');
+    l.className = 'text-gray-600 dark:text-gray-400';
+    l.textContent = label;
+    const v = document.createElement('span');
+    v.className = valueClass;
+    v.textContent = value;
+    row.appendChild(l);
+    row.appendChild(v);
+    return row;
+}
+
+function buildVbankBlock(orderData: OrderData): HTMLElement {
+    const p = orderData.payment ?? {};
+    const wrap = document.createElement('div');
+    wrap.id = VBANK_BLOCK_ID;
+    wrap.className = 'pt-4 mt-2 border-t border-gray-200 dark:border-gray-700';
+
+    const inner = document.createElement('div');
+    inner.className = 'bg-blue-50 dark:bg-blue-900/30 border border-blue-200 dark:border-blue-700 rounded-lg p-4';
+
+    const title = document.createElement('h3');
+    title.className = 'text-sm font-semibold text-blue-800 dark:text-blue-300 mb-3';
+    title.textContent = '가상계좌 입금 안내';
+
+    const rows = document.createElement('div');
+    rows.className = 'space-y-2';
+    rows.appendChild(buildVbankRow('은행', p.vbank_name ?? ''));
+    rows.appendChild(buildVbankRow('계좌번호', p.vbank_number ?? '', 'font-medium font-mono text-gray-900 dark:text-white'));
+    rows.appendChild(buildVbankRow('예금주', p.vbank_holder ?? ''));
+    rows.appendChild(buildVbankRow('입금 금액', orderData.total_amount_formatted ?? '', 'font-bold text-blue-600 dark:text-blue-400'));
+
+    const dueRaw = p.vbank_due_at;
+    if (dueRaw) {
+        const dueRow = document.createElement('div');
+        dueRow.className = 'flex justify-between text-sm pt-2 border-t border-blue-200 dark:border-blue-700 mt-2';
+        const dueLabel = document.createElement('span');
+        dueLabel.className = 'text-gray-600 dark:text-gray-400';
+        dueLabel.textContent = '입금 기한';
+        const dueValue = document.createElement('span');
+        dueValue.className = 'font-medium text-red-600 dark:text-red-400';
+        dueValue.textContent = formatVbankDueAt(dueRaw);
+        dueRow.appendChild(dueLabel);
+        dueRow.appendChild(dueValue);
+        rows.appendChild(dueRow);
+    }
+
+    inner.appendChild(title);
+    inner.appendChild(rows);
+
+    if (!p.paid_at) {
+        const notice = document.createElement('p');
+        notice.className = 'text-xs text-blue-700 dark:text-blue-300 mt-3';
+        notice.textContent = '입금 기한 내에 입금이 완료되지 않으면 주문이 자동 취소됩니다.';
+        inner.appendChild(notice);
+    }
+
+    wrap.appendChild(inner);
+    return wrap;
+}
+
+async function tryInject(orderNumber: string): Promise<boolean> {
+    const orderData = getOrderFromState(orderNumber);
+    if (!orderData) return false;
+
+    const { payment } = orderData;
+    if (!payment || payment.pg_provider !== 'nicepayments') return true;
+
+    const container = findPaymentContainer();
+    if (!container) return false;
+    const receiptInfo = await fetchReceiptInfo(orderNumber);
+    patchPaymentMethodDisplay(container, receiptInfo?.payment_method_display_label);
+
+    // 가상계좌 입금 안내 — 결제수단이 vbank 이고 가상계좌 번호 발급된 경우 표시 (paid_at 무관: 입금 전후 모두 표시).
+    if (payment.payment_method === 'vbank' && payment.vbank_number && !document.getElementById(VBANK_BLOCK_ID)) {
+        container.appendChild(buildVbankBlock(orderData));
+        console.info(`[${PLUGIN_ID}] vbank info injected on mypage order show`);
+    }
+
+    if (!payment.transaction_id) return true;
+    // 영수증 버튼은 결제완료(paid_at 채워짐) 시점에만 표시 — 가상계좌 입금대기 차단
+    if (!payment.paid_at) return true;
+
+    if (document.getElementById(ROW_ID)) return true;
+
+    container.appendChild(buildReceiptRow(orderNumber));
+    console.info(`[${PLUGIN_ID}] receipt button injected on mypage order show`);
+    return true;
+}
+
+function startPolling(orderNumber: string): void {
+    let attempts = 0;
+    const id = setInterval(() => {
+        attempts++;
+        void tryInject(orderNumber).then(done => {
+            if (done || attempts >= 30) clearInterval(id);
+        });
+    }, 400);
+}
+
+function onRouteChange(): void {
+    const match = location.pathname.match(ORDER_SHOW_RE);
+    if (match) startPolling(match[1]);
+}
+
+export function installMypageOrderShowInjector(): void {
+    if (typeof window === 'undefined') return;
+    const w = window as unknown as Record<string, unknown>;
+    if (w[FLAG]) return;
+    w[FLAG] = true;
+
+    console.info(`[${PLUGIN_ID}] mypage order show injector installed`);
+
+    const schedule = (delay = 1500) => setTimeout(onRouteChange, delay);
+
+    if (document.readyState === 'loading') {
+        document.addEventListener('DOMContentLoaded', () => schedule());
+    } else {
+        schedule();
+    }
+
+    const origPush = history.pushState.bind(history);
+    history.pushState = (...args: Parameters<typeof history.pushState>) => {
+        origPush(...args);
+        schedule(600);
+    };
+    window.addEventListener('popstate', () => schedule(500));
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/orderCompleteReceiptInjector.ts b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/orderCompleteReceiptInjector.ts
new file mode 100644
index 00000000..2cd616b1
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/orderCompleteReceiptInjector.ts
@@ -0,0 +1,151 @@
+const PLUGIN_ID = 'sirsoft-pay_nicepayments';
+const FLAG = '__nicepayOcReceiptInjectorInstalled';
+const BTN_ID = 'nicepay-oc-receipt-btn';
+
+const ORDER_COMPLETE_RE = /^\/shop\/orders\/([^/]+)\/complete$/;
+
+type Payment = {
+    pg_provider: string;
+    transaction_id: string | null;
+    paid_at: string | null;
+    [key: string]: unknown;
+};
+
+interface ReceiptInfo {
+    receipt_url?: string | null;
+    payment_method_display_label?: string | null;
+}
+
+function getToken(): string | null {
+    return localStorage.getItem('auth_token');
+}
+
+async function fetchPayment(orderNumber: string): Promise<Payment | null> {
+    const token = getToken();
+    if (!token) return null;
+
+    try {
+        const res = await fetch(`/api/modules/sirsoft-ecommerce/user/orders/${orderNumber}`, {
+            headers: { Authorization: `Bearer ${token}`, Accept: 'application/json' },
+        });
+        if (!res.ok) return null;
+        const data = (await res.json()) as { data?: { payment?: Payment } };
+        return data?.data?.payment ?? null;
+    } catch {
+        return null;
+    }
+}
+
+async function fetchReceiptInfo(orderNumber: string): Promise<ReceiptInfo | null> {
+    const token = getToken();
+    if (!token) return null;
+
+    try {
+        const res = await fetch(`/api/plugins/${PLUGIN_ID}/user/orders/${orderNumber}/receipt`, {
+            headers: { Authorization: `Bearer ${token}`, Accept: 'application/json' },
+        });
+        if (!res.ok) return null;
+        return (await res.json()) as ReceiptInfo;
+    } catch {
+        return null;
+    }
+}
+
+function patchPaymentMethodDisplay(displayLabel: string | null | undefined): boolean {
+    if (!displayLabel) return false;
+
+    const rows = Array.from(document.querySelectorAll<HTMLElement>('div'));
+    for (const row of rows) {
+        const spans = Array.from(row.children).filter(
+            (child): child is HTMLElement => child instanceof HTMLElement && child.tagName === 'SPAN',
+        );
+        if (spans.length < 2) continue;
+
+        const label = spans[0].textContent?.trim();
+        if (label !== '결제 방법' && label !== '결제수단' && label !== '결제 방식') continue;
+
+        const value = spans[spans.length - 1];
+        if (value.textContent?.trim() !== displayLabel) {
+            value.textContent = displayLabel;
+            value.dataset.nicepayPaymentMethodPatched = 'true';
+        }
+        row.dataset.nicepayPaymentMethodRow = 'true';
+        return true;
+    }
+
+    return false;
+}
+
+async function injectOnOrderComplete(orderNumber: string): Promise<void> {
+    if (document.getElementById(BTN_ID)) return;
+
+    const payment = await fetchPayment(orderNumber);
+    // 입금완료(paid_at 채워짐) 시점에만 영수증 버튼 표시 — 가상계좌 입금대기 차단
+    if (!payment || payment.pg_provider !== 'nicepayments' || !payment.transaction_id || !payment.paid_at) return;
+
+    const blueBtn = Array.from(document.querySelectorAll<HTMLButtonElement>('button[type="button"]'))
+        .find(b => b.className.includes('bg-blue-600'));
+
+    if (!blueBtn?.parentElement) return;
+
+    const receiptInfo = await fetchReceiptInfo(orderNumber);
+    patchPaymentMethodDisplay(receiptInfo?.payment_method_display_label);
+
+    const container = blueBtn.parentElement;
+
+    const receiptBtn = document.createElement('button');
+    receiptBtn.id = BTN_ID;
+    receiptBtn.type = 'button';
+    receiptBtn.className = blueBtn.className
+        .replace(/bg-blue-\d+/g, 'bg-green-600')
+        .replace(/hover:bg-blue-\d+/g, 'hover:bg-green-700');
+    receiptBtn.textContent = '영수증 조회';
+
+    receiptBtn.addEventListener('click', async () => {
+        receiptBtn.disabled = true;
+        receiptBtn.textContent = '로딩 중...';
+        const data = await fetchReceiptInfo(orderNumber);
+        receiptBtn.disabled = false;
+        receiptBtn.textContent = '영수증 조회';
+        const url = data?.receipt_url ?? null;
+        if (url) {
+            window.open(url, 'nicepay_receipt', 'width=800,height=600,scrollbars=yes,resizable=yes');
+        }
+    });
+
+    const lastBtn = container.lastElementChild;
+    container.insertBefore(receiptBtn, lastBtn);
+
+    console.info(`[${PLUGIN_ID}] receipt button injected on order complete page`);
+}
+
+function tryInject(): void {
+    const match = location.pathname.match(ORDER_COMPLETE_RE);
+    if (match) {
+        void injectOnOrderComplete(match[1]);
+    }
+}
+
+export function installOrderCompleteReceiptInjector(): void {
+    if (typeof window === 'undefined') return;
+    const w = window as Record<string, unknown>;
+    if (w[FLAG]) return;
+    w[FLAG] = true;
+
+    console.info(`[${PLUGIN_ID}] order complete receipt injector installed`);
+
+    const schedule = (delay = 1200) => setTimeout(tryInject, delay);
+
+    if (document.readyState === 'loading') {
+        document.addEventListener('DOMContentLoaded', () => schedule());
+    } else {
+        schedule();
+    }
+
+    const origPush = history.pushState.bind(history);
+    history.pushState = (...args: Parameters<typeof history.pushState>) => {
+        origPush(...args);
+        schedule();
+    };
+    window.addEventListener('popstate', () => schedule(500));
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/orderResponseInterceptor.ts b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/orderResponseInterceptor.ts
new file mode 100644
index 00000000..73cf3ee4
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/orderResponseInterceptor.ts
@@ -0,0 +1,330 @@
+/**
+ * 주문 생성 API 요청/응답 인터셉터
+ *
+ * G7Core 템플릿 엔진의 apiCall 핸들러는 window.fetch 를 직접 사용하므로
+ * window.fetch 를 래핑하는 방식으로 동작한다.
+ *
+ *   1. POST /api/modules/sirsoft-ecommerce/user/orders 요청을 가로챈다
+ *   2. payment_method 가 'nicepay_*' 이면 'card' 로 교체해 서버에 전송
+ *      (서버의 PaymentMethodEnum 에 nicepay_* 가 없어서 422 발생 방지)
+ *   3. 응답에서 pg_provider === 'sirsoft-nicepayments' 이면 requestPayment 핸들러를 직접 호출
+ *   4. 원래 nicepay 방식(paymentMethod)을 requestPayment 에 전달해 올바른 결제창 호출
+ *   5. requires_pg_payment → false, redirect_url → 현재 URL 로 교체
+ *      → 템플릿 조건 분기가 !requires_pg_payment 쪽으로 떨어져 navigate-to-self 가 됨
+ */
+
+import { requestPaymentHandler } from './handlers/requestPayment';
+
+const ORDER_CREATE_PATH = '/user/orders';
+const TARGET_PG_PROVIDER = 'sirsoft-nicepayments';
+const PLUGIN_IDENTIFIER = 'sirsoft-pay_nicepayments';
+const FETCH_FLAG = '__sirsoftNicepayFetchInterceptorInstalled';
+const CHECKOUT_ENDPOINT_PATH = '/api/modules/sirsoft-ecommerce/checkout';
+const PAYMENT_IN_PROGRESS_FLAG = '__sirsoftNicepayPaymentInProgress';
+const CHECKOUT_CACHE_KEY = '__sirsoftNicepayCheckoutCache';
+
+const logger = {
+    info: (...args: unknown[]) => console.info(`[${PLUGIN_IDENTIFIER}]`, ...args),
+    warn: (...args: unknown[]) => console.warn(`[${PLUGIN_IDENTIFIER}]`, ...args),
+    error: (...args: unknown[]) => console.error(`[${PLUGIN_IDENTIFIER}]`, ...args),
+};
+
+function buildNoOpRedirectUrl(): string {
+    return window.location.pathname + window.location.search + window.location.hash;
+}
+
+function isTargetOrderEndpoint(url: string, method: string): boolean {
+    if (method.toUpperCase() !== 'POST') return false;
+    const path = (url ?? '').split('?')[0].split('#')[0];
+    return path === ORDER_CREATE_PATH || path.endsWith(ORDER_CREATE_PATH);
+}
+
+function isCheckoutEndpoint(url: string, method: string): boolean {
+    if (method.toUpperCase() !== 'GET') return false;
+    const path = (url ?? '').split('?')[0].split('#')[0];
+    return path === CHECKOUT_ENDPOINT_PATH || path.endsWith(CHECKOUT_ENDPOINT_PATH);
+}
+
+function extractPaymentMethodFromBody(body: unknown): string | undefined {
+    if (!body) return undefined;
+    let obj: Record<string, unknown> | null = null;
+    if (typeof body === 'string') {
+        try { obj = JSON.parse(body) as Record<string, unknown>; } catch { return undefined; }
+    } else if (typeof body === 'object') {
+        obj = body as Record<string, unknown>;
+    }
+    if (!obj) return undefined;
+    const v = obj['payment_method'];
+    return typeof v === 'string' && v.length > 0 ? v : undefined;
+}
+
+function replacePaymentMethodInBody(body: string, newMethod: string): string {
+    try {
+        const parsed = JSON.parse(body) as Record<string, unknown>;
+        if ('payment_method' in parsed) {
+            return JSON.stringify({ ...parsed, payment_method: newMethod });
+        }
+    } catch { /* fall through */ }
+    return body;
+}
+
+function resolveOrderPaymentAmount(orderData: Record<string, unknown>): number {
+    const candidates = [orderData.total_due_amount, orderData.total_amount];
+    for (const candidate of candidates) {
+        const amount = Number(candidate ?? 0);
+        if (Number.isFinite(amount) && amount > 0) {
+            return Math.floor(amount);
+        }
+    }
+
+    return 0;
+}
+
+export function installOrderResponseInterceptor(): void {
+    const w = window as unknown as Record<string, unknown>;
+    if (w[FETCH_FLAG]) return;
+    w[FETCH_FLAG] = true;
+
+    // 최초 설치 플러그인이 원본 브라우저 fetch를 보존 (다른 PG 인터셉터가 쌓이기 전)
+    // easy pay 요청 시 이 fetch를 사용해 다른 PG 인터셉터(NHN KCP 등)의 간섭을 차단한다
+    const ORIGINAL_FETCH_KEY = '__sirsoftPgOriginalFetch';
+    if (!w[ORIGINAL_FETCH_KEY]) {
+        w[ORIGINAL_FETCH_KEY] = window.fetch.bind(window);
+    }
+    const browserFetch = w[ORIGINAL_FETCH_KEY] as typeof fetch;
+
+    const originalFetch = window.fetch.bind(window);
+
+    window.fetch = async (input: RequestInfo | URL, init?: RequestInit): Promise<Response> => {
+        const url =
+            typeof input === 'string'
+                ? input
+                : input instanceof URL
+                    ? input.href
+                    : (input as Request).url;
+        const method = init?.method ?? (input instanceof Request ? input.method : 'GET');
+
+        // GET checkout 캐싱 — 결제 진행 중 페이지 재초기화 시 "주문서 없음" 다이얼로그 억제
+        if (isCheckoutEndpoint(url, method)) {
+            if (w[PAYMENT_IN_PROGRESS_FLAG] && w[CHECKOUT_CACHE_KEY]) {
+                logger.info('payment in progress — serving cached checkout response');
+                return new Response(w[CHECKOUT_CACHE_KEY] as string, {
+                    status: 200,
+                    headers: { 'Content-Type': 'application/json' },
+                });
+            }
+            const checkoutResp = await originalFetch(input, init);
+            if (checkoutResp.ok) {
+                const text = await checkoutResp.text();
+                w[CHECKOUT_CACHE_KEY] = text;
+                return new Response(text, {
+                    status: checkoutResp.status,
+                    statusText: checkoutResp.statusText,
+                    headers: checkoutResp.headers,
+                });
+            }
+            return checkoutResp;
+        }
+
+        if (!isTargetOrderEndpoint(url, method)) {
+            return originalFetch(input, init);
+        }
+
+        // 요청 body에서 payment_method 추출. nicepay_* (간편결제) 만 'card' 로 교체.
+        // 일반 결제수단(card / vbank / bank / phone)도 그대로 보존해 requestPaymentHandler
+        // 호출 시 정확한 결제수단으로 결제창을 연다 (이전엔 nicepay_* 만 추적해서
+        // 가상계좌/계좌이체/휴대폰 선택 시 'card' 로 폴백되는 회귀가 있었음).
+        let originalPaymentMethod: string | undefined;
+        let isEasyPay = false;
+        let modifiedInit = init;
+
+        if (init?.body && typeof init.body === 'string') {
+            const pm = extractPaymentMethodFromBody(init.body);
+            if (typeof pm === 'string' && pm.length > 0) {
+                originalPaymentMethod = pm;
+                if (pm.startsWith('nicepay_')) {
+                    isEasyPay = true;
+                    modifiedInit = { ...init, body: replacePaymentMethodInBody(init.body, 'card') };
+                    logger.info(`easy pay detected: replacing payment_method '${pm}' → 'card'`);
+                }
+            }
+        }
+
+        // easy pay일 때는 browserFetch(원본)를 사용해 NHN KCP 등 다른 PG 인터셉터를 우회한다.
+        // "타 PG와 사용가능함"이 ON이고 기본 PG가 NHN KCP일 때 NHN KCP 결제창이 먼저 열리는 것을 방지.
+        const fetchFn = isEasyPay ? browserFetch : originalFetch;
+        const response = await fetchFn(input, modifiedInit);
+
+        // 2xx 응답만 처리 (4xx/5xx 오류 응답은 그대로 통과)
+        if (!response.ok) {
+            return response;
+        }
+
+        // 응답 파싱 (clone으로 원본 스트림 보호)
+        // 서버 응답 구조: { success, message, data: { order, requires_pg_payment, pg_provider, pg_payment_data, redirect_url } }
+        let envelope: Record<string, unknown> | null = null;
+        try {
+            envelope = (await response.clone().json()) as Record<string, unknown>;
+        } catch {
+            return response;
+        }
+
+        const responseData = (envelope?.data ?? envelope) as Record<string, unknown> | null;
+
+        // 일반 결제: PG 결제가 필요 없으면 통과
+        // 간편결제(nicepay_*): requires_pg_payment=false여도 계속 처리
+        //   → 기본 PG가 미설정이면 백엔드가 requires_pg_payment:false를 반환하지만
+        //     간편결제는 나이스페이먼츠 결제창을 열어야 하므로 통과시킴 (취약점 방어)
+        if (!responseData?.requires_pg_payment && !isEasyPay) {
+            return response;
+        }
+
+        // easy pay: pg_provider 무관하게 나이스페이 처리
+        // 일반 결제: pg_provider가 나이스페이인 경우에만 처리 (나이스페이가 기본 PG일 때)
+        const isNicepayPg = responseData.pg_provider === TARGET_PG_PROVIDER;
+
+        if (!isEasyPay && !isNicepayPg) {
+            return response;
+        }
+
+        // pg_payment_data: 백엔드 응답에 포함되거나,
+        // 간편결제 + 기본 PG 미설정 시 order 데이터에서 직접 구성
+        let pgPaymentData = responseData.pg_payment_data as Record<string, unknown> | undefined;
+        if (!pgPaymentData && isEasyPay) {
+            const orderData = responseData.order as Record<string, unknown> | undefined;
+            if (orderData) {
+                const options = orderData.options as Array<Record<string, unknown>> | undefined;
+                const firstName = (options?.[0]?.product_name as string | undefined) ?? String(orderData.order_number ?? '');
+                const orderName = (options?.length ?? 0) > 1
+                    ? `${firstName} 외 ${(options?.length ?? 0) - 1}건`
+                    : firstName;
+                pgPaymentData = {
+                    order_number: orderData.order_number,
+                    order_name: orderName,
+                    // PG 청구액 SSoT는 total_due_amount. 구형 응답 호환만 total_amount로 fallback.
+                    amount: resolveOrderPaymentAmount(orderData),
+                    currency: 'KRW',
+                    customer_name: orderData.orderer_name ?? null,
+                    customer_email: orderData.orderer_email ?? null,
+                    customer_phone: String(orderData.orderer_phone ?? '').replace(/[^0-9]/g, ''),
+                    customer_key: orderData.user_id ?? null,
+                };
+                logger.info('pg_payment_data constructed from order (기본 PG 미설정)', {
+                    order_number: pgPaymentData.order_number,
+                    amount: pgPaymentData.amount,
+                });
+            }
+        }
+
+        if (!pgPaymentData) {
+            logger.warn('nicepayments order detected but pg_payment_data missing');
+            return response;
+        }
+
+        const paymentMethod = originalPaymentMethod ?? 'card';
+
+        logger.info('intercepted order create response — opening PG popup', { paymentMethod });
+
+        void requestPaymentHandler({
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            params: { pgPaymentData: pgPaymentData as any, paymentMethod },
+        });
+
+        // 결제 진행 중 플래그 설정 — GET checkout 캐시 서빙으로 "주문서 없음" 다이얼로그 억제
+        w[PAYMENT_IN_PROGRESS_FLAG] = true;
+
+        // 결제창(팝업)이 열려 있는 동안 checkout 페이지에 머물도록
+        // redirect_url을 항상 현재 URL(navigate-to-self)로 교체한다.
+        // → 템플릿 fallback navigate가 무력화되어 "결제 완료" 페이지로 이동하지 않음
+        // → 실제 결제 완료 후 requestPaymentHandler 콜백이 complete 페이지로 이동시킴
+        // navigate-to-self로 checkout 재초기화 시 GET checkout 404 → "주문서 없음" 다이얼로그가
+        //   뜰 수 있으나, PAYMENT_IN_PROGRESS_FLAG + 캐시 서빙으로 억제된다.
+
+        // envelope.data 안에 있는 경우와 최상위에 있는 경우 모두 처리
+        const modifiedData = { ...responseData, requires_pg_payment: false, redirect_url: buildNoOpRedirectUrl() };
+        const modifiedBody = envelope?.data
+            ? { ...envelope, data: modifiedData }
+            : modifiedData;
+
+        return new Response(JSON.stringify(modifiedBody), {
+            status: response.status,
+            statusText: response.statusText,
+            headers: response.headers,
+        });
+    };
+
+    logger.info('fetch order interceptor installed');
+
+    // Axios 인터셉터 설치 — GET checkout 캐싱 및 결제 중 캐시 서빙
+    // G7Core.api.client(Axios)가 초기화된 후 설치해야 하므로 비동기로 재시도
+    tryInstallAxiosCheckoutInterceptor(w, 15);
+}
+
+const AXIOS_CHECKOUT_FLAG = '__sirsoftNicepayAxiosCheckoutInterceptorInstalled';
+
+function tryInstallAxiosCheckoutInterceptor(w: Record<string, unknown>, retries: number): void {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const axiosClient = ((window as any)?.G7Core?.api?.client) as any;
+    if (!axiosClient?.interceptors) {
+        if (retries > 0) {
+            setTimeout(() => tryInstallAxiosCheckoutInterceptor(w, retries - 1), 300);
+        }
+        return;
+    }
+
+    if (w[AXIOS_CHECKOUT_FLAG]) return;
+    w[AXIOS_CHECKOUT_FLAG] = true;
+
+    // 응답 인터셉터: GET checkout 성공 시 캐시 저장
+    // Axios config.url은 baseURL을 포함하지 않으므로 (config.baseURL ?? '') + config.url 로 완성
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    axiosClient.interceptors.response.use((response: any) => {
+        const method = (response?.config?.method ?? '').toLowerCase();
+        const url = String((response?.config?.baseURL ?? '') + (response?.config?.url ?? ''));
+        if (method === 'get' && isCheckoutEndpoint(url, 'GET') && response?.status === 200) {
+            w[CHECKOUT_CACHE_KEY] = JSON.stringify(response.data);
+            logger.info('checkout response cached (axios)');
+        }
+        return response;
+    });
+
+    // 요청 인터셉터: 결제 진행 중 GET checkout을 캐시에서 반환
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    axiosClient.interceptors.request.use((config: any) => {
+        const method = (config?.method ?? '').toLowerCase();
+        const url = String((config?.baseURL ?? '') + (config?.url ?? ''));
+        if (method === 'get' && isCheckoutEndpoint(url, 'GET') && w[PAYMENT_IN_PROGRESS_FLAG] && w[CHECKOUT_CACHE_KEY]) {
+            logger.info('payment in progress — serving cached checkout response (axios)');
+            // adapter를 Promise.resolve로 교체해 실제 요청 없이 캐시 반환
+            config.adapter = () => Promise.resolve({
+                data: JSON.parse(w[CHECKOUT_CACHE_KEY] as string),
+                status: 200,
+                statusText: 'OK (cached)',
+                headers: { 'content-type': 'application/json' },
+                config,
+                request: {},
+            });
+        }
+        return config;
+    });
+
+    logger.info('axios checkout interceptor installed');
+
+    // 인터셉터 설치 직후 GET checkout 즉시 캐싱 — navigate-to-self 재초기화 대비
+    if (!w[CHECKOUT_CACHE_KEY]) {
+        void (async () => {
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const coreApi = ((window as any)?.G7Core?.api) as { get?: (url: string) => Promise<unknown> } | undefined;
+                await coreApi?.get?.('/modules/sirsoft-ecommerce/checkout');
+                // 응답은 Axios 응답 인터셉터가 자동으로 캐싱함
+            } catch { /* 체크아웃 세션 없으면 실패 — 무시 */ }
+        })();
+    }
+}
+
+/** @deprecated Axios 인터셉터 방식 — apiCall 핸들러가 window.fetch 를 사용하므로 동작하지 않음. installOrderResponseInterceptor 를 사용할 것. */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function installAxiosOrderInterceptor(_axiosClient: any): void {
+    // no-op
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/paymentCloseReport.ts b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/paymentCloseReport.ts
new file mode 100644
index 00000000..0ea64690
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/resources/js/paymentCloseReport.ts
@@ -0,0 +1,63 @@
+export interface PaymentCloseReportContext {
+    closeReportUrl?: string;
+    oid: string;
+    price: number;
+    buyer_email?: string;
+    buyer_phone?: string;
+    payment_method?: string;
+}
+
+function resolveApiUrl(url: string): string {
+    if (/^https?:\/\//i.test(url) || url.startsWith('/api/')) {
+        return url;
+    }
+
+    if (url.startsWith('/plugins/')) {
+        return `/api${url}`;
+    }
+
+    if (url.startsWith('plugins/')) {
+        return `/api/${url}`;
+    }
+
+    return url;
+}
+
+function trimReason(reason: string): string {
+    return reason.trim().slice(0, 160);
+}
+
+export async function reportPaymentWindowClosed(
+    context: PaymentCloseReportContext,
+    reason = 'nicepay-window-closed',
+): Promise<void> {
+    if (!context.closeReportUrl) {
+        return;
+    }
+
+    const payload = {
+        oid: context.oid,
+        price: Number(context.price),
+        buyer_email: context.buyer_email ?? '',
+        buyer_phone: context.buyer_phone ?? '',
+        payment_method: context.payment_method ?? '',
+        reason: trimReason(reason) || 'nicepay-window-closed',
+    };
+
+    try {
+        const apiClient = ((window as any).G7Core)?.api;
+        if (typeof apiClient?.post === 'function') {
+            await apiClient.post(context.closeReportUrl, payload);
+            return;
+        }
+
+        await fetch(resolveApiUrl(context.closeReportUrl), {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(payload),
+            keepalive: true,
+        });
+    } catch (error) {
+        console.warn('[sirsoft-pay_nicepayments] failed to report payment window close', error);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/resources/lang/en.json b/plugins/_bundled/sirsoft-pay_nicepayments/resources/lang/en.json
new file mode 100644
index 00000000..e644cfcc
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/resources/lang/en.json
@@ -0,0 +1,154 @@
+{
+    "editor": {
+        "data_source": {
+            "nicepay_easy_pay_config": "Easy Pay Config",
+            "nicepay_escrow": "Escrow",
+            "nicepay_status": "Payment Status",
+            "nicepay_test_mode_status": "Test Mode Status",
+            "nicepay_test_map": "Test Payment Map",
+            "settings": "Payment Settings",
+            "vbank_info": "Virtual Account Info"
+        }
+    },
+    "settings": {
+        "title": "NicePayments Settings",
+        "description": "NicePayments PG integration settings",
+        "test_mode": "Test Mode",
+        "test_mode_hint": "Real card authorization/withdrawal notifications may still occur in test mode. Test account payments are batch-cancelled around 23:30 on the same day.",
+        "section_test_keys": "Test Key Settings",
+        "test_mid": "Test Merchant ID (MID)",
+        "test_mid_hint": "NicePayments shared test MID. No change needed for testing.",
+        "test_merchant_key": "Test Merchant Key",
+        "test_merchant_key_hint": "NicePayments shared test key. No change needed for testing.",
+        "section_live_keys": "Live Key Settings",
+        "live_mid": "Live Merchant ID (MID)",
+        "live_mid_hint": "Check in NicePayments merchant portal > Merchant Info > KEY Management. Enter only the part after 'SR'.",
+        "live_mid_example": "e.g. If your MID is SRpaytestm, enter only paytestm → Result: SRpaytestm",
+        "live_merchant_key": "Live Merchant Key",
+        "live_merchant_key_hint": "Keep this key secret.",
+        "live_mode_warning_title": "Live Mode Active",
+        "live_mode_warning_body": "Real payments are being processed. Make sure your live MID and merchant key are correctly configured.",
+        "section_vbank_notify": "Virtual Account Deposit Notification URL",
+        "vbank_notify_hint": "When using virtual accounts, register the URL below in the NicePayments merchant portal (Merchant Info settings). Deposits will be automatically notified to this address.",
+        "vbank_notify_copied": "URL copied to clipboard.",
+        "copy": "Copy",
+        "section_redirect": "Redirect URLs",
+        "redirect_success_url": "Payment Success Redirect URL",
+        "redirect_success_url_hint": "Supports relative paths (/shop/...) or full URLs (https://...). {orderId} will be replaced with the actual order number.",
+        "redirect_fail_url": "Payment Failure Redirect URL",
+        "redirect_fail_url_hint": "Supports relative paths or full URLs. Error details are appended as query parameters.",
+        "use_escrow": "Enable Escrow Payment",
+        "use_escrow_hint": "Enables escrow payment for buyer protection when selling physical goods. Delivery registration is required after escrow payment.",
+        "section_easy_pay": "Easy Pay Settings",
+        "section_easy_pay_hint": "Enable the easy pay services you want to offer. Only activate services where you have a signed contract with NicePayments.",
+        "easy_pay_naverpay": "Naver Pay",
+        "easy_pay_naverpay_hint": "Available in test mode",
+        "easy_pay_kakaopay": "Kakao Pay",
+        "easy_pay_samsungpay": "Samsung Pay",
+        "easy_pay_applepay": "Apple Pay",
+        "easy_pay_applepay_hint": "Available on Safari and Apple devices only",
+        "easy_pay_payco": "PAYCO",
+        "easy_pay_skpay": "11pay (SK Pay)",
+        "easy_pay_ssgpay": "SSG Pay",
+        "easy_pay_lpay": "L.pay",
+        "easy_pay_allow_with_other_pg": "Allow with other PG",
+        "easy_pay_allow_with_other_pg_hint": "When enabled, NicePay easy pay buttons will appear on the checkout page even when another PG is set as the default payment provider."
+    },
+    "admin": {
+        "transaction_query_title": "TID Transaction Query",
+        "transaction_query_description": "Query payment status directly using a NicePayments transaction ID (TID).",
+        "transaction_tid_label": "Transaction ID (TID)",
+        "transaction_query_button": "Query",
+        "transaction_query_error": "Query Failed",
+        "transaction_result_title": "Query Result",
+        "result_tid": "Transaction ID (TID)",
+        "result_order_id": "Order ID (Moid)",
+        "result_amount": "Amount",
+        "result_status": "Payment Status",
+        "result_method": "Payment Method",
+        "result_auth_code": "Authorization Code",
+        "result_auth_date": "Authorization Date",
+        "result_result_code": "Result Code",
+        "order_verify_title": "NicePayments Verification",
+        "order_verify_description": "Query real-time payment status from NicePayments server.",
+        "order_verify_button": "Verify",
+        "order_verify_error": "Query Failed",
+        "pay_status_approved": "Approved",
+        "pay_status_cancelled": "Cancelled",
+        "pay_status_unknown": "Unknown",
+        "vbank_noti_title": "Virtual Account Deposit Notifications",
+        "vbank_noti_description": "Audit log of NicePay deposit notifications (auto-accumulated)",
+        "vbank_noti_count": "Notification count",
+        "vbank_noti_first_at": "First received",
+        "vbank_noti_last_at": "Last received",
+        "vbank_noti_deposited_at": "Deposit confirmed at",
+        "vbank_noti_cancelled_at": "Deposit cancelled at",
+        "vbank_noti_depositor": "Depositor (last)",
+        "vbank_noti_history": "History (chronological)",
+        "vbank_noti_type_deposited": "Deposited",
+        "vbank_noti_type_cancelled": "Cancelled",
+        "vbank_noti_type_other": "Other",
+        "vbank_noti_query_button": "Load notification log",
+        "vbank_noti_loading": "Loading...",
+        "vbank_noti_not_loaded": "Click the button to view the NicePay deposit notification log.",
+        "vbank_noti_empty": "No deposit notifications received.",
+        "vbank_noti_load_error": "Failed to load notification log.",
+        "escrow_badge": "Escrow",
+        "result_escrow": "Escrow",
+        "escrow_yes": "Escrow Payment",
+        "escrow_no": "Regular Payment",
+        "escrow_payment_notice": "This is an escrow payment. Buyer confirmation is required after delivery registration.",
+        "escrow_delivery_title": "Escrow Delivery Registration",
+        "escrow_delivery_company": "Courier Company",
+        "escrow_delivery_company_placeholder": "e.g. FedEx",
+        "escrow_tracking_number": "Tracking Number",
+        "escrow_tracking_number_placeholder": "Enter tracking number",
+        "escrow_buyer_address": "Delivery Address",
+        "escrow_register_name": "Registrant Name",
+        "escrow_register_button": "Register Delivery",
+        "escrow_register_success": "Escrow delivery has been registered.",
+        "escrow_register_error": "Failed to register escrow delivery.",
+        "test_mode_badge": "TEST",
+        "test_mode_order_notice": "This order was processed in test mode. Real card authorization/withdrawal notifications may occur, but NicePayments test account payments are batch-cancelled around 23:30 on the same day. Verify live payment status before shipping.",
+        "test_mode_settings_warning_plugin": "NicePayments",
+        "test_mode_settings_warning_title": "Warning: NicePayments is currently set to test mode.",
+        "test_mode_settings_warning_body": "Test payments do not create real payments. If the shop is live, switch this plugin to live payment mode before operating.",
+        "test_mode_settings_warning_action": "Switch to live mode",
+        "test_mode_orders_in_list": "Test payment orders included"
+    },
+    "easy_pay": {
+        "section_title": "Easy Pay"
+    },
+    "user": {
+        "receipt_label": "Receipt",
+        "view_receipt": "View Receipt",
+        "view_cash_receipt": "View Cash Receipt",
+        "easy_pay_label": "Easy Pay",
+        "test_mode_badge": "TEST",
+        "tax_breakdown_title": "Tax Breakdown",
+        "supply_amount": "Supply Amount",
+        "vat_amount": "VAT",
+        "tax_free_amount": "Tax-Free Amount",
+        "vbank_deposit_info": "Virtual Account Deposit Info",
+        "vbank_bank": "Bank",
+        "vbank_account": "Account Number",
+        "vbank_holder": "Account Holder",
+        "vbank_amount": "Deposit Amount",
+        "vbank_due": "Deposit Due",
+        "vbank_notice": "If deposit is not completed by the due date, the order will be auto-cancelled."
+    },
+    "messages": {
+        "refund": {
+            "missing_tid": "Payment transaction ID (TID) is missing.",
+            "default_reason": "Admin refund"
+        },
+        "payment": {
+            "auth_failed": "Payment authentication failed.",
+            "mid_mismatch": "Merchant ID does not match.",
+            "signature_mismatch": "Payment signature verification failed.",
+            "order_not_found": "Order not found.",
+            "amount_mismatch": "Payment amount does not match.",
+            "authorize_failed": "Payment authorization failed."
+        }
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/resources/lang/ko.json b/plugins/_bundled/sirsoft-pay_nicepayments/resources/lang/ko.json
new file mode 100644
index 00000000..cb748fb1
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/resources/lang/ko.json
@@ -0,0 +1,154 @@
+{
+    "editor": {
+        "data_source": {
+            "nicepay_easy_pay_config": "간편결제 설정",
+            "nicepay_escrow": "에스크로",
+            "nicepay_status": "결제 상태",
+            "nicepay_test_mode_status": "테스트 모드 상태",
+            "nicepay_test_map": "테스트 결제 맵",
+            "settings": "결제 설정",
+            "vbank_info": "가상계좌 정보"
+        }
+    },
+    "settings": {
+        "title": "나이스페이먼츠 설정",
+        "description": "나이스페이먼츠 PG 연동 설정",
+        "test_mode": "테스트 모드",
+        "test_mode_hint": "테스트 모드에서도 실제 카드 승인/출금 알림이 발생할 수 있으며, 테스트 계정 결제는 당일 23:30경 일괄 자동 취소됩니다.",
+        "section_test_keys": "테스트 키 설정",
+        "test_mid": "테스트 가맹점 ID (MID)",
+        "test_mid_hint": "나이스페이먼츠 공용 테스트 MID입니다. 테스트 전용이며 변경하지 않아도 됩니다.",
+        "test_merchant_key": "테스트 가맹점 키",
+        "test_merchant_key_hint": "나이스페이먼츠 공용 테스트 키입니다. 테스트 전용이며 변경하지 않아도 됩니다.",
+        "section_live_keys": "라이브 키 설정",
+        "live_mid": "라이브 가맹점 ID (MID)",
+        "live_mid_hint": "나이스페이먼츠 상점관리자 > 가맹점정보 > KEY관리에서 확인. 'SR'을 제외한 나머지만 입력하세요.",
+        "live_mid_example": "예) 상점ID가 SRpaytestm이면 paytestm만 입력 → 완성: SRpaytestm",
+        "live_merchant_key": "라이브 가맹점 키",
+        "live_merchant_key_hint": "외부에 노출되지 않도록 주의하세요.",
+        "live_mode_warning_title": "라이브 모드 활성화",
+        "live_mode_warning_body": "현재 실제 결제가 처리됩니다. 라이브 MID와 가맹점 키가 올바르게 설정되어 있는지 확인하세요.",
+        "section_vbank_notify": "가상계좌 입금통보 URL",
+        "vbank_notify_hint": "가상계좌 사용 시 아래 URL을 나이스페이먼츠 가맹점관리자 → 가맹점정보 설정에 등록하세요. 입금이 완료되면 이 주소로 자동 통보됩니다.",
+        "vbank_notify_copied": "URL이 클립보드에 복사되었습니다.",
+        "copy": "복사",
+        "section_redirect": "리다이렉트 URL",
+        "redirect_success_url": "결제 성공 리다이렉트 URL",
+        "redirect_success_url_hint": "상대 경로(/shop/...) 또는 전체 URL(https://...) 모두 가능합니다. {orderId}는 주문번호로 자동 치환됩니다.",
+        "redirect_fail_url": "결제 실패 리다이렉트 URL",
+        "redirect_fail_url_hint": "상대 경로 또는 전체 URL 모두 가능합니다. 오류 정보는 쿼리 파라미터로 자동 추가됩니다.",
+        "use_escrow": "에스크로 결제 사용",
+        "use_escrow_hint": "실물 상품 판매 시 구매자 보호를 위한 에스크로 결제를 활성화합니다. 에스크로 결제 후 배송 등록이 필요합니다.",
+        "section_easy_pay": "간편결제 설정",
+        "section_easy_pay_hint": "사용할 간편결제 서비스를 선택하세요. 나이스페이먼츠 가맹점 계약이 완료된 서비스만 활성화하세요.",
+        "easy_pay_naverpay": "네이버페이",
+        "easy_pay_naverpay_hint": "테스트 모드에서도 사용 가능",
+        "easy_pay_kakaopay": "카카오페이",
+        "easy_pay_samsungpay": "삼성페이",
+        "easy_pay_applepay": "애플페이",
+        "easy_pay_applepay_hint": "Safari 및 Apple 기기에서만 사용 가능",
+        "easy_pay_payco": "PAYCO",
+        "easy_pay_skpay": "11pay (SK페이)",
+        "easy_pay_ssgpay": "SSG페이",
+        "easy_pay_lpay": "L.pay",
+        "easy_pay_allow_with_other_pg": "타 PG와 사용가능함",
+        "easy_pay_allow_with_other_pg_hint": "활성화하면, 다른 PG사가 기본 결제수단으로 설정된 경우에도 체크아웃 페이지에 나이스페이 간편결제 버튼이 표시됩니다."
+    },
+    "admin": {
+        "transaction_query_title": "TID 거래 조회",
+        "transaction_query_description": "나이스페이먼츠 거래 ID(TID)로 결제 상태를 직접 조회합니다.",
+        "transaction_tid_label": "거래 ID (TID)",
+        "transaction_query_button": "조회",
+        "transaction_query_error": "조회 실패",
+        "transaction_result_title": "조회 결과",
+        "result_tid": "거래 ID (TID)",
+        "result_order_id": "주문번호 (Moid)",
+        "result_amount": "결제 금액",
+        "result_status": "결제 상태",
+        "result_method": "결제 수단",
+        "result_auth_code": "승인번호",
+        "result_auth_date": "승인일시",
+        "result_result_code": "결과 코드",
+        "order_verify_title": "나이스페이먼츠 결제 검증",
+        "order_verify_description": "나이스페이먼츠 서버에서 실시간으로 결제 상태를 조회합니다.",
+        "order_verify_button": "결제 조회",
+        "order_verify_error": "조회 실패",
+        "pay_status_approved": "승인",
+        "pay_status_cancelled": "취소",
+        "pay_status_unknown": "미확인",
+        "vbank_noti_title": "가상계좌 입금통보 이력",
+        "vbank_noti_description": "NicePay 입금통보 수신 기록 (자동 누적)",
+        "vbank_noti_count": "통보 횟수",
+        "vbank_noti_first_at": "첫 통보 수신",
+        "vbank_noti_last_at": "마지막 통보 수신",
+        "vbank_noti_deposited_at": "입금완료 통보 시각",
+        "vbank_noti_cancelled_at": "입금취소 통보 시각",
+        "vbank_noti_depositor": "입금자명 (마지막)",
+        "vbank_noti_history": "통보 이력 (시간순)",
+        "vbank_noti_type_deposited": "입금완료",
+        "vbank_noti_type_cancelled": "입금취소",
+        "vbank_noti_type_other": "기타 통보",
+        "vbank_noti_query_button": "통보 이력 조회",
+        "vbank_noti_loading": "조회 중...",
+        "vbank_noti_not_loaded": "조회 버튼을 누르면 NicePay 입금통보 이력을 확인할 수 있습니다.",
+        "vbank_noti_empty": "수신된 입금통보가 없습니다.",
+        "vbank_noti_load_error": "입금통보 이력 조회 중 오류가 발생했습니다.",
+        "escrow_badge": "에스크로",
+        "result_escrow": "에스크로 여부",
+        "escrow_yes": "에스크로 결제",
+        "escrow_no": "일반 결제",
+        "escrow_payment_notice": "에스크로 결제입니다. 배송 등록 후 구매자 구매확정이 필요합니다.",
+        "escrow_delivery_title": "에스크로 배송 등록",
+        "escrow_delivery_company": "택배사명",
+        "escrow_delivery_company_placeholder": "예: CJ대한통운",
+        "escrow_tracking_number": "운송장번호",
+        "escrow_tracking_number_placeholder": "운송장 번호 입력",
+        "escrow_buyer_address": "배송지 주소",
+        "escrow_register_name": "등록자 이름",
+        "escrow_register_button": "배송 등록",
+        "escrow_register_success": "에스크로 배송이 등록되었습니다.",
+        "escrow_register_error": "에스크로 배송 등록에 실패했습니다.",
+        "test_mode_badge": "테스트 결제",
+        "test_mode_order_notice": "테스트 결제로 처리된 주문입니다. 실제 카드 승인/출금 알림이 발생할 수 있으나, 나이스페이먼츠 테스트 계정 결제는 당일 23:30경 일괄 자동 취소됩니다. 배송 전 운영 결제 여부를 확인하세요.",
+        "test_mode_settings_warning_plugin": "나이스페이먼츠",
+        "test_mode_settings_warning_title": "(주의!) 나이스페이먼츠 결제 설정이 현재 테스트결제로 되어 있습니다.",
+        "test_mode_settings_warning_body": "테스트결제 시 실제 결제가 되지 않으므로, 쇼핑몰 운영 중이면 반드시 실결제로 설정하여 운영하세요.",
+        "test_mode_settings_warning_action": "실결제로 설정",
+        "test_mode_orders_in_list": "테스트 결제 주문 포함"
+    },
+    "easy_pay": {
+        "section_title": "간편결제"
+    },
+    "user": {
+        "receipt_label": "영수증",
+        "view_receipt": "영수증 보기",
+        "view_cash_receipt": "현금영수증 조회",
+        "easy_pay_label": "간편결제 서비스",
+        "test_mode_badge": "테스트 결제",
+        "tax_breakdown_title": "세금 상세",
+        "supply_amount": "공급가액",
+        "vat_amount": "부가세",
+        "tax_free_amount": "면세금액",
+        "vbank_deposit_info": "가상계좌 입금 안내",
+        "vbank_bank": "은행",
+        "vbank_account": "계좌번호",
+        "vbank_holder": "예금주",
+        "vbank_amount": "입금 금액",
+        "vbank_due": "입금 기한",
+        "vbank_notice": "입금 기한 내에 입금이 완료되지 않으면 주문이 자동 취소됩니다."
+    },
+    "messages": {
+        "refund": {
+            "missing_tid": "결제 거래번호(TID)가 없습니다.",
+            "default_reason": "관리자 환불"
+        },
+        "payment": {
+            "auth_failed": "결제 인증에 실패했습니다.",
+            "mid_mismatch": "가맹점 ID가 일치하지 않습니다.",
+            "signature_mismatch": "결제 서명 검증에 실패했습니다.",
+            "order_not_found": "주문을 찾을 수 없습니다.",
+            "amount_mismatch": "결제 금액이 일치하지 않습니다.",
+            "authorize_failed": "결제 승인에 실패했습니다."
+        }
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/resources/layouts/admin/plugin_settings.json b/plugins/_bundled/sirsoft-pay_nicepayments/resources/layouts/admin/plugin_settings.json
new file mode 100644
index 00000000..04b63fdb
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/resources/layouts/admin/plugin_settings.json
@@ -0,0 +1,1163 @@
+{
+    "version": "1.0.0",
+    "layout_name": "plugin_settings",
+    "permissions": [
+        "core.plugins.update"
+    ],
+    "extends": "_admin_base",
+    "meta": {
+        "title": "$t:sirsoft-pay_nicepayments.settings.title",
+        "description": "$t:sirsoft-pay_nicepayments.settings.description"
+    },
+    "data_sources": [
+        {
+            "id": "settings",
+            "label_key": "$t:sirsoft-pay_nicepayments.editor.data_source.settings",
+            "type": "api",
+            "endpoint": "/api/admin/plugins/{{route.identifier}}/settings",
+            "method": "GET",
+            "auto_fetch": true,
+            "auth_required": true,
+            "initLocal": "form",
+            "refetchOnMount": true
+        },
+        {
+            "id": "vbank_info",
+            "label_key": "$t:sirsoft-pay_nicepayments.editor.data_source.vbank_info",
+            "type": "api",
+            "endpoint": "/api/plugins/sirsoft-pay_nicepayments/admin/vbank-notify-url",
+            "method": "GET",
+            "auto_fetch": true,
+            "auth_required": true,
+            "initLocal": "vbankInfo"
+        }
+    ],
+    "slots": {
+        "content": [
+            {
+                "id": "plugin_settings_content",
+                "type": "basic",
+                "name": "Div",
+                "dataKey": "form",
+                "trackChanges": true,
+                "props": {
+                    "className": "p-4 sm:p-6 lg:p-8 min-h-screen bg-gray-50 dark:bg-gray-900"
+                },
+                "children": [
+                    {
+                        "id": "page_header",
+                        "type": "composite",
+                        "name": "PageHeader",
+                        "props": {
+                            "title": "$t:sirsoft-pay_nicepayments.settings.title",
+                            "description": "$t:sirsoft-pay_nicepayments.settings.description",
+                            "backPath": "/admin/plugins",
+                            "backLabel": "$t:admin.plugins.back_to_list"
+                        }
+                    },
+                    {
+                        "id": "validation_error",
+                        "type": "basic",
+                        "name": "Div",
+                        "if": "{{_local.errors}}",
+                        "props": {
+                            "className": "alert-danger"
+                        },
+                        "children": [
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": {
+                                    "className": "flex gap-3"
+                                },
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "Icon",
+                                        "props": {
+                                            "name": "triangle-exclamation",
+                                            "className": "w-5 h-5 text-red-600 dark:text-red-400 flex-shrink-0 mt-0.5"
+                                        }
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "H3",
+                                                "props": {
+                                                    "className": "text-error-soft"
+                                                },
+                                                "text": "$t:admin.plugins.settings.validation_error"
+                                            },
+                                            {
+                                                "type": "basic",
+                                                "name": "Ul",
+                                                "if": "{{typeof _local.errors === 'object' && Object.keys(_local.errors).length > 0}}",
+                                                "props": {
+                                                    "className": "mt-2 list-disc list-inside space-y-1"
+                                                },
+                                                "iteration": {
+                                                    "source": "Object.entries(_local.errors ?? {}).flatMap(([field, messages]) => Array.isArray(messages) ? messages : [messages])",
+                                                    "item_var": "message"
+                                                },
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Li",
+                                                        "props": {
+                                                            "className": "grid-3col-responsive"
+                                                        },
+                                                        "text": "{{message}}"
+                                                    }
+                                                ]
+                                            }
+                                        ]
+                                    }
+                                ]
+                            }
+                        ]
+                    },
+                    {
+                        "id": "test_mode_card",
+                        "type": "basic",
+                        "name": "Div",
+                        "props": {
+                            "className": "mt-6 bg-white dark:bg-gray-800 rounded-lg shadow-sm border border-gray-200 dark:border-gray-700"
+                        },
+                        "children": [
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": {
+                                    "className": "p-6"
+                                },
+                                "children": [
+                                    {
+                                        "id": "field_test_mode",
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "flex items-center justify-between"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Label",
+                                                        "props": {
+                                                            "className": "form-label"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nicepayments.settings.test_mode"
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "P",
+                                                        "props": {
+                                                            "className": "form-hint"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nicepayments.settings.test_mode_hint"
+                                                    }
+                                                ]
+                                            },
+                                            {
+                                                "type": "composite",
+                                                "name": "Toggle",
+                                                "props": {
+                                                    "name": "is_test_mode"
+                                                }
+                                            }
+                                        ]
+                                    }
+                                ]
+                            }
+                        ]
+                    },
+                    {
+                        "id": "live_mode_warning",
+                        "type": "basic",
+                        "name": "Div",
+                        "if": "{{_local.form && !_local.form.is_test_mode}}",
+                        "props": {
+                            "className": "mt-6 bg-amber-50 dark:bg-amber-900/20 border border-amber-200 dark:border-amber-700 rounded-lg p-4"
+                        },
+                        "children": [
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": {
+                                    "className": "flex gap-3"
+                                },
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "Icon",
+                                        "props": {
+                                            "name": "triangle-exclamation",
+                                            "className": "w-5 h-5 text-amber-600 dark:text-amber-400 flex-shrink-0 mt-0.5"
+                                        }
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "H3",
+                                                "props": {
+                                                    "className": "text-sm font-semibold text-warning-soft"
+                                                },
+                                                "text": "$t:sirsoft-pay_nicepayments.settings.live_mode_warning_title"
+                                            },
+                                            {
+                                                "type": "basic",
+                                                "name": "P",
+                                                "props": {
+                                                    "className": "mt-1 text-warning-soft"
+                                                },
+                                                "text": "$t:sirsoft-pay_nicepayments.settings.live_mode_warning_body"
+                                            }
+                                        ]
+                                    }
+                                ]
+                            }
+                        ]
+                    },
+                    {
+                        "id": "live_keys_section",
+                        "type": "basic",
+                        "name": "Div",
+                        "props": {
+                            "className": "mt-6 bg-white dark:bg-gray-800 rounded-lg shadow-sm border border-gray-200 dark:border-gray-700"
+                        },
+                        "children": [
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": {
+                                    "className": "panel-header-row"
+                                },
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "H3",
+                                        "props": {
+                                            "className": "text-error-strong"
+                                        },
+                                        "text": "$t:sirsoft-pay_nicepayments.settings.section_live_keys"
+                                    }
+                                ]
+                            },
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": {
+                                    "className": "p-6 space-y-6"
+                                },
+                                "children": [
+                                    {
+                                        "id": "field_live_mid",
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "section-heading-md"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "props": {
+                                                    "className": "lg:col-span-1"
+                                                },
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Label",
+                                                        "props": {
+                                                            "className": "form-label"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nicepayments.settings.live_mid"
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "P",
+                                                        "props": {
+                                                            "className": "form-hint"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nicepayments.settings.live_mid_hint"
+                                                    }
+                                                ]
+                                            },
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "props": {
+                                                    "className": "lg:col-span-2"
+                                                },
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Div",
+                                                        "props": {
+                                                            "className": "flex rounded-lg border border-gray-300 dark:border-gray-600 overflow-hidden focus-within:ring-2 focus-within:ring-blue-500 dark:focus-within:ring-blue-400 focus-within:border-transparent"
+                                                        },
+                                                        "children": [
+                                                            {
+                                                                "type": "basic",
+                                                                "name": "Span",
+                                                                "props": {
+                                                                    "className": "inline-flex items-center px-3 bg-gray-100 dark:bg-gray-600 border-r border-gray-300 dark:border-gray-600 text-body font-mono font-bold select-none"
+                                                                },
+                                                                "text": "SR"
+                                                            },
+                                                            {
+                                                                "type": "basic",
+                                                                "name": "Input",
+                                                                "props": {
+                                                                    "type": "text",
+                                                                    "name": "live_mid",
+                                                                    "placeholder": "paytestm",
+                                                                    "className": "flex-1 font-mono outline-none border-0"
+                                                                }
+                                                            }
+                                                        ]
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "P",
+                                                        "props": {
+                                                            "className": "mt-1.5 text-tertiary"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nicepayments.settings.live_mid_example"
+                                                    }
+                                                ]
+                                            }
+                                        ]
+                                    },
+                                    {
+                                        "id": "field_live_merchant_key",
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "section-heading-md"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "props": {
+                                                    "className": "lg:col-span-1"
+                                                },
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Label",
+                                                        "props": {
+                                                            "className": "form-label"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nicepayments.settings.live_merchant_key"
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "P",
+                                                        "props": {
+                                                            "className": "form-hint"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nicepayments.settings.live_merchant_key_hint"
+                                                    }
+                                                ]
+                                            },
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "props": {
+                                                    "className": "lg:col-span-2"
+                                                },
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Input",
+                                                        "props": {
+                                                            "type": "password",
+                                                            "name": "live_merchant_key",
+                                                            "placeholder": "live_key_...",
+                                                            "className": "dark:focus:ring-blue-400 focus:border-transparent font-mono"
+                                                        }
+                                                    }
+                                                ]
+                                            }
+                                        ]
+                                    }
+                                ]
+                            }
+                        ]
+                    },
+                    {
+                        "id": "redirect_section",
+                        "type": "basic",
+                        "name": "Div",
+                        "props": {
+                            "className": "mt-6 bg-white dark:bg-gray-800 rounded-lg shadow-sm border border-gray-200 dark:border-gray-700"
+                        },
+                        "children": [
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": {
+                                    "className": "panel-header-row"
+                                },
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "H3",
+                                        "props": {
+                                            "className": "text-error-strong"
+                                        },
+                                        "text": "$t:sirsoft-pay_nicepayments.settings.section_redirect"
+                                    }
+                                ]
+                            },
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": {
+                                    "className": "p-6 space-y-6"
+                                },
+                                "children": [
+                                    {
+                                        "id": "field_redirect_success_url",
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "section-heading-md"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "props": {
+                                                    "className": "lg:col-span-1"
+                                                },
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Label",
+                                                        "props": {
+                                                            "className": "form-label"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nicepayments.settings.redirect_success_url"
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "P",
+                                                        "props": {
+                                                            "className": "form-hint"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nicepayments.settings.redirect_success_url_hint"
+                                                    }
+                                                ]
+                                            },
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "props": {
+                                                    "className": "lg:col-span-2"
+                                                },
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Input",
+                                                        "props": {
+                                                            "type": "text",
+                                                            "name": "redirect_success_url",
+                                                            "placeholder": "/shop/orders/{orderId}/complete",
+                                                            "className": "dark:focus:ring-blue-400 focus:border-transparent"
+                                                        }
+                                                    }
+                                                ]
+                                            }
+                                        ]
+                                    },
+                                    {
+                                        "id": "field_redirect_fail_url",
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "section-heading-md"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "props": {
+                                                    "className": "lg:col-span-1"
+                                                },
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Label",
+                                                        "props": {
+                                                            "className": "form-label"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nicepayments.settings.redirect_fail_url"
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "P",
+                                                        "props": {
+                                                            "className": "form-hint"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nicepayments.settings.redirect_fail_url_hint"
+                                                    }
+                                                ]
+                                            },
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "props": {
+                                                    "className": "lg:col-span-2"
+                                                },
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Input",
+                                                        "props": {
+                                                            "type": "text",
+                                                            "name": "redirect_fail_url",
+                                                            "placeholder": "/shop/checkout",
+                                                            "className": "dark:focus:ring-blue-400 focus:border-transparent"
+                                                        }
+                                                    }
+                                                ]
+                                            }
+                                        ]
+                                    }
+                                ]
+                            }
+                        ]
+                    },
+                    {
+                        "id": "vbank_notify_section",
+                        "type": "basic",
+                        "name": "Div",
+                        "props": {
+                            "className": "mt-6 bg-white dark:bg-gray-800 rounded-lg shadow-sm border border-blue-200 dark:border-blue-800"
+                        },
+                        "children": [
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": {
+                                    "className": "px-6 py-4 border-b border-blue-200 dark:border-blue-800 bg-blue-50 dark:bg-blue-900/20 rounded-t-lg"
+                                },
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "flex-center gap-2"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Icon",
+                                                "props": {
+                                                    "name": "bell",
+                                                    "className": "w-4 h-4 text-blue-600 dark:text-blue-400"
+                                                }
+                                            },
+                                            {
+                                                "type": "basic",
+                                                "name": "H3",
+                                                "props": {
+                                                    "className": "text-base font-semibold text-blue-900 dark:text-blue-100"
+                                                },
+                                                "text": "$t:sirsoft-pay_nicepayments.settings.section_vbank_notify"
+                                            }
+                                        ]
+                                    }
+                                ]
+                            },
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": {
+                                    "className": "p-6"
+                                },
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "P",
+                                        "props": {
+                                            "className": "text-label mb-3"
+                                        },
+                                        "text": "$t:sirsoft-pay_nicepayments.settings.vbank_notify_hint"
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "flex-center gap-2"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Input",
+                                                "props": {
+                                                    "type": "text",
+                                                    "readOnly": true,
+                                                    "value": "{{_local.vbankInfo?.url ?? '/plugins/sirsoft-pay_nicepayments/payment/vbank-notify'}}",
+                                                    "className": "input-readonly flex-1 font-mono"
+                                                }
+                                            },
+                                            {
+                                                "type": "basic",
+                                                "name": "Button",
+                                                "props": {
+                                                    "className": "flex-center gap-1.5 px-3 py-2 bg-gray-100 dark:bg-gray-700 hover:bg-gray-200 dark:hover:bg-gray-600 text-body border border-gray-300 dark:border-gray-600 rounded-lg font-medium transition-colors whitespace-nowrap"
+                                                },
+                                                "actions": [
+                                                    {
+                                                        "type": "click",
+                                                        "handler": "sequence",
+                                                        "actions": [
+                                                            {
+                                                                "handler": "copyToClipboard",
+                                                                "params": {
+                                                                    "text": "{{_local.vbankInfo?.url ?? '/plugins/sirsoft-pay_nicepayments/payment/vbank-notify'}}"
+                                                                }
+                                                            },
+                                                            {
+                                                                "handler": "toast",
+                                                                "params": {
+                                                                    "type": "success",
+                                                                    "message": "$t:sirsoft-pay_nicepayments.settings.vbank_notify_copied"
+                                                                }
+                                                            }
+                                                        ]
+                                                    }
+                                                ],
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Icon",
+                                                        "props": {
+                                                            "name": "copy",
+                                                            "className": "w-4 h-4"
+                                                        }
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Span",
+                                                        "text": "$t:sirsoft-pay_nicepayments.settings.copy"
+                                                    }
+                                                ]
+                                            }
+                                        ]
+                                    }
+                                ]
+                            }
+                        ]
+                    },
+                    {
+                        "id": "escrow_section",
+                        "type": "basic",
+                        "name": "Div",
+                        "props": {
+                            "className": "mt-6 bg-white dark:bg-gray-800 rounded-lg shadow-sm border border-gray-200 dark:border-gray-700"
+                        },
+                        "children": [
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": {
+                                    "className": "p-6"
+                                },
+                                "children": [
+                                    {
+                                        "id": "field_use_escrow",
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "flex items-center justify-between"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Label",
+                                                        "props": {
+                                                            "className": "form-label"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nicepayments.settings.use_escrow"
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "P",
+                                                        "props": {
+                                                            "className": "form-hint"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nicepayments.settings.use_escrow_hint"
+                                                    }
+                                                ]
+                                            },
+                                            {
+                                                "type": "composite",
+                                                "name": "Toggle",
+                                                "props": {
+                                                    "name": "use_escrow"
+                                                }
+                                            }
+                                        ]
+                                    }
+                                ]
+                            }
+                        ]
+                    },
+                    {
+                        "id": "easy_pay_section",
+                        "_comment_hidden": "간편결제는 차후 오픈 예정 — 현재는 렌더링 차단. 오픈 시 if 키 제거하면 복원됨.",
+                        "if": "{{false}}",
+                        "type": "basic",
+                        "name": "Div",
+                        "props": {
+                            "className": "mt-6 bg-white dark:bg-gray-800 rounded-lg shadow-sm border border-gray-200 dark:border-gray-700"
+                        },
+                        "children": [
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": {
+                                    "className": "panel-header-row"
+                                },
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "H3",
+                                        "props": {
+                                            "className": "text-error-strong"
+                                        },
+                                        "text": "$t:sirsoft-pay_nicepayments.settings.section_easy_pay"
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "P",
+                                        "props": {
+                                            "className": "form-hint"
+                                        },
+                                        "text": "$t:sirsoft-pay_nicepayments.settings.section_easy_pay_hint"
+                                    }
+                                ]
+                            },
+                            {
+                                "type": "basic",
+                                "name": "Div",
+                                "props": {
+                                    "className": "divide-y divide-gray-100 dark:divide-gray-700"
+                                },
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "flex items-center justify-between px-6 py-4 bg-blue-50 dark:bg-blue-900/20"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Label",
+                                                        "props": {
+                                                            "className": "form-label"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nicepayments.settings.easy_pay_allow_with_other_pg"
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "P",
+                                                        "props": {
+                                                            "className": "mt-0.5 text-tertiary"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nicepayments.settings.easy_pay_allow_with_other_pg_hint"
+                                                    }
+                                                ]
+                                            },
+                                            {
+                                                "type": "composite",
+                                                "name": "Toggle",
+                                                "props": {
+                                                    "name": "easy_pay_allow_with_other_pg"
+                                                }
+                                            }
+                                        ]
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "flex items-center justify-between px-6 py-4"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Label",
+                                                        "props": {
+                                                            "className": "form-label"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nicepayments.settings.easy_pay_naverpay"
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "P",
+                                                        "props": {
+                                                            "className": "mt-0.5 text-xs text-green-600 dark:text-green-400"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nicepayments.settings.easy_pay_naverpay_hint"
+                                                    }
+                                                ]
+                                            },
+                                            {
+                                                "type": "composite",
+                                                "name": "Toggle",
+                                                "props": {
+                                                    "name": "easy_pay_naverpay"
+                                                }
+                                            }
+                                        ]
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "flex items-center justify-between px-6 py-4"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Label",
+                                                "props": {
+                                                    "className": "form-label"
+                                                },
+                                                "text": "$t:sirsoft-pay_nicepayments.settings.easy_pay_kakaopay"
+                                            },
+                                            {
+                                                "type": "composite",
+                                                "name": "Toggle",
+                                                "props": {
+                                                    "name": "easy_pay_kakaopay"
+                                                }
+                                            }
+                                        ]
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "flex items-center justify-between px-6 py-4"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Label",
+                                                "props": {
+                                                    "className": "form-label"
+                                                },
+                                                "text": "$t:sirsoft-pay_nicepayments.settings.easy_pay_samsungpay"
+                                            },
+                                            {
+                                                "type": "composite",
+                                                "name": "Toggle",
+                                                "props": {
+                                                    "name": "easy_pay_samsungpay"
+                                                }
+                                            }
+                                        ]
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "flex items-center justify-between px-6 py-4"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Div",
+                                                "children": [
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "Label",
+                                                        "props": {
+                                                            "className": "form-label"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nicepayments.settings.easy_pay_applepay"
+                                                    },
+                                                    {
+                                                        "type": "basic",
+                                                        "name": "P",
+                                                        "props": {
+                                                            "className": "mt-0.5 text-tertiary"
+                                                        },
+                                                        "text": "$t:sirsoft-pay_nicepayments.settings.easy_pay_applepay_hint"
+                                                    }
+                                                ]
+                                            },
+                                            {
+                                                "type": "composite",
+                                                "name": "Toggle",
+                                                "props": {
+                                                    "name": "easy_pay_applepay"
+                                                }
+                                            }
+                                        ]
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "flex items-center justify-between px-6 py-4"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Label",
+                                                "props": {
+                                                    "className": "form-label"
+                                                },
+                                                "text": "$t:sirsoft-pay_nicepayments.settings.easy_pay_payco"
+                                            },
+                                            {
+                                                "type": "composite",
+                                                "name": "Toggle",
+                                                "props": {
+                                                    "name": "easy_pay_payco"
+                                                }
+                                            }
+                                        ]
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "flex items-center justify-between px-6 py-4"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Label",
+                                                "props": {
+                                                    "className": "form-label"
+                                                },
+                                                "text": "$t:sirsoft-pay_nicepayments.settings.easy_pay_skpay"
+                                            },
+                                            {
+                                                "type": "composite",
+                                                "name": "Toggle",
+                                                "props": {
+                                                    "name": "easy_pay_skpay"
+                                                }
+                                            }
+                                        ]
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "flex items-center justify-between px-6 py-4"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Label",
+                                                "props": {
+                                                    "className": "form-label"
+                                                },
+                                                "text": "$t:sirsoft-pay_nicepayments.settings.easy_pay_ssgpay"
+                                            },
+                                            {
+                                                "type": "composite",
+                                                "name": "Toggle",
+                                                "props": {
+                                                    "name": "easy_pay_ssgpay"
+                                                }
+                                            }
+                                        ]
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "Div",
+                                        "props": {
+                                            "className": "flex items-center justify-between px-6 py-4"
+                                        },
+                                        "children": [
+                                            {
+                                                "type": "basic",
+                                                "name": "Label",
+                                                "props": {
+                                                    "className": "form-label"
+                                                },
+                                                "text": "$t:sirsoft-pay_nicepayments.settings.easy_pay_lpay"
+                                            },
+                                            {
+                                                "type": "composite",
+                                                "name": "Toggle",
+                                                "props": {
+                                                    "name": "easy_pay_lpay"
+                                                }
+                                            }
+                                        ]
+                                    }
+                                ]
+                            }
+                        ]
+                    },
+                    {
+                        "id": "footer_buttons",
+                        "type": "basic",
+                        "name": "Div",
+                        "props": {
+                            "className": "sticky bottom-0 z-10 flex justify-end items-center gap-3 mt-6 px-4 py-3 bg-gray-50 border border-gray-200 rounded-lg dark:bg-gray-800 dark:border-gray-700"
+                        },
+                        "children": [
+                            {
+                                "id": "cancel_button",
+                                "type": "basic",
+                                "name": "Button",
+                                "props": {
+                                    "className": "btn btn-secondary"
+                                },
+                                "actions": [
+                                    {
+                                        "type": "click",
+                                        "handler": "navigate",
+                                        "params": {
+                                            "path": "/admin/plugins"
+                                        }
+                                    }
+                                ],
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "Span",
+                                        "text": "$t:common.cancel"
+                                    }
+                                ]
+                            },
+                            {
+                                "id": "save_button",
+                                "type": "basic",
+                                "name": "Button",
+                                "props": {
+                                    "disabled": "{{!_local.hasChanges || _local.isSaving}}",
+                                    "className": "btn btn-primary flex-center gap-1.5"
+                                },
+                                "actions": [
+                                    {
+                                        "type": "click",
+                                        "handler": "sequence",
+                                        "actions": [
+                                            {
+                                                "handler": "setState",
+                                                "params": {
+                                                    "target": "local",
+                                                    "isSaving": true,
+                                                    "errors": null
+                                                }
+                                            },
+                                            {
+                                                "handler": "apiCall",
+                                                "auth_required": true,
+                                                "target": "/api/admin/plugins/{{route.identifier}}/settings",
+                                                "params": {
+                                                    "method": "PUT",
+                                                    "body": "{{_local.form}}"
+                                                },
+                                                "onSuccess": [
+                                                    {
+                                                        "handler": "setState",
+                                                        "params": {
+                                                            "target": "local",
+                                                            "isSaving": false,
+                                                            "hasChanges": false
+                                                        }
+                                                    },
+                                                    {
+                                                        "handler": "toast",
+                                                        "params": {
+                                                            "type": "success",
+                                                            "message": "$t:admin.plugins.settings.save_success"
+                                                        }
+                                                    },
+                                                    {
+                                                        "handler": "refetchDataSource",
+                                                        "params": {
+                                                            "dataSourceId": "settings"
+                                                        }
+                                                    }
+                                                ],
+                                                "onError": [
+                                                    {
+                                                        "handler": "setState",
+                                                        "params": {
+                                                            "target": "local",
+                                                            "isSaving": false,
+                                                            "errors": "{{$error.errors}}"
+                                                        }
+                                                    },
+                                                    {
+                                                        "handler": "toast",
+                                                        "params": {
+                                                            "type": "error",
+                                                            "message": "$t:admin.plugins.settings.save_error"
+                                                        }
+                                                    }
+                                                ]
+                                            }
+                                        ]
+                                    }
+                                ],
+                                "children": [
+                                    {
+                                        "type": "basic",
+                                        "name": "Icon",
+                                        "if": "{{_local.isSaving}}",
+                                        "props": {
+                                            "name": "spinner",
+                                            "className": "spinner-sm"
+                                        }
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "Span",
+                                        "if": "{{!_local.isSaving}}",
+                                        "text": "$t:common.save"
+                                    },
+                                    {
+                                        "type": "basic",
+                                        "name": "Span",
+                                        "if": "{{_local.isSaving}}",
+                                        "text": "$t:common.saving"
+                                    }
+                                ]
+                            }
+                        ]
+                    }
+                ]
+            }
+        ]
+    }
+}
\ No newline at end of file
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/src/Concerns/IssuesReceiptCookie.php b/plugins/_bundled/sirsoft-pay_nicepayments/src/Concerns/IssuesReceiptCookie.php
new file mode 100644
index 00000000..8c690d1c
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/src/Concerns/IssuesReceiptCookie.php
@@ -0,0 +1,69 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Concerns;
+
+use Illuminate\Cookie\CookieJar;
+use Symfony\Component\HttpFoundation\Cookie;
+
+trait IssuesReceiptCookie
+{
+    public const RECEIPT_COOKIE_NAME = 'nicepayments_receipt_token';
+    private const RECEIPT_COOKIE_TTL_MINUTES = 5;
+
+    protected function queueReceiptCookie(string $orderNumber): void
+    {
+        $expiresTs = time() + (self::RECEIPT_COOKIE_TTL_MINUTES * 60);
+        $signature = $this->signReceiptToken($orderNumber, $expiresTs);
+        $tokenValue = $orderNumber.'|'.$expiresTs.'|'.$signature;
+
+        /** @var CookieJar $jar */
+        $jar = app(CookieJar::class);
+
+        $jar->queue(new Cookie(
+            name: self::RECEIPT_COOKIE_NAME,
+            value: $tokenValue,
+            expire: $expiresTs,
+            path: '/',
+            domain: null,
+            secure: request()->isSecure(),
+            httpOnly: true,
+            raw: false,
+            sameSite: Cookie::SAMESITE_LAX,
+        ));
+    }
+
+    protected function verifyReceiptCookie(?string $cookieValue, string $expectedOrderNumber): bool
+    {
+        if (! is_string($cookieValue) || $cookieValue === '') {
+            return false;
+        }
+
+        $parts = explode('|', $cookieValue);
+        if (count($parts) !== 3) {
+            return false;
+        }
+
+        [$orderNumber, $expiresTs, $signature] = $parts;
+
+        if ($orderNumber !== $expectedOrderNumber) {
+            return false;
+        }
+
+        if (! ctype_digit($expiresTs) || (int) $expiresTs < time()) {
+            return false;
+        }
+
+        if (! ctype_xdigit($signature) || strlen($signature) !== 64) {
+            return false;
+        }
+
+        return hash_equals($this->signReceiptToken($orderNumber, (int) $expiresTs), $signature);
+    }
+
+    private function signReceiptToken(string $orderNumber, int $expiresTs): string
+    {
+        return hash_hmac('sha256', $orderNumber.'|'.$expiresTs, (string) config('app.key', ''));
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/src/Concerns/PreventsReplayCallback.php b/plugins/_bundled/sirsoft-pay_nicepayments/src/Concerns/PreventsReplayCallback.php
new file mode 100644
index 00000000..82920d1b
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/src/Concerns/PreventsReplayCallback.php
@@ -0,0 +1,57 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Concerns;
+
+use Illuminate\Support\Facades\Log;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentStatusEnum;
+use Modules\Sirsoft\Ecommerce\Models\OrderPayment;
+
+/**
+ * Plugin 측 replay attack 방어 — 동일 PG 거래 ID 의 중복 콜백을 멱등 처리.
+ *
+ * `g7_ecommerce_order_payments.transaction_id` 컬럼은 DB unique 제약이 없으므로
+ * 동일 transaction_id 로 콜백이 두 번 도착하면 두 번 `completePayment()` 가
+ * 실행되어 중복 처리될 위험이 있다 (예: 결제완료 알림 중복, 마일리지 중복 적립).
+ *
+ * 본 트레이트는 콜백 진입 시점에 OrderPayment 를 조회하여 이미 `paid` 상태이면
+ * 멱등 분기로 조기 리턴하도록 한다. modules 영역의 schema 는 변경하지 않고
+ * plugin scope 내에서만 처리한다.
+ */
+trait PreventsReplayCallback
+{
+    /**
+     * 동일 transaction_id 가 이미 paid 상태로 저장되었는지 확인.
+     *
+     * @param  string|null  $transactionId  PG 거래 ID (NICE: tid)
+     * @return bool true 면 중복 콜백 — 멱등 응답으로 처리해야 함
+     */
+    protected function wasAlreadyPaid(?string $transactionId): bool
+    {
+        if ($transactionId === null || $transactionId === '') {
+            return false;
+        }
+
+        return OrderPayment::query()
+            ->where('transaction_id', $transactionId)
+            ->where('payment_status', PaymentStatusEnum::PAID)
+            ->exists();
+    }
+
+    /**
+     * Replay 감지를 로깅. 통일된 로그 형식으로 운영 모니터링 용이성 확보.
+     *
+     * @param  string  $tid  PG 거래 ID
+     * @param  string|null  $moid  주문번호 (있을 경우)
+     * @param  string  $context  콜백 종류
+     */
+    protected function logReplayDetected(string $tid, ?string $moid, string $context): void
+    {
+        Log::info('NICE: replay detected — already paid, returning idempotent response', [
+            'tid'     => $tid,
+            'moid'    => $moid,
+            'context' => $context,
+        ]);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/src/Concerns/RecordsPaymentWindowClosure.php b/plugins/_bundled/sirsoft-pay_nicepayments/src/Concerns/RecordsPaymentWindowClosure.php
new file mode 100644
index 00000000..12ca61ba
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/src/Concerns/RecordsPaymentWindowClosure.php
@@ -0,0 +1,128 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Concerns;
+
+use InvalidArgumentException;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Log;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentStatusEnum;
+use Modules\Sirsoft\Ecommerce\Models\Order;
+use Modules\Sirsoft\Ecommerce\Models\OrderAddress;
+use Modules\Sirsoft\Ecommerce\Services\CurrencyConversionService;
+use Modules\Sirsoft\Ecommerce\Services\OrderProcessingService;
+
+trait RecordsPaymentWindowClosure
+{
+    protected function expectedPaymentPrice(Order $order): int
+    {
+        // 결제 청구액 SSoT = 결제 통화(order_currency) 환산액. base(total_due_amount) 직접 비교 시
+        // base≠결제 통화에서 PG 청구 통화와 단위가 어긋난다(buildPgPaymentData 와 동일 기준).
+        return app(CurrencyConversionService::class)->resolveOrderPaymentChargeAmount($order);
+    }
+
+    protected function resolveExpectedPaymentPriceOrNull(Order $order, string $context, array $logContext = []): ?int
+    {
+        try {
+            return $this->expectedPaymentPrice($order);
+        } catch (InvalidArgumentException $e) {
+            $this->logInvalidPaymentCurrency($order, $e, $context, $logContext);
+
+            return null;
+        }
+    }
+
+    protected function invalidPaymentCurrencyFailureMessage(InvalidArgumentException $e): string
+    {
+        $message = trim($e->getMessage());
+
+        return $message !== ''
+            ? $message
+            : '나이스페이먼츠 결제 통화 환율 설정이 올바르지 않습니다.';
+    }
+
+    protected function logInvalidPaymentCurrency(
+        Order $order,
+        InvalidArgumentException $e,
+        string $context,
+        array $logContext = [],
+    ): void {
+        Log::error('NicePayments: payment currency is not chargeable', array_merge([
+            'context' => $context,
+            'order_id' => $order->id,
+            'order_number' => $order->order_number,
+            'currency' => $order->currency,
+            'currency_snapshot' => $order->currency_snapshot,
+            'error' => $e->getMessage(),
+        ], $logContext));
+    }
+
+    protected function requestMatchesOrderBuyer(Request $request, Order $order): bool
+    {
+        /** @var OrderAddress|null $address */
+        $address = $order->shippingAddress;
+        if (! $address) {
+            return true;
+        }
+
+        $expectedEmail = strtolower(trim((string) $address->orderer_email));
+        if ($expectedEmail !== '') {
+            $receivedEmail = strtolower(trim((string) $request->input('buyer_email', '')));
+            if ($receivedEmail === '' || $receivedEmail !== $expectedEmail) {
+                return false;
+            }
+        }
+
+        $expectedPhone = $this->digitsOnly((string) $address->orderer_phone);
+        if ($expectedPhone !== '') {
+            $receivedPhone = $this->digitsOnly((string) $request->input('buyer_phone', ''));
+            if ($receivedPhone === '' || $receivedPhone !== $expectedPhone) {
+                return false;
+            }
+        }
+
+        return true;
+    }
+
+    protected function markPaymentWindowClosed(
+        OrderProcessingService $orderService,
+        Order $order,
+        string $failureCode,
+        string $failureMessage,
+        ?string $cancelMessage = null,
+    ): Order {
+        if (! $order->order_status->isBeforePayment()) {
+            return $order;
+        }
+
+        $failedOrder = $orderService->failPayment($order, $failureCode, $failureMessage);
+
+        return $this->markNicePaymentFailed($failedOrder, $failureCode, $failureMessage);
+    }
+
+    protected function markNicePaymentFailed(Order $order, string $failureCode, string $failureMessage): Order
+    {
+        $payment = $order->payment()->first();
+        if (! $payment) {
+            return $order;
+        }
+
+        $payment->update([
+            'payment_status' => PaymentStatusEnum::FAILED->value,
+            'payment_meta' => array_merge($payment->payment_meta ?? [], [
+                'failure_code' => $failureCode,
+                'failure_message' => $failureMessage,
+                'failed_at' => now()->toIso8601String(),
+                'failure_source' => 'nicepayments',
+            ]),
+        ]);
+
+        return $order->fresh();
+    }
+
+    protected function digitsOnly(string $value): string
+    {
+        return preg_replace('/[^0-9]/', '', $value) ?? '';
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/src/Concerns/ResolvesEasyPayDisplay.php b/plugins/_bundled/sirsoft-pay_nicepayments/src/Concerns/ResolvesEasyPayDisplay.php
new file mode 100644
index 00000000..6184513b
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/src/Concerns/ResolvesEasyPayDisplay.php
@@ -0,0 +1,227 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Concerns;
+
+use Modules\Sirsoft\Ecommerce\Enums\PaymentMethodEnum;
+
+trait ResolvesEasyPayDisplay
+{
+    private const EASY_PAY_METHODS = [
+        'nicepay_naverpay' => [
+            'provider' => 'naverpay',
+            'label' => ['ko' => '네이버페이', 'en' => 'NaverPay'],
+        ],
+        'nicepay_kakaopay' => [
+            'provider' => 'kakaopay',
+            'label' => ['ko' => '카카오페이', 'en' => 'KakaoPay'],
+        ],
+        'nicepay_samsungpay' => [
+            'provider' => 'samsungpay',
+            'label' => ['ko' => '삼성페이', 'en' => 'Samsung Pay'],
+        ],
+        'nicepay_applepay' => [
+            'provider' => 'applepay',
+            'label' => ['ko' => '애플페이', 'en' => 'Apple Pay'],
+        ],
+        'nicepay_payco' => [
+            'provider' => 'payco',
+            'label' => ['ko' => 'PAYCO (페이코)', 'en' => 'PAYCO'],
+        ],
+        'nicepay_skpay' => [
+            'provider' => 'skpay',
+            'label' => ['ko' => 'SK pay', 'en' => 'SK pay'],
+        ],
+        'nicepay_ssgpay' => [
+            'provider' => 'ssgpay',
+            'label' => ['ko' => 'SSG PAY', 'en' => 'SSG PAY'],
+        ],
+        'nicepay_lpay' => [
+            'provider' => 'lpay',
+            'label' => ['ko' => 'L.pay', 'en' => 'L.pay'],
+        ],
+    ];
+
+    /**
+     * @return array{method: string, provider: string, label: array{ko: string, en: string}}|array{}
+     */
+    protected function resolveEasyPayMeta(array $payload): array
+    {
+        $method = $this->resolveEasyPayMethod($payload);
+        if ($method === null || ! isset(self::EASY_PAY_METHODS[$method])) {
+            return [];
+        }
+
+        $definition = self::EASY_PAY_METHODS[$method];
+
+        return [
+            'method' => $method,
+            'provider' => $definition['provider'],
+            'label' => $definition['label'],
+        ];
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    protected function decodePaymentMeta(mixed $paymentMeta): array
+    {
+        if (is_array($paymentMeta)) {
+            return $paymentMeta;
+        }
+
+        if (! is_string($paymentMeta) || trim($paymentMeta) === '') {
+            return [];
+        }
+
+        $decoded = json_decode($paymentMeta, true);
+
+        return is_array($decoded) ? $decoded : [];
+    }
+
+    /**
+     * @return array{
+     *     payment_method_label: string|null,
+     *     payment_method_display_label: string|null,
+     *     selected_payment_method: string|null,
+     *     embedded_pg_provider: string|null,
+     *     embedded_pg_provider_label: string|null
+     * }
+     */
+    protected function resolvePaymentDisplay(object $payment): array
+    {
+        $paymentMeta = $this->decodePaymentMeta($payment->payment_meta ?? null);
+        $selectedPaymentMethod = $this->stringOrNull($paymentMeta['nicepay_easy_pay_method'] ?? null);
+        $provider = $this->stringOrNull(
+            $payment->embedded_pg_provider
+                ?? $paymentMeta['nicepay_easy_pay_provider']
+                ?? $paymentMeta['embedded_pg_provider']
+                ?? null
+        );
+
+        if ($provider === null && $selectedPaymentMethod !== null) {
+            $provider = $this->stringOrNull(self::EASY_PAY_METHODS[$selectedPaymentMethod]['provider'] ?? null);
+        }
+
+        $baseLabel = $this->paymentMethodLabel($this->stringOrNull($payment->payment_method ?? null));
+        $embeddedLabel = $this->embeddedPgProviderLabel($provider, $paymentMeta);
+
+        return [
+            'payment_method_label' => $baseLabel,
+            'payment_method_display_label' => $this->paymentMethodDisplayLabel($baseLabel, $embeddedLabel),
+            'selected_payment_method' => $selectedPaymentMethod,
+            'embedded_pg_provider' => $provider,
+            'embedded_pg_provider_label' => $embeddedLabel,
+        ];
+    }
+
+    protected function paymentMethodLabel(?string $method): ?string
+    {
+        if ($method === null || $method === '') {
+            return null;
+        }
+
+        return PaymentMethodEnum::tryFrom($method)?->label() ?? $method;
+    }
+
+    protected function paymentMethodDisplayLabel(?string $baseLabel, ?string $embeddedLabel): ?string
+    {
+        if ($baseLabel === null || $baseLabel === '') {
+            return $embeddedLabel;
+        }
+
+        if ($embeddedLabel === null || $embeddedLabel === '') {
+            return $baseLabel;
+        }
+
+        return $embeddedLabel . ' (' . $baseLabel . ')';
+    }
+
+    /**
+     * @param array<string, mixed> $paymentMeta
+     */
+    protected function embeddedPgProviderLabel(?string $provider, array $paymentMeta = []): ?string
+    {
+        $metaLabel = $this->localizedLabel($paymentMeta['nicepay_easy_pay_label'] ?? null)
+            ?? $this->localizedLabel($paymentMeta['embedded_pg_provider_label'] ?? null);
+
+        if ($metaLabel !== null) {
+            return $metaLabel;
+        }
+
+        if ($provider === null || $provider === '') {
+            return null;
+        }
+
+        foreach (self::EASY_PAY_METHODS as $definition) {
+            if (($definition['provider'] ?? null) === $provider) {
+                return $this->localizedLabel($definition['label'] ?? null);
+            }
+        }
+
+        return null;
+    }
+
+    /**
+     * @param array<string, mixed> $payload
+     */
+    private function resolveEasyPayMethod(array $payload): ?string
+    {
+        foreach (['nicepay_easy_pay_method', 'MallReserved1'] as $key) {
+            $method = $this->stringOrNull($payload[$key] ?? null);
+            if ($method !== null && isset(self::EASY_PAY_METHODS[$method])) {
+                return $method;
+            }
+        }
+
+        $mallReserved = $this->stringOrNull($payload['MallReserved'] ?? null);
+        if ($mallReserved === null) {
+            return null;
+        }
+
+        $decoded = json_decode($mallReserved, true);
+        if (is_array($decoded)) {
+            $method = $this->stringOrNull($decoded['nicepay_easy_pay_method'] ?? null);
+            if ($method !== null && isset(self::EASY_PAY_METHODS[$method])) {
+                return $method;
+            }
+        }
+
+        parse_str($mallReserved, $parsed);
+        $method = $this->stringOrNull($parsed['nicepay_easy_pay_method'] ?? null);
+        if ($method !== null && isset(self::EASY_PAY_METHODS[$method])) {
+            return $method;
+        }
+
+        return isset(self::EASY_PAY_METHODS[$mallReserved]) ? $mallReserved : null;
+    }
+
+    private function localizedLabel(mixed $label): ?string
+    {
+        if (is_string($label) && trim($label) !== '') {
+            return $label;
+        }
+
+        if (! is_array($label)) {
+            return null;
+        }
+
+        $locale = app()->getLocale();
+
+        return $this->stringOrNull($label[$locale] ?? null)
+            ?? $this->stringOrNull($label['ko'] ?? null)
+            ?? $this->stringOrNull($label['en'] ?? null);
+    }
+
+    private function stringOrNull(mixed $value): ?string
+    {
+        if (! is_string($value)) {
+            return null;
+        }
+
+        $value = trim($value);
+
+        return $value === '' ? null : $value;
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/src/Concerns/SanitizesPgResponse.php b/plugins/_bundled/sirsoft-pay_nicepayments/src/Concerns/SanitizesPgResponse.php
new file mode 100644
index 00000000..52f30f1e
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/src/Concerns/SanitizesPgResponse.php
@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Concerns;
+
+trait SanitizesPgResponse
+{
+    /**
+     * PG 응답 원문 대신 운영에 필요한 필드만 남긴다.
+     *
+     * 구매자명/연락처/카드번호/가상계좌번호처럼 PG 응답에 섞일 수 있는 민감 필드는
+     * whitelist 에 넣지 않는 방식으로 차단한다. 기존 관리자 조회 호환을 위해
+     * payment_meta.pg_raw_response 키는 유지하되 내용은 sanitized subset 이다.
+     */
+    protected function sanitizePgResponse(array $response, array $allowedKeys): array
+    {
+        $allowed = array_flip($allowedKeys);
+        $sanitized = [];
+
+        foreach ($response as $key => $value) {
+            if (! isset($allowed[$key])) {
+                continue;
+            }
+
+            $sanitized[$key] = is_scalar($value) || $value === null
+                ? $value
+                : json_encode($value, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
+        }
+
+        return $sanitized;
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/src/Controllers/AdminEscrowController.php b/plugins/_bundled/sirsoft-pay_nicepayments/src/Controllers/AdminEscrowController.php
new file mode 100644
index 00000000..258c1b31
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/src/Controllers/AdminEscrowController.php
@@ -0,0 +1,132 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Controllers;
+
+use App\Helpers\ResponseHelper;
+use App\Http\Controllers\Api\Base\AdminBaseController;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Log;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentStatusEnum;
+use Modules\Sirsoft\Ecommerce\Models\OrderPayment;
+use Plugins\Sirsoft\PayNicepayments\Services\NicePaymentsApiService;
+
+class AdminEscrowController extends AdminBaseController
+{
+    public function __construct(
+        private readonly NicePaymentsApiService $apiService,
+    ) {
+        parent::__construct();
+    }
+
+    /**
+     * 주문의 에스크로 결제 목록 조회
+     *
+     * GET /api/plugins/sirsoft-pay_nicepayments/admin/orders/{orderNumber}/escrow-payments
+     */
+    /**
+     * 주문의 에스크로 결제 목록 조회
+     *
+     * 에스크로(EscrowYN=Y) 로 결제된 가상계좌/카드 결제 건들의 TID/금액/상태를 반환.
+     * 어드민 에스크로 배송 등록 화면에서 결제 선택 UI 데이터 소스로 사용.
+     *
+     * @param  string  $orderNumber  주문번호
+     * @return JsonResponse 에스크로 결제 목록
+     */
+    public function getEscrowPayments(string $orderNumber): JsonResponse
+    {
+        $payments = DB::table('ecommerce_order_payments')
+            ->join('ecommerce_orders', 'ecommerce_orders.id', '=', 'ecommerce_order_payments.order_id')
+            ->where('ecommerce_orders.order_number', $orderNumber)
+            ->where('ecommerce_order_payments.pg_provider', 'nicepayments')
+            ->where('ecommerce_order_payments.is_escrow', 1)
+            ->get(['ecommerce_order_payments.id', 'ecommerce_order_payments.transaction_id', 'ecommerce_order_payments.payment_method', 'ecommerce_order_payments.payment_status']);
+
+        return ResponseHelper::success('messages.success', [
+            'escrow_payments' => $payments->map(fn ($p) => [
+                'id' => $p->id,
+                'transaction_id' => $p->transaction_id,
+                'payment_method' => $p->payment_method,
+                'payment_status' => $p->payment_status,
+            ])->values()->all(),
+        ]);
+    }
+
+    /**
+     * 에스크로 배송 등록
+     *
+     * POST /api/plugins/sirsoft-pay_nicepayments/admin/escrow/register-delivery
+     */
+    /**
+     * 에스크로 배송 등록
+     *
+     * NicePay escrow_process.jsp 호출하여 배송 정보(택배사/송장번호/수령인 등)를
+     * NicePay 측에 등록. 등록 완료 시 구매자에게 자동으로 구매확정 안내가 발송됨.
+     *
+     * @param  Request  $request  배송 정보 폼
+     * @return JsonResponse 등록 결과 + ResultCode
+     */
+    public function registerDelivery(Request $request): JsonResponse
+    {
+        $validated = $request->validate([
+            'tid' => 'required|string',
+            'delivery_name' => 'required|string|max:100',
+            'tracking_number' => 'required|string|max:100',
+            'buyer_address' => 'required|string|max:200',
+            'register_name' => 'required|string|max:50',
+        ]);
+
+        try {
+            $payment = $this->findRegisterableEscrowPayment($validated['tid']);
+            if (! $payment) {
+                return ResponseHelper::error('messages.failed', 422, [
+                    'message' => ['Escrow payment not found for the requested NicePayments TID.'],
+                ]);
+            }
+
+            $this->useStoredCredentials($payment);
+
+            $result = $this->apiService->registerEscrowDelivery(
+                tid: $validated['tid'],
+                deliveryName: $validated['delivery_name'],
+                trackingNumber: $validated['tracking_number'],
+                buyerAddress: $validated['buyer_address'],
+                registerName: $validated['register_name'],
+            );
+
+            Log::info('NicePayments: escrow delivery registered', [
+                'tid' => $validated['tid'],
+                'delivery_name' => $validated['delivery_name'],
+                'tracking_number' => $validated['tracking_number'],
+            ]);
+
+            return ResponseHelper::success('messages.success', $result);
+        } catch (\Exception $e) {
+            return ResponseHelper::error($e->getMessage(), 502, null);
+        }
+    }
+
+    private function findRegisterableEscrowPayment(string $tid): ?OrderPayment
+    {
+        return OrderPayment::query()
+            ->where('pg_provider', 'nicepayments')
+            ->where('is_escrow', true)
+            ->where('payment_status', PaymentStatusEnum::PAID)
+            ->where('transaction_id', $tid)
+            ->first();
+    }
+
+    private function useStoredCredentials(OrderPayment $payment): void
+    {
+        $meta = $payment->payment_meta ?? [];
+        $mid = trim((string) ($meta['mid'] ?? ''));
+        if ($mid === '' || ! array_key_exists('is_test_mode', $meta)) {
+            return;
+        }
+
+        $this->apiService->useStoredCredentials((bool) $meta['is_test_mode'], $mid);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/src/Controllers/AdminOrderListController.php b/plugins/_bundled/sirsoft-pay_nicepayments/src/Controllers/AdminOrderListController.php
new file mode 100644
index 00000000..841bc581
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/src/Controllers/AdminOrderListController.php
@@ -0,0 +1,91 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Controllers;
+
+use App\Helpers\ResponseHelper;
+use App\Http\Controllers\Api\Base\AdminBaseController;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Support\Facades\DB;
+use Plugins\Sirsoft\PayNicepayments\Concerns\ResolvesEasyPayDisplay;
+
+class AdminOrderListController extends AdminBaseController
+{
+    use ResolvesEasyPayDisplay;
+
+    public function __construct()
+    {
+        parent::__construct();
+    }
+
+    /**
+     * 나이스페이먼츠 테스트 모드 주문 맵 반환
+     *
+     * 최근 6개월 이내 nicepayments 결제 주문 중 payment_meta.is_test_mode = true 인
+     * 주문번호를 { "order_number": true, ... } 맵으로 반환한다. 어드민 주문 목록에
+     * 테스트 결제 배지 표시용으로 사용된다.
+     *
+     * @return JsonResponse 테스트 모드 주문 맵
+     */
+    public function testModeMap(): JsonResponse
+    {
+        $rows = DB::table('ecommerce_orders as o')
+            ->join('ecommerce_order_payments as p', 'p.order_id', '=', 'o.id')
+            ->whereIn('p.pg_provider', ['nicepayments', 'nicepay'])
+            ->whereNotNull('p.payment_meta')
+            ->where('p.created_at', '>=', now()->subMonths(6))
+            ->select(['o.order_number', 'p.payment_meta'])
+            ->get();
+
+        $map = [];
+        foreach ($rows as $row) {
+            $meta = json_decode($row->payment_meta, true) ?? [];
+            if ($meta['is_test_mode'] ?? false) {
+                $map[$row->order_number] = true;
+            }
+        }
+
+        return ResponseHelper::success('messages.success', $map);
+    }
+
+    /**
+     * 나이스페이먼츠 간편결제 표시 맵 반환
+     *
+     * 관리자 주문목록은 코어 결제 리소스의 기본 결제수단 라벨을 사용하므로,
+     * 플러그인 데이터소스로 실제 간편결제 표시명을 보강한다.
+     *
+     * @return JsonResponse 주문번호별 표시 맵
+     */
+    public function easyPayDisplayMap(): JsonResponse
+    {
+        $rows = DB::table('ecommerce_orders as o')
+            ->join('ecommerce_order_payments as p', 'p.order_id', '=', 'o.id')
+            ->whereIn('p.pg_provider', ['nicepayments', 'nicepay'])
+            ->where('p.created_at', '>=', now()->subMonths(6))
+            ->select([
+                'o.order_number',
+                'p.payment_method',
+                'p.embedded_pg_provider',
+                'p.payment_meta',
+            ])
+            ->get();
+
+        $map = [];
+        foreach ($rows as $row) {
+            $display = $this->resolvePaymentDisplay($row);
+            if (($display['embedded_pg_provider_label'] ?? null) === null) {
+                continue;
+            }
+
+            $map[$row->order_number] = [
+                'payment_method_label' => $display['payment_method_label'],
+                'payment_method_display_label' => $display['payment_method_display_label'],
+                'embedded_pg_provider' => $display['embedded_pg_provider'],
+                'embedded_pg_provider_label' => $display['embedded_pg_provider_label'],
+            ];
+        }
+
+        return ResponseHelper::success('messages.success', $map);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/src/Controllers/AdminSettingsStatusController.php b/plugins/_bundled/sirsoft-pay_nicepayments/src/Controllers/AdminSettingsStatusController.php
new file mode 100644
index 00000000..2e854622
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/src/Controllers/AdminSettingsStatusController.php
@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Controllers;
+
+use App\Helpers\ResponseHelper;
+use App\Services\PluginSettingsService;
+use Illuminate\Http\JsonResponse;
+
+class AdminSettingsStatusController
+{
+    private const PLUGIN_IDENTIFIER = 'sirsoft-pay_nicepayments';
+
+    public function __construct(private readonly PluginSettingsService $settingsService) {}
+
+    /**
+     * 테스트 모드 활성 여부만 반환한다.
+     *
+     * @return JsonResponse
+     */
+    public function testMode(): JsonResponse
+    {
+        return ResponseHelper::success('messages.success', [
+            'is_test_mode' => (bool) $this->settingsService->get(self::PLUGIN_IDENTIFIER, 'is_test_mode', true),
+        ]);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/src/Controllers/AdminTransactionController.php b/plugins/_bundled/sirsoft-pay_nicepayments/src/Controllers/AdminTransactionController.php
new file mode 100644
index 00000000..04631f52
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/src/Controllers/AdminTransactionController.php
@@ -0,0 +1,110 @@
+<?php
+
+namespace Plugins\Sirsoft\PayNicepayments\Controllers;
+
+use App\Helpers\ResponseHelper;
+use App\Http\Controllers\Api\Base\AdminBaseController;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Log;
+use Plugins\Sirsoft\PayNicepayments\Concerns\ResolvesEasyPayDisplay;
+use Plugins\Sirsoft\PayNicepayments\Services\NicePaymentsApiService;
+
+class AdminTransactionController extends AdminBaseController
+{
+    use ResolvesEasyPayDisplay;
+
+    public function __construct(
+        private NicePaymentsApiService $apiService
+    ) {
+        parent::__construct();
+    }
+
+    /**
+     * TID 단건 거래 조회
+     *
+     * NicePay 단건 거래 조회 API 를 호출하고 로컬 DB 의 보조 정보(에스크로 여부,
+     * 테스트 모드 플래그)를 합쳐 반환한다.
+     *
+     * @param  Request  $request  tid 입력 폼
+     * @return JsonResponse 거래 정보 + _local_is_escrow / EscrowYN / _is_test_mode 보강
+     */
+    public function query(Request $request): JsonResponse
+    {
+        $tid = trim((string) $request->input('tid', ''));
+
+        if ($tid === '') {
+            return ResponseHelper::error('messages.failed', 422, ['tid' => [__('sirsoft-pay_nicepayments::messages.errors.tid_required')]]);
+        }
+
+        return $this->queryByTid($tid);
+    }
+
+    /**
+     * 주문번호로 거래 조회 (TID 자동 매핑)
+     *
+     * 어드민 주문 상세에서 거래 조회 버튼 클릭 시 사용. ecommerce_order_payments
+     * 의 transaction_id 를 찾아 queryByTid 로 위임.
+     *
+     * @param  string  $orderNumber  주문번호
+     * @return JsonResponse 거래 정보 또는 매핑 없을 시 null
+     */
+    public function queryByOrder(string $orderNumber): JsonResponse
+    {
+        $payment = DB::table('ecommerce_order_payments')
+            ->join('ecommerce_orders', 'ecommerce_orders.id', '=', 'ecommerce_order_payments.order_id')
+            ->where('ecommerce_orders.order_number', $orderNumber)
+            ->whereNotNull('ecommerce_order_payments.transaction_id')
+            ->where('ecommerce_order_payments.transaction_id', '!=', '')
+            ->whereIn('ecommerce_order_payments.pg_provider', ['nicepayments', 'nicepay'])
+            ->select(['ecommerce_order_payments.transaction_id'])
+            ->first();
+
+        if (!$payment) {
+            return ResponseHelper::success('messages.success', null);
+        }
+
+        return $this->queryByTid($payment->transaction_id);
+    }
+
+    private function queryByTid(string $tid): JsonResponse
+    {
+        try {
+            $result = $this->apiService->queryTransaction($tid);
+
+            $localPayment = DB::table('ecommerce_order_payments')
+                ->where('transaction_id', $tid)
+                ->select(['is_escrow', 'payment_meta', 'payment_method', 'embedded_pg_provider'])
+                ->first();
+
+            $result['_local_is_escrow'] = (bool) ($localPayment?->is_escrow ?? false);
+            $display = $localPayment ? $this->resolvePaymentDisplay($localPayment) : [
+                'payment_method_label' => null,
+                'payment_method_display_label' => null,
+                'embedded_pg_provider' => null,
+                'embedded_pg_provider_label' => null,
+            ];
+            $result['_base_pay_method_label'] = $display['payment_method_label'];
+            $result['_embedded_pg_provider'] = $display['embedded_pg_provider'];
+            $result['_embedded_pg_provider_label'] = $display['embedded_pg_provider_label'];
+            $result['_pay_method_label'] = $display['payment_method_display_label'];
+            $result['payment_method_display_label'] = $display['payment_method_display_label'];
+
+            if ($localPayment?->payment_meta) {
+                $meta = json_decode($localPayment->payment_meta, true);
+                $result['EscrowYN'] = $meta['pg_raw_response']['EscrowYN']
+                    ?? ($result['EscrowYN'] ?? 'N');
+                $result['_is_test_mode'] = (bool) ($meta['is_test_mode'] ?? false);
+            }
+
+            return ResponseHelper::success('messages.success', $result);
+        } catch (\Exception $e) {
+            Log::error('NicePayments queryTransaction failed', [
+                'tid' => $tid,
+                'error' => $e->getMessage(),
+            ]);
+            return ResponseHelper::error('messages.failed', 502, null);
+        }
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/src/Controllers/AdminVbankNotificationController.php b/plugins/_bundled/sirsoft-pay_nicepayments/src/Controllers/AdminVbankNotificationController.php
new file mode 100644
index 00000000..1082c1ec
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/src/Controllers/AdminVbankNotificationController.php
@@ -0,0 +1,77 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Controllers;
+
+use Illuminate\Http\JsonResponse;
+use Modules\Sirsoft\Ecommerce\Services\OrderProcessingService;
+
+/**
+ * 어드민 — 가상계좌 입금통보 이력 조회 컨트롤러
+ *
+ * GET /api/plugins/sirsoft-pay_nicepayments/admin/orders/{orderNumber}/vbank-notifications
+ *
+ * OrderPaymentResource 는 payment_meta 를 노출하지 않으므로 (PII 보호),
+ * 어드민 전용으로 입금통보 이력만 따로 추출해 반환한다.
+ *
+ * 응답 shape:
+ *   {
+ *     "success": true,
+ *     "data": {
+ *       "notifications": [...],   // 시간순 통보 entry 배열
+ *       "summary": {...}           // 한 줄 요약 (count/timestamps/depositor)
+ *     }
+ *   }
+ *
+ * 미들웨어: auth:sanctum + admin (routes/api.php 그룹에서 적용)
+ */
+class AdminVbankNotificationController
+{
+    public function __construct(
+        private readonly OrderProcessingService $orderService
+    ) {
+    }
+
+    /**
+     * 가상계좌 입금통보 이력 조회
+     *
+     * 주문의 payment_meta 에 누적 저장된 NicePay 입금통보 이벤트 (계좌발급/입금완료/취소/재통보)
+     * 를 timeline 형태로 반환한다. 어드민 패널에서 통보 시점/금액/예금주를 추적 가능.
+     *
+     * @param  string  $orderNumber  주문번호
+     * @return JsonResponse notifications + summary, 또는 404 (주문 없음) / 빈 배열 (가상계좌 아님)
+     */
+    public function show(string $orderNumber): JsonResponse
+    {
+        $order = $this->orderService->findByOrderNumber($orderNumber);
+
+        if (! $order) {
+            return response()->json([
+                'success' => false,
+                'message' => __('sirsoft-pay_nicepayments::messages.errors.order_not_found'),
+                'data' => ['notifications' => [], 'summary' => null],
+            ], 404);
+        }
+
+        $payment = $order->payment;
+        if (! $payment || $payment->payment_method?->value !== 'vbank') {
+            return response()->json([
+                'success' => true,
+                'data' => ['notifications' => [], 'summary' => null],
+            ]);
+        }
+
+        $meta = is_array($payment->payment_meta) ? $payment->payment_meta : [];
+        $notifications = is_array($meta['vbank_notifications'] ?? null) ? $meta['vbank_notifications'] : [];
+        $summary = is_array($meta['vbank_notification_summary'] ?? null) ? $meta['vbank_notification_summary'] : null;
+
+        return response()->json([
+            'success' => true,
+            'data' => [
+                'notifications' => $notifications,
+                'summary' => $summary,
+            ],
+        ]);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/src/Controllers/AdminVbankRefundController.php b/plugins/_bundled/sirsoft-pay_nicepayments/src/Controllers/AdminVbankRefundController.php
new file mode 100644
index 00000000..f13c200a
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/src/Controllers/AdminVbankRefundController.php
@@ -0,0 +1,253 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Controllers;
+
+use App\Helpers\ResponseHelper;
+use App\Http\Controllers\Api\Base\AdminBaseController;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Auth;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Log;
+use Modules\Sirsoft\Ecommerce\Enums\OrderStatusEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentMethodEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentStatusEnum;
+use Modules\Sirsoft\Ecommerce\Models\Order;
+use Modules\Sirsoft\Ecommerce\Models\OrderPayment;
+use Modules\Sirsoft\Ecommerce\Services\OrderCancellationService;
+use Plugins\Sirsoft\PayNicepayments\Services\NicePaymentsApiService;
+
+/**
+ * 가상계좌 입금 완료 건 환불 처리
+ *
+ * 입금이 완료된 가상계좌는 일반 환불 훅으로는 처리할 수 없습니다.
+ * 나이스페이먼츠 API가 환불받을 계좌 정보(계좌번호·은행코드·예금주)를 요구하기 때문입니다.
+ * 이 컨트롤러는 해당 정보를 직접 수집하여 취소 API를 호출합니다.
+ */
+class AdminVbankRefundController extends AdminBaseController
+{
+    public function __construct(
+        private readonly NicePaymentsApiService $apiService,
+        private readonly OrderCancellationService $cancellationService,
+    ) {
+        parent::__construct();
+    }
+
+    /**
+     * POST /api/plugins/sirsoft-pay_nicepayments/admin/vbank-refund
+     */
+    /**
+     * 가상계좌 입금 완료 건 환불 처리
+     *
+     * 일반 환불 훅으로 처리할 수 없는 vbank 입금 완료 건의 환불을 직접 수행.
+     * NicePay 가 요구하는 환불 계좌 정보(계좌번호·은행코드·예금주)를 직접 수집.
+     *
+     * @param  Request  $request  TID/MOID/CancelAmt + 환불계좌 정보
+     * @return JsonResponse 환불 결과 또는 422 (입력 누락)
+     */
+    public function refund(Request $request): JsonResponse
+    {
+        $tid = trim((string) $request->input('tid', ''));
+        $moid = trim((string) $request->input('moid', ''));
+        $cancelAmt = (int) $request->input('cancel_amt', 0);
+        $cancelMsg = trim((string) $request->input('cancel_msg', __('sirsoft-pay_nicepayments::messages.defaults.vbank_refund_msg')));
+        $refundAcctNo = trim((string) $request->input('refund_acct_no', ''));
+        $refundBankCd = trim((string) $request->input('refund_bank_cd', ''));
+        $refundAcctNm = trim((string) $request->input('refund_acct_nm', ''));
+
+        if ($tid === '' || $moid === '' || $cancelAmt <= 0
+            || $refundAcctNo === '' || $refundBankCd === '' || $refundAcctNm === '') {
+            return ResponseHelper::error('messages.failed', 422, [
+                'message' => __('sirsoft-pay_nicepayments::messages.errors.vbank_refund_required_fields'),
+            ]);
+        }
+
+        $claimedPayment = null;
+        $pgCancelled = false;
+
+        try {
+            $claim = $this->claimRefund($moid, $tid, $cancelAmt);
+            if (isset($claim['error_key'])) {
+                return $this->refundError((string) $claim['error_key'], (int) $claim['status']);
+            }
+
+            /** @var Order $order */
+            $order = $claim['order'];
+            /** @var OrderPayment $payment */
+            $payment = $claim['payment'];
+            $claimedPayment = $payment;
+
+            $this->useStoredCredentials($payment);
+
+            $result = $this->apiService->cancelPayment(
+                $tid,
+                $moid,
+                $cancelAmt,
+                $cancelMsg,
+                0,
+                $refundAcctNo,
+                $refundBankCd,
+                $refundAcctNm,
+            );
+            $pgCancelled = true;
+
+            $this->assertCancelResponseMatches($result, $tid, $cancelAmt);
+
+            $cancellation = $this->cancellationService->cancelOrder(
+                $order->fresh(['options', 'payment', 'shippings']),
+                $cancelMsg,
+                null,
+                Auth::id(),
+                false,
+            );
+
+            $this->markRefundCompleted($cancellation->order->payment, $result);
+
+            Log::info('NicePayments: admin vbank refund success', [
+                'tid' => $tid,
+                'moid' => $moid,
+                'cancel_amt' => $cancelAmt,
+            ]);
+
+            return ResponseHelper::success('messages.success', $result);
+        } catch (\Exception $e) {
+            Log::error('NicePayments: admin vbank refund failed', [
+                'tid' => $tid,
+                'moid' => $moid,
+                'error' => $e->getMessage(),
+            ]);
+
+            $this->markRefundFailed($claimedPayment, $e, $pgCancelled);
+
+            return ResponseHelper::error('messages.failed', 502, null);
+        }
+    }
+
+    /**
+     * @return array{order?: Order, payment?: OrderPayment, error_key?: string, status?: int}
+     */
+    private function claimRefund(string $moid, string $tid, int $cancelAmt): array
+    {
+        return DB::transaction(function () use ($moid, $tid, $cancelAmt): array {
+            $order = Order::query()
+                ->where('order_number', $moid)
+                ->lockForUpdate()
+                ->first();
+
+            if (! $order) {
+                return ['error_key' => 'vbank_refund_order_not_found', 'status' => 404];
+            }
+
+            if ($order->order_status !== OrderStatusEnum::PAYMENT_COMPLETE
+                || ! $order->options()->where('option_status', '!=', OrderStatusEnum::CANCELLED->value)->exists()) {
+                return ['error_key' => 'vbank_refund_invalid_payment', 'status' => 422];
+            }
+
+            $payment = $order->payment()->lockForUpdate()->first();
+            if (! $payment || ! $this->isRefundableVbankPayment($payment, $tid)) {
+                return ['error_key' => 'vbank_refund_invalid_payment', 'status' => 422];
+            }
+
+            $meta = $payment->payment_meta ?? [];
+            if (($meta['vbank_refund_status'] ?? null) === 'processing') {
+                return ['error_key' => 'vbank_refund_already_processing', 'status' => 409];
+            }
+
+            if (in_array(($meta['vbank_refund_status'] ?? null), ['completed', 'pg_cancelled_domain_failed'], true)
+                || $payment->isFullyCancelled()) {
+                return ['error_key' => 'vbank_refund_invalid_payment', 'status' => 422];
+            }
+
+            $cancellableAmount = (int) round((float) $payment->getCancellableAmount());
+            if ($cancelAmt !== $cancellableAmount) {
+                return ['error_key' => 'vbank_refund_amount_mismatch', 'status' => 422];
+            }
+
+            $payment->update([
+                'payment_meta' => array_merge($meta, [
+                    'vbank_refund_status' => 'processing',
+                    'vbank_refund_started_at' => now()->toIso8601String(),
+                ]),
+            ]);
+
+            return [
+                'order' => $order->fresh(['options', 'payment', 'shippings']),
+                'payment' => $payment->fresh(),
+            ];
+        });
+    }
+
+    private function isRefundableVbankPayment(OrderPayment $payment, string $tid): bool
+    {
+        return $payment->pg_provider === 'nicepayments'
+            && $payment->payment_method === PaymentMethodEnum::VBANK
+            && $payment->payment_status === PaymentStatusEnum::PAID
+            && $payment->paid_at !== null
+            && $payment->vbank_number !== null
+            && hash_equals((string) $payment->transaction_id, $tid);
+    }
+
+    private function useStoredCredentials(OrderPayment $payment): void
+    {
+        $meta = $payment->payment_meta ?? [];
+        $mid = trim((string) ($meta['mid'] ?? ''));
+        if ($mid === '' || ! array_key_exists('is_test_mode', $meta)) {
+            return;
+        }
+
+        $this->apiService->useStoredCredentials((bool) $meta['is_test_mode'], $mid);
+    }
+
+    private function assertCancelResponseMatches(array $result, string $tid, int $cancelAmt): void
+    {
+        $responseTid = trim((string) ($result['TID'] ?? ''));
+        if ($responseTid !== '' && ! hash_equals($tid, $responseTid)) {
+            throw new \RuntimeException('NicePayments vbank refund TID mismatch');
+        }
+
+        if (isset($result['CancelAmt']) && (int) $result['CancelAmt'] !== $cancelAmt) {
+            throw new \RuntimeException('NicePayments vbank refund amount mismatch');
+        }
+    }
+
+    private function markRefundCompleted(?OrderPayment $payment, array $result): void
+    {
+        if (! $payment) {
+            return;
+        }
+
+        $payment->update([
+            'payment_meta' => array_merge($payment->payment_meta ?? [], [
+                'vbank_refund_status' => 'completed',
+                'vbank_refunded_at' => now()->toIso8601String(),
+                'vbank_refund_result_code' => $result['ResultCode'] ?? null,
+                'vbank_refund_tid' => $result['TID'] ?? $payment->transaction_id,
+            ]),
+        ]);
+    }
+
+    private function markRefundFailed(?OrderPayment $payment, \Throwable $e, bool $pgCancelled): void
+    {
+        if (! $payment) {
+            return;
+        }
+
+        $payment->refresh();
+        $payment->update([
+            'payment_meta' => array_merge($payment->payment_meta ?? [], [
+                'vbank_refund_status' => $pgCancelled ? 'pg_cancelled_domain_failed' : 'failed',
+                'vbank_refund_failed_at' => now()->toIso8601String(),
+                'vbank_refund_error' => $e->getMessage(),
+            ]),
+        ]);
+    }
+
+    private function refundError(string $key, int $status): JsonResponse
+    {
+        return ResponseHelper::error('messages.failed', $status, [
+            'message' => __("sirsoft-pay_nicepayments::messages.errors.{$key}"),
+        ]);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/src/Controllers/PaymentCallbackController.php b/plugins/_bundled/sirsoft-pay_nicepayments/src/Controllers/PaymentCallbackController.php
new file mode 100644
index 00000000..3f4fdae5
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/src/Controllers/PaymentCallbackController.php
@@ -0,0 +1,1148 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Controllers;
+
+use App\Contracts\Extension\CacheInterface;
+use App\Extension\HookManager;
+use App\Services\PluginSettingsService;
+use Carbon\Carbon;
+use InvalidArgumentException;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Log;
+use Illuminate\Support\Facades\RateLimiter;
+use Modules\Sirsoft\Ecommerce\Enums\OrderStatusEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentStatusEnum;
+use Modules\Sirsoft\Ecommerce\Exceptions\PaymentAmountMismatchException;
+use Modules\Sirsoft\Ecommerce\Helpers\DeviceDetector;
+use Modules\Sirsoft\Ecommerce\Models\Order;
+use Modules\Sirsoft\Ecommerce\Models\OrderPayment;
+use Modules\Sirsoft\Ecommerce\Services\OrderProcessingService;
+use Plugins\Sirsoft\PayNicepayments\Concerns\PreventsReplayCallback;
+use Plugins\Sirsoft\PayNicepayments\Concerns\IssuesReceiptCookie;
+use Plugins\Sirsoft\PayNicepayments\Concerns\RecordsPaymentWindowClosure;
+use Plugins\Sirsoft\PayNicepayments\Concerns\ResolvesEasyPayDisplay;
+use Plugins\Sirsoft\PayNicepayments\Concerns\SanitizesPgResponse;
+use Plugins\Sirsoft\PayNicepayments\Http\Requests\AuthCallbackRequest;
+use Plugins\Sirsoft\PayNicepayments\Http\Requests\VbankNotifyRequest;
+use Plugins\Sirsoft\PayNicepayments\Services\NicePaymentsApiService;
+use Plugins\Sirsoft\PayNicepayments\Support\UrlHelper;
+
+/**
+ * 나이스페이먼츠 결제 콜백 컨트롤러
+ *
+ * 나이스페이먼츠 결제는 2단계 인증 방식입니다:
+ *  1단계: 브라우저가 POST 콜백으로 인증 토큰 전달 → authCallback()
+ *  2단계: 서버가 NextAppURL로 최종 승인 요청 → NicePaymentsApiService::authorizePayment()
+ */
+class PaymentCallbackController
+{
+    use PreventsReplayCallback;
+    use IssuesReceiptCookie;
+    use RecordsPaymentWindowClosure;
+    use ResolvesEasyPayDisplay;
+    use SanitizesPgResponse;
+
+    private const PLUGIN_IDENTIFIER = 'sirsoft-pay_nicepayments';
+
+    /** 성공 결제 방법 ResultCode 목록 */
+    private const SUCCESS_RESULT_CODES = ['3001', '4000', '4100', 'A000', '7001'];
+
+    private const AUTH_RESPONSE_KEYS = [
+        'ResultCode',
+        'ResultMsg',
+        'TID',
+        'Moid',
+        'MID',
+        'Amt',
+        'PayMethod',
+        'AppNo',
+        'AuthDate',
+        'AuthCode',
+        'CardCode',
+        'CardName',
+        'IssuCardCode',
+        'IssuCardName',
+        'AcquCardCode',
+        'AcquCardName',
+        'CardQuota',
+        'CardInterest',
+        'CardCl',
+        'CcPartCl',
+        'CardNoInterest',
+        'RcptTID',
+        'EscrowYN',
+        'MallReserved',
+        'MallReserved1',
+        'Currency',
+    ];
+
+    private const VBANK_ISSUE_RESPONSE_KEYS = [
+        'ResultCode',
+        'ResultMsg',
+        'TID',
+        'Moid',
+        'MID',
+        'Amt',
+        'PayMethod',
+        'AuthDate',
+        'AuthCode',
+        'VbankBankCode',
+        'VbankBankName',
+        'VbankExpDate',
+        'VbankExpTime',
+        'RcptTID',
+        'EscrowYN',
+        'MallReserved',
+        'MallReserved1',
+    ];
+
+    private const VBANK_NOTIFY_RESPONSE_KEYS = [
+        'PG',
+        'PayMethod',
+        'MID',
+        'MOID',
+        'TID',
+        'Amt',
+        'ResultCode',
+        'ResultMsg',
+        'AuthDate',
+        'AuthCode',
+        'StateCd',
+        'VbankName',
+        'FnCd',
+        'FnName',
+        'CancelDate',
+        'CancelMOID',
+        'MallReserved',
+        'MallReserved1',
+        'TransType',
+        'CartCnt',
+        'RcptTID',
+    ];
+
+    public function __construct(
+        private readonly OrderProcessingService $orderService,
+        private readonly PluginSettingsService $pluginSettingsService,
+        private readonly NicePaymentsApiService $apiService,
+        private readonly CacheInterface $cache,
+    ) {}
+
+    /**
+     * 나이스페이먼츠 결제 승인 콜백
+     *
+     * POST /plugins/sirsoft-pay_nicepayments/payment/callback
+     * (CSRF 제외 - 나이스페이먼츠가 브라우저 통해 POST 전달)
+     */
+    /**
+     * 나이스페이먼츠 결제 승인 콜백
+     *
+     * 1단계: 브라우저가 POST 콜백으로 인증 토큰 전달 → 서명 검증 + 서버 승인 호출.
+     * 2단계: NextAppURL 호출해 최종 승인. 결제 수단별로 가상계좌(계좌발급)/카드(즉시완료) 분기.
+     * 사용자 취소(AuthResultCode != '0000') 는 에러 query 없이 체크아웃으로 복귀.
+     *
+     * @param  AuthCallbackRequest  $request  검증된 콜백 페이로드
+     * @return RedirectResponse 성공/실패 URL 로 리다이렉트
+     */
+    public function authCallback(AuthCallbackRequest $request): RedirectResponse
+    {
+        $validated = $request->validated();
+
+        $authResultCode = $validated['AuthResultCode'];
+        $authResultMsg = $validated['AuthResultMsg'] ?? '';
+        $moid = $validated['Moid'] ?? '';
+
+        // 1단계: 인증 결과 코드 확인 (실패/취소 케이스는 여기서 종료)
+        //
+        // 인증 단계 실패는 NextAppURL 호출 (실제 결제 승인) 이전이라 사용자가 아직 결제를
+        // 완료하지 않은 상태. 코드/메시지로 사용자 취소 vs PG 시스템 오류를 구분하려 해도
+        // NicePay 가 보내는 패턴이 다양해 (모바일 결제창 종료 시 '0021 - 결제창을 종료하셨습니다',
+        // 영문 cancel, 코드만 있고 메시지가 비어있는 경우 등) 정확히 분류하기 어렵다.
+        //
+        // 사용자 입장에서 인증단계 실패는 어떤 코드든 "다시 시도" 외에 할 수 있는 액션이 없고
+        // 결제도 일어나지 않았으므로 generic 에러 toast 를 띄우면 오히려 혼란을 준다.
+        // 따라서 인증단계 실패는 모두 silent redirect 로 통일 — 체크아웃에 그대로 머물러
+        // 결제수단을 다시 선택하거나 정보를 수정해 재시도 가능.
+        //
+        // 운영 가시성은 Log 로 충분히 확보 (auth_result_code / auth_result_msg 모두 보존).
+        if ($authResultCode !== '0000') {
+            Log::info('NicePayments: auth phase did not complete', [
+                'moid' => $moid,
+                'auth_result_code' => $authResultCode,
+                'auth_result_msg' => $authResultMsg,
+                'ip' => $request->ip(),
+            ]);
+
+            return redirect($this->resolveFailUrl([]));
+        }
+
+        // 인증 성공 케이스 — 추가 필드 추출
+        $nextAppUrl = $validated['NextAppURL'];
+        $txTid = $validated['TxTid'];
+        $authToken = $validated['AuthToken'];
+        $mid = $validated['MID'];
+        $amt = (int) $validated['Amt'];
+        $netCancelUrl = $validated['NetCancelURL'];
+        $signature = $validated['Signature'];
+
+        // AuthToken freshness 가드 — NicePay 콜백 페이로드에 명시적 timestamp 가 없어
+        // 동일 AuthToken 으로 짧은 시간 안에 중복 콜백 시도되는 stale replay 가능.
+        // Cache 기반 60초 윈도우 디듀프로 보조 방어 (HIGH 2 의 transaction_id replay 가드
+        // 외에 추가 계층). transaction_id 까지 도달하기 전 인증 단계 자체에서 차단.
+        $replayCacheKey = 'nicepay_auth_token_seen:'.hash('sha256', $mid.':'.$authToken.':'.$txTid);
+        if ($this->cache->has($replayCacheKey)) {
+            Log::warning('NicePayments: duplicate authCallback within freshness window — replay suspected', [
+                'moid' => $moid,
+                'txTid' => $txTid,
+                'ip' => $request->ip(),
+            ]);
+
+            $this->queueReceiptCookie($moid);
+
+            return redirect($this->resolveSuccessUrl($moid));
+        }
+        $this->cache->put($replayCacheKey, true, 60);
+
+        // 2단계: MID 일치 확인
+        if ($mid !== $this->apiService->getMid()) {
+            Log::error('NicePayments: MID mismatch', [
+                'received_mid' => $mid,
+                'config_mid' => $this->apiService->getMid(),
+                'moid' => $moid,
+                'ip' => $request->ip(),
+            ]);
+
+            return redirect($this->resolveFailUrl(['error' => 'mid_mismatch', 'orderId' => $moid]));
+        }
+
+        // 3단계: 서명 검증
+        if (! $this->apiService->verifyCallbackSignature($authToken, $mid, $amt, $signature)) {
+            Log::error('NicePayments: signature verification failed', ['moid' => $moid, 'ip' => $request->ip()]);
+
+            return redirect($this->resolveFailUrl(['error' => 'signature_mismatch', 'orderId' => $moid]));
+        }
+
+        try {
+            // 주문 조회
+            $order = $this->orderService->findByOrderNumber($moid);
+
+            if (! $order) {
+                Log::error('NicePayments: order not found', ['moid' => $moid]);
+
+                return redirect($this->resolveFailUrl(['error' => 'order_not_found', 'orderId' => $moid]));
+            }
+
+            if (! $order->order_status->isBeforePayment()) {
+                Log::warning('NicePayments: callback ignored for non-payable order', [
+                    'moid' => $moid,
+                    'order_status' => $order->order_status->value,
+                    'payment_status' => $order->payment?->payment_status?->value,
+                ]);
+
+                return redirect($this->resolveFailUrl(['error' => 'order_not_payable', 'orderId' => $moid]));
+            }
+
+            HookManager::doAction('sirsoft-pay_nicepayments.payment.before_authorize', $order, $validated);
+
+            // 4단계: 서버 승인 API 호출
+            $pgResponse = $this->apiService->authorizePayment($nextAppUrl, $txTid, $authToken, $amt);
+
+            HookManager::doAction('sirsoft-pay_nicepayments.payment.after_authorize', $order, $pgResponse);
+
+            $resultCode = $pgResponse['ResultCode'] ?? '';
+
+            if (! in_array($resultCode, self::SUCCESS_RESULT_CODES, true)) {
+                Log::warning('NicePayments: authorize failed', [
+                    'moid' => $moid,
+                    'result_code' => $resultCode,
+                    'result_msg' => $pgResponse['ResultMsg'] ?? '',
+                ]);
+
+                $failureMessage = $pgResponse['ResultMsg'] ?? '';
+                $failedOrder = $this->orderService->failPayment($order, $resultCode, $failureMessage);
+                $this->markNicePaymentFailed($failedOrder, $resultCode, $failureMessage);
+
+                // authorize 실패 — NextAppURL 호출이 거부됐어도 PG 측에 잔존 승인이 있을
+                // 수 있어 net cancel 호출. NicePay 가 미승인 상태이면 net cancel API 가
+                // safe-no-op 으로 동작하므로 모든 실패 경로에서 호출해 안전.
+                $this->apiService->sendNetCancel($netCancelUrl, $txTid, $authToken, $amt);
+
+                return redirect($this->resolveFailUrl([
+                    'error' => 'authorize_failed',
+                    'orderId' => $moid,
+                ]));
+            }
+
+            // 5단계: 결제 수단별 처리
+            $payMethod = $pgResponse['PayMethod'] ?? '';
+            $isEscrow = ($pgResponse['EscrowYN'] ?? 'N') === 'Y'
+                || $this->apiService->isEscrowEnabled();
+
+            if ($payMethod === 'VBANK') {
+                $issueStatus = $this->recordVbankIssueWithLock($moid, $pgResponse, $resultCode, $payMethod, $isEscrow, $txTid);
+                if ($issueStatus === 'already_waiting') {
+                    $this->logReplayDetected((string) ($pgResponse['TID'] ?? $txTid), $moid, 'authCallback (vbank issue)');
+                    $this->queueReceiptCookie($moid);
+
+                    return redirect($this->resolveSuccessUrl($moid));
+                }
+
+                if ($issueStatus !== 'recorded') {
+                    Log::warning('NicePayments: vbank issue ignored after locked state check', [
+                        'moid' => $moid,
+                        'status' => $issueStatus,
+                    ]);
+
+                    $this->apiService->sendNetCancel($netCancelUrl, $txTid, $authToken, $amt);
+
+                    return redirect($this->resolveFailUrl(['error' => 'order_not_payable', 'orderId' => $moid]));
+                }
+
+                Log::info('NicePayments: vbank account issued', [
+                    'moid' => $moid,
+                    'vbank_name' => $pgResponse['VbankBankName'] ?? null,
+                    'vbank_number_last4' => $this->lastFour((string) ($pgResponse['VbankNum'] ?? '')),
+                ]);
+            } else {
+                $effectiveTid = (string) ($pgResponse['TID'] ?? $txTid);
+                $completionStatus = $this->completeAuthorizedPaymentWithLock($moid, $pgResponse, $txTid, $amt, $isEscrow, $request, $validated);
+
+                if ($completionStatus === 'already_paid') {
+                    $this->logReplayDetected($effectiveTid, $moid, 'authCallback (card)');
+                    $this->queueReceiptCookie($moid);
+
+                    return redirect($this->resolveSuccessUrl($moid));
+                }
+
+                if ($completionStatus === 'paid_with_other_tid') {
+                    Log::warning('NicePayments: order already paid with another TID; net cancelling current authorization', [
+                        'moid' => $moid,
+                        'tid' => $effectiveTid,
+                    ]);
+
+                    $this->apiService->sendNetCancel($netCancelUrl, $txTid, $authToken, $amt);
+                    $this->queueReceiptCookie($moid);
+
+                    return redirect($this->resolveSuccessUrl($moid));
+                }
+
+                if ($completionStatus !== 'completed') {
+                    Log::warning('NicePayments: authorized payment ignored after locked state check', [
+                        'moid' => $moid,
+                        'tid' => $effectiveTid,
+                        'status' => $completionStatus,
+                    ]);
+
+                    $this->apiService->sendNetCancel($netCancelUrl, $txTid, $authToken, $amt);
+
+                    return redirect($this->resolveFailUrl(['error' => 'order_not_payable', 'orderId' => $moid]));
+                }
+            }
+
+            $this->queueReceiptCookie($moid);
+
+            return redirect($this->resolveSuccessUrl($moid));
+
+        } catch (PaymentAmountMismatchException $e) {
+            Log::error('NicePayments: amount mismatch', [
+                'moid' => $moid,
+                'expected' => $e->getExpectedAmount(),
+                'actual' => $e->getActualAmount(),
+            ]);
+
+            $this->apiService->sendNetCancel($netCancelUrl, $txTid, $authToken, $amt);
+
+            if (isset($order)) {
+                $failedOrder = $this->orderService->failPayment($order, 'AMOUNT_MISMATCH', $e->getMessage());
+                $this->markNicePaymentFailed($failedOrder, 'AMOUNT_MISMATCH', $e->getMessage());
+            }
+
+            return redirect($this->resolveFailUrl(['error' => 'amount_mismatch', 'orderId' => $moid]));
+
+        } catch (InvalidArgumentException $e) {
+            Log::error('NicePayments: invalid payment currency during authorization', [
+                'moid' => $moid,
+                'error' => $e->getMessage(),
+            ]);
+
+            $this->apiService->sendNetCancel($netCancelUrl, $txTid, $authToken, $amt);
+
+            if (isset($order)) {
+                $failureMessage = $this->invalidPaymentCurrencyFailureMessage($e);
+                $failedOrder = $this->orderService->failPayment($order, 'INVALID_PAYMENT_CURRENCY', $failureMessage);
+                $this->markNicePaymentFailed($failedOrder, 'INVALID_PAYMENT_CURRENCY', $failureMessage);
+            }
+
+            return redirect($this->resolveFailUrl([
+                'error' => 'invalid_payment_currency',
+                'orderId' => $moid,
+            ]));
+
+        } catch (\Exception $e) {
+            Log::error('NicePayments: authorize exception', [
+                'moid' => $moid,
+                'error' => $e->getMessage(),
+            ]);
+
+            $approvedTid = $pgResponse['TID'] ?? $txTid;
+            if ($this->wasAlreadyPaid((string) $approvedTid)) {
+                $this->logReplayDetected((string) $approvedTid, $moid, 'authCallback exception');
+                $this->queueReceiptCookie($moid);
+
+                return redirect($this->resolveSuccessUrl($moid));
+            }
+
+            $this->apiService->sendNetCancel($netCancelUrl, $txTid, $authToken, $amt);
+
+            if (isset($order)) {
+                try {
+                    $failedOrder = $this->orderService->failPayment($order, 'AUTHORIZE_EXCEPTION', $e->getMessage());
+                    $this->markNicePaymentFailed($failedOrder, 'AUTHORIZE_EXCEPTION', $e->getMessage());
+                } catch (\Throwable $recordingError) {
+                    Log::warning('NicePayments: failed to record authorize exception as payment failure', [
+                        'moid' => $moid,
+                        'error' => $recordingError->getMessage(),
+                    ]);
+                }
+            }
+
+            return redirect($this->resolveFailUrl([
+                'error' => 'authorize_failed',
+                'orderId' => $moid,
+            ]));
+        }
+    }
+
+    private function recordVbankIssueWithLock(
+        string $moid,
+        array $pgResponse,
+        string $resultCode,
+        string $payMethod,
+        bool $isEscrow,
+        string $txTid,
+    ): string {
+        return DB::transaction(function () use ($moid, $pgResponse, $resultCode, $payMethod, $isEscrow, $txTid): string {
+            $lockedOrder = Order::query()
+                ->where('order_number', $moid)
+                ->lockForUpdate()
+                ->first();
+
+            if (! $lockedOrder) {
+                return 'order_not_found';
+            }
+
+            $payment = $lockedOrder->payment()->lockForUpdate()->first();
+            if (! $payment || ! $lockedOrder->order_status->isBeforePayment()) {
+                return 'not_payable';
+            }
+
+            $issuedTid = (string) ($pgResponse['TID'] ?? $txTid);
+            $meta = $payment->payment_meta ?? [];
+            $storedTid = (string) ($meta['vbank_tid'] ?? $payment->transaction_id ?? '');
+
+            if ($payment->payment_status === PaymentStatusEnum::WAITING_DEPOSIT
+                && $storedTid !== ''
+                && hash_equals($storedTid, $issuedTid)) {
+                return 'already_waiting';
+            }
+
+            if ($payment->payment_status !== PaymentStatusEnum::READY) {
+                return 'not_payable';
+            }
+
+            $vbankDueAt = null;
+            if (isset($pgResponse['VbankExpDate'])) {
+                $dateStr = $pgResponse['VbankExpDate'].($pgResponse['VbankExpTime'] ?? '235959');
+                $vbankDueAt = Carbon::createFromFormat('YmdHis', $dateStr);
+            }
+
+            $payment->payment_status = PaymentStatusEnum::WAITING_DEPOSIT;
+            $payment->pg_provider = 'nicepayments';
+            $payment->vbank_name = $pgResponse['VbankBankName'] ?? null;
+            $payment->vbank_number = $pgResponse['VbankNum'] ?? null;
+            $payment->vbank_due_at = $vbankDueAt;
+            $payment->vbank_issued_at = now();
+            $payment->is_escrow = $isEscrow;
+            $payment->payment_meta = [
+                'result_code' => $resultCode,
+                'pay_method' => $payMethod,
+                'auth_date' => $pgResponse['AuthDate'] ?? null,
+                'mid' => $this->apiService->getMid(),
+                'vbank_tid' => $issuedTid,
+                'vbank_num' => $pgResponse['VbankNum'] ?? null,
+                'vbank_name' => $pgResponse['VbankBankName'] ?? null,
+                'vbank_exp_date' => isset($pgResponse['VbankExpDate'])
+                    ? $pgResponse['VbankExpDate'].($pgResponse['VbankExpTime'] ?? '235959')
+                    : null,
+                'is_test_mode' => $this->apiService->isTestMode(),
+                'pg_response_sanitized' => true,
+                'pg_raw_response' => $this->sanitizePgResponse($pgResponse, self::VBANK_ISSUE_RESPONSE_KEYS),
+            ];
+            $payment->save();
+
+            return 'recorded';
+        });
+    }
+
+    private function completeAuthorizedPaymentWithLock(
+        string $moid,
+        array $pgResponse,
+        string $txTid,
+        int $amt,
+        bool $isEscrow,
+        Request $request,
+        array $callbackPayload,
+    ): string {
+        return DB::transaction(function () use ($moid, $pgResponse, $txTid, $amt, $isEscrow, $request, $callbackPayload): string {
+            $lockedOrder = Order::query()
+                ->where('order_number', $moid)
+                ->lockForUpdate()
+                ->first();
+
+            if (! $lockedOrder) {
+                return 'order_not_found';
+            }
+
+            $payment = $lockedOrder->payment()->lockForUpdate()->first();
+            if (! $payment) {
+                return 'payment_not_found';
+            }
+
+            $effectiveTid = (string) ($pgResponse['TID'] ?? $txTid);
+            if ($payment->isPaid() && hash_equals((string) $payment->transaction_id, $effectiveTid)) {
+                return 'already_paid';
+            }
+
+            if ($payment->isPaid()) {
+                return 'paid_with_other_tid';
+            }
+
+            if (! $lockedOrder->order_status->isBeforePayment()
+                || $payment->payment_status !== PaymentStatusEnum::READY) {
+                return 'not_payable';
+            }
+
+            $lockedOrder->setRelation('payment', $payment);
+            $easyPayMeta = $this->resolveEasyPayMeta(array_merge($pgResponse, $callbackPayload));
+
+            $this->orderService->completePayment($lockedOrder, [
+                'transaction_id' => $effectiveTid,
+                'card_approval_number' => $pgResponse['AppNo'] ?? null,
+                'card_number_masked' => $pgResponse['CardNum'] ?? null,
+                'card_name' => $pgResponse['IssuCardName'] ?? $pgResponse['CardName'] ?? null,
+                'card_installment_months' => (int) ($pgResponse['CardQuota'] ?? 0),
+                'is_interest_free' => false,
+                'embedded_pg_provider' => $easyPayMeta['provider'] ?? null,
+                'receipt_url' => 'https://npg.nicepay.co.kr/issue/IssueLoader.do?type=0&TID='.rawurlencode($effectiveTid),
+                'payment_meta' => [
+                    'result_code' => $pgResponse['ResultCode'] ?? null,
+                    ...($easyPayMeta === [] ? [] : [
+                        'nicepay_easy_pay_method' => $easyPayMeta['method'],
+                        'nicepay_easy_pay_provider' => $easyPayMeta['provider'],
+                        'nicepay_easy_pay_label' => $easyPayMeta['label'],
+                        'embedded_pg_provider' => $easyPayMeta['provider'],
+                        'embedded_pg_provider_label' => $easyPayMeta['label'],
+                    ]),
+                    'pay_method' => $pgResponse['PayMethod'] ?? null,
+                    'auth_date' => $pgResponse['AuthDate'] ?? null,
+                    'mid' => $this->apiService->getMid(),
+                    'is_test_mode' => $this->apiService->isTestMode(),
+                    'rcpt_tid' => $pgResponse['RcptTID'] ?? null,
+                    'pg_response_sanitized' => true,
+                    'pg_raw_response' => $this->sanitizePgResponse($pgResponse, self::AUTH_RESPONSE_KEYS),
+                ],
+                'payment_device' => DeviceDetector::detect($request),
+            ], $amt);
+
+            $lockedOrder->refresh();
+            $pgUpdates = ['pg_provider' => 'nicepayments'];
+            if ($isEscrow) {
+                $pgUpdates['is_escrow'] = true;
+            }
+            $lockedOrder->payment?->update($pgUpdates);
+
+            return 'completed';
+        });
+    }
+
+    /**
+     * 결제 요청 SignData 생성
+     *
+     * POST /plugins/sirsoft-pay_nicepayments/payment/sign-data
+     */
+    /**
+     * 결제 요청 SignData 생성
+     *
+     * 클라이언트가 결제창 호출 직전에 EdiDate + SignData 를 발급받기 위해 호출.
+     * 비회원 결제도 호출하므로 라우트 인증에는 의존하지 않는다.
+     * MOID, 주문 상태, 나이스페이 결제 레코드, Amt 를 우리 DB 와 비교 검증하여
+     * 클라이언트 측 주문/금액 조작을 차단한다.
+     *
+     * @param  Request  $request  amt + moid
+     * @return JsonResponse ediDate / signData / mid 또는 400/422
+     */
+    public function signData(Request $request): JsonResponse
+    {
+        $amt = (int) $request->input('amt', 0);
+        $moid = (string) $request->input('moid', '');
+
+        if ($amt <= 0 || $moid === '') {
+            return response()->json(['error' => __('sirsoft-pay_nicepayments::messages.errors.invalid_request')], 400);
+        }
+
+        $rateLimitKey = $this->signDataRateLimitKey($request, $moid);
+        if (RateLimiter::tooManyAttempts($rateLimitKey, 20)) {
+            return response()->json(['error' => __('sirsoft-pay_nicepayments::messages.errors.invalid_request')], 429);
+        }
+        RateLimiter::hit($rateLimitKey, 60);
+
+        // 주문 금액 검증: 클라이언트가 임의 금액으로 SignData를 요청하는 조작 방지
+        $order = $this->orderService->findByOrderNumber($moid);
+
+        if (! $order) {
+            Log::warning('NicePayments: SignData - order not found', [
+                'moid' => $moid,
+                'ip' => $request->ip(),
+            ]);
+
+            return response()->json(['error' => __('sirsoft-pay_nicepayments::messages.errors.order_not_found')], 422);
+        }
+
+        if (! $this->requestMatchesOrderBuyer($request, $order)) {
+            Log::warning('NicePayments: SignData buyer verification failed', [
+                'moid' => $moid,
+                'ip' => $request->ip(),
+            ]);
+
+            return response()->json(['error' => __('sirsoft-pay_nicepayments::messages.errors.invalid_request')], 403);
+        }
+
+        $payment = $order->payment()->first();
+
+        if (! $payment || $payment->pg_provider !== 'nicepayments') {
+            Log::warning('NicePayments: SignData rejected for non-payable order', [
+                'moid' => $moid,
+                'order_status' => $order->order_status->value,
+                'payment_status' => $payment?->payment_status?->value,
+                'pg_provider' => $payment?->pg_provider,
+                'ip' => $request->ip(),
+            ]);
+
+            return response()->json(['error' => __('sirsoft-pay_nicepayments::messages.errors.invalid_request')], 422);
+        }
+
+        // 결제 청구액 SSoT = 결제 통화(order_currency) 환산액 (마일리지/예치금 차감 후 실청구액).
+        // 클라이언트 SignData 요청액(amt = pg_payment_data.amount = resolveOrderPaymentChargeAmount)·
+        // 코어 최종 승인 검증과 동일 기준. base≠결제 통화(예: base JPY, 결제 KRW)에서도 단위가 일치한다.
+        $expectedChargeAmount = $this->resolveExpectedPaymentPriceOrNull($order, 'sign_data', [
+            'moid' => $moid,
+            'requested_amt' => $amt,
+            'ip' => $request->ip(),
+        ]);
+        if ($expectedChargeAmount === null) {
+            return response()->json(['error' => __('sirsoft-pay_nicepayments::messages.errors.invalid_request')], 422);
+        }
+
+        if ($expectedChargeAmount !== $amt) {
+            Log::warning('NicePayments: SignData amount mismatch', [
+                'moid' => $moid,
+                'requested_amt' => $amt,
+                'actual_amt' => $expectedChargeAmount,
+                'ip' => $request->ip(),
+            ]);
+
+            return response()->json(['error' => __('sirsoft-pay_nicepayments::messages.errors.invalid_amount')], 422);
+        }
+
+        if (! $order->order_status->isBeforePayment() || $payment->payment_status !== PaymentStatusEnum::READY) {
+            if (! $this->restoreRetryableNicepayOrder($order, $payment)) {
+                Log::warning('NicePayments: SignData rejected for non-payable order', [
+                    'moid' => $moid,
+                    'order_status' => $order->order_status->value,
+                    'payment_status' => $payment->payment_status?->value,
+                    'pg_provider' => $payment->pg_provider,
+                    'ip' => $request->ip(),
+                ]);
+
+                return response()->json(['error' => __('sirsoft-pay_nicepayments::messages.errors.invalid_request')], 422);
+            }
+        }
+
+        $mid = trim($this->apiService->getMid());
+        if ($mid === '') {
+            Log::error('NicePayments: SignData rejected because MID is not configured', [
+                'moid' => $moid,
+                'is_test_mode' => $this->apiService->isTestMode(),
+            ]);
+
+            return response()->json(['error' => __('sirsoft-pay_nicepayments::messages.errors.invalid_request')], 422);
+        }
+
+        $ediDate = $this->apiService->generateEdiDate();
+        $signData = $this->apiService->generateSignData($ediDate, $amt);
+
+        return response()->json([
+            'ediDate' => $ediDate,
+            'signData' => $signData,
+            'mid' => $mid,
+        ]);
+    }
+
+    private function signDataRateLimitKey(Request $request, string $moid): string
+    {
+        return 'sirsoft-pay_nicepayments:sign-data:'.sha1($request->ip().'|'.$moid);
+    }
+
+    /**
+     * 가상계좌 입금 통보 처리
+     *
+     * POST /plugins/sirsoft-pay_nicepayments/payment/vbank-notify
+     * 공식 매뉴얼: https://developers.nicepay.co.kr/manual-noti.php
+     *
+     * 동작:
+     *   - ResultCode === '4110' 입금완료 통보만 결제완료 처리
+     *   - 그 외 ResultCode (계좌발급, 입금취소 등) 는 로깅만 하고 OK 응답
+     *   - 어떤 결과든 200 + 정확히 "OK" (text/plain) 를 돌려줘야 NicePay 가 재시도하지 않음
+     *   - 한글 인코딩(EUC-KR) 은 VbankNotifyRequest::prepareForValidation 에서 UTF-8 로 변환됨
+     *
+     * 공식 spec 에 입금통보 Signature 가 없어 위변조 검증은 하지 않으며, 대신:
+     *   - 발송 IP 화이트리스트 (VbankNotifyRequest::authorize)
+     *   - TID/MOID/Amt 가 우리 DB 의 임시 발급 정보와 일치하는지 비교
+     *   - 동일 TID 중복 처리 방지 (행 잠금)
+     *   세 단계로 위변조/재처리 방어.
+     */
+    /**
+     * 가상계좌 입금 통보 처리
+     *
+     * NicePay 서버가 직접 호출하는 입금 확인 웹훅. ResultCode 4110(입금완료) 만
+     * 결제완료 처리하고 그 외 코드는 payment_meta 에 timeline 으로 누적.
+     * 어떤 결과든 200 + 정확히 "OK" 응답으로 NicePay 재시도 차단.
+     *
+     * @param  VbankNotifyRequest  $request  검증된 입금통보 페이로드 (EUC-KR → UTF-8 변환됨)
+     * @return Response 항상 200 + "OK" (text/plain)
+     */
+    public function vbankNotify(VbankNotifyRequest $request): Response
+    {
+        $validated = $request->validated();
+
+        $tid = (string) $validated['TID'];
+        $moid = (string) $validated['MOID'];
+        $amt = (int) $validated['Amt'];
+        $resultCode = (string) $validated['ResultCode'];
+
+        // 입금완료 통보 (4110) 만 결제완료 처리.
+        // 4100/계좌발급은 authCallback 에서 이미 처리됐고, 그 외 코드는 입금취소/오류 등.
+        $isDeposited = $resultCode === '4110';
+        $isCancellation = ! empty($validated['CancelDate'])
+            || in_array((string) ($validated['StateCd'] ?? ''), ['1', '2'], true);
+
+        // 통보 종류 라벨 (어드민/로그용)
+        $notiType = $isDeposited ? 'deposited' : ($isCancellation ? 'cancelled' : 'other');
+
+        if (! $isDeposited) {
+            Log::info(
+                'NicePayments: vbank notify '.($isCancellation ? 'cancellation' : 'non-deposit'),
+                [
+                    'tid' => $tid,
+                    'moid' => $moid,
+                    'result_code' => $resultCode,
+                    'state_cd' => $validated['StateCd'] ?? null,
+                    'cancel_date' => $validated['CancelDate'] ?? null,
+                    'result_msg' => $validated['ResultMsg'] ?? null,
+                ]
+            );
+
+            // 입금완료가 아니어도 어드민이 통보 시점/내용을 확인할 수 있도록 이력 저장.
+            // 4100(계좌발급)·취소·재통보 모두 누적되어 어드민 패널에서 timeline 으로 보임.
+            $this->recordVbankNotification($moid, $tid, $amt, $resultCode, $notiType, $validated);
+
+            return response('OK', 200)->header('Content-Type', 'text/plain');
+        }
+
+        try {
+            $order = $this->orderService->findByOrderNumber($moid);
+
+            if (! $order) {
+                Log::error('NicePayments: vbank notify - order not found', ['moid' => $moid, 'tid' => $tid]);
+
+                return response('FAIL', 200)->header('Content-Type', 'text/plain');
+            }
+
+            $alreadyProcessed = false;
+            $contextError = null;
+
+            DB::transaction(function () use ($order, $tid, $amt, $validated, &$alreadyProcessed, &$contextError): void {
+                // 동시 입금 통보 중복 처리 방지: 행 단위 잠금
+                $payment = $order->payment()->lockForUpdate()->first();
+
+                if (! $payment) {
+                    $contextError = 'payment_not_found';
+
+                    return;
+                }
+
+                if ($payment->isPaid() && hash_equals((string) $payment->transaction_id, $tid)) {
+                    $alreadyProcessed = true;
+
+                    return;
+                }
+
+                $contextError = $this->validateVbankNotifyContext($order, $payment, $validated, $tid, $amt);
+                if ($contextError !== null) {
+                    return;
+                }
+
+                // 기존 통보 이력 보존 — completePayment 가 payment_meta 를 통째로 교체할 수 있어
+                // 미리 머지한 메타를 만들어 전달
+                $existingNotifications = is_array($payment?->payment_meta['vbank_notifications'] ?? null)
+                    ? $payment->payment_meta['vbank_notifications']
+                    : [];
+
+                $newEntry = $this->buildVbankNotificationEntry('4110', $amt, 'deposited', $validated);
+                $allNotifications = array_merge($existingNotifications, [$newEntry]);
+
+                $this->orderService->completePayment($order, [
+                    'transaction_id' => $tid,
+                    'receipt_url' => 'https://npg.nicepay.co.kr/issue/IssueLoader.do?type=0&TID='.rawurlencode($tid),
+                    'payment_meta' => [
+                        'result_code' => '4110',
+                        'auth_date' => $validated['AuthDate'] ?? null,
+                        'auth_code' => $validated['AuthCode'] ?? null,
+                        'mid' => $validated['MID'] ?? $this->apiService->getMid(),
+                        'vbank_tid' => $tid,
+                        'vbank_num' => $validated['VbankNum'] ?? null,
+                        'vbank_name' => $validated['VbankName'] ?? null,
+                        'vbank_input_name' => $validated['VbankInputName'] ?? null,
+                        'fn_cd' => $validated['FnCd'] ?? null,
+                        'fn_name' => $validated['FnName'] ?? null,
+                        'is_test_mode' => $this->apiService->isTestMode(),
+                        'rcpt_tid' => $validated['RcptTID'] ?? null,
+                        'pg_response_sanitized' => true,
+                        'pg_raw_response' => $this->sanitizePgResponse($validated, self::VBANK_NOTIFY_RESPONSE_KEYS),
+                        // 어드민 표시용 통보 이력 (전체 누적)
+                        'vbank_notifications' => $allNotifications,
+                        'vbank_notification_summary' => $this->buildNotificationSummary($allNotifications),
+                    ],
+                ], $amt);
+
+                // pg_provider 명시 설정 (completePayment가 이 필드를 업데이트하지 않을 수 있음)
+                $order->refresh();
+                $order->payment?->update(['pg_provider' => 'nicepayments']);
+            });
+
+            if ($contextError !== null) {
+                Log::warning('NicePayments: vbank notify context mismatch', [
+                    'reason' => $contextError,
+                    'tid' => $tid,
+                    'moid' => $moid,
+                    'amt' => $amt,
+                ]);
+
+                return response('FAIL', 200)->header('Content-Type', 'text/plain');
+            } elseif ($alreadyProcessed) {
+                Log::info('NicePayments: vbank notify - already processed', ['tid' => $tid, 'moid' => $moid]);
+            } else {
+                Log::info('NicePayments: vbank deposit confirmed', [
+                    'tid' => $tid,
+                    'moid' => $moid,
+                    'amt' => $amt,
+                    'auth_date' => $validated['AuthDate'] ?? null,
+                ]);
+            }
+
+            return response('OK', 200)->header('Content-Type', 'text/plain');
+
+        } catch (\Exception $e) {
+            Log::error('NicePayments: vbank notify failed', [
+                'tid' => $tid,
+                'moid' => $moid,
+                'error' => $e->getMessage(),
+            ]);
+
+            return response('FAIL', 200)->header('Content-Type', 'text/plain');
+        }
+    }
+
+    private function validateVbankNotifyContext(
+        Order $order,
+        OrderPayment $payment,
+        array $validated,
+        string $tid,
+        int $amount,
+    ): ?string {
+        if (! in_array($payment->payment_method?->value, ['vbank', 'virtual_account'], true)) {
+            return 'payment_method_not_vbank';
+        }
+
+        if ($payment->payment_status !== PaymentStatusEnum::WAITING_DEPOSIT) {
+            return 'payment_not_waiting_deposit';
+        }
+
+        $meta = $payment->payment_meta ?? [];
+        $storedTid = trim((string) ($payment->transaction_id ?: ($meta['vbank_tid'] ?? '')));
+        if ($storedTid === '' || ! hash_equals($storedTid, $tid)) {
+            return 'tid_mismatch';
+        }
+
+        $storedMid = trim((string) ($meta['mid'] ?? ''));
+        $expectedMid = $storedMid !== '' ? $storedMid : $this->apiService->getMid();
+        $receivedMid = trim((string) ($validated['MID'] ?? ''));
+        if ($expectedMid === '' || $receivedMid === '' || ! hash_equals($expectedMid, $receivedMid)) {
+            return 'mid_mismatch';
+        }
+
+        $storedAccount = trim((string) ($payment->vbank_number ?: ($meta['vbank_num'] ?? '')));
+        $receivedAccount = trim((string) ($validated['VbankNum'] ?? ''));
+        if ($storedAccount === '' || $receivedAccount === '' || ! hash_equals($storedAccount, $receivedAccount)) {
+            return 'vbank_account_mismatch';
+        }
+
+        $expectedAmount = $this->resolveExpectedPaymentPriceOrNull($order, 'vbank_notify', [
+            'tid' => $tid,
+            'received_amt' => $amount,
+        ]);
+        if ($expectedAmount === null) {
+            return 'invalid_payment_currency';
+        }
+
+        if ($amount !== $expectedAmount) {
+            return 'amount_mismatch';
+        }
+
+        return null;
+    }
+
+    private function restoreRetryableNicepayOrder(Order $order, OrderPayment $payment): bool
+    {
+        if (! $this->isRetryableNicepayFailure($order, $payment)) {
+            return false;
+        }
+
+        DB::transaction(function () use ($order, $payment) {
+            $now = now()->toIso8601String();
+            $orderMeta = $order->order_meta ?? [];
+            $paymentMeta = $payment->payment_meta ?? [];
+
+            $previousFailure = array_filter([
+                'code' => $orderMeta['payment_failure_code'] ?? $paymentMeta['failure_code'] ?? null,
+                'message' => $orderMeta['payment_failure_message'] ?? $paymentMeta['failure_message'] ?? null,
+                'failed_at' => $orderMeta['payment_failed_at'] ?? $paymentMeta['failed_at'] ?? null,
+            ], fn ($value) => $value !== null && $value !== '');
+
+            if ($previousFailure !== []) {
+                $history = $orderMeta['nicepayments_retry_failures'] ?? [];
+                $history = is_array($history) ? $history : [];
+                $history[] = $previousFailure;
+                $orderMeta['nicepayments_retry_failures'] = array_slice($history, -5);
+            }
+
+            unset(
+                $orderMeta['payment_failure_code'],
+                $orderMeta['payment_failure_message'],
+                $orderMeta['payment_failed_at'],
+                $paymentMeta['failure_code'],
+                $paymentMeta['failure_message'],
+                $paymentMeta['failed_at'],
+                $paymentMeta['failure_source'],
+            );
+
+            $orderMeta['nicepayments_retry_count'] = (int) ($orderMeta['nicepayments_retry_count'] ?? 0) + 1;
+            $orderMeta['nicepayments_retry_started_at'] = $now;
+            $paymentMeta['retry_count'] = (int) ($paymentMeta['retry_count'] ?? 0) + 1;
+            $paymentMeta['retry_started_at'] = $now;
+
+            $order->update([
+                'order_status' => OrderStatusEnum::PENDING_ORDER,
+                'order_meta' => $orderMeta,
+            ]);
+
+            $payment->update([
+                'payment_status' => PaymentStatusEnum::READY,
+                'payment_meta' => $paymentMeta,
+                'paid_at' => null,
+                'cancelled_at' => null,
+            ]);
+        });
+
+        Log::info('NicePayments: retryable failed order restored for SignData', [
+            'moid' => $order->order_number,
+            'payment_id' => $payment->id,
+        ]);
+
+        return true;
+    }
+
+    private function isRetryableNicepayFailure(Order $order, OrderPayment $payment): bool
+    {
+        $paymentMeta = $payment->payment_meta ?? [];
+        $failureCode = (string) ($paymentMeta['failure_code'] ?? $order->order_meta['payment_failure_code'] ?? '');
+
+        return $order->order_status === OrderStatusEnum::CANCELLED
+            && $payment->pg_provider === 'nicepayments'
+            && $payment->payment_status === PaymentStatusEnum::FAILED
+            && ($paymentMeta['failure_source'] ?? null) === 'nicepayments'
+            && $failureCode !== 'AMOUNT_MISMATCH'
+            && blank($payment->transaction_id)
+            && blank($payment->card_approval_number)
+            && $payment->paid_at === null;
+    }
+
+    private function resolveSuccessUrl(string $orderId): string
+    {
+        $settings = $this->pluginSettingsService->get(self::PLUGIN_IDENTIFIER) ?? [];
+        $urlTemplate = $settings['redirect_success_url'] ?? '/shop/orders/{orderId}/complete';
+        $url = str_replace('{orderId}', $orderId, $urlTemplate);
+
+        return UrlHelper::toAbsolute($url);
+    }
+
+    private function resolveFailUrl(array $queryParams = []): string
+    {
+        $settings = $this->pluginSettingsService->get(self::PLUGIN_IDENTIFIER) ?? [];
+        $baseUrl = $settings['redirect_fail_url'] ?? '/shop/checkout';
+
+        if (! empty($queryParams)) {
+            $query = http_build_query(array_filter($queryParams));
+            $separator = str_contains($baseUrl, '?') ? '&' : '?';
+            $baseUrl = $baseUrl.$separator.$query;
+        }
+
+        return UrlHelper::toAbsolute($baseUrl);
+    }
+
+    /**
+     * 입금통보 1건의 어드민 표시용 entry 생성.
+     *
+     * 어드민 패널에서 timeline 형태로 보여줄 핵심 필드만 추려둠. raw 는 전체 보존.
+     */
+    private function buildVbankNotificationEntry(
+        string $resultCode,
+        int $amt,
+        string $type,
+        array $validated
+    ): array {
+        return [
+            'received_at' => now()->toIso8601String(),
+            'type' => $type, // 'deposited' | 'cancelled' | 'other'
+            'result_code' => $resultCode,
+            'result_msg' => $validated['ResultMsg'] ?? null,
+            'state_cd' => $validated['StateCd'] ?? null,
+            'amt' => $amt,
+            'tid' => $validated['TID'] ?? null,
+            'auth_date' => $validated['AuthDate'] ?? null,
+            'auth_code' => $validated['AuthCode'] ?? null,
+            'depositor' => $validated['VbankInputName'] ?? null,
+            'vbank_num' => $validated['VbankNum'] ?? null,
+            'vbank_name' => $validated['VbankName'] ?? null,
+            'cancel_date' => $validated['CancelDate'] ?? null,
+            'raw_sanitized' => true,
+            'raw' => $this->sanitizePgResponse($validated, self::VBANK_NOTIFY_RESPONSE_KEYS),
+        ];
+    }
+
+    /**
+     * 입금완료가 아닌 통보 (계좌발급/취소/오류/재통보) 를 payment_meta 에 누적.
+     *
+     * 어드민이 "언제 어떤 통보가 왔는지" 추적할 수 있도록 모든 이벤트를 기록.
+     * 주문/결제가 없으면 조용히 skip (위변조 방어 — 우리 DB 에 없는 주문은 무시).
+     */
+    private function recordVbankNotification(
+        string $moid,
+        string $tid,
+        int $amt,
+        string $resultCode,
+        string $type,
+        array $validated
+    ): void {
+        try {
+            DB::transaction(function () use ($moid, $amt, $resultCode, $type, $validated): void {
+                $order = $this->orderService->findByOrderNumber($moid);
+                if (! $order) {
+                    return;
+                }
+
+                $payment = $order->payment()->lockForUpdate()->first();
+                if (! $payment) {
+                    return;
+                }
+
+                $existing = is_array($payment->payment_meta['vbank_notifications'] ?? null)
+                    ? $payment->payment_meta['vbank_notifications']
+                    : [];
+
+                $entry = $this->buildVbankNotificationEntry($resultCode, $amt, $type, $validated);
+                $existing[] = $entry;
+
+                $payment->payment_meta = array_merge($payment->payment_meta ?? [], [
+                    'vbank_notifications' => $existing,
+                    'vbank_notification_summary' => $this->buildNotificationSummary($existing),
+                ]);
+                $payment->save();
+            });
+        } catch (\Throwable $e) {
+            // 통보 이력 기록 실패가 OK 응답 자체를 막아 NicePay 재시도를 유발하지 않도록 swallow.
+            Log::warning('NicePayments: failed to record vbank notification entry', [
+                'moid' => $moid,
+                'tid' => $tid,
+                'error' => $e->getMessage(),
+            ]);
+        }
+    }
+
+    /**
+     * 어드민 패널 한 줄 요약용 데이터.
+     *
+     * - first_received_at / last_received_at: 첫·마지막 통보 시각
+     * - count: 누적 통보 횟수 (재통보 포함)
+     * - last_type / last_result_code: 마지막 통보 종류
+     * - deposited_at / cancelled_at: 입금완료·입금취소가 있었던 경우의 시각
+     */
+    private function buildNotificationSummary(array $notifications): array
+    {
+        if (empty($notifications)) {
+            return [];
+        }
+
+        $first = $notifications[0];
+        $last = end($notifications);
+        reset($notifications);
+
+        $depositedAt = null;
+        $cancelledAt = null;
+        foreach ($notifications as $n) {
+            if (($n['type'] ?? '') === 'deposited' && $depositedAt === null) {
+                $depositedAt = $n['received_at'] ?? null;
+            }
+            if (($n['type'] ?? '') === 'cancelled') {
+                $cancelledAt = $n['received_at'] ?? null;
+            }
+        }
+
+        return [
+            'count' => count($notifications),
+            'first_received_at' => $first['received_at'] ?? null,
+            'last_received_at' => $last['received_at'] ?? null,
+            'last_type' => $last['type'] ?? null,
+            'last_result_code' => $last['result_code'] ?? null,
+            'deposited_at' => $depositedAt,
+            'cancelled_at' => $cancelledAt,
+            'last_depositor' => $last['depositor'] ?? null,
+            'last_amt' => $last['amt'] ?? null,
+        ];
+    }
+
+    private function lastFour(string $value): ?string
+    {
+        $digits = $this->digitsOnly($value);
+        if ($digits === '') {
+            return null;
+        }
+
+        return substr($digits, -4);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/src/Controllers/PaymentCloseReportController.php b/plugins/_bundled/sirsoft-pay_nicepayments/src/Controllers/PaymentCloseReportController.php
new file mode 100644
index 00000000..b63757b3
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/src/Controllers/PaymentCloseReportController.php
@@ -0,0 +1,166 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Controllers;
+
+use App\Helpers\ResponseHelper;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\RateLimiter;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentStatusEnum;
+use Modules\Sirsoft\Ecommerce\Models\Order;
+use Modules\Sirsoft\Ecommerce\Services\OrderProcessingService;
+use Plugins\Sirsoft\PayNicepayments\Concerns\RecordsPaymentWindowClosure;
+use Plugins\Sirsoft\PayNicepayments\Http\Requests\PaymentCloseReportRequest;
+
+class PaymentCloseReportController
+{
+    use RecordsPaymentWindowClosure;
+
+    private const FAILURE_CODE = 'USER_CANCEL';
+
+    private const FAILURE_MESSAGE = '사용자가 나이스페이먼츠 결제창을 닫았습니다.';
+
+    public function __construct(
+        private readonly OrderProcessingService $orderService,
+    ) {}
+
+    /**
+     * PC 결제창 닫힘 보고를 검증하고 결제 실패/취소 이력을 기록합니다.
+     *
+     * @param  PaymentCloseReportRequest  $request  결제창 닫힘 보고 요청
+     * @return JsonResponse 닫힘 보고 처리 결과
+     */
+    public function store(PaymentCloseReportRequest $request): JsonResponse
+    {
+        $validated = $request->validated();
+        $oid = $validated['oid'];
+        $price = (int) $validated['price'];
+
+        $rateLimitKey = $this->rateLimitKey($request, $oid);
+        if (RateLimiter::tooManyAttempts($rateLimitKey, 20)) {
+            return ResponseHelper::error('messages.failed', 429, [
+                'message' => ['Too many NicePayments payment close reports. Please try again later.'],
+            ]);
+        }
+        RateLimiter::hit($rateLimitKey, 60);
+
+        $order = $this->orderService->findByOrderNumber($oid);
+        if (! $order) {
+            return ResponseHelper::error('messages.failed', 404, [
+                'message' => ['Order not found.'],
+            ]);
+        }
+
+        if (! $this->requestMatchesOrderBuyer($request, $order)) {
+            return ResponseHelper::error('messages.failed', 403, [
+                'message' => ['Order buyer verification failed.'],
+            ]);
+        }
+
+        $expectedPrice = $this->resolveExpectedPaymentPriceOrNull($order, 'close_report', [
+            'oid' => $oid,
+            'received_price' => $price,
+            'ip' => $request->ip(),
+        ]);
+        if ($expectedPrice === null) {
+            return ResponseHelper::error('messages.failed', 422, [
+                'message' => ['Payment currency is not chargeable.'],
+            ]);
+        }
+
+        if ($price !== $expectedPrice) {
+            return ResponseHelper::error('messages.failed', 422, [
+                'message' => ['Payment amount does not match the order amount.'],
+            ]);
+        }
+
+        $closeReason = trim((string) ($validated['reason'] ?? ''));
+        $result = $this->recordCloseReportWithLock(
+            $oid,
+            $price,
+            $closeReason !== '' ? $closeReason : self::FAILURE_MESSAGE,
+        );
+
+        if (($result['status'] ?? null) === 'amount_mismatch') {
+            return ResponseHelper::error('messages.failed', 422, [
+                'message' => ['Payment amount does not match the order amount.'],
+            ]);
+        }
+
+        if (($result['status'] ?? null) === 'invalid_payment_currency') {
+            return ResponseHelper::error('messages.failed', 422, [
+                'message' => ['Payment currency is not chargeable.'],
+            ]);
+        }
+
+        if (($result['status'] ?? null) === 'ignored') {
+            return ResponseHelper::success('messages.success', [
+                'status' => 'ignored',
+                'reason' => $result['reason'] ?? 'order_not_payable',
+            ]);
+        }
+
+        return ResponseHelper::success('messages.success', [
+            'status' => 'recorded',
+        ]);
+    }
+
+    private function rateLimitKey(PaymentCloseReportRequest $request, string $oid): string
+    {
+        return 'sirsoft-pay_nicepayments:payment-close-report:'.sha1($request->ip().'|'.$oid);
+    }
+
+    /**
+     * @return array{status: string, reason?: string}
+     */
+    private function recordCloseReportWithLock(string $oid, int $price, string $closeReason): array
+    {
+        return DB::transaction(function () use ($oid, $price, $closeReason): array {
+            $lockedOrder = Order::query()
+                ->where('order_number', $oid)
+                ->lockForUpdate()
+                ->first();
+
+            if (! $lockedOrder || ! $lockedOrder->order_status->isBeforePayment()) {
+                return ['status' => 'ignored', 'reason' => 'order_not_payable'];
+            }
+
+            $payment = $lockedOrder->payment()->lockForUpdate()->first();
+            $lockedOrder->setRelation('payment', $payment);
+
+            // close-report 는 결제창이 승인/발급 단계로 넘어가기 전 READY 상태만 실패 처리한다.
+            // 카드 승인 콜백과 경쟁해 PAID 가 먼저 저장됐거나, 가상계좌 발급으로 WAITING_DEPOSIT 이
+            // 된 주문은 닫힘 보고가 뒤늦게 도착해도 주문/결제 상태를 덮으면 안 된다.
+            if ($payment?->isPaid()) {
+                return ['status' => 'ignored', 'reason' => 'payment_already_paid'];
+            }
+            if (! $payment || $payment->payment_status !== PaymentStatusEnum::READY) {
+                return ['status' => 'ignored', 'reason' => 'payment_not_ready'];
+            }
+
+            $expectedPrice = $this->resolveExpectedPaymentPriceOrNull($lockedOrder, 'close_report_locked', [
+                'oid' => $oid,
+                'received_price' => $price,
+            ]);
+            if ($expectedPrice === null) {
+                return ['status' => 'invalid_payment_currency'];
+            }
+
+            if ($price !== $expectedPrice) {
+                return ['status' => 'amount_mismatch'];
+            }
+
+            $this->markPaymentWindowClosed(
+                $this->orderService,
+                $lockedOrder,
+                self::FAILURE_CODE,
+                self::FAILURE_MESSAGE,
+                $closeReason,
+            );
+
+            return ['status' => 'recorded'];
+        });
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/src/Controllers/UserReceiptController.php b/plugins/_bundled/sirsoft-pay_nicepayments/src/Controllers/UserReceiptController.php
new file mode 100644
index 00000000..c4037c4d
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/src/Controllers/UserReceiptController.php
@@ -0,0 +1,103 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Controllers;
+
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\DB;
+use Modules\Sirsoft\Ecommerce\Services\GuestOrderAuthService;
+use Plugins\Sirsoft\PayNicepayments\Concerns\IssuesReceiptCookie;
+use Plugins\Sirsoft\PayNicepayments\Concerns\ResolvesEasyPayDisplay;
+
+class UserReceiptController
+{
+    use IssuesReceiptCookie;
+    use ResolvesEasyPayDisplay;
+
+    private const RECEIPT_BASE_URL = 'https://npg.nicepay.co.kr/issue/IssueLoader.do';
+
+    public function __construct(
+        private readonly GuestOrderAuthService $guestOrderAuthService,
+    ) {}
+
+    /**
+     * 사용자 마이페이지 영수증 정보 조회
+     *
+     * 결제 영수증 URL(신용카드)과 현금영수증 URL(현금/계좌이체)을 반환한다.
+     * receipt_url 이 비어있으면 transaction_id 로 NicePay IssueLoader URL 을 동적 생성.
+     * 테스트 모드 결제는 is_test_mode=true 플래그로 표시되어 UI 에서 안내 가능.
+     *
+     * @param  Request  $request  회원 또는 비회원 영수증 요청
+     * @param  string  $orderNumber  주문번호
+     * @return JsonResponse receipt_url / cash_receipt_url / is_test_mode 또는 404
+     */
+    public function show(Request $request, string $orderNumber): JsonResponse
+    {
+        $user = $request->user();
+        $query = DB::table('ecommerce_order_payments as p')
+            ->join('ecommerce_orders as o', 'o.id', '=', 'p.order_id')
+            ->where('o.order_number', $orderNumber)
+            ->where('p.pg_provider', 'nicepayments');
+
+        if ($user) {
+            $query->where('o.user_id', $user->id);
+        } else {
+            $order = $this->guestOrderAuthService->verifyToken($request->header('X-Guest-Order-Token'), $orderNumber);
+
+            if ($order) {
+                $query->whereNull('o.user_id')->where('o.id', $order->id);
+            } elseif ($this->verifyReceiptCookie($request->cookie(self::RECEIPT_COOKIE_NAME), $orderNumber)) {
+                $query->whereNull('o.user_id')
+                    ->where('o.id', function ($sub) use ($orderNumber) {
+                        $sub->select('id')->from('ecommerce_orders')->where('order_number', $orderNumber);
+                    });
+            } else {
+                return response()->json(['error' => 'Not found'], 404);
+            }
+        }
+
+        $payment = $query
+            ->select([
+                'p.transaction_id',
+                'p.receipt_url',
+                'p.payment_meta',
+                'p.payment_method',
+                'p.embedded_pg_provider',
+            ])
+            ->first();
+
+        if (! $payment) {
+            return response()->json(['error' => 'Not found'], 404);
+        }
+
+        $receiptUrl = $payment->receipt_url;
+        if (! $receiptUrl && $payment->transaction_id) {
+            $receiptUrl = self::RECEIPT_BASE_URL . '?type=0&TID=' . rawurlencode($payment->transaction_id);
+        }
+
+        $cashReceiptUrl = null;
+        $isTestMode = false;
+        $display = $this->resolvePaymentDisplay($payment);
+        if ($payment->payment_meta) {
+            $meta = json_decode($payment->payment_meta, true);
+            $rcptTid = $meta['rcpt_tid'] ?? ($meta['pg_raw_response']['RcptTID'] ?? null);
+            if ($rcptTid) {
+                $cashReceiptUrl = self::RECEIPT_BASE_URL . '?type=1&TID=' . rawurlencode($rcptTid);
+            }
+            $isTestMode = (bool) ($meta['is_test_mode'] ?? false);
+        }
+
+        return response()->json([
+            'receipt_url' => $receiptUrl,
+            'cash_receipt_url' => $cashReceiptUrl,
+            'is_test_mode' => $isTestMode,
+            'payment_method_label' => $display['payment_method_label'],
+            'payment_method_display_label' => $display['payment_method_display_label'],
+            'selected_payment_method' => $display['selected_payment_method'],
+            'embedded_pg_provider' => $display['embedded_pg_provider'],
+            'embedded_pg_provider_label' => $display['embedded_pg_provider_label'],
+        ]);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/src/Exceptions/NicePayApiException.php b/plugins/_bundled/sirsoft-pay_nicepayments/src/Exceptions/NicePayApiException.php
new file mode 100644
index 00000000..debfc895
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/src/Exceptions/NicePayApiException.php
@@ -0,0 +1,20 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Exceptions;
+
+use RuntimeException;
+
+/**
+ * 나이스페이먼츠 PG API 호출 실패 예외
+ *
+ * NicePay 외부 API 호출 단계에서 발생하는 모든 실패 (HTTP 오류, ResultCode 비정상,
+ * 응답 파싱 실패, SSRF 방어 차단 등) 를 단일 도메인 예외로 통합한다.
+ *
+ * 베이스 \Exception / \RuntimeException 직접 throw 대신 본 클래스를 사용해
+ * 외부 소비자가 NicePay 도메인 오류만 선택적으로 catch 할 수 있도록 한다.
+ */
+class NicePayApiException extends RuntimeException
+{
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/src/Http/Middleware/VbankNotifyIpWhitelist.php b/plugins/_bundled/sirsoft-pay_nicepayments/src/Http/Middleware/VbankNotifyIpWhitelist.php
new file mode 100644
index 00000000..c41ebdab
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/src/Http/Middleware/VbankNotifyIpWhitelist.php
@@ -0,0 +1,46 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Http\Middleware;
+
+use Closure;
+use Illuminate\Http\Request;
+use Symfony\Component\HttpFoundation\Response;
+
+/**
+ * 가상계좌 입금통보 IP 화이트리스트 미들웨어
+ *
+ * NicePay 공식 발송 IP 만 허용. 로컬/테스트 환경(127.0.0.1, ::1)은 예외.
+ * 위변조/재처리 방어의 1차 게이트로, FormRequest::authorize() 대신 라우트
+ * 미들웨어 계층에서 처리해 권한 책임을 명확히 분리한다.
+ */
+class VbankNotifyIpWhitelist
+{
+    /** 나이스페이먼츠 공식 입금통보 발송 IP — 매뉴얼 INBOUND 섹션 */
+    private const ALLOWED_IPS = [
+        '121.133.126.10',
+        '121.133.126.11',
+        '211.33.136.39',
+    ];
+
+    /**
+     * 요청 IP 가 화이트리스트에 있는지 확인하고 통과 여부 결정
+     *
+     * @param  Request  $request  들어온 HTTP 요청
+     * @param  Closure  $next  다음 미들웨어
+     * @return Response 다음 미들웨어 응답 또는 403
+     */
+    public function handle(Request $request, Closure $next): Response
+    {
+        if (app()->environment('testing', 'local')) {
+            return $next($request);
+        }
+
+        if (! in_array($request->ip(), self::ALLOWED_IPS, true)) {
+            abort(403, 'Forbidden');
+        }
+
+        return $next($request);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/src/Http/Requests/AuthCallbackRequest.php b/plugins/_bundled/sirsoft-pay_nicepayments/src/Http/Requests/AuthCallbackRequest.php
new file mode 100644
index 00000000..ccb5a958
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/src/Http/Requests/AuthCallbackRequest.php
@@ -0,0 +1,89 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Http\Requests;
+
+use Illuminate\Contracts\Validation\Validator;
+use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Http\Exceptions\HttpResponseException;
+use Plugins\Sirsoft\PayNicepayments\Support\UrlHelper;
+
+/**
+ * 나이스페이먼츠 결제 승인 콜백 요청 검증
+ *
+ * POST /plugins/sirsoft-pay_nicepayments/payment/callback
+ *
+ * 나이스페이먼츠가 브라우저를 통해 POST 방식으로 전달하는 파라미터입니다.
+ */
+class AuthCallbackRequest extends FormRequest
+{
+    private const PLUGIN_IDENTIFIER = 'sirsoft-pay_nicepayments';
+
+    /**
+     * 콜백 요청 인가 — 외부 PG 호출이라 항상 true
+     *
+     * @return bool 항상 true
+     */
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * NicePay 콜백 페이로드 검증 규칙
+     *
+     * AuthResultCode 가 '0000' 이 아닐 때 (사용자 취소/실패) 는 NextAppURL 등
+     * 후속 필드가 없을 수 있어 strict 검증을 풀어 컨트롤러가 직접 분기 처리.
+     *
+     * @return array<string, mixed> Laravel 검증 규칙
+     */
+    public function rules(): array
+    {
+        // 사용자 취소 / 인증 실패 시 NicePay 는 NextAppURL / TxTid / AuthToken /
+        // Signature 등을 보내지 않거나 빈 값으로 보낸다. AuthResultCode 가
+        // '0000' 이 아닐 땐 strict 검증을 풀어 controller 가 직접 분기 처리하도록 한다.
+        // (그렇지 않으면 validation 단계에서 '?error=invalid_params' 로 redirect 되어
+        //  generic 에러 toast 가 뜨고 사용자 취소가 실제 에러처럼 보임)
+        $code = $this->input('AuthResultCode');
+
+        if ($code !== null && $code !== '0000') {
+            return [
+                'AuthResultCode' => ['required', 'string'],
+                'AuthResultMsg' => ['nullable', 'string'],
+                'Moid' => ['nullable', 'string'],
+                'Amt' => ['nullable', 'integer', 'min:1'],
+                'MallReserved' => ['nullable', 'string', 'max:1000'],
+                'MallReserved1' => ['nullable', 'string', 'max:20'],
+            ];
+        }
+
+        return [
+            'AuthResultCode' => ['required', 'string'],
+            'AuthResultMsg' => ['nullable', 'string'],
+            'NextAppURL' => ['required', 'string', 'url'],
+            'TxTid' => ['required', 'string'],
+            'AuthToken' => ['required', 'string'],
+            'PayMethod' => ['required', 'string'],
+            'MID' => ['required', 'string'],
+            'Moid' => ['required', 'string'],
+            'Amt' => ['required', 'integer', 'min:1'],
+            'NetCancelURL' => ['required', 'string', 'url'],
+            'Signature' => ['required', 'string'],
+            'MallReserved' => ['nullable', 'string', 'max:1000'],
+            'MallReserved1' => ['nullable', 'string', 'max:20'],
+        ];
+    }
+
+    protected function failedValidation(Validator $validator): void
+    {
+        $settings = plugin_settings(self::PLUGIN_IDENTIFIER);
+        $baseUrl = $settings['redirect_fail_url'] ?? '/shop/checkout';
+        $separator = str_contains($baseUrl, '?') ? '&' : '?';
+        $url = $baseUrl . $separator . http_build_query(['error' => 'invalid_params']);
+
+        throw new HttpResponseException(
+            redirect(UrlHelper::toAbsolute($url))
+        );
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/src/Http/Requests/PaymentCloseReportRequest.php b/plugins/_bundled/sirsoft-pay_nicepayments/src/Http/Requests/PaymentCloseReportRequest.php
new file mode 100644
index 00000000..ed0eb5cf
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/src/Http/Requests/PaymentCloseReportRequest.php
@@ -0,0 +1,37 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Http\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class PaymentCloseReportRequest extends FormRequest
+{
+    /**
+     * 결제창 닫힘 보고 요청을 허용합니다.
+     *
+     * @return bool 요청 허용 여부
+     */
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * 결제창 닫힘 보고 요청 검증 규칙을 반환합니다.
+     *
+     * @return array<string, array<int, string>> 필드별 검증 규칙
+     */
+    public function rules(): array
+    {
+        return [
+            'oid'            => ['required', 'string', 'max:40'],
+            'price'          => ['required', 'integer', 'min:1'],
+            'buyer_email'    => ['nullable', 'string', 'max:255'],
+            'buyer_phone'    => ['nullable', 'string', 'max:30'],
+            'payment_method' => ['nullable', 'string', 'max:50'],
+            'reason'         => ['nullable', 'string', 'max:160'],
+        ];
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/src/Http/Requests/VbankNotifyRequest.php b/plugins/_bundled/sirsoft-pay_nicepayments/src/Http/Requests/VbankNotifyRequest.php
new file mode 100644
index 00000000..8612b4ee
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/src/Http/Requests/VbankNotifyRequest.php
@@ -0,0 +1,147 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Http\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+/**
+ * 나이스페이먼츠 가상계좌 입금 통보 요청 검증
+ *
+ * POST /plugins/sirsoft-pay_nicepayments/payment/vbank-notify
+ * 공식 매뉴얼: https://developers.nicepay.co.kr/manual-noti.php
+ *
+ * NicePay 서버가 직접 호출하는 입금 확인 웹훅. 응답으로 정확히 "OK" (200, text/plain) 를
+ * 돌려줘야 하며, 그렇지 않으면 NicePay 가 최대 10회까지 재시도하고 실패 메일을 보낸다.
+ *
+ * 매뉴얼 필드명을 그대로 사용 (대소문자 정확히 일치):
+ *   필수: PG, PayMethod, MID, Amt, MOID, TID, ResultCode, AuthDate
+ *   가상계좌: VbankName, VbankNum, VbankInputName, FnCd, FnName, StateCd
+ *   기타: name(구매자), BuyerEmail, ResultMsg, CancelDate, MallReserved 등
+ *
+ * 한글 데이터는 매뉴얼상 EUC-KR 인코딩으로 들어오므로 prepareForValidation 에서
+ * UTF-8 로 자동 변환한다.
+ *
+ * 호환성 보호:
+ *   - Moid (소문자 i) 로 보내는 호환 케이스도 자동으로 MOID 로 매핑.
+ *   - Signature 필드는 공식 spec 에는 없으나 nullable 로 받아 차단되지 않게 한다.
+ *
+ * 보안: 발송 IP 는 NicePay 공식 IP 만 허용. 로컬/테스트 환경은 예외.
+ */
+class VbankNotifyRequest extends FormRequest
+{
+    /** 한글 인코딩 변환 대상 필드 (EUC-KR → UTF-8) */
+    private const TEXT_FIELDS_FOR_DECODE = [
+        'GoodsName',
+        'name',          // 구매자명
+        'VbankName',
+        'VbankInputName',
+        'FnName',
+        'ResultMsg',
+        'AuthResultMsg',
+        'MallReserved',
+    ];
+
+    /**
+     * FormRequest 인가 — 권한 검증은 vbank-notify.ip-whitelist 미들웨어에서 처리
+     *
+     * @return bool 항상 true
+     */
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * 한글 EUC-KR → UTF-8 변환 + 필드 alias 정규화.
+     */
+    protected function prepareForValidation(): void
+    {
+        $data = $this->all();
+
+        // 1) 한글 필드 EUC-KR → UTF-8 변환 (이미 UTF-8 인 경우는 보존)
+        foreach (self::TEXT_FIELDS_FOR_DECODE as $field) {
+            if (! isset($data[$field]) || ! is_string($data[$field]) || $data[$field] === '') {
+                continue;
+            }
+            $value = $data[$field];
+
+            // 이미 valid UTF-8 이면 그대로
+            if (mb_check_encoding($value, 'UTF-8')) {
+                // 단, ASCII 7-bit 가 아니고 EUC-KR 로도 valid 해서 모호한 경우는
+                // 한글 보였을 때만 decode 시도 — 매뉴얼이 EUC-KR 명시이므로 일단 보존
+                continue;
+            }
+
+            if (mb_check_encoding($value, 'EUC-KR') || mb_check_encoding($value, 'CP949')) {
+                $converted = @mb_convert_encoding($value, 'UTF-8', 'CP949'); // CP949 = EUC-KR superset
+                if (is_string($converted) && $converted !== '') {
+                    $data[$field] = $converted;
+                }
+            }
+        }
+
+        // 2) Moid (소문자 i) → MOID 정규화 — 일부 호환 환경 대응
+        if (! isset($data['MOID']) && isset($data['Moid'])) {
+            $data['MOID'] = $data['Moid'];
+        }
+
+        $this->replace($data);
+    }
+
+    /**
+     * 입금통보 페이로드 검증 규칙
+     *
+     * NicePay 매뉴얼 필드명을 그대로 사용. 한글(BuyerName 등) 은 EUC-KR 로
+     * 들어와 prepareForValidation 에서 UTF-8 로 변환된 후 검증.
+     *
+     * @return array<string, mixed> Laravel 검증 규칙
+     */
+    public function rules(): array
+    {
+        return [
+            // 필수 식별자
+            'TID' => ['required', 'string', 'max:30'],
+            'MOID' => ['required', 'string', 'max:64'],
+            'Amt' => ['required', 'integer', 'min:1'],
+            'ResultCode' => ['required', 'string', 'max:4'],
+
+            // 통보 메타 (공식 매뉴얼)
+            'PG' => ['nullable', 'string', 'max:10'],
+            'PayMethod' => ['nullable', 'string', 'max:10'],
+            'MID' => ['nullable', 'string', 'max:10'],
+            'MallUserID' => ['nullable', 'string', 'max:20'],
+            'AuthDate' => ['nullable', 'string', 'max:14'],
+            'AuthCode' => ['nullable', 'string', 'max:30'],
+            'StateCd' => ['nullable', 'string', 'max:1'],
+            'ResultMsg' => ['nullable', 'string', 'max:200'],
+            'GoodsName' => ['nullable', 'string', 'max:80'],
+            'name' => ['nullable', 'string', 'max:60'],
+            'BuyerEmail' => ['nullable', 'string', 'max:60'],
+
+            // 가상계좌 전용
+            'VbankName' => ['nullable', 'string', 'max:40'],
+            'VbankNum' => ['nullable', 'string', 'max:30'],
+            'VbankInputName' => ['nullable', 'string', 'max:40'],
+            'FnCd' => ['nullable', 'string', 'max:4'],
+            'FnName' => ['nullable', 'string', 'max:40'],
+
+            // 취소 (입금취소 통보 시)
+            'CancelDate' => ['nullable', 'string', 'max:14'],
+            'CancelMOID' => ['nullable', 'string', 'max:64'],
+
+            // 가맹점 사용자 정의
+            'MallReserved' => ['nullable', 'string', 'max:1000'],
+            'MallReserved1' => ['nullable', 'string', 'max:20'],
+            'TransType' => ['nullable', 'string', 'max:1'],
+            'CartCnt' => ['nullable', 'string', 'max:10'],
+
+            // 호환성: Moid 도 받음 (prepareForValidation 에서 MOID 로 매핑됨)
+            'Moid' => ['nullable', 'string'],
+
+            // 공식 spec 에 없으나 일부 환경에서 받을 수 있음 — 차단 안 되게 nullable
+            'Signature' => ['nullable', 'string'],
+        ];
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/src/Listeners/AdjustEcommercePaymentMethodsLayoutListener.php b/plugins/_bundled/sirsoft-pay_nicepayments/src/Listeners/AdjustEcommercePaymentMethodsLayoutListener.php
new file mode 100644
index 00000000..b1aabd02
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/src/Listeners/AdjustEcommercePaymentMethodsLayoutListener.php
@@ -0,0 +1,335 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Listeners;
+
+use App\Contracts\Extension\HookListenerInterface;
+
+/**
+ * 이커머스 결제수단 설정 화면에서 나이스페이먼츠 간편결제를 PG 선택 불필요 항목으로 표시한다.
+ */
+class AdjustEcommercePaymentMethodsLayoutListener implements HookListenerInterface
+{
+    private const TARGET_LAYOUT = 'admin_ecommerce_settings';
+
+    private const TEST_MODE_DATA_SOURCE_ID = 'nicepay_test_mode_status';
+
+    private const TEST_MODE_NOTICE_ID = 'payment_test_mode_order_settings_notice';
+
+    private const TEST_MODE_NOTICE_ROW_ID = 'nicepay_test_mode_order_settings_notice';
+
+    private const TEST_MODE_CONDITION = 'nicepay_test_mode_status.data?.is_test_mode === true';
+
+    private const CORE_NO_PG_METHODS = ['point', 'deposit', 'free', 'dbank'];
+
+    private const NICEPAY_NO_PG_METHODS = [
+        'nicepay_naverpay',
+        'nicepay_kakaopay',
+        'nicepay_samsungpay',
+        'nicepay_applepay',
+        'nicepay_payco',
+        'nicepay_skpay',
+        'nicepay_ssgpay',
+        'nicepay_lpay',
+    ];
+
+    /**
+     * @return array<string, array<string, mixed>>
+     */
+    public static function getSubscribedHooks(): array
+    {
+        return [
+            'core.layout_extension.after_apply' => [
+                'method' => 'markEasyPayMethodsAsPgNotRequired',
+                'type' => 'filter',
+                'priority' => 40,
+            ],
+        ];
+    }
+
+    /**
+     * @param mixed ...$args
+     */
+    public function handle(...$args): void {}
+
+    /**
+     * @param array<string, mixed> $layout
+     * @param int $templateId
+     * @return array<string, mixed>
+     */
+    public function markEasyPayMethodsAsPgNotRequired(array $layout, int $templateId): array
+    {
+        if (($layout['layout_name'] ?? '') !== self::TARGET_LAYOUT) {
+            return $layout;
+        }
+
+        $layout = $this->replaceNoPgMethodExpressions($layout);
+
+        return $this->ensureTestModeWarning($layout);
+    }
+
+    /**
+     * @param array<string, mixed> $node
+     * @return array<string, mixed>
+     */
+    private function replaceNoPgMethodExpressions(array $node): array
+    {
+        foreach ($node as $key => $value) {
+            if (is_array($value)) {
+                $node[$key] = $this->replaceNoPgMethodExpressions($value);
+                continue;
+            }
+
+            if (is_string($value)) {
+                $node[$key] = $this->addNicepayMethodsToNoPgArray($value);
+            }
+        }
+
+        return $node;
+    }
+
+    private function addNicepayMethodsToNoPgArray(string $expression): string
+    {
+        return preg_replace_callback(
+            '/\[((?:\'[^\']+\'\s*,?\s*)+)\]\.includes\(\$method\.id\)/',
+            function (array $matches): string {
+                preg_match_all("/'([^']+)'/", $matches[1], $tokenMatches);
+                $ids = $tokenMatches[1] ?? [];
+
+                foreach (self::CORE_NO_PG_METHODS as $coreId) {
+                    if (! in_array($coreId, $ids, true)) {
+                        return $matches[0];
+                    }
+                }
+
+                foreach (self::NICEPAY_NO_PG_METHODS as $methodId) {
+                    if (! in_array($methodId, $ids, true)) {
+                        $ids[] = $methodId;
+                    }
+                }
+
+                return "['" . implode("','", $ids) . "'].includes(\$method.id)";
+            },
+            $expression
+        ) ?? $expression;
+    }
+
+    /**
+     * @param array<string, mixed> $layout
+     * @return array<string, mixed>
+     */
+    private function ensureTestModeWarning(array $layout): array
+    {
+        $layout = $this->ensureTestModeDataSource($layout);
+
+        return $this->insertTestModeNotice($layout);
+    }
+
+    /**
+     * @param array<string, mixed> $layout
+     * @return array<string, mixed>
+     */
+    private function ensureTestModeDataSource(array $layout): array
+    {
+        $dataSources = is_array($layout['data_sources'] ?? null) ? $layout['data_sources'] : [];
+
+        foreach ($dataSources as $source) {
+            if (is_array($source) && ($source['id'] ?? null) === self::TEST_MODE_DATA_SOURCE_ID) {
+                $layout['data_sources'] = $dataSources;
+
+                return $layout;
+            }
+        }
+
+        $dataSources[] = [
+            'id' => self::TEST_MODE_DATA_SOURCE_ID,
+            'label_key' => '$t:sirsoft-pay_nicepayments.editor.data_source.nicepay_test_mode_status',
+            'type' => 'api',
+            'endpoint' => '/api/plugins/sirsoft-pay_nicepayments/admin/settings/test-mode-status',
+            'method' => 'GET',
+            'auto_fetch' => true,
+            'auth_required' => true,
+        ];
+
+        $layout['data_sources'] = $dataSources;
+
+        return $layout;
+    }
+
+    /**
+     * @param array<string, mixed> $node
+     * @return array<string, mixed>
+     */
+    private function insertTestModeNotice(array $node): array
+    {
+        if (($node['id'] ?? null) === 'tab_content_order_settings' && is_array($node['children'] ?? null)) {
+            $noticeIndex = $this->findChildIndexById($node['children'], self::TEST_MODE_NOTICE_ID);
+
+            if ($noticeIndex === null) {
+                $insertAt = $this->findChildIndexById($node['children'], 'payment_methods_card') ?? count($node['children']);
+                array_splice($node['children'], $insertAt, 0, [$this->testModeNoticeContainerNode()]);
+                $noticeIndex = $insertAt;
+            }
+
+            if (is_array($node['children'][$noticeIndex] ?? null)) {
+                $notice = $node['children'][$noticeIndex];
+                $notice['if'] = $this->mergeTestModeCondition((string) ($notice['if'] ?? ''));
+                $node['children'][$noticeIndex] = $this->appendTestModeNoticeRow($notice);
+            }
+
+            return $node;
+        }
+
+        foreach ($node as $key => $value) {
+            if (is_array($value)) {
+                $node[$key] = $this->insertTestModeNotice($value);
+            }
+        }
+
+        return $node;
+    }
+
+    /**
+     * @param array<int, mixed> $children
+     */
+    private function findChildIndexById(array $children, string $id): ?int
+    {
+        foreach ($children as $index => $child) {
+            if (is_array($child) && ($child['id'] ?? null) === $id) {
+                return $index;
+            }
+        }
+
+        return null;
+    }
+
+    /**
+     * @param array<int, mixed> $children
+     */
+    private function hasChildWithId(array $children, string $id): bool
+    {
+        return $this->findChildIndexById($children, $id) !== null;
+    }
+
+    private function mergeTestModeCondition(string $condition): string
+    {
+        if (str_contains($condition, self::TEST_MODE_CONDITION)) {
+            return $condition !== '' ? $condition : '{{' . self::TEST_MODE_CONDITION . '}}';
+        }
+
+        $inner = trim($condition);
+        if (str_starts_with($inner, '{{') && str_ends_with($inner, '}}')) {
+            $inner = trim(substr($inner, 2, -2));
+        }
+
+        if ($inner === '') {
+            return '{{' . self::TEST_MODE_CONDITION . '}}';
+        }
+
+        return '{{' . $inner . ' || ' . self::TEST_MODE_CONDITION . '}}';
+    }
+
+    /**
+     * @param array<string, mixed> $notice
+     * @return array<string, mixed>
+     */
+    private function appendTestModeNoticeRow(array $notice): array
+    {
+        $children = is_array($notice['children'] ?? null) ? $notice['children'] : [];
+
+        if (! $this->hasChildWithId($children, self::TEST_MODE_NOTICE_ROW_ID)) {
+            $children[] = $this->testModeNoticeRowNode();
+        }
+
+        $notice['children'] = $children;
+
+        return $notice;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    private function testModeNoticeContainerNode(): array
+    {
+        return [
+            'id' => self::TEST_MODE_NOTICE_ID,
+            'type' => 'basic',
+            'name' => 'Div',
+            'if' => '{{' . self::TEST_MODE_CONDITION . '}}',
+            'props' => [
+                'className' => 'mb-4 space-y-3 rounded-lg border border-orange-200 bg-orange-50 p-4 dark:border-orange-700 dark:bg-orange-900/20',
+            ],
+            'children' => [
+                $this->testModeNoticeRowNode(),
+            ],
+        ];
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    private function testModeNoticeRowNode(): array
+    {
+        return [
+            'id' => self::TEST_MODE_NOTICE_ROW_ID,
+            'type' => 'basic',
+            'name' => 'Div',
+            'if' => '{{' . self::TEST_MODE_CONDITION . '}}',
+            'props' => [
+                'className' => 'flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between',
+            ],
+            'children' => [
+                [
+                    'type' => 'basic',
+                    'name' => 'Div',
+                    'props' => [
+                        'className' => 'min-w-0',
+                    ],
+                    'children' => [
+                        [
+                            'type' => 'basic',
+                            'name' => 'Div',
+                            'props' => [
+                                'className' => 'text-sm font-medium text-orange-950 dark:text-orange-50',
+                            ],
+                            'text' => '$t:sirsoft-pay_nicepayments.admin.test_mode_settings_warning_plugin',
+                        ],
+                        [
+                            'type' => 'basic',
+                            'name' => 'P',
+                            'props' => [
+                                'className' => 'mt-0.5 text-sm leading-6 text-orange-800 dark:text-orange-200',
+                            ],
+                            'text' => '$t:sirsoft-pay_nicepayments.admin.test_mode_settings_warning_body',
+                        ],
+                    ],
+                ],
+                [
+                    'type' => 'basic',
+                    'name' => 'Button',
+                    'props' => [
+                        'type' => 'button',
+                        'className' => 'btn btn-outline btn-sm w-full flex-shrink-0 border-orange-300 text-orange-900 hover:bg-orange-100 sm:w-auto dark:border-orange-600 dark:text-orange-100 dark:hover:bg-orange-900/40',
+                    ],
+                    'actions' => [
+                        [
+                            'type' => 'click',
+                            'handler' => 'navigate',
+                            'params' => [
+                                'path' => '/admin/plugins/sirsoft-pay_nicepayments/settings',
+                            ],
+                        ],
+                    ],
+                    'children' => [
+                                [
+                                    'type' => 'basic',
+                                    'name' => 'Span',
+                                    'text' => '$t:sirsoft-pay_nicepayments.admin.test_mode_settings_warning_action',
+                                ],
+                    ],
+                ],
+            ],
+        ];
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/src/Listeners/CancelActivityLogListener.php b/plugins/_bundled/sirsoft-pay_nicepayments/src/Listeners/CancelActivityLogListener.php
new file mode 100644
index 00000000..c9035623
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/src/Listeners/CancelActivityLogListener.php
@@ -0,0 +1,92 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Listeners;
+
+use App\ActivityLog\Traits\ResolvesActivityLogType;
+use App\Contracts\Extension\HookListenerInterface;
+use Modules\Sirsoft\Ecommerce\Models\Order;
+use Modules\Sirsoft\Ecommerce\Models\OrderPayment;
+
+/**
+ * NicePayments PG 결제 취소 활동 로그 리스너.
+ *
+ * 코어의 sirsoft-ecommerce.payment.refund 필터 훅을 priority 20 으로 구독해
+ * PaymentRefundListener (priority 10) 가 NicePayments cancel API 호출에 성공한
+ * 직후 실행.
+ *
+ * 코어가 이미 기록하는 order.cancel (주문 단위 취소 의도) 와 별도로,
+ * "PG 가 실제로 취소를 확인했다" 는 별도 이벤트를 활동 로그에 보존한다.
+ */
+class CancelActivityLogListener implements HookListenerInterface
+{
+    use ResolvesActivityLogType;
+
+    private const PG_PROVIDER_ID = 'nicepayments';
+
+    /**
+     * 구독할 훅 매핑 반환
+     *
+     * @return array<string, array<string, mixed>> 훅 구독 설정
+     */
+    public static function getSubscribedHooks(): array
+    {
+        return [
+            'sirsoft-ecommerce.payment.refund' => [
+                'method' => 'logCancelConfirmed',
+                'type' => 'filter',
+                'priority' => 20,
+            ],
+        ];
+    }
+
+    /**
+     * 기본 핸들러 (미사용)
+     *
+     * @param  mixed  ...$args  훅 인수
+     */
+    public function handle(...$args): void {}
+
+    /**
+     * PG 가 결제 취소를 확인한 직후 활동 로그를 기록한다.
+     *
+     * @param  array  $result  이전 필터 누적 결과
+     * @param  Order  $order  대상 주문
+     * @param  OrderPayment  $payment  대상 결제 정보
+     * @param  float  $refundAmount  환불 금액
+     * @param  string|null  $reason  취소 사유
+     * @return array 결과 통과 (mutation 없음)
+     */
+    public function logCancelConfirmed(
+        array $result,
+        Order $order,
+        OrderPayment $payment,
+        float $refundAmount,
+        ?string $reason = null,
+    ): array {
+        if ($payment->pg_provider !== self::PG_PROVIDER_ID) {
+            return $result;
+        }
+        if (empty($result['success'])) {
+            return $result;
+        }
+
+        $this->logActivity('payment.cancel', [
+            'loggable' => $order,
+            'description_key' => 'sirsoft-pay_nicepayments::activity_log.description.payment_cancel',
+            'description_params' => [
+                'order_number' => $order->order_number,
+                'refund_amount' => number_format((int) $refundAmount),
+            ],
+            'properties' => [
+                'tid' => $payment->transaction_id,
+                'cancel_tid' => $result['transaction_id'] ?? null,
+                'refund_amount' => $refundAmount,
+                'reason' => $reason,
+            ],
+        ]);
+
+        return $result;
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/src/Listeners/EnsureAdminOrderDetailPaymentQueryLayoutListener.php b/plugins/_bundled/sirsoft-pay_nicepayments/src/Listeners/EnsureAdminOrderDetailPaymentQueryLayoutListener.php
new file mode 100644
index 00000000..a4e29ea6
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/src/Listeners/EnsureAdminOrderDetailPaymentQueryLayoutListener.php
@@ -0,0 +1,340 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Listeners;
+
+use App\Contracts\Extension\HookListenerInterface;
+
+class EnsureAdminOrderDetailPaymentQueryLayoutListener implements HookListenerInterface
+{
+    private const TARGET_LAYOUT = 'admin_ecommerce_order_detail';
+
+    private const NOTICE_ID = 'nicepay_test_mode_notice';
+
+    private const HEADER_TARGET_IDS = [
+        'sticky_header_container',
+        'page_header_section',
+        'page_header',
+        'order_detail_wrapper',
+    ];
+
+    private const BODY_TARGET_IDS = [
+        'tab_content_area',
+        'order_detail_wrapper',
+    ];
+
+    /**
+     * @return array<string, array<string, mixed>>
+     */
+    public static function getSubscribedHooks(): array
+    {
+        return [
+            'core.layout_extension.after_apply' => [
+                'method' => 'ensurePaymentQueryLayout',
+                'type' => 'filter',
+                'priority' => 66,
+            ],
+        ];
+    }
+
+    /**
+     * @param mixed ...$args
+     */
+    public function handle(...$args): void {}
+
+    /**
+     * @param array<string, mixed> $layout
+     * @param int $templateId
+     * @return array<string, mixed>
+     */
+    public function ensurePaymentQueryLayout(array $layout, int $templateId): array
+    {
+        if (($layout['layout_name'] ?? '') !== self::TARGET_LAYOUT) {
+            return $layout;
+        }
+
+        $extension = $this->orderPaymentQueryExtension();
+
+        $layout = $this->ensureDataSources($layout, $extension['data_sources'] ?? []);
+        $this->ensureInjections($layout, $extension['injections'] ?? []);
+
+        return $layout;
+    }
+
+    /**
+     * @param array<string, mixed> $layout
+     * @param array<int, mixed> $extensionDataSources
+     * @return array<string, mixed>
+     */
+    private function ensureDataSources(array $layout, array $extensionDataSources): array
+    {
+        $dataSources = isset($layout['data_sources']) && is_array($layout['data_sources'])
+            ? $layout['data_sources']
+            : [];
+        $existingIds = [];
+
+        foreach ($dataSources as $dataSource) {
+            if (is_array($dataSource) && is_string($dataSource['id'] ?? null)) {
+                $existingIds[$dataSource['id']] = true;
+            }
+        }
+
+        foreach ($extensionDataSources as $dataSource) {
+            if (! is_array($dataSource) || ! is_string($dataSource['id'] ?? null)) {
+                continue;
+            }
+
+            if (isset($existingIds[$dataSource['id']])) {
+                continue;
+            }
+
+            $dataSources[] = $dataSource;
+            $existingIds[$dataSource['id']] = true;
+        }
+
+        $layout['data_sources'] = $dataSources;
+
+        return $layout;
+    }
+
+    /**
+     * @param array<string, mixed> $layout
+     * @param array<int, mixed> $injections
+     */
+    private function ensureInjections(array &$layout, array $injections): void
+    {
+        foreach ($injections as $injection) {
+            if (! is_array($injection) || ! isset($injection['components']) || ! is_array($injection['components'])) {
+                continue;
+            }
+
+            $position = is_string($injection['position'] ?? null) ? $injection['position'] : 'append_child';
+            $components = $this->normalizeComponents($injection['components']);
+            $targetIds = $this->isHeaderInjection($injection) ? self::HEADER_TARGET_IDS : self::BODY_TARGET_IDS;
+
+            if ($this->appendComponentsToFirstAvailableTarget($layout, $targetIds, $components, $position)) {
+                continue;
+            }
+
+            if (! isset($layout['slots']['content']) || ! is_array($layout['slots']['content'])) {
+                $layout['slots']['content'] = [];
+            }
+
+            $this->mergeMissingComponents($layout['slots']['content'], $components, $position);
+        }
+    }
+
+    /**
+     * @param array<string, mixed> $injection
+     */
+    private function isHeaderInjection(array $injection): bool
+    {
+        return in_array($injection['target_id'] ?? null, self::HEADER_TARGET_IDS, true);
+    }
+
+    /**
+     * @param array<string, mixed> $node
+     * @param array<int, string> $targetIds
+     * @param array<int, mixed> $components
+     */
+    private function appendComponentsToFirstAvailableTarget(
+        array &$node,
+        array $targetIds,
+        array $components,
+        string $position
+    ): bool {
+        foreach ($targetIds as $targetId) {
+            if ($this->appendComponentsToTargetId($node, $targetId, $components, $position)) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+
+    /**
+     * @param array<string, mixed> $node
+     * @param array<int, mixed> $components
+     */
+    private function appendComponentsToTargetId(
+        array &$node,
+        string $targetId,
+        array $components,
+        string $position
+    ): bool {
+        if (($node['id'] ?? null) === $targetId) {
+            if (! isset($node['children']) || ! is_array($node['children'])) {
+                $node['children'] = [];
+            }
+
+            $this->mergeMissingComponents($node['children'], $components, $position);
+
+            return true;
+        }
+
+        foreach ($node as &$value) {
+            if (is_array($value) && $this->appendComponentsToTargetId($value, $targetId, $components, $position)) {
+                return true;
+            }
+        }
+        unset($value);
+
+        return false;
+    }
+
+    /**
+     * @param array<int, mixed> $target
+     * @param array<int, mixed> $components
+     */
+    private function mergeMissingComponents(array &$target, array $components, string $position): void
+    {
+        $missing = [];
+
+        foreach ($components as $component) {
+            if (! is_array($component) || $this->containsComponent($target, $component)) {
+                continue;
+            }
+
+            $missing[] = $component;
+        }
+
+        if ($missing === []) {
+            return;
+        }
+
+        if (str_starts_with($position, 'prepend')) {
+            $target = array_merge($missing, $target);
+
+            return;
+        }
+
+        array_push($target, ...$missing);
+    }
+
+    /**
+     * @param array<int, mixed> $components
+     * @return array<int, mixed>
+     */
+    private function normalizeComponents(array $components): array
+    {
+        return array_map(function ($component) {
+            if (
+                is_array($component)
+                && ! isset($component['id'])
+                && $this->containsString($component, 'sirsoft-pay_nicepayments.admin.test_mode_order_notice')
+            ) {
+                $component['id'] = self::NOTICE_ID;
+            }
+
+            return $component;
+        }, $components);
+    }
+
+    /**
+     * @param array<string|int, mixed> $node
+     * @param array<string, mixed> $component
+     */
+    private function containsComponent(array $node, array $component): bool
+    {
+        if (is_string($component['id'] ?? null) && $this->containsNodeId($node, $component['id'])) {
+            return true;
+        }
+
+        foreach ($this->componentSignatures($component) as $signature) {
+            if ($this->containsString($node, $signature)) {
+                return true;
+            }
+        }
+
+        $targetJson = json_encode($node, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
+        $componentJson = json_encode($component, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
+
+        return is_string($targetJson)
+            && is_string($componentJson)
+            && $componentJson !== ''
+            && str_contains($targetJson, $componentJson);
+    }
+
+    /**
+     * @param array<string, mixed> $component
+     * @return array<int, string>
+     */
+    private function componentSignatures(array $component): array
+    {
+        $json = json_encode($component, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
+
+        if (! is_string($json)) {
+            return [];
+        }
+
+        $signatures = [];
+
+        foreach ([
+            'sirsoft-pay_nicepayments.admin.test_mode_order_notice',
+            'sirsoft-pay_nicepayments.admin.escrow_payment_notice',
+            'sirsoft-pay_nicepayments.admin.order_verify_title',
+            'sirsoft-pay_nicepayments.admin.escrow_delivery_title',
+            'sirsoft-pay_nicepayments.admin.vbank_noti_title',
+        ] as $candidate) {
+            if (str_contains($json, $candidate)) {
+                $signatures[] = $candidate;
+            }
+        }
+
+        return $signatures;
+    }
+
+    /**
+     * @param array<string|int, mixed> $node
+     */
+    private function containsNodeId(array $node, string $id): bool
+    {
+        if (($node['id'] ?? null) === $id) {
+            return true;
+        }
+
+        foreach ($node as $value) {
+            if (is_array($value) && $this->containsNodeId($value, $id)) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+
+    /**
+     * @param array<string|int, mixed> $node
+     */
+    private function containsString(array $node, string $needle): bool
+    {
+        foreach ($node as $value) {
+            if (is_array($value) && $this->containsString($value, $needle)) {
+                return true;
+            }
+
+            if (is_string($value) && str_contains($value, $needle)) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    private function orderPaymentQueryExtension(): array
+    {
+        $path = dirname(__DIR__, 2).'/resources/extensions/admin_order_payment_query.json';
+        $contents = is_file($path) ? file_get_contents($path) : false;
+
+        if (! is_string($contents)) {
+            return [];
+        }
+
+        $decoded = json_decode($contents, true);
+
+        return is_array($decoded) ? $decoded : [];
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/src/Listeners/EnsureAdminOrderListTestBadgeLayoutListener.php b/plugins/_bundled/sirsoft-pay_nicepayments/src/Listeners/EnsureAdminOrderListTestBadgeLayoutListener.php
new file mode 100644
index 00000000..ff890baf
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/src/Listeners/EnsureAdminOrderListTestBadgeLayoutListener.php
@@ -0,0 +1,247 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Listeners;
+
+use App\Contracts\Extension\HookListenerInterface;
+
+class EnsureAdminOrderListTestBadgeLayoutListener implements HookListenerInterface
+{
+    private const TARGET_LAYOUT = 'admin_ecommerce_order_list';
+
+    private const ORDER_GRID_ID = 'order_datagrid';
+
+    private const DATA_SOURCE_ID = 'nicepay_test_map';
+
+    private const EASY_PAY_DISPLAY_DATA_SOURCE_ID = 'nicepay_easy_pay_display_map';
+
+    private const BADGE_CONDITION = 'nicepay_test_map.data?.[row.order_number] === true';
+
+    private const EASY_PAY_DISPLAY_EXPRESSION = 'nicepay_easy_pay_display_map.data?.[row.order_number]?.payment_method_display_label ?? row.payment?.payment_method_label';
+
+    /**
+     * @return array<string, array<string, mixed>>
+     */
+    public static function getSubscribedHooks(): array
+    {
+        return [
+            'core.layout_extension.after_apply' => [
+                'method' => 'ensureTestBadgeLayout',
+                'type' => 'filter',
+                'priority' => 60,
+            ],
+        ];
+    }
+
+    /**
+     * @param mixed ...$args
+     */
+    public function handle(...$args): void {}
+
+    /**
+     * @param array<string, mixed> $layout
+     * @param int $templateId
+     * @return array<string, mixed>
+     */
+    public function ensureTestBadgeLayout(array $layout, int $templateId): array
+    {
+        if (($layout['layout_name'] ?? '') !== self::TARGET_LAYOUT) {
+            return $layout;
+        }
+
+        $layout = $this->ensureDataSource($layout);
+
+        if (isset($layout['components']) && is_array($layout['components'])) {
+            $this->ensureOrderGridBadge($layout['components']);
+        }
+
+        return $layout;
+    }
+
+    /**
+     * @param array<string, mixed> $layout
+     * @return array<string, mixed>
+     */
+    private function ensureDataSource(array $layout): array
+    {
+        $dataSources = isset($layout['data_sources']) && is_array($layout['data_sources'])
+            ? $layout['data_sources']
+            : [];
+
+        $existingIds = [];
+        foreach ($dataSources as $dataSource) {
+            if (is_array($dataSource) && ($dataSource['id'] ?? null) === self::DATA_SOURCE_ID) {
+                $existingIds[self::DATA_SOURCE_ID] = true;
+            }
+
+            if (is_array($dataSource) && ($dataSource['id'] ?? null) === self::EASY_PAY_DISPLAY_DATA_SOURCE_ID) {
+                $existingIds[self::EASY_PAY_DISPLAY_DATA_SOURCE_ID] = true;
+            }
+        }
+
+        if (! isset($existingIds[self::DATA_SOURCE_ID])) {
+            $dataSources[] = [
+                'id' => self::DATA_SOURCE_ID,
+                'label_key' => '$t:sirsoft-pay_nicepayments.editor.data_source.nicepay_test_map',
+                'type' => 'api',
+                'endpoint' => '/api/plugins/sirsoft-pay_nicepayments/admin/orders/test-mode-map',
+                'method' => 'GET',
+                'auto_fetch' => true,
+                'auth_required' => true,
+                'loading_strategy' => 'progressive',
+            ];
+        }
+
+        if (! isset($existingIds[self::EASY_PAY_DISPLAY_DATA_SOURCE_ID])) {
+            $dataSources[] = [
+                'id' => self::EASY_PAY_DISPLAY_DATA_SOURCE_ID,
+                'label_key' => '$t:sirsoft-pay_nicepayments.editor.data_source.nicepay_easy_pay_display_map',
+                'type' => 'api',
+                'endpoint' => '/api/plugins/sirsoft-pay_nicepayments/admin/orders/easy-pay-display-map',
+                'method' => 'GET',
+                'auto_fetch' => true,
+                'auth_required' => true,
+                'loading_strategy' => 'progressive',
+            ];
+        }
+
+        $layout['data_sources'] = $dataSources;
+
+        return $layout;
+    }
+
+    /**
+     * @param array<int, mixed> $components
+     */
+    private function ensureOrderGridBadge(array &$components): bool
+    {
+        foreach ($components as &$component) {
+            if (! is_array($component)) {
+                continue;
+            }
+
+            if (($component['id'] ?? '') === self::ORDER_GRID_ID) {
+                $this->ensurePaymentMethodColumnBadge($component);
+
+                return true;
+            }
+
+            if (isset($component['children']) && is_array($component['children'])) {
+                if ($this->ensureOrderGridBadge($component['children'])) {
+                    return true;
+                }
+            }
+        }
+        unset($component);
+
+        return false;
+    }
+
+    /**
+     * @param array<string, mixed> $grid
+     */
+    private function ensurePaymentMethodColumnBadge(array &$grid): void
+    {
+        if (! isset($grid['props']['columns']) || ! is_array($grid['props']['columns'])) {
+            return;
+        }
+
+        foreach ($grid['props']['columns'] as &$column) {
+            if (! is_array($column) || ($column['field'] ?? null) !== 'payment_method') {
+                continue;
+            }
+
+            $this->appendBadgeToColumn($column);
+            $this->ensurePaymentMethodDisplayExpression($column);
+
+            return;
+        }
+        unset($column);
+    }
+
+    /**
+     * @param array<string|int, mixed> $node
+     */
+    private function ensurePaymentMethodDisplayExpression(array &$node): bool
+    {
+        if (($node['text'] ?? null) === '{{row.payment?.payment_method_label}}') {
+            $node['text'] = '{{'.self::EASY_PAY_DISPLAY_EXPRESSION.'}}';
+
+            return true;
+        }
+
+        foreach ($node as &$value) {
+            if (is_array($value) && $this->ensurePaymentMethodDisplayExpression($value)) {
+                return true;
+            }
+        }
+        unset($value);
+
+        return false;
+    }
+
+    /**
+     * @param array<string, mixed> $column
+     */
+    private function appendBadgeToColumn(array &$column): void
+    {
+        if ($this->containsNicepayBadgeCondition($column)) {
+            return;
+        }
+
+        if (! isset($column['cellChildren']) || ! is_array($column['cellChildren'])) {
+            $column['cellChildren'] = [];
+        }
+
+        foreach ($column['cellChildren'] as &$cellChild) {
+            if (
+                is_array($cellChild)
+                && ($cellChild['name'] ?? null) === 'Div'
+                && isset($cellChild['children'])
+                && is_array($cellChild['children'])
+            ) {
+                $cellChild['children'][] = $this->badgeComponent();
+
+                return;
+            }
+        }
+        unset($cellChild);
+
+        $column['cellChildren'][] = $this->badgeComponent();
+    }
+
+    /**
+     * @param array<string, mixed> $node
+     */
+    private function containsNicepayBadgeCondition(array $node): bool
+    {
+        foreach ($node as $value) {
+            if (is_array($value) && $this->containsNicepayBadgeCondition($value)) {
+                return true;
+            }
+
+            if (is_string($value) && str_contains($value, self::BADGE_CONDITION)) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    private function badgeComponent(): array
+    {
+        return [
+            'type' => 'basic',
+            'name' => 'Span',
+            'if' => '{{'.self::BADGE_CONDITION.'}}',
+            'props' => [
+                'className' => 'text-xs font-medium text-orange-500 dark:text-orange-400 leading-tight',
+            ],
+            'text' => '($t:sirsoft-pay_nicepayments.admin.test_mode_badge)',
+        ];
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/src/Listeners/PaymentRefundListener.php b/plugins/_bundled/sirsoft-pay_nicepayments/src/Listeners/PaymentRefundListener.php
new file mode 100644
index 00000000..88037be0
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/src/Listeners/PaymentRefundListener.php
@@ -0,0 +1,169 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Listeners;
+
+use App\Contracts\Extension\HookListenerInterface;
+use App\Extension\HookManager;
+use Illuminate\Support\Facades\Log;
+use Modules\Sirsoft\Ecommerce\Models\Order;
+use Modules\Sirsoft\Ecommerce\Models\OrderPayment;
+use Plugins\Sirsoft\PayNicepayments\Services\NicePaymentsApiService;
+
+class PaymentRefundListener implements HookListenerInterface
+{
+    private const PG_PROVIDER_ID = 'nicepayments';
+    private const MONEY_EPSILON = 0.0001;
+
+    /**
+     * 구독할 훅 매핑 반환
+     *
+     * @return array<string, array<string, mixed>> 훅 구독 설정
+     */
+    public static function getSubscribedHooks(): array
+    {
+        return [
+            'sirsoft-ecommerce.payment.refund' => [
+                'method' => 'processRefund',
+                'type' => 'filter',
+                'priority' => 10,
+            ],
+        ];
+    }
+
+    /**
+     * 기본 핸들러 (미사용 — 개별 메서드에서 처리)
+     *
+     * @param  mixed  ...$args  훅 인수
+     */
+    public function handle(...$args): void {}
+
+    /**
+     * 환불 처리 훅 핸들러 (sirsoft-ecommerce.payment.refund 필터)
+     *
+     * NicePay 결제 건 (pg_provider=nicepayments) 만 처리. 가상계좌 입금 완료 건은
+     * 환불계좌 정보가 필요해 별도 어드민 API 로 우회. before_cancel/after_cancel
+     * 액션 훅을 발행하여 외부 확장 지점 제공.
+     *
+     * @param  array  $result  이전 필터 누적 결과
+     * @param  Order  $order  대상 주문
+     * @param  OrderPayment  $payment  대상 결제 정보
+     * @param  float  $refundAmount  환불 금액
+     * @param  string|null  $reason  환불 사유 (없으면 기본 메시지)
+     * @return array success / error_code / error_message / transaction_id
+     */
+    public function processRefund(
+        array $result,
+        Order $order,
+        OrderPayment $payment,
+        float $refundAmount,
+        ?string $reason = null,
+    ): array {
+        if ($payment->pg_provider !== self::PG_PROVIDER_ID) {
+            return $result;
+        }
+
+        // 가상계좌 입금 완료 건은 환불 계좌 정보가 필요하므로 일반 훅으로 처리 불가
+        // payment_status 는 훅 호출 전 updatePayment() 에서 이미 CANCELLED 로 변경되므로
+        // 입금 여부 판별에는 paid_at (입금 확인 시 설정) 을 사용한다
+        if ($payment->vbank_number !== null
+            && $payment->paid_at !== null) {
+            return [
+                'success' => false,
+                'error_code' => 'VBANK_REQUIRES_BANK_INFO',
+                'error_message' => __('sirsoft-pay_nicepayments::messages.errors.vbank_completed_requires_bank_info'),
+                'transaction_id' => null,
+            ];
+        }
+
+        $tid = $payment->transaction_id;
+        if (! $tid) {
+            return [
+                'success' => false,
+                'error_code' => 'MISSING_TID',
+                'error_message' => __('sirsoft-pay_nicepayments::messages.refund.missing_tid'),
+                'transaction_id' => null,
+            ];
+        }
+
+        try {
+            $apiService = app(NicePaymentsApiService::class);
+            $this->useStoredCredentials($apiService, $payment);
+
+            $cancelMsg = $reason ?? __('sirsoft-pay_nicepayments::messages.refund.default_reason');
+            $cancelAmt = (int) $refundAmount;
+
+            if ($cancelAmt <= 0) {
+                return [
+                    'success' => false,
+                    'error_code' => 'INVALID_REFUND_AMOUNT',
+                    'error_message' => __('sirsoft-pay_nicepayments::messages.errors.invalid_refund_amount', ['amount' => $cancelAmt]),
+                    'transaction_id' => null,
+                ];
+            }
+
+            $moid = (string) $order->order_number;
+
+            $isPartial = $this->shouldUsePartialCancelCode($payment, $cancelAmt);
+            $response = $apiService->cancelPayment($tid, $moid, $cancelAmt, $cancelMsg, $isPartial ? 1 : 0);
+
+            Log::info('NicePayments: refund success', [
+                'order_id' => $order->id,
+                'tid' => $tid,
+                'cancel_amt' => $cancelAmt,
+            ]);
+
+            return [
+                'success' => true,
+                'error_code' => null,
+                'error_message' => null,
+                'transaction_id' => $response['TID'] ?? $tid,
+            ];
+        } catch (\Exception $e) {
+            Log::error('NicePayments: refund failed', [
+                'order_id' => $order->id,
+                'tid' => $tid,
+                'cancel_amt' => (int) $refundAmount,
+                'error' => $e->getMessage(),
+            ]);
+
+            HookManager::doAction('sirsoft-pay_nicepayments.payment.refund_failed', $order, $payment, [
+                'tid' => $tid,
+                'cancel_amt' => (int) $refundAmount,
+                'error' => $e->getMessage(),
+            ]);
+
+            return [
+                'success' => false,
+                'error_code' => 'PG_API_ERROR',
+                'error_message' => $e->getMessage(),
+                'transaction_id' => null,
+            ];
+        }
+    }
+
+    private function useStoredCredentials(NicePaymentsApiService $apiService, OrderPayment $payment): void
+    {
+        $meta = $payment->payment_meta ?? [];
+        $mid = trim((string) ($meta['mid'] ?? ''));
+        if ($mid === '' || ! array_key_exists('is_test_mode', $meta)) {
+            return;
+        }
+
+        $apiService->useStoredCredentials((bool) $meta['is_test_mode'], $mid);
+    }
+
+    /**
+     * 코어는 PG 환불 훅 호출 전에 누적 취소액을 먼저 반영한다.
+     * 따라서 남은 잔액 취소 시 getCancellableAmount() 만 보면 전액취소처럼 보일 수 있으므로,
+     * 이번 환불 이전에 이미 취소된 결제 통화 금액이 있었는지도 함께 확인한다.
+     */
+    private function shouldUsePartialCancelCode(OrderPayment $payment, int $cancelAmt): bool
+    {
+        $cancelledBeforeThisRefund = max(0.0, $payment->cancelledLocalAmount() - $cancelAmt);
+
+        return $cancelledBeforeThisRefund > self::MONEY_EPSILON
+            || $payment->getCancellableAmount() > self::MONEY_EPSILON;
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/src/Listeners/RegisterEasyPayMethodsListener.php b/plugins/_bundled/sirsoft-pay_nicepayments/src/Listeners/RegisterEasyPayMethodsListener.php
new file mode 100644
index 00000000..e79a2e1c
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/src/Listeners/RegisterEasyPayMethodsListener.php
@@ -0,0 +1,177 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Listeners;
+
+use App\Contracts\Extension\HookListenerInterface;
+
+/**
+ * 나이스페이먼츠 간편결제를 이커머스 결제수단 목록에 등록한다.
+ *
+ * 각 결제수단 ID는 프론트 requestPaymentHandler 의 nicepay_* 매핑과 일치한다.
+ */
+class RegisterEasyPayMethodsListener implements HookListenerInterface
+{
+    private const PLUGIN_IDENTIFIER = 'sirsoft-pay_nicepayments';
+
+    private const EASY_PAY_METHODS = [
+        [
+            'id' => 'nicepay_naverpay',
+            'name_key' => 'sirsoft-pay_nicepayments::payment_methods.naverpay.name',
+            'description_key' => 'sirsoft-pay_nicepayments::payment_methods.naverpay.description',
+            'icon' => 'wallet',
+        ],
+        [
+            'id' => 'nicepay_kakaopay',
+            'name_key' => 'sirsoft-pay_nicepayments::payment_methods.kakaopay.name',
+            'description_key' => 'sirsoft-pay_nicepayments::payment_methods.kakaopay.description',
+            'icon' => 'message-circle',
+        ],
+        [
+            'id' => 'nicepay_samsungpay',
+            'name_key' => 'sirsoft-pay_nicepayments::payment_methods.samsungpay.name',
+            'description_key' => 'sirsoft-pay_nicepayments::payment_methods.samsungpay.description',
+            'icon' => 'smartphone',
+        ],
+        [
+            'id' => 'nicepay_applepay',
+            'name_key' => 'sirsoft-pay_nicepayments::payment_methods.applepay.name',
+            'description_key' => 'sirsoft-pay_nicepayments::payment_methods.applepay.description',
+            'icon' => 'smartphone',
+        ],
+        [
+            'id' => 'nicepay_payco',
+            'name_key' => 'sirsoft-pay_nicepayments::payment_methods.payco.name',
+            'description_key' => 'sirsoft-pay_nicepayments::payment_methods.payco.description',
+            'icon' => 'wallet',
+        ],
+        [
+            'id' => 'nicepay_skpay',
+            'name_key' => 'sirsoft-pay_nicepayments::payment_methods.skpay.name',
+            'description_key' => 'sirsoft-pay_nicepayments::payment_methods.skpay.description',
+            'icon' => 'wallet-cards',
+        ],
+        [
+            'id' => 'nicepay_ssgpay',
+            'name_key' => 'sirsoft-pay_nicepayments::payment_methods.ssgpay.name',
+            'description_key' => 'sirsoft-pay_nicepayments::payment_methods.ssgpay.description',
+            'icon' => 'shopping-bag',
+        ],
+        [
+            'id' => 'nicepay_lpay',
+            'name_key' => 'sirsoft-pay_nicepayments::payment_methods.lpay.name',
+            'description_key' => 'sirsoft-pay_nicepayments::payment_methods.lpay.description',
+            'icon' => 'wallet',
+        ],
+    ];
+
+    /**
+     * @return array<string, array<string, mixed>>
+     */
+    public static function getSubscribedHooks(): array
+    {
+        return [
+            'sirsoft-ecommerce.settings.filter_available_payment_methods' => [
+                'method' => 'injectEasyPayMethods',
+                'type' => 'filter',
+                'priority' => 40,
+            ],
+        ];
+    }
+
+    /**
+     * @param mixed ...$args
+     */
+    public function handle(...$args): void {}
+
+    /**
+     * @param array<int, array<string, mixed>> $methods
+     * @return array<int, array<string, mixed>>
+     */
+    public function injectEasyPayMethods(array $methods): array
+    {
+        $easyPayMethods = array_map(
+            fn (array $method): array => $this->buildEntry(
+                id: $method['id'],
+                nameKey: $method['name_key'],
+                descriptionKey: $method['description_key'],
+                icon: $method['icon'],
+            ),
+            self::EASY_PAY_METHODS
+        );
+
+        $easyPayIds = array_column($easyPayMethods, 'id');
+        $methods = array_values(array_filter(
+            $methods,
+            fn (array $method): bool => ! in_array($method['id'] ?? null, $easyPayIds, true)
+        ));
+
+        $insertAfter = $this->resolveInsertionIndex($methods);
+        if ($insertAfter === null) {
+            return array_merge($methods, $easyPayMethods);
+        }
+
+        return array_merge(
+            array_slice($methods, 0, $insertAfter + 1),
+            $easyPayMethods,
+            array_slice($methods, $insertAfter + 1),
+        );
+    }
+
+    /**
+     * @param array<int, array<string, mixed>> $methods
+     */
+    private function resolveInsertionIndex(array $methods): ?int
+    {
+        $phoneIndex = null;
+        foreach ($methods as $index => $method) {
+            if (($method['id'] ?? null) === 'phone') {
+                $phoneIndex = $index;
+                break;
+            }
+        }
+
+        if ($phoneIndex === null) {
+            return null;
+        }
+
+        $insertAfter = $phoneIndex;
+        for ($index = $phoneIndex + 1, $count = count($methods); $index < $count; $index++) {
+            $id = (string) ($methods[$index]['id'] ?? '');
+            if (
+                ! str_starts_with($id, 'kginicis_')
+                && ! str_starts_with($id, 'nhnkcp_')
+                && ! str_starts_with($id, 'nicepay_')
+            ) {
+                break;
+            }
+            $insertAfter = $index;
+        }
+
+        return $insertAfter;
+    }
+
+    private function buildEntry(string $id, string $nameKey, string $descriptionKey, string $icon): array
+    {
+        return [
+            'id' => $id,
+            'name' => [
+                'ko' => __($nameKey, [], 'ko'),
+                'en' => __($nameKey, [], 'en'),
+            ],
+            'description' => [
+                'ko' => __($descriptionKey, [], 'ko'),
+                'en' => __($descriptionKey, [], 'en'),
+            ],
+            'icon' => $icon,
+            'source' => 'plugin:' . self::PLUGIN_IDENTIFIER,
+            'defaults' => [
+                'pg_provider' => null,
+                'is_active' => false,
+                'min_order_amount' => 0,
+                'stock_deduction_timing' => 'payment_complete',
+            ],
+        ];
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/src/Listeners/RegisterPgProviderListener.php b/plugins/_bundled/sirsoft-pay_nicepayments/src/Listeners/RegisterPgProviderListener.php
new file mode 100644
index 00000000..82347fdd
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/src/Listeners/RegisterPgProviderListener.php
@@ -0,0 +1,130 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Listeners;
+
+use App\Contracts\Extension\HookListenerInterface;
+
+class RegisterPgProviderListener implements HookListenerInterface
+{
+    private const PLUGIN_IDENTIFIER = 'sirsoft-pay_nicepayments';
+
+    /**
+     * 구독할 훅 매핑 반환
+     *
+     * @return array<string, array<string, mixed>> 훅 구독 설정
+     */
+    public static function getSubscribedHooks(): array
+    {
+        return [
+            'sirsoft-ecommerce.payment.registered_pg_providers' => [
+                'method' => 'registerProvider',
+                'type' => 'filter',
+                'priority' => 10,
+            ],
+            'sirsoft-ecommerce.payment.get_client_config' => [
+                'method' => 'getClientConfig',
+                'type' => 'filter',
+                'priority' => 10,
+            ],
+        ];
+    }
+
+    /**
+     * 기본 핸들러 (미사용 — 개별 메서드에서 처리)
+     *
+     * @param  mixed  ...$args  훅 인수
+     */
+    public function handle(...$args): void {}
+
+    /**
+     * PG 제공자 목록에 나이스페이먼츠 등록
+     *
+     * @param  array  $providers  기존 PG 제공자 목록
+     * @return array 나이스페이먼츠가 추가된 PG 제공자 목록
+     */
+    public function registerProvider(array $providers): array
+    {
+        $providers[] = [
+            'id' => 'nicepayments',
+            'name_key' => 'sirsoft-pay_nicepayments::provider.name',
+            'name' => localized_label(nameKey: 'sirsoft-pay_nicepayments::provider.name'),
+            'icon' => 'credit-card',
+            'supported_methods' => ['card', 'bank_transfer', 'virtual_account', 'mobile'],
+        ];
+
+        return $providers;
+    }
+
+    /**
+     * PG 클라이언트 설정 제공 (프론트엔드 SDK용)
+     *
+     * MID, SDK URL, 콜백 URL, 활성화된 간편결제 목록 등을 반환. "타 PG 와 사용가능함"
+     * 설정이 꺼져 있고 기본 PG 가 nicepayments 가 아니면 간편결제는 빈 배열.
+     *
+     * @param  array  $config  기존 설정
+     * @param  string  $provider  PG 제공자 ID
+     * @return array 클라이언트 설정 또는 입력 그대로 (다른 PG 인 경우)
+     */
+    public function getClientConfig(array $config, string $provider): array
+    {
+        if ($provider !== 'nicepayments') {
+            return $config;
+        }
+
+        $settings = $this->getPluginSettings();
+        $isTest = $settings['is_test_mode'] ?? true;
+
+        $liveMid = $this->buildLiveMid((string) ($settings['live_mid'] ?? ''));
+
+        $easyPayKeys = ['NAVERPAY' => 'easy_pay_naverpay', 'KAKAOPAY' => 'easy_pay_kakaopay', 'SAMSUNGPAY' => 'easy_pay_samsungpay', 'APPLEPAY' => 'easy_pay_applepay', 'PAYCO' => 'easy_pay_payco', 'SKPAY' => 'easy_pay_skpay', 'SSGPAY' => 'easy_pay_ssgpay', 'LPAY' => 'easy_pay_lpay'];
+        $enabledEasyPays = array_values(array_keys(array_filter($easyPayKeys, fn ($key) => (bool) ($settings[$key] ?? false))));
+
+        // "타 PG와 사용가능함"이 꺼져 있고 현재 기본 PG가 nicepayments가 아니면 간편결제 숨김
+        $allowWithOtherPg = (bool) ($settings['easy_pay_allow_with_other_pg'] ?? false);
+        if (! $allowWithOtherPg && ! $this->isNicepayDefaultPg()) {
+            $enabledEasyPays = [];
+        }
+
+        return array_merge($config, [
+            'mid' => $isTest
+                ? ($settings['test_mid'] ?? '')
+                : $liveMid,
+            'sdk_url' => 'https://web.nicepay.co.kr/v3/webstd/js/nicepay-3.0.js',
+            'callback_url' => '/plugins/sirsoft-pay_nicepayments/payment/callback',
+            'sign_data_url' => '/plugins/sirsoft-pay_nicepayments/payment/sign-data',
+            'close_report_url' => '/plugins/sirsoft-pay_nicepayments/payment/close-report',
+            'useEscrow' => (bool) ($settings['use_escrow'] ?? false),
+            'enabled_easy_pays' => $enabledEasyPays,
+        ]);
+    }
+
+    private function isNicepayDefaultPg(): bool
+    {
+        $path = storage_path('app/modules/sirsoft-ecommerce/settings/order_settings.json');
+
+        if (! file_exists($path)) {
+            return false;
+        }
+
+        $data = json_decode(file_get_contents($path), true);
+
+        return ($data['default_pg_provider'] ?? '') === 'nicepayments';
+    }
+
+    private function getPluginSettings(): array
+    {
+        return plugin_settings(self::PLUGIN_IDENTIFIER);
+    }
+
+    private function buildLiveMid(string $suffix): string
+    {
+        $suffix = trim($suffix);
+        if ($suffix === '') {
+            return '';
+        }
+
+        return str_starts_with($suffix, 'SR') ? $suffix : 'SR' . $suffix;
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/src/Listeners/RestoreLayoutExtensionsAfterUpdateListener.php b/plugins/_bundled/sirsoft-pay_nicepayments/src/Listeners/RestoreLayoutExtensionsAfterUpdateListener.php
new file mode 100644
index 00000000..f6d28df3
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/src/Listeners/RestoreLayoutExtensionsAfterUpdateListener.php
@@ -0,0 +1,154 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Listeners;
+
+use App\Contracts\Extension\HookListenerInterface;
+use App\Contracts\Repositories\LayoutRepositoryInterface;
+use App\Contracts\Repositories\TemplateRepositoryInterface;
+use App\Enums\LayoutExtensionType;
+use App\Enums\LayoutSourceType;
+use App\Services\LayoutExtensionService;
+use Illuminate\Support\Facades\Log;
+
+class RestoreLayoutExtensionsAfterUpdateListener implements HookListenerInterface
+{
+    private const PLUGIN_IDENTIFIER = 'sirsoft-pay_nicepayments';
+
+    /**
+     * @return array<string, array<string, mixed>>
+     */
+    public static function getSubscribedHooks(): array
+    {
+        return [
+            'core.plugins.updated' => [
+                'method' => 'restoreCurrentExtensionsAfterUpdate',
+                'type' => 'action',
+                'priority' => 20,
+                'sync' => true,
+            ],
+        ];
+    }
+
+    /**
+     * @param mixed ...$args
+     */
+    public function handle(...$args): void {}
+
+    /**
+     * @param string $identifier
+     */
+    public function restoreCurrentExtensionsAfterUpdate(string $identifier): void
+    {
+        if ($identifier !== self::PLUGIN_IDENTIFIER) {
+            return;
+        }
+
+        $service = app(LayoutExtensionService::class);
+
+        foreach ($this->currentOverlayExtensions() as $extensionData) {
+            $targetLayout = $extensionData['target_layout'] ?? null;
+            if (! is_string($targetLayout) || $targetLayout === '') {
+                continue;
+            }
+
+            foreach ($this->templateIdsForLogicalLayout($targetLayout) as $templateId) {
+                $result = $service->registerExtension(
+                    $extensionData,
+                    LayoutSourceType::Plugin,
+                    self::PLUGIN_IDENTIFIER,
+                    $templateId,
+                    true
+                );
+
+                if ($result !== null) {
+                    $service->invalidateExtensionCache($templateId, $targetLayout, LayoutExtensionType::Overlay);
+                }
+            }
+        }
+    }
+
+    /**
+     * @return array<int, array<string, mixed>>
+     */
+    private function currentOverlayExtensions(): array
+    {
+        $paths = glob($this->extensionsDirectory().'/*.json') ?: [];
+        $extensions = [];
+
+        foreach ($paths as $path) {
+            $extensionData = $this->readExtensionJson($path);
+            if ($extensionData === null || ! isset($extensionData['target_layout'])) {
+                continue;
+            }
+
+            $extensions[] = $extensionData;
+        }
+
+        return $extensions;
+    }
+
+    private function extensionsDirectory(): string
+    {
+        return dirname(__DIR__, 2).'/resources/extensions';
+    }
+
+    /**
+     * @return array<string, mixed>|null
+     */
+    private function readExtensionJson(string $path): ?array
+    {
+        $content = file_get_contents($path);
+        if ($content === false) {
+            Log::warning('NicePayments layout extension file could not be read.', [
+                'path' => $path,
+            ]);
+
+            return null;
+        }
+
+        $data = json_decode($content, true);
+        if (json_last_error() !== JSON_ERROR_NONE || ! is_array($data)) {
+            Log::warning('NicePayments layout extension JSON parse failed.', [
+                'path' => $path,
+                'error' => json_last_error_msg(),
+            ]);
+
+            return null;
+        }
+
+        return $data;
+    }
+
+    /**
+     * @return array<int, int>
+     */
+    private function templateIdsForLogicalLayout(string $layoutName): array
+    {
+        $templateRepository = app(TemplateRepositoryInterface::class);
+        $layoutRepository = app(LayoutRepositoryInterface::class);
+        $templateIds = [];
+
+        foreach ($templateRepository->getAll() as $template) {
+            $layoutNames = $layoutRepository->getLayoutNamesByTemplateId((int) $template->id);
+
+            foreach ($layoutNames as $storedName) {
+                if (! is_string($storedName) || ! $this->matchesLogicalLayout($storedName, $layoutName)) {
+                    continue;
+                }
+
+                $templateIds[(int) $template->id] = (int) $template->id;
+
+                break;
+            }
+        }
+
+        return array_values($templateIds);
+    }
+
+    private function matchesLogicalLayout(string $storedName, string $layoutName): bool
+    {
+        return $storedName === $layoutName || str_ends_with($storedName, '.'.$layoutName);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/src/Providers/PayNicepaymentsServiceProvider.php b/plugins/_bundled/sirsoft-pay_nicepayments/src/Providers/PayNicepaymentsServiceProvider.php
new file mode 100644
index 00000000..3db1271c
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/src/Providers/PayNicepaymentsServiceProvider.php
@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Providers;
+
+use App\Extension\BasePluginServiceProvider;
+use Illuminate\Cookie\Middleware\EncryptCookies;
+
+class PayNicepaymentsServiceProvider extends BasePluginServiceProvider
+{
+    protected string $pluginIdentifier = 'sirsoft-pay_nicepayments';
+
+    public function boot(): void
+    {
+        parent::boot();
+
+        // PG callback 이 발급하는 영수증 쿠키는 HMAC 으로 자체 무결성 보장하므로
+        // EncryptCookies 대상에서 제외한다. 암호화 대상이면 callback 응답에서
+        // 직접 발급한 평문 쿠키가 다음 API 요청에서 복호화 실패로 폐기될 수 있다.
+        // 값 동기화: IssuesReceiptCookie::RECEIPT_COOKIE_NAME 과 동일해야 함.
+        EncryptCookies::except(['nicepayments_receipt_token']);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/src/Services/NicePaymentsApiService.php b/plugins/_bundled/sirsoft-pay_nicepayments/src/Services/NicePaymentsApiService.php
new file mode 100644
index 00000000..05334256
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/src/Services/NicePaymentsApiService.php
@@ -0,0 +1,419 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Services;
+
+use App\Extension\HookManager;
+use App\Services\PluginSettingsService;
+use Illuminate\Support\Facades\Http;
+use Illuminate\Support\Facades\Log;
+use Plugins\Sirsoft\PayNicepayments\Exceptions\NicePayApiException;
+
+class NicePaymentsApiService
+{
+    private const CANCEL_URL = 'https://pg-api.nicepay.co.kr/webapi/cancel_process.jsp';
+
+    private const QUERY_URL = 'https://webapi.nicepay.co.kr/webapi/inquery/trans_status.jsp';
+
+    private const DELIVERY_REG_URL = 'https://webapi.nicepay.co.kr/webapi/escrow_process.jsp';
+
+    private const PLUGIN_IDENTIFIER = 'sirsoft-pay_nicepayments';
+
+    private bool $isTest;
+
+    private string $mid;
+
+    private string $merchantKey;
+
+    private bool $useEscrow;
+
+    /** @var array<string, mixed> */
+    private array $settings;
+
+    public function __construct(PluginSettingsService $pluginSettingsService)
+    {
+        $settings = $pluginSettingsService->get(self::PLUGIN_IDENTIFIER) ?? [];
+        $this->settings = $settings;
+        $this->isTest = $settings['is_test_mode'] ?? true;
+        $this->mid = $this->isTest
+            ? ($settings['test_mid'] ?? '')
+            : self::buildLiveMid($settings['live_mid'] ?? '');
+        $this->merchantKey = $this->isTest
+            ? ($settings['test_merchant_key'] ?? '')
+            : ($settings['live_merchant_key'] ?? '');
+        $this->useEscrow = (bool) ($settings['use_escrow'] ?? false);
+    }
+
+    private static function buildLiveMid(string $suffix): string
+    {
+        $suffix = trim($suffix);
+        if ($suffix === '') {
+            return '';
+        }
+
+        return str_starts_with($suffix, 'SR') ? $suffix : 'SR' . $suffix;
+    }
+
+    /**
+     * 활성 MID 반환 (테스트/라이브 자동 분기)
+     *
+     * @return string MID
+     */
+    public function getMid(): string
+    {
+        return $this->mid;
+    }
+
+    /**
+     * 에스크로 결제 활성 여부
+     *
+     * @return bool use_escrow 설정값
+     */
+    public function isEscrowEnabled(): bool
+    {
+        return $this->useEscrow;
+    }
+
+    /**
+     * 테스트 모드 여부
+     *
+     * @return bool is_test_mode 설정값
+     */
+    public function isTestMode(): bool
+    {
+        return $this->isTest;
+    }
+
+    /**
+     * 결제 당시 저장된 MID/모드로 API 서명 컨텍스트를 복원합니다.
+     *
+     * 과거 결제 환불 시 운영자가 테스트/운영 모드 또는 MID 설정을 바꿨어도
+     * 취소 요청은 결제 당시 MID 로 서명되어야 합니다. MerchantKey 는 보안상
+     * payment_meta 에 저장하지 않고 현재 설정의 해당 모드 키를 사용합니다.
+     *
+     * @param  bool  $isTest  결제 당시 테스트 모드 여부
+     * @param  string  $mid  결제 당시 MID
+     */
+    public function useStoredCredentials(bool $isTest, string $mid): void
+    {
+        $this->isTest = $isTest;
+        $this->mid = $isTest ? $mid : self::buildLiveMid($mid);
+        $this->merchantKey = $isTest
+            ? (string) ($this->settings['test_merchant_key'] ?? '')
+            : (string) ($this->settings['live_merchant_key'] ?? '');
+    }
+
+    /**
+     * 에스크로 배송 등록 API 호출 (escrow_process.jsp)
+     *
+     * SignData: hex(sha256(TID + MID + ReqType + EdiDate + MerchantKey)).
+     * 응답 ResultCode = 'C000' 이면 성공.
+     *
+     * @param  string  $tid  거래번호
+     * @param  string  $deliveryName  택배사명
+     * @param  string  $trackingNumber  송장번호
+     * @param  string  $buyerAddress  구매자 주소
+     * @param  string  $registerName  등록자명
+     * @return array NicePay 응답 (UTF-8 변환 + JSON 파싱)
+     * @throws \Exception API 호출 실패 또는 PG 오류 시
+     */
+    public function registerEscrowDelivery(
+        string $tid,
+        string $deliveryName,
+        string $trackingNumber,
+        string $buyerAddress,
+        string $registerName,
+    ): array {
+        $reqType = '03';
+        $ediDate = $this->computeEdiDate();
+        $signData = bin2hex(hash('sha256', $tid . $this->mid . $reqType . $ediDate . $this->merchantKey, true));
+
+        $response = Http::timeout(15)->asForm()->post(self::DELIVERY_REG_URL, [
+            'MID' => $this->mid,
+            'TID' => $tid,
+            'EdiDate' => $ediDate,
+            'SignData' => $signData,
+            'ReqType' => $reqType,
+            'DeliveryCoNm' => $deliveryName,
+            'BuyerAddr' => $buyerAddress,
+            'InvoiceNum' => $trackingNumber,
+            'RegisterName' => $registerName,
+            'ConfirmMail' => 1,
+            'CharSet' => 'utf-8',
+        ]);
+
+        if ($response->failed()) {
+            throw new NicePayApiException('NicePayments delivery reg API error: HTTP ' . $response->status());
+        }
+
+        $result = $response->json() ?? [];
+
+        if (($result['ResultCode'] ?? '') !== 'C000') {
+            Log::error('NicePayments escrow delivery reg failed', [
+                'result_code' => $result['ResultCode'] ?? 'UNKNOWN',
+                'result_msg' => $result['ResultMsg'] ?? '',
+                'tid' => $tid,
+            ]);
+            throw new NicePayApiException($result['ResultMsg'] ?? 'NicePayments escrow delivery registration failed');
+        }
+
+        return $result;
+    }
+
+    /**
+     * 콜백 서명 검증 — hex(sha256(AuthToken + MID + Amt + MerchantKey))
+     *
+     * @param  string  $authToken  콜백으로 받은 AuthToken
+     * @param  string  $mid  콜백 MID
+     * @param  int  $amt  콜백 결제 금액
+     * @param  string  $signature  검증할 서명
+     * @return bool 일치 여부
+     */
+    public function verifyCallbackSignature(string $authToken, string $mid, int $amt, string $signature): bool
+    {
+        $expected = bin2hex(hash('sha256', $authToken . $mid . (string) $amt . $this->merchantKey, true));
+
+        return hash_equals($expected, $signature);
+    }
+
+    /**
+     * 가상계좌 입금 통보 서명 검증 — hex(sha256(TID + MID + Amt + MerchantKey))
+     *
+     * @param  string  $tid  통보 TID
+     * @param  int  $amt  통보 입금 금액
+     * @param  string  $signature  검증할 서명
+     * @return bool 일치 여부
+     */
+    public function verifyVbankNotifySignature(string $tid, int $amt, string $signature): bool
+    {
+        $expected = bin2hex(hash('sha256', $tid . $this->mid . (string) $amt . $this->merchantKey, true));
+
+        return hash_equals($expected, $signature);
+    }
+
+    /**
+     * 서버 승인 API 호출 (2단계 인증)
+     *
+     * @param string $nextAppUrl  나이스페이먼츠가 전달한 승인 URL
+     * @param string $txTid       임시 거래번호
+     * @param string $authToken   인증 토큰
+     * @param int    $amt         결제 금액
+     * @return array PG 응답 데이터
+     * @throws \Exception API 호출 실패 시
+     */
+    public function authorizePayment(string $nextAppUrl, string $txTid, string $authToken, int $amt): array
+    {
+        // SSRF 방지: NextAppURL은 반드시 나이스페이먼츠 공식 도메인이어야 함
+        if (! $this->isNicePayUrl($nextAppUrl)) {
+            throw new NicePayApiException('Invalid NextAppURL host: ' . parse_url($nextAppUrl, PHP_URL_HOST));
+        }
+
+        $ediDate = $this->computeEdiDate();
+        $signData = bin2hex(hash('sha256', $authToken . $this->mid . (string) $amt . $ediDate . $this->merchantKey, true));
+
+        $response = Http::timeout(15)->asForm()->post($nextAppUrl, [
+            'TID' => $txTid,
+            'AuthToken' => $authToken,
+            'MID' => $this->mid,
+            'Amt' => $amt,
+            'EdiDate' => $ediDate,
+            'SignData' => $signData,
+            'CharSet' => 'utf-8',
+        ]);
+
+        if ($response->failed()) {
+            throw new NicePayApiException('NicePayments authorize API error: HTTP ' . $response->status());
+        }
+
+        return $response->json() ?? [];
+    }
+
+    /**
+     * 결제 취소 API 호출
+     *
+     * before_cancel / after_cancel 액션 훅 발행 — 외부 소비자가 취소 지점에
+     * 본인인증 등 확장 로직을 붙일 수 있는 확장점 제공.
+     *
+     * @param  string  $tid  거래번호
+     * @param  string  $moid  주문번호
+     * @param  int  $cancelAmt  취소 금액
+     * @param  string  $cancelMsg  취소 사유
+     * @param  int  $partialCancelCode  0=전액취소, 1=부분취소
+     * @param  string|null  $refundAcctNo  환불 계좌번호 (가상계좌 입금완료 환불 시 필수)
+     * @param  string|null  $refundBankCd  환불 은행 코드
+     * @param  string|null  $refundAcctNm  환불 계좌 예금주명
+     * @return array PG 응답 데이터
+     * @throws \Exception API 호출 실패 시
+     */
+    public function cancelPayment(
+        string $tid,
+        string $moid,
+        int $cancelAmt,
+        string $cancelMsg,
+        int $partialCancelCode = 0,
+        ?string $refundAcctNo = null,
+        ?string $refundBankCd = null,
+        ?string $refundAcctNm = null,
+    ): array {
+        $ediDate = $this->computeEdiDate();
+        $signData = bin2hex(hash('sha256', $this->mid . (string) $cancelAmt . $ediDate . $this->merchantKey, true));
+
+        // NicePay 취소 API는 EUC-KR 인코딩 요구
+        $cancelMsgEuc = mb_convert_encoding($cancelMsg, 'EUC-KR', 'UTF-8');
+
+        $params = [
+            'TID' => $tid,
+            'MID' => $this->mid,
+            'Moid' => $moid,
+            'CancelAmt' => $cancelAmt,
+            'CancelMsg' => $cancelMsgEuc,
+            'PartialCancelCode' => $partialCancelCode,
+            'EdiDate' => $ediDate,
+            'SignData' => $signData,
+            'CharSet' => 'euc-kr',
+        ];
+
+        // 가상계좌 입금 완료 건 환불 시 환불 계좌 정보 필수
+        if ($refundAcctNo !== null) {
+            $params['RefundAcctNo'] = mb_convert_encoding($refundAcctNo, 'EUC-KR', 'UTF-8');
+            $params['RefundBankCd'] = $refundBankCd ?? '';
+            $params['RefundAcctNm'] = mb_convert_encoding($refundAcctNm ?? '', 'EUC-KR', 'UTF-8');
+        }
+
+        // 훅: 결제 취소 전 (본인인증 등 확장 지점)
+        HookManager::doAction('sirsoft-pay_nicepayments.payment.before_cancel', $tid, $moid, $cancelAmt, $cancelMsg);
+
+        $response = Http::timeout(15)->asForm()->post(self::CANCEL_URL, $params);
+
+        if ($response->failed()) {
+            throw new NicePayApiException('NicePayments cancel API error: HTTP ' . $response->status());
+        }
+
+        // 취소 API는 EUC-KR 응답을 반환하므로 UTF-8로 변환 후 JSON 파싱
+        $rawBody = $response->body();
+        $utf8Body = mb_convert_encoding($rawBody, 'UTF-8', 'EUC-KR');
+        $result = json_decode($utf8Body, true) ?? [];
+
+        if (! \in_array($result['ResultCode'] ?? '', ['2001', '2211'], true)) {
+            Log::error('NicePayments cancel failed', [
+                'result_code' => $result['ResultCode'] ?? 'UNKNOWN',
+                'result_msg' => $result['ResultMsg'] ?? '',
+                'tid' => $tid,
+            ]);
+            throw new NicePayApiException($result['ResultMsg'] ?? 'NicePayments cancel failed');
+        }
+
+        // 훅: 결제 취소 완료 후 (외부 소비자 후처리 확장 지점)
+        HookManager::doAction('sirsoft-pay_nicepayments.payment.after_cancel', $tid, $result);
+
+        return $result;
+    }
+
+    /**
+     * 단건 거래 조회 API 호출
+     *
+     * @param string $tid 조회할 거래번호
+     * @return array PG 응답 데이터
+     * @throws \Exception API 호출 실패 시
+     */
+    public function queryTransaction(string $tid): array
+    {
+        $ediDate = $this->computeEdiDate();
+        // SignData: hex(sha256(TID + MID + EdiDate + MerchantKey)) — TID 먼저
+        $signData = bin2hex(hash('sha256', $tid . $this->mid . $ediDate . $this->merchantKey, true));
+
+        $response = Http::timeout(15)->asForm()->post(self::QUERY_URL, [
+            'TID' => $tid,
+            'MID' => $this->mid,
+            'EdiDate' => $ediDate,
+            'SignData' => $signData,
+            'CharSet' => 'utf-8',
+            'EdiType' => 'JSON',
+        ]);
+
+        if ($response->failed()) {
+            throw new NicePayApiException('NicePayments query API error: HTTP ' . $response->status());
+        }
+
+        return $response->json() ?? [];
+    }
+
+    /**
+     * 망취소 요청 (서버 승인 중 예외 발생 시 결제 원천 취소)
+     *
+     * @param string $netCancelUrl 나이스페이먼츠가 전달한 망취소 URL
+     * @param string $txTid        임시 거래번호 (TxTid)
+     * @param string $authToken    인증 토큰
+     * @param int    $amt          결제 금액
+     */
+    public function sendNetCancel(string $netCancelUrl, string $txTid, string $authToken, int $amt): void
+    {
+        if (! $this->isNicePayUrl($netCancelUrl)) {
+            Log::warning('NicePayments: invalid net cancel URL skipped', ['url' => parse_url($netCancelUrl, PHP_URL_HOST)]);
+
+            return;
+        }
+
+        try {
+            $ediDate = $this->computeEdiDate();
+            $signData = bin2hex(hash('sha256', $authToken . $this->mid . (string) $amt . $ediDate . $this->merchantKey, true));
+
+            Http::timeout(10)->asForm()->post($netCancelUrl, [
+                'TID' => $txTid,
+                'NetCancel' => 1,
+                'AuthToken' => $authToken,
+                'MID' => $this->mid,
+                'Amt' => $amt,
+                'EdiDate' => $ediDate,
+                'SignData' => $signData,
+                'CharSet' => 'utf-8',
+            ]);
+        } catch (\Throwable $e) {
+            Log::error('NicePayments net cancel failed', ['error' => $e->getMessage()]);
+        }
+    }
+
+    /**
+     * EdiDate 생성 (YYYYMMDDHHmmss 형식, 숫자만)
+     */
+    /**
+     * EdiDate 생성 (YYYYMMDDHHmmss 형식, 숫자만)
+     *
+     * @return string 14자리 숫자 문자열
+     */
+    public function generateEdiDate(): string
+    {
+        return preg_replace('/[^0-9]/', '', now()->format('Y-m-d H:i:s')) ?? now()->format('YmdHis');
+    }
+
+    /**
+     * 결제 요청 SignData 생성 (hex(sha256(EdiDate + MID + Amt + MerchantKey)))
+     */
+    /**
+     * 결제 요청 SignData 생성 (hex(sha256(EdiDate + MID + Amt + MerchantKey)))
+     *
+     * @param  string  $ediDate  EdiDate (generateEdiDate 결과)
+     * @param  int  $amt  결제 금액
+     * @return string 64자 hex 서명
+     */
+    public function generateSignData(string $ediDate, int $amt): string
+    {
+        return bin2hex(hash('sha256', $ediDate . $this->mid . (string) $amt . $this->merchantKey, true));
+    }
+
+    private function computeEdiDate(): string
+    {
+        return $this->generateEdiDate();
+    }
+
+    /** NextAppURL / NetCancelURL이 나이스페이먼츠 공식 도메인인지 검증 (SSRF 방지) */
+    private function isNicePayUrl(string $url): bool
+    {
+        $parsed = parse_url($url);
+        $scheme = $parsed['scheme'] ?? '';
+        $host = $parsed['host'] ?? '';
+
+        return $scheme === 'https' && str_ends_with($host, '.nicepay.co.kr');
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/src/Support/UrlHelper.php b/plugins/_bundled/sirsoft-pay_nicepayments/src/Support/UrlHelper.php
new file mode 100644
index 00000000..b2f571cb
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/src/Support/UrlHelper.php
@@ -0,0 +1,41 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Support;
+
+/**
+ * 결제 콜백 redirect URL 빌더
+ *
+ * Laravel 의 `redirect('/path')` 는 내부적으로 `URL::to('/path')` 로 절대 URL 을 만드는데,
+ * reverse proxy 뒤 PHP-FPM 환경에서 `Request::root()` 가 `http://localhost` 로
+ * 떨어지는 경우가 있다 (TrustProxies 미구성, mod_proxy_fcgi 의 Host 미전달 등).
+ *
+ * 결제 콜백은 외부 요청 헤더를 신뢰하면 redirect origin 이 흔들릴 수 있으므로,
+ * 모든 상대 경로는 운영자가 관리하는 config('app.url') 기준으로 절대화한다.
+ */
+final class UrlHelper
+{
+    /**
+     * 상대 경로를 절대 URL 로 변환
+     *
+     * 입력이 이미 `http://` / `https://` 로 시작하면 그대로 반환한다.
+     * 상대 경로는 신뢰 가능한 설정값인 config('app.url') 기준으로 절대화한다.
+     *
+     * @param  string  $urlOrPath  상대 경로 또는 절대 URL
+     * @return string 절대 URL
+     */
+    public static function toAbsolute(string $urlOrPath): string
+    {
+        if (preg_match('#^https?://#i', $urlOrPath) === 1) {
+            return $urlOrPath;
+        }
+
+        $origin = rtrim((string) config('app.url', 'http://localhost'), '/');
+        if ($origin === '') {
+            $origin = 'http://localhost';
+        }
+
+        return rtrim($origin, '/') . '/' . ltrim($urlOrPath, '/');
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/src/routes/api.php b/plugins/_bundled/sirsoft-pay_nicepayments/src/routes/api.php
new file mode 100644
index 00000000..43e6cf5b
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/src/routes/api.php
@@ -0,0 +1,88 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+use Plugins\Sirsoft\PayNicepayments\Controllers\AdminEscrowController;
+use Plugins\Sirsoft\PayNicepayments\Controllers\AdminOrderListController;
+use Plugins\Sirsoft\PayNicepayments\Controllers\AdminSettingsStatusController;
+use Plugins\Sirsoft\PayNicepayments\Controllers\AdminTransactionController;
+use Plugins\Sirsoft\PayNicepayments\Controllers\AdminVbankNotificationController;
+use Plugins\Sirsoft\PayNicepayments\Controllers\AdminVbankRefundController;
+use Plugins\Sirsoft\PayNicepayments\Controllers\PaymentCloseReportController;
+use Plugins\Sirsoft\PayNicepayments\Controllers\UserReceiptController;
+
+/*
+|--------------------------------------------------------------------------
+| NicePayments Plugin API Routes
+|--------------------------------------------------------------------------
+|
+| 프리픽스: /api/plugins/sirsoft-pay_nicepayments (PluginRouteServiceProvider 자동 적용)
+| 미들웨어: api (PluginRouteServiceProvider 자동 적용)
+|
+*/
+
+// PC 결제창 닫힘 보고 — 주문 컨텍스트 검증 후 결제 실패/취소 이력 기록
+Route::post('/payment/close-report', [PaymentCloseReportController::class, 'store'])
+    ->name('payment.close-report');
+
+Route::get('/user/orders/{orderNumber}/receipt', [UserReceiptController::class, 'show'])
+    ->middleware('optional.sanctum')
+    ->name('user.orders.receipt');
+
+Route::prefix('admin')->name('admin.')->middleware(['auth:sanctum', 'admin'])->group(function () {
+    // 가상계좌 입금통보 URL 조회 (관리자 설정 페이지 표시용)
+    Route::get('/vbank-notify-url', function () {
+        return response()->json([
+            'success' => true,
+            'data' => [
+                'url' => url('/plugins/sirsoft-pay_nicepayments/payment/vbank-notify'),
+            ],
+        ]);
+    })->middleware('permission:admin,sirsoft-ecommerce.settings.read')
+        ->name('vbank.notify.url');
+
+    Route::get('/settings/test-mode-status', [AdminSettingsStatusController::class, 'testMode'])
+        ->middleware('permission:admin,sirsoft-ecommerce.settings.read')
+        ->name('settings.test-mode-status');
+
+    // TID 단건 거래 조회
+    Route::post('/transaction/query', [AdminTransactionController::class, 'query'])
+        ->middleware('permission:admin,sirsoft-ecommerce.orders.read')
+        ->name('transaction.query');
+
+    // 주문번호로 나이스페이 거래 조회 (자동 조회용)
+    Route::get('/orders/{orderNumber}/transaction-status', [AdminTransactionController::class, 'queryByOrder'])
+        ->middleware('permission:admin,sirsoft-ecommerce.orders.read')
+        ->name('orders.transaction-status');
+
+    // 테스트 모드 주문 맵 조회 (주문 목록 배지용)
+    Route::get('/orders/test-mode-map', [AdminOrderListController::class, 'testModeMap'])
+        ->middleware('permission:admin,sirsoft-ecommerce.orders.read')
+        ->name('orders.test-mode-map');
+
+    // 주문 목록 간편결제 표시 맵 조회
+    Route::get('/orders/easy-pay-display-map', [AdminOrderListController::class, 'easyPayDisplayMap'])
+        ->middleware('permission:admin,sirsoft-ecommerce.orders.read')
+        ->name('orders.easy-pay-display-map');
+
+    // 가상계좌 입금 완료 건 환불 (환불 계좌 정보 필요)
+    Route::post('/vbank-refund', [AdminVbankRefundController::class, 'refund'])
+        ->middleware('permission:admin,sirsoft-ecommerce.orders.update')
+        ->name('vbank.refund');
+
+    // 에스크로 결제 목록 조회
+    Route::get('/orders/{orderNumber}/escrow-payments', [AdminEscrowController::class, 'getEscrowPayments'])
+        ->middleware('permission:admin,sirsoft-ecommerce.orders.read')
+        ->name('orders.escrow-payments');
+
+    // 에스크로 배송 등록
+    Route::post('/escrow/register-delivery', [AdminEscrowController::class, 'registerDelivery'])
+        ->middleware('permission:admin,sirsoft-ecommerce.orders.update')
+        ->name('escrow.register-delivery');
+
+    // 가상계좌 입금통보 이력 조회 — 어드민 주문 상세 패널에서 사용.
+    // OrderPaymentResource 가 payment_meta 를 노출하지 않으므로, 어드민 전용으로 통보 이력만
+    // 추출해 반환 (PII 는 sanitize 됨).
+    Route::get('/orders/{orderNumber}/vbank-notifications', [AdminVbankNotificationController::class, 'show'])
+        ->middleware('permission:admin,sirsoft-ecommerce.orders.read')
+        ->name('orders.vbank-notifications');
+});
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/src/routes/web.php b/plugins/_bundled/sirsoft-pay_nicepayments/src/routes/web.php
new file mode 100644
index 00000000..ba064a99
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/src/routes/web.php
@@ -0,0 +1,39 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+use Plugins\Sirsoft\PayNicepayments\Controllers\PaymentCallbackController;
+use Plugins\Sirsoft\PayNicepayments\Http\Middleware\VbankNotifyIpWhitelist;
+
+/*
+|--------------------------------------------------------------------------
+| NicePayments Plugin Web Routes
+|--------------------------------------------------------------------------
+|
+| 프리픽스: /plugins/sirsoft-pay_nicepayments (PluginRouteServiceProvider 자동 적용)
+| 미들웨어: web (PluginRouteServiceProvider 자동 적용)
+|
+| 나이스페이먼츠는 브라우저 POST 콜백 방식이므로 CSRF 미들웨어를 제외합니다.
+|
+*/
+
+Route::withoutMiddleware([\Illuminate\Foundation\Http\Middleware\ValidateCsrfToken::class])
+    ->group(function () {
+        // 결제 승인 콜백 (나이스페이먼츠 → 브라우저 POST)
+        Route::post('/payment/callback', [PaymentCallbackController::class, 'authCallback'])
+            ->name('payment.callback');
+
+        // 가상계좌 입금 통보 (나이스페이먼츠 서버 → 우리 서버 POST)
+        // IP 화이트리스트 미들웨어로 NicePay 공식 발송 IP 만 허용
+        Route::post('/payment/vbank-notify', [PaymentCallbackController::class, 'vbankNotify'])
+            ->middleware(VbankNotifyIpWhitelist::class)
+            ->name('payment.vbank-notify');
+    });
+
+// SignData 생성: 비회원 결제도 결제창 진입 직전에 호출하므로 인증 미들웨어를 걸지 않는다.
+// 대신 컨트롤러에서 주문번호, 결제 전 상태, 나이스페이 결제 레코드, 청구 금액을 모두 검증한다.
+Route::withoutMiddleware([\Illuminate\Foundation\Http\Middleware\ValidateCsrfToken::class])
+    ->middleware(['throttle:30,1'])
+    ->group(function () {
+        Route::post('/payment/sign-data', [PaymentCallbackController::class, 'signData'])
+            ->name('payment.sign-data');
+    });
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/tests/Feature/Concerns/PreventsReplayCallbackTest.php b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Feature/Concerns/PreventsReplayCallbackTest.php
new file mode 100644
index 00000000..772f2f7b
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Feature/Concerns/PreventsReplayCallbackTest.php
@@ -0,0 +1,149 @@
+<?php
+
+namespace Plugins\Sirsoft\PayNicepayments\Tests\Feature\Concerns;
+
+use App\Models\User;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderFactory;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderPaymentFactory;
+use Modules\Sirsoft\Ecommerce\Enums\OrderStatusEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentMethodEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentStatusEnum;
+use Plugins\Sirsoft\PayNicepayments\Concerns\PreventsReplayCallback;
+use Plugins\Sirsoft\PayNicepayments\Tests\PluginTestCase;
+
+/**
+ * Phase 3 PoC (Feature) — 나이스페이먼츠 PreventsReplayCallback trait 동작 검증
+ *
+ * 본 테스트는 trait 의 wasAlreadyPaid() 가 다음 시나리오에서 올바르게
+ * 분기하는지 DB 통합 환경에서 검증한다:
+ *
+ *   1. transaction_id null/empty → false (early return, query 미실행)
+ *   2. paid 상태 + 동일 tid 존재 → true (replay detected)
+ *   3. ready 상태만 존재 → false (still in progress)
+ *   4. paid 상태이지만 다른 tid → false (no match)
+ *
+ * 본 trait 의 정확성은 사용 측 컨트롤러 (PaymentCallbackController) 의
+ * 멱등성 분기 정확도에 직결되므로 PoC 의 핵심 검증 대상.
+ */
+class PreventsReplayCallbackTest extends PluginTestCase
+{
+    private object $traitSubject;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        // 익명 클래스에 trait 적용 + protected 메서드를 public 으로 노출
+        $this->traitSubject = new class {
+            use PreventsReplayCallback {
+                wasAlreadyPaid as public;
+            }
+        };
+    }
+
+    private function seedPayment(string $tid, PaymentStatusEnum $status, int $amount = 50000): void
+    {
+        $user = User::factory()->create();
+
+        $order = OrderFactory::new()->create([
+            'user_id' => $user->id,
+            'order_number' => 'ORD-RC-' . random_int(10000, 99999),
+            'order_status' => $status === PaymentStatusEnum::PAID
+                ? OrderStatusEnum::PAYMENT_COMPLETE
+                : OrderStatusEnum::PENDING_ORDER,
+            'subtotal_amount' => $amount,
+            'total_discount_amount' => 0,
+            'total_coupon_discount_amount' => 0,
+            'total_product_coupon_discount_amount' => 0,
+            'total_order_coupon_discount_amount' => 0,
+            'total_code_discount_amount' => 0,
+            'base_shipping_amount' => 0,
+            'extra_shipping_amount' => 0,
+            'shipping_discount_amount' => 0,
+            'total_shipping_amount' => 0,
+            'total_amount' => $amount,
+            'total_due_amount' => $amount,
+            'total_points_used_amount' => 0,
+            'total_deposit_used_amount' => 0,
+            'total_paid_amount' => $status === PaymentStatusEnum::PAID ? $amount : 0,
+        ]);
+
+        OrderPaymentFactory::new()->create([
+            'order_id' => $order->id,
+            'payment_status' => $status,
+            'payment_method' => PaymentMethodEnum::CARD,
+            'pg_provider' => 'nicepayments',
+            'paid_amount_local' => $status === PaymentStatusEnum::PAID ? $amount : 0,
+            'paid_at' => $status === PaymentStatusEnum::PAID ? now() : null,
+            'transaction_id' => $tid,
+        ]);
+    }
+
+    /**
+     * @scenario context=authorize_card, threat=replay_db_long, callback_state=first_arrival
+     * @effects replay_first_arrival_proceeds_normally
+     */
+    public function test_null_transaction_id_returns_false_without_query(): void
+    {
+        $this->assertFalse($this->traitSubject->wasAlreadyPaid(null));
+    }
+
+    /**
+     * @scenario context=authorize_card, threat=replay_db_long, callback_state=first_arrival
+     * @effects replay_first_arrival_proceeds_normally
+     */
+    public function test_empty_transaction_id_returns_false_without_query(): void
+    {
+        $this->assertFalse($this->traitSubject->wasAlreadyPaid(''));
+    }
+
+    /**
+     * @scenario context=authorize_card, threat=replay_db_long, callback_state=second_arrival_outside_60s
+     * @effects replay_detected_on_second_arrival_db
+     */
+    public function test_paid_payment_with_same_tid_returns_true(): void
+    {
+        $tid = 'TID_PAID_001';
+        $this->seedPayment($tid, PaymentStatusEnum::PAID);
+
+        $this->assertTrue($this->traitSubject->wasAlreadyPaid($tid));
+    }
+
+    /**
+     * Ready 상태만 존재 — 아직 결제 미완료이므로 replay 미감지.
+     * @scenario context=authorize_card, threat=replay_db_long, callback_state=first_arrival
+     * @effects replay_first_arrival_proceeds_normally
+     */
+    public function test_ready_status_payment_returns_false(): void
+    {
+        $tid = 'TID_READY_001';
+        $this->seedPayment($tid, PaymentStatusEnum::READY);
+
+        $this->assertFalse($this->traitSubject->wasAlreadyPaid($tid));
+    }
+
+    /**
+     * 다른 tid 로 paid 상태 — 동일 tid 가 아니므로 match 없음.
+     * @scenario context=authorize_card, threat=replay_db_long, callback_state=first_arrival
+     * @effects replay_first_arrival_proceeds_normally
+     */
+    public function test_paid_with_different_tid_returns_false(): void
+    {
+        $this->seedPayment('TID_OTHER_PAYMENT_001', PaymentStatusEnum::PAID);
+
+        $this->assertFalse($this->traitSubject->wasAlreadyPaid('TID_QUERY_001'));
+    }
+
+    /**
+     * Failed 상태 + 동일 tid — paid 가 아니므로 replay 감지 안 함.
+     * @scenario context=authorize_card, threat=replay_db_long, callback_state=first_arrival
+     * @effects replay_first_arrival_proceeds_normally
+     */
+    public function test_failed_payment_with_same_tid_returns_false(): void
+    {
+        $tid = 'TID_FAILED_001';
+        $this->seedPayment($tid, PaymentStatusEnum::FAILED);
+
+        $this->assertFalse($this->traitSubject->wasAlreadyPaid($tid));
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/tests/Feature/Controllers/AdminEscrowControllerTest.php b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Feature/Controllers/AdminEscrowControllerTest.php
new file mode 100644
index 00000000..5aed6b0a
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Feature/Controllers/AdminEscrowControllerTest.php
@@ -0,0 +1,103 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Tests\Feature\Controllers;
+
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderFactory;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderPaymentFactory;
+use Modules\Sirsoft\Ecommerce\Enums\OrderStatusEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentMethodEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentStatusEnum;
+use Plugins\Sirsoft\PayNicepayments\Services\NicePaymentsApiService;
+use Plugins\Sirsoft\PayNicepayments\Tests\PluginTestCase;
+
+class AdminEscrowControllerTest extends PluginTestCase
+{
+    private const TID = 'NICE_ESCROW_TID_001';
+
+    public function test_register_delivery_requires_bound_escrow_payment_and_restores_credentials(): void
+    {
+        $admin = $this->createAdminUser(['sirsoft-ecommerce.orders.update']);
+        $this->createPaidEscrowPayment();
+
+        $apiServiceMock = $this->createMock(NicePaymentsApiService::class);
+        $apiServiceMock->expects($this->once())
+            ->method('useStoredCredentials')
+            ->with(false, 'SRLIVE001');
+        $apiServiceMock->expects($this->once())
+            ->method('registerEscrowDelivery')
+            ->with(
+                self::TID,
+                'CJ대한통운',
+                'TRACK123456',
+                '서울시 테스트구 1',
+                '운영자',
+            )
+            ->willReturn([
+                'ResultCode' => 'C000',
+                'ResultMsg' => '정상처리',
+            ]);
+        $this->app->instance(NicePaymentsApiService::class, $apiServiceMock);
+
+        $response = $this->actingAs($admin)->postJson('/api/plugins/sirsoft-pay_nicepayments/admin/escrow/register-delivery', [
+            'tid' => self::TID,
+            'delivery_name' => 'CJ대한통운',
+            'tracking_number' => 'TRACK123456',
+            'buyer_address' => '서울시 테스트구 1',
+            'register_name' => '운영자',
+        ]);
+
+        $response->assertOk()
+            ->assertJsonPath('success', true)
+            ->assertJsonPath('data.ResultCode', 'C000');
+    }
+
+    public function test_register_delivery_rejects_unbound_tid_before_api_call(): void
+    {
+        $admin = $this->createAdminUser(['sirsoft-ecommerce.orders.update']);
+        $this->createPaidEscrowPayment();
+
+        $apiServiceMock = $this->createMock(NicePaymentsApiService::class);
+        $apiServiceMock->expects($this->never())->method('useStoredCredentials');
+        $apiServiceMock->expects($this->never())->method('registerEscrowDelivery');
+        $this->app->instance(NicePaymentsApiService::class, $apiServiceMock);
+
+        $response = $this->actingAs($admin)->postJson('/api/plugins/sirsoft-pay_nicepayments/admin/escrow/register-delivery', [
+            'tid' => 'ATTACKER_SUPPLIED_TID',
+            'delivery_name' => 'CJ대한통운',
+            'tracking_number' => 'TRACK123456',
+            'buyer_address' => '서울시 테스트구 1',
+            'register_name' => '운영자',
+        ]);
+
+        $response->assertStatus(422)
+            ->assertJsonPath('success', false);
+    }
+
+    private function createPaidEscrowPayment(): void
+    {
+        $order = OrderFactory::new()->create([
+            'order_status' => OrderStatusEnum::PAYMENT_COMPLETE,
+            'subtotal_amount' => 30000,
+            'total_amount' => 30000,
+            'total_due_amount' => 0,
+            'total_paid_amount' => 30000,
+            'paid_at' => now(),
+        ]);
+
+        OrderPaymentFactory::new()->forOrder($order)->create([
+            'payment_status' => PaymentStatusEnum::PAID,
+            'payment_method' => PaymentMethodEnum::CARD,
+            'pg_provider' => 'nicepayments',
+            'is_escrow' => true,
+            'paid_amount_local' => 30000,
+            'paid_at' => now(),
+            'transaction_id' => self::TID,
+            'payment_meta' => [
+                'mid' => 'SRLIVE001',
+                'is_test_mode' => false,
+            ],
+        ]);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/tests/Feature/Controllers/AdminSettingsStatusControllerTest.php b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Feature/Controllers/AdminSettingsStatusControllerTest.php
new file mode 100644
index 00000000..f4cac8bd
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Feature/Controllers/AdminSettingsStatusControllerTest.php
@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Tests\Feature\Controllers;
+
+use App\Services\PluginSettingsService;
+use Plugins\Sirsoft\PayNicepayments\Tests\PluginTestCase;
+
+class AdminSettingsStatusControllerTest extends PluginTestCase
+{
+    public function test_test_mode_status_returns_current_setting(): void
+    {
+        $settings = $this->createMock(PluginSettingsService::class);
+        $settings->expects($this->once())
+            ->method('get')
+            ->with('sirsoft-pay_nicepayments', 'is_test_mode', true)
+            ->willReturn(true);
+        $this->app->instance(PluginSettingsService::class, $settings);
+
+        $admin = $this->createAdminUser(['sirsoft-ecommerce.settings.read']);
+
+        $response = $this->actingAs($admin)
+            ->getJson('/api/plugins/sirsoft-pay_nicepayments/admin/settings/test-mode-status');
+
+        $response->assertOk()
+            ->assertJsonPath('data.is_test_mode', true);
+
+        $data = $response->json('data');
+        $this->assertArrayNotHasKey('test_mid', $data);
+        $this->assertArrayNotHasKey('live_mid', $data);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/tests/Feature/Controllers/AdminVbankRefundControllerTest.php b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Feature/Controllers/AdminVbankRefundControllerTest.php
new file mode 100644
index 00000000..bc8b9f94
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Feature/Controllers/AdminVbankRefundControllerTest.php
@@ -0,0 +1,231 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Tests\Feature\Controllers;
+
+use App\Models\User;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderPaymentFactory;
+use Modules\Sirsoft\Ecommerce\Enums\OrderStatusEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentMethodEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentStatusEnum;
+use Modules\Sirsoft\Ecommerce\Enums\SequenceType;
+use Modules\Sirsoft\Ecommerce\Models\Order;
+use Modules\Sirsoft\Ecommerce\Models\OrderOption;
+use Modules\Sirsoft\Ecommerce\Models\OrderRefund;
+use Modules\Sirsoft\Ecommerce\Models\Sequence;
+use Plugins\Sirsoft\PayNicepayments\Services\NicePaymentsApiService;
+use Plugins\Sirsoft\PayNicepayments\Tests\PluginTestCase;
+
+class AdminVbankRefundControllerTest extends PluginTestCase
+{
+    private const TID = 'NICE_VBANK_TID_001';
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        $this->createCancelSequences();
+    }
+
+    public function test_admin_vbank_refund_updates_order_domain_after_pg_cancel(): void
+    {
+        $admin = $this->createAdminUser(['sirsoft-ecommerce.orders.update']);
+        $order = $this->createPaidVbankOrder();
+
+        $apiServiceMock = $this->createMock(NicePaymentsApiService::class);
+        $apiServiceMock->expects($this->once())
+            ->method('useStoredCredentials')
+            ->with(false, 'SRLIVE001');
+        $apiServiceMock->expects($this->once())
+            ->method('cancelPayment')
+            ->with(
+                self::TID,
+                $order->order_number,
+                30000,
+                '가상계좌 환불',
+                0,
+                '1234567890',
+                '004',
+                '홍길동',
+            )
+            ->willReturn([
+                'ResultCode' => '2001',
+                'ResultMsg' => '취소 성공',
+                'TID' => self::TID,
+                'CancelAmt' => '30000',
+            ]);
+
+        $this->app->instance(NicePaymentsApiService::class, $apiServiceMock);
+
+        $response = $this->actingAs($admin)->postJson('/api/plugins/sirsoft-pay_nicepayments/admin/vbank-refund', [
+            'tid' => self::TID,
+            'moid' => $order->order_number,
+            'cancel_amt' => 30000,
+            'cancel_msg' => '가상계좌 환불',
+            'refund_acct_no' => '1234567890',
+            'refund_bank_cd' => '004',
+            'refund_acct_nm' => '홍길동',
+        ]);
+
+        $response->assertOk()->assertJsonPath('success', true);
+
+        $order->refresh();
+        $payment = $order->payment->fresh();
+        $refund = OrderRefund::query()->where('order_id', $order->id)->first();
+
+        $this->assertEquals(OrderStatusEnum::CANCELLED, $order->order_status);
+        $this->assertEquals(PaymentStatusEnum::CANCELLED, $payment->payment_status);
+        $this->assertEquals(30000.0, (float) $payment->cancelled_amount);
+        $this->assertSame('completed', $payment->payment_meta['vbank_refund_status'] ?? null);
+        $this->assertNotNull($refund);
+        $this->assertEquals(30000.0, (float) $refund->refund_amount);
+    }
+
+    public function test_admin_vbank_refund_rejects_amount_mismatch_before_pg_cancel(): void
+    {
+        $admin = $this->createAdminUser(['sirsoft-ecommerce.orders.update']);
+        $order = $this->createPaidVbankOrder();
+
+        $apiServiceMock = $this->createMock(NicePaymentsApiService::class);
+        $apiServiceMock->expects($this->never())->method('cancelPayment');
+        $this->app->instance(NicePaymentsApiService::class, $apiServiceMock);
+
+        $response = $this->actingAs($admin)->postJson('/api/plugins/sirsoft-pay_nicepayments/admin/vbank-refund', [
+            'tid' => self::TID,
+            'moid' => $order->order_number,
+            'cancel_amt' => 29999,
+            'refund_acct_no' => '1234567890',
+            'refund_bank_cd' => '004',
+            'refund_acct_nm' => '홍길동',
+        ]);
+
+        $response->assertStatus(422)->assertJsonPath('success', false);
+
+        $order->refresh();
+        $this->assertEquals(OrderStatusEnum::PAYMENT_COMPLETE, $order->order_status);
+        $this->assertEquals(0.0, (float) $order->payment->cancelled_amount);
+    }
+
+    public function test_admin_vbank_refund_requires_orders_update_permission(): void
+    {
+        $admin = $this->createAdminUser(['sirsoft-ecommerce.orders.read']);
+        $order = $this->createPaidVbankOrder();
+
+        $apiServiceMock = $this->createMock(NicePaymentsApiService::class);
+        $apiServiceMock->expects($this->never())->method('cancelPayment');
+        $this->app->instance(NicePaymentsApiService::class, $apiServiceMock);
+
+        $response = $this->actingAs($admin)->postJson('/api/plugins/sirsoft-pay_nicepayments/admin/vbank-refund', [
+            'tid' => self::TID,
+            'moid' => $order->order_number,
+            'cancel_amt' => 30000,
+            'refund_acct_no' => '1234567890',
+            'refund_bank_cd' => '004',
+            'refund_acct_nm' => '홍길동',
+        ]);
+
+        $response->assertForbidden();
+    }
+
+    private function createPaidVbankOrder(): Order
+    {
+        $user = User::factory()->create();
+
+        $order = Order::factory()->create([
+            'user_id' => $user->id,
+            'order_status' => OrderStatusEnum::PAYMENT_COMPLETE,
+            'subtotal_amount' => 30000,
+            'total_shipping_amount' => 0,
+            'total_amount' => 30000,
+            'total_paid_amount' => 30000,
+            'total_due_amount' => 0,
+            'total_cancelled_amount' => 0,
+            'cancellation_count' => 0,
+            'paid_at' => now(),
+            'promotions_applied_snapshot' => [],
+            'shipping_policy_applied_snapshot' => [],
+        ]);
+
+        OrderOption::factory()->forOrder($order)->create([
+            'quantity' => 1,
+            'unit_price' => 30000,
+            'subtotal_price' => 30000,
+            'subtotal_paid_amount' => 30000,
+            'subtotal_discount_amount' => 0,
+            'option_status' => OrderStatusEnum::PAYMENT_COMPLETE,
+            'product_snapshot' => [
+                'id' => null,
+                'name' => ['ko' => '테스트상품', 'en' => 'Test Product'],
+                'product_code' => null,
+                'sku' => null,
+                'brand_id' => null,
+                'list_price' => 30000,
+                'selling_price' => 30000,
+                'currency_code' => 'KRW',
+                'stock_quantity' => 100,
+                'tax_status' => 'taxable',
+                'tax_rate' => 10,
+                'has_options' => false,
+                'option_groups' => null,
+                'thumbnail_url' => null,
+            ],
+            'option_snapshot' => [
+                'id' => null,
+                'option_code' => null,
+                'option_values' => null,
+                'option_name' => '기본',
+                'price_adjustment' => 0,
+                'list_price' => 30000,
+                'selling_price' => 30000,
+                'currency_code' => 'KRW',
+                'stock_quantity' => 100,
+                'weight' => 0.5,
+                'volume' => 0.01,
+                'sku' => null,
+                'is_default' => true,
+            ],
+        ]);
+
+        OrderPaymentFactory::new()->forOrder($order)->create([
+            'payment_status' => PaymentStatusEnum::PAID,
+            'payment_method' => PaymentMethodEnum::VBANK,
+            'pg_provider' => 'nicepayments',
+            'paid_amount_local' => 30000,
+            'paid_amount_base' => 30000,
+            'cancelled_amount' => 0,
+            'paid_at' => now(),
+            'transaction_id' => self::TID,
+            'vbank_number' => '0987654321',
+            'vbank_name' => '국민은행',
+            'payment_meta' => [
+                'mid' => 'SRLIVE001',
+                'is_test_mode' => false,
+                'vbank_tid' => self::TID,
+                'vbank_num' => '0987654321',
+            ],
+        ]);
+
+        return $order->fresh(['payment', 'options', 'shippings']);
+    }
+
+    private function createCancelSequences(): void
+    {
+        foreach ([SequenceType::CANCEL, SequenceType::REFUND] as $type) {
+            $cfg = $type->getDefaultConfig();
+            Sequence::firstOrCreate(
+                ['type' => $type->value],
+                [
+                    'algorithm' => $cfg['algorithm']->value,
+                    'prefix' => $cfg['prefix'],
+                    'current_value' => 0,
+                    'increment' => 1,
+                    'min_value' => 1,
+                    'max_value' => $cfg['max_value'],
+                    'cycle' => false,
+                    'pad_length' => $cfg['pad_length'],
+                ]
+            );
+        }
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/tests/Feature/Controllers/EasyPayDisplayControllerTest.php b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Feature/Controllers/EasyPayDisplayControllerTest.php
new file mode 100644
index 00000000..a746100c
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Feature/Controllers/EasyPayDisplayControllerTest.php
@@ -0,0 +1,147 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Tests\Feature\Controllers;
+
+use App\Models\User;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderFactory;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderPaymentFactory;
+use Modules\Sirsoft\Ecommerce\Enums\OrderStatusEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentMethodEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentStatusEnum;
+use Plugins\Sirsoft\PayNicepayments\Services\NicePaymentsApiService;
+use Plugins\Sirsoft\PayNicepayments\Tests\PluginTestCase;
+
+class EasyPayDisplayControllerTest extends PluginTestCase
+{
+    public function test_admin_order_list_easy_pay_display_map_returns_display_labels(): void
+    {
+        app()->setLocale('ko');
+
+        $admin = $this->createAdminUser(['sirsoft-ecommerce.orders.read']);
+        $order = $this->createPaidEasyPayOrder('nicepay_payco', 'payco', [
+            'ko' => 'PAYCO (페이코)',
+            'en' => 'PAYCO',
+        ]);
+
+        $response = $this->actingAs($admin)
+            ->getJson('/api/plugins/sirsoft-pay_nicepayments/admin/orders/easy-pay-display-map');
+
+        $response->assertOk();
+
+        $display = $response->json("data.{$order->order_number}");
+        $this->assertSame('payco', $display['embedded_pg_provider'] ?? null);
+        $this->assertContains($display['embedded_pg_provider_label'] ?? null, ['PAYCO (페이코)', 'PAYCO']);
+        $this->assertSame(
+            ($display['embedded_pg_provider_label'] ?? '') . ' (' . ($display['payment_method_label'] ?? '') . ')',
+            $display['payment_method_display_label'] ?? null,
+        );
+    }
+
+    public function test_admin_transaction_status_includes_easy_pay_display_label(): void
+    {
+        app()->setLocale('ko');
+
+        $admin = $this->createAdminUser(['sirsoft-ecommerce.orders.read']);
+        $order = $this->createPaidEasyPayOrder('nicepay_kakaopay', 'kakaopay', [
+            'ko' => '카카오페이',
+            'en' => 'KakaoPay',
+        ]);
+
+        $apiServiceMock = $this->createMock(NicePaymentsApiService::class);
+        $apiServiceMock->expects($this->once())
+            ->method('queryTransaction')
+            ->with('NICE_TID_' . $order->id)
+            ->willReturn([
+                'ResultCode' => '3001',
+                'ResultMsg' => '정상처리',
+                'TID' => 'NICE_TID_' . $order->id,
+                'PayMethod' => 'CARD',
+            ]);
+        $this->app->instance(NicePaymentsApiService::class, $apiServiceMock);
+
+        $response = $this->actingAs($admin)
+            ->getJson("/api/plugins/sirsoft-pay_nicepayments/admin/orders/{$order->order_number}/transaction-status");
+
+        $response->assertOk()
+            ->assertJsonPath('data._embedded_pg_provider', 'kakaopay');
+
+        $data = $response->json('data');
+        $this->assertContains($data['_embedded_pg_provider_label'] ?? null, ['카카오페이', 'KakaoPay']);
+        $this->assertSame(
+            ($data['_embedded_pg_provider_label'] ?? '') . ' (' . ($data['_base_pay_method_label'] ?? '') . ')',
+            $data['_pay_method_label'] ?? null,
+        );
+    }
+
+    public function test_user_receipt_response_includes_easy_pay_display_label(): void
+    {
+        app()->setLocale('ko');
+
+        $user = User::factory()->create();
+        $order = $this->createPaidEasyPayOrder('nicepay_naverpay', 'naverpay', [
+            'ko' => '네이버페이',
+            'en' => 'NaverPay',
+        ], $user);
+
+        $response = $this->actingAs($user)
+            ->getJson("/api/plugins/sirsoft-pay_nicepayments/user/orders/{$order->order_number}/receipt");
+
+        $response->assertOk()
+            ->assertJsonPath('selected_payment_method', 'nicepay_naverpay')
+            ->assertJsonPath('embedded_pg_provider', 'naverpay');
+
+        $data = $response->json();
+        $this->assertContains($data['embedded_pg_provider_label'] ?? null, ['네이버페이', 'NaverPay']);
+        $this->assertSame(
+            ($data['embedded_pg_provider_label'] ?? '') . ' (' . ($data['payment_method_label'] ?? '') . ')',
+            $data['payment_method_display_label'] ?? null,
+        );
+    }
+
+    /**
+     * @param array{ko: string, en: string} $label
+     */
+    private function createPaidEasyPayOrder(
+        string $method,
+        string $provider,
+        array $label,
+        ?User $user = null,
+    ): \Modules\Sirsoft\Ecommerce\Models\Order {
+        $order = OrderFactory::new()->create([
+            'user_id' => ($user ?? User::factory()->create())->id,
+            'order_number' => 'ORD-NICE-EASY-' . random_int(10000, 99999),
+            'order_status' => OrderStatusEnum::PAYMENT_COMPLETE,
+            'subtotal_amount' => 50000,
+            'total_amount' => 50000,
+            'total_due_amount' => 0,
+            'total_paid_amount' => 50000,
+            'currency' => 'KRW',
+            'currency_snapshot' => self::krwCurrencySnapshot(),
+            'paid_at' => now(),
+        ]);
+
+        OrderPaymentFactory::new()->create([
+            'order_id' => $order->id,
+            'payment_status' => PaymentStatusEnum::PAID,
+            'payment_method' => PaymentMethodEnum::CARD,
+            'pg_provider' => 'nicepayments',
+            'transaction_id' => 'NICE_TID_' . $order->id,
+            'embedded_pg_provider' => $provider,
+            'paid_amount_local' => 50000,
+            'paid_at' => now(),
+            'payment_meta' => [
+                'nicepay_easy_pay_method' => $method,
+                'nicepay_easy_pay_provider' => $provider,
+                'nicepay_easy_pay_label' => $label,
+                'pg_raw_response' => [
+                    'ResultCode' => '3001',
+                    'PayMethod' => 'CARD',
+                ],
+            ],
+        ]);
+
+        return $order;
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/tests/Feature/Controllers/PaymentCallbackControllerTest.php b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Feature/Controllers/PaymentCallbackControllerTest.php
new file mode 100644
index 00000000..7626bb3b
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Feature/Controllers/PaymentCallbackControllerTest.php
@@ -0,0 +1,1144 @@
+<?php
+
+namespace Plugins\Sirsoft\PayNicepayments\Tests\Feature\Controllers;
+
+use App\Extension\HookManager;
+use App\Models\User;
+use Illuminate\Support\Facades\RateLimiter;
+use Illuminate\Support\Facades\Http;
+use Illuminate\Support\Facades\Log;
+use Mockery;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderAddressFactory;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderFactory;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderOptionFactory;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderPaymentFactory;
+use Modules\Sirsoft\Ecommerce\Enums\OrderStatusEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentMethodEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentStatusEnum;
+use Modules\Sirsoft\Ecommerce\Models\Order;
+use Plugins\Sirsoft\PayNicepayments\Tests\PluginTestCase;
+
+class PaymentCallbackControllerTest extends PluginTestCase
+{
+    private const TEST_MID = 'nicepay00m';
+
+    private const TEST_MERCHANT_KEY = 'EYzu8jGGMfqaDEp76gSckuvnaHHu+bC4opsSN6lHv3b2lurNYkVXrZ7Z1AoqQnXI3eLuaUFyoRNC6FkrzVjceg==';
+
+    private function makeAuthorizeResponse(string $tid, string $moid, int $amount, string $resultCode = '3001'): array
+    {
+        return [
+            'ResultCode' => $resultCode,
+            'ResultMsg' => '정상처리',
+            'TID' => $tid,
+            'Moid' => $moid,
+            'Amt' => (string) $amount,
+            'PayMethod' => 'CARD',
+            'AppNo' => 'APP12345',
+            'CardNum' => '4330-****-****-1234',
+            'IssuCardName' => '신한카드',
+            'CardQuota' => '00',
+            'AuthDate' => now()->format('YmdHis'),
+        ];
+    }
+
+    private function createTestOrder(
+        int $totalAmount = 50000,
+        PaymentMethodEnum $paymentMethod = PaymentMethodEnum::CARD,
+    ): Order {
+        $user = User::factory()->create();
+
+        $order = OrderFactory::new()->create([
+            'user_id' => $user->id,
+            'order_number' => 'ORD-TEST-' . random_int(10000, 99999),
+            'order_status' => OrderStatusEnum::PENDING_ORDER,
+            'subtotal_amount' => $totalAmount,
+            'total_discount_amount' => 0,
+            'total_coupon_discount_amount' => 0,
+            'total_product_coupon_discount_amount' => 0,
+            'total_order_coupon_discount_amount' => 0,
+            'total_code_discount_amount' => 0,
+            'base_shipping_amount' => 0,
+            'extra_shipping_amount' => 0,
+            'shipping_discount_amount' => 0,
+            'total_shipping_amount' => 0,
+            'total_amount' => $totalAmount,
+            'total_due_amount' => $totalAmount,
+            'total_points_used_amount' => 0,
+            'total_deposit_used_amount' => 0,
+            'total_paid_amount' => 0,
+            'currency' => 'KRW',
+            'currency_snapshot' => self::krwCurrencySnapshot(),
+        ]);
+
+        OrderPaymentFactory::new()->create([
+            'order_id' => $order->id,
+            'payment_status' => PaymentStatusEnum::READY,
+            'payment_method' => $paymentMethod,
+            'pg_provider' => 'nicepayments',
+            'paid_amount_local' => 0,
+            'paid_at' => null,
+            'transaction_id' => null,
+            'card_approval_number' => null,
+        ]);
+
+        return $order;
+    }
+
+    private function mockPluginSettings(array $overrides = []): void
+    {
+        $defaults = [
+            'is_test_mode' => true,
+            'test_mid' => self::TEST_MID,
+            'test_merchant_key' => self::TEST_MERCHANT_KEY,
+            'live_mid' => '',
+            'live_merchant_key' => '',
+            'redirect_success_url' => '/shop/orders/{orderId}/complete',
+            'redirect_fail_url' => '/shop/checkout',
+        ];
+
+        $settingsMock = $this->createMock(\App\Services\PluginSettingsService::class);
+        $settingsMock->method('get')
+            ->willReturn(array_merge($defaults, $overrides));
+
+        $this->app->instance(\App\Services\PluginSettingsService::class, $settingsMock);
+    }
+
+    private function makeSignature(string $authToken, string $mid, int $amt, string $merchantKey): string
+    {
+        return bin2hex(hash('sha256', $authToken . $mid . (string) $amt . $merchantKey, true));
+    }
+
+    private function makeCallbackParams(string $moid, int $amt, array $overrides = []): array
+    {
+        $authToken = 'AUTH_TOKEN_' . uniqid();
+        $signature = $this->makeSignature($authToken, self::TEST_MID, $amt, self::TEST_MERCHANT_KEY);
+
+        return array_merge([
+            'AuthResultCode' => '0000',
+            'AuthResultMsg' => '성공',
+            'NextAppURL' => 'https://pay.nicepay.co.kr/v1/authorize',
+            'TxTid' => 'TX_TID_' . uniqid(),
+            'AuthToken' => $authToken,
+            'PayMethod' => 'CARD',
+            'MID' => self::TEST_MID,
+            'Moid' => $moid,
+            'Amt' => $amt,
+            'NetCancelURL' => 'https://pay.nicepay.co.kr/v1/netcancel',
+            'Signature' => $signature,
+        ], $overrides);
+    }
+
+    private function makeVbankNotifyPayload(string $moid, int $amt, array $overrides = []): array
+    {
+        return array_merge([
+            'PG' => 'nicepay',
+            'PayMethod' => 'VBANK',
+            'MID' => self::TEST_MID,
+            'MOID' => $moid,
+            'TID' => 'VBANK_TID_' . uniqid(),
+            'Amt' => $amt,
+            'ResultCode' => '4110',
+            'ResultMsg' => '입금완료',
+            'AuthDate' => now()->format('YmdHis'),
+            'AuthCode' => 'AUTH12345',
+            'VbankNum' => '1234567890',
+            'VbankName' => '국민은행',
+            'VbankInputName' => '홍길동',
+            'FnCd' => '004',
+            'FnName' => '국민은행',
+        ], $overrides);
+    }
+
+    private function markVbankIssued(Order $order, string $tid, int $amount, array $overrides = []): void
+    {
+        $order->payment()->update([
+            'payment_method' => PaymentMethodEnum::VBANK,
+            'payment_status' => PaymentStatusEnum::WAITING_DEPOSIT,
+            'pg_provider' => 'nicepayments',
+            'vbank_name' => $overrides['vbank_name'] ?? '국민은행',
+            'vbank_number' => $overrides['vbank_number'] ?? '1234567890',
+            'vbank_issued_at' => now(),
+            'payment_meta' => array_merge([
+                'result_code' => '4100',
+                'pay_method' => 'VBANK',
+                'mid' => self::TEST_MID,
+                'vbank_tid' => $tid,
+                'vbank_num' => $overrides['vbank_number'] ?? '1234567890',
+                'vbank_name' => $overrides['vbank_name'] ?? '국민은행',
+                'is_test_mode' => true,
+            ], $overrides['payment_meta'] ?? []),
+        ]);
+    }
+
+    // ===== SignData 생성 테스트 =====
+
+    public function test_sign_data_allows_guest_pending_nicepayments_order(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $this->mockPluginSettings();
+
+        $response = $this->postJson('/plugins/sirsoft-pay_nicepayments/payment/sign-data', [
+            'amt' => 50000,
+            'moid' => $order->order_number,
+        ]);
+
+        $response->assertOk()
+            ->assertJsonStructure([
+                'ediDate',
+                'signData',
+                'mid',
+            ])
+            ->assertJsonPath('mid', self::TEST_MID);
+
+        $this->assertSame(64, strlen((string) $response->json('signData')));
+    }
+
+    public function test_sign_data_rejects_amount_mismatch(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $this->mockPluginSettings();
+
+        $response = $this->postJson('/plugins/sirsoft-pay_nicepayments/payment/sign-data', [
+            'amt' => 49999,
+            'moid' => $order->order_number,
+        ]);
+
+        $response->assertStatus(422)
+            ->assertJsonPath('error', __('sirsoft-pay_nicepayments::messages.errors.invalid_amount'));
+    }
+
+    public function test_sign_data_rejects_buyer_mismatch(): void
+    {
+        $order = $this->createTestOrder(50000);
+        OrderAddressFactory::new()->forOrder($order)->shipping()->create([
+            'orderer_email' => 'buyer@example.com',
+            'orderer_phone' => '010-1234-5678',
+        ]);
+        $this->mockPluginSettings();
+
+        $response = $this->postJson('/plugins/sirsoft-pay_nicepayments/payment/sign-data', [
+            'amt' => 50000,
+            'moid' => $order->order_number,
+            'buyer_email' => 'attacker@example.com',
+            'buyer_phone' => '01099999999',
+        ]);
+
+        $response->assertForbidden()
+            ->assertJsonPath('error', __('sirsoft-pay_nicepayments::messages.errors.invalid_request'));
+    }
+
+    public function test_sign_data_is_rate_limited_by_order_and_ip(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $this->mockPluginSettings();
+
+        RateLimiter::clear('sirsoft-pay_nicepayments:sign-data:'.sha1('127.0.0.1|'.$order->order_number));
+
+        for ($i = 0; $i < 20; $i++) {
+            $this->postJson('/plugins/sirsoft-pay_nicepayments/payment/sign-data', [
+                'amt' => 50000,
+                'moid' => $order->order_number,
+            ])->assertOk();
+        }
+
+        $this->postJson('/plugins/sirsoft-pay_nicepayments/payment/sign-data', [
+            'amt' => 50000,
+            'moid' => $order->order_number,
+        ])->assertStatus(429)
+            ->assertJsonPath('error', __('sirsoft-pay_nicepayments::messages.errors.invalid_request'));
+    }
+
+    public function test_sign_data_rejects_unchargeable_payment_currency(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $order->update([
+            'currency' => 'USD',
+            'currency_snapshot' => self::unchargeableUsdCurrencySnapshot(),
+        ]);
+        $this->mockPluginSettings();
+
+        $response = $this->postJson('/plugins/sirsoft-pay_nicepayments/payment/sign-data', [
+            'amt' => 50000,
+            'moid' => $order->order_number,
+        ]);
+
+        $response->assertStatus(422)
+            ->assertJsonPath('error', __('sirsoft-pay_nicepayments::messages.errors.invalid_request'));
+
+        $order->refresh();
+        $this->assertEquals(OrderStatusEnum::PENDING_ORDER, $order->order_status);
+        $this->assertEquals(PaymentStatusEnum::READY, $order->payment->payment_status);
+    }
+
+    public function test_sign_data_rejects_non_payable_order(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $order->update(['order_status' => OrderStatusEnum::CANCELLED]);
+        $order->payment()->update(['payment_status' => PaymentStatusEnum::FAILED]);
+        $this->mockPluginSettings();
+
+        $response = $this->postJson('/plugins/sirsoft-pay_nicepayments/payment/sign-data', [
+            'amt' => 50000,
+            'moid' => $order->order_number,
+        ]);
+
+        $response->assertStatus(422)
+            ->assertJsonPath('error', __('sirsoft-pay_nicepayments::messages.errors.invalid_request'));
+    }
+
+    public function test_sign_data_rejects_live_mode_when_live_mid_is_missing(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $this->mockPluginSettings([
+            'is_test_mode' => false,
+            'live_mid' => '',
+            'live_merchant_key' => 'live_key',
+        ]);
+
+        $response = $this->postJson('/plugins/sirsoft-pay_nicepayments/payment/sign-data', [
+            'amt' => 50000,
+            'moid' => $order->order_number,
+        ]);
+
+        $response->assertStatus(422)
+            ->assertJsonPath('error', __('sirsoft-pay_nicepayments::messages.errors.invalid_request'));
+    }
+
+    public function test_sign_data_restores_retryable_failed_nicepayments_order(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $order->update([
+            'order_status' => OrderStatusEnum::CANCELLED,
+            'order_meta' => [
+                'payment_failure_code' => 'USER_CANCEL',
+                'payment_failure_message' => '사용자가 결제창을 닫았습니다.',
+                'payment_failed_at' => now()->toIso8601String(),
+            ],
+        ]);
+        $order->payment()->update([
+            'payment_status' => PaymentStatusEnum::FAILED,
+            'payment_meta' => [
+                'failure_source' => 'nicepayments',
+                'failure_code' => 'USER_CANCEL',
+                'failure_message' => '사용자가 결제창을 닫았습니다.',
+                'failed_at' => now()->toIso8601String(),
+            ],
+        ]);
+        $this->mockPluginSettings();
+
+        $response = $this->postJson('/plugins/sirsoft-pay_nicepayments/payment/sign-data', [
+            'amt' => 50000,
+            'moid' => $order->order_number,
+        ]);
+
+        $response->assertOk()
+            ->assertJsonStructure(['ediDate', 'signData', 'mid']);
+
+        $order->refresh();
+        $payment = $order->payment->fresh();
+
+        $this->assertEquals(OrderStatusEnum::PENDING_ORDER, $order->order_status);
+        $this->assertEquals(PaymentStatusEnum::READY, $payment->payment_status);
+        $this->assertArrayNotHasKey('payment_failure_code', $order->order_meta);
+        $this->assertEquals(1, $order->order_meta['nicepayments_retry_count'] ?? null);
+        $this->assertArrayNotHasKey('failure_code', $payment->payment_meta);
+        $this->assertEquals(1, $payment->payment_meta['retry_count'] ?? null);
+    }
+
+    public function test_sign_data_does_not_restore_amount_mismatch_failure(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $order->update([
+            'order_status' => OrderStatusEnum::CANCELLED,
+            'order_meta' => [
+                'payment_failure_code' => 'AMOUNT_MISMATCH',
+                'payment_failure_message' => 'amount mismatch',
+                'payment_failed_at' => now()->toIso8601String(),
+            ],
+        ]);
+        $order->payment()->update([
+            'payment_status' => PaymentStatusEnum::FAILED,
+            'payment_meta' => [
+                'failure_source' => 'nicepayments',
+                'failure_code' => 'AMOUNT_MISMATCH',
+                'failure_message' => 'amount mismatch',
+                'failed_at' => now()->toIso8601String(),
+            ],
+        ]);
+        $this->mockPluginSettings();
+
+        $response = $this->postJson('/plugins/sirsoft-pay_nicepayments/payment/sign-data', [
+            'amt' => 50000,
+            'moid' => $order->order_number,
+        ]);
+
+        $response->assertStatus(422)
+            ->assertJsonPath('error', __('sirsoft-pay_nicepayments::messages.errors.invalid_request'));
+
+        $order->refresh();
+        $payment = $order->payment->fresh();
+
+        $this->assertEquals(OrderStatusEnum::CANCELLED, $order->order_status);
+        $this->assertEquals(PaymentStatusEnum::FAILED, $payment->payment_status);
+    }
+
+    public function test_sign_data_rejects_non_nicepayments_payment_record(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $order->payment()->update(['pg_provider' => 'kginicis']);
+        $this->mockPluginSettings();
+
+        $response = $this->postJson('/plugins/sirsoft-pay_nicepayments/payment/sign-data', [
+            'amt' => 50000,
+            'moid' => $order->order_number,
+        ]);
+
+        $response->assertStatus(422)
+            ->assertJsonPath('error', __('sirsoft-pay_nicepayments::messages.errors.invalid_request'));
+    }
+
+    public function test_sign_data_rejects_missing_payment_record(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $order->payment()->delete();
+        $this->mockPluginSettings();
+
+        $response = $this->postJson('/plugins/sirsoft-pay_nicepayments/payment/sign-data', [
+            'amt' => 50000,
+            'moid' => $order->order_number,
+        ]);
+
+        $response->assertStatus(422)
+            ->assertJsonPath('error', __('sirsoft-pay_nicepayments::messages.errors.invalid_request'));
+    }
+
+    public function test_sign_data_rejects_unknown_order(): void
+    {
+        $this->mockPluginSettings();
+
+        $response = $this->postJson('/plugins/sirsoft-pay_nicepayments/payment/sign-data', [
+            'amt' => 50000,
+            'moid' => 'ORD-NOT-FOUND',
+        ]);
+
+        $response->assertStatus(422)
+            ->assertJsonPath('error', __('sirsoft-pay_nicepayments::messages.errors.order_not_found'));
+    }
+
+    // ===== 성공 콜백 테스트 =====
+
+    public function test_auth_callback_redirects_to_complete_page_on_valid_payment(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $this->mockPluginSettings();
+
+        $tid = 'TID_' . uniqid();
+        $params = $this->makeCallbackParams($order->order_number, 50000);
+
+        Http::fake([
+            'pay.nicepay.co.kr/v1/authorize' => Http::response(
+                $this->makeAuthorizeResponse($tid, $order->order_number, 50000),
+                200
+            ),
+        ]);
+
+        $response = $this->post('/plugins/sirsoft-pay_nicepayments/payment/callback', $params);
+
+        $response->assertRedirect("/shop/orders/{$order->order_number}/complete");
+
+        $order->refresh();
+        $this->assertEquals(OrderStatusEnum::PAYMENT_COMPLETE, $order->order_status);
+
+        $payment = $order->payment;
+        $payment->refresh();
+        $this->assertEquals($tid, $payment->transaction_id);
+        $this->assertEquals('APP12345', $payment->card_approval_number);
+    }
+
+    public function test_auth_callback_stores_easy_pay_display_metadata(): void
+    {
+        app()->setLocale('ko');
+
+        $order = $this->createTestOrder(50000);
+        $this->mockPluginSettings();
+
+        $tid = 'TID_EASY_PAY_' . uniqid();
+        $params = $this->makeCallbackParams($order->order_number, 50000, [
+            'MallReserved' => 'nicepay_easy_pay_method=nicepay_kakaopay',
+            'MallReserved1' => 'nicepay_kakaopay',
+        ]);
+
+        Http::fake([
+            'pay.nicepay.co.kr/v1/authorize' => Http::response(
+                $this->makeAuthorizeResponse($tid, $order->order_number, 50000),
+                200
+            ),
+        ]);
+
+        $response = $this->post('/plugins/sirsoft-pay_nicepayments/payment/callback', $params);
+
+        $response->assertRedirect("/shop/orders/{$order->order_number}/complete");
+
+        $payment = $order->payment;
+        $payment->refresh();
+        $meta = $payment->payment_meta;
+
+        $this->assertSame('kakaopay', $payment->embedded_pg_provider);
+        $this->assertSame('nicepay_kakaopay', $meta['nicepay_easy_pay_method'] ?? null);
+        $this->assertSame('kakaopay', $meta['nicepay_easy_pay_provider'] ?? null);
+        $this->assertSame('카카오페이', $meta['nicepay_easy_pay_label']['ko'] ?? null);
+        $this->assertSame('KakaoPay', $meta['nicepay_easy_pay_label']['en'] ?? null);
+        $this->assertSame('kakaopay', $meta['embedded_pg_provider'] ?? null);
+    }
+
+    public function test_auth_callback_stores_only_whitelisted_pg_response_fields(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $this->mockPluginSettings();
+
+        $tid = 'TID_SANITIZED';
+        $params = $this->makeCallbackParams($order->order_number, 50000);
+
+        Http::fake([
+            'pay.nicepay.co.kr/v1/authorize' => Http::response(array_merge(
+                $this->makeAuthorizeResponse($tid, $order->order_number, 50000),
+                [
+                    'BuyerName' => '홍길동',
+                    'BuyerEmail' => 'buyer@example.test',
+                    'BuyerTel' => '01012345678',
+                    'NewSensitiveField' => 'store-me-not',
+                ]
+            ), 200),
+        ]);
+
+        $response = $this->post('/plugins/sirsoft-pay_nicepayments/payment/callback', $params);
+
+        $response->assertRedirect("/shop/orders/{$order->order_number}/complete");
+
+        $payment = $order->payment;
+        $payment->refresh();
+
+        $meta = $payment->payment_meta;
+        $this->assertTrue($meta['pg_response_sanitized'] ?? false);
+        $this->assertSame($tid, $meta['pg_raw_response']['TID'] ?? null);
+        $this->assertSame('3001', $meta['pg_raw_response']['ResultCode'] ?? null);
+        $this->assertArrayNotHasKey('CardNum', $meta['pg_raw_response']);
+        $this->assertArrayNotHasKey('BuyerName', $meta['pg_raw_response']);
+        $this->assertArrayNotHasKey('BuyerEmail', $meta['pg_raw_response']);
+        $this->assertArrayNotHasKey('BuyerTel', $meta['pg_raw_response']);
+        $this->assertArrayNotHasKey('NewSensitiveField', $meta['pg_raw_response']);
+    }
+
+    public function test_vbank_issue_stores_only_whitelisted_pg_response_fields(): void
+    {
+        $order = $this->createTestOrder(30000, PaymentMethodEnum::VBANK);
+        $this->mockPluginSettings();
+
+        $tid = 'VBANK_ISSUE_SANITIZED';
+        $params = $this->makeCallbackParams($order->order_number, 30000, [
+            'PayMethod' => 'VBANK',
+        ]);
+
+        Http::fake([
+            'pay.nicepay.co.kr/v1/authorize' => Http::response(array_merge(
+                $this->makeAuthorizeResponse($tid, $order->order_number, 30000, '4100'),
+                [
+                    'PayMethod' => 'VBANK',
+                    'VbankBankCode' => '004',
+                    'VbankBankName' => '국민은행',
+                    'VbankNum' => '1234567890',
+                    'VbankExpDate' => '20260521',
+                    'VbankExpTime' => '235959',
+                    'VbankInputName' => '홍길동',
+                    'BuyerName' => '구매자',
+                    'BuyerEmail' => 'buyer@example.test',
+                    'BuyerTel' => '01012345678',
+                    'NewSensitiveField' => 'store-me-not',
+                ]
+            ), 200),
+        ]);
+
+        $response = $this->post('/plugins/sirsoft-pay_nicepayments/payment/callback', $params);
+
+        $response->assertRedirect("/shop/orders/{$order->order_number}/complete");
+
+        $payment = $order->payment;
+        $payment->refresh();
+
+        $meta = $payment->payment_meta;
+        $this->assertTrue($meta['pg_response_sanitized'] ?? false);
+        $this->assertSame($tid, $meta['pg_raw_response']['TID'] ?? null);
+        $this->assertSame('국민은행', $meta['pg_raw_response']['VbankBankName'] ?? null);
+        $this->assertArrayNotHasKey('VbankNum', $meta['pg_raw_response']);
+        $this->assertArrayNotHasKey('VbankInputName', $meta['pg_raw_response']);
+        $this->assertArrayNotHasKey('CardNum', $meta['pg_raw_response']);
+        $this->assertArrayNotHasKey('BuyerName', $meta['pg_raw_response']);
+        $this->assertArrayNotHasKey('BuyerEmail', $meta['pg_raw_response']);
+        $this->assertArrayNotHasKey('BuyerTel', $meta['pg_raw_response']);
+        $this->assertArrayNotHasKey('NewSensitiveField', $meta['pg_raw_response']);
+    }
+
+    /**
+     * 인증 단계(AuthResultCode != '0000') 실패는 사용자가 아직 결제를 끝내지 않은 상태로
+     * 어떤 코드/메시지가 오든 generic 에러 toast 없이 체크아웃으로 깨끗하게 복귀해야 한다.
+     *
+     * 모바일에서 사용자가 취소버튼을 누르거나, PG 가 인증을 거부하거나, 타임아웃이 발생하더라도
+     * 이 시점엔 결제 승인 (NextAppURL 호출) 이 일어나기 전이므로 사용자 입장에서는 "다시 시도"
+     * 외에 할 수 있는 것이 없다. "결제 처리 중 오류" 같은 강한 메시지는 부적절.
+     */
+    public function test_auth_callback_softens_pre_authorize_failures_to_silent_redirect(): void
+    {
+        $this->mockPluginSettings();
+
+        $cases = [
+            ['code' => '9999', 'msg' => '사용자 취소'],                  // 표준 사용자 취소
+            ['code' => '2001', 'msg' => '사용자 취소'],                  // 한국어 사용자 메시지
+            ['code' => '0021', 'msg' => '결제창을 종료하셨습니다'],       // 결제창 종료 (취소 키워드 없음)
+            ['code' => '8001', 'msg' => 'User cancelled'],               // 영문 cancel
+            ['code' => 'F004', 'msg' => '지불 거절'],                    // 사용자/취소 키워드 없는 PG 거절
+            ['code' => '5500', 'msg' => '인증 시간 초과'],                // 타임아웃
+            ['code' => '0033', 'msg' => ''],                              // 메시지 없는 실패
+        ];
+
+        foreach ($cases as $case) {
+            $params = $this->makeCallbackParams('ORD-TEST-99999', 50000, [
+                'AuthResultCode' => $case['code'],
+                'AuthResultMsg' => $case['msg'],
+            ]);
+
+            $response = $this->post('/plugins/sirsoft-pay_nicepayments/payment/callback', $params);
+
+            $response->assertRedirect();
+            $location = $response->headers->get('Location');
+
+            $this->assertStringNotContainsString(
+                'error=',
+                $location,
+                "AuthResultCode={$case['code']} ({$case['msg']}) 은 인증단계 실패이므로 error query 없이 체크아웃으로 복귀해야 한다. 실제 redirect: {$location}",
+            );
+            $this->assertStringContainsString('/shop/checkout', $location);
+        }
+    }
+
+    public function test_auth_callback_keeps_pre_authorize_failure_retryable_when_amount_matches_order(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $option = OrderOptionFactory::new()->forOrder($order)->create([
+            'option_status' => OrderStatusEnum::PENDING_ORDER,
+        ]);
+        $this->mockPluginSettings();
+
+        $response = $this->post('/plugins/sirsoft-pay_nicepayments/payment/callback', [
+            'AuthResultCode' => '0021',
+            'AuthResultMsg' => '결제창을 종료하셨습니다',
+            'Moid' => $order->order_number,
+            'Amt' => 50000,
+        ]);
+
+        $response->assertRedirect('/shop/checkout');
+        $this->assertStringNotContainsString('error=', $response->headers->get('Location'));
+
+        $order->refresh();
+        $payment = $order->payment->fresh();
+
+        $this->assertEquals(OrderStatusEnum::PENDING_ORDER, $order->order_status);
+        $this->assertArrayNotHasKey('payment_failure_code', $order->order_meta ?? []);
+        $this->assertEquals(PaymentStatusEnum::READY, $payment->payment_status);
+        $this->assertArrayNotHasKey('failure_code', $payment->payment_meta ?? []);
+        $this->assertNull($payment->cancelled_at);
+        $this->assertEquals(OrderStatusEnum::PENDING_ORDER, $option->refresh()->option_status);
+    }
+
+    public function test_auth_callback_redirects_to_fail_on_mid_mismatch(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $this->mockPluginSettings();
+
+        $params = $this->makeCallbackParams($order->order_number, 50000, [
+            'MID' => 'WRONG_MID',
+        ]);
+
+        $response = $this->post('/plugins/sirsoft-pay_nicepayments/payment/callback', $params);
+
+        $response->assertRedirect();
+        $this->assertStringContainsString('error=mid_mismatch', $response->headers->get('Location'));
+    }
+
+    public function test_auth_callback_redirects_to_fail_on_signature_mismatch(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $this->mockPluginSettings();
+
+        $params = $this->makeCallbackParams($order->order_number, 50000, [
+            'Signature' => 'INVALID_SIGNATURE',
+        ]);
+
+        $response = $this->post('/plugins/sirsoft-pay_nicepayments/payment/callback', $params);
+
+        $response->assertRedirect();
+        $this->assertStringContainsString('error=signature_mismatch', $response->headers->get('Location'));
+    }
+
+    public function test_auth_callback_redirects_to_fail_on_order_not_found(): void
+    {
+        $this->mockPluginSettings();
+
+        $params = $this->makeCallbackParams('NON_EXISTENT_ORDER', 50000);
+
+        Http::fake([
+            'pay.nicepay.co.kr/v1/authorize' => Http::response(
+                $this->makeAuthorizeResponse('TID_NONE', 'NON_EXISTENT_ORDER', 50000),
+                200
+            ),
+        ]);
+
+        $response = $this->post('/plugins/sirsoft-pay_nicepayments/payment/callback', $params);
+
+        $response->assertRedirect();
+        $this->assertStringContainsString('error=order_not_found', $response->headers->get('Location'));
+    }
+
+    public function test_auth_callback_redirects_to_fail_and_sends_net_cancel_on_authorize_failure(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $this->mockPluginSettings();
+
+        $params = $this->makeCallbackParams($order->order_number, 50000);
+
+        Http::fake([
+            'pay.nicepay.co.kr/v1/authorize' => Http::response([
+                'ResultCode' => '9999',
+                'ResultMsg' => '승인 실패',
+            ], 200),
+            'pay.nicepay.co.kr/v1/netcancel' => Http::response('OK', 200),
+        ]);
+
+        $response = $this->post('/plugins/sirsoft-pay_nicepayments/payment/callback', $params);
+
+        $response->assertRedirect();
+        $this->assertStringContainsString('error=authorize_failed', $response->headers->get('Location'));
+
+        $order->refresh();
+        $this->assertEquals(OrderStatusEnum::CANCELLED, $order->order_status);
+        $this->assertEquals(PaymentStatusEnum::FAILED, $order->payment->payment_status);
+        $this->assertEquals('9999', $order->payment->payment_meta['failure_code'] ?? null);
+    }
+
+    public function test_auth_callback_records_authorize_exception_as_failed_payment(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $this->mockPluginSettings();
+
+        $params = $this->makeCallbackParams($order->order_number, 50000);
+
+        Http::fake([
+            'pay.nicepay.co.kr/v1/authorize' => Http::response([], 500),
+            'pay.nicepay.co.kr/v1/netcancel' => Http::response('OK', 200),
+        ]);
+
+        $response = $this->post('/plugins/sirsoft-pay_nicepayments/payment/callback', $params);
+
+        $response->assertRedirect();
+        $this->assertStringContainsString('error=authorize_failed', $response->headers->get('Location'));
+
+        $order->refresh();
+        $payment = $order->payment->fresh();
+
+        $this->assertEquals(OrderStatusEnum::CANCELLED, $order->order_status);
+        $this->assertEquals('AUTHORIZE_EXCEPTION', $order->order_meta['payment_failure_code'] ?? null);
+        $this->assertEquals(PaymentStatusEnum::FAILED, $payment->payment_status);
+        $this->assertEquals('AUTHORIZE_EXCEPTION', $payment->payment_meta['failure_code'] ?? null);
+    }
+
+    public function test_auth_callback_records_invalid_payment_currency_as_failed_payment(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $order->update([
+            'currency' => 'USD',
+            'currency_snapshot' => self::unchargeableUsdCurrencySnapshot(),
+        ]);
+        $this->mockPluginSettings();
+
+        $params = $this->makeCallbackParams($order->order_number, 50000);
+
+        Http::fake([
+            'pay.nicepay.co.kr/v1/authorize' => Http::response(
+                $this->makeAuthorizeResponse('TID_INVALID_CURRENCY', $order->order_number, 50000),
+                200
+            ),
+            'pay.nicepay.co.kr/v1/netcancel' => Http::response('OK', 200),
+        ]);
+
+        $response = $this->post('/plugins/sirsoft-pay_nicepayments/payment/callback', $params);
+
+        $response->assertRedirect();
+        $this->assertStringContainsString('error=invalid_payment_currency', $response->headers->get('Location'));
+
+        $order->refresh();
+        $payment = $order->payment->fresh();
+
+        $this->assertEquals(OrderStatusEnum::CANCELLED, $order->order_status);
+        $this->assertEquals('INVALID_PAYMENT_CURRENCY', $order->order_meta['payment_failure_code'] ?? null);
+        $this->assertEquals(PaymentStatusEnum::FAILED, $payment->payment_status);
+        $this->assertEquals('INVALID_PAYMENT_CURRENCY', $payment->payment_meta['failure_code'] ?? null);
+
+        Http::assertSent(fn ($request) => str_contains($request->url(), '/v1/netcancel'));
+    }
+
+    public function test_auth_callback_redirects_to_fail_url_on_missing_params(): void
+    {
+        $this->mockPluginSettings();
+
+        $response = $this->post('/plugins/sirsoft-pay_nicepayments/payment/callback', [
+            'AuthResultCode' => '0000',
+        ]);
+
+        $response->assertRedirect();
+        $this->assertStringContainsString('error=invalid_params', $response->headers->get('Location'));
+    }
+
+    public function test_auth_callback_redirects_to_custom_success_url(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $this->mockPluginSettings(['redirect_success_url' => '/custom/payment/{orderId}/done']);
+
+        $tid = 'TID_CUSTOM';
+        $params = $this->makeCallbackParams($order->order_number, 50000);
+
+        Http::fake([
+            'pay.nicepay.co.kr/v1/authorize' => Http::response(
+                $this->makeAuthorizeResponse($tid, $order->order_number, 50000),
+                200
+            ),
+        ]);
+
+        $response = $this->post('/plugins/sirsoft-pay_nicepayments/payment/callback', $params);
+
+        $response->assertRedirect("/custom/payment/{$order->order_number}/done");
+    }
+
+    public function test_auth_callback_detects_mobile_device(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $this->mockPluginSettings();
+
+        $params = $this->makeCallbackParams($order->order_number, 50000);
+
+        Http::fake([
+            'pay.nicepay.co.kr/v1/authorize' => Http::response(
+                $this->makeAuthorizeResponse('TID_MOBILE', $order->order_number, 50000),
+                200
+            ),
+        ]);
+
+        $response = $this->post(
+            '/plugins/sirsoft-pay_nicepayments/payment/callback',
+            $params,
+            ['User-Agent' => 'Mozilla/5.0 (iPhone; CPU iPhone OS 16_0 like Mac OS X)']
+        );
+
+        $response->assertRedirect("/shop/orders/{$order->order_number}/complete");
+
+        $payment = $order->payment;
+        $payment->refresh();
+        $this->assertEquals('mobile', $payment->payment_device);
+    }
+
+    public function test_auth_callback_ignores_non_payable_order_without_authorize_request(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $order->update(['order_status' => OrderStatusEnum::CANCELLED]);
+        $order->payment()->update(['payment_status' => PaymentStatusEnum::FAILED]);
+        $this->mockPluginSettings();
+
+        $params = $this->makeCallbackParams($order->order_number, 50000);
+
+        Http::fake([
+            '*' => Http::response(
+                $this->makeAuthorizeResponse('TID_SHOULD_NOT_BE_SENT', $order->order_number, 50000),
+                200
+            ),
+        ]);
+
+        $response = $this->post('/plugins/sirsoft-pay_nicepayments/payment/callback', $params);
+
+        $response->assertRedirect();
+        $this->assertStringContainsString('error=order_not_payable', $response->headers->get('Location'));
+
+        $order->refresh();
+        $this->assertEquals(OrderStatusEnum::CANCELLED, $order->order_status);
+        $this->assertEquals(PaymentStatusEnum::FAILED, $order->payment->payment_status);
+        $this->assertNull($order->payment->transaction_id);
+        Http::assertNothingSent();
+    }
+
+    // ===== 가상계좌 입금 통보 테스트 =====
+
+    public function test_vbank_notify_returns_ok_on_successful_deposit(): void
+    {
+        $tid = 'VBANK_TID_001';
+        $order = $this->createTestOrder(30000, PaymentMethodEnum::VBANK);
+        $this->markVbankIssued($order, $tid, 30000);
+
+        $response = $this->post(
+            '/plugins/sirsoft-pay_nicepayments/payment/vbank-notify',
+            $this->makeVbankNotifyPayload($order->order_number, 30000, ['TID' => $tid])
+        );
+
+        $response->assertOk();
+        $this->assertEquals('OK', $response->getContent());
+
+        $order->refresh();
+        $this->assertEquals(OrderStatusEnum::PAYMENT_COMPLETE, $order->order_status);
+    }
+
+    public function test_vbank_notify_stores_only_whitelisted_pg_response_fields(): void
+    {
+        $tid = 'VBANK_TID_SANITIZED';
+        $order = $this->createTestOrder(30000, PaymentMethodEnum::VBANK);
+        $this->markVbankIssued($order, $tid, 30000);
+
+        $response = $this->post(
+            '/plugins/sirsoft-pay_nicepayments/payment/vbank-notify',
+            $this->makeVbankNotifyPayload($order->order_number, 30000, [
+                'TID' => $tid,
+                'name' => '구매자명',
+                'BuyerEmail' => 'buyer@example.test',
+                'MallUserID' => 'member-001',
+                'Signature' => 'signature-value',
+            ])
+        );
+
+        $response->assertOk();
+        $this->assertEquals('OK', $response->getContent());
+
+        $payment = $order->payment;
+        $payment->refresh();
+
+        $meta = $payment->payment_meta;
+        $this->assertTrue($meta['pg_response_sanitized'] ?? false);
+        $this->assertSame('VBANK_TID_SANITIZED', $meta['pg_raw_response']['TID'] ?? null);
+        $this->assertSame('4110', $meta['pg_raw_response']['ResultCode'] ?? null);
+        $this->assertArrayNotHasKey('VbankNum', $meta['pg_raw_response']);
+        $this->assertArrayNotHasKey('VbankInputName', $meta['pg_raw_response']);
+        $this->assertArrayNotHasKey('name', $meta['pg_raw_response']);
+        $this->assertArrayNotHasKey('BuyerEmail', $meta['pg_raw_response']);
+        $this->assertArrayNotHasKey('MallUserID', $meta['pg_raw_response']);
+        $this->assertArrayNotHasKey('Signature', $meta['pg_raw_response']);
+        $this->assertTrue($meta['vbank_notifications'][0]['raw_sanitized'] ?? false);
+        $this->assertArrayNotHasKey('VbankNum', $meta['vbank_notifications'][0]['raw']);
+        $this->assertArrayNotHasKey('VbankInputName', $meta['vbank_notifications'][0]['raw']);
+    }
+
+    public function test_vbank_notify_returns_ok_on_cancelled_deposit(): void
+    {
+        $response = $this->post(
+            '/plugins/sirsoft-pay_nicepayments/payment/vbank-notify',
+            $this->makeVbankNotifyPayload('ORD-TEST-CANCEL', 30000, [
+                'TID' => 'VBANK_TID_002',
+                'ResultCode' => '4100',
+                'ResultMsg' => '계좌발급',
+            ])
+        );
+
+        $response->assertOk();
+        $this->assertEquals('OK', $response->getContent());
+    }
+
+    public function test_vbank_notify_returns_fail_on_order_not_found(): void
+    {
+        $response = $this->post(
+            '/plugins/sirsoft-pay_nicepayments/payment/vbank-notify',
+            $this->makeVbankNotifyPayload('NON_EXISTENT_ORDER', 30000, ['TID' => 'VBANK_TID_003'])
+        );
+
+        $response->assertOk();
+        $this->assertEquals('FAIL', $response->getContent());
+    }
+
+    public function test_vbank_notify_is_idempotent_for_same_tid(): void
+    {
+        $tid = 'VBANK_TID_DUPLICATE';
+        $order = $this->createTestOrder(30000, PaymentMethodEnum::VBANK);
+        $order->update([
+            'order_status' => OrderStatusEnum::PAYMENT_COMPLETE,
+            'total_paid_amount' => 30000,
+            'total_due_amount' => 0,
+        ]);
+        $order->payment()->update([
+            'payment_status' => PaymentStatusEnum::PAID,
+            'paid_amount_local' => 30000,
+            'paid_at' => now(),
+            'transaction_id' => $tid,
+            'vbank_number' => '1234567890',
+            'payment_meta' => [
+                'mid' => self::TEST_MID,
+                'vbank_tid' => $tid,
+                'vbank_num' => '1234567890',
+                'is_test_mode' => true,
+            ],
+        ]);
+
+        $response = $this->post(
+            '/plugins/sirsoft-pay_nicepayments/payment/vbank-notify',
+            $this->makeVbankNotifyPayload($order->order_number, 30000, ['TID' => $tid])
+        );
+
+        $response->assertOk();
+        $this->assertEquals('OK', $response->getContent());
+
+        $order->refresh();
+        $this->assertEquals(OrderStatusEnum::PAYMENT_COMPLETE, $order->order_status);
+    }
+
+    public function test_vbank_notify_rejects_mismatched_context_without_completing_order(): void
+    {
+        $tid = 'VBANK_TID_SECURE';
+        $order = $this->createTestOrder(30000, PaymentMethodEnum::VBANK);
+        $this->markVbankIssued($order, $tid, 30000);
+
+        $response = $this->post(
+            '/plugins/sirsoft-pay_nicepayments/payment/vbank-notify',
+            $this->makeVbankNotifyPayload($order->order_number, 30000, [
+                'TID' => 'VBANK_TID_FORGED',
+                'MID' => self::TEST_MID,
+                'VbankNum' => '1234567890',
+            ])
+        );
+
+        $response->assertOk();
+        $this->assertEquals('FAIL', $response->getContent());
+
+        $order->refresh();
+        $this->assertEquals(OrderStatusEnum::PENDING_ORDER, $order->order_status);
+        $this->assertNull($order->payment->transaction_id);
+    }
+
+    public function test_vbank_notify_rejects_amount_mismatch_without_completing_order(): void
+    {
+        $tid = 'VBANK_TID_AMOUNT';
+        $order = $this->createTestOrder(30000, PaymentMethodEnum::VBANK);
+        $this->markVbankIssued($order, $tid, 30000);
+
+        $response = $this->post(
+            '/plugins/sirsoft-pay_nicepayments/payment/vbank-notify',
+            $this->makeVbankNotifyPayload($order->order_number, 29999, ['TID' => $tid])
+        );
+
+        $response->assertOk();
+        $this->assertEquals('FAIL', $response->getContent());
+
+        $order->refresh();
+        $this->assertEquals(OrderStatusEnum::PENDING_ORDER, $order->order_status);
+    }
+
+    public function test_vbank_notify_success_log_does_not_include_depositor_or_full_account(): void
+    {
+        Log::spy();
+
+        $tid = 'VBANK_TID_LOG_SAFE';
+        $order = $this->createTestOrder(30000, PaymentMethodEnum::VBANK);
+        $this->markVbankIssued($order, $tid, 30000);
+
+        $response = $this->post(
+            '/plugins/sirsoft-pay_nicepayments/payment/vbank-notify',
+            $this->makeVbankNotifyPayload($order->order_number, 30000, ['TID' => $tid])
+        );
+
+        $response->assertOk();
+
+        Log::shouldHaveReceived('info')
+            ->with('NicePayments: vbank deposit confirmed', Mockery::on(function (array $context): bool {
+                return ! array_key_exists('depositor', $context)
+                    && ! array_key_exists('vbank_number', $context)
+                    && ! array_key_exists('vbank_num', $context);
+            }));
+    }
+
+    public function test_auth_callback_rolls_back_and_net_cancels_when_payment_complete_hook_throws_inside_locked_callback(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $this->mockPluginSettings();
+
+        $tid = 'TID_POST_COMMIT';
+        $params = $this->makeCallbackParams($order->order_number, 50000);
+
+        Http::fake([
+            'pay.nicepay.co.kr/v1/authorize' => Http::response(
+                $this->makeAuthorizeResponse($tid, $order->order_number, 50000),
+                200
+            ),
+            'pay.nicepay.co.kr/v1/netcancel' => Http::response('OK', 200),
+        ]);
+
+        HookManager::addAction('sirsoft-ecommerce.order.after_payment_complete', function (): void {
+            throw new \RuntimeException('post commit listener failed');
+        }, 999);
+
+        try {
+            $response = $this->post('/plugins/sirsoft-pay_nicepayments/payment/callback', $params);
+        } finally {
+            HookManager::clearAction('sirsoft-ecommerce.order.after_payment_complete');
+        }
+
+        $response->assertRedirect("/shop/checkout?error=authorize_failed&orderId={$order->order_number}");
+
+        $order->refresh();
+        $this->assertEquals(OrderStatusEnum::CANCELLED, $order->order_status);
+        $this->assertEquals(PaymentStatusEnum::FAILED, $order->payment->payment_status);
+
+        Http::assertSent(fn ($request) => str_contains($request->url(), 'netcancel'));
+    }
+
+    public function test_auth_callback_does_not_complete_again_when_order_is_paid_with_another_tid_after_authorize(): void
+    {
+        $order = $this->createTestOrder(50000);
+        $this->mockPluginSettings();
+
+        $tid = 'TID_CURRENT_AUTH';
+        $params = $this->makeCallbackParams($order->order_number, 50000);
+        $afterCompleteCalls = 0;
+
+        Http::fake([
+            'pay.nicepay.co.kr/v1/authorize' => Http::response(
+                $this->makeAuthorizeResponse($tid, $order->order_number, 50000),
+                200
+            ),
+            'pay.nicepay.co.kr/v1/netcancel' => Http::response('OK', 200),
+        ]);
+
+        HookManager::addAction('sirsoft-pay_nicepayments.payment.after_authorize', function () use ($order): void {
+            $order->update([
+                'order_status' => OrderStatusEnum::PAYMENT_COMPLETE,
+                'total_due_amount' => 0,
+                'total_paid_amount' => 50000,
+                'paid_at' => now(),
+            ]);
+            $order->payment()->update([
+                'payment_status' => PaymentStatusEnum::PAID,
+                'paid_amount_local' => 50000,
+                'paid_at' => now(),
+                'transaction_id' => 'TID_ALREADY_PAID',
+            ]);
+        }, 999);
+        HookManager::addAction('sirsoft-ecommerce.order.after_payment_complete', function () use (&$afterCompleteCalls): void {
+            $afterCompleteCalls++;
+        }, 999);
+
+        try {
+            $response = $this->post('/plugins/sirsoft-pay_nicepayments/payment/callback', $params);
+        } finally {
+            HookManager::clearAction('sirsoft-pay_nicepayments.payment.after_authorize');
+            HookManager::clearAction('sirsoft-ecommerce.order.after_payment_complete');
+        }
+
+        $response->assertRedirect("/shop/orders/{$order->order_number}/complete");
+        $this->assertSame(0, $afterCompleteCalls);
+
+        $order->refresh();
+        $this->assertEquals(OrderStatusEnum::PAYMENT_COMPLETE, $order->order_status);
+        $this->assertEquals('TID_ALREADY_PAID', $order->payment->transaction_id);
+
+        Http::assertSent(fn ($request) => str_contains($request->url(), 'netcancel'));
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/tests/Feature/Controllers/PaymentCloseReportControllerTest.php b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Feature/Controllers/PaymentCloseReportControllerTest.php
new file mode 100644
index 00000000..579a1029
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Feature/Controllers/PaymentCloseReportControllerTest.php
@@ -0,0 +1,354 @@
+<?php
+
+namespace Plugins\Sirsoft\PayNicepayments\Tests\Feature\Controllers;
+
+use Mockery;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderFactory;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderPaymentFactory;
+use Modules\Sirsoft\Ecommerce\Enums\OrderStatusEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentMethodEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentStatusEnum;
+use Modules\Sirsoft\Ecommerce\Models\Order;
+use Modules\Sirsoft\Ecommerce\Models\OrderAddress;
+use Modules\Sirsoft\Ecommerce\Services\OrderProcessingService;
+use Plugins\Sirsoft\PayNicepayments\Tests\PluginTestCase;
+
+class PaymentCloseReportControllerTest extends PluginTestCase
+{
+    public function test_close_report_marks_pending_order_failed_and_payment_cancelled(): void
+    {
+        $order = OrderFactory::new()->create([
+            'order_number' => 'ORD-NICE-CLOSE-001',
+            'order_status' => OrderStatusEnum::PENDING_ORDER,
+            'currency' => 'KRW',
+            'currency_snapshot' => self::krwCurrencySnapshot(),
+            'subtotal_amount' => 10000,
+            'total_amount' => 10000,
+            'total_due_amount' => 10000,
+            'total_paid_amount' => 0,
+        ]);
+        OrderPaymentFactory::new()->create([
+            'order_id' => $order->id,
+            'payment_status' => PaymentStatusEnum::READY,
+            'payment_method' => PaymentMethodEnum::CARD,
+            'pg_provider' => 'nicepayments',
+            'paid_amount_local' => 0,
+        ]);
+
+        $response = $this->postJson('/api/plugins/sirsoft-pay_nicepayments/payment/close-report', [
+            'oid' => 'ORD-NICE-CLOSE-001',
+            'price' => 10000,
+            'payment_method' => 'card',
+            'reason' => 'nicepay-window-closed',
+        ]);
+
+        $response->assertOk()
+            ->assertJsonPath('data.status', 'recorded');
+
+        $order->refresh();
+        $this->assertEquals(OrderStatusEnum::CANCELLED, $order->order_status);
+        $this->assertEquals(PaymentStatusEnum::FAILED, $order->payment->payment_status);
+    }
+
+    public function test_close_report_marks_real_payment_failed(): void
+    {
+        $order = OrderFactory::new()->create([
+            'order_number' => 'ORD-NICE-CLOSE-REAL',
+            'order_status' => OrderStatusEnum::PENDING_ORDER,
+            'currency' => 'KRW',
+            'currency_snapshot' => self::krwCurrencySnapshot(),
+            'subtotal_amount' => 10000,
+            'total_amount' => 10000,
+            'total_due_amount' => 10000,
+            'total_paid_amount' => 0,
+        ]);
+        OrderPaymentFactory::new()->create([
+            'order_id' => $order->id,
+            'payment_status' => PaymentStatusEnum::READY,
+            'payment_method' => PaymentMethodEnum::CARD,
+            'pg_provider' => 'nicepayments',
+            'paid_amount_local' => 0,
+        ]);
+
+        $response = $this->postJson('/api/plugins/sirsoft-pay_nicepayments/payment/close-report', [
+            'oid' => 'ORD-NICE-CLOSE-REAL',
+            'price' => 10000,
+            'payment_method' => 'card',
+            'reason' => 'nicepay-window-closed',
+        ]);
+
+        $response->assertOk()
+            ->assertJsonPath('data.status', 'recorded');
+
+        $order->refresh();
+        $payment = $order->payment;
+        $payment->refresh();
+
+        $this->assertEquals(OrderStatusEnum::CANCELLED, $order->order_status);
+        $this->assertEquals(PaymentStatusEnum::FAILED, $payment->payment_status);
+        $this->assertEquals('USER_CANCEL', $order->order_meta['payment_failure_code'] ?? null);
+        $this->assertNull($payment->cancelled_at);
+    }
+
+    public function test_close_report_rejects_amount_mismatch(): void
+    {
+        $order = $this->makeOrder('ORD-NICE-CLOSE-002', 10000);
+
+        $orderService = Mockery::mock(OrderProcessingService::class);
+        $orderService->shouldReceive('findByOrderNumber')
+            ->once()
+            ->with('ORD-NICE-CLOSE-002')
+            ->andReturn($order);
+        $orderService->shouldNotReceive('failPayment');
+        $orderService->shouldNotReceive('recordPaymentCancellation');
+
+        $this->app->instance(OrderProcessingService::class, $orderService);
+
+        $response = $this->postJson('/api/plugins/sirsoft-pay_nicepayments/payment/close-report', [
+            'oid' => 'ORD-NICE-CLOSE-002',
+            'price' => 9000,
+        ]);
+
+        $response->assertStatus(422)
+            ->assertJsonPath('errors.message.0', 'Payment amount does not match the order amount.');
+    }
+
+    public function test_close_report_rejects_unchargeable_payment_currency_without_marking_failed(): void
+    {
+        $order = $this->makeOrder('ORD-NICE-CLOSE-CURRENCY', 10000);
+        $order->currency = 'USD';
+        $order->currency_snapshot = self::unchargeableUsdCurrencySnapshot();
+
+        $orderService = Mockery::mock(OrderProcessingService::class);
+        $orderService->shouldReceive('findByOrderNumber')
+            ->once()
+            ->with('ORD-NICE-CLOSE-CURRENCY')
+            ->andReturn($order);
+        $orderService->shouldNotReceive('failPayment');
+        $orderService->shouldNotReceive('recordPaymentCancellation');
+
+        $this->app->instance(OrderProcessingService::class, $orderService);
+
+        $response = $this->postJson('/api/plugins/sirsoft-pay_nicepayments/payment/close-report', [
+            'oid' => 'ORD-NICE-CLOSE-CURRENCY',
+            'price' => 10000,
+        ]);
+
+        $response->assertStatus(422)
+            ->assertJsonPath('errors.message.0', 'Payment currency is not chargeable.');
+    }
+
+    public function test_close_report_rejects_buyer_mismatch(): void
+    {
+        $order = $this->makeOrder('ORD-NICE-CLOSE-003', 10000);
+        $order->setRelation('shippingAddress', new OrderAddress([
+            'address_type' => 'shipping',
+            'orderer_email' => 'buyer@example.com',
+            'orderer_phone' => '010-1234-5678',
+        ]));
+
+        $orderService = Mockery::mock(OrderProcessingService::class);
+        $orderService->shouldReceive('findByOrderNumber')
+            ->once()
+            ->with('ORD-NICE-CLOSE-003')
+            ->andReturn($order);
+        $orderService->shouldNotReceive('failPayment');
+        $orderService->shouldNotReceive('recordPaymentCancellation');
+
+        $this->app->instance(OrderProcessingService::class, $orderService);
+
+        $response = $this->postJson('/api/plugins/sirsoft-pay_nicepayments/payment/close-report', [
+            'oid' => 'ORD-NICE-CLOSE-003',
+            'price' => 10000,
+            'buyer_email' => 'attacker@example.com',
+            'buyer_phone' => '01012345678',
+        ]);
+
+        $response->assertStatus(403)
+            ->assertJsonPath('errors.message.0', 'Order buyer verification failed.');
+    }
+
+    public function test_close_report_ignores_order_that_is_no_longer_payable(): void
+    {
+        $order = $this->makeOrder('ORD-NICE-CLOSE-004', 10000);
+        $order->order_status = OrderStatusEnum::PAYMENT_COMPLETE;
+
+        $orderService = Mockery::mock(OrderProcessingService::class);
+        $orderService->shouldReceive('findByOrderNumber')
+            ->once()
+            ->with('ORD-NICE-CLOSE-004')
+            ->andReturn($order);
+        $orderService->shouldNotReceive('failPayment');
+        $orderService->shouldNotReceive('recordPaymentCancellation');
+
+        $this->app->instance(OrderProcessingService::class, $orderService);
+
+        $response = $this->postJson('/api/plugins/sirsoft-pay_nicepayments/payment/close-report', [
+            'oid' => 'ORD-NICE-CLOSE-004',
+            'price' => 10000,
+        ]);
+
+        $response->assertOk()
+            ->assertJsonPath('data.status', 'ignored')
+            ->assertJsonPath('data.reason', 'order_not_payable');
+    }
+
+    public function test_close_report_rechecks_locked_order_before_marking_failed(): void
+    {
+        $order = OrderFactory::new()->create([
+            'order_number' => 'ORD-NICE-CLOSE-RACE',
+            'order_status' => OrderStatusEnum::PENDING_ORDER,
+            'currency' => 'KRW',
+            'currency_snapshot' => self::krwCurrencySnapshot(),
+            'subtotal_amount' => 10000,
+            'total_amount' => 10000,
+            'total_due_amount' => 10000,
+            'total_paid_amount' => 0,
+        ]);
+        OrderPaymentFactory::new()->create([
+            'order_id' => $order->id,
+            'payment_status' => PaymentStatusEnum::READY,
+            'payment_method' => PaymentMethodEnum::CARD,
+            'pg_provider' => 'nicepayments',
+            'paid_amount_local' => 0,
+        ]);
+
+        $staleOrder = $order->fresh(['payment']);
+        $order->update([
+            'order_status' => OrderStatusEnum::PAYMENT_COMPLETE,
+            'total_due_amount' => 0,
+            'total_paid_amount' => 10000,
+            'paid_at' => now(),
+        ]);
+        $order->payment()->update([
+            'payment_status' => PaymentStatusEnum::PAID,
+            'paid_amount_local' => 10000,
+            'paid_at' => now(),
+            'transaction_id' => 'TID_ALREADY_PAID',
+        ]);
+
+        $orderService = Mockery::mock(OrderProcessingService::class);
+        $orderService->shouldReceive('findByOrderNumber')
+            ->once()
+            ->with('ORD-NICE-CLOSE-RACE')
+            ->andReturn($staleOrder);
+        $orderService->shouldNotReceive('failPayment');
+        $this->app->instance(OrderProcessingService::class, $orderService);
+
+        $response = $this->postJson('/api/plugins/sirsoft-pay_nicepayments/payment/close-report', [
+            'oid' => 'ORD-NICE-CLOSE-RACE',
+            'price' => 10000,
+            'payment_method' => 'card',
+            'reason' => 'nicepay-window-closed',
+        ]);
+
+        $response->assertOk()
+            ->assertJsonPath('data.status', 'ignored')
+            ->assertJsonPath('data.reason', 'order_not_payable');
+
+        $order->refresh();
+        $this->assertEquals(OrderStatusEnum::PAYMENT_COMPLETE, $order->order_status);
+        $this->assertEquals(PaymentStatusEnum::PAID, $order->payment->payment_status);
+    }
+
+    public function test_close_report_ignores_order_when_payment_already_paid_but_status_still_pending(): void
+    {
+        // race 재현: 승인 콜백이 payment 를 먼저 PAID 로 갱신했으나 order_status 는 아직 PENDING_ORDER.
+        // 카드 주문은 승인 직전까지 PENDING_ORDER(=isBeforePayment) 라 order_status 가드만으로는
+        // 통과한다. 행 락 획득 후 payment_status=PAID 재확인으로만 차단된다(payment_already_paid).
+        $order = OrderFactory::new()->create([
+            'order_number' => 'ORD-NICE-CLOSE-PAID',
+            'order_status' => OrderStatusEnum::PENDING_ORDER,
+            'currency' => 'KRW',
+            'currency_snapshot' => self::krwCurrencySnapshot(),
+            'subtotal_amount' => 10000,
+            'total_amount' => 10000,
+            'total_due_amount' => 10000,
+            'total_paid_amount' => 0,
+        ]);
+        OrderPaymentFactory::new()->create([
+            'order_id' => $order->id,
+            'payment_status' => PaymentStatusEnum::PAID,
+            'payment_method' => PaymentMethodEnum::CARD,
+            'pg_provider' => 'nicepayments',
+            'paid_amount_local' => 10000,
+            'paid_at' => now(),
+            'transaction_id' => 'TID_PAID_RACE',
+        ]);
+
+        $response = $this->postJson('/api/plugins/sirsoft-pay_nicepayments/payment/close-report', [
+            'oid' => 'ORD-NICE-CLOSE-PAID',
+            'price' => 10000,
+            'payment_method' => 'card',
+            'reason' => 'nicepay-window-closed',
+        ]);
+
+        $response->assertOk()
+            ->assertJsonPath('data.status', 'ignored')
+            ->assertJsonPath('data.reason', 'payment_already_paid');
+
+        // 결제 성공이 닫힘 보고로 덮이지 않아야 한다.
+        $order->refresh();
+        $this->assertEquals(PaymentStatusEnum::PAID, $order->payment->payment_status);
+        $this->assertNotEquals(OrderStatusEnum::CANCELLED, $order->order_status);
+    }
+
+    public function test_close_report_ignores_vbank_order_waiting_for_deposit(): void
+    {
+        $order = OrderFactory::new()->create([
+            'order_number' => 'ORD-NICE-CLOSE-VBANK-WAIT',
+            'order_status' => OrderStatusEnum::PENDING_ORDER,
+            'currency' => 'KRW',
+            'currency_snapshot' => self::krwCurrencySnapshot(),
+            'subtotal_amount' => 10000,
+            'total_amount' => 10000,
+            'total_due_amount' => 10000,
+            'total_paid_amount' => 0,
+        ]);
+        OrderPaymentFactory::new()->create([
+            'order_id' => $order->id,
+            'payment_status' => PaymentStatusEnum::WAITING_DEPOSIT,
+            'payment_method' => PaymentMethodEnum::VBANK,
+            'pg_provider' => 'nicepayments',
+            'paid_amount_local' => 0,
+            'transaction_id' => 'TID_VBANK_WAITING',
+            'vbank_name' => '국민은행',
+            'vbank_number' => '1234567890',
+            'vbank_issued_at' => now(),
+            'payment_meta' => [
+                'vbank_tid' => 'TID_VBANK_WAITING',
+                'vbank_num' => '1234567890',
+                'vbank_name' => '국민은행',
+            ],
+        ]);
+
+        $response = $this->postJson('/api/plugins/sirsoft-pay_nicepayments/payment/close-report', [
+            'oid' => 'ORD-NICE-CLOSE-VBANK-WAIT',
+            'price' => 10000,
+            'payment_method' => 'vbank',
+            'reason' => 'nicepay-window-closed',
+        ]);
+
+        $response->assertOk()
+            ->assertJsonPath('data.status', 'ignored')
+            ->assertJsonPath('data.reason', 'payment_not_ready');
+
+        $order->refresh();
+        $this->assertEquals(OrderStatusEnum::PENDING_ORDER, $order->order_status);
+        $this->assertEquals(PaymentStatusEnum::WAITING_DEPOSIT, $order->payment->payment_status);
+        $this->assertSame('TID_VBANK_WAITING', $order->payment->transaction_id);
+        $this->assertNull($order->order_meta['payment_failure_code'] ?? null);
+    }
+
+    private function makeOrder(string $orderNumber, int $amount): Order
+    {
+        $order = new Order;
+        $order->order_number = $orderNumber;
+        $order->order_status = OrderStatusEnum::PENDING_ORDER;
+        $order->currency = 'KRW';
+        $order->currency_snapshot = self::krwCurrencySnapshot();
+        $order->total_due_amount = $amount;
+
+        return $order;
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/tests/Feature/Controllers/ShippingAndCouponCancellationTest.php b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Feature/Controllers/ShippingAndCouponCancellationTest.php
new file mode 100644
index 00000000..efa508d4
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Feature/Controllers/ShippingAndCouponCancellationTest.php
@@ -0,0 +1,834 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Tests\Feature\Controllers;
+
+use App\Extension\HookListenerRegistrar;
+use App\Extension\HookManager;
+use App\Models\User;
+use Illuminate\Support\Facades\Queue;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderPaymentFactory;
+use Modules\Sirsoft\Ecommerce\Enums\CouponIssueRecordStatus;
+use Modules\Sirsoft\Ecommerce\Enums\OrderStatusEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentMethodEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentStatusEnum;
+use Modules\Sirsoft\Ecommerce\Enums\SequenceType;
+use Modules\Sirsoft\Ecommerce\Models\Coupon;
+use Modules\Sirsoft\Ecommerce\Models\CouponIssue;
+use Modules\Sirsoft\Ecommerce\Models\Order;
+use Modules\Sirsoft\Ecommerce\Models\OrderOption;
+use Modules\Sirsoft\Ecommerce\Models\OrderPayment;
+use Modules\Sirsoft\Ecommerce\Models\OrderRefund;
+use Modules\Sirsoft\Ecommerce\Models\OrderShipping;
+use Modules\Sirsoft\Ecommerce\Models\Sequence;
+use Plugins\Sirsoft\PayNicepayments\Listeners\PaymentRefundListener;
+use Plugins\Sirsoft\PayNicepayments\Services\NicePaymentsApiService;
+use Plugins\Sirsoft\PayNicepayments\Tests\PluginTestCase;
+
+/**
+ * 나이스페이먼츠 결제 플러그인 — 배송비·쿠폰 적용 취소 통합 테스트
+ *
+ * ShippingAndPromotionCancellationTest.php 가 mockPgRefundSuccess() 로 훅을 가짜로 대체한 것과 달리,
+ * 이 테스트는 실제 PaymentRefundListener 를 등록하고 NicePaymentsApiService 만 mock 으로 교체한다.
+ * 경로 전체를 검증한다:
+ *   admin cancel request → OrderCancellationService → PaymentRefundListener → NicePaymentsApiService
+ *
+ * Mock 규칙:
+ *   - 호출 횟수/인자 검증이 필요한 테스트: $mock->expects($this->once())->method(...)->willReturn(...)
+ *   - 성공만 필요한 테스트: $this->stubNicePayCancelSuccess()
+ *   - 호출되면 안 되는 테스트: $mock->expects($this->never())->method(...)
+ *   ※ 같은 메서드에 method()와 expects()를 동시에 걸면 PHPUnit이 이중 호출로 인식하므로 혼용 금지.
+ */
+class ShippingAndCouponCancellationTest extends PluginTestCase
+{
+    private const TID = 'TID_NICEPAY_TEST_001';
+
+    private const CANCEL_SUCCESS = [
+        'ResultCode' => '2001',
+        'ResultMsg'  => '취소 성공',
+        'TID'        => 'TID_CANCEL_NICEPAY',
+    ];
+
+    protected User $adminUser;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        // HookArgumentSerializer PHP 8.1 enum 직렬화 버그 우회
+        Queue::fake();
+
+        $this->adminUser = $this->createAdminUser(['sirsoft-ecommerce.orders.update']);
+        $this->createCancelSequences();
+
+        // 테스트 DB 시더가 plugin 레코드를 등록하지 않아
+        // PluginManager::registerPluginHookListeners() 의 active 가드에서 skip 되므로
+        // 테스트에서 직접 listener 를 등록한다. HookListenerRegistrar 가 idempotent 이라
+        // 운영 환경에서 listener 가 이미 등록되어 있으면 중복 호출되지 않음.
+        HookListenerRegistrar::register(PaymentRefundListener::class, 'sirsoft-pay_nicepayments');
+    }
+
+    protected function tearDown(): void
+    {
+        HookManager::resetAll();
+        // HookListenerRegistrar 의 static $registered 캐시도 비워야
+        // 다음 테스트의 setUp 에서 register() 가 실제 등록을 수행한다.
+        HookListenerRegistrar::clear();
+        parent::tearDown();
+    }
+
+    // ────────────────────────────────────────────
+    // Mock 헬퍼
+    // ────────────────────────────────────────────
+
+    /**
+     * cancelPayment 를 성공 stub 으로만 설정합니다 (호출 횟수 검증 없음).
+     * 호출 횟수·인자를 검증해야 하는 테스트에서는 이 메서드 대신 인라인 mock 을 사용하세요.
+     */
+    private function stubNicePayCancelSuccess(): void
+    {
+        $mock = $this->createMock(NicePaymentsApiService::class);
+        $mock->method('cancelPayment')->willReturn(self::CANCEL_SUCCESS);
+        $this->app->instance(NicePaymentsApiService::class, $mock);
+    }
+
+    /**
+     * cancelPayment 가 정확히 1회 호출되는 mock 을 생성합니다.
+     * 반환된 mock 에 with() 제약을 추가할 수 있습니다.
+     */
+    private function expectNicePayCancelOnce(): \PHPUnit\Framework\MockObject\MockObject
+    {
+        $mock = $this->createMock(NicePaymentsApiService::class);
+        $mock->expects($this->once())
+            ->method('cancelPayment')
+            ->willReturn(self::CANCEL_SUCCESS);
+        $this->app->instance(NicePaymentsApiService::class, $mock);
+
+        return $mock;
+    }
+
+    /**
+     * cancelPayment 가 호출되지 않아야 하는 mock 을 생성합니다.
+     */
+    private function expectNicePayCancelNever(): void
+    {
+        $mock = $this->createMock(NicePaymentsApiService::class);
+        $mock->expects($this->never())->method('cancelPayment');
+        $this->app->instance(NicePaymentsApiService::class, $mock);
+    }
+
+    /**
+     * cancelPayment 에서 예외를 던지는 mock 을 생성합니다.
+     */
+    private function stubNicePayCancelFailure(string $errorMsg = 'NicePayments 취소 실패'): void
+    {
+        $mock = $this->createMock(NicePaymentsApiService::class);
+        $mock->method('cancelPayment')->willThrowException(new \Exception($errorMsg));
+        $this->app->instance(NicePaymentsApiService::class, $mock);
+    }
+
+    /**
+     * 쿠폰 복원 훅을 등록합니다.
+     */
+    private function mockCouponRestore(): void
+    {
+        HookManager::addAction(
+            'sirsoft-ecommerce.coupon.restore',
+            function (Order $order, array $couponIssueIds) {
+                CouponIssue::whereIn('id', $couponIssueIds)->update([
+                    'status'   => CouponIssueRecordStatus::AVAILABLE->value,
+                    'used_at'  => null,
+                    'order_id' => null,
+                ]);
+            },
+            10
+        );
+    }
+
+    // ────────────────────────────────────────────
+    // 주문 생성 헬퍼
+    // ────────────────────────────────────────────
+
+    private function createCancelSequences(): void
+    {
+        foreach ([SequenceType::CANCEL, SequenceType::REFUND] as $type) {
+            $cfg = $type->getDefaultConfig();
+            Sequence::firstOrCreate(
+                ['type' => $type->value],
+                [
+                    'algorithm'     => $cfg['algorithm']->value,
+                    'prefix'        => $cfg['prefix'],
+                    'current_value' => 0,
+                    'increment'     => 1,
+                    'min_value'     => 1,
+                    'max_value'     => $cfg['max_value'],
+                    'cycle'         => false,
+                    'pad_length'    => $cfg['pad_length'],
+                ]
+            );
+        }
+    }
+
+    /**
+     * 나이스페이먼츠 결제가 완료된 배송비 포함 주문을 생성합니다.
+     *
+     * @return array{order: Order, options: OrderOption[], payment: OrderPayment, shipping: OrderShipping}
+     */
+    private function createNicepayOrderWithShipping(
+        int $optionCount = 1,
+        int $unitPrice = 20000,
+        int $shippingFee = 3000,
+        string $tid = self::TID,
+    ): array {
+        $user     = User::factory()->create();
+        $subtotal = $unitPrice * $optionCount;
+        $total    = $subtotal + $shippingFee;
+
+        $order = Order::factory()->create([
+            'user_id'                          => $user->id,
+            'order_status'                     => OrderStatusEnum::PAYMENT_COMPLETE,
+            'subtotal_amount'                  => $subtotal,
+            'total_shipping_amount'            => $shippingFee,
+            'total_amount'                     => $total,
+            'total_paid_amount'                => $total,
+            'total_due_amount'                 => 0,
+            'total_cancelled_amount'           => 0,
+            'cancellation_count'               => 0,
+            'paid_at'                          => now(),
+            'promotions_applied_snapshot'      => [],
+            'shipping_policy_applied_snapshot' => [],
+        ]);
+
+        $options = [];
+        for ($i = 0; $i < $optionCount; $i++) {
+            $options[] = OrderOption::factory()->forOrder($order)->create([
+                'quantity'                 => 1,
+                'unit_price'               => $unitPrice,
+                'subtotal_price'           => $unitPrice,
+                'subtotal_paid_amount'     => $unitPrice,
+                'subtotal_discount_amount' => 0,
+                'option_status'            => OrderStatusEnum::PAYMENT_COMPLETE,
+                'product_snapshot'         => [
+                    'id' => null, 'name' => ['ko' => '테스트상품', 'en' => 'Test Product'],
+                    'product_code' => null, 'sku' => null, 'brand_id' => null,
+                    'list_price' => $unitPrice, 'selling_price' => $unitPrice,
+                    'currency_code' => 'KRW', 'stock_quantity' => 100,
+                    'tax_status' => 'taxable', 'tax_rate' => 10,
+                    'has_options' => false, 'option_groups' => null, 'thumbnail_url' => null,
+                ],
+                'option_snapshot'          => [
+                    'id' => null, 'option_code' => null, 'option_values' => null,
+                    'option_name' => '기본', 'price_adjustment' => 0,
+                    'list_price' => $unitPrice, 'selling_price' => $unitPrice,
+                    'currency_code' => 'KRW', 'stock_quantity' => 100,
+                    'weight' => 0.5, 'volume' => 0.01, 'sku' => null, 'is_default' => true,
+                ],
+            ]);
+        }
+
+        $payment = OrderPaymentFactory::new()->forOrder($order)->create([
+            'payment_status'    => PaymentStatusEnum::PAID,
+            'payment_method'    => PaymentMethodEnum::CARD,
+            'pg_provider'       => 'nicepayments',
+            'paid_amount_local' => $total,
+            'paid_amount_base'  => $total,
+            'cancelled_amount'  => 0,
+            'paid_at'           => now(),
+            'transaction_id'    => $tid,
+        ]);
+
+        $shipping = OrderShipping::factory()->forOrder($order)->create([
+            'order_option_id'       => $options[0]->id,
+            'base_shipping_amount'  => $shippingFee,
+            'total_shipping_amount' => $shippingFee,
+        ]);
+
+        return compact('order', 'options', 'payment', 'shipping');
+    }
+
+    /**
+     * 나이스페이먼츠 결제가 완료된 쿠폰 할인 주문을 생성합니다.
+     *
+     * @return array{order: Order, options: OrderOption[], payment: OrderPayment, couponIssue: CouponIssue}
+     */
+    private function createNicepayOrderWithCoupon(
+        int $optionCount = 1,
+        int $unitPrice = 30000,
+        int $couponDiscount = 3000,
+        int $minOrderAmount = 0,
+        string $tid = self::TID,
+    ): array {
+        $user     = User::factory()->create();
+        $subtotal = $unitPrice * $optionCount;
+        $paid     = $subtotal - $couponDiscount;
+
+        $order = Order::factory()->create([
+            'user_id'                            => $user->id,
+            'order_status'                       => OrderStatusEnum::PAYMENT_COMPLETE,
+            'subtotal_amount'                    => $subtotal,
+            'total_shipping_amount'              => 0,
+            'total_amount'                       => $subtotal,
+            'total_coupon_discount_amount'       => $couponDiscount,
+            'total_order_coupon_discount_amount' => $couponDiscount,
+            'total_paid_amount'                  => $paid,
+            'total_due_amount'                   => 0,
+            'total_cancelled_amount'             => 0,
+            'cancellation_count'                 => 0,
+            'paid_at'                            => now(),
+            'shipping_policy_applied_snapshot'   => [],
+        ]);
+
+        // 쿠폰 할인을 옵션별로 균등 분배 (단가보다 할인이 큰 경우에도 음수 방지)
+        $options = [];
+        $perBase = (int) round($couponDiscount / $optionCount);
+        for ($i = 0; $i < $optionCount; $i++) {
+            $perDisc   = $i < ($optionCount - 1)
+                ? $perBase
+                : $couponDiscount - $perBase * ($optionCount - 1);
+            $options[] = OrderOption::factory()->forOrder($order)->create([
+                'quantity'                 => 1,
+                'unit_price'               => $unitPrice,
+                'subtotal_price'           => $unitPrice,
+                'subtotal_paid_amount'     => $unitPrice - $perDisc,
+                'subtotal_discount_amount' => $perDisc,
+                'option_status'            => OrderStatusEnum::PAYMENT_COMPLETE,
+                'product_snapshot'         => [
+                    'id' => null, 'name' => ['ko' => '테스트상품', 'en' => 'Test Product'],
+                    'product_code' => null, 'sku' => null, 'brand_id' => null,
+                    'list_price' => $unitPrice, 'selling_price' => $unitPrice,
+                    'currency_code' => 'KRW', 'stock_quantity' => 100,
+                    'tax_status' => 'taxable', 'tax_rate' => 10,
+                    'has_options' => false, 'option_groups' => null, 'thumbnail_url' => null,
+                ],
+                'option_snapshot'          => [
+                    'id' => null, 'option_code' => null, 'option_values' => null,
+                    'option_name' => '기본', 'price_adjustment' => 0,
+                    'list_price' => $unitPrice, 'selling_price' => $unitPrice,
+                    'currency_code' => 'KRW', 'stock_quantity' => 100,
+                    'weight' => 0.5, 'volume' => 0.01, 'sku' => null, 'is_default' => true,
+                ],
+            ]);
+        }
+
+        $payment = OrderPaymentFactory::new()->forOrder($order)->create([
+            'payment_status'    => PaymentStatusEnum::PAID,
+            'payment_method'    => PaymentMethodEnum::CARD,
+            'pg_provider'       => 'nicepayments',
+            'paid_amount_local' => $paid,
+            'paid_amount_base'  => $paid,
+            'cancelled_amount'  => 0,
+            'paid_at'           => now(),
+            'transaction_id'    => $tid,
+        ]);
+
+        $coupon = Coupon::create([
+            'name'            => '검수용 테스트 쿠폰',
+            'target_type'     => 'order_amount',
+            'discount_type'   => 'fixed',
+            'discount_value'  => $couponDiscount,
+            'issue_method'    => 'direct',
+            'issue_condition' => 'manual',
+            'issue_status'    => 'issuing',
+            'total_quantity'  => 100,
+            'issued_count'    => 1,
+            'per_user_limit'  => 1,
+            'valid_type'      => 'period',
+            'is_combinable'   => false,
+        ]);
+
+        $couponIssue = CouponIssue::create([
+            'coupon_id'       => $coupon->id,
+            'user_id'         => $order->user_id,
+            'coupon_code'     => 'TEST-' . strtoupper(uniqid()),
+            'status'          => CouponIssueRecordStatus::USED->value,
+            'issued_at'       => now(),
+            'used_at'         => now(),
+            'order_id'        => $order->id,
+            'discount_amount' => $couponDiscount,
+        ]);
+
+        $order->update([
+            'promotions_applied_snapshot' => [
+                'coupon_issue_ids' => [$couponIssue->id],
+                'order_promotions' => [
+                    'coupons' => [[
+                        'coupon_issue_id'  => $couponIssue->id,
+                        'discount_type'    => 'fixed',
+                        'discount_value'   => $couponDiscount,
+                        'min_order_amount' => $minOrderAmount,
+                        'applied_amount'   => $couponDiscount,
+                    ]],
+                ],
+            ],
+        ]);
+
+        return compact('order', 'options', 'payment', 'couponIssue');
+    }
+
+    // ====================================================
+    // 1. 배송정책 + 전체취소
+    // ====================================================
+
+    /**
+     * 배송비 있는 주문 전체취소 시 NicePayments cancelPayment 가 정확히 1회 호출되고
+     * 배송비가 환불 레코드에 포함되어야 한다.
+     */
+    public function test_full_cancel_with_shipping_calls_nicepayments_once_and_refunds_shipping(): void
+    {
+        // Given: 20,000원 상품 + 3,000원 배송비 = 23,000원 결제
+        $this->expectNicePayCancelOnce(); // 정확히 1회만 호출되어야 함
+
+        $data  = $this->createNicepayOrderWithShipping(optionCount: 1, unitPrice: 20000, shippingFee: 3000);
+        $order = $data['order'];
+
+        // When: 전체취소 (PG 연동 on)
+        $response = $this->actingAs($this->adminUser)
+            ->postJson("/api/modules/sirsoft-ecommerce/admin/orders/{$order->order_number}/cancel", [
+                'type'      => 'full',
+                'reason'    => 'changed_mind',
+                'cancel_pg' => true,
+            ]);
+
+        // Then: 성공 + 배송비 환불 포함
+        $response->assertOk()->assertJsonPath('success', true);
+
+        $order->refresh();
+        $this->assertEquals(OrderStatusEnum::CANCELLED, $order->order_status);
+
+        $refund = OrderRefund::where('order_id', $order->id)->first();
+        $this->assertNotNull($refund);
+        $this->assertEquals(3000, (float) $refund->refund_shipping_amount, '배송비 3,000원이 환불되어야 합니다');
+        $this->assertEquals(23000, (float) $refund->refund_amount, '상품(20,000) + 배송비(3,000) = 23,000원 환불');
+    }
+
+    /**
+     * 전체취소 시 NicePayments cancelPayment 에 isPartial=0 (전액취소) 이 전달되어야 한다.
+     */
+    public function test_full_cancel_passes_partial_code_zero_to_nicepayments(): void
+    {
+        $mock = $this->createMock(NicePaymentsApiService::class);
+        $mock->expects($this->once())
+            ->method('cancelPayment')
+            ->with(
+                self::TID,          // tid
+                $this->anything(),  // moid
+                23000,              // cancelAmt
+                $this->anything(),  // cancelMsg
+                0,                  // isPartial = 0 (전액취소)
+                null, null, null,
+            )
+            ->willReturn(self::CANCEL_SUCCESS);
+        $this->app->instance(NicePaymentsApiService::class, $mock);
+
+        $data  = $this->createNicepayOrderWithShipping(optionCount: 1, unitPrice: 20000, shippingFee: 3000);
+        $order = $data['order'];
+
+        $this->actingAs($this->adminUser)
+            ->postJson("/api/modules/sirsoft-ecommerce/admin/orders/{$order->order_number}/cancel", [
+                'type'      => 'full',
+                'reason'    => 'changed_mind',
+                'cancel_pg' => true,
+            ])->assertOk()->assertJsonPath('success', true);
+    }
+
+    /**
+     * 무료배송 주문 전체취소 시 환불 레코드에 배송비가 0원이어야 한다.
+     */
+    public function test_full_cancel_free_shipping_refunds_only_product_amount(): void
+    {
+        $this->stubNicePayCancelSuccess();
+
+        $data  = $this->createNicepayOrderWithShipping(optionCount: 1, unitPrice: 30000, shippingFee: 0);
+        $order = $data['order'];
+
+        $response = $this->actingAs($this->adminUser)
+            ->postJson("/api/modules/sirsoft-ecommerce/admin/orders/{$order->order_number}/cancel", [
+                'type'      => 'full',
+                'reason'    => 'changed_mind',
+                'cancel_pg' => true,
+            ]);
+
+        $response->assertOk()->assertJsonPath('success', true);
+
+        $refund = OrderRefund::where('order_id', $order->id)->first();
+        $this->assertNotNull($refund);
+        $this->assertEquals(0, (float) $refund->refund_shipping_amount);
+        $this->assertEquals(30000, (float) $refund->refund_amount);
+    }
+
+    // ====================================================
+    // 2. 배송정책 + 부분취소
+    // ====================================================
+
+    /**
+     * 배송비 있는 주문 부분취소 시 NicePayments cancelPayment 에 isPartial=1 이 전달되어야 한다.
+     */
+    public function test_partial_cancel_with_shipping_calls_nicepayments_with_partial_flag(): void
+    {
+        // Given: 20,000원 × 2개 + 배송비 3,000원 = 43,000원
+        $mock = $this->createMock(NicePaymentsApiService::class);
+        $mock->expects($this->once())
+            ->method('cancelPayment')
+            ->with(
+                self::TID,
+                $this->anything(),
+                23000,
+                $this->anything(),
+                1,          // isPartial = 1 (부분취소)
+                null, null, null,
+            )
+            ->willReturn(self::CANCEL_SUCCESS);
+        $this->app->instance(NicePaymentsApiService::class, $mock);
+
+        $data    = $this->createNicepayOrderWithShipping(optionCount: 2, unitPrice: 20000, shippingFee: 3000);
+        $order   = $data['order'];
+        $options = $data['options'];
+
+        $response = $this->actingAs($this->adminUser)
+            ->postJson("/api/modules/sirsoft-ecommerce/admin/orders/{$order->order_number}/cancel", [
+                'type'      => 'partial',
+                'items'     => [['order_option_id' => $options[0]->id, 'cancel_quantity' => 1]],
+                'reason'    => 'changed_mind',
+                'cancel_pg' => true,
+            ]);
+
+        $response->assertOk()->assertJsonPath('success', true);
+
+        $order->refresh();
+        // 부분취소는 주문 상태(결제완료)를 유지하고 취소된 옵션만 CANCELLED 로 전이된다(PARTIAL_CANCELLED 폐기).
+        $this->assertEquals(OrderStatusEnum::PAYMENT_COMPLETE, $order->order_status);
+        $this->assertEquals(OrderStatusEnum::CANCELLED, $options[0]->refresh()->option_status);
+
+        $refund = OrderRefund::where('order_id', $order->id)->first();
+        $this->assertNotNull($refund, '부분취소 후 환불 레코드가 생성되어야 합니다');
+        $this->assertEquals(3000, (float) $refund->refund_shipping_amount, '부분취소 시 배송비 차액 3,000원이 포함되어야 합니다');
+        $this->assertEquals(23000, (float) $refund->refund_amount, '상품(20,000) + 배송비 차액(3,000) = 23,000원 환불');
+    }
+
+    /**
+     * 이미 부분취소된 거래의 남은 잔액을 취소할 때도 NicePayments 에는 부분취소 코드가 전달되어야 한다.
+     */
+    public function test_remaining_cancel_after_prior_partial_cancel_keeps_partial_flag(): void
+    {
+        $calls = [];
+        $mock = $this->createMock(NicePaymentsApiService::class);
+        $mock->expects($this->exactly(2))
+            ->method('cancelPayment')
+            ->willReturnCallback(function (
+                string $tid,
+                string $moid,
+                int $cancelAmt,
+                string $cancelMsg,
+                int $partialCancelCode,
+            ) use (&$calls) {
+                $calls[] = compact('tid', 'moid', 'cancelAmt', 'cancelMsg', 'partialCancelCode');
+
+                return self::CANCEL_SUCCESS;
+            });
+        $this->app->instance(NicePaymentsApiService::class, $mock);
+
+        $data = $this->createNicepayOrderWithShipping(optionCount: 2, unitPrice: 1000, shippingFee: 0);
+        $order = $data['order'];
+        $options = $data['options'];
+
+        $this->actingAs($this->adminUser)
+            ->postJson("/api/modules/sirsoft-ecommerce/admin/orders/{$order->order_number}/cancel", [
+                'type'      => 'partial',
+                'items'     => [['order_option_id' => $options[0]->id, 'cancel_quantity' => 1]],
+                'reason'    => 'changed_mind',
+                'cancel_pg' => true,
+            ])->assertOk()->assertJsonPath('success', true);
+
+        $this->actingAs($this->adminUser)
+            ->postJson("/api/modules/sirsoft-ecommerce/admin/orders/{$order->order_number}/cancel", [
+                'type'      => 'partial',
+                'items'     => [['order_option_id' => $options[1]->id, 'cancel_quantity' => 1]],
+                'reason'    => 'changed_mind',
+                'cancel_pg' => true,
+            ])->assertOk()->assertJsonPath('success', true);
+
+        $this->assertSame(1, $calls[0]['partialCancelCode']);
+        $this->assertSame(1, $calls[1]['partialCancelCode']);
+    }
+
+    /**
+     * cancel_pg=false 이면 NicePayments API 를 호출하지 않아야 한다.
+     */
+    public function test_partial_cancel_without_pg_never_calls_nicepayments_api(): void
+    {
+        $this->expectNicePayCancelNever(); // cancel_pg=false 이므로 API 미호출
+
+        $data    = $this->createNicepayOrderWithShipping(optionCount: 2, unitPrice: 20000, shippingFee: 3000);
+        $order   = $data['order'];
+        $options = $data['options'];
+        $originalPaid = (float) $order->total_paid_amount;
+
+        $response = $this->actingAs($this->adminUser)
+            ->postJson("/api/modules/sirsoft-ecommerce/admin/orders/{$order->order_number}/cancel", [
+                'type'      => 'partial',
+                'items'     => [['order_option_id' => $options[0]->id, 'cancel_quantity' => 1]],
+                'reason'    => 'changed_mind',
+                'cancel_pg' => false,
+            ]);
+
+        $response->assertOk()->assertJsonPath('success', true);
+
+        $refund = OrderRefund::where('order_id', $order->id)->first();
+        $this->assertNotNull($refund);
+        $this->assertGreaterThan(0, (float) $refund->refund_amount);
+        $this->assertLessThanOrEqual($originalPaid, (float) $refund->refund_amount);
+    }
+
+    // ====================================================
+    // 3. 쿠폰 적용 + 전체취소
+    // ====================================================
+
+    /**
+     * 쿠폰 적용 주문 전체취소 시 실결제금액(할인 후)이 환불되고 쿠폰이 복원되어야 한다.
+     */
+    public function test_full_cancel_with_coupon_refunds_paid_amount_and_restores_coupon(): void
+    {
+        // Given: 30,000원 - 쿠폰 3,000원 = 27,000원 실결제 (나이스페이먼츠)
+        $this->stubNicePayCancelSuccess();
+        $this->mockCouponRestore();
+
+        $data        = $this->createNicepayOrderWithCoupon(optionCount: 1, unitPrice: 30000, couponDiscount: 3000);
+        $order       = $data['order'];
+        $couponIssue = $data['couponIssue'];
+
+        $response = $this->actingAs($this->adminUser)
+            ->postJson("/api/modules/sirsoft-ecommerce/admin/orders/{$order->order_number}/cancel", [
+                'type'      => 'full',
+                'reason'    => 'changed_mind',
+                'cancel_pg' => true,
+            ]);
+
+        $response->assertOk()->assertJsonPath('success', true);
+
+        // 실결제금액(27,000원) 환불 검증
+        $refund = OrderRefund::where('order_id', $order->id)->first();
+        $this->assertNotNull($refund);
+        $this->assertEquals(27000, (float) $refund->refund_amount, '쿠폰 할인 후 실결제금액(27,000원)이 환불되어야 합니다');
+
+        // 쿠폰 복원 검증
+        $couponIssue->refresh();
+        $this->assertEquals(CouponIssueRecordStatus::AVAILABLE, $couponIssue->status, '쿠폰이 AVAILABLE 로 복원되어야 합니다');
+        $this->assertNull($couponIssue->order_id, '복원된 쿠폰의 order_id 가 null 이어야 합니다');
+    }
+
+    /**
+     * 쿠폰 적용 주문 전체취소 시 NicePayments cancelPayment 에 실결제금액이 전달되어야 한다.
+     */
+    public function test_full_cancel_with_coupon_calls_nicepayments_with_paid_amount(): void
+    {
+        // 쿠폰 할인 후 실결제금액(27,000원)이 PG 취소 금액으로 전달되어야 함
+        $mock = $this->createMock(NicePaymentsApiService::class);
+        $mock->expects($this->once())
+            ->method('cancelPayment')
+            ->with(self::TID, $this->anything(), 27000, $this->anything(), 0, null, null, null)
+            ->willReturn(self::CANCEL_SUCCESS);
+        $this->app->instance(NicePaymentsApiService::class, $mock);
+
+        $this->mockCouponRestore();
+
+        $data  = $this->createNicepayOrderWithCoupon(optionCount: 1, unitPrice: 30000, couponDiscount: 3000);
+        $order = $data['order'];
+
+        $this->actingAs($this->adminUser)
+            ->postJson("/api/modules/sirsoft-ecommerce/admin/orders/{$order->order_number}/cancel", [
+                'type'      => 'full',
+                'reason'    => 'changed_mind',
+                'cancel_pg' => true,
+            ])->assertOk()->assertJsonPath('success', true);
+    }
+
+    // ====================================================
+    // 4. 쿠폰 적용 + 부분취소
+    // ====================================================
+
+    /**
+     * 부분취소 후 잔여금액이 쿠폰 최소 조건을 충족하는 경우 성공해야 한다.
+     */
+    public function test_partial_cancel_with_coupon_succeeds_when_min_amount_still_met(): void
+    {
+        // 30,000원 × 2개, 쿠폰 3,000원 (최소 20,000원) → 부분취소 후 잔여 30,000원 > 최소
+        $this->stubNicePayCancelSuccess();
+        $this->mockCouponRestore();
+
+        $data    = $this->createNicepayOrderWithCoupon(
+            optionCount: 2, unitPrice: 30000, couponDiscount: 3000, minOrderAmount: 20000
+        );
+        $order   = $data['order'];
+        $options = $data['options'];
+
+        $response = $this->actingAs($this->adminUser)
+            ->postJson("/api/modules/sirsoft-ecommerce/admin/orders/{$order->order_number}/cancel", [
+                'type'      => 'partial',
+                'items'     => [['order_option_id' => $options[0]->id, 'cancel_quantity' => 1]],
+                'reason'    => 'changed_mind',
+                'cancel_pg' => true,
+            ]);
+
+        $response->assertOk()->assertJsonPath('success', true);
+        $order->refresh();
+        // 부분취소는 주문 상태(결제완료)를 유지하고 취소된 옵션만 CANCELLED 로 전이된다(PARTIAL_CANCELLED 폐기).
+        $this->assertEquals(OrderStatusEnum::PAYMENT_COMPLETE, $order->order_status);
+        $this->assertEquals(OrderStatusEnum::CANCELLED, $options[0]->refresh()->option_status);
+    }
+
+    /**
+     * 쿠폰 최소 주문금액 조건 미달 부분취소 시 422 를 반환하고 NicePayments API 를 호출하지 않아야 한다.
+     *
+     * 20,000원 × 2개, 쿠폰 22,000원 할인 (최소 30,000원) → 결제 18,000원
+     * 옵션 1개 취소 후 잔여 20,000 < 최소 30,000 → 쿠폰 소멸
+     * 재계산: 20,000 > 원 결제 18,000 → 422 (추가 결제 필요, 취소 거부)
+     */
+    public function test_partial_cancel_rejected_when_coupon_condition_no_longer_met(): void
+    {
+        $this->expectNicePayCancelNever(); // 취소 거부되므로 PG API 미호출
+
+        $data    = $this->createNicepayOrderWithCoupon(
+            optionCount: 2, unitPrice: 20000, couponDiscount: 22000, minOrderAmount: 30000
+        );
+        $order   = $data['order'];
+        $options = $data['options'];
+
+        $response = $this->actingAs($this->adminUser)
+            ->postJson("/api/modules/sirsoft-ecommerce/admin/orders/{$order->order_number}/cancel", [
+                'type'      => 'partial',
+                'items'     => [['order_option_id' => $options[0]->id, 'cancel_quantity' => 1]],
+                'reason'    => 'changed_mind',
+                'cancel_pg' => true,
+            ]);
+
+        $response->assertStatus(422)->assertJsonPath('success', false);
+    }
+
+    // ====================================================
+    // 5. 가상계좌 결제 + 취소
+    // ====================================================
+
+    /**
+     * 입금 완료된 가상계좌 주문 취소 시 VBANK_REQUIRES_BANK_INFO 오류로 취소 실패해야 한다.
+     *
+     * vbank_number 가 있고 payment_status = PAID 이면 PaymentRefundListener 가
+     * VBANK_REQUIRES_BANK_INFO 를 반환 → OrderCancellationService 가 취소를 거부.
+     * 환불 계좌 정보는 AdminVbankRefundController 를 통해 별도 처리한다.
+     */
+    public function test_full_cancel_deposited_vbank_fails_with_pg_refund_error(): void
+    {
+        $this->expectNicePayCancelNever(); // vbank 는 일반 API 로 처리 불가 → 미호출
+
+        $data    = $this->createNicepayOrderWithShipping(optionCount: 1, unitPrice: 20000, shippingFee: 0);
+        $order   = $data['order'];
+        $payment = $data['payment'];
+
+        // 가상계좌 입금 완료 상태로 업데이트
+        $payment->update([
+            'vbank_number'   => '1234567890',
+            'vbank_name'     => '국민은행',
+            'payment_status' => PaymentStatusEnum::PAID,
+        ]);
+
+        $response = $this->actingAs($this->adminUser)
+            ->postJson("/api/modules/sirsoft-ecommerce/admin/orders/{$order->order_number}/cancel", [
+                'type'      => 'full',
+                'reason'    => 'changed_mind',
+                'cancel_pg' => true,
+            ]);
+
+        // 가상계좌 입금 완료 건은 환불 계좌 없이 PG 환불 불가 → 취소 실패
+        $response->assertStatus(422)->assertJsonPath('success', false);
+
+        // 주문 상태가 CANCELLED 로 변경되지 않아야 함 (롤백)
+        $order->refresh();
+        $this->assertNotEquals(OrderStatusEnum::CANCELLED, $order->order_status);
+    }
+
+    // ====================================================
+    // 6. NicePayments API 오류
+    // ====================================================
+
+    /**
+     * NicePayments cancelPayment API 오류 시 주문 취소가 실패하고 롤백되어야 한다.
+     */
+    public function test_cancel_fails_and_rolls_back_when_nicepayments_api_throws(): void
+    {
+        $this->stubNicePayCancelFailure('NicePayments 취소 실패: 결제가 만료되었습니다');
+
+        $data  = $this->createNicepayOrderWithShipping(optionCount: 1, unitPrice: 20000, shippingFee: 3000);
+        $order = $data['order'];
+
+        $response = $this->actingAs($this->adminUser)
+            ->postJson("/api/modules/sirsoft-ecommerce/admin/orders/{$order->order_number}/cancel", [
+                'type'      => 'full',
+                'reason'    => 'changed_mind',
+                'cancel_pg' => true,
+            ]);
+
+        // PG 취소 실패 → 422
+        $response->assertStatus(422)->assertJsonPath('success', false);
+
+        // 주문이 CANCELLED 로 변경되지 않아야 함 (트랜잭션 롤백)
+        $order->refresh();
+        $this->assertNotEquals(OrderStatusEnum::CANCELLED, $order->order_status, 'PG 환불 실패 시 주문 상태 변경이 롤백되어야 합니다');
+    }
+
+    /**
+     * NicePayments API 오류 시 refund_failed 훅이 발동되어야 한다.
+     */
+    public function test_nicepayments_api_error_fires_refund_failed_hook(): void
+    {
+        $this->stubNicePayCancelFailure('API 호출 실패');
+
+        $data  = $this->createNicepayOrderWithShipping(optionCount: 1, unitPrice: 20000, shippingFee: 3000);
+        $order = $data['order'];
+
+        $hookFired = false;
+        HookManager::addAction('sirsoft-pay_nicepayments.payment.refund_failed', function () use (&$hookFired) {
+            $hookFired = true;
+        }, 20);
+
+        $this->actingAs($this->adminUser)
+            ->postJson("/api/modules/sirsoft-ecommerce/admin/orders/{$order->order_number}/cancel", [
+                'type'      => 'full',
+                'reason'    => 'changed_mind',
+                'cancel_pg' => true,
+            ]);
+
+        $this->assertTrue($hookFired, 'PG 환불 실패 시 refund_failed 훅이 발동되어야 합니다');
+    }
+
+    // ====================================================
+    // 7. non-nicepayments PG 주문에 대한 무간섭 검증
+    // ====================================================
+
+    /**
+     * pg_provider 가 nicepayments 가 아닌 주문에는 PaymentRefundListener 가 개입하지 않아야 한다.
+     */
+    public function test_listener_skips_non_nicepayments_payment(): void
+    {
+        $this->expectNicePayCancelNever(); // 다른 PG 이므로 NicePayments API 미호출
+
+        $data    = $this->createNicepayOrderWithShipping(optionCount: 1, unitPrice: 20000, shippingFee: 3000);
+        $order   = $data['order'];
+        $payment = $data['payment'];
+
+        // pg_provider 를 다른 PG 로 변경
+        $payment->update(['pg_provider' => 'other_pg']);
+
+        // cancel_pg=false 로 PG 없이 취소 (다른 PG 는 환불 핸들러 없음)
+        $response = $this->actingAs($this->adminUser)
+            ->postJson("/api/modules/sirsoft-ecommerce/admin/orders/{$order->order_number}/cancel", [
+                'type'      => 'full',
+                'reason'    => 'changed_mind',
+                'cancel_pg' => false,
+            ]);
+
+        $response->assertOk()->assertJsonPath('success', true);
+
+        $order->refresh();
+        $this->assertEquals(OrderStatusEnum::CANCELLED, $order->order_status);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/tests/Feature/Controllers/UserReceiptControllerTest.php b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Feature/Controllers/UserReceiptControllerTest.php
new file mode 100644
index 00000000..b93485b2
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Feature/Controllers/UserReceiptControllerTest.php
@@ -0,0 +1,145 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Tests\Feature\Controllers;
+
+use App\Models\User;
+use Illuminate\Cookie\Middleware\EncryptCookies;
+use Illuminate\Support\Facades\Hash;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderFactory;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderPaymentFactory;
+use Modules\Sirsoft\Ecommerce\Enums\OrderStatusEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentMethodEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentStatusEnum;
+use Modules\Sirsoft\Ecommerce\Services\GuestOrderAuthService;
+use Plugins\Sirsoft\PayNicepayments\Tests\PluginTestCase;
+
+class UserReceiptControllerTest extends PluginTestCase
+{
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        // 운영에서는 PayNicepaymentsServiceProvider::boot 가 동일하게 등록한다.
+        EncryptCookies::except(['nicepayments_receipt_token']);
+    }
+
+    public function test_guest_receipt_requires_valid_token(): void
+    {
+        $order = $this->createGuestOrder();
+        $this->createNicepaymentsPayment($order, 'NICE_TID_GUEST_001');
+
+        $this->getJson("/api/plugins/sirsoft-pay_nicepayments/user/orders/{$order->order_number}/receipt")
+            ->assertNotFound();
+
+        $this->withHeader('X-Guest-Order-Token', (time() + 1800).'|'.str_repeat('0', 64))
+            ->getJson("/api/plugins/sirsoft-pay_nicepayments/user/orders/{$order->order_number}/receipt")
+            ->assertNotFound();
+    }
+
+    public function test_guest_receipt_returns_receipt_url_with_valid_header_token(): void
+    {
+        app()->setLocale('ko');
+
+        $order = $this->createGuestOrder();
+        $this->createNicepaymentsPayment($order, 'NICE_TID_GUEST_002');
+
+        $response = $this->withHeader('X-Guest-Order-Token', $this->issueGuestToken($order))
+            ->getJson("/api/plugins/sirsoft-pay_nicepayments/user/orders/{$order->order_number}/receipt")
+            ->assertOk()
+            ->assertJsonPath('receipt_url', 'https://npg.nicepay.co.kr/issue/IssueLoader.do?type=0&TID=NICE_TID_GUEST_002');
+
+        $this->assertContains($response->json('payment_method_label'), ['신용카드', 'Credit Card']);
+    }
+
+    public function test_guest_receipt_returns_receipt_url_with_valid_cookie(): void
+    {
+        $order = $this->createGuestOrder();
+        $this->createNicepaymentsPayment($order, 'NICE_TID_GUEST_003');
+
+        $this->withUnencryptedCookie('nicepayments_receipt_token', $this->issueReceiptCookie($order->order_number))
+            ->withCredentials()
+            ->getJson("/api/plugins/sirsoft-pay_nicepayments/user/orders/{$order->order_number}/receipt")
+            ->assertOk()
+            ->assertJsonPath('receipt_url', 'https://npg.nicepay.co.kr/issue/IssueLoader.do?type=0&TID=NICE_TID_GUEST_003');
+    }
+
+    public function test_guest_token_for_other_order_cannot_access_receipt(): void
+    {
+        $order1 = $this->createGuestOrder();
+        $order2 = $this->createGuestOrder();
+        $this->createNicepaymentsPayment($order1, 'NICE_TID_GUEST_004');
+        $this->createNicepaymentsPayment($order2, 'NICE_TID_GUEST_005');
+
+        $this->withHeader('X-Guest-Order-Token', $this->issueGuestToken($order1))
+            ->getJson("/api/plugins/sirsoft-pay_nicepayments/user/orders/{$order2->order_number}/receipt")
+            ->assertNotFound();
+    }
+
+    public function test_authenticated_user_cannot_access_guest_order_receipt_via_token(): void
+    {
+        $user = User::factory()->create();
+        $order = $this->createGuestOrder();
+        $this->createNicepaymentsPayment($order, 'NICE_TID_GUEST_006');
+
+        $this->actingAs($user)
+            ->withHeader('X-Guest-Order-Token', $this->issueGuestToken($order))
+            ->getJson("/api/plugins/sirsoft-pay_nicepayments/user/orders/{$order->order_number}/receipt")
+            ->assertNotFound();
+    }
+
+    private function createGuestOrder()
+    {
+        return OrderFactory::new()->create([
+            'user_id' => null,
+            'guest_lookup_password_hash' => Hash::make('test1234'),
+            'order_number' => 'ORD-NICE-GUEST-' . random_int(10000, 99999),
+            'order_status' => OrderStatusEnum::PAYMENT_COMPLETE,
+            'total_amount' => 1000,
+            'total_due_amount' => 0,
+            'total_paid_amount' => 1000,
+            'paid_at' => now(),
+        ]);
+    }
+
+    private function createNicepaymentsPayment($order, string $transactionId): void
+    {
+        OrderPaymentFactory::new()->create([
+            'order_id' => $order->id,
+            'payment_status' => PaymentStatusEnum::PAID,
+            'payment_method' => PaymentMethodEnum::CARD,
+            'pg_provider' => 'nicepayments',
+            'transaction_id' => $transactionId,
+            'receipt_url' => null,
+            'paid_amount_local' => 1000,
+            'paid_at' => now(),
+            'payment_meta' => ['is_test_mode' => true],
+        ]);
+    }
+
+    private function issueGuestToken($order): string
+    {
+        $svc = app(GuestOrderAuthService::class);
+        $rc = new \ReflectionClass($svc);
+        $signMethod = $rc->getMethod('sign');
+        $signMethod->setAccessible(true);
+        $suffixMethod = $rc->getMethod('passwordHashSuffix');
+        $suffixMethod->setAccessible(true);
+
+        $expiresTs = time() + 1800;
+        $suffix = $suffixMethod->invoke($svc, $order);
+        $sig = $signMethod->invoke($svc, $order->order_number, (int) $order->id, $expiresTs, $suffix);
+
+        return $expiresTs.'|'.$sig;
+    }
+
+    private function issueReceiptCookie(string $orderNumber): string
+    {
+        $expiresTs = time() + 300;
+        $payload = $orderNumber.'|'.$expiresTs;
+        $signature = hash_hmac('sha256', $payload, (string) config('app.key', ''));
+
+        return $payload.'|'.$signature;
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/tests/PluginTestCase.php b/plugins/_bundled/sirsoft-pay_nicepayments/tests/PluginTestCase.php
new file mode 100644
index 00000000..abdd26df
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/tests/PluginTestCase.php
@@ -0,0 +1,224 @@
+<?php
+
+namespace Plugins\Sirsoft\PayNicepayments\Tests;
+
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Tests\TestCase;
+
+abstract class PluginTestCase extends TestCase
+{
+    use RefreshDatabase;
+
+    protected function shouldSeed(): bool
+    {
+        return true;
+    }
+
+    protected function seeder(): string
+    {
+        return \Modules\Sirsoft\Ecommerce\Database\Seeders\TestingSeeder::class;
+    }
+
+    protected function migrateFreshUsing(): array
+    {
+        return [
+            '--drop-views' => $this->shouldDropViews(),
+            '--drop-types' => $this->shouldDropTypes(),
+            '--seed' => $this->shouldSeed(),
+            '--seeder' => $this->seeder(),
+            '--path' => [
+                'database/migrations',
+                'modules/sirsoft-ecommerce/database/migrations',
+            ],
+        ];
+    }
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        $this->registerModuleAutoload();
+        $this->registerPluginAutoload();
+
+        $this->app->register(\Modules\Sirsoft\Ecommerce\Providers\EcommerceServiceProvider::class);
+
+        $this->registerModuleRoutes();
+        $this->registerPluginRoutes();
+
+        // SettingsServiceProvider 가 storage/app/settings/general.json 의 site_url 로
+        // app.url 을 override 하면 Laravel 의 assertRedirect (APP_URL 기반) 와 mismatch.
+        // 테스트 환경에서는 APP_URL 그대로 사용하도록 명시 리셋.
+        \Illuminate\Support\Facades\Config::set('app.url', env('APP_URL', 'http://localhost'));
+    }
+
+    protected static function krwCurrencySnapshot(): array
+    {
+        return [
+            'base_currency' => 'KRW',
+            'order_currency' => 'KRW',
+            'base_unit' => 1,
+            'exchange_rates' => [
+                'KRW' => [
+                    'rate' => 1,
+                    'rounding_unit' => '1',
+                    'rounding_method' => 'round',
+                    'decimal_places' => 0,
+                    'base_unit' => 1,
+                ],
+            ],
+        ];
+    }
+
+    protected static function unchargeableUsdCurrencySnapshot(): array
+    {
+        return [
+            'base_currency' => 'KRW',
+            'order_currency' => 'USD',
+            'base_unit' => 1,
+            'exchange_rates' => [
+                'KRW' => [
+                    'rate' => 1,
+                    'rounding_unit' => '1',
+                    'rounding_method' => 'round',
+                    'decimal_places' => 0,
+                    'base_unit' => 1,
+                ],
+                'USD' => [
+                    'rate' => 0,
+                    'rounding_unit' => '0.01',
+                    'rounding_method' => 'round',
+                    'decimal_places' => 2,
+                    'base_unit' => 1,
+                ],
+            ],
+        ];
+    }
+
+    protected function registerModuleAutoload(): void
+    {
+        $moduleBasePath = base_path('modules/sirsoft-ecommerce/src/');
+
+        spl_autoload_register(function ($class) use ($moduleBasePath) {
+            $prefix = 'Modules\\Sirsoft\\Ecommerce\\';
+            $len = strlen($prefix);
+
+            if (strncmp($prefix, $class, $len) !== 0) {
+                return;
+            }
+
+            $relativeClass = substr($class, $len);
+            $file = $moduleBasePath . str_replace('\\', '/', $relativeClass) . '.php';
+
+            if (file_exists($file)) {
+                require $file;
+            }
+        });
+
+        $helpersFile = $moduleBasePath . 'Helpers/helpers.php';
+        if (file_exists($helpersFile)) {
+            require_once $helpersFile;
+        }
+    }
+
+    protected function registerPluginAutoload(): void
+    {
+        $pluginBasePath = base_path('plugins/sirsoft-pay_nicepayments/src/');
+
+        spl_autoload_register(function ($class) use ($pluginBasePath) {
+            $prefix = 'Plugins\\Sirsoft\\Nicepayments\\';
+            $len = strlen($prefix);
+
+            if (strncmp($prefix, $class, $len) !== 0) {
+                return;
+            }
+
+            $relativeClass = substr($class, $len);
+            $file = $pluginBasePath . str_replace('\\', '/', $relativeClass) . '.php';
+
+            if (file_exists($file)) {
+                require $file;
+            }
+        });
+    }
+
+    protected function registerModuleRoutes(): void
+    {
+        $apiRoutesFile = base_path('modules/sirsoft-ecommerce/src/routes/api.php');
+
+        if (file_exists($apiRoutesFile)) {
+            \Illuminate\Support\Facades\Route::prefix('api/modules/sirsoft-ecommerce')
+                ->name('api.modules.sirsoft-ecommerce.')
+                ->middleware('api')
+                ->group($apiRoutesFile);
+        }
+    }
+
+    protected function registerPluginRoutes(): void
+    {
+        $webRoutesFile = base_path('plugins/sirsoft-pay_nicepayments/src/routes/web.php');
+
+        if (file_exists($webRoutesFile)) {
+            \Illuminate\Support\Facades\Route::prefix('plugins/sirsoft-pay_nicepayments')
+                ->name('plugins.sirsoft-pay_nicepayments.')
+                ->middleware('web')
+                ->group($webRoutesFile);
+        }
+
+        $apiRoutesFile = base_path('plugins/sirsoft-pay_nicepayments/src/routes/api.php');
+
+        if (file_exists($apiRoutesFile)) {
+            \Illuminate\Support\Facades\Route::prefix('api/plugins/sirsoft-pay_nicepayments')
+                ->name('api.plugins.sirsoft-pay_nicepayments.')
+                ->middleware('api')
+                ->group($apiRoutesFile);
+        }
+    }
+
+    protected function createAdminUser(array $permissions = []): \App\Models\User
+    {
+        $user = \App\Models\User::factory()->create();
+
+        $uniqueRoleIdentifier = 'admin-test-' . $user->id . '-' . time();
+        $userRole = \App\Models\Role::create([
+            'identifier' => $uniqueRoleIdentifier,
+            'name' => ['ko' => '테스트 관리자', 'en' => 'Test Admin'],
+        ]);
+        $user->roles()->attach($userRole->id);
+
+        $adminAccessPermission = \App\Models\Permission::firstOrCreate(
+            ['identifier' => 'admin.access'],
+            [
+                'name' => ['ko' => '관리자 접근', 'en' => 'Admin Access'],
+                'type' => \App\Enums\PermissionType::Admin,
+            ]
+        );
+        $userRole->permissions()->attach($adminAccessPermission->id);
+
+        if (! empty($permissions)) {
+            foreach ($permissions as $permissionIdentifier) {
+                $permission = \App\Models\Permission::firstOrCreate(
+                    ['identifier' => $permissionIdentifier],
+                    [
+                        'name' => ['ko' => $permissionIdentifier, 'en' => $permissionIdentifier],
+                        'type' => 'admin',
+                    ]
+                );
+                $userRole->permissions()->syncWithoutDetaching([$permission->id]);
+            }
+        }
+
+        return $user;
+    }
+
+    protected function createUser(): \App\Models\User
+    {
+        $userRole = \App\Models\Role::where('identifier', 'user')->first();
+        $user = \App\Models\User::factory()->create();
+
+        if ($userRole) {
+            $user->roles()->attach($userRole->id);
+        }
+
+        return $user;
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/tests/Unit/Concerns/IssuesReceiptCookieTest.php b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Unit/Concerns/IssuesReceiptCookieTest.php
new file mode 100644
index 00000000..793958e1
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Unit/Concerns/IssuesReceiptCookieTest.php
@@ -0,0 +1,92 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Tests\Unit\Concerns;
+
+use Plugins\Sirsoft\PayNicepayments\Concerns\IssuesReceiptCookie;
+use Plugins\Sirsoft\PayNicepayments\Tests\PluginTestCase;
+
+/**
+ * 영수증 cookie HMAC 검증 로직 단위 테스트.
+ *
+ * HTTP 통합(callback → Set-Cookie → 후속 호출에서 cookie 자동 첨부) 검증은
+ * Playwright 시나리오로 다룬다 — Laravel 의 EncryptCookies 미들웨어와 PHPUnit
+ * HTTP 테스트 환경의 cookie 처리 흐름이 production 과 일부 다르기 때문.
+ */
+class IssuesReceiptCookieTest extends PluginTestCase
+{
+    private object $subject;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        // IssuesReceiptCookie 는 trait — 익명 클래스로 인스턴스화
+        $this->subject = new class {
+            use IssuesReceiptCookie {
+                verifyReceiptCookie as public;
+            }
+        };
+    }
+
+    public function test_verify_succeeds_with_fresh_token_matching_order_number(): void
+    {
+        $orderNumber = 'ORD-RECEIPT-12345';
+        $cookieValue = $this->buildToken($orderNumber, time() + 300);
+
+        $this->assertTrue($this->subject->verifyReceiptCookie($cookieValue, $orderNumber));
+    }
+
+    public function test_verify_fails_when_cookie_missing(): void
+    {
+        $this->assertFalse($this->subject->verifyReceiptCookie(null, 'ORD-RECEIPT-99999'));
+        $this->assertFalse($this->subject->verifyReceiptCookie('', 'ORD-RECEIPT-99999'));
+    }
+
+    public function test_verify_fails_when_token_format_invalid(): void
+    {
+        // 3-파트 미충족
+        $this->assertFalse($this->subject->verifyReceiptCookie('ORD-X|123', 'ORD-X'));
+        // 만료시각이 숫자 아님
+        $this->assertFalse($this->subject->verifyReceiptCookie('ORD-X|abc|'.str_repeat('0', 64), 'ORD-X'));
+        // 서명이 hex 아님
+        $this->assertFalse($this->subject->verifyReceiptCookie('ORD-X|'.(time() + 300).'|invalid_sig', 'ORD-X'));
+    }
+
+    public function test_verify_fails_when_token_expired(): void
+    {
+        $orderNumber = 'ORD-RECEIPT-EXPIRED';
+        $expiredCookie = $this->buildToken($orderNumber, time() - 60);
+
+        $this->assertFalse($this->subject->verifyReceiptCookie($expiredCookie, $orderNumber));
+    }
+
+    public function test_verify_fails_when_order_number_mismatched(): void
+    {
+        $tokenFor = 'ORD-RECEIPT-AAA';
+        $accessing = 'ORD-RECEIPT-BBB';
+        $cookieValue = $this->buildToken($tokenFor, time() + 300);
+
+        // cookie 의 payload 가 다른 주문번호이므로 reject
+        $this->assertFalse($this->subject->verifyReceiptCookie($cookieValue, $accessing));
+    }
+
+    public function test_verify_fails_when_signature_tampered(): void
+    {
+        $orderNumber = 'ORD-RECEIPT-TAMPER';
+        $expiresTs = time() + 300;
+        // 정상 서명 대신 0으로 가득 찬 위조 서명
+        $tampered = $orderNumber.'|'.$expiresTs.'|'.str_repeat('0', 64);
+
+        $this->assertFalse($this->subject->verifyReceiptCookie($tampered, $orderNumber));
+    }
+
+    private function buildToken(string $orderNumber, int $expiresTs): string
+    {
+        $payload = $orderNumber.'|'.$expiresTs;
+        $signature = hash_hmac('sha256', $payload, (string) config('app.key', ''));
+
+        return $orderNumber.'|'.$expiresTs.'|'.$signature;
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/tests/Unit/Controllers/AuthTokenDedupeKeyTest.php b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Unit/Controllers/AuthTokenDedupeKeyTest.php
new file mode 100644
index 00000000..f42ad811
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Unit/Controllers/AuthTokenDedupeKeyTest.php
@@ -0,0 +1,137 @@
+<?php
+
+namespace Plugins\Sirsoft\PayNicepayments\Tests\Unit\Controllers;
+
+use PHPUnit\Framework\TestCase;
+
+/**
+ * Phase 3 PoC — 나이스페이먼츠 AuthToken 60s dedupe 의 cache key 결정성 검증
+ *
+ * 본 테스트는 PaymentCallbackController::authCallback 에 정의된 dedupe
+ * cache key 산출 로직이 다음 속성을 만족하는지 검증한다:
+ *
+ *   1. 결정성 — 동일 (mid, authToken, txTid) 입력은 항상 동일 key 산출
+ *   2. 충돌 회피 — 다른 입력이면 다른 key
+ *   3. 길이 안정성 — 항상 64자 (sha256 hex)
+ *   4. prefix — 'nicepay_auth_token_seen:' 로 시작
+ *
+ * 실제 dedupe 차단 동작은 Feature 테스트(컨트롤러 + 가짜 cache) 에서
+ * 검증되며, 본 테스트는 cache key 구성 그 자체의 안정성에 집중.
+ *
+ * 운영적 의미:
+ *   - 동일 cache key 가 도출되어야 두 번째 콜백이 차단됨
+ *   - mid 가 다르면 (= 다른 가맹점) 같은 token/tid 라도 충돌 안 함
+ *   - txTid 가 다르면 (= 다른 PG 거래) 같은 token 이라도 충돌 안 함
+ */
+class AuthTokenDedupeKeyTest extends TestCase
+{
+    private function buildKey(string $mid, string $authToken, string $txTid): string
+    {
+        // PaymentCallbackController.php:113 와 동일한 산출 로직
+        return 'nicepay_auth_token_seen:' . hash('sha256', $mid . ':' . $authToken . ':' . $txTid);
+    }
+
+    /**
+     * @scenario context=authorize_card, threat=replay_token_short, callback_state=first_arrival
+     * @effects auth_token_cache_key_uses_sha256_of_mid_token_txtid, auth_token_first_arrival_writes_cache
+     */
+    public function test_key_is_deterministic_for_same_input(): void
+    {
+        $a = $this->buildKey('SR12345', 'AUTH_TOKEN_001', 'TX_TID_001');
+        $b = $this->buildKey('SR12345', 'AUTH_TOKEN_001', 'TX_TID_001');
+
+        $this->assertSame($a, $b);
+    }
+
+    /**
+     * @scenario context=authorize_card, threat=replay_token_short, callback_state=second_arrival_within_60s
+     * @effects auth_token_within_60s_blocked
+     */
+    public function test_key_differs_when_token_differs(): void
+    {
+        $a = $this->buildKey('SR12345', 'AUTH_TOKEN_001', 'TX_TID_001');
+        $b = $this->buildKey('SR12345', 'AUTH_TOKEN_002', 'TX_TID_001');
+
+        $this->assertNotSame($a, $b);
+    }
+
+    /**
+     * @scenario context=authorize_card, threat=replay_token_short, callback_state=second_arrival_within_60s
+     * @effects auth_token_within_60s_blocked
+     */
+    public function test_key_differs_when_tx_tid_differs(): void
+    {
+        $a = $this->buildKey('SR12345', 'AUTH_TOKEN_001', 'TX_TID_001');
+        $b = $this->buildKey('SR12345', 'AUTH_TOKEN_001', 'TX_TID_002');
+
+        $this->assertNotSame($a, $b);
+    }
+
+    /**
+     * 다른 가맹점 (MID) 라면 같은 token+tid 도 충돌 없음.
+     * 멀티 가맹점 환경에서 한 가맹점의 dedupe 가 다른 가맹점에 영향 안 미침.
+     *
+     * @scenario context=authorize_card, threat=replay_token_short, callback_state=first_arrival
+     * @effects auth_token_cache_key_uses_sha256_of_mid_token_txtid
+     */
+    public function test_key_differs_when_mid_differs(): void
+    {
+        $a = $this->buildKey('SR12345', 'AUTH_TOKEN_001', 'TX_TID_001');
+        $b = $this->buildKey('SR99999', 'AUTH_TOKEN_001', 'TX_TID_001');
+
+        $this->assertNotSame($a, $b);
+    }
+
+    /**
+     * @scenario context=naverpay_callback, threat=replay_token_short, callback_state=first_arrival
+     * @effects auth_token_cache_key_uses_sha256_of_mid_token_txtid
+     */
+    public function test_key_has_expected_prefix(): void
+    {
+        $key = $this->buildKey('SR12345', 'AT001', 'TX001');
+
+        $this->assertStringStartsWith('nicepay_auth_token_seen:', $key);
+    }
+
+    /**
+     * sha256 hex = 64자.
+     * @scenario context=authorize_card, threat=replay_token_short, callback_state=first_arrival
+     * @effects auth_token_cache_key_uses_sha256_of_mid_token_txtid
+     */
+    public function test_key_has_stable_length(): void
+    {
+        $key = $this->buildKey('SR12345', 'AT001', 'TX001');
+
+        // 'nicepay_auth_token_seen:' (24) + sha256 hex (64) = 88
+        $this->assertSame(88, strlen($key));
+    }
+
+    /**
+     * 셸 메타문자/제어문자가 mid/token/tid 에 들어와도 hash 함수가
+     * 결정적 hex 만 산출하므로 cache key 부분에서 인젝션 위험 없음.
+     *
+     * @scenario context=authorize_card, threat=replay_token_short, callback_state=first_arrival
+     * @effects auth_token_cache_key_uses_sha256_of_mid_token_txtid
+     */
+    public function test_key_safe_with_metachars_in_input(): void
+    {
+        $key = $this->buildKey('SR" || OR 1=1 --', "TOKEN\nLF", "TID;rm");
+
+        $this->assertMatchesRegularExpression('/^nicepay_auth_token_seen:[0-9a-f]{64}$/', $key);
+    }
+
+    /**
+     * @scenario context=kakaopay_callback, threat=replay_token_short, callback_state=second_arrival_outside_60s
+     * @effects auth_token_outside_60s_proceeds
+     */
+    public function test_key_collision_with_concatenation_blurring(): void
+    {
+        // 만약 구분자 ':' 없이 단순 concat 했다면 ('ab', 'cd', 'ef') 와 ('abc', 'd', 'ef') 가
+        // 같은 hash 를 만들 수 있다. ':' 구분자 사용으로 이 모호성을 회피하는지 검증.
+        $a = $this->buildKey('SR', '12345', 'TID');
+        $b = $this->buildKey('SR12345', '', 'TID');
+
+        // 구분자 ':' 가 있으면 'SR:12345:TID' vs 'SR12345::TID' → 다른 hash
+        $this->assertNotSame($a, $b);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/tests/Unit/Listeners/AdjustEcommercePaymentMethodsLayoutListenerTest.php b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Unit/Listeners/AdjustEcommercePaymentMethodsLayoutListenerTest.php
new file mode 100644
index 00000000..addb16c2
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Unit/Listeners/AdjustEcommercePaymentMethodsLayoutListenerTest.php
@@ -0,0 +1,119 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Tests\Unit\Listeners;
+
+use PHPUnit\Framework\TestCase;
+use Plugins\Sirsoft\PayNicepayments\Listeners\AdjustEcommercePaymentMethodsLayoutListener;
+
+class AdjustEcommercePaymentMethodsLayoutListenerTest extends TestCase
+{
+    public function test_subscribes_to_layout_after_apply_as_filter(): void
+    {
+        $hooks = AdjustEcommercePaymentMethodsLayoutListener::getSubscribedHooks();
+
+        $this->assertSame(
+            'filter',
+            $hooks['core.layout_extension.after_apply']['type'] ?? null
+        );
+        $this->assertSame(
+            'markEasyPayMethodsAsPgNotRequired',
+            $hooks['core.layout_extension.after_apply']['method'] ?? null
+        );
+    }
+
+    public function test_marks_nicepay_easy_pay_methods_as_pg_not_required_in_admin_ecommerce_settings(): void
+    {
+        $listener = new AdjustEcommercePaymentMethodsLayoutListener();
+
+        $layout = [
+            'layout_name' => 'admin_ecommerce_settings',
+            'components' => [
+                [
+                    'type' => 'basic',
+                    'name' => 'Select',
+                    'if' => "{{!['point','deposit','free','dbank'].includes(\$method.id) && (_local.form?.available_pg_providers ?? []).length > 0}}",
+                ],
+                [
+                    'type' => 'composite',
+                    'name' => 'Toggle',
+                    'props' => [
+                        'disabled' => "{{_computed.isReadOnly || !['point','deposit','free','dbank','kginicis_naverpay','nhnkcp_payco'].includes(\$method.id) && !\$method.pg_provider && !_local.form?.order_settings?.default_pg_provider}}",
+                    ],
+                ],
+            ],
+        ];
+
+        $result = $listener->markEasyPayMethodsAsPgNotRequired($layout, 1);
+        $json = json_encode($result, JSON_UNESCAPED_SLASHES);
+
+        $this->assertIsString($json);
+        $this->assertStringContainsString('kginicis_naverpay', $json);
+        $this->assertStringContainsString('nhnkcp_payco', $json);
+        $this->assertStringContainsString('nicepay_naverpay', $json);
+        $this->assertStringContainsString('nicepay_kakaopay', $json);
+        $this->assertStringContainsString('nicepay_samsungpay', $json);
+        $this->assertStringContainsString('nicepay_applepay', $json);
+        $this->assertStringContainsString('nicepay_payco', $json);
+        $this->assertStringContainsString('nicepay_skpay', $json);
+        $this->assertStringContainsString('nicepay_ssgpay', $json);
+        $this->assertStringContainsString('nicepay_lpay', $json);
+        $this->assertStringNotContainsString("['point','deposit','free','dbank'].includes", $json);
+    }
+
+    public function test_adds_test_mode_warning_to_order_settings_tab(): void
+    {
+        $listener = new AdjustEcommercePaymentMethodsLayoutListener();
+
+        $layout = [
+            'layout_name' => 'admin_ecommerce_settings',
+            'children' => [
+                [
+                    'id' => 'tab_content_order_settings',
+                    'children' => [
+                        ['id' => 'default_pg_card'],
+                        ['id' => 'payment_methods_card'],
+                    ],
+                ],
+            ],
+        ];
+
+        $result = $listener->markEasyPayMethodsAsPgNotRequired($layout, 1);
+        $result = $listener->markEasyPayMethodsAsPgNotRequired($result, 1);
+        $json = json_encode($result, JSON_UNESCAPED_SLASHES);
+
+        $this->assertIsString($json);
+        $this->assertStringContainsString('nicepay_test_mode_status', $json);
+        $this->assertStringContainsString('/api/plugins/sirsoft-pay_nicepayments/admin/settings/test-mode-status', $json);
+        $this->assertStringContainsString('payment_test_mode_order_settings_notice', $json);
+        $this->assertStringContainsString('nicepay_test_mode_order_settings_notice', $json);
+        $this->assertStringNotContainsString('sirsoft-pay_nicepayments.admin.test_mode_settings_summary_title', $json);
+        $this->assertStringNotContainsString('sirsoft-pay_nicepayments.admin.test_mode_settings_summary_body', $json);
+        $this->assertStringContainsString('sirsoft-pay_nicepayments.admin.test_mode_settings_warning_plugin', $json);
+        $this->assertStringContainsString('sirsoft-pay_nicepayments.admin.test_mode_settings_warning_body', $json);
+        $this->assertStringContainsString('/admin/plugins/sirsoft-pay_nicepayments/settings', $json);
+        $this->assertSame(1, substr_count($json, 'payment_test_mode_order_settings_notice'));
+        $this->assertSame(1, substr_count($json, 'nicepay_test_mode_order_settings_notice'));
+        $this->assertLessThan(
+            strpos($json, 'payment_methods_card'),
+            strpos($json, 'payment_test_mode_order_settings_notice')
+        );
+    }
+
+    public function test_leaves_other_layouts_unchanged(): void
+    {
+        $listener = new AdjustEcommercePaymentMethodsLayoutListener();
+
+        $layout = [
+            'layout_name' => 'shop/checkout',
+            'components' => [
+                [
+                    'if' => "{{!['point','deposit','free','dbank'].includes(\$method.id)}}",
+                ],
+            ],
+        ];
+
+        $this->assertSame($layout, $listener->markEasyPayMethodsAsPgNotRequired($layout, 1));
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/tests/Unit/Listeners/EnsureAdminOrderLayoutExtensionsListenerTest.php b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Unit/Listeners/EnsureAdminOrderLayoutExtensionsListenerTest.php
new file mode 100644
index 00000000..e5038aa9
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Unit/Listeners/EnsureAdminOrderLayoutExtensionsListenerTest.php
@@ -0,0 +1,266 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Tests\Unit\Listeners;
+
+use PHPUnit\Framework\TestCase;
+use Plugins\Sirsoft\PayNicepayments\Listeners\EnsureAdminOrderDetailPaymentQueryLayoutListener;
+use Plugins\Sirsoft\PayNicepayments\Listeners\EnsureAdminOrderListTestBadgeLayoutListener;
+
+class EnsureAdminOrderLayoutExtensionsListenerTest extends TestCase
+{
+    public function test_list_listener_ensures_test_mode_data_source_and_badge(): void
+    {
+        $listener = new EnsureAdminOrderListTestBadgeLayoutListener();
+
+        $result = $listener->ensureTestBadgeLayout($this->makeOrderListLayout(), 1);
+        $json = json_encode($result, JSON_UNESCAPED_SLASHES);
+
+        $this->assertSame(1, $this->countDataSources($result, 'nicepay_test_map'));
+        $this->assertSame(1, $this->countDataSources($result, 'nicepay_easy_pay_display_map'));
+        $this->assertSame(1, $this->countString($result, 'nicepay_test_map.data?.[row.order_number] === true'));
+        $this->assertSame(1, $this->countString($result, 'nicepay_easy_pay_display_map.data?.[row.order_number]?.payment_method_display_label ?? row.payment?.payment_method_label'));
+        $this->assertIsString($json);
+        $this->assertStringContainsString('/api/plugins/sirsoft-pay_nicepayments/admin/orders/test-mode-map', $json);
+        $this->assertStringContainsString('/api/plugins/sirsoft-pay_nicepayments/admin/orders/easy-pay-display-map', $json);
+        $this->assertStringContainsString('sirsoft-pay_nicepayments.admin.test_mode_badge', $json);
+    }
+
+    public function test_list_listener_is_idempotent(): void
+    {
+        $listener = new EnsureAdminOrderListTestBadgeLayoutListener();
+
+        $once = $listener->ensureTestBadgeLayout($this->makeOrderListLayout(), 1);
+        $twice = $listener->ensureTestBadgeLayout($once, 1);
+
+        $this->assertSame(1, $this->countDataSources($twice, 'nicepay_test_map'));
+        $this->assertSame(1, $this->countDataSources($twice, 'nicepay_easy_pay_display_map'));
+        $this->assertSame(1, $this->countString($twice, 'nicepay_test_map.data?.[row.order_number] === true'));
+        $this->assertSame(1, $this->countString($twice, 'nicepay_easy_pay_display_map.data?.[row.order_number]?.payment_method_display_label ?? row.payment?.payment_method_label'));
+    }
+
+    public function test_detail_listener_ensures_test_notice_and_payment_panels(): void
+    {
+        $listener = new EnsureAdminOrderDetailPaymentQueryLayoutListener();
+
+        $result = $listener->ensurePaymentQueryLayout($this->makeOrderDetailLayout(), 1);
+        $header = $this->findNodeById($result, 'page_header_section');
+        $tabContent = $this->findNodeById($result, 'tab_content_area');
+        $wrapper = $this->findNodeById($result, 'order_detail_wrapper');
+        $json = json_encode($result, JSON_UNESCAPED_SLASHES);
+
+        $this->assertSame(1, $this->countDataSources($result, 'nicepay_status'));
+        $this->assertSame(1, $this->countDataSources($result, 'nicepay_escrow'));
+        $this->assertIsArray($header);
+        $this->assertIsArray($tabContent);
+        $this->assertIsArray($wrapper);
+        $this->assertSame(1, $this->countNodeId($header, 'nicepay_test_mode_notice'));
+        $this->assertSame(1, $this->countNodeId($tabContent, 'nicepay_verify_panel'));
+        $this->assertSame(1, $this->countNodeId($tabContent, 'nicepay_escrow_panel'));
+        $this->assertSame(1, $this->countNodeId($tabContent, 'nicepay_vbank_notifications_panel'));
+        $this->assertSame(0, $this->countDirectChildId($wrapper, 'nicepay_verify_panel'));
+        $this->assertIsString($json);
+        $this->assertStringContainsString('nicepay_status.data?._is_test_mode === true', $json);
+        $this->assertStringContainsString('sirsoft-pay_nicepayments.admin.order_verify_title', $json);
+    }
+
+    public function test_detail_listener_uses_wrapper_when_tab_content_area_is_renamed(): void
+    {
+        $listener = new EnsureAdminOrderDetailPaymentQueryLayoutListener();
+
+        $result = $listener->ensurePaymentQueryLayout($this->makeOrderDetailLayout(includeTabContentArea: false), 1);
+        $wrapper = $this->findNodeById($result, 'order_detail_wrapper');
+
+        $this->assertIsArray($wrapper);
+        $this->assertSame(1, $this->countDirectChildId($wrapper, 'nicepay_verify_panel'));
+    }
+
+    public function test_detail_listener_is_idempotent(): void
+    {
+        $listener = new EnsureAdminOrderDetailPaymentQueryLayoutListener();
+
+        $once = $listener->ensurePaymentQueryLayout($this->makeOrderDetailLayout(), 1);
+        $twice = $listener->ensurePaymentQueryLayout($once, 1);
+
+        $this->assertSame(1, $this->countDataSources($twice, 'nicepay_status'));
+        $this->assertSame(1, $this->countNodeId($twice, 'nicepay_test_mode_notice'));
+        $this->assertSame(1, $this->countNodeId($twice, 'nicepay_verify_panel'));
+        $this->assertSame(1, $this->countNodeId($twice, 'nicepay_escrow_panel'));
+        $this->assertSame(1, $this->countNodeId($twice, 'nicepay_vbank_notifications_panel'));
+    }
+
+    public function test_leaves_other_layouts_unchanged(): void
+    {
+        $listListener = new EnsureAdminOrderListTestBadgeLayoutListener();
+        $detailListener = new EnsureAdminOrderDetailPaymentQueryLayoutListener();
+        $layout = [
+            'layout_name' => 'shop/checkout',
+            'data_sources' => [],
+            'components' => [],
+        ];
+
+        $this->assertSame($layout, $listListener->ensureTestBadgeLayout($layout, 1));
+        $this->assertSame($layout, $detailListener->ensurePaymentQueryLayout($layout, 1));
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    private function makeOrderListLayout(): array
+    {
+        return [
+            'layout_name' => 'admin_ecommerce_order_list',
+            'data_sources' => [],
+            'components' => [
+                [
+                    'id' => 'order_datagrid',
+                    'type' => 'composite',
+                    'name' => 'DataGrid',
+                    'props' => [
+                        'columns' => [
+                            ['field' => 'order_number', 'cellChildren' => []],
+                            [
+                                'field' => 'payment_method',
+                                'cellChildren' => [
+                                    [
+                                        'type' => 'basic',
+                                        'name' => 'Div',
+                                        'children' => [
+                                            ['type' => 'basic', 'name' => 'Span', 'text' => '{{row.payment?.payment_method_label}}'],
+                                        ],
+                                    ],
+                                ],
+                            ],
+                        ],
+                    ],
+                ],
+            ],
+        ];
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    private function makeOrderDetailLayout(bool $includeTabContentArea = true): array
+    {
+        $children = [
+            [
+                'id' => 'page_header_section',
+                'type' => 'basic',
+                'name' => 'Div',
+                'children' => [
+                    ['id' => 'page_header', 'type' => 'basic', 'name' => 'Div'],
+                ],
+            ],
+        ];
+
+        if ($includeTabContentArea) {
+            $children[] = ['id' => 'tab_content_area', 'type' => 'basic', 'name' => 'Div', 'children' => []];
+        }
+
+        return [
+            'layout_name' => 'admin_ecommerce_order_detail',
+            'data_sources' => [],
+            'slots' => [
+                'content' => [
+                    [
+                        'id' => 'order_detail_wrapper',
+                        'type' => 'basic',
+                        'name' => 'Div',
+                        'children' => $children,
+                    ],
+                ],
+            ],
+        ];
+    }
+
+    /**
+     * @param array<string, mixed> $layout
+     */
+    private function countDataSources(array $layout, string $id): int
+    {
+        return count(array_filter(
+            $layout['data_sources'] ?? [],
+            static fn ($dataSource): bool => is_array($dataSource) && ($dataSource['id'] ?? null) === $id
+        ));
+    }
+
+    /**
+     * @param array<string|int, mixed> $node
+     */
+    private function countString(array $node, string $needle): int
+    {
+        $count = 0;
+
+        foreach ($node as $value) {
+            if (is_array($value)) {
+                $count += $this->countString($value, $needle);
+                continue;
+            }
+
+            if (is_string($value) && str_contains($value, $needle)) {
+                $count++;
+            }
+        }
+
+        return $count;
+    }
+
+    /**
+     * @param array<string|int, mixed> $node
+     */
+    private function countNodeId(array $node, string $id): int
+    {
+        $count = 0;
+
+        foreach ($node as $value) {
+            if (is_array($value)) {
+                $count += $this->countNodeId($value, $id);
+                continue;
+            }
+
+            if ($value === $id) {
+                $count++;
+            }
+        }
+
+        return $count;
+    }
+
+    /**
+     * @param array<string, mixed> $node
+     * @return array<string, mixed>|null
+     */
+    private function findNodeById(array $node, string $id): ?array
+    {
+        if (($node['id'] ?? null) === $id) {
+            return $node;
+        }
+
+        foreach ($node as $value) {
+            if (! is_array($value)) {
+                continue;
+            }
+
+            $found = $this->findNodeById($value, $id);
+
+            if (is_array($found)) {
+                return $found;
+            }
+        }
+
+        return null;
+    }
+
+    /**
+     * @param array<string, mixed> $node
+     */
+    private function countDirectChildId(array $node, string $id): int
+    {
+        return count(array_filter(
+            $node['children'] ?? [],
+            static fn ($child): bool => is_array($child) && ($child['id'] ?? null) === $id
+        ));
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/tests/Unit/Listeners/PaymentRefundListenerTest.php b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Unit/Listeners/PaymentRefundListenerTest.php
new file mode 100644
index 00000000..a2cff850
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Unit/Listeners/PaymentRefundListenerTest.php
@@ -0,0 +1,164 @@
+<?php
+
+namespace Plugins\Sirsoft\PayNicepayments\Tests\Unit\Listeners;
+
+use App\Extension\HookManager;
+use App\Models\User;
+use Illuminate\Support\Facades\Http;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderFactory;
+use Modules\Sirsoft\Ecommerce\Database\Factories\OrderPaymentFactory;
+use Modules\Sirsoft\Ecommerce\Enums\OrderStatusEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentMethodEnum;
+use Modules\Sirsoft\Ecommerce\Enums\PaymentStatusEnum;
+use Modules\Sirsoft\Ecommerce\Models\Order;
+use Modules\Sirsoft\Ecommerce\Models\OrderPayment;
+use Plugins\Sirsoft\PayNicepayments\Listeners\PaymentRefundListener;
+use Plugins\Sirsoft\PayNicepayments\Services\NicePaymentsApiService;
+use Plugins\Sirsoft\PayNicepayments\Tests\PluginTestCase;
+
+class PaymentRefundListenerTest extends PluginTestCase
+{
+    private function createOrderWithPayment(string $tid = 'TID_REFUND_001', int $amount = 50000): array
+    {
+        $user = User::factory()->create();
+
+        $order = OrderFactory::new()->create([
+            'user_id' => $user->id,
+            'order_number' => 'ORD-TEST-' . random_int(10000, 99999),
+            'order_status' => OrderStatusEnum::PAYMENT_COMPLETE,
+            'subtotal_amount' => $amount,
+            'total_discount_amount' => 0,
+            'total_coupon_discount_amount' => 0,
+            'total_product_coupon_discount_amount' => 0,
+            'total_order_coupon_discount_amount' => 0,
+            'total_code_discount_amount' => 0,
+            'base_shipping_amount' => 0,
+            'extra_shipping_amount' => 0,
+            'shipping_discount_amount' => 0,
+            'total_shipping_amount' => 0,
+            'total_amount' => $amount,
+            'total_due_amount' => $amount,
+            'total_points_used_amount' => 0,
+            'total_deposit_used_amount' => 0,
+            'total_paid_amount' => $amount,
+        ]);
+
+        $payment = OrderPaymentFactory::new()->create([
+            'order_id' => $order->id,
+            'payment_status' => PaymentStatusEnum::PAID,
+            'payment_method' => PaymentMethodEnum::CARD,
+            'pg_provider' => 'nicepayments',
+            'paid_amount_local' => $amount,
+            'paid_at' => now(),
+            'transaction_id' => $tid,
+        ]);
+
+        return [$order, $payment];
+    }
+
+    public function test_process_refund_skips_non_nicepayments_provider(): void
+    {
+        [$order, $payment] = $this->createOrderWithPayment();
+        $payment->update(['pg_provider' => 'other_pg']);
+        $payment->refresh();
+
+        $listener = new PaymentRefundListener();
+        $initial = ['success' => false, 'error_code' => null];
+
+        $result = $listener->processRefund($initial, $order, $payment, 50000.0, null);
+
+        $this->assertSame($initial, $result);
+    }
+
+    public function test_process_refund_returns_error_when_tid_is_missing(): void
+    {
+        [$order, $payment] = $this->createOrderWithPayment();
+        $payment->update(['transaction_id' => null]);
+        $payment->refresh();
+
+        $listener = new PaymentRefundListener();
+        $result = $listener->processRefund([], $order, $payment, 50000.0, null);
+
+        $this->assertFalse($result['success']);
+        $this->assertEquals('MISSING_TID', $result['error_code']);
+    }
+
+    public function test_process_refund_returns_success_on_successful_cancel(): void
+    {
+        [$order, $payment] = $this->createOrderWithPayment('TID_SUCCESS', 50000);
+
+        $apiServiceMock = $this->createMock(NicePaymentsApiService::class);
+        $apiServiceMock->method('cancelPayment')
+            ->willReturn(['ResultCode' => '2001', 'TID' => 'TID_CANCEL']);
+
+        $this->app->instance(NicePaymentsApiService::class, $apiServiceMock);
+
+        $listener = new PaymentRefundListener();
+        $result = $listener->processRefund([], $order, $payment, 50000.0, '고객 요청');
+
+        $this->assertTrue($result['success']);
+        $this->assertNull($result['error_code']);
+        $this->assertEquals('TID_CANCEL', $result['transaction_id']);
+    }
+
+    public function test_process_refund_restores_payment_time_mid_and_mode(): void
+    {
+        [$order, $payment] = $this->createOrderWithPayment('TID_STORED_MID', 50000);
+        $payment->update([
+            'payment_meta' => [
+                'mid' => 'SRLIVE001',
+                'is_test_mode' => false,
+            ],
+        ]);
+        $payment->refresh();
+
+        $apiServiceMock = $this->createMock(NicePaymentsApiService::class);
+        $apiServiceMock->expects($this->once())
+            ->method('useStoredCredentials')
+            ->with(false, 'SRLIVE001');
+        $apiServiceMock->expects($this->once())
+            ->method('cancelPayment')
+            ->willReturn(['ResultCode' => '2001', 'TID' => 'TID_CANCEL']);
+
+        $this->app->instance(NicePaymentsApiService::class, $apiServiceMock);
+
+        $listener = new PaymentRefundListener();
+        $result = $listener->processRefund([], $order, $payment, 50000.0, '고객 요청');
+
+        $this->assertTrue($result['success']);
+        $this->assertEquals('TID_CANCEL', $result['transaction_id']);
+    }
+
+    public function test_process_refund_fires_refund_failed_hook_on_api_error(): void
+    {
+        [$order, $payment] = $this->createOrderWithPayment('TID_FAIL', 50000);
+
+        $apiServiceMock = $this->createMock(NicePaymentsApiService::class);
+        $apiServiceMock->method('cancelPayment')
+            ->willThrowException(new \Exception('PG API 오류'));
+
+        $this->app->instance(NicePaymentsApiService::class, $apiServiceMock);
+
+        $hookFired = false;
+        $capturedArgs = [];
+
+        HookManager::addAction(
+            'sirsoft-pay_nicepayments.payment.refund_failed',
+            function (Order $o, OrderPayment $p, array $context) use (&$hookFired, &$capturedArgs) {
+                $hookFired = true;
+                $capturedArgs = $context;
+            },
+            10
+        );
+
+        $listener = new PaymentRefundListener();
+        $result = $listener->processRefund([], $order, $payment, 50000.0, null);
+
+        $this->assertFalse($result['success']);
+        $this->assertEquals('PG_API_ERROR', $result['error_code']);
+        $this->assertTrue($hookFired, 'refund_failed 훅이 발동되어야 합니다');
+        $this->assertEquals('TID_FAIL', $capturedArgs['tid']);
+        $this->assertEquals(50000, $capturedArgs['cancel_amt']);
+        $this->assertEquals('PG API 오류', $capturedArgs['error']);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/tests/Unit/Listeners/RegisterEasyPayMethodsListenerTest.php b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Unit/Listeners/RegisterEasyPayMethodsListenerTest.php
new file mode 100644
index 00000000..871b1f3d
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Unit/Listeners/RegisterEasyPayMethodsListenerTest.php
@@ -0,0 +1,135 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Tests\Unit\Listeners;
+
+use Plugins\Sirsoft\PayNicepayments\Listeners\AdjustEcommercePaymentMethodsLayoutListener;
+use Plugins\Sirsoft\PayNicepayments\Listeners\RegisterEasyPayMethodsListener;
+use Plugins\Sirsoft\PayNicepayments\Plugin;
+use Tests\TestCase;
+
+class RegisterEasyPayMethodsListenerTest extends TestCase
+{
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        $this->app['translator']->addNamespace(
+            'sirsoft-pay_nicepayments',
+            base_path('plugins/_bundled/sirsoft-pay_nicepayments/lang')
+        );
+    }
+
+    public function test_injects_easy_pay_methods_after_existing_pg_easy_pay_methods(): void
+    {
+        $listener = new RegisterEasyPayMethodsListener();
+
+        $methods = $listener->injectEasyPayMethods([
+            ['id' => 'card'],
+            ['id' => 'phone'],
+            ['id' => 'kginicis_samsung_pay'],
+            ['id' => 'nhnkcp_payco'],
+            ['id' => 'point'],
+            ['id' => 'deposit'],
+        ]);
+
+        $this->assertSame([
+            'card',
+            'phone',
+            'kginicis_samsung_pay',
+            'nhnkcp_payco',
+            'nicepay_naverpay',
+            'nicepay_kakaopay',
+            'nicepay_samsungpay',
+            'nicepay_applepay',
+            'nicepay_payco',
+            'nicepay_skpay',
+            'nicepay_ssgpay',
+            'nicepay_lpay',
+            'point',
+            'deposit',
+        ], array_column($methods, 'id'));
+    }
+
+    public function test_plugin_registers_easy_pay_hook_listeners(): void
+    {
+        $listeners = (new Plugin())->getHookListeners();
+
+        $this->assertContains(RegisterEasyPayMethodsListener::class, $listeners);
+        $this->assertContains(AdjustEcommercePaymentMethodsLayoutListener::class, $listeners);
+    }
+
+    public function test_easy_pay_methods_do_not_require_pg_provider_in_saved_defaults(): void
+    {
+        $listener = new RegisterEasyPayMethodsListener();
+
+        $methods = $listener->injectEasyPayMethods([
+            ['id' => 'phone'],
+            ['id' => 'point'],
+        ]);
+
+        $easyPayMethods = array_filter(
+            $methods,
+            fn (array $method): bool => str_starts_with((string) ($method['id'] ?? ''), 'nicepay_')
+        );
+
+        $this->assertCount(8, $easyPayMethods);
+
+        foreach ($easyPayMethods as $method) {
+            $this->assertArrayHasKey('defaults', $method);
+            $this->assertNull($method['defaults']['pg_provider'] ?? null);
+            $this->assertFalse($method['defaults']['is_active'] ?? true);
+            $this->assertSame('payment_complete', $method['defaults']['stock_deduction_timing'] ?? null);
+        }
+    }
+
+    public function test_easy_pay_method_labels_match_admin_payment_method_names(): void
+    {
+        $listener = new RegisterEasyPayMethodsListener();
+
+        $methods = $listener->injectEasyPayMethods([
+            ['id' => 'phone'],
+            ['id' => 'point'],
+        ]);
+
+        $naverpay = collect($methods)->firstWhere('id', 'nicepay_naverpay');
+        $kakaopay = collect($methods)->firstWhere('id', 'nicepay_kakaopay');
+        $payco = collect($methods)->firstWhere('id', 'nicepay_payco');
+
+        $this->assertSame('네이' . "\u{200B}" . '버페이 (나이스페이먼츠)', $naverpay['name']['ko'] ?? null);
+        $this->assertSame('카카' . "\u{200B}" . '오페이로 결제 (나이스페이먼츠)', $kakaopay['description']['ko'] ?? null);
+        $this->assertSame('PAYCO (NicePayments)', $payco['name']['en'] ?? null);
+    }
+
+    public function test_easy_pay_method_labels_avoid_other_pg_brand_matchers(): void
+    {
+        $listener = new RegisterEasyPayMethodsListener();
+
+        $methods = $listener->injectEasyPayMethods([
+            ['id' => 'phone'],
+            ['id' => 'point'],
+        ]);
+
+        $guardedTexts = [];
+        foreach (['nicepay_naverpay', 'nicepay_kakaopay', 'nicepay_samsungpay', 'nicepay_lpay'] as $methodId) {
+            $method = collect($methods)->firstWhere('id', $methodId);
+
+            $guardedTexts[] = $method['name']['ko'] ?? '';
+            $guardedTexts[] = $method['description']['ko'] ?? '';
+            $guardedTexts[] = $method['name']['en'] ?? '';
+            $guardedTexts[] = $method['description']['en'] ?? '';
+        }
+
+        $joined = implode(' ', $guardedTexts);
+
+        $this->assertStringContainsString("\u{200B}", $joined);
+        $this->assertStringNotContainsString('네이버페이', $joined);
+        $this->assertStringNotContainsString('카카오페이', $joined);
+        $this->assertStringNotContainsString('삼성페이', $joined);
+        $this->assertStringNotContainsString('Naver Pay', $joined);
+        $this->assertStringNotContainsString('Kakao Pay', $joined);
+        $this->assertStringNotContainsString('Samsung Pay', $joined);
+        $this->assertStringNotContainsString('L.pay', $joined);
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/tests/Unit/Listeners/RestoreLayoutExtensionsAfterUpdateListenerTest.php b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Unit/Listeners/RestoreLayoutExtensionsAfterUpdateListenerTest.php
new file mode 100644
index 00000000..79aa5759
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Unit/Listeners/RestoreLayoutExtensionsAfterUpdateListenerTest.php
@@ -0,0 +1,111 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Tests\Unit\Listeners;
+
+use App\Enums\LayoutExtensionType;
+use App\Enums\LayoutSourceType;
+use App\Models\LayoutExtension;
+use App\Models\Template;
+use App\Models\TemplateLayout;
+use Plugins\Sirsoft\PayNicepayments\Listeners\RestoreLayoutExtensionsAfterUpdateListener;
+use Plugins\Sirsoft\PayNicepayments\Plugin;
+use Plugins\Sirsoft\PayNicepayments\Tests\PluginTestCase;
+
+class RestoreLayoutExtensionsAfterUpdateListenerTest extends PluginTestCase
+{
+    public function test_subscribes_to_plugin_updated_as_sync_action(): void
+    {
+        $hooks = RestoreLayoutExtensionsAfterUpdateListener::getSubscribedHooks();
+
+        $this->assertSame('action', $hooks['core.plugins.updated']['type'] ?? null);
+        $this->assertSame('restoreCurrentExtensionsAfterUpdate', $hooks['core.plugins.updated']['method'] ?? null);
+        $this->assertTrue($hooks['core.plugins.updated']['sync'] ?? false);
+    }
+
+    public function test_plugin_registers_layout_extension_restore_listener(): void
+    {
+        $this->assertContains(
+            RestoreLayoutExtensionsAfterUpdateListener::class,
+            (new Plugin())->getHookListeners()
+        );
+    }
+
+    public function test_restores_soft_deleted_current_extension_for_prefixed_module_layout(): void
+    {
+        $template = Template::factory()->create([
+            'identifier' => 'sirsoft-admin_basic',
+            'type' => 'admin',
+            'status' => 'active',
+        ]);
+
+        TemplateLayout::factory()->create([
+            'template_id' => $template->id,
+            'name' => 'sirsoft-ecommerce.admin_ecommerce_order_list',
+            'source_type' => LayoutSourceType::Module,
+            'source_identifier' => 'sirsoft-ecommerce',
+            'content' => [
+                'layout_name' => 'admin_ecommerce_order_list',
+                'components' => [],
+                'data_sources' => [],
+            ],
+        ]);
+
+        $extension = LayoutExtension::factory()
+            ->overlay()
+            ->fromPlugin('sirsoft-pay_nicepayments')
+            ->targeting('admin_ecommerce_order_list')
+            ->create([
+                'template_id' => $template->id,
+                'content' => [
+                    'target_layout' => 'admin_ecommerce_order_list',
+                    'data_sources' => [],
+                    'injections' => [],
+                ],
+                'is_active' => true,
+            ]);
+        $extension->delete();
+
+        (new RestoreLayoutExtensionsAfterUpdateListener())
+            ->restoreCurrentExtensionsAfterUpdate('sirsoft-pay_nicepayments');
+
+        $restored = LayoutExtension::withTrashed()->findOrFail($extension->id);
+
+        $this->assertFalse($restored->trashed());
+        $this->assertTrue($restored->is_active);
+        $this->assertSame(LayoutExtensionType::Overlay, $restored->extension_type);
+        $this->assertSame(LayoutSourceType::Plugin, $restored->source_type);
+        $this->assertSame('sirsoft-pay_nicepayments', $restored->source_identifier);
+        $this->assertSame('admin_ecommerce_order_list', $restored->target_name);
+
+        $json = json_encode($restored->content, JSON_UNESCAPED_SLASHES);
+        $this->assertIsString($json);
+        $this->assertStringContainsString('nicepay_test_map', $json);
+    }
+
+    public function test_ignores_other_plugins(): void
+    {
+        $template = Template::factory()->create(['type' => 'admin']);
+
+        TemplateLayout::factory()->create([
+            'template_id' => $template->id,
+            'name' => 'sirsoft-ecommerce.admin_ecommerce_order_list',
+            'source_type' => LayoutSourceType::Module,
+            'source_identifier' => 'sirsoft-ecommerce',
+            'content' => ['layout_name' => 'admin_ecommerce_order_list'],
+        ]);
+
+        $extension = LayoutExtension::factory()
+            ->overlay()
+            ->fromPlugin('sirsoft-pay_nicepayments')
+            ->targeting('admin_ecommerce_order_list')
+            ->create(['template_id' => $template->id]);
+        $extension->delete();
+
+        (new RestoreLayoutExtensionsAfterUpdateListener())
+            ->restoreCurrentExtensionsAfterUpdate('sirsoft-pay_nhnkcp');
+
+        $this->assertTrue(LayoutExtension::withTrashed()->findOrFail($extension->id)->trashed());
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/tests/Unit/Services/NicePaymentsApiServiceTest.php b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Unit/Services/NicePaymentsApiServiceTest.php
new file mode 100644
index 00000000..f0e2ad6c
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Unit/Services/NicePaymentsApiServiceTest.php
@@ -0,0 +1,253 @@
+<?php
+
+namespace Plugins\Sirsoft\PayNicepayments\Tests\Unit\Services;
+
+use App\Services\PluginSettingsService;
+use Illuminate\Support\Facades\Http;
+use Plugins\Sirsoft\PayNicepayments\Services\NicePaymentsApiService;
+use Plugins\Sirsoft\PayNicepayments\Tests\PluginTestCase;
+
+class NicePaymentsApiServiceTest extends PluginTestCase
+{
+    private const TEST_MID = 'nicepay00m';
+
+    private const TEST_MERCHANT_KEY = 'EYzu8jGGMfqaDEp76gSckuvnaHHu+bC4opsSN6lHv3b2lurNYkVXrZ7Z1AoqQnXI3eLuaUFyoRNC6FkrzVjceg==';
+
+    private function makeService(array $settingsOverrides = []): NicePaymentsApiService
+    {
+        $defaults = [
+            'is_test_mode' => true,
+            'test_mid' => self::TEST_MID,
+            'test_merchant_key' => self::TEST_MERCHANT_KEY,
+            'live_mid' => '',
+            'live_merchant_key' => '',
+        ];
+
+        $settingsMock = $this->createMock(PluginSettingsService::class);
+        $settingsMock->method('get')
+            ->willReturn(array_merge($defaults, $settingsOverrides));
+
+        return new NicePaymentsApiService($settingsMock);
+    }
+
+    public function test_get_mid_returns_test_mid_in_test_mode(): void
+    {
+        $service = $this->makeService();
+
+        $this->assertEquals(self::TEST_MID, $service->getMid());
+    }
+
+    public function test_get_mid_returns_live_mid_in_live_mode(): void
+    {
+        $service = $this->makeService([
+            'is_test_mode' => false,
+            'live_mid' => 'live_mid_value',
+            'live_merchant_key' => 'live_key',
+        ]);
+
+        $this->assertEquals('SRlive_mid_value', $service->getMid());
+    }
+
+    public function test_get_mid_returns_empty_when_live_mid_is_missing(): void
+    {
+        $service = $this->makeService([
+            'is_test_mode' => false,
+            'live_mid' => '',
+            'live_merchant_key' => 'live_key',
+        ]);
+
+        $this->assertSame('', $service->getMid());
+    }
+
+    public function test_verify_callback_signature_returns_true_on_valid_signature(): void
+    {
+        $service = $this->makeService();
+
+        $authToken = 'AUTH_TOKEN_TEST';
+        $mid = self::TEST_MID;
+        $amt = 50000;
+        $signature = bin2hex(hash('sha256', $authToken . $mid . (string) $amt . self::TEST_MERCHANT_KEY, true));
+
+        $this->assertTrue($service->verifyCallbackSignature($authToken, $mid, $amt, $signature));
+    }
+
+    public function test_verify_callback_signature_returns_false_on_invalid_signature(): void
+    {
+        $service = $this->makeService();
+
+        $this->assertFalse($service->verifyCallbackSignature('token', self::TEST_MID, 50000, 'INVALID'));
+    }
+
+    public function test_verify_callback_signature_returns_false_on_tampered_amount(): void
+    {
+        $service = $this->makeService();
+
+        $authToken = 'AUTH_TOKEN_TEST';
+        $amt = 50000;
+        $signature = bin2hex(hash('sha256', $authToken . self::TEST_MID . (string) $amt . self::TEST_MERCHANT_KEY, true));
+
+        // 금액을 변조하여 서명 검증
+        $this->assertFalse($service->verifyCallbackSignature($authToken, self::TEST_MID, 99999, $signature));
+    }
+
+    public function test_authorize_payment_calls_next_app_url_with_correct_params(): void
+    {
+        $service = $this->makeService();
+
+        $nextAppUrl = 'https://pay.nicepay.co.kr/v1/authorize';
+        $txTid = 'TX_TID_TEST';
+        $authToken = 'AUTH_TOKEN_TEST';
+        $amt = 50000;
+
+        Http::fake([
+            $nextAppUrl => Http::response([
+                'ResultCode' => '3001',
+                'ResultMsg' => '정상처리',
+                'TID' => 'TID_FINAL',
+                'Amt' => (string) $amt,
+            ], 200),
+        ]);
+
+        $result = $service->authorizePayment($nextAppUrl, $txTid, $authToken, $amt);
+
+        $this->assertEquals('3001', $result['ResultCode']);
+        $this->assertEquals('TID_FINAL', $result['TID']);
+
+        Http::assertSent(function ($request) use ($nextAppUrl, $txTid, $authToken, $amt) {
+            return $request->url() === $nextAppUrl
+                && $request['TID'] === $txTid
+                && $request['AuthToken'] === $authToken
+                && $request['MID'] === self::TEST_MID
+                && $request['Amt'] == $amt
+                && isset($request['EdiDate'])
+                && isset($request['SignData'])
+                && $request['CharSet'] === 'utf-8';
+        });
+    }
+
+    public function test_authorize_payment_throws_on_http_error(): void
+    {
+        $service = $this->makeService();
+
+        Http::fake([
+            '*' => Http::response(null, 500),
+        ]);
+
+        $this->expectException(\Exception::class);
+        $this->expectExceptionMessageMatches('/HTTP 500/');
+
+        $service->authorizePayment('https://pay.nicepay.co.kr/v1/authorize', 'TID', 'TOKEN', 50000);
+    }
+
+    public function test_cancel_payment_calls_cancel_api_and_returns_response(): void
+    {
+        $service = $this->makeService();
+
+        Http::fake([
+            'pg-api.nicepay.co.kr/webapi/cancel_process.jsp' => Http::response([
+                'ResultCode' => '2001',
+                'ResultMsg' => '취소 성공',
+                'TID' => 'TID_CANCEL',
+            ], 200),
+        ]);
+
+        $result = $service->cancelPayment('TID_ORIG', 'ORD-001', 50000, '고객 요청', 0);
+
+        $this->assertEquals('2001', $result['ResultCode']);
+    }
+
+    public function test_cancel_payment_throws_on_non_2001_result_code(): void
+    {
+        $service = $this->makeService();
+
+        Http::fake([
+            'pg-api.nicepay.co.kr/webapi/cancel_process.jsp' => Http::response([
+                'ResultCode' => '9999',
+                'ResultMsg' => '취소 실패',
+            ], 200),
+        ]);
+
+        $this->expectException(\Exception::class);
+        $this->expectExceptionMessage('취소 실패');
+
+        $service->cancelPayment('TID_ORIG', 'ORD-001', 50000, '고객 요청', 0);
+    }
+
+    public function test_send_net_cancel_posts_to_net_cancel_url(): void
+    {
+        $service = $this->makeService();
+
+        $netCancelUrl = 'https://pay.nicepay.co.kr/v1/netcancel';
+
+        Http::fake([
+            $netCancelUrl => Http::response('OK', 200),
+        ]);
+
+        // 예외 없이 실행되어야 함
+        $service->sendNetCancel($netCancelUrl, 'TX_TID_TEST', 'AUTH_TOKEN_TEST', 50000);
+
+        Http::assertSent(function ($request) use ($netCancelUrl) {
+            return $request->url() === $netCancelUrl
+                && $request['NetCancel'] == 1
+                && $request['MID'] === self::TEST_MID;
+        });
+    }
+
+    public function test_send_net_cancel_does_not_throw_on_http_error(): void
+    {
+        $service = $this->makeService();
+
+        Http::fake([
+            '*' => Http::response(null, 500),
+        ]);
+
+        // 예외 없이 실행되어야 함 (망취소 실패는 무시)
+        $service->sendNetCancel('https://pay.nicepay.co.kr/v1/netcancel', 'TX_TID', 'TOKEN', 50000);
+
+        $this->assertTrue(true);
+    }
+
+    public function test_query_transaction_calls_query_api(): void
+    {
+        $service = $this->makeService();
+        $tid = 'TID_QUERY_TEST';
+
+        Http::fake([
+            'webapi.nicepay.co.kr/webapi/inquery/trans_status.jsp' => Http::response([
+                'ResultCode' => '2000',
+                'ResultMsg' => '정상처리',
+                'TID' => $tid,
+                'Amt' => '50000',
+            ], 200),
+        ]);
+
+        $result = $service->queryTransaction($tid);
+
+        $this->assertEquals('2000', $result['ResultCode']);
+        $this->assertEquals($tid, $result['TID']);
+
+        Http::assertSent(function ($request) use ($tid) {
+            return str_contains($request->url(), 'trans_status.jsp')
+                && $request['TID'] === $tid
+                && $request['MID'] === self::TEST_MID
+                && isset($request['EdiDate'])
+                && isset($request['SignData'])
+                && $request['CharSet'] === 'utf-8'
+                && $request['EdiType'] === 'JSON';
+        });
+    }
+
+    public function test_query_transaction_throws_on_http_error(): void
+    {
+        $service = $this->makeService();
+
+        Http::fake([
+            '*' => Http::response(null, 500),
+        ]);
+
+        $this->expectException(\Exception::class);
+        $this->expectExceptionMessageMatches('/HTTP 500/');
+
+        $service->queryTransaction('TID_TEST');
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/tests/Unit/Support/UrlHelperTest.php b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Unit/Support/UrlHelperTest.php
new file mode 100644
index 00000000..4baf3f9f
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/tests/Unit/Support/UrlHelperTest.php
@@ -0,0 +1,39 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugins\Sirsoft\PayNicepayments\Tests\Unit\Support;
+
+use Plugins\Sirsoft\PayNicepayments\Support\UrlHelper;
+use Plugins\Sirsoft\PayNicepayments\Tests\PluginTestCase;
+
+class UrlHelperTest extends PluginTestCase
+{
+    public function test_relative_url_uses_config_app_url_instead_of_forwarded_host(): void
+    {
+        config(['app.url' => 'https://shop.example.test']);
+
+        $_SERVER['HTTP_X_FORWARDED_HOST'] = 'attacker.example.test';
+        $_SERVER['HTTP_X_FORWARDED_PROTO'] = 'https';
+        $_SERVER['HTTP_HOST'] = 'attacker.example.test';
+
+        try {
+            $this->assertSame(
+                'https://shop.example.test/shop/checkout',
+                UrlHelper::toAbsolute('/shop/checkout')
+            );
+        } finally {
+            unset($_SERVER['HTTP_X_FORWARDED_HOST'], $_SERVER['HTTP_X_FORWARDED_PROTO'], $_SERVER['HTTP_HOST']);
+        }
+    }
+
+    public function test_absolute_url_is_returned_unchanged(): void
+    {
+        config(['app.url' => 'https://shop.example.test']);
+
+        $this->assertSame(
+            'https://payments.example.test/return',
+            UrlHelper::toAbsolute('https://payments.example.test/return')
+        );
+    }
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/tests/scenarios/example_pg_payment.yaml.example b/plugins/_bundled/sirsoft-pay_nicepayments/tests/scenarios/example_pg_payment.yaml.example
new file mode 100644
index 00000000..661cbbae
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/tests/scenarios/example_pg_payment.yaml.example
@@ -0,0 +1,110 @@
+# 시나리오 매니페스트 예시 (실제 적용 아님 — .yaml.example 확장자)
+# 실제 매니페스트로 채택할 때 .yaml 로 이름 변경 + test_files 의 실재 경로 매핑
+#
+# 참조: docs/testing-guide.md "기능 단위 시나리오 매트릭스"
+
+feature: order_payment_pg_nicepayments
+description: 나이스페이먼츠 PG 를 통한 주문 결제 흐름 (회원/비회원, 결제 수단, 가상계좌, 에스크로, 간편결제 등 도메인 변수 cross product)
+
+# 매니페스트를 검증하는 테스트 파일 (실제 작성 시 경로 갱신)
+test_files:
+  - plugins/_bundled/sirsoft-pay_nicepayments/tests/Feature/Payment/NicePayAuthCallbackTest.php
+  - plugins/_bundled/sirsoft-pay_nicepayments/tests/Feature/Payment/VbankNotifyTest.php
+  - plugins/_bundled/sirsoft-pay_nicepayments/tests/Feature/Payment/CancelTest.php
+
+# 축이 많아 full cross product 가 폭발하므로 pairwise 전략
+coverage_strategy: pairwise
+
+# 입력 axis — 결제 흐름에 영향을 주는 도메인 변수 전수
+axes:
+  user_type: [member, guest]
+  payment_method: [card, bank_transfer, virtual_account, mobile]
+  easy_pay: [none, naverpay, kakaopay, samsungpay, applepay, payco, skpay, ssgpay, lpay]
+  is_test_mode: [true, false]
+  use_escrow: [true, false]
+  product_options: [single, multi_option, bundle]
+  shipping_region: [domestic, jeju, remote_island]
+  shipping_policy: [free, fixed, range_based, conditional_free]
+  coupon_applied: [none, product, category, all]
+  rounding_unit: [1, 10, 100]
+
+# 의미 없는 조합 컷 — 사유 명시 필수
+exclusions:
+  - { payment_method: virtual_account, easy_pay: kakaopay, reason: "가상계좌는 간편결제와 동시 적용 불가" }
+  - { payment_method: virtual_account, use_escrow: true, easy_pay: naverpay, reason: "에스크로 가상계좌는 간편결제 비대상" }
+  - { easy_pay: applepay, payment_method: bank_transfer, reason: "간편결제는 카드 결제 수단으로만 진입" }
+  - { easy_pay: applepay, payment_method: virtual_account, reason: "간편결제는 카드 결제 수단으로만 진입" }
+  - { easy_pay: applepay, payment_method: mobile, reason: "간편결제는 카드 결제 수단으로만 진입" }
+  - { user_type: guest, easy_pay: naverpay, reason: "비회원은 간편결제 미지원" }
+
+# 후속 효과 체인 — 결제 후 모든 부수효과
+effects:
+  - auth_callback_received
+  - signature_verified
+  - mid_matched
+  - server_authorize_called
+  - payment_completed              # card / mobile / easy_pay
+  - vbank_issued                   # virtual_account 1단계
+  - vbank_notification_received    # virtual_account 2단계
+  - vbank_deposit_completed        # ResultCode 4110
+  - notification_sent_to_user
+  - notification_amount_matches_total
+  - vat_calculated
+  - tax_free_amount_split
+  - coupon_marked_used
+  - inventory_decremented
+  - order_status_transitioned_to_paid
+
+# 보조 흐름 — 취소/환불/통보 등
+sub_flows:
+  - id: partial_cancel_card
+    description: 카드 결제 부분 취소 (CancelAmt < 원결제 금액)
+    effects:
+      - before_cancel_hook_invoked     # plugin action hook
+      - cancel_api_called
+      - after_cancel_hook_invoked
+      - shipping_policy_recalculated
+      - discount_recalculated
+      - mileage_partial_refunded
+      - vat_recalculated
+
+  - id: full_cancel_card
+    description: 카드 결제 전액 취소
+    effects:
+      - before_cancel_hook_invoked
+      - payment_voided
+      - after_cancel_hook_invoked
+      - mileage_fully_refunded
+      - coupon_unused
+      - inventory_restored
+      - order_status_transitioned_to_cancelled
+
+  - id: vbank_refund_after_deposit
+    description: 입금 완료된 가상계좌 환불 (관리자 경로 — 환불 계좌 정보 필수)
+    effects:
+      - admin_refund_endpoint_called
+      - refund_account_validated
+      - cancel_api_called_with_bank_info
+      - vat_recalculated
+      - order_status_transitioned_to_cancelled
+
+  - id: user_cancel_at_pg_dialog
+    description: 사용자가 결제창에서 '취소' 또는 '종료' 선택 (AuthResultCode != '0000')
+    effects:
+      - redirect_to_checkout_without_error_query
+      - no_payment_record_created
+
+  - id: vbank_repeat_notification
+    description: 동일 TID 입금 통보 재발송 시 중복 처리 방지
+    effects:
+      - row_lock_acquired
+      - already_paid_short_circuited
+      - ok_response_returned
+
+notes: |
+  이 매니페스트는 예시이며 실제 채택 시 다음을 갱신하세요:
+   1. test_files 경로
+   2. axes 값 목록 (특히 easy_pay 는 plugin.json easy_pay_* 설정과 동기)
+   3. effects 명명 (테스트 docblock @effects 와 1:1 매칭)
+   4. before_cancel / after_cancel 훅은 sirsoft-pay_nicepayments.payment.before_cancel / after_cancel
+  pairwise 전략 케이스 수: 약 30~40 (full 일 경우 2*4*9*2*2*3*3*4*4*3 = 41,472)
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/tests/scenarios/security-callback-defense.yaml b/plugins/_bundled/sirsoft-pay_nicepayments/tests/scenarios/security-callback-defense.yaml
new file mode 100644
index 00000000..9f5eaa89
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/tests/scenarios/security-callback-defense.yaml
@@ -0,0 +1,95 @@
+# audit:allow test-scenario-coverage reason: Phase 2 SSoT — 본 매니페스트는 나이스페이먼츠 콜백 보안 매트릭스의 명세 문서. AuthToken Cache 기반 dedupe 와 replay/net-cancel 의 cross product 전체 자동 검증은 Phase 3 (침투 PoC) 에서 처리.
+
+feature: 콜백 보안 방어 (replay attack / authToken dedupe / post-approve net cancel)
+
+description: |
+  나이스페이먼츠 결제 콜백 처리 경로의 3가지 핵심 보안 위협에 대한 방어 매트릭스.
+
+  방어 대상 위협:
+    1. Replay attack (DB 영구) — 동일 transaction_id (TxTid) 로 콜백 재전송 시 두 번
+       결제 처리되어 알림/마일리지/재고 중복. PreventsReplayCallback trait +
+       DB unique index (ecommerce module beta.5) 로 영구 방어.
+    2. AuthToken replay (단기) — 동일 AuthToken+TxTid 가 60초 안에 재전송되면
+       정상 결제 흐름의 race condition / 의도된 재시도가 아니라 replay 의심.
+       CacheInterface 60초 TTL dedupe 키로 단기 윈도우 방어.
+    3. Post-approve 실패 시 net cancel 누락 — server-side 승인 성공 후 도메인 처리
+       (금액 검증, 주문 상태 전이) 가 실패하면 PG 측은 승인 상태이지만 G7 주문은 미생성.
+       sendNetCancel() 헬퍼로 PG 승인 자동 취소.
+
+axes:
+  context: [authorize_card, authorize_vbank, naverpay_callback, kakaopay_callback]
+  threat: [replay_db_long, replay_token_short, post_approve_failure]
+  callback_state: [first_arrival, second_arrival_outside_60s, second_arrival_within_60s, domain_succeeds, domain_fails]
+
+exclusions:
+  - { threat: replay_db_long, callback_state: domain_succeeds, reason: "replay 는 domain 처리 이전 단계" }
+  - { threat: replay_db_long, callback_state: domain_fails, reason: "replay 는 domain 처리 이전 단계" }
+  - { threat: replay_db_long, callback_state: second_arrival_within_60s, reason: "60s 윈도우는 token replay 단계 — DB 영구 분기와 중복 불필요" }
+  - { threat: replay_token_short, callback_state: domain_succeeds, reason: "token dedupe 는 domain 이전 단계" }
+  - { threat: replay_token_short, callback_state: domain_fails, reason: "token dedupe 는 domain 이전 단계" }
+  - { threat: replay_token_short, callback_state: second_arrival_outside_60s, reason: "60s 외 재전송은 token dedupe 가 아닌 DB 영구 분기로 처리" }
+  - { threat: replay_token_short, context: authorize_vbank, reason: "vbank 통보는 authToken 발급 없음 — token dedupe 무관" }
+  - { threat: post_approve_failure, callback_state: first_arrival, reason: "post-approve 실패는 도메인 결과 분기" }
+  - { threat: post_approve_failure, callback_state: second_arrival_outside_60s, reason: "post-approve 실패는 도메인 결과 분기" }
+  - { threat: post_approve_failure, callback_state: second_arrival_within_60s, reason: "post-approve 실패는 도메인 결과 분기" }
+  - { threat: post_approve_failure, context: authorize_vbank, reason: "vbank 는 비동기 입금 — post-approve 단계 없음" }
+
+effects:
+  # DB 영구 replay defense — PreventsReplayCallback trait
+  - replay_detected_on_second_arrival_db
+  - replay_response_is_idempotent_ok
+  - replay_no_double_completion
+  - replay_logged_with_context
+  - replay_first_arrival_proceeds_normally
+  - replay_db_unique_blocks_concurrent_insert
+
+  # 단기 AuthToken dedupe — CacheInterface 60s TTL
+  - auth_token_first_arrival_writes_cache
+  - auth_token_within_60s_blocked
+  - auth_token_outside_60s_proceeds
+  - auth_token_cache_key_uses_sha256_of_mid_token_txtid
+  - auth_token_blocked_returns_4xx_or_idempotent
+  - auth_token_logged_when_dedupe_hit
+
+  # Post-approve net cancel
+  - post_approve_failure_triggers_send_net_cancel
+  - net_cancel_sends_pg_cancel_api_call
+  - net_cancel_uses_browser_fetch_to_bypass_interceptor
+  - net_cancel_passes_approved_tid
+  - net_cancel_passes_full_amount
+
+test_files: []
+
+manual_verification:
+  - description: "Replay DB 영구 PoC — authorize_card 재전송"
+    steps:
+      - "정상 카드 결제 콜백 1차 → 200 OK, payment_status=paid"
+      - "1시간 후 동일 TxTid 페이로드 재전송 → 200 OK (멱등)"
+      - "Log 에 'NicePayments: replay detected' 확인"
+      - "DB: g7_ecommerce_order_payments 에 동일 transaction_id row 1건만 존재"
+  - description: "AuthToken 단기 dedupe PoC — 60초 내 재시도"
+    steps:
+      - "정상 카드 결제 콜백 1차 (AuthToken=AT001, TxTid=TX001) → 200 OK"
+      - "10초 후 동일 AuthToken+TxTid 재전송 → 차단 (4xx 또는 idempotent)"
+      - "Cache key nicepay_auth_token_seen:sha256(mid:AT001:TX001) 존재 확인"
+      - "61초 후 재전송 → Cache TTL 만료 → DB 영구 분기로 처리 (정상 replay 차단)"
+  - description: "Post-approve 실패 net cancel PoC"
+    steps:
+      - "정상 카드 콜백으로 authorize 진입"
+      - "PG 승인 성공 (resultCode=0000), TxTid 발급됨"
+      - "이후 OrderProcessingService 가 PaymentAmountMismatchException throw 시뮬"
+      - "sendNetCancel 가 browserFetch(__sirsoftPgOriginalFetch) 로 PG 취소 API 호출"
+      - "PG 측 거래 상태: 승인 후 취소 (정산 영향 없음)"
+      - "G7 주문: 미생성 상태 유지"
+
+notes: |
+  본 매니페스트는 Phase 2 보안 강화 작업의 SSoT.
+
+  관련 코드:
+   - src/Concerns/PreventsReplayCallback.php (DB 영구 replay 가드)
+   - src/Controllers/PaymentCallbackController.php (authorize + AuthToken Cache dedupe + sendNetCancel)
+
+  관련 modules (참고 — plugin scope 외):
+   - modules/_bundled/sirsoft-ecommerce/database/migrations/2026_05_16_000001_add_unique_index_to_transaction_id_on_ecommerce_order_payments_table.php
+
+  Phase 3 침투 PoC 에서 본 manual_verification 항목을 자동화 PoC 스크립트로 변환 예정.
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/tsconfig.json b/plugins/_bundled/sirsoft-pay_nicepayments/tsconfig.json
new file mode 100644
index 00000000..f50d72bd
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/tsconfig.json
@@ -0,0 +1,18 @@
+{
+    "compilerOptions": {
+        "target": "ES2020",
+        "module": "ESNext",
+        "lib": ["ES2020", "DOM", "DOM.Iterable"],
+        "strict": true,
+        "moduleResolution": "bundler",
+        "noEmit": true,
+        "noUnusedLocals": true,
+        "noUnusedParameters": true,
+        "noFallthroughCasesInSwitch": true,
+        "baseUrl": ".",
+        "paths": {
+            "@/*": ["resources/js/*"]
+        }
+    },
+    "include": ["resources/js/**/*.ts"]
+}
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/vite.config.ts b/plugins/_bundled/sirsoft-pay_nicepayments/vite.config.ts
new file mode 100644
index 00000000..64776032
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/vite.config.ts
@@ -0,0 +1,27 @@
+import { defineConfig } from 'vite';
+import { resolve } from 'path';
+
+export default defineConfig({
+    build: {
+        lib: {
+            entry: resolve(__dirname, 'resources/js/index.ts'),
+            name: 'SirsoftNicepayments',
+            formats: ['iife'],
+        },
+        outDir: 'dist',
+        rollupOptions: {
+            output: {
+                entryFileNames: 'js/plugin.iife.js',
+            },
+        },
+        sourcemap: true,
+        minify: 'esbuild',
+        target: 'es2020',
+        chunkSizeWarningLimit: 500,
+    },
+    resolve: {
+        alias: {
+            '@': resolve(__dirname, 'resources/js'),
+        },
+    },
+});
diff --git a/plugins/_bundled/sirsoft-pay_nicepayments/vitest.config.ts b/plugins/_bundled/sirsoft-pay_nicepayments/vitest.config.ts
new file mode 100644
index 00000000..b66c6912
--- /dev/null
+++ b/plugins/_bundled/sirsoft-pay_nicepayments/vitest.config.ts
@@ -0,0 +1,17 @@
+import { defineConfig } from 'vitest/config';
+import path from 'path';
+
+export default defineConfig({
+    test: {
+        globals: true,
+        environment: 'jsdom',
+        include: ['resources/js/**/*.{test,spec}.{ts,tsx}'],
+        exclude: ['node_modules/', 'dist/'],
+    },
+    resolve: {
+        alias: {
+            '@': path.resolve(__dirname, 'resources/js'),
+            '@core': path.resolve(__dirname, '../../resources/js/core'),
+        },
+    },
+});