@sayren/store-sdk 0.15.0 → 0.16.0

package/dist/index.d.mts

@@ -921,8 +921,8 @@ export declare const oauthClientRegistrationRequestSchema: z.ZodObject<{
   }>>;
   redirect_uris: z.ZodOptional<z.ZodArray<z.ZodString>>;
   grant_types: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-    authorization_code: "authorization_code";
     refresh_token: "refresh_token";
+    authorization_code: "authorization_code";
     client_credentials: "client_credentials";
     "urn:ietf:params:oauth:grant-type:token-exchange": "urn:ietf:params:oauth:grant-type:token-exchange";
   }>>>;
@@ -2272,6 +2272,7 @@ export declare const eventTypeSchema: z.ZodEnum<{
   "ORDER.DELIVERED": "ORDER.DELIVERED";
   "ORDER.PURCHASE_DECIDED": "ORDER.PURCHASE_DECIDED";
   "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
+  "ORDER.CANCELED": "ORDER.CANCELED";
   "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
   "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
   "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
@@ -2296,6 +2297,7 @@ export declare const webhookSchema: z.ZodObject<{
     "ORDER.DELIVERED": "ORDER.DELIVERED";
     "ORDER.PURCHASE_DECIDED": "ORDER.PURCHASE_DECIDED";
     "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
+    "ORDER.CANCELED": "ORDER.CANCELED";
     "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
     "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
     "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
@@ -2324,6 +2326,7 @@ export declare const webhookCreatedSchema: z.ZodObject<{
     "ORDER.DELIVERED": "ORDER.DELIVERED";
     "ORDER.PURCHASE_DECIDED": "ORDER.PURCHASE_DECIDED";
     "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
+    "ORDER.CANCELED": "ORDER.CANCELED";
     "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
     "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
     "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
@@ -2402,6 +2405,7 @@ export declare const webhookDeliverySchema: z.ZodObject<{
     "ORDER.DELIVERED": "ORDER.DELIVERED";
     "ORDER.PURCHASE_DECIDED": "ORDER.PURCHASE_DECIDED";
     "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
+    "ORDER.CANCELED": "ORDER.CANCELED";
     "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
     "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
     "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
@@ -2453,6 +2457,7 @@ export declare const webhookDeliveryDetailSchema: z.ZodObject<{
     "ORDER.DELIVERED": "ORDER.DELIVERED";
     "ORDER.PURCHASE_DECIDED": "ORDER.PURCHASE_DECIDED";
     "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
+    "ORDER.CANCELED": "ORDER.CANCELED";
     "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
     "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
     "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
@@ -2513,6 +2518,7 @@ export declare const webhookDeliveryListQuerySchema: z.ZodObject<{
     "ORDER.DELIVERED": "ORDER.DELIVERED";
     "ORDER.PURCHASE_DECIDED": "ORDER.PURCHASE_DECIDED";
     "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
+    "ORDER.CANCELED": "ORDER.CANCELED";
     "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
     "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
     "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
@@ -2538,6 +2544,7 @@ export declare const webhookTestRequestSchema: z.ZodObject<{
     "ORDER.DELIVERED": "ORDER.DELIVERED";
     "ORDER.PURCHASE_DECIDED": "ORDER.PURCHASE_DECIDED";
     "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
+    "ORDER.CANCELED": "ORDER.CANCELED";
     "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
     "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
     "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
@@ -2577,6 +2584,7 @@ export declare const webhookRequestSchema: z.ZodObject<{
     "ORDER.DELIVERED": "ORDER.DELIVERED";
     "ORDER.PURCHASE_DECIDED": "ORDER.PURCHASE_DECIDED";
     "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
+    "ORDER.CANCELED": "ORDER.CANCELED";
     "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
     "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
     "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
@@ -7423,7 +7431,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     list: () => Promise<{
       webhookId: string;
       url: string;
-      eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK")[];
+      eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK")[];
       status: "ACTIVE" | "SUSPENDED";
       secretPrefix: string;
       suspendedAt: string | null;
@@ -7433,7 +7441,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     create: (body: WebhookRequest) => Promise<{
       webhookId: string;
       url: string;
-      eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK")[];
+      eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK")[];
       status: "ACTIVE" | "SUSPENDED";
       secretPrefix: string;
       suspendedAt: string | null;
@@ -7443,7 +7451,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     get: (webhookId: string) => Promise<{
       webhookId: string;
       url: string;
-      eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK")[];
+      eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK")[];
       status: "ACTIVE" | "SUSPENDED";
       secretPrefix: string;
       suspendedAt: string | null;
@@ -7453,7 +7461,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     update: (webhookId: string, body: WebhookRequest) => Promise<{
       webhookId: string;
       url: string;
-      eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK")[];
+      eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK")[];
       status: "ACTIVE" | "SUSPENDED";
       secretPrefix: string;
       suspendedAt: string | null;
@@ -7468,7 +7476,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     resume: (webhookId: string) => Promise<{
       webhookId: string;
       url: string;
-      eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK")[];
+      eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK")[];
       status: "ACTIVE" | "SUSPENDED";
       secretPrefix: string;
       suspendedAt: string | null;
@@ -7478,7 +7486,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     listDeliveries: (webhookId: string, params?: WebhookDeliveryListParams) => Promise<{
       deliveryId: string;
       eventId: string;
-      eventType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK";
+      eventType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK";
       url: string;
       status: "PENDING" | "PENDING_RETRY" | "SUCCESS" | "FAILED";
       responseStatusCode: number | null;
@@ -7505,7 +7513,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     getDelivery: (webhookId: string, deliveryId: string) => Promise<{
       deliveryId: string;
       eventId: string;
-      eventType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK";
+      eventType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK";
       url: string;
       status: "PENDING" | "PENDING_RETRY" | "SUCCESS" | "FAILED";
       responseStatusCode: number | null;
@@ -7540,7 +7548,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     redeliver: (webhookId: string, deliveryId: string) => Promise<{
       deliveryId: string;
       eventId: string;
-      eventType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK";
+      eventType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK";
       url: string;
       status: "PENDING" | "PENDING_RETRY" | "SUCCESS" | "FAILED";
       responseStatusCode: number | null;
@@ -8507,6 +8515,43 @@ export declare const orderWebhookEventDataSchema: z.ZodObject<{
   testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, z.core.$strip>;
 export type OrderWebhookEventData = z.infer<typeof orderWebhookEventDataSchema>;
+/**
+ * `ORDER.CANCELED` — 셀러 직권취소(`POST /v1/order-items/{orderItemId}/cancel`)로 주문상품이 취소됐다.
+ * 수량 단위 부분 취소도 이 이벤트다(`quantity` < 주문 수량이면 주문상품 상태가 그대로다).
+ * 구매자가 신청한 취소·반품은 `CLAIM.*` 이벤트로 온다.
+ */
+export declare const orderCanceledWebhookEventDataSchema: z.ZodObject<{
+  orderId: z.ZodString;
+  orderItemId: z.ZodString;
+  status: z.ZodEnum<{
+    PAID: "PAID";
+    CANCELED: "CANCELED";
+    PAYMENT_WAITING: "PAYMENT_WAITING";
+    CONFIRMED: "CONFIRMED";
+    DISPATCHED: "DISPATCHED";
+    DELIVERING: "DELIVERING";
+    DELIVERED: "DELIVERED";
+    PURCHASE_DECIDED: "PURCHASE_DECIDED";
+  }>;
+  itemStatus: z.ZodEnum<{
+    PAID: "PAID";
+    CANCELED: "CANCELED";
+    PAYMENT_WAITING: "PAYMENT_WAITING";
+    CONFIRMED: "CONFIRMED";
+    DISPATCHED: "DISPATCHED";
+    DELIVERING: "DELIVERING";
+    DELIVERED: "DELIVERED";
+    PURCHASE_DECIDED: "PURCHASE_DECIDED";
+  }>;
+  reason: z.ZodString;
+  quantity: z.ZodNumber;
+  canceledQuantity: z.ZodNumber;
+  refundAmount: z.ZodNumber;
+  deliveryFeeRefundAmount: z.ZodNumber;
+  deliveryFeeChargeAmount: z.ZodNumber;
+  testPayment: z.ZodBoolean;
+}, z.core.$strip>;
+export type OrderCanceledWebhookEventData = z.infer<typeof orderCanceledWebhookEventDataSchema>;
 export declare const claimWebhookEventDataSchema: z.ZodObject<{
   claimId: z.ZodString;
   orderId: z.ZodString;
@@ -8578,6 +8623,43 @@ export declare const orderWebhookEventSchema: z.ZodObject<{
   createdAt: z.ZodString;
   storeId: z.ZodString;
 }, z.core.$strip>;
+export declare const orderCanceledWebhookEventSchema: z.ZodObject<{
+  type: z.ZodLiteral<"ORDER.CANCELED">;
+  data: z.ZodObject<{
+    orderId: z.ZodString;
+    orderItemId: z.ZodString;
+    status: z.ZodEnum<{
+      PAID: "PAID";
+      CANCELED: "CANCELED";
+      PAYMENT_WAITING: "PAYMENT_WAITING";
+      CONFIRMED: "CONFIRMED";
+      DISPATCHED: "DISPATCHED";
+      DELIVERING: "DELIVERING";
+      DELIVERED: "DELIVERED";
+      PURCHASE_DECIDED: "PURCHASE_DECIDED";
+    }>;
+    itemStatus: z.ZodEnum<{
+      PAID: "PAID";
+      CANCELED: "CANCELED";
+      PAYMENT_WAITING: "PAYMENT_WAITING";
+      CONFIRMED: "CONFIRMED";
+      DISPATCHED: "DISPATCHED";
+      DELIVERING: "DELIVERING";
+      DELIVERED: "DELIVERED";
+      PURCHASE_DECIDED: "PURCHASE_DECIDED";
+    }>;
+    reason: z.ZodString;
+    quantity: z.ZodNumber;
+    canceledQuantity: z.ZodNumber;
+    refundAmount: z.ZodNumber;
+    deliveryFeeRefundAmount: z.ZodNumber;
+    deliveryFeeChargeAmount: z.ZodNumber;
+    testPayment: z.ZodBoolean;
+  }, z.core.$strip>;
+  id: z.ZodString;
+  createdAt: z.ZodString;
+  storeId: z.ZodString;
+}, z.core.$strip>;
 export declare const claimWebhookEventSchema: z.ZodObject<{
   type: z.ZodEnum<{
     "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
@@ -8674,6 +8756,42 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   id: z.ZodString;
   createdAt: z.ZodString;
   storeId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"ORDER.CANCELED">;
+  data: z.ZodObject<{
+    orderId: z.ZodString;
+    orderItemId: z.ZodString;
+    status: z.ZodEnum<{
+      PAID: "PAID";
+      CANCELED: "CANCELED";
+      PAYMENT_WAITING: "PAYMENT_WAITING";
+      CONFIRMED: "CONFIRMED";
+      DISPATCHED: "DISPATCHED";
+      DELIVERING: "DELIVERING";
+      DELIVERED: "DELIVERED";
+      PURCHASE_DECIDED: "PURCHASE_DECIDED";
+    }>;
+    itemStatus: z.ZodEnum<{
+      PAID: "PAID";
+      CANCELED: "CANCELED";
+      PAYMENT_WAITING: "PAYMENT_WAITING";
+      CONFIRMED: "CONFIRMED";
+      DISPATCHED: "DISPATCHED";
+      DELIVERING: "DELIVERING";
+      DELIVERED: "DELIVERED";
+      PURCHASE_DECIDED: "PURCHASE_DECIDED";
+    }>;
+    reason: z.ZodString;
+    quantity: z.ZodNumber;
+    canceledQuantity: z.ZodNumber;
+    refundAmount: z.ZodNumber;
+    deliveryFeeRefundAmount: z.ZodNumber;
+    deliveryFeeChargeAmount: z.ZodNumber;
+    testPayment: z.ZodBoolean;
+  }, z.core.$strip>;
+  id: z.ZodString;
+  createdAt: z.ZodString;
+  storeId: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
   type: z.ZodEnum<{
     "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";

package/dist/index.mjs

@@ -1357,6 +1357,7 @@ const eventTypeSchema = z.enum([
 	"ORDER.DELIVERED",
 	"ORDER.PURCHASE_DECIDED",
 	"ORDER.ADDRESS_CHANGE_REQUESTED",
+	"ORDER.CANCELED",
 	"CLAIM.CANCEL_REQUESTED",
 	"CLAIM.RETURN_REQUESTED",
 	"CLAIM.EXCHANGE_REQUESTED",
@@ -1364,7 +1365,7 @@ const eventTypeSchema = z.enum([
 	"INQUIRY.CREATED",
 	"REVIEW.CREATED",
 	"PRODUCT.OUT_OF_STOCK"
-]);
+]).describe("웹훅 이벤트 타입. `ORDER.ADDRESS_CHANGE_REQUESTED`는 현재 발송하지 않음(호환을 위해 값만 남았고, 구독해도 이벤트가 오지 않는다)");
 const webhookStatusSchema = z.enum(["ACTIVE", "SUSPENDED"]).describe("구독 상태. `ACTIVE`=발송 대상, `SUSPENDED`=24시간 이상 연속 전송 실패로 발송이 정지된 상태. 정지 중 발생한 이벤트는 적재하지 않는다. 재개(`POST /webhooks/{id}/resume`)하거나 구독을 수정하면 ACTIVE로 돌아간다");
 const webhookSchema = z.object({
 	webhookId: z.string(),
@@ -3992,6 +3993,24 @@ const orderWebhookEventDataSchema = z.object({
 	status: orderItemStatusSchema.describe("이벤트 발생 시점의 주문 대표 상태"),
 	testPayment: z.boolean().optional().default(false).describe("테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았다. 이 필드가 없는 이전 이벤트는 false로 읽는다")
 });
+/**
+* `ORDER.CANCELED` — 셀러 직권취소(`POST /v1/order-items/{orderItemId}/cancel`)로 주문상품이 취소됐다.
+* 수량 단위 부분 취소도 이 이벤트다(`quantity` < 주문 수량이면 주문상품 상태가 그대로다).
+* 구매자가 신청한 취소·반품은 `CLAIM.*` 이벤트로 온다.
+*/
+const orderCanceledWebhookEventDataSchema = z.object({
+	orderId: z.string().describe("주문 ID"),
+	orderItemId: z.string().describe("취소한 주문 상품 ID"),
+	status: orderItemStatusSchema.describe("취소 뒤 주문 대표 상태. 모든 주문 상품이 취소됐으면 `CANCELED`다"),
+	itemStatus: orderItemStatusSchema.describe("취소 뒤 주문 상품 상태. 전 수량이 취소됐으면 `CANCELED`, 일부만 취소했으면 원래 상태다"),
+	reason: z.string().describe("취소 사유 코드 — 판매자 취소 요청의 `reason`(`OUT_OF_STOCK`·`PRICE_ERROR`·`DELIVERY_IMPOSSIBLE`·`ETC`). 사유가 늘어날 수 있어 문자열이다. 모르는 값은 `ETC`처럼 다룬다"),
+	quantity: z.number().int().describe("이번에 취소한 수량"),
+	canceledQuantity: z.number().int().describe("취소 후 누적 취소 수량"),
+	refundAmount: z.number().int().describe("환불액 (원). 수량 비율 상품 금액 + 배송비 환불 − 조건부 무료배송 미달 차감이다. 결제사 환불 결과는 결제 내역(`GET /v1/payments/{paymentId}`)으로 확인한다"),
+	deliveryFeeRefundAmount: z.number().int().describe("환불액에 포함된 배송비 (원)"),
+	deliveryFeeChargeAmount: z.number().int().describe("환불액에서 뺀 배송비 (원) — 조건부 무료배송 기준 미달 차감"),
+	testPayment: z.boolean().describe("테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았다")
+});
 const claimWebhookEventDataSchema = z.object({
 	claimId: z.string().describe("클레임 ID"),
 	orderId: z.string().describe("주문 ID"),
@@ -4030,6 +4049,11 @@ const orderWebhookEventSchema = z.object({
 	]),
 	data: orderWebhookEventDataSchema
 });
+const orderCanceledWebhookEventSchema = z.object({
+	...envelopeFields,
+	type: z.literal("ORDER.CANCELED"),
+	data: orderCanceledWebhookEventDataSchema
+});
 const claimWebhookEventSchema = z.object({
 	...envelopeFields,
 	type: z.enum([
@@ -4058,6 +4082,7 @@ const productOutOfStockWebhookEventSchema = z.object({
 /** 웹훅 요청 본문. `type`으로 판별하며 `data` 형태가 타입별로 다르다 */
 const webhookEventSchema = z.discriminatedUnion("type", [
 	orderWebhookEventSchema,
+	orderCanceledWebhookEventSchema,
 	claimWebhookEventSchema,
 	inquiryWebhookEventSchema,
 	reviewWebhookEventSchema,
@@ -4213,4 +4238,4 @@ function createStoreSession(options) {
 	};
 }
 //#endregion
-export { APPROVAL_ALREADY_DECIDED_CODE, APPROVAL_REQUIRED_CODE, ApiError, ApprovalPendingError, CASH_RECEIPT_STATUS_VALUES, MAX_ANALYTICS_ALLOWED_ORIGINS, MAX_AUTO_TRANSITION_DAYS, MAX_OPTION_GROUPS, MAX_PRODUCT_IMAGES, MAX_VALUES_PER_GROUP, MAX_VARIANTS, MCP_TELEMETRY_MAX_RESULTS, PAYMENT_ROUTING_EXCLUSION_CODES, PORTONE_CHANNEL_NAME_MAX_LENGTH, PORTONE_MAX_CHANNELS, PORTONE_MIN_CHANNELS, REFUND_POLICY_DEFAULTS, REMOTE_AREA_ZIP_RANGES, RESERVED_STORE_CODES, SHIPPING_POLICY_DEFAULTS, STORE_CODE_PATTERN, STORE_ROLE_SCOPES, STORE_SCOPE_RESOURCES, STORE_SESSION_KEYS, TOSS_WIDGET_CLIENT_KEY_PATTERN, TOSS_WIDGET_KEY_MESSAGE, TOSS_WIDGET_SECRET_KEY_PATTERN, UPLOAD_PURPOSE_LIMITS, VARIANT_STOCK_EXCLUSIVE_MESSAGE, WEBHOOK_DEFAULT_TOLERANCE_SEC, WEBHOOK_DELIVERY_ID_HEADER, WEBHOOK_EVENT_ID_HEADER, WEBHOOK_EVENT_TYPE_HEADER, WEBHOOK_FAILURE_REASONS, WEBHOOK_HEADERS, WEBHOOK_PAYLOAD_EXCERPT_MAX_BYTES, WEBHOOK_RESOURCE_TYPES, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_USER_AGENT, addressChangeRequestListSchema, addressTypeSchema, agentPolicyDecisionSchema, analyticsChannelSchema, analyticsCheckoutOutcomeSchema, analyticsCheckoutSchema, analyticsDeviceRowSchema, analyticsDevicesSchema, analyticsFunnelStepSchema, analyticsOriginSchema, analyticsOverviewSchema, analyticsPagesQuerySchema, analyticsPagesSchema, analyticsProductRowSchema, analyticsProductSortSchema, analyticsProductsQuerySchema, analyticsProductsSchema, analyticsRangeQuerySchema, analyticsRealtimeSchema, analyticsSearchQuerySchema, analyticsSearchSchema, analyticsSourceGroupBySchema, analyticsSourceRowSchema, analyticsSourcesQuerySchema, analyticsSourcesSchema, analyticsTotalsSchema, apiClientListQuerySchema, apiClientSchema, apiClientSecretRotatedSchema, apiClientStatusSchema, apiClientTypeSchema, apiLogErrorSchema, apiLogListQuerySchema, apiLogPageSchema, apiLogPrincipalSchema, apiLogPrincipalTypeSchema, apiLogSchema, apiLogStatusFilterSchema, apiLogSummarySchema, apiTokenCreateRequestSchema, apiTokenCreatedSchema, apiTokenSchema, approvalDecisionRequestSchema, approvalListQuerySchema, approvalPageSchema, approvalRequestSchema, approvalStatusSchema, approveClaimResultSchema, auditActorSchema, auditActorTypeSchema, auditLogListQuerySchema, auditLogOutcomeSchema, auditLogPageSchema, auditLogSchema, auditLogSourceSchema, buildAuthorizeUrl, buildQuery, bulkResultSchema, cancelBySellerRequestSchema, cancelBySellerResultSchema, carrierSchema, cashReceiptSchema, categoryAttributeSchema, categoryCreateRequestSchema, categoryDeleteQuerySchema, categoryDeleteStrategySchema, categoryListQuerySchema, categoryPatchRequestSchema, categoryProductSortSchema, categorySchema, categorySearchResultSchema, categoryTreeNodeSchema, categoryWithPathSchema, changeTypeSchema, claimDetailSchema, claimHoldResultSchema, claimListQuerySchema, claimReasonSchema, claimReturnAddressSchema, claimSchema, claimStatusSchema, claimTypeSchema, claimWebhookEventDataSchema, claimWebhookEventSchema, clientCredentialsTokenResponseSchema, consentActionSchema, consentKindSchema, consentSourceSchema, createPkcePair, createStoreClient, createStoreSession, customerAddressSchema, customerConsentListQuerySchema, customerConsentSchema, customerConsentStateSchema, customerConsentsSchema, customerDetailSchema, customerInquiryCategorySchema, customerInquiryListQuerySchema, customerListQuerySchema, customerOrderSchema, customerSortSchema, customerStatsSchema, customerSummarySchema, customerWithdrawalBlockedDetailsSchema, deliveryBundleKeyOf, deliveryFeeWaiverSchema, deliveryInfoSchema, deliveryMethodSchema, deliveryStatusSchema, deliveryTypeSchema, discountRequestSchema, discountSchema, dispatchRequestSchema, easyPayProviderResponseSchema, easyPayProviderSchema, eventTypeSchema, exchangeAuthorizationCode, exchangeStoreTokenViaOAuth, holdOrderItemRequestSchema, inquiryListQuerySchema, inquirySchema, inquiryWebhookEventDataSchema, inquiryWebhookEventSchema, invitationDeliveryStatusSchema, invitationListQuerySchema, invitationSchema, inviteMemberRequestSchema, isReservedStoreCode, isStoreScope, isWebOrigin, liveGateConditionCodeSchema, liveGateConditionSchema, liveGateErrorDetailsSchema, liveGateSchema, loginProviderSchema, loginProviderStatusSchema, loginProviderTestSchema, loginSettingsSchema, maskedSecretSchema, mcpRuleResultSchema, mcpToolEventSchema, myAccountSchema, myStoreSchema, oauthClientRegistrationRequestSchema, oauthClientRegistrationResponseSchema, oauthTokenResponseSchema, optionGroupRequestSchema, optionGroupSchema, optionModelRequestSchema, optionModelSchema, optionValueRequestSchema, optionValueSchema, orderItemListQuerySchema, orderItemMemoResultSchema, orderItemPageSchema, orderItemSchema, orderItemStatusSchema, orderListQuerySchema, orderSchema, orderSummaryPageSchema, orderSummarySchema, orderWebhookEventDataSchema, orderWebhookEventSchema, pageInfoSchema, pageQueryShape, pageSchema, paymentAttemptRecordSchema, paymentAttemptStatusSchema, paymentCredentialSetSchema, paymentListQuerySchema, paymentProviderSchema, paymentProviderVerificationSchema, paymentRecordDetailSchema, paymentRecordPageSchema, paymentRecordSchema, paymentRecordStatusSchema, paymentRefundRecordSchema, paymentSettingsSchema, pgEnvironmentSchema, pgPaymentMethodSchema, pgProviderSchema, pgVerificationResultSchema, policyDocumentUrlSchema, policyVersionSchema, portOneChannelSchema, portOneCredentialsInputSchema, productCreateRequestSchema, productImageRejection, productImageUrlSchema, productListQuerySchema, productOutOfStockWebhookEventDataSchema, productOutOfStockWebhookEventSchema, productPatchRequestSchema, productRefundPolicyOverride, productSchema, productSortSchema, productStatusSchema, productSummarySchema, productVariantRequestSchema, productVariantSchema, proratedRefundBase, purchaseDecisionExtendResultSchema, purchaseDecisionRequestResultSchema, quoteDelivery, refreshUserToken, refundPolicyPatchSchema, refundPolicySchema, rejectClaimRequestSchema, remoteAreaLabelOf, remoteAreaOf, remoteAreaSchema, remoteSurchargeOf, resolveRefundPolicy, resolveShippingPolicy, reviewListQuerySchema, reviewReportResultSchema, reviewSchema, reviewSortSchema, reviewWebhookEventDataSchema, reviewWebhookEventSchema, salesReportGroupBySchema, salesReportQuerySchema, salesReportRowSchema, salesReportSchema, salesTotalsSchema, saveLoginProviderRequestSchema, scopeAccessSchema, sellerAddressListQuerySchema, sellerAddressRequestSchema, sellerAddressSchema, sellerCustomerInquirySchema, settlementDetailQuerySchema, settlementDetailSchema, settlementListQuerySchema, settlementStatusSchema, settlementSummarySchema, settlementWithDetailsSchema, shippingAddressSchema, shippingPolicyPatchSchema, shippingPolicySchema, storeCodeSchema, storeMemberRoleUpdatedSchema, storeMemberSchema, storeRoleSchema, storeSchema, storeScopeResourceSchema, storeTokenResponseSchema, tossPaymentsCredentialsInputSchema, trackingStageResponseSchema, trackingUpdateResultSchema, updateLoginProviderRequestSchema, updateLoginSettingsRequestSchema, updateMemberRoleRequestSchema, updatePaymentProviderRequestSchema, updatePaymentSettingsRequestSchema, updateStoreRequestSchema, uploadExtensionOf, uploadPurposeSchema, uploadRejection, uploadRequestSchema, uploadTicketSchema, upsertPortOneProviderRequestSchema, upsertTossPaymentsProviderRequestSchema, userTokenResponseSchema, variantStockRequestSchema, variantStockSchema, verifyPaymentProviderRequestSchema, webhookCreatedSchema, webhookDeliveryDetailSchema, webhookDeliveryErrorCodeSchema, webhookDeliveryListQuerySchema, webhookDeliveryResourceSchema, webhookDeliverySchema, webhookDeliveryStatusSchema, webhookEventSchema, webhookFailureReasonSchema, webhookRedeliverFailedResultSchema, webhookRequestHeaderSchema, webhookRequestSchema, webhookResourceTypeSchema, webhookSchema, webhookSecretRotatedSchema, webhookStatusSchema, webhookTestRequestSchema, webhookTestResultSchema, withdrawCustomerRequestSchema, writeDryRunResultSchema, writePreviewSchema };
+export { APPROVAL_ALREADY_DECIDED_CODE, APPROVAL_REQUIRED_CODE, ApiError, ApprovalPendingError, CASH_RECEIPT_STATUS_VALUES, MAX_ANALYTICS_ALLOWED_ORIGINS, MAX_AUTO_TRANSITION_DAYS, MAX_OPTION_GROUPS, MAX_PRODUCT_IMAGES, MAX_VALUES_PER_GROUP, MAX_VARIANTS, MCP_TELEMETRY_MAX_RESULTS, PAYMENT_ROUTING_EXCLUSION_CODES, PORTONE_CHANNEL_NAME_MAX_LENGTH, PORTONE_MAX_CHANNELS, PORTONE_MIN_CHANNELS, REFUND_POLICY_DEFAULTS, REMOTE_AREA_ZIP_RANGES, RESERVED_STORE_CODES, SHIPPING_POLICY_DEFAULTS, STORE_CODE_PATTERN, STORE_ROLE_SCOPES, STORE_SCOPE_RESOURCES, STORE_SESSION_KEYS, TOSS_WIDGET_CLIENT_KEY_PATTERN, TOSS_WIDGET_KEY_MESSAGE, TOSS_WIDGET_SECRET_KEY_PATTERN, UPLOAD_PURPOSE_LIMITS, VARIANT_STOCK_EXCLUSIVE_MESSAGE, WEBHOOK_DEFAULT_TOLERANCE_SEC, WEBHOOK_DELIVERY_ID_HEADER, WEBHOOK_EVENT_ID_HEADER, WEBHOOK_EVENT_TYPE_HEADER, WEBHOOK_FAILURE_REASONS, WEBHOOK_HEADERS, WEBHOOK_PAYLOAD_EXCERPT_MAX_BYTES, WEBHOOK_RESOURCE_TYPES, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_USER_AGENT, addressChangeRequestListSchema, addressTypeSchema, agentPolicyDecisionSchema, analyticsChannelSchema, analyticsCheckoutOutcomeSchema, analyticsCheckoutSchema, analyticsDeviceRowSchema, analyticsDevicesSchema, analyticsFunnelStepSchema, analyticsOriginSchema, analyticsOverviewSchema, analyticsPagesQuerySchema, analyticsPagesSchema, analyticsProductRowSchema, analyticsProductSortSchema, analyticsProductsQuerySchema, analyticsProductsSchema, analyticsRangeQuerySchema, analyticsRealtimeSchema, analyticsSearchQuerySchema, analyticsSearchSchema, analyticsSourceGroupBySchema, analyticsSourceRowSchema, analyticsSourcesQuerySchema, analyticsSourcesSchema, analyticsTotalsSchema, apiClientListQuerySchema, apiClientSchema, apiClientSecretRotatedSchema, apiClientStatusSchema, apiClientTypeSchema, apiLogErrorSchema, apiLogListQuerySchema, apiLogPageSchema, apiLogPrincipalSchema, apiLogPrincipalTypeSchema, apiLogSchema, apiLogStatusFilterSchema, apiLogSummarySchema, apiTokenCreateRequestSchema, apiTokenCreatedSchema, apiTokenSchema, approvalDecisionRequestSchema, approvalListQuerySchema, approvalPageSchema, approvalRequestSchema, approvalStatusSchema, approveClaimResultSchema, auditActorSchema, auditActorTypeSchema, auditLogListQuerySchema, auditLogOutcomeSchema, auditLogPageSchema, auditLogSchema, auditLogSourceSchema, buildAuthorizeUrl, buildQuery, bulkResultSchema, cancelBySellerRequestSchema, cancelBySellerResultSchema, carrierSchema, cashReceiptSchema, categoryAttributeSchema, categoryCreateRequestSchema, categoryDeleteQuerySchema, categoryDeleteStrategySchema, categoryListQuerySchema, categoryPatchRequestSchema, categoryProductSortSchema, categorySchema, categorySearchResultSchema, categoryTreeNodeSchema, categoryWithPathSchema, changeTypeSchema, claimDetailSchema, claimHoldResultSchema, claimListQuerySchema, claimReasonSchema, claimReturnAddressSchema, claimSchema, claimStatusSchema, claimTypeSchema, claimWebhookEventDataSchema, claimWebhookEventSchema, clientCredentialsTokenResponseSchema, consentActionSchema, consentKindSchema, consentSourceSchema, createPkcePair, createStoreClient, createStoreSession, customerAddressSchema, customerConsentListQuerySchema, customerConsentSchema, customerConsentStateSchema, customerConsentsSchema, customerDetailSchema, customerInquiryCategorySchema, customerInquiryListQuerySchema, customerListQuerySchema, customerOrderSchema, customerSortSchema, customerStatsSchema, customerSummarySchema, customerWithdrawalBlockedDetailsSchema, deliveryBundleKeyOf, deliveryFeeWaiverSchema, deliveryInfoSchema, deliveryMethodSchema, deliveryStatusSchema, deliveryTypeSchema, discountRequestSchema, discountSchema, dispatchRequestSchema, easyPayProviderResponseSchema, easyPayProviderSchema, eventTypeSchema, exchangeAuthorizationCode, exchangeStoreTokenViaOAuth, holdOrderItemRequestSchema, inquiryListQuerySchema, inquirySchema, inquiryWebhookEventDataSchema, inquiryWebhookEventSchema, invitationDeliveryStatusSchema, invitationListQuerySchema, invitationSchema, inviteMemberRequestSchema, isReservedStoreCode, isStoreScope, isWebOrigin, liveGateConditionCodeSchema, liveGateConditionSchema, liveGateErrorDetailsSchema, liveGateSchema, loginProviderSchema, loginProviderStatusSchema, loginProviderTestSchema, loginSettingsSchema, maskedSecretSchema, mcpRuleResultSchema, mcpToolEventSchema, myAccountSchema, myStoreSchema, oauthClientRegistrationRequestSchema, oauthClientRegistrationResponseSchema, oauthTokenResponseSchema, optionGroupRequestSchema, optionGroupSchema, optionModelRequestSchema, optionModelSchema, optionValueRequestSchema, optionValueSchema, orderCanceledWebhookEventDataSchema, orderCanceledWebhookEventSchema, orderItemListQuerySchema, orderItemMemoResultSchema, orderItemPageSchema, orderItemSchema, orderItemStatusSchema, orderListQuerySchema, orderSchema, orderSummaryPageSchema, orderSummarySchema, orderWebhookEventDataSchema, orderWebhookEventSchema, pageInfoSchema, pageQueryShape, pageSchema, paymentAttemptRecordSchema, paymentAttemptStatusSchema, paymentCredentialSetSchema, paymentListQuerySchema, paymentProviderSchema, paymentProviderVerificationSchema, paymentRecordDetailSchema, paymentRecordPageSchema, paymentRecordSchema, paymentRecordStatusSchema, paymentRefundRecordSchema, paymentSettingsSchema, pgEnvironmentSchema, pgPaymentMethodSchema, pgProviderSchema, pgVerificationResultSchema, policyDocumentUrlSchema, policyVersionSchema, portOneChannelSchema, portOneCredentialsInputSchema, productCreateRequestSchema, productImageRejection, productImageUrlSchema, productListQuerySchema, productOutOfStockWebhookEventDataSchema, productOutOfStockWebhookEventSchema, productPatchRequestSchema, productRefundPolicyOverride, productSchema, productSortSchema, productStatusSchema, productSummarySchema, productVariantRequestSchema, productVariantSchema, proratedRefundBase, purchaseDecisionExtendResultSchema, purchaseDecisionRequestResultSchema, quoteDelivery, refreshUserToken, refundPolicyPatchSchema, refundPolicySchema, rejectClaimRequestSchema, remoteAreaLabelOf, remoteAreaOf, remoteAreaSchema, remoteSurchargeOf, resolveRefundPolicy, resolveShippingPolicy, reviewListQuerySchema, reviewReportResultSchema, reviewSchema, reviewSortSchema, reviewWebhookEventDataSchema, reviewWebhookEventSchema, salesReportGroupBySchema, salesReportQuerySchema, salesReportRowSchema, salesReportSchema, salesTotalsSchema, saveLoginProviderRequestSchema, scopeAccessSchema, sellerAddressListQuerySchema, sellerAddressRequestSchema, sellerAddressSchema, sellerCustomerInquirySchema, settlementDetailQuerySchema, settlementDetailSchema, settlementListQuerySchema, settlementStatusSchema, settlementSummarySchema, settlementWithDetailsSchema, shippingAddressSchema, shippingPolicyPatchSchema, shippingPolicySchema, storeCodeSchema, storeMemberRoleUpdatedSchema, storeMemberSchema, storeRoleSchema, storeSchema, storeScopeResourceSchema, storeTokenResponseSchema, tossPaymentsCredentialsInputSchema, trackingStageResponseSchema, trackingUpdateResultSchema, updateLoginProviderRequestSchema, updateLoginSettingsRequestSchema, updateMemberRoleRequestSchema, updatePaymentProviderRequestSchema, updatePaymentSettingsRequestSchema, updateStoreRequestSchema, uploadExtensionOf, uploadPurposeSchema, uploadRejection, uploadRequestSchema, uploadTicketSchema, upsertPortOneProviderRequestSchema, upsertTossPaymentsProviderRequestSchema, userTokenResponseSchema, variantStockRequestSchema, variantStockSchema, verifyPaymentProviderRequestSchema, webhookCreatedSchema, webhookDeliveryDetailSchema, webhookDeliveryErrorCodeSchema, webhookDeliveryListQuerySchema, webhookDeliveryResourceSchema, webhookDeliverySchema, webhookDeliveryStatusSchema, webhookEventSchema, webhookFailureReasonSchema, webhookRedeliverFailedResultSchema, webhookRequestHeaderSchema, webhookRequestSchema, webhookResourceTypeSchema, webhookSchema, webhookSecretRotatedSchema, webhookStatusSchema, webhookTestRequestSchema, webhookTestResultSchema, withdrawCustomerRequestSchema, writeDryRunResultSchema, writePreviewSchema };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sayren/store-sdk",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "main": "./dist/index.mjs",
   "types": "./dist/index.d.mts",
   "exports": {

package/src/schemas/common.ts

@@ -70,6 +70,7 @@ export const changeTypeSchema = z.enum([
   // 취소·반품 승인으로 주문상품이 취소됐다 — 서버가 이 값을 쓰므로 목록에 있어야 한다
   // (빠져 있던 동안 클레임이 끝난 주문상품이 섞이면 응답 검증이 깨졌다)
   "CLAIM.COMPLETED",
+  // 현재 서버가 쓰지 않음. 공개 계약 호환을 위해 값만 남겼다
   "ORDER.ADDRESS_CHANGE_REQUESTED",
 ]);
 

package/src/schemas/misc.ts

@@ -138,21 +138,28 @@ export interface SettlementListParams extends PageParams {
   status?: SettlementStatus;
 }
 
-export const eventTypeSchema = z.enum([
-  "ORDER.PAID",
-  "ORDER.CONFIRMED",
-  "ORDER.DISPATCHED",
-  "ORDER.DELIVERED",
-  "ORDER.PURCHASE_DECIDED",
-  "ORDER.ADDRESS_CHANGE_REQUESTED",
-  "CLAIM.CANCEL_REQUESTED",
-  "CLAIM.RETURN_REQUESTED",
-  "CLAIM.EXCHANGE_REQUESTED",
-  "CLAIM.COMPLETED",
-  "INQUIRY.CREATED",
-  "REVIEW.CREATED",
-  "PRODUCT.OUT_OF_STOCK",
-]);
+export const eventTypeSchema = z
+  .enum([
+    "ORDER.PAID",
+    "ORDER.CONFIRMED",
+    "ORDER.DISPATCHED",
+    "ORDER.DELIVERED",
+    "ORDER.PURCHASE_DECIDED",
+    // 현재 발송하지 않음. 공개 계약 호환을 위해 값만 남겼다(구독해도 이벤트가 오지 않는다)
+    "ORDER.ADDRESS_CHANGE_REQUESTED",
+    // 셀러 직권취소 (이슈 #50). 뒤에 붙여 기존 값의 순서를 바꾸지 않는다
+    "ORDER.CANCELED",
+    "CLAIM.CANCEL_REQUESTED",
+    "CLAIM.RETURN_REQUESTED",
+    "CLAIM.EXCHANGE_REQUESTED",
+    "CLAIM.COMPLETED",
+    "INQUIRY.CREATED",
+    "REVIEW.CREATED",
+    "PRODUCT.OUT_OF_STOCK",
+  ])
+  .describe(
+    "웹훅 이벤트 타입. `ORDER.ADDRESS_CHANGE_REQUESTED`는 현재 발송하지 않음(호환을 위해 값만 남았고, 구독해도 이벤트가 오지 않는다)",
+  );
 
 export type EventType = z.infer<typeof eventTypeSchema>;
 

package/src/schemas/webhook-event.ts

@@ -38,6 +38,46 @@ export const orderWebhookEventDataSchema = z.object({
 });
 export type OrderWebhookEventData = z.infer<typeof orderWebhookEventDataSchema>;
 
+/**
+ * `ORDER.CANCELED` — 셀러 직권취소(`POST /v1/order-items/{orderItemId}/cancel`)로 주문상품이 취소됐다.
+ * 수량 단위 부분 취소도 이 이벤트다(`quantity` < 주문 수량이면 주문상품 상태가 그대로다).
+ * 구매자가 신청한 취소·반품은 `CLAIM.*` 이벤트로 온다.
+ */
+export const orderCanceledWebhookEventDataSchema = z.object({
+  orderId: z.string().describe("주문 ID"),
+  orderItemId: z.string().describe("취소한 주문 상품 ID"),
+  status: orderItemStatusSchema.describe(
+    "취소 뒤 주문 대표 상태. 모든 주문 상품이 취소됐으면 `CANCELED`다",
+  ),
+  itemStatus: orderItemStatusSchema.describe(
+    "취소 뒤 주문 상품 상태. 전 수량이 취소됐으면 `CANCELED`, 일부만 취소했으면 원래 상태다",
+  ),
+  reason: z
+    .string()
+    .describe(
+      "취소 사유 코드 — 판매자 취소 요청의 `reason`(`OUT_OF_STOCK`·`PRICE_ERROR`·`DELIVERY_IMPOSSIBLE`·`ETC`). " +
+        "사유가 늘어날 수 있어 문자열이다. 모르는 값은 `ETC`처럼 다룬다",
+    ),
+  quantity: z.number().int().describe("이번에 취소한 수량"),
+  canceledQuantity: z.number().int().describe("취소 후 누적 취소 수량"),
+  refundAmount: z
+    .number()
+    .int()
+    .describe(
+      "환불액 (원). 수량 비율 상품 금액 + 배송비 환불 − 조건부 무료배송 미달 차감이다. " +
+        "결제사 환불 결과는 결제 내역(`GET /v1/payments/{paymentId}`)으로 확인한다",
+    ),
+  deliveryFeeRefundAmount: z.number().int().describe("환불액에 포함된 배송비 (원)"),
+  deliveryFeeChargeAmount: z
+    .number()
+    .int()
+    .describe("환불액에서 뺀 배송비 (원) — 조건부 무료배송 기준 미달 차감"),
+  testPayment: z
+    .boolean()
+    .describe("테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았다"),
+});
+export type OrderCanceledWebhookEventData = z.infer<typeof orderCanceledWebhookEventDataSchema>;
+
 export const claimWebhookEventDataSchema = z.object({
   claimId: z.string().describe("클레임 ID"),
   orderId: z.string().describe("주문 ID"),
@@ -125,11 +165,18 @@ export const orderWebhookEventSchema = z.object({
     "ORDER.DISPATCHED",
     "ORDER.DELIVERED",
     "ORDER.PURCHASE_DECIDED",
+    // 현재 발송하지 않음. 공개 계약 호환을 위해 값만 남겼다
     "ORDER.ADDRESS_CHANGE_REQUESTED",
   ]),
   data: orderWebhookEventDataSchema,
 });
 
+export const orderCanceledWebhookEventSchema = z.object({
+  ...envelopeFields,
+  type: z.literal("ORDER.CANCELED"),
+  data: orderCanceledWebhookEventDataSchema,
+});
+
 export const claimWebhookEventSchema = z.object({
   ...envelopeFields,
   type: z.enum([
@@ -163,6 +210,7 @@ export const productOutOfStockWebhookEventSchema = z.object({
 export const webhookEventSchema = z
   .discriminatedUnion("type", [
     orderWebhookEventSchema,
+    orderCanceledWebhookEventSchema,
     claimWebhookEventSchema,
     inquiryWebhookEventSchema,
     reviewWebhookEventSchema,