Saleor Webhook 비동기 이벤트
비동기(Async) 이벤트는 fire-and-forget 방식이다. Saleor가 응답을 기다리지 않으므로 흐름을 차단하거나 수정할 수 없다. 후처리(알림, 동기화, 로깅)에 사용한다. 약 107개.
도메인별 이벤트 수
| 도메인 | 이벤트 수 | 주요 이벤트 |
|---|---|---|
| Order | 15 | ORDER_CREATED/CONFIRMED/PAID/FULLY_PAID/CANCELLED/FULFILLED |
| Product/Variant | 17 | PRODUCT_CREATED/UPDATED/DELETED, VARIANT_OUT_OF_STOCK/BACK_IN_STOCK |
| Account/User | 11 | CUSTOMER_CREATED, ACCOUNT_CONFIRMATION_REQUESTED |
| Checkout | 5 | CHECKOUT_CREATED/UPDATED/FULLY_PAID |
| Fulfillment | 5 | FULFILLMENT_CREATED/CANCELED/TRACKING_NUMBER_UPDATED |
| Discount/Promotion | 18 | PROMOTION_CREATED/STARTED/ENDED, VOUCHER_CREATED |
| Channel | 5 | CHANNEL_CREATED/UPDATED/STATUS_CHANGED |
| Shipping | 6 | SHIPPING_PRICE_CREATED, SHIPPING_ZONE_CREATED |
| Invoice | 3 | INVOICE_REQUESTED/DELETED/SENT |
| Collection/Category | 7 | COLLECTION_CREATED, CATEGORY_CREATED |
| Staff/Permission | 6 | STAFF_CREATED, PERMISSION_GROUP_CREATED |
| 기타 | 9+ | APP_INSTALLED, GIFT_CARD_SENT, THUMBNAIL_CREATED |
Deferred Payload
Order 관련 14개, Checkout 2개는 is_deferred_payload: True로 payload 생성 자체도 비동기 큐에서 처리된다. 고부하 환경에서 API 응답 속도 보호 목적.
커스터마이징 관점
비동기 이벤트는 흐름을 변경할 수 없고 관찰만 가능하다. 한국형 커스터마이징에서의 용도:
ORDER_CREATED→ 외부 ERP/WMS 동기화INVOICE_REQUESTED→ 세금계산서 발행 App 트리거FULFILLMENT_TRACKING_NUMBER_UPDATED→ 배송추적 알림PRODUCT_VARIANT_OUT_OF_STOCK→ 재입고 알림CHECKOUT_FULLY_PAID→ 결제 완료 알림톡 발송