Saleor Webhook 동기 이벤트
동기(Sync) 이벤트는 Saleor가 App의 HTTP 응답을 기다린 후 결과를 플로우에 반영한다. 커스터마이징에서 가장 중요한 확장 포인트다. 총 22개.
세금 계산 (HANDLE_TAXES)
Saleor 내장 세금 계산을 완전히 교체할 수 있다. 응답이 없으면 내장 계산으로 fallback.
| 이벤트 | 제어 범위 |
|---|---|
CHECKOUT_CALCULATE_TAXES | Checkout 세금 전체를 App이 계산하여 덮어씀 |
ORDER_CALCULATE_TAXES | Order 세금 전체를 App이 계산하여 덮어씀 |
결제 - Transaction API (HANDLE_PAYMENTS)
한국 PG 연동의 핵심. 결제 흐름 전체를 App이 소유한다.
| 이벤트 | 역할 |
|---|---|
PAYMENT_GATEWAY_INITIALIZE_SESSION | 게이트웨이 초기화 (SDK 토큰 발급 등) |
TRANSACTION_INITIALIZE_SESSION | 결제 시작, 초기 상태 반환 |
TRANSACTION_PROCESS_SESSION | 결제 결과 검증 후 상태 확정 |
TRANSACTION_CHARGE_REQUESTED | PSP에 charge 요청 처리 |
TRANSACTION_REFUND_REQUESTED | PSP에 refund 요청 처리 |
TRANSACTION_CANCELATION_REQUESTED | PSP에 cancel 요청 처리 |
배송 방법 (MANAGE_SHIPPING)
외부 물류 API를 Saleor DB 없이 동적으로 연결할 수 있다.
| 이벤트 | 역할 |
|---|---|
SHIPPING_LIST_METHODS_FOR_CHECKOUT | 외부 배송 옵션을 동적으로 추가 |
CHECKOUT_FILTER_SHIPPING_METHODS | 조건부로 배송 옵션 제거 |
ORDER_FILTER_SHIPPING_METHODS | Order 단계 배송 필터링 |
저장 결제 수단 (HANDLE_PAYMENTS)
| 이벤트 | 역할 |
|---|---|
LIST_STORED_PAYMENT_METHODS | PSP의 저장 카드 목록 반환 |
STORED_PAYMENT_METHOD_DELETE_REQUESTED | 저장 카드 삭제 처리 |
결제 토큰화 (HANDLE_PAYMENTS)
| 이벤트 | 역할 |
|---|---|
PAYMENT_GATEWAY_INITIALIZE_TOKENIZATION_SESSION | 토큰화 세션 초기화 |
PAYMENT_METHOD_INITIALIZE_TOKENIZATION_SESSION | 결제 수단 토큰화 시작 |
PAYMENT_METHOD_PROCESS_TOKENIZATION_SESSION | 토큰화 완료 처리 |
레거시 Payment Plugin (HANDLE_PAYMENTS, deprecated)
PAYMENT_AUTHORIZE, PAYMENT_CAPTURE, PAYMENT_CONFIRM, PAYMENT_PROCESS, PAYMENT_REFUND, PAYMENT_VOID, PAYMENT_LIST_GATEWAYS — 신규 구현에서는 Transaction API 사용 권장.