Commerce
서비스형 SaaS를 위한 light-tier 커머스 플러그인입니다. 상품·주문·단건결제·정기결제·인보이스·환불·쿠폰·결제 이력을 표준화합니다. 복잡한 옵션·SKU·배송·재고·마켓플레이스가 필요하면 LunarCommerce를 사용합니다.
상태
| 항목 | 값 |
|---|---|
| Layer | existing |
| Tier | Business |
| Status | released |
| Version | 1.15.1 |
| 가격 | Free (one_time) |
| 카테고리 | Commerce & Billing |
주요 기능
- user/SaaS/Tenant 3축으로 격리 된 빌링키 정기결제
- 원자적·멱등 webhook 원장과 provider-managed 구독
- Smartro 등 PG adapter를 통한 단건결제·가상계좌·영수증·환불
- PG 승인 후 로컬 검증이 거부된 주문의
PG 확인 필요표시와 승인분 취소 복구 - 외부 PG 결제 실패와 승인 미정합을 구분하는 사이트 운영자 알림
- SaaS/Tenant 관리 패널과 한국어·영어·일본어·중국어 관리 UI
PG 승인 후 로컬 거부 복구
PG는 승인했지만 주문번호·금액·MID·서명·채널 검증이 실패하면 Commerce는 주문을 결제완료로 바꾸지 않습니다. 승인 TID와 금액을 보존하고 관리 화면에 PG 확인 필요를 표시합니다.
운영자는 PG 승인분 취소를 통해 PG에만 남은 승인분을 취소할 수 있습니다. 이 조치는 성공 결제를 되돌리는 일반 환불과 별도이며, step-up 인증과 감사로그가 적용됩니다.
자세한 절차는 Commerce 관리자 가이드를 참고하세요.
PG 결제 실패 운영자 알림
외부 PG의 일반 결제 실패를 이메일·웹훅·텔레그램·카카오 알림톡 같은 사이트 운영 채널로 받을 수 있습니다. 이 알림은 기본적으로 꺼져 있으며, 사이트별로 명시적으로 활성화해야 합니다.
- 관리 패널의 사이트 설정 > 운영자 알림에서 채널을 등록합니다.
- 이벤트 목록에서 PG 결제 실패(
operator.payment_failed)를 켭니다. - 발송할 채널을 선택하고 저장한 뒤 테스트 발송으로 설정을 확인합니다.
지갑 잔액 부족과 고객의 결제창 닫기는 이 이벤트에서 제외됩니다. PG 승인 후 로컬 검증이 거부된 거래는 PG 승인 거래 확인 필요(operator.payment_unreconciled)로만 알리므로 같은 거래가 두 이벤트로 중복 발송되지 않습니다.
알림에는 사이트명·주문번호·PG·금액·통화·정규화한 오류코드와 사유만 포함합니다. 원본 PG 응답, TID, 서명값, 빌링 토큰은 일반 실패 알림에 포함하지 않습니다. 각 채널은 독립적으로 재시도하므로 한 채널의 일시 장애가 다른 채널 발송을 막지 않습니다.
세부 운영 절차는 Commerce 관리자 가이드를 참고하세요.
제외 범위
다중 옵션, SKU, 배송, 재고, 리뷰, 위시리스트, 마켓플레이스, 복잡한 B2B 견적은 범위 밖입니다. 이런 요구에는 LunarCommerce를 사용합니다.
라이선스
MIT
🛒 Plugin Store에서 보기: store.codebase.how/plugins/commerce