@sayren/store-sdk 0.16.0 → 0.18.0

package/dist/index.d.mts

@@ -165,8 +165,8 @@ export declare const auditLogPageSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type AuditLogPage = z.infer<typeof auditLogPageSchema>;
 export declare const agentPolicyDecisionSchema: z.ZodEnum<{
-  DENIED: "DENIED";
   APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
+  DENIED: "DENIED";
   ALLOW: "ALLOW";
 }>;
 export type AgentPolicyDecision = z.infer<typeof agentPolicyDecisionSchema>;
@@ -190,8 +190,8 @@ export type WritePreview = z.infer<typeof writePreviewSchema>;
 export declare const writeDryRunResultSchema: z.ZodObject<{
   dryRun: z.ZodLiteral<true>;
   decision: z.ZodEnum<{
-    DENIED: "DENIED";
     APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
+    DENIED: "DENIED";
     ALLOW: "ALLOW";
   }>;
   reason: z.ZodNullable<z.ZodString>;
@@ -213,25 +213,25 @@ export declare const writeDryRunResultSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type WriteDryRunResult = z.infer<typeof writeDryRunResultSchema>;
 export declare const approvalStatusSchema: z.ZodEnum<{
+  EXPIRED: "EXPIRED";
   PENDING: "PENDING";
   FAILED: "FAILED";
   SUCCEEDED: "SUCCEEDED";
   EXECUTING: "EXECUTING";
   UNKNOWN: "UNKNOWN";
   REJECTED: "REJECTED";
-  EXPIRED: "EXPIRED";
 }>;
 export type ApprovalStatus = z.infer<typeof approvalStatusSchema>;
 export declare const approvalRequestSchema: z.ZodObject<{
   approvalId: z.ZodString;
   status: z.ZodEnum<{
+    EXPIRED: "EXPIRED";
     PENDING: "PENDING";
     FAILED: "FAILED";
     SUCCEEDED: "SUCCEEDED";
     EXECUTING: "EXECUTING";
     UNKNOWN: "UNKNOWN";
     REJECTED: "REJECTED";
-    EXPIRED: "EXPIRED";
   }>;
   operationId: z.ZodString;
   method: z.ZodString;
@@ -287,13 +287,13 @@ export declare const approvalRequestSchema: z.ZodObject<{
 export type ApprovalRequest = z.infer<typeof approvalRequestSchema>;
 export declare const approvalListQuerySchema: z.ZodObject<{
   status: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>, z.ZodArray<z.ZodEnum<{
+    EXPIRED: "EXPIRED";
     PENDING: "PENDING";
     FAILED: "FAILED";
     SUCCEEDED: "SUCCEEDED";
     EXECUTING: "EXECUTING";
     UNKNOWN: "UNKNOWN";
     REJECTED: "REJECTED";
-    EXPIRED: "EXPIRED";
   }>>>>;
   cursor: z.ZodOptional<z.ZodString>;
   limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
@@ -306,13 +306,13 @@ export declare const approvalPageSchema: z.ZodObject<{
   items: z.ZodArray<z.ZodObject<{
     approvalId: z.ZodString;
     status: z.ZodEnum<{
+      EXPIRED: "EXPIRED";
       PENDING: "PENDING";
       FAILED: "FAILED";
       SUCCEEDED: "SUCCEEDED";
       EXECUTING: "EXECUTING";
       UNKNOWN: "UNKNOWN";
       REJECTED: "REJECTED";
-      EXPIRED: "EXPIRED";
     }>;
     operationId: z.ZodString;
     method: z.ZodString;
@@ -1073,9 +1073,9 @@ export type ApiLogSummary = z.infer<typeof apiLogSummarySchema>;
 //#endregion
 //#region src/schemas/auth.d.ts
 export declare const storeRoleSchema: z.ZodEnum<{
+  OWNER: "OWNER";
   ADMIN: "ADMIN";
   STAFF: "STAFF";
-  OWNER: "OWNER";
 }>;
 export type StoreRole = z.infer<typeof storeRoleSchema>;
 export declare const userTokenResponseSchema: z.ZodObject<{
@@ -1099,9 +1099,9 @@ export declare const storeTokenResponseSchema: z.ZodObject<{
   expires_in: z.ZodNumber;
   storeId: z.ZodString;
   role: z.ZodEnum<{
+    OWNER: "OWNER";
     ADMIN: "ADMIN";
     STAFF: "STAFF";
-    OWNER: "OWNER";
   }>;
   scopes: z.ZodArray<z.ZodString>;
 }, z.core.$strip>;
@@ -1111,9 +1111,9 @@ export declare const myStoreSchema: z.ZodObject<{
   storeName: z.ZodString;
   storeCode: z.ZodString;
   role: z.ZodEnum<{
+    OWNER: "OWNER";
     ADMIN: "ADMIN";
     STAFF: "STAFF";
-    OWNER: "OWNER";
   }>;
   status: z.ZodEnum<{
     ACTIVE: "ACTIVE";
@@ -1555,6 +1555,7 @@ export declare const claimSchema: z.ZodObject<{
     carrierCode: z.ZodNullable<z.ZodString>;
     trackingNumber: z.ZodNullable<z.ZodString>;
   }, z.core.$strip>>;
+  fulfillmentType: z.ZodDefault<z.ZodOptional<z.ZodString>>;
   requestedAt: z.ZodString;
   completedAt: z.ZodNullable<z.ZodString>;
   holdExpiresAt: z.ZodNullable<z.ZodString>;
@@ -1642,6 +1643,7 @@ export declare const claimDetailSchema: z.ZodObject<{
     carrierCode: z.ZodNullable<z.ZodString>;
     trackingNumber: z.ZodNullable<z.ZodString>;
   }, z.core.$strip>>;
+  fulfillmentType: z.ZodDefault<z.ZodOptional<z.ZodString>>;
   requestedAt: z.ZodString;
   completedAt: z.ZodNullable<z.ZodString>;
   holdExpiresAt: z.ZodNullable<z.ZodString>;
@@ -1700,10 +1702,312 @@ export declare const approveClaimResultSchema: z.ZodObject<{
   quantity: z.ZodNumber;
   deliveryFeeRefundAmount: z.ZodNumber;
   deliveryFeeChargeAmount: z.ZodNumber;
+  couponChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+  couponChargeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   refundedAt: z.ZodString;
 }, z.core.$strip>;
 export type ApproveClaimResult = z.infer<typeof approveClaimResultSchema>;
 //#endregion
+//#region src/schemas/coupon.d.ts
+/**
+ * 쿠폰 관리 API 계약 (이슈 #47) — `/v1/coupons/**`, 스코프 `promotion:r|rw`.
+ *
+ * 금액 계산 규칙은 `promotion.ts`(`quotePricing`)가 원천이고, 여기에는 셀러가 쿠폰을 만들고 나눠 주는 표면만 있다.
+ * 발급·사용이 시작된 쿠폰은 혜택·조건·대상·사용 시작일을 바꿀 수 없다(409 `COUPON_LOCKED`). 이름·설명·종료일 연장·
+ * 한도 상향·중지·재개·종료만 된다. 규칙을 바꾸려면 새 쿠폰을 만든다.
+ */
+/** 쿠폰 상태 — `ACTIVE`(사용 중)·`PAUSED`(중지, 재개 가능)·`ENDED`(종료, 되돌릴 수 없음) */
+export declare const couponStatusSchema: z.ZodEnum<{
+  ACTIVE: "ACTIVE";
+  PAUSED: "PAUSED";
+  ENDED: "ENDED";
+}>;
+export type CouponStatus = z.infer<typeof couponStatusSchema>;
+/** 지금 만들 수 있는 발급 방식 — 다운로드·가입 자동 지급은 뒤 단계다 */
+export declare const couponIssueMethodSchema: z.ZodEnum<{
+  CODE: "CODE";
+  MANUAL: "MANUAL";
+}>;
+export type CouponIssueMethod = z.infer<typeof couponIssueMethodSchema>;
+/** 코드 형식 — 영문·숫자·`-`·`_` 6~30자. 대소문자를 구분하지 않고 서버가 대문자로 저장한다 */
+export declare const COUPON_CODE_PATTERN: RegExp;
+/** 코드 정규화 — 대문자, 앞뒤 공백 제거. 입력·저장·조회가 같은 함수를 쓴다 */
+export declare function normalizeCouponCode(code: string): string;
+/** 조건 입력 — 생략한 항목은 기본값(`COUPON_CONDITIONS_DEFAULTS`)이다 */
+export declare const couponConditionsInputSchema: z.ZodObject<{
+  minOrderAmount: z.ZodOptional<z.ZodNumber>;
+  firstOrderOnly: z.ZodOptional<z.ZodBoolean>;
+  memberOnly: z.ZodOptional<z.ZodBoolean>;
+  stackWithInstantDiscount: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+/** 대상 입력 — 생략한 목록은 빈 목록이다(포함 목록이 모두 비면 전 상품) */
+export declare const couponTargetInputSchema: z.ZodObject<{
+  includeProductIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  includeCategoryIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  excludeProductIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  excludeCategoryIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+/** `POST /v1/coupons` */
+export declare const createCouponRequestSchema: z.ZodObject<{
+  name: z.ZodString;
+  description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  kind: z.ZodEnum<{
+    ORDER: "ORDER";
+    PRODUCT: "PRODUCT";
+    DELIVERY: "DELIVERY";
+  }>;
+  benefit: z.ZodObject<{
+    type: z.ZodEnum<{
+      RATE: "RATE";
+      AMOUNT: "AMOUNT";
+    }>;
+    value: z.ZodNumber;
+    maxDiscountAmount: z.ZodNullable<z.ZodNumber>;
+  }, z.core.$strip>;
+  conditions: z.ZodOptional<z.ZodObject<{
+    minOrderAmount: z.ZodOptional<z.ZodNumber>;
+    firstOrderOnly: z.ZodOptional<z.ZodBoolean>;
+    memberOnly: z.ZodOptional<z.ZodBoolean>;
+    stackWithInstantDiscount: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strict>>;
+  target: z.ZodOptional<z.ZodObject<{
+    includeProductIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    includeCategoryIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    excludeProductIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    excludeCategoryIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  }, z.core.$strict>>;
+  issueMethod: z.ZodEnum<{
+    CODE: "CODE";
+    MANUAL: "MANUAL";
+  }>;
+  code: z.ZodOptional<z.ZodString>;
+  startsAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+  endsAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+  validDaysAfterIssue: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  totalIssueLimit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  totalUseLimit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  perMemberIssueLimit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  perMemberUseLimit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strict>;
+export type CreateCouponRequest = z.infer<typeof createCouponRequestSchema>;
+/**
+ * `PATCH /v1/coupons/{couponId}` — 준 항목만 바뀐다. 발급·사용이 시작된 쿠폰(`locked`)은 이름·설명·종료일 연장·
+ * 한도 상향만 받고, 그 밖의 항목이 현재 값과 다르면 409 `COUPON_LOCKED`다. 종류·발급 방식은 바꿀 수 없다.
+ */
+export declare const updateCouponRequestSchema: z.ZodObject<{
+  name: z.ZodOptional<z.ZodString>;
+  description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  benefit: z.ZodOptional<z.ZodObject<{
+    type: z.ZodEnum<{
+      RATE: "RATE";
+      AMOUNT: "AMOUNT";
+    }>;
+    value: z.ZodNumber;
+    maxDiscountAmount: z.ZodNullable<z.ZodNumber>;
+  }, z.core.$strip>>;
+  conditions: z.ZodOptional<z.ZodObject<{
+    minOrderAmount: z.ZodOptional<z.ZodNumber>;
+    firstOrderOnly: z.ZodOptional<z.ZodBoolean>;
+    memberOnly: z.ZodOptional<z.ZodBoolean>;
+    stackWithInstantDiscount: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strict>>;
+  target: z.ZodOptional<z.ZodObject<{
+    includeProductIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    includeCategoryIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    excludeProductIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    excludeCategoryIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  }, z.core.$strict>>;
+  code: z.ZodOptional<z.ZodString>;
+  startsAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+  endsAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+  validDaysAfterIssue: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  totalIssueLimit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  totalUseLimit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  perMemberIssueLimit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  perMemberUseLimit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strict>;
+export type UpdateCouponRequest = z.infer<typeof updateCouponRequestSchema>;
+/** 쿠폰 응답 */
+export declare const couponSchema: z.ZodObject<{
+  couponId: z.ZodString;
+  name: z.ZodString;
+  description: z.ZodNullable<z.ZodString>;
+  kind: z.ZodEnum<{
+    ORDER: "ORDER";
+    PRODUCT: "PRODUCT";
+    DELIVERY: "DELIVERY";
+  }>;
+  benefit: z.ZodObject<{
+    type: z.ZodEnum<{
+      RATE: "RATE";
+      AMOUNT: "AMOUNT";
+    }>;
+    value: z.ZodNumber;
+    maxDiscountAmount: z.ZodNullable<z.ZodNumber>;
+  }, z.core.$strip>;
+  conditions: z.ZodObject<{
+    minOrderAmount: z.ZodNumber;
+    firstOrderOnly: z.ZodBoolean;
+    memberOnly: z.ZodBoolean;
+    stackWithInstantDiscount: z.ZodBoolean;
+  }, z.core.$strip>;
+  target: z.ZodObject<{
+    includeProductIds: z.ZodArray<z.ZodString>;
+    includeCategoryIds: z.ZodArray<z.ZodString>;
+    excludeProductIds: z.ZodArray<z.ZodString>;
+    excludeCategoryIds: z.ZodArray<z.ZodString>;
+  }, z.core.$strip>;
+  issueMethod: z.ZodString;
+  code: z.ZodNullable<z.ZodString>;
+  startsAt: z.ZodNullable<z.ZodString>;
+  endsAt: z.ZodNullable<z.ZodString>;
+  validDaysAfterIssue: z.ZodNullable<z.ZodNumber>;
+  totalIssueLimit: z.ZodNullable<z.ZodNumber>;
+  totalUseLimit: z.ZodNullable<z.ZodNumber>;
+  perMemberIssueLimit: z.ZodNullable<z.ZodNumber>;
+  perMemberUseLimit: z.ZodNullable<z.ZodNumber>;
+  issuedCount: z.ZodNumber;
+  reservedCount: z.ZodNumber;
+  usedCount: z.ZodNumber;
+  status: z.ZodEnum<{
+    ACTIVE: "ACTIVE";
+    PAUSED: "PAUSED";
+    ENDED: "ENDED";
+  }>;
+  locked: z.ZodBoolean;
+  lockedAt: z.ZodNullable<z.ZodString>;
+  createdAt: z.ZodString;
+  updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type Coupon = z.infer<typeof couponSchema>;
+/** `GET /v1/coupons` 쿼리 */
+export declare const couponListQuerySchema: z.ZodObject<{
+  page: z.ZodOptional<z.ZodString>;
+  size: z.ZodOptional<z.ZodString>;
+  status: z.ZodOptional<z.ZodEnum<{
+    ACTIVE: "ACTIVE";
+    PAUSED: "PAUSED";
+    ENDED: "ENDED";
+  }>>;
+  kind: z.ZodOptional<z.ZodEnum<{
+    ORDER: "ORDER";
+    PRODUCT: "PRODUCT";
+    DELIVERY: "DELIVERY";
+  }>>;
+  issueMethod: z.ZodOptional<z.ZodEnum<{
+    CODE: "CODE";
+    MANUAL: "MANUAL";
+  }>>;
+  q: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** 발급 쿠폰 상태 — 만료는 저장 상태가 아니라 조회 시각으로 판정한 값이다 */
+export declare const couponIssueStatusSchema: z.ZodString;
+export declare const couponIssueSchema: z.ZodObject<{
+  issueId: z.ZodString;
+  couponId: z.ZodString;
+  customerId: z.ZodString;
+  customerName: z.ZodNullable<z.ZodString>;
+  status: z.ZodString;
+  validFrom: z.ZodString;
+  validUntil: z.ZodNullable<z.ZodString>;
+  usedOrderId: z.ZodNullable<z.ZodString>;
+  issuedAt: z.ZodString;
+  revokedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type CouponIssue = z.infer<typeof couponIssueSchema>;
+export declare const couponIssueListQuerySchema: z.ZodObject<{
+  page: z.ZodOptional<z.ZodString>;
+  size: z.ZodOptional<z.ZodString>;
+  status: z.ZodOptional<z.ZodEnum<{
+    REVOKED: "REVOKED";
+    AVAILABLE: "AVAILABLE";
+    RESERVED: "RESERVED";
+    USED: "USED";
+  }>>;
+}, z.core.$strip>;
+/** `POST /v1/coupons/{couponId}/issues` — 셀러 지급. 한 번에 1,000명까지 */
+export declare const issueCouponRequestSchema: z.ZodObject<{
+  customerIds: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export type IssueCouponRequest = z.infer<typeof issueCouponRequestSchema>;
+export declare const issueCouponResultSchema: z.ZodObject<{
+  issued: z.ZodArray<z.ZodObject<{
+    customerId: z.ZodString;
+    issueId: z.ZodString;
+  }, z.core.$strip>>;
+  failed: z.ZodArray<z.ZodObject<{
+    customerId: z.ZodString;
+    code: z.ZodString;
+    message: z.ZodString;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type IssueCouponResult = z.infer<typeof issueCouponResultSchema>;
+export declare const couponRedemptionSchema: z.ZodObject<{
+  redemptionId: z.ZodString;
+  couponId: z.ZodString;
+  issueId: z.ZodNullable<z.ZodString>;
+  customerId: z.ZodNullable<z.ZodString>;
+  orderId: z.ZodNullable<z.ZodString>;
+  status: z.ZodString;
+  discountAmount: z.ZodNumber;
+  reservedAt: z.ZodString;
+  usedAt: z.ZodNullable<z.ZodString>;
+  releasedAt: z.ZodNullable<z.ZodString>;
+  restoredAt: z.ZodNullable<z.ZodString>;
+  restoreSkippedReason: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type CouponRedemption = z.infer<typeof couponRedemptionSchema>;
+export declare const couponRedemptionListQuerySchema: z.ZodObject<{
+  page: z.ZodOptional<z.ZodString>;
+  size: z.ZodOptional<z.ZodString>;
+  status: z.ZodOptional<z.ZodEnum<{
+    RESERVED: "RESERVED";
+    USED: "USED";
+    RELEASED: "RELEASED";
+    RESTORED: "RESTORED";
+  }>>;
+}, z.core.$strip>;
+export declare const couponStatsSchema: z.ZodObject<{
+  couponId: z.ZodString;
+  issuedCount: z.ZodNumber;
+  revokedCount: z.ZodNumber;
+  reservedCount: z.ZodNumber;
+  usedCount: z.ZodNumber;
+  restoredCount: z.ZodNumber;
+  releasedCount: z.ZodNumber;
+  discountTotal: z.ZodNumber;
+  orderPaymentTotal: z.ZodNumber;
+}, z.core.$strip>;
+export type CouponStats = z.infer<typeof couponStatsSchema>;
+/** `GET /v1/customers/{customerId}/coupons` 항목 — 발급 쿠폰 + 쿠폰 이름·혜택 */
+export declare const customerCouponSchema: z.ZodObject<{
+  issueId: z.ZodString;
+  couponId: z.ZodString;
+  customerId: z.ZodString;
+  customerName: z.ZodNullable<z.ZodString>;
+  status: z.ZodString;
+  validFrom: z.ZodString;
+  validUntil: z.ZodNullable<z.ZodString>;
+  usedOrderId: z.ZodNullable<z.ZodString>;
+  issuedAt: z.ZodString;
+  revokedAt: z.ZodNullable<z.ZodString>;
+  couponName: z.ZodString;
+  kind: z.ZodEnum<{
+    ORDER: "ORDER";
+    PRODUCT: "PRODUCT";
+    DELIVERY: "DELIVERY";
+  }>;
+  benefit: z.ZodObject<{
+    type: z.ZodEnum<{
+      RATE: "RATE";
+      AMOUNT: "AMOUNT";
+    }>;
+    value: z.ZodNumber;
+    maxDiscountAmount: z.ZodNullable<z.ZodNumber>;
+  }, z.core.$strip>;
+}, z.core.$strip>;
+export type CustomerCoupon = z.infer<typeof customerCouponSchema>;
+//#endregion
 //#region src/schemas/customer.d.ts
 /** 구매자 목록 정렬 */
 export declare const customerSortSchema: z.ZodEnum<{
@@ -2010,6 +2314,180 @@ export declare const customerWithdrawalBlockedDetailsSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type CustomerWithdrawalBlockedDetails = z.infer<typeof customerWithdrawalBlockedDetailsSchema>;
 //#endregion
+//#region src/schemas/digital-asset.d.ts
+/**
+ * 파일 다운로드 상품의 판매 파일 (이슈 #48 단계 3).
+ *
+ * 파일은 CDN **비공개 객체**다. `POST /v1/uploads`(`purpose: "digital-asset"`)로 자리를 받아 응답의 `headers`와 함께 PUT하고,
+ * 응답의 `key`로 상품에 연결한다. 객체 키와 파일 주소는 어떤 응답에도 싣지 않는다 — 구매자는 제공된 주문상품에서
+ * 수명 300초의 서명 주소로만 받는다. 주문은 주문 시점 파일을 스냅샷하므로 파일을 바꿔도 이미 산 구매자는 옛 파일을 받는다.
+ */
+export declare const digitalAssetAttachRequestSchema: z.ZodObject<{
+  key: z.ZodString;
+  fileName: z.ZodString;
+  sizeBytes: z.ZodOptional<z.ZodNumber>;
+  contentType: z.ZodOptional<z.ZodString>;
+  variantId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DigitalAssetAttachRequest = z.infer<typeof digitalAssetAttachRequestSchema>;
+/** 판매 파일 — 객체 키·주소는 싣지 않는다 */
+export declare const digitalAssetSchema: z.ZodObject<{
+  assetId: z.ZodString;
+  productId: z.ZodString;
+  variantId: z.ZodNullable<z.ZodString>;
+  fileName: z.ZodString;
+  contentType: z.ZodNullable<z.ZodString>;
+  sizeBytes: z.ZodNullable<z.ZodNumber>;
+  status: z.ZodString;
+  createdAt: z.ZodString;
+}, z.core.$strip>;
+export type DigitalAsset = z.infer<typeof digitalAssetSchema>;
+/** 셀러 확인용 서명 주소 — `POST /v1/products/{productId}/digital-assets/{assetId}/preview-url` */
+export declare const digitalAssetPreviewSchema: z.ZodObject<{
+  url: z.ZodURL;
+  expiresAt: z.ZodString;
+}, z.core.$strip>;
+export type DigitalAssetPreview = z.infer<typeof digitalAssetPreviewSchema>;
+/** 주문상품의 다운로드 제공 정보 — 주문 응답의 `fulfillment.download` */
+export declare const orderItemDownloadSchema: z.ZodObject<{
+  count: z.ZodNumber;
+  limit: z.ZodNumber;
+  expiresAt: z.ZodNullable<z.ZodString>;
+  firstDownloadedAt: z.ZodNullable<z.ZodString>;
+  files: z.ZodArray<z.ZodObject<{
+    assetId: z.ZodString;
+    fileName: z.ZodString;
+    sizeBytes: z.ZodNullable<z.ZodNumber>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type OrderItemDownload = z.infer<typeof orderItemDownloadSchema>;
+//#endregion
+//#region src/schemas/fulfillment-code.d.ts
+/**
+ * 코드 발급 상품의 코드 풀 (이슈 #48 단계 2) — 라이선스 키·기프트 코드처럼 결제 확정과 함께 한 개씩 배정하는 코드다.
+ *
+ * **평문 코드는 두 경로로만 나간다** — 구매자 열람(`POST /storefront/v1/me/order-items/{id}/fulfillment/reveal`)과 셀러 콘솔
+ * 열람(`POST /v1/fulfillment-codes/{codeId}/reveal`, 콘솔 전용). 목록·주문·웹훅·API 로그에는 가린 값(`hint`)만 싣는다.
+ * 코드는 결제 자격 증명과 같은 키링·AES-256-GCM으로 암호화해 저장한다.
+ */
+/**
+ * 코드 상태.
+ * - `AVAILABLE` 판매 가능 — 재고로 센다
+ * - `ASSIGNED` 주문상품에 배정됨
+ * - `REVOKED` 환불로 회수됨(구매자 화면에서 숨긴다. 코드 자체의 무효화는 셀러 시스템 몫이다)
+ * - `EXPIRED` 유효기간이 지나 배정하지 않음
+ * - `VOID` 셀러가 폐기함
+ */
+export declare const fulfillmentCodeStatusSchema: z.ZodEnum<{
+  REVOKED: "REVOKED";
+  AVAILABLE: "AVAILABLE";
+  ASSIGNED: "ASSIGNED";
+  EXPIRED: "EXPIRED";
+  VOID: "VOID";
+}>;
+export type FulfillmentCodeStatus = z.infer<typeof fulfillmentCodeStatusSchema>;
+/** 한 번에 올릴 수 있는 코드 수 */
+export declare const MAX_CODES_PER_UPLOAD = 10000;
+/** 코드 한 개의 최대 길이 */
+export declare const MAX_CODE_LENGTH = 200;
+/**
+ * 코드 일괄 업로드 요청 — `POST /v1/products/{productId}/codes`. `codes`(배열)와 `csv`(본문) 중 하나를 보낸다.
+ * 앞뒤 공백은 지우고 빈 줄은 건너뛴다. 같은 상품에 이미 있는 코드와 요청 안의 중복은 받지 않는다(`duplicates`).
+ */
+export declare const fulfillmentCodeUploadRequestSchema: z.ZodObject<{
+  variantId: z.ZodOptional<z.ZodString>;
+  codes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  csv: z.ZodOptional<z.ZodString>;
+  expiresAt: z.ZodOptional<z.ZodISODateTime>;
+}, z.core.$strip>;
+export type FulfillmentCodeUploadRequest = z.infer<typeof fulfillmentCodeUploadRequestSchema>;
+/** 받지 않은 줄 */
+export declare const fulfillmentCodeRejectionSchema: z.ZodObject<{
+  line: z.ZodNumber;
+  reason: z.ZodString;
+}, z.core.$strip>;
+/** 업로드 결과 — 배치 요약 */
+export declare const fulfillmentCodeBatchSchema: z.ZodObject<{
+  batchId: z.ZodString;
+  productId: z.ZodString;
+  variantId: z.ZodString;
+  total: z.ZodNumber;
+  accepted: z.ZodNumber;
+  duplicates: z.ZodNumber;
+  rejected: z.ZodArray<z.ZodObject<{
+    line: z.ZodNumber;
+    reason: z.ZodString;
+  }, z.core.$strip>>;
+  expiresAt: z.ZodNullable<z.ZodString>;
+  createdAt: z.ZodString;
+}, z.core.$strip>;
+export type FulfillmentCodeBatch = z.infer<typeof fulfillmentCodeBatchSchema>;
+/** 코드 목록의 한 줄 — **가린 값만** 싣는다 */
+export declare const fulfillmentCodeSchema: z.ZodObject<{
+  codeId: z.ZodString;
+  productId: z.ZodString;
+  variantId: z.ZodString;
+  batchId: z.ZodNullable<z.ZodString>;
+  hint: z.ZodString;
+  status: z.ZodString;
+  orderItemId: z.ZodNullable<z.ZodString>;
+  assignedAt: z.ZodNullable<z.ZodString>;
+  revealedAt: z.ZodNullable<z.ZodString>;
+  expiresAt: z.ZodNullable<z.ZodString>;
+  createdAt: z.ZodString;
+}, z.core.$strip>;
+export type FulfillmentCode = z.infer<typeof fulfillmentCodeSchema>;
+export declare const fulfillmentCodePageSchema: z.ZodObject<{
+  page: z.ZodNumber;
+  size: z.ZodNumber;
+  totalElements: z.ZodNumber;
+  totalPages: z.ZodNumber;
+  contents: z.ZodArray<z.ZodObject<{
+    codeId: z.ZodString;
+    productId: z.ZodString;
+    variantId: z.ZodString;
+    batchId: z.ZodNullable<z.ZodString>;
+    hint: z.ZodString;
+    status: z.ZodString;
+    orderItemId: z.ZodNullable<z.ZodString>;
+    assignedAt: z.ZodNullable<z.ZodString>;
+    revealedAt: z.ZodNullable<z.ZodString>;
+    expiresAt: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+  }, z.core.$strip>>;
+  available: z.ZodNumber;
+}, z.core.$strip>;
+export type FulfillmentCodePage = z.infer<typeof fulfillmentCodePageSchema>;
+/** `GET /v1/products/{productId}/codes` 쿼리 */
+export declare const fulfillmentCodeListQuerySchema: z.ZodObject<{
+  page: z.ZodOptional<z.ZodString>;
+  size: z.ZodOptional<z.ZodString>;
+  status: z.ZodOptional<z.ZodEnum<{
+    REVOKED: "REVOKED";
+    AVAILABLE: "AVAILABLE";
+    ASSIGNED: "ASSIGNED";
+    EXPIRED: "EXPIRED";
+    VOID: "VOID";
+  }>>;
+  variantId: z.ZodOptional<z.ZodString>;
+  batchId: z.ZodOptional<z.ZodString>;
+  orderItemId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** 셀러 콘솔 코드 열람 응답 — `POST /v1/fulfillment-codes/{codeId}/reveal` */
+export declare const fulfillmentCodeRevealSchema: z.ZodObject<{
+  codeId: z.ZodString;
+  code: z.ZodString;
+}, z.core.$strip>;
+export type FulfillmentCodeReveal = z.infer<typeof fulfillmentCodeRevealSchema>;
+/** 주문상품에 배정된 코드의 가린 값 — 주문 응답의 `fulfillment.codes` */
+export declare const orderItemCodeSchema: z.ZodObject<{
+  codeId: z.ZodString;
+  hint: z.ZodString;
+  status: z.ZodString;
+  revealedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type OrderItemCode = z.infer<typeof orderItemCodeSchema>;
+//#endregion
 //#region src/schemas/login.d.ts
 /** 소셜 로그인 공급자 */
 export declare const loginProviderSchema: z.ZodEnum<{
@@ -2093,10 +2571,10 @@ export declare const inquirySchema: z.ZodObject<{
   orderItemId: z.ZodNullable<z.ZodString>;
   category: z.ZodEnum<{
     ETC: "ETC";
+    PRODUCT: "PRODUCT";
     DELIVERY: "DELIVERY";
     RETURN: "RETURN";
     EXCHANGE: "EXCHANGE";
-    PRODUCT: "PRODUCT";
   }>;
   content: z.ZodString;
   secret: z.ZodBoolean;
@@ -2273,6 +2751,7 @@ export declare const eventTypeSchema: z.ZodEnum<{
   "ORDER.PURCHASE_DECIDED": "ORDER.PURCHASE_DECIDED";
   "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
   "ORDER.CANCELED": "ORDER.CANCELED";
+  "ORDER.FULFILLED": "ORDER.FULFILLED";
   "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
   "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
   "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
@@ -2298,6 +2777,7 @@ export declare const webhookSchema: z.ZodObject<{
     "ORDER.PURCHASE_DECIDED": "ORDER.PURCHASE_DECIDED";
     "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
     "ORDER.CANCELED": "ORDER.CANCELED";
+    "ORDER.FULFILLED": "ORDER.FULFILLED";
     "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
     "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
     "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
@@ -2327,6 +2807,7 @@ export declare const webhookCreatedSchema: z.ZodObject<{
     "ORDER.PURCHASE_DECIDED": "ORDER.PURCHASE_DECIDED";
     "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
     "ORDER.CANCELED": "ORDER.CANCELED";
+    "ORDER.FULFILLED": "ORDER.FULFILLED";
     "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
     "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
     "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
@@ -2406,6 +2887,7 @@ export declare const webhookDeliverySchema: z.ZodObject<{
     "ORDER.PURCHASE_DECIDED": "ORDER.PURCHASE_DECIDED";
     "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
     "ORDER.CANCELED": "ORDER.CANCELED";
+    "ORDER.FULFILLED": "ORDER.FULFILLED";
     "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
     "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
     "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
@@ -2458,6 +2940,7 @@ export declare const webhookDeliveryDetailSchema: z.ZodObject<{
     "ORDER.PURCHASE_DECIDED": "ORDER.PURCHASE_DECIDED";
     "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
     "ORDER.CANCELED": "ORDER.CANCELED";
+    "ORDER.FULFILLED": "ORDER.FULFILLED";
     "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
     "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
     "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
@@ -2519,6 +3002,7 @@ export declare const webhookDeliveryListQuerySchema: z.ZodObject<{
     "ORDER.PURCHASE_DECIDED": "ORDER.PURCHASE_DECIDED";
     "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
     "ORDER.CANCELED": "ORDER.CANCELED";
+    "ORDER.FULFILLED": "ORDER.FULFILLED";
     "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
     "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
     "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
@@ -2545,6 +3029,7 @@ export declare const webhookTestRequestSchema: z.ZodObject<{
     "ORDER.PURCHASE_DECIDED": "ORDER.PURCHASE_DECIDED";
     "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
     "ORDER.CANCELED": "ORDER.CANCELED";
+    "ORDER.FULFILLED": "ORDER.FULFILLED";
     "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
     "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
     "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
@@ -2585,6 +3070,7 @@ export declare const webhookRequestSchema: z.ZodObject<{
     "ORDER.PURCHASE_DECIDED": "ORDER.PURCHASE_DECIDED";
     "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
     "ORDER.CANCELED": "ORDER.CANCELED";
+    "ORDER.FULFILLED": "ORDER.FULFILLED";
     "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
     "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
     "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
@@ -2664,77 +3150,577 @@ export declare const reviewReportResultSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type ReviewReportResult = z.infer<typeof reviewReportResultSchema>;
 //#endregion
-//#region src/schemas/order.d.ts
-export declare const orderSummarySchema: z.ZodObject<{
-  orderId: z.ZodString;
-  ordererName: z.ZodString;
-  itemCount: z.ZodNumber;
-  totalAmount: z.ZodNumber;
-  representativeStatus: z.ZodEnum<{
-    PAID: "PAID";
-    CANCELED: "CANCELED";
-    PAYMENT_WAITING: "PAYMENT_WAITING";
-    CONFIRMED: "CONFIRMED";
-    DISPATCHED: "DISPATCHED";
-    DELIVERING: "DELIVERING";
-    DELIVERED: "DELIVERED";
-    PURCHASE_DECIDED: "PURCHASE_DECIDED";
-  }>;
-  orderedAt: z.ZodString;
-  testPayment: z.ZodBoolean;
-}, z.core.$strip>;
-export type OrderSummary = z.infer<typeof orderSummarySchema>;
-export declare const shippingAddressSchema: z.ZodObject<{
-  receiverName: z.ZodString;
-  phone: z.ZodString;
-  zipCode: z.ZodString;
-  address1: z.ZodString;
-  address2: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-  deliveryMemo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-  entranceCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, z.core.$strip>;
-export type ShippingAddress = z.infer<typeof shippingAddressSchema>;
-export declare const orderItemSchema: z.ZodObject<{
-  orderItemId: z.ZodString;
-  orderId: 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";
-  }>;
-  claimStatus: z.ZodNullable<z.ZodEnum<{
-    CANCEL_REQUESTED: "CANCEL_REQUESTED";
-    RETURN_REQUESTED: "RETURN_REQUESTED";
-    EXCHANGE_REQUESTED: "EXCHANGE_REQUESTED";
-  }>>;
-  productId: z.ZodString;
-  productName: z.ZodString;
-  optionId: z.ZodNullable<z.ZodString>;
-  optionName: z.ZodNullable<z.ZodString>;
-  sellerCode: z.ZodNullable<z.ZodString>;
-  quantity: z.ZodNumber;
-  canceledQuantity: z.ZodNumber;
-  activeQuantity: z.ZodNumber;
-  unitPrice: z.ZodNumber;
-  discountAmount: z.ZodNumber;
-  totalPrice: z.ZodNumber;
-  hold: z.ZodNullable<z.ZodObject<{
-    reason: z.ZodString;
-    expectedDispatchDate: z.ZodString;
-  }, z.core.$strip>>;
-  autoDecisionDate: z.ZodNullable<z.ZodString>;
-  sellerMemo: z.ZodNullable<z.ZodString>;
-  orderedAt: z.ZodString;
-  lastChangedAt: z.ZodString;
-  lastChangedType: z.ZodEnum<{
-    "ORDER.PAID": "ORDER.PAID";
-    "ORDER.CONFIRMED": "ORDER.CONFIRMED";
-    "ORDER.DISPATCHED": "ORDER.DISPATCHED";
+//#region src/schemas/fulfillment.d.ts
+/**
+ * 상품 유형과 제공 방식 (이슈 #48) — 배송이 필요 없는 상품을 팔기 위한 축이다.
+ *
+ * **상품 유형은 제공 방식 하나로 표현한다.** `fulfillmentType` 한 필드가 배송 필요 여부, 이행 흐름, 재고 의미를 정한다.
+ * 코드 곳곳에서 유형 이름으로 분기하지 않고 이 파일의 판정 함수(`requiresShipping`·`fulfillmentRuleOf`)를 지난다.
+ * 유형이 늘어나도 판정표 한 곳만 고치면 배송비 계산·결제 시작·클레임·콘솔 버튼이 같이 따라온다.
+ *
+ * 주문상품 상태 enum은 바꾸지 않는다. 비실물의 **제공 완료는 `DELIVERED`를 재사용한다** — 새 상태를 더하면 기존 소비자의
+ * 상태 분기(배송완료 뒤 구매확정 대기, 반품 가능 판정)가 새 값을 모른다. 표시는 `fulfillmentType`으로 가른다.
+ */
+/**
+ * 상품 유형.
+ * - `SHIPPING` 배송 상품(기본, 이 필드 이전의 상품 전부)
+ * - `DOWNLOAD` 파일 다운로드
+ * - `CODE` 코드 발급(라이선스 키·기프트 코드)
+ * - `SERVICE` 이용권·상품권·서비스(예약 없음)
+ * - `PICKUP` 방문 수령 실물
+ */
+export declare const fulfillmentTypeSchema: z.ZodEnum<{
+  SHIPPING: "SHIPPING";
+  DOWNLOAD: "DOWNLOAD";
+  CODE: "CODE";
+  SERVICE: "SERVICE";
+  PICKUP: "PICKUP";
+}>;
+export type FulfillmentType = z.infer<typeof fulfillmentTypeSchema>;
+/** 제공 방식 — `AUTO`는 결제 확정과 함께 제공하고, `MANUAL`은 셀러가 제공 처리한다 */
+export declare const fulfillmentModeSchema: z.ZodEnum<{
+  AUTO: "AUTO";
+  MANUAL: "MANUAL";
+}>;
+export type FulfillmentMode = z.infer<typeof fulfillmentModeSchema>;
+/**
+ * 응답 스키마용 유형 — 서버가 나중에 유형을 더해도 옛 SDK가 응답 파싱에서 깨지지 않게 문자열로 받는다.
+ * 요청은 `fulfillmentTypeSchema`(닫힌 enum)로 검증한다.
+ */
+export declare const fulfillmentTypeResponseSchema: z.ZodString;
+/** 유형 하나의 규칙 — 배송·제공·재고·클레임이 이 표를 읽는다 */
+export interface FulfillmentRule {
+  /** 택배 배송이 필요한가 — 배송비·배송지·발송 흐름의 대상인가 */
+  requiresShipping: boolean;
+  /** 허용하는 제공 방식. 배송 상품은 제공 방식이 없다(빈 배열) */
+  modes: readonly FulfillmentMode[];
+  /** 제공 방식을 정하지 않았을 때의 기본값. 배송 상품은 null */
+  defaultMode: FulfillmentMode | null;
+  /** 반품에 수거가 필요한가 — 실물만 수거한다(방문 수령 포함) */
+  requiresCollection: boolean;
+  /** 교환을 받는가 — 실물만 받는다 */
+  exchangeSupported: boolean;
+}
+/**
+ * 유형별 규칙표 — **유일한 원천이다.**
+ *
+ * `PICKUP`은 실물이라 반품 수거와 교환을 받지만 택배 배송은 없다. `DOWNLOAD`는 결제 즉시 권한을 발급하므로 `AUTO`만,
+ * `PICKUP`은 셀러가 수령 완료를 누르므로 `MANUAL`만 둔다.
+ */
+export declare const FULFILLMENT_RULES: Readonly<Record<FulfillmentType, FulfillmentRule>>;
+/**
+ * 저장된 값 → 유형. null·모르는 값은 `SHIPPING`이다 — 이 필드 이전의 주문상품(`order_items.fulfillment_type` null)과
+ * 상품은 모두 배송 상품이었다.
+ */
+export declare function fulfillmentTypeOf(value: string | null | undefined): FulfillmentType;
+/** 유형의 규칙 — 모르는 값은 배송 상품 규칙이다 */
+export declare function fulfillmentRuleOf(type: string | null | undefined): FulfillmentRule;
+/** 택배 배송이 필요한가 — 배송비 묶음·배송지·발송 흐름의 판정은 이 함수 하나를 지난다 */
+export declare function requiresShipping(type: string | null | undefined): boolean;
+/** 반품에 수거가 필요한가 — 비실물 반품은 수거 등록·수거 완료 없이 승인한다 */
+export declare function requiresCollection(type: string | null | undefined): boolean;
+/**
+ * 유효 제공 방식 — 요청 값이 유형에 허용되면 그 값, 생략이면 유형 기본값이다. 배송 상품은 null이다.
+ * 허용되지 않는 값은 `null`을 돌려주지 않고 호출부가 거부하도록 `undefined`를 돌려준다.
+ */
+export declare function resolveFulfillmentMode(type: FulfillmentType, mode: FulfillmentMode | null | undefined): FulfillmentMode | null | undefined;
+/**
+ * 배송이 없는 주문상품의 배송 묶음 키 (`order_items.delivery_bundle_key`).
+ *
+ * null로 두면 환불 정산이 #29 이전 주문의 레거시 폴백(「묶음 = 같은 상품」, 상품의 **현재** 배송비)을 탄다.
+ * 이 키를 만나면 배송비 환불·차감이 0이고 `orders.delivery_fee_settlements`에 항목을 만들지 않는다.
+ * 정책 지문 키(`b:…`)와 겹치지 않는다.
+ */
+export declare const NO_SHIPPING_BUNDLE_KEY = "none";
+/** 배송비 유형 — 무료·유료·조건부 무료 */
+export declare const deliveryTypeSchema: z.ZodEnum<{
+  FREE: "FREE";
+  PAID: "PAID";
+  CONDITIONAL_FREE: "CONDITIONAL_FREE";
+}>;
+export type DeliveryType = z.infer<typeof deliveryTypeSchema>;
+/** 파일 다운로드 기본값 — 횟수 5회·기간 30일(#48 결정 8) */
+export declare const DOWNLOAD_DEFAULTS: {
+  readonly limit: 5;
+  readonly days: 30;
+};
+/**
+ * 상품 이행 — 등록(POST). 유형 키를 생략하면 그 유형의 기본값이다(`{ "type": "DOWNLOAD" }`만으로 등록할 수 있다).
+ */
+export declare const productFulfillmentCreateSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  type: z.ZodLiteral<"SHIPPING">;
+  shipping: z.ZodOptional<z.ZodObject<{
+    deliveryType: z.ZodDefault<z.ZodEnum<{
+      FREE: "FREE";
+      PAID: "PAID";
+      CONDITIONAL_FREE: "CONDITIONAL_FREE";
+    }>>;
+    deliveryFee: z.ZodOptional<z.ZodNumber>;
+    conditionalFreeAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    shippingAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    returnAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+  type: z.ZodLiteral<"DOWNLOAD">;
+  download: z.ZodDefault<z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+    days: z.ZodDefault<z.ZodNumber>;
+    stockTracking: z.ZodDefault<z.ZodBoolean>;
+    withdrawalRestricted: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+  type: z.ZodLiteral<"CODE">;
+  code: z.ZodDefault<z.ZodObject<{
+    mode: z.ZodDefault<z.ZodEnum<{
+      AUTO: "AUTO";
+      MANUAL: "MANUAL";
+    }>>;
+    withdrawalRestricted: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+  type: z.ZodLiteral<"SERVICE">;
+  service: z.ZodDefault<z.ZodObject<{
+    mode: z.ZodDefault<z.ZodEnum<{
+      AUTO: "AUTO";
+      MANUAL: "MANUAL";
+    }>>;
+  }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+  type: z.ZodLiteral<"PICKUP">;
+  pickup: z.ZodDefault<z.ZodObject<{
+    addressId: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>>;
+}, z.core.$strict>], "type">;
+export type ProductFulfillmentCreate = z.infer<typeof productFulfillmentCreateSchema>;
+/** 등록 요청의 입력 모양 — 기본값이 채워지기 전(생략 가능한 필드가 optional) */
+export type ProductFulfillmentCreateInput = z.input<typeof productFulfillmentCreateSchema>;
+/**
+ * 상품 이행 — 수정(PUT·PATCH). 통째 교체이고 유형 키와 그 안의 필드가 **모두 필수**다. 서버는 현재 값과 병합하지 않는다.
+ * `fulfillment` 자체를 생략하면 이행을 바꾸지 않는다.
+ */
+export declare const productFulfillmentUpdateSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  type: z.ZodLiteral<"SHIPPING">;
+  shipping: z.ZodObject<{
+    deliveryType: z.ZodEnum<{
+      FREE: "FREE";
+      PAID: "PAID";
+      CONDITIONAL_FREE: "CONDITIONAL_FREE";
+    }>;
+    deliveryFee: z.ZodNumber;
+    conditionalFreeAmount: z.ZodNullable<z.ZodNumber>;
+    shippingAddressId: z.ZodNullable<z.ZodString>;
+    returnAddressId: z.ZodNullable<z.ZodString>;
+  }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+  type: z.ZodLiteral<"DOWNLOAD">;
+  download: z.ZodObject<{
+    limit: z.ZodNumber;
+    days: z.ZodNumber;
+    stockTracking: z.ZodBoolean;
+    withdrawalRestricted: z.ZodBoolean;
+  }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+  type: z.ZodLiteral<"CODE">;
+  code: z.ZodObject<{
+    mode: z.ZodEnum<{
+      AUTO: "AUTO";
+      MANUAL: "MANUAL";
+    }>;
+    withdrawalRestricted: z.ZodBoolean;
+  }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+  type: z.ZodLiteral<"SERVICE">;
+  service: z.ZodObject<{
+    mode: z.ZodEnum<{
+      AUTO: "AUTO";
+      MANUAL: "MANUAL";
+    }>;
+  }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+  type: z.ZodLiteral<"PICKUP">;
+  pickup: z.ZodObject<{
+    addressId: z.ZodString;
+  }, z.core.$strict>;
+}, z.core.$strict>], "type">;
+export type ProductFulfillmentUpdate = z.infer<typeof productFulfillmentUpdateSchema>;
+/**
+ * 저장된 상품 이행 — 알려진 유형의 닫힌 유니온. 서버의 상품 엔티티와 응답이 이 모양을 쓴다.
+ * 응답 파싱은 `productFulfillmentResponseSchema`(열린 유니온)를 쓴다.
+ */
+export declare const productFulfillmentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  type: z.ZodLiteral<"SHIPPING">;
+  shipping: z.ZodObject<{
+    deliveryType: z.ZodEnum<{
+      FREE: "FREE";
+      PAID: "PAID";
+      CONDITIONAL_FREE: "CONDITIONAL_FREE";
+    }>;
+    deliveryFee: z.ZodNumber;
+    conditionalFreeAmount: z.ZodNullable<z.ZodNumber>;
+    shippingAddressId: z.ZodNullable<z.ZodString>;
+    returnAddressId: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"DOWNLOAD">;
+  download: z.ZodObject<{
+    limit: z.ZodNumber;
+    days: z.ZodNumber;
+    stockTracking: z.ZodBoolean;
+    withdrawalRestricted: z.ZodBoolean;
+  }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"CODE">;
+  code: z.ZodObject<{
+    mode: z.ZodEnum<{
+      AUTO: "AUTO";
+      MANUAL: "MANUAL";
+    }>;
+    withdrawalRestricted: z.ZodBoolean;
+  }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"SERVICE">;
+  service: z.ZodObject<{
+    mode: z.ZodEnum<{
+      AUTO: "AUTO";
+      MANUAL: "MANUAL";
+    }>;
+  }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"PICKUP">;
+  pickup: z.ZodObject<{
+    addressId: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>;
+}, z.core.$strip>], "type">;
+export type ProductFulfillment = z.infer<typeof productFulfillmentSchema>;
+/** 유형 이름 → 그 유형의 저장된 이행 */
+export type ProductFulfillmentOf<T extends FulfillmentType> = Extract<ProductFulfillment, {
+  type: T;
+}>;
+/** 응답이 알려 주는 모르는 유형 — SDK가 아직 모르는 유형(서버가 나중에 더한 유형) */
+export interface UnknownFulfillment {
+  type: "OTHER";
+  /** 서버가 보낸 유형 이름 */
+  rawType: string;
+}
+/**
+ * 열린 응답 유니온 — 알려진 유형은 판별 유니온으로 검사하고, **모르는 유형만** `{ type: "OTHER", rawType }`로 읽는다.
+ *
+ * `type: z.string()` 가지를 그대로 두면 TS가 `type === "SHIPPING"`으로 좁혀도 문자열 가지가 남는다. `OTHER` 리터럴로 바꿔 좁히기를
+ * 지킨다. 알려진 유형의 모양이 틀린 응답은 폴백으로 숨기지 않고 파싱 오류로 둔다.
+ */
+export declare function openFulfillmentUnion<T extends z.ZodType>(known: T): z.ZodUnion<readonly [T, z.ZodPipe<z.ZodObject<{
+  type: z.ZodString;
+}, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
+  [x: string]: unknown;
+  type: string;
+}>>]>;
+export declare const productFulfillmentResponseSchema: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+  type: z.ZodLiteral<"SHIPPING">;
+  shipping: z.ZodObject<{
+    deliveryType: z.ZodEnum<{
+      FREE: "FREE";
+      PAID: "PAID";
+      CONDITIONAL_FREE: "CONDITIONAL_FREE";
+    }>;
+    deliveryFee: z.ZodNumber;
+    conditionalFreeAmount: z.ZodNullable<z.ZodNumber>;
+    shippingAddressId: z.ZodNullable<z.ZodString>;
+    returnAddressId: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"DOWNLOAD">;
+  download: z.ZodObject<{
+    limit: z.ZodNumber;
+    days: z.ZodNumber;
+    stockTracking: z.ZodBoolean;
+    withdrawalRestricted: z.ZodBoolean;
+  }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"CODE">;
+  code: z.ZodObject<{
+    mode: z.ZodEnum<{
+      AUTO: "AUTO";
+      MANUAL: "MANUAL";
+    }>;
+    withdrawalRestricted: z.ZodBoolean;
+  }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"SERVICE">;
+  service: z.ZodObject<{
+    mode: z.ZodEnum<{
+      AUTO: "AUTO";
+      MANUAL: "MANUAL";
+    }>;
+  }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"PICKUP">;
+  pickup: z.ZodObject<{
+    addressId: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>;
+}, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
+  type: z.ZodString;
+}, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
+  [x: string]: unknown;
+  type: string;
+}>>]>;
+export type ProductFulfillmentView = z.infer<typeof productFulfillmentResponseSchema>;
+/** 제공 방식 — CODE·SERVICE는 저장된 값, DOWNLOAD는 AUTO, PICKUP은 MANUAL, 배송 상품은 null */
+export declare function fulfillmentModeOf(fulfillment: ProductFulfillment): FulfillmentMode | null;
+/** 재고를 세는가 — 파일 다운로드만 끌 수 있다 */
+export declare function stockTrackingOf(fulfillment: ProductFulfillment): boolean;
+/** 청약철회 제한 대상인가 — 파일 다운로드·코드 발급만 켤 수 있다(전자상거래법 제17조 제2항 제5호, 디지털 콘텐츠) */
+export declare function withdrawalRestrictedOf(fulfillment: ProductFulfillment): boolean;
+/** 코드 풀을 쓰는가 — 코드 발급 + 자동 제공. 재고가 판매 가능 코드 수다 */
+export declare function usesCodePool(fulfillment: ProductFulfillment): boolean;
+/** 결제 확정과 함께 제공까지 끝내는가 — 비실물 + 자동 제공 */
+export declare function autoFulfillableOf(fulfillment: ProductFulfillment): boolean;
+/**
+ * 주문상품의 주문 시점 이행 — 결제 확정이 주문서 줄에서 굳힌다. 상품의 현재 값이 아니다. 서버는 주문상품 컬럼
+ * (`fulfillment_type`·`delivery_bundle_key`·`stock_tracked`·`withdrawal_restricted`)과 jsonb(`fulfillment_snapshot`)를 합쳐 이 모양을 만든다.
+ *
+ * `mode`는 **주문 시점 상품의 방식**이다. 실제 제공 방식은 제공 기록(`fulfillment.mode`)에 있고 다를 수 있다(자동 제공 상품의 수동 복구).
+ */
+export declare const orderItemFulfillmentSnapshotSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  type: z.ZodLiteral<"SHIPPING">;
+  shipping: z.ZodObject<{
+    bundleKey: z.ZodNullable<z.ZodString>;
+    returnAddressId: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"DOWNLOAD">;
+  download: z.ZodObject<{
+    limit: z.ZodNumber;
+    days: z.ZodNumber;
+    stockTracked: z.ZodBoolean;
+    withdrawalRestricted: z.ZodBoolean;
+  }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"CODE">;
+  code: z.ZodObject<{
+    mode: z.ZodString;
+    withdrawalRestricted: z.ZodBoolean;
+  }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"SERVICE">;
+  service: z.ZodObject<{
+    mode: z.ZodString;
+  }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"PICKUP">;
+  pickup: z.ZodObject<{
+    addressId: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>;
+}, z.core.$strip>], "type">;
+export type OrderItemFulfillmentSnapshot = z.infer<typeof orderItemFulfillmentSnapshotSchema>;
+export declare const orderItemFulfillmentSnapshotResponseSchema: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+  type: z.ZodLiteral<"SHIPPING">;
+  shipping: z.ZodObject<{
+    bundleKey: z.ZodNullable<z.ZodString>;
+    returnAddressId: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"DOWNLOAD">;
+  download: z.ZodObject<{
+    limit: z.ZodNumber;
+    days: z.ZodNumber;
+    stockTracked: z.ZodBoolean;
+    withdrawalRestricted: z.ZodBoolean;
+  }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"CODE">;
+  code: z.ZodObject<{
+    mode: z.ZodString;
+    withdrawalRestricted: z.ZodBoolean;
+  }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"SERVICE">;
+  service: z.ZodObject<{
+    mode: z.ZodString;
+  }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"PICKUP">;
+  pickup: z.ZodObject<{
+    addressId: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>;
+}, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
+  type: z.ZodString;
+}, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
+  [x: string]: unknown;
+  type: string;
+}>>]>;
+export type OrderItemFulfillmentSnapshotView = z.infer<typeof orderItemFulfillmentSnapshotResponseSchema>;
+//#endregion
+//#region src/schemas/order.d.ts
+export declare const orderSummarySchema: z.ZodObject<{
+  orderId: z.ZodString;
+  ordererName: z.ZodString;
+  itemCount: z.ZodNumber;
+  totalAmount: z.ZodNumber;
+  representativeStatus: z.ZodEnum<{
+    PAID: "PAID";
+    CANCELED: "CANCELED";
+    PAYMENT_WAITING: "PAYMENT_WAITING";
+    CONFIRMED: "CONFIRMED";
+    DISPATCHED: "DISPATCHED";
+    DELIVERING: "DELIVERING";
+    DELIVERED: "DELIVERED";
+    PURCHASE_DECIDED: "PURCHASE_DECIDED";
+  }>;
+  orderedAt: z.ZodString;
+  testPayment: z.ZodBoolean;
+}, z.core.$strip>;
+export type OrderSummary = z.infer<typeof orderSummarySchema>;
+export declare const shippingAddressSchema: z.ZodObject<{
+  receiverName: z.ZodString;
+  phone: z.ZodString;
+  zipCode: z.ZodString;
+  address1: z.ZodString;
+  address2: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  deliveryMemo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  entranceCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type ShippingAddress = z.infer<typeof shippingAddressSchema>;
+/** 비실물 주문상품의 제공 정보 (이슈 #48) */
+export declare const orderItemFulfillmentSchema: z.ZodObject<{
+  status: z.ZodString;
+  mode: z.ZodNullable<z.ZodString>;
+  fulfilledAt: z.ZodString;
+  note: z.ZodNullable<z.ZodString>;
+  codes: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+    codeId: z.ZodString;
+    hint: z.ZodString;
+    status: z.ZodString;
+    revealedAt: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>>>;
+  download: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    count: z.ZodNumber;
+    limit: z.ZodNumber;
+    expiresAt: z.ZodNullable<z.ZodString>;
+    firstDownloadedAt: z.ZodNullable<z.ZodString>;
+    files: z.ZodArray<z.ZodObject<{
+      assetId: z.ZodString;
+      fileName: z.ZodString;
+      sizeBytes: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>>>;
+  mail: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    status: z.ZodString;
+    sentAt: z.ZodNullable<z.ZodString>;
+    errorCode: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>>>;
+}, z.core.$strip>;
+/** 제공 안내 메일 재발송 결과 */
+export declare const fulfillmentMailResendSchema: z.ZodObject<{
+  mailStatus: z.ZodString;
+}, z.core.$strip>;
+export type FulfillmentMailResend = z.infer<typeof fulfillmentMailResendSchema>;
+export type OrderItemFulfillment = z.infer<typeof orderItemFulfillmentSchema>;
+export declare const orderItemSchema: z.ZodObject<{
+  orderItemId: z.ZodString;
+  orderId: 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";
+  }>;
+  claimStatus: z.ZodNullable<z.ZodEnum<{
+    CANCEL_REQUESTED: "CANCEL_REQUESTED";
+    RETURN_REQUESTED: "RETURN_REQUESTED";
+    EXCHANGE_REQUESTED: "EXCHANGE_REQUESTED";
+  }>>;
+  productId: z.ZodString;
+  productName: z.ZodString;
+  optionId: z.ZodNullable<z.ZodString>;
+  optionName: z.ZodNullable<z.ZodString>;
+  sellerCode: z.ZodNullable<z.ZodString>;
+  fulfillmentSnapshot: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"SHIPPING">;
+    shipping: z.ZodObject<{
+      bundleKey: z.ZodNullable<z.ZodString>;
+      returnAddressId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"DOWNLOAD">;
+    download: z.ZodObject<{
+      limit: z.ZodNumber;
+      days: z.ZodNumber;
+      stockTracked: z.ZodBoolean;
+      withdrawalRestricted: z.ZodBoolean;
+    }, z.core.$strip>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"CODE">;
+    code: z.ZodObject<{
+      mode: z.ZodString;
+      withdrawalRestricted: z.ZodBoolean;
+    }, z.core.$strip>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"SERVICE">;
+    service: z.ZodObject<{
+      mode: z.ZodString;
+    }, z.core.$strip>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"PICKUP">;
+    pickup: z.ZodObject<{
+      addressId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+  }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
+    type: z.ZodString;
+  }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
+    [x: string]: unknown;
+    type: string;
+  }>>]>;
+  quantity: z.ZodNumber;
+  canceledQuantity: z.ZodNumber;
+  activeQuantity: z.ZodNumber;
+  unitPrice: z.ZodNumber;
+  discountAmount: z.ZodNumber;
+  totalPrice: z.ZodNumber;
+  couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+  hold: z.ZodNullable<z.ZodObject<{
+    reason: z.ZodString;
+    expectedDispatchDate: z.ZodString;
+  }, z.core.$strip>>;
+  fulfillment: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    status: z.ZodString;
+    mode: z.ZodNullable<z.ZodString>;
+    fulfilledAt: z.ZodString;
+    note: z.ZodNullable<z.ZodString>;
+    codes: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+      codeId: z.ZodString;
+      hint: z.ZodString;
+      status: z.ZodString;
+      revealedAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>>>;
+    download: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+      count: z.ZodNumber;
+      limit: z.ZodNumber;
+      expiresAt: z.ZodNullable<z.ZodString>;
+      firstDownloadedAt: z.ZodNullable<z.ZodString>;
+      files: z.ZodArray<z.ZodObject<{
+        assetId: z.ZodString;
+        fileName: z.ZodString;
+        sizeBytes: z.ZodNullable<z.ZodNumber>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>>>;
+    mail: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+      status: z.ZodString;
+      sentAt: z.ZodNullable<z.ZodString>;
+      errorCode: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>>>;
+  }, z.core.$strip>>>>;
+  autoDecisionDate: z.ZodNullable<z.ZodString>;
+  sellerMemo: z.ZodNullable<z.ZodString>;
+  orderedAt: z.ZodString;
+  lastChangedAt: z.ZodString;
+  lastChangedType: z.ZodEnum<{
+    "ORDER.PAID": "ORDER.PAID";
+    "ORDER.CONFIRMED": "ORDER.CONFIRMED";
+    "ORDER.DISPATCHED": "ORDER.DISPATCHED";
     "ORDER.DELIVERED": "ORDER.DELIVERED";
     "ORDER.PURCHASE_DECIDED": "ORDER.PURCHASE_DECIDED";
     "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
@@ -2746,6 +3732,15 @@ export declare const orderItemSchema: z.ZodObject<{
   testPayment: z.ZodBoolean;
 }, z.core.$strip>;
 export type OrderItem = z.infer<typeof orderItemSchema>;
+/** 주문이 받은 쿠폰 한 장 (이슈 #47) */
+export declare const orderDiscountSchema: z.ZodObject<{
+  couponId: z.ZodString;
+  name: z.ZodString;
+  kind: z.ZodString;
+  discountAmount: z.ZodNumber;
+  issueId: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type OrderDiscount = z.infer<typeof orderDiscountSchema>;
 export declare const orderSchema: z.ZodObject<{
   orderId: z.ZodString;
   orderedAt: z.ZodString;
@@ -2754,6 +3749,7 @@ export declare const orderSchema: z.ZodObject<{
     phone: z.ZodString;
     email: z.ZodOptional<z.ZodEmail>;
   }, z.core.$strip>;
+  requiresShipping: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
   shippingAddress: z.ZodObject<{
     receiverName: z.ZodString;
     phone: z.ZodString;
@@ -2777,6 +3773,15 @@ export declare const orderSchema: z.ZodObject<{
     productAmount: z.ZodNumber;
     deliveryFee: z.ZodNumber;
     discountAmount: z.ZodNumber;
+    couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    deliveryDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    discounts: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+      couponId: z.ZodString;
+      name: z.ZodString;
+      kind: z.ZodString;
+      discountAmount: z.ZodNumber;
+      issueId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>>>;
     totalAmount: z.ZodNumber;
     paidAt: z.ZodNullable<z.ZodString>;
     cashReceipt: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
@@ -2802,6 +3807,7 @@ export declare const orderSchema: z.ZodObject<{
       updatedAt: z.ZodString;
     }, z.core.$strip>>>>;
   }, z.core.$strip>;
+  withdrawalAgreedAt: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
   testPayment: z.ZodBoolean;
   items: z.ZodArray<z.ZodObject<{
     orderItemId: z.ZodString;
@@ -2826,16 +3832,81 @@ export declare const orderSchema: z.ZodObject<{
     optionId: z.ZodNullable<z.ZodString>;
     optionName: z.ZodNullable<z.ZodString>;
     sellerCode: z.ZodNullable<z.ZodString>;
+    fulfillmentSnapshot: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+      type: z.ZodLiteral<"SHIPPING">;
+      shipping: z.ZodObject<{
+        bundleKey: z.ZodNullable<z.ZodString>;
+        returnAddressId: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"DOWNLOAD">;
+      download: z.ZodObject<{
+        limit: z.ZodNumber;
+        days: z.ZodNumber;
+        stockTracked: z.ZodBoolean;
+        withdrawalRestricted: z.ZodBoolean;
+      }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"CODE">;
+      code: z.ZodObject<{
+        mode: z.ZodString;
+        withdrawalRestricted: z.ZodBoolean;
+      }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"SERVICE">;
+      service: z.ZodObject<{
+        mode: z.ZodString;
+      }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"PICKUP">;
+      pickup: z.ZodObject<{
+        addressId: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>;
+    }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
+      type: z.ZodString;
+    }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
+      [x: string]: unknown;
+      type: string;
+    }>>]>;
     quantity: z.ZodNumber;
     canceledQuantity: z.ZodNumber;
     activeQuantity: z.ZodNumber;
     unitPrice: z.ZodNumber;
     discountAmount: z.ZodNumber;
     totalPrice: z.ZodNumber;
+    couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     hold: z.ZodNullable<z.ZodObject<{
       reason: z.ZodString;
       expectedDispatchDate: z.ZodString;
     }, z.core.$strip>>;
+    fulfillment: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+      status: z.ZodString;
+      mode: z.ZodNullable<z.ZodString>;
+      fulfilledAt: z.ZodString;
+      note: z.ZodNullable<z.ZodString>;
+      codes: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        codeId: z.ZodString;
+        hint: z.ZodString;
+        status: z.ZodString;
+        revealedAt: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>>>>;
+      download: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        count: z.ZodNumber;
+        limit: z.ZodNumber;
+        expiresAt: z.ZodNullable<z.ZodString>;
+        firstDownloadedAt: z.ZodNullable<z.ZodString>;
+        files: z.ZodArray<z.ZodObject<{
+          assetId: z.ZodString;
+          fileName: z.ZodString;
+          sizeBytes: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>>;
+      }, z.core.$strip>>>>;
+      mail: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        status: z.ZodString;
+        sentAt: z.ZodNullable<z.ZodString>;
+        errorCode: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>>>>;
+    }, z.core.$strip>>>>;
     autoDecisionDate: z.ZodNullable<z.ZodString>;
     sellerMemo: z.ZodNullable<z.ZodString>;
     orderedAt: z.ZodString;
@@ -2911,16 +3982,81 @@ export declare const orderItemPageSchema: z.ZodObject<{
     optionId: z.ZodNullable<z.ZodString>;
     optionName: z.ZodNullable<z.ZodString>;
     sellerCode: z.ZodNullable<z.ZodString>;
+    fulfillmentSnapshot: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+      type: z.ZodLiteral<"SHIPPING">;
+      shipping: z.ZodObject<{
+        bundleKey: z.ZodNullable<z.ZodString>;
+        returnAddressId: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"DOWNLOAD">;
+      download: z.ZodObject<{
+        limit: z.ZodNumber;
+        days: z.ZodNumber;
+        stockTracked: z.ZodBoolean;
+        withdrawalRestricted: z.ZodBoolean;
+      }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"CODE">;
+      code: z.ZodObject<{
+        mode: z.ZodString;
+        withdrawalRestricted: z.ZodBoolean;
+      }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"SERVICE">;
+      service: z.ZodObject<{
+        mode: z.ZodString;
+      }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"PICKUP">;
+      pickup: z.ZodObject<{
+        addressId: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>;
+    }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
+      type: z.ZodString;
+    }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
+      [x: string]: unknown;
+      type: string;
+    }>>]>;
     quantity: z.ZodNumber;
     canceledQuantity: z.ZodNumber;
     activeQuantity: z.ZodNumber;
     unitPrice: z.ZodNumber;
     discountAmount: z.ZodNumber;
     totalPrice: z.ZodNumber;
+    couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     hold: z.ZodNullable<z.ZodObject<{
       reason: z.ZodString;
       expectedDispatchDate: z.ZodString;
     }, z.core.$strip>>;
+    fulfillment: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+      status: z.ZodString;
+      mode: z.ZodNullable<z.ZodString>;
+      fulfilledAt: z.ZodString;
+      note: z.ZodNullable<z.ZodString>;
+      codes: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        codeId: z.ZodString;
+        hint: z.ZodString;
+        status: z.ZodString;
+        revealedAt: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>>>>;
+      download: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        count: z.ZodNumber;
+        limit: z.ZodNumber;
+        expiresAt: z.ZodNullable<z.ZodString>;
+        firstDownloadedAt: z.ZodNullable<z.ZodString>;
+        files: z.ZodArray<z.ZodObject<{
+          assetId: z.ZodString;
+          fileName: z.ZodString;
+          sizeBytes: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>>;
+      }, z.core.$strip>>>>;
+      mail: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        status: z.ZodString;
+        sentAt: z.ZodNullable<z.ZodString>;
+        errorCode: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>>>>;
+    }, z.core.$strip>>>>;
     autoDecisionDate: z.ZodNullable<z.ZodString>;
     sellerMemo: z.ZodNullable<z.ZodString>;
     orderedAt: z.ZodString;
@@ -2962,6 +4098,7 @@ export declare const orderListQuerySchema: z.ZodObject<{
     PURCHASE_DECIDED: "PURCHASE_DECIDED";
   }>>;
   keyword: z.ZodOptional<z.ZodString>;
+  fulfillmentType: z.ZodOptional<z.ZodString>;
   testPayment: z.ZodOptional<z.ZodEnum<{
     true: "true";
     false: "false";
@@ -2998,6 +4135,8 @@ export interface OrderListParams extends PageParams {
   orderedTo?: string;
   status?: z.infer<typeof orderItemStatusSchema>;
   keyword?: string;
+  /** 상품 유형 필터 — 이 유형의 주문상품이 하나라도 있는 주문(이슈 #48) */
+  fulfillmentType?: string;
   /** 테스트 결제 필터 — `"true"` 테스트 결제만, `"false"` 실결제만, 생략하면 전부 */
   testPayment?: "true" | "false";
 }
@@ -3122,6 +4261,21 @@ export declare const cancelBySellerRequestSchema: z.ZodObject<{
   quantity: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type CancelBySellerRequest = z.infer<typeof cancelBySellerRequestSchema>;
+/**
+ * 제공 처리 요청 (이슈 #48) — `POST /v1/order-items/{orderItemId}/fulfill`. 수동 제공 비실물 주문상품(이용권·방문 수령 등)을
+ * 제공 완료(`DELIVERED`)로 바꾼다.
+ */
+export declare const fulfillRequestSchema: z.ZodObject<{
+  note: z.ZodOptional<z.ZodString>;
+  codes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type FulfillRequest = z.infer<typeof fulfillRequestSchema>;
+/** 제공 처리 일괄 요청 — `POST /v1/order-items/fulfill` */
+export declare const fulfillBulkRequestSchema: z.ZodObject<{
+  orderItemIds: z.ZodArray<z.ZodString>;
+  note: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type FulfillBulkRequest = z.infer<typeof fulfillBulkRequestSchema>;
 /** `POST /v1/order-items/{orderItemId}/cancel` 응답 — 셀러 직권취소 환불 결과 */
 export declare const cancelBySellerResultSchema: z.ZodObject<{
   orderItemId: z.ZodString;
@@ -3130,6 +4284,8 @@ export declare const cancelBySellerResultSchema: z.ZodObject<{
   canceledQuantity: z.ZodNumber;
   deliveryFeeRefundAmount: z.ZodNumber;
   deliveryFeeChargeAmount: z.ZodNumber;
+  couponChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+  couponChargeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   refundedAt: z.ZodString;
 }, z.core.$strip>;
 export type CancelBySellerResult = z.infer<typeof cancelBySellerResultSchema>;
@@ -4166,26 +5322,20 @@ export interface PaymentListParams extends PageParams {
 //#endregion
 //#region src/schemas/product.d.ts
 export declare const productStatusSchema: z.ZodEnum<{
-  SALE: "SALE";
   SUSPENDED: "SUSPENDED";
-  OUT_OF_STOCK: "OUT_OF_STOCK";
   CLOSED: "CLOSED";
+  SALE: "SALE";
+  OUT_OF_STOCK: "OUT_OF_STOCK";
 }>;
 export type ProductStatus = z.infer<typeof productStatusSchema>;
-export declare const deliveryTypeSchema: z.ZodEnum<{
-  FREE: "FREE";
-  PAID: "PAID";
-  CONDITIONAL_FREE: "CONDITIONAL_FREE";
-}>;
-export type DeliveryType = z.infer<typeof deliveryTypeSchema>;
 export declare const productSummarySchema: z.ZodObject<{
   productId: z.ZodString;
   name: z.ZodString;
   status: z.ZodEnum<{
-    SALE: "SALE";
     SUSPENDED: "SUSPENDED";
-    OUT_OF_STOCK: "OUT_OF_STOCK";
     CLOSED: "CLOSED";
+    SALE: "SALE";
+    OUT_OF_STOCK: "OUT_OF_STOCK";
   }>;
   salePrice: z.ZodNumber;
   discountedPrice: z.ZodNullable<z.ZodNumber>;
@@ -4193,6 +5343,9 @@ export declare const productSummarySchema: z.ZodObject<{
   categoryId: z.ZodNullable<z.ZodString>;
   thumbnailUrl: z.ZodOptional<z.ZodURL>;
   hasOptions: z.ZodBoolean;
+  fulfillment: z.ZodObject<{
+    type: z.ZodString;
+  }, z.core.$strip>;
   updatedAt: z.ZodString;
 }, z.core.$strip>;
 export type ProductSummary = z.infer<typeof productSummarySchema>;
@@ -4233,14 +5386,26 @@ export declare const productVariantSchema: z.ZodObject<{
   usable: z.ZodBoolean;
 }, z.core.$strip>;
 export type ProductVariant = z.infer<typeof productVariantSchema>;
+export declare const discountSchema: z.ZodObject<{
+  productId: z.ZodString;
+  discountType: z.ZodEnum<{
+    RATE: "RATE";
+    AMOUNT: "AMOUNT";
+  }>;
+  discountValue: z.ZodNumber;
+  discountedPrice: z.ZodNumber;
+  startAt: z.ZodNullable<z.ZodString>;
+  endAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type Discount = z.infer<typeof discountSchema>;
 export declare const productSchema: z.ZodObject<{
   productId: z.ZodString;
   name: z.ZodString;
   status: z.ZodEnum<{
-    SALE: "SALE";
     SUSPENDED: "SUSPENDED";
-    OUT_OF_STOCK: "OUT_OF_STOCK";
     CLOSED: "CLOSED";
+    SALE: "SALE";
+    OUT_OF_STOCK: "OUT_OF_STOCK";
   }>;
   salePrice: z.ZodNumber;
   discountedPrice: z.ZodNullable<z.ZodNumber>;
@@ -4280,24 +5445,74 @@ export declare const productSchema: z.ZodObject<{
     sellerCode: z.ZodNullable<z.ZodString>;
     usable: z.ZodBoolean;
   }, z.core.$strip>>;
-  deliveryType: z.ZodOptional<z.ZodEnum<{
-    FREE: "FREE";
-    PAID: "PAID";
-    CONDITIONAL_FREE: "CONDITIONAL_FREE";
-  }>>;
-  deliveryFee: z.ZodOptional<z.ZodNumber>;
-  conditionalFreeAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-  returnFee: z.ZodOptional<z.ZodNumber>;
-  exchangeFee: z.ZodOptional<z.ZodNumber>;
-  refundPolicy: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+  fulfillment: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"SHIPPING">;
+    shipping: z.ZodObject<{
+      deliveryType: z.ZodEnum<{
+        FREE: "FREE";
+        PAID: "PAID";
+        CONDITIONAL_FREE: "CONDITIONAL_FREE";
+      }>;
+      deliveryFee: z.ZodNumber;
+      conditionalFreeAmount: z.ZodNullable<z.ZodNumber>;
+      shippingAddressId: z.ZodNullable<z.ZodString>;
+      returnAddressId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"DOWNLOAD">;
+    download: z.ZodObject<{
+      limit: z.ZodNumber;
+      days: z.ZodNumber;
+      stockTracking: z.ZodBoolean;
+      withdrawalRestricted: z.ZodBoolean;
+    }, z.core.$strip>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"CODE">;
+    code: z.ZodObject<{
+      mode: z.ZodEnum<{
+        AUTO: "AUTO";
+        MANUAL: "MANUAL";
+      }>;
+      withdrawalRestricted: z.ZodBoolean;
+    }, z.core.$strip>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"SERVICE">;
+    service: z.ZodObject<{
+      mode: z.ZodEnum<{
+        AUTO: "AUTO";
+        MANUAL: "MANUAL";
+      }>;
+    }, z.core.$strip>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"PICKUP">;
+    pickup: z.ZodObject<{
+      addressId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+  }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
+    type: z.ZodString;
+  }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
+    [x: string]: unknown;
+    type: string;
+  }>>]>;
+  fulfillmentTypeLocked: z.ZodBoolean;
+  refundPolicy: z.ZodNullable<z.ZodObject<{
     preShipmentDeliveryFeeRefund: z.ZodOptional<z.ZodBoolean>;
     returnDeliveryFee: z.ZodOptional<z.ZodNumber>;
     exchangeDeliveryFee: z.ZodOptional<z.ZodNumber>;
     sellerFaultFreeShipping: z.ZodOptional<z.ZodBoolean>;
     conditionalFreeShortfallCharge: z.ZodOptional<z.ZodBoolean>;
-  }, z.core.$strict>>>;
-  shippingAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-  returnAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  }, z.core.$strict>>;
+  discount: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    productId: z.ZodString;
+    discountType: z.ZodEnum<{
+      RATE: "RATE";
+      AMOUNT: "AMOUNT";
+    }>;
+    discountValue: z.ZodNumber;
+    discountedPrice: z.ZodNumber;
+    startAt: z.ZodNullable<z.ZodString>;
+    endAt: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>>;
   createdAt: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type Product = z.infer<typeof productSchema>;
@@ -4433,6 +5648,70 @@ export declare const variantStockSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type VariantStock = z.infer<typeof variantStockSchema>;
 export declare const productCreateRequestSchema: z.ZodObject<{
+  fulfillment: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"SHIPPING">;
+    shipping: z.ZodOptional<z.ZodObject<{
+      deliveryType: z.ZodDefault<z.ZodEnum<{
+        FREE: "FREE";
+        PAID: "PAID";
+        CONDITIONAL_FREE: "CONDITIONAL_FREE";
+      }>>;
+      deliveryFee: z.ZodOptional<z.ZodNumber>;
+      conditionalFreeAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      shippingAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      returnAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>;
+  }, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"DOWNLOAD">;
+    download: z.ZodDefault<z.ZodObject<{
+      limit: z.ZodDefault<z.ZodNumber>;
+      days: z.ZodDefault<z.ZodNumber>;
+      stockTracking: z.ZodDefault<z.ZodBoolean>;
+      withdrawalRestricted: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>;
+  }, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"CODE">;
+    code: z.ZodDefault<z.ZodObject<{
+      mode: z.ZodDefault<z.ZodEnum<{
+        AUTO: "AUTO";
+        MANUAL: "MANUAL";
+      }>>;
+      withdrawalRestricted: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>;
+  }, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"SERVICE">;
+    service: z.ZodDefault<z.ZodObject<{
+      mode: z.ZodDefault<z.ZodEnum<{
+        AUTO: "AUTO";
+        MANUAL: "MANUAL";
+      }>>;
+    }, z.core.$strict>>;
+  }, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"PICKUP">;
+    pickup: z.ZodDefault<z.ZodObject<{
+      addressId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+  }, z.core.$strict>], "type">>;
+  optionGroups: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    groupId: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    values: z.ZodArray<z.ZodObject<{
+      valueId: z.ZodOptional<z.ZodString>;
+      name: z.ZodString;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>>;
+  variants: z.ZodArray<z.ZodObject<{
+    variantId: z.ZodOptional<z.ZodString>;
+    valueNames: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    additionalPrice: z.ZodDefault<z.ZodNumber>;
+    stockQuantity: z.ZodOptional<z.ZodNumber>;
+    sku: z.ZodOptional<z.ZodString>;
+    barcode: z.ZodOptional<z.ZodString>;
+    costPrice: z.ZodOptional<z.ZodNumber>;
+    weightGram: z.ZodOptional<z.ZodNumber>;
+    sellerCode: z.ZodOptional<z.ZodString>;
+    usable: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strip>>;
   name: z.ZodString;
   categoryId: z.ZodString;
   salePrice: z.ZodNumber;
@@ -4444,15 +5723,6 @@ export declare const productCreateRequestSchema: z.ZodObject<{
     attributeId: z.ZodString;
     value: z.ZodString;
   }, z.core.$strip>>>;
-  deliveryType: z.ZodDefault<z.ZodEnum<{
-    FREE: "FREE";
-    PAID: "PAID";
-    CONDITIONAL_FREE: "CONDITIONAL_FREE";
-  }>>;
-  deliveryFee: z.ZodOptional<z.ZodNumber>;
-  conditionalFreeAmount: z.ZodOptional<z.ZodNumber>;
-  returnFee: z.ZodDefault<z.ZodNumber>;
-  exchangeFee: z.ZodDefault<z.ZodNumber>;
   refundPolicy: z.ZodOptional<z.ZodNullable<z.ZodObject<{
     preShipmentDeliveryFeeRefund: z.ZodOptional<z.ZodBoolean>;
     returnDeliveryFee: z.ZodOptional<z.ZodNumber>;
@@ -4460,8 +5730,55 @@ export declare const productCreateRequestSchema: z.ZodObject<{
     sellerFaultFreeShipping: z.ZodOptional<z.ZodBoolean>;
     conditionalFreeShortfallCharge: z.ZodOptional<z.ZodBoolean>;
   }, z.core.$strict>>>;
-  shippingAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-  returnAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export type ProductCreateRequest = z.infer<typeof productCreateRequestSchema>;
+export type ProductCreateRequestInput = z.input<typeof productCreateRequestSchema>;
+/** 전체 수정(PUT) — 공통 필드는 등록과 같고, 이행은 생략하면 현재 값 유지, 주면 필드가 모두 필수다 */
+export declare const productReplaceRequestSchema: z.ZodObject<{
+  fulfillment: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"SHIPPING">;
+    shipping: z.ZodObject<{
+      deliveryType: z.ZodEnum<{
+        FREE: "FREE";
+        PAID: "PAID";
+        CONDITIONAL_FREE: "CONDITIONAL_FREE";
+      }>;
+      deliveryFee: z.ZodNumber;
+      conditionalFreeAmount: z.ZodNullable<z.ZodNumber>;
+      shippingAddressId: z.ZodNullable<z.ZodString>;
+      returnAddressId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+  }, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"DOWNLOAD">;
+    download: z.ZodObject<{
+      limit: z.ZodNumber;
+      days: z.ZodNumber;
+      stockTracking: z.ZodBoolean;
+      withdrawalRestricted: z.ZodBoolean;
+    }, z.core.$strict>;
+  }, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"CODE">;
+    code: z.ZodObject<{
+      mode: z.ZodEnum<{
+        AUTO: "AUTO";
+        MANUAL: "MANUAL";
+      }>;
+      withdrawalRestricted: z.ZodBoolean;
+    }, z.core.$strict>;
+  }, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"SERVICE">;
+    service: z.ZodObject<{
+      mode: z.ZodEnum<{
+        AUTO: "AUTO";
+        MANUAL: "MANUAL";
+      }>;
+    }, z.core.$strict>;
+  }, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"PICKUP">;
+    pickup: z.ZodObject<{
+      addressId: z.ZodString;
+    }, z.core.$strict>;
+  }, z.core.$strict>], "type">>;
   optionGroups: z.ZodDefault<z.ZodArray<z.ZodObject<{
     groupId: z.ZodOptional<z.ZodString>;
     name: z.ZodString;
@@ -4482,21 +5799,88 @@ export declare const productCreateRequestSchema: z.ZodObject<{
     sellerCode: z.ZodOptional<z.ZodString>;
     usable: z.ZodDefault<z.ZodBoolean>;
   }, z.core.$strip>>;
-}, z.core.$strip>;
-export type ProductCreateRequest = z.infer<typeof productCreateRequestSchema>;
+  name: z.ZodString;
+  categoryId: z.ZodString;
+  salePrice: z.ZodNumber;
+  originalPrice: z.ZodOptional<z.ZodNumber>;
+  description: z.ZodOptional<z.ZodString>;
+  descriptionJson: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  images: z.ZodOptional<z.ZodArray<z.ZodURL>>;
+  attributes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    attributeId: z.ZodString;
+    value: z.ZodString;
+  }, z.core.$strip>>>;
+  refundPolicy: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    preShipmentDeliveryFeeRefund: z.ZodOptional<z.ZodBoolean>;
+    returnDeliveryFee: z.ZodOptional<z.ZodNumber>;
+    exchangeDeliveryFee: z.ZodOptional<z.ZodNumber>;
+    sellerFaultFreeShipping: z.ZodOptional<z.ZodBoolean>;
+    conditionalFreeShortfallCharge: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type ProductReplaceRequest = z.infer<typeof productReplaceRequestSchema>;
+export type ProductReplaceRequestInput = z.input<typeof productReplaceRequestSchema>;
 export declare const productPatchRequestSchema: z.ZodObject<{
   name: z.ZodOptional<z.ZodString>;
   salePrice: z.ZodOptional<z.ZodNumber>;
   status: z.ZodOptional<z.ZodEnum<{
-    SALE: "SALE";
     SUSPENDED: "SUSPENDED";
-    OUT_OF_STOCK: "OUT_OF_STOCK";
     CLOSED: "CLOSED";
+    SALE: "SALE";
+    OUT_OF_STOCK: "OUT_OF_STOCK";
   }>>;
-  deliveryFee: z.ZodOptional<z.ZodNumber>;
-  shippingAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-  returnAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, z.core.$strip>;
+  fulfillment: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"SHIPPING">;
+    shipping: z.ZodObject<{
+      deliveryType: z.ZodEnum<{
+        FREE: "FREE";
+        PAID: "PAID";
+        CONDITIONAL_FREE: "CONDITIONAL_FREE";
+      }>;
+      deliveryFee: z.ZodNumber;
+      conditionalFreeAmount: z.ZodNullable<z.ZodNumber>;
+      shippingAddressId: z.ZodNullable<z.ZodString>;
+      returnAddressId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+  }, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"DOWNLOAD">;
+    download: z.ZodObject<{
+      limit: z.ZodNumber;
+      days: z.ZodNumber;
+      stockTracking: z.ZodBoolean;
+      withdrawalRestricted: z.ZodBoolean;
+    }, z.core.$strict>;
+  }, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"CODE">;
+    code: z.ZodObject<{
+      mode: z.ZodEnum<{
+        AUTO: "AUTO";
+        MANUAL: "MANUAL";
+      }>;
+      withdrawalRestricted: z.ZodBoolean;
+    }, z.core.$strict>;
+  }, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"SERVICE">;
+    service: z.ZodObject<{
+      mode: z.ZodEnum<{
+        AUTO: "AUTO";
+        MANUAL: "MANUAL";
+      }>;
+    }, z.core.$strict>;
+  }, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"PICKUP">;
+    pickup: z.ZodObject<{
+      addressId: z.ZodString;
+    }, z.core.$strict>;
+  }, z.core.$strict>], "type">>;
+  refundPolicy: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    preShipmentDeliveryFeeRefund: z.ZodOptional<z.ZodBoolean>;
+    returnDeliveryFee: z.ZodOptional<z.ZodNumber>;
+    exchangeDeliveryFee: z.ZodOptional<z.ZodNumber>;
+    sellerFaultFreeShipping: z.ZodOptional<z.ZodBoolean>;
+    conditionalFreeShortfallCharge: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strict>>>;
+}, z.core.$strict>;
 export type ProductPatchRequest = z.infer<typeof productPatchRequestSchema>;
 export declare const productSortSchema: z.ZodEnum<{
   "createdAt.desc": "createdAt.desc";
@@ -4518,10 +5902,10 @@ export declare const productListQuerySchema: z.ZodObject<{
   page: z.ZodOptional<z.ZodString>;
   size: z.ZodOptional<z.ZodString>;
   status: z.ZodOptional<z.ZodEnum<{
-    SALE: "SALE";
     SUSPENDED: "SUSPENDED";
-    OUT_OF_STOCK: "OUT_OF_STOCK";
     CLOSED: "CLOSED";
+    SALE: "SALE";
+    OUT_OF_STOCK: "OUT_OF_STOCK";
   }>>;
   categoryId: z.ZodOptional<z.ZodString>;
   keyword: z.ZodOptional<z.ZodString>;
@@ -4534,18 +5918,6 @@ export declare const productListQuerySchema: z.ZodObject<{
     "updatedAt.desc": "updatedAt.desc";
   }>>;
 }, z.core.$strip>;
-export declare const discountSchema: z.ZodObject<{
-  productId: z.ZodString;
-  discountType: z.ZodEnum<{
-    RATE: "RATE";
-    AMOUNT: "AMOUNT";
-  }>;
-  discountValue: z.ZodNumber;
-  discountedPrice: z.ZodNumber;
-  startAt: z.ZodNullable<z.ZodString>;
-  endAt: z.ZodNullable<z.ZodString>;
-}, z.core.$strip>;
-export type Discount = z.infer<typeof discountSchema>;
 export declare const discountRequestSchema: z.ZodObject<{
   discountType: z.ZodEnum<{
     RATE: "RATE";
@@ -4597,6 +5969,8 @@ export declare const updateStoreRequestSchema: z.ZodObject<{
   analyticsAllowedOrigins: z.ZodOptional<z.ZodArray<z.ZodString>>;
   storefrontOrigins: z.ZodOptional<z.ZodArray<z.ZodString>>;
   guestCheckoutEnabled: z.ZodOptional<z.ZodBoolean>;
+  fulfillmentMailEnabled: z.ZodOptional<z.ZodBoolean>;
+  withdrawalNotice: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   autoDeliverDays: z.ZodOptional<z.ZodNumber>;
   autoConfirmDays: z.ZodOptional<z.ZodNumber>;
   refundPolicy: z.ZodOptional<z.ZodObject<{
@@ -4605,6 +5979,7 @@ export declare const updateStoreRequestSchema: z.ZodObject<{
     exchangeDeliveryFee: z.ZodOptional<z.ZodNumber>;
     sellerFaultFreeShipping: z.ZodOptional<z.ZodBoolean>;
     conditionalFreeShortfallCharge: z.ZodOptional<z.ZodBoolean>;
+    couponShortfallCharge: z.ZodOptional<z.ZodBoolean>;
   }, z.core.$strict>>;
   shippingPolicy: z.ZodOptional<z.ZodObject<{
     baseDeliveryFee: z.ZodOptional<z.ZodNumber>;
@@ -4634,6 +6009,8 @@ export declare const storeSchema: z.ZodObject<{
   analyticsAllowedOrigins: z.ZodArray<z.ZodString>;
   storefrontOrigins: z.ZodArray<z.ZodString>;
   guestCheckoutEnabled: z.ZodBoolean;
+  fulfillmentMailEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+  withdrawalNotice: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
   autoDeliverDays: z.ZodNumber;
   autoConfirmDays: z.ZodNumber;
   refundPolicy: z.ZodObject<{
@@ -4642,6 +6019,7 @@ export declare const storeSchema: z.ZodObject<{
     exchangeDeliveryFee: z.ZodNumber;
     sellerFaultFreeShipping: z.ZodBoolean;
     conditionalFreeShortfallCharge: z.ZodBoolean;
+    couponShortfallCharge: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
   }, z.core.$strip>;
   shippingPolicy: z.ZodObject<{
     baseDeliveryFee: z.ZodNumber;
@@ -4664,9 +6042,9 @@ export declare const storeMemberSchema: z.ZodObject<{
   name: z.ZodString;
   email: z.ZodEmail;
   role: z.ZodEnum<{
+    OWNER: "OWNER";
     ADMIN: "ADMIN";
     STAFF: "STAFF";
-    OWNER: "OWNER";
   }>;
   joinedAt: z.ZodString;
   lastActiveAt: z.ZodNullable<z.ZodString>;
@@ -4691,8 +6069,8 @@ export declare const invitationSchema: z.ZodObject<{
     STAFF: "STAFF";
   }>;
   status: z.ZodEnum<{
-    PENDING: "PENDING";
     EXPIRED: "EXPIRED";
+    PENDING: "PENDING";
     ACCEPTED: "ACCEPTED";
     CANCELED: "CANCELED";
   }>;
@@ -4731,8 +6109,8 @@ export type UpdateMemberRoleRequest = z.infer<typeof updateMemberRoleRequestSche
 /** `GET /v1/store/invitations` 쿼리 — OpenAPI 문서용 형태 */
 export declare const invitationListQuerySchema: z.ZodObject<{
   status: z.ZodOptional<z.ZodEnum<{
-    PENDING: "PENDING";
     EXPIRED: "EXPIRED";
+    PENDING: "PENDING";
     ACCEPTED: "ACCEPTED";
     CANCELED: "CANCELED";
   }>>;
@@ -4746,23 +6124,30 @@ export declare const storeMemberRoleUpdatedSchema: z.ZodObject<{
   }>;
 }, z.core.$strip>;
 export type StoreMemberRoleUpdated = z.infer<typeof storeMemberRoleUpdatedSchema>;
+/**
+ * 주소 유형 — 출고지·반품지·방문 수령지(이슈 #48). 방문 수령지(`PICKUP`)는 목록에서 `type=PICKUP`으로 조회할 때만 나온다
+ * (이 값을 모르는 옛 SDK의 목록 파싱이 깨지지 않게).
+ */
 export declare const addressTypeSchema: z.ZodEnum<{
-  RETURN: "RETURN";
   SHIPPING: "SHIPPING";
+  PICKUP: "PICKUP";
+  RETURN: "RETURN";
 }>;
 export type AddressType = z.infer<typeof addressTypeSchema>;
 /** `GET /v1/seller-addresses` 쿼리 — OpenAPI 문서용 형태. 기본 주소 우선, 그다음 등록순이다 */
 export declare const sellerAddressListQuerySchema: z.ZodObject<{
   type: z.ZodOptional<z.ZodEnum<{
-    RETURN: "RETURN";
     SHIPPING: "SHIPPING";
+    PICKUP: "PICKUP";
+    RETURN: "RETURN";
   }>>;
 }, z.core.$strip>;
 export declare const sellerAddressSchema: z.ZodObject<{
   addressId: z.ZodString;
   type: z.ZodEnum<{
-    RETURN: "RETURN";
     SHIPPING: "SHIPPING";
+    PICKUP: "PICKUP";
+    RETURN: "RETURN";
   }>;
   name: z.ZodString;
   isDefault: z.ZodBoolean;
@@ -4776,8 +6161,9 @@ export declare const sellerAddressSchema: z.ZodObject<{
 export type SellerAddress = z.infer<typeof sellerAddressSchema>;
 export declare const sellerAddressRequestSchema: z.ZodObject<{
   type: z.ZodEnum<{
-    RETURN: "RETURN";
     SHIPPING: "SHIPPING";
+    PICKUP: "PICKUP";
+    RETURN: "RETURN";
   }>;
   name: z.ZodString;
   contactName: z.ZodString;
@@ -4794,10 +6180,13 @@ export type SellerAddressRequest = z.infer<typeof sellerAddressRequestSchema>;
  *
  * - `product-image`: 상품 목록·상세의 상품 이미지. 목록 썸네일로 쓰이므로 정지 이미지만 받는다.
  * - `description`: 상세설명 본문에 삽입하는 미디어. 동영상과 svg도 받는다.
+ * - `digital-asset`: 파일 다운로드 상품의 판매 파일(이슈 #48). **비공개 객체**로 올라가고 공개 주소가 없다 — 구매자는 제공된
+ *   주문상품에서 수명 300초의 서명 주소로만 받는다.
  */
 export declare const uploadPurposeSchema: z.ZodEnum<{
   "product-image": "product-image";
   description: "description";
+  "digital-asset": "digital-asset";
 }>;
 export type UploadPurpose = z.infer<typeof uploadPurposeSchema>;
 export interface UploadPurposeLimit {
@@ -4812,6 +6201,8 @@ export interface UploadPurposeLimit {
  * 직접 PUT되므로 이 검사는 셀러가 올리기 전에 알게 하는 장치이고, 실제 상한은 CDN이 강제한다.
  */
 export declare const UPLOAD_PURPOSE_LIMITS: Record<UploadPurpose, UploadPurposeLimit>;
+/** 비공개 업로드(판매 파일)의 PUT 필수 헤더 — CDN이 이 값으로 공개 조회를 막는다 */
+export declare const PRIVATE_UPLOAD_HEADERS: Readonly<Record<string, string>>;
 /** 파일명의 소문자 확장자. 확장자가 없으면 `""` */
 export declare function uploadExtensionOf(filename: string): string;
 export interface UploadRejection {
@@ -4837,6 +6228,7 @@ export declare const uploadRequestSchema: z.ZodObject<{
   purpose: z.ZodDefault<z.ZodEnum<{
     "product-image": "product-image";
     description: "description";
+    "digital-asset": "digital-asset";
   }>>;
   size: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
@@ -4844,6 +6236,8 @@ export type UploadRequest = z.infer<typeof uploadRequestSchema>;
 export declare const uploadTicketSchema: z.ZodObject<{
   url: z.ZodURL;
   uploadUrl: z.ZodURL;
+  key: z.ZodOptional<z.ZodString>;
+  headers: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
 }, z.core.$strip>;
 export type UploadTicket = z.infer<typeof uploadTicketSchema>;
 //#endregion
@@ -4988,7 +6382,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       storeId: string;
       storeName: string;
       storeCode: string;
-      role: "ADMIN" | "STAFF" | "OWNER";
+      role: "OWNER" | "ADMIN" | "STAFF";
       status: "ACTIVE" | "SUSPENDED" | "CLOSED";
     }[]>;
     /** RFC 7009 — token을 폐기한다 (public client는 client_id만 동반) */
@@ -5125,6 +6519,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
     create: (body: UploadRequest) => Promise<{
       url: string;
       uploadUrl: string;
+      headers: Record<string, string>;
+      key?: string | undefined;
     }>;
     /**
      * 자리 발급 + 바이트 PUT을 한 번에 — 끝나면 `url`이 공개 주소다.
@@ -5146,12 +6542,15 @@ export declare function createStoreClient(options: StoreClientOptions): {
       contents: {
         productId: string;
         name: string;
-        status: "SALE" | "SUSPENDED" | "OUT_OF_STOCK" | "CLOSED";
+        status: "SUSPENDED" | "CLOSED" | "SALE" | "OUT_OF_STOCK";
         salePrice: number;
         discountedPrice: number | null;
         stockQuantity: number;
         categoryId: string | null;
         hasOptions: boolean;
+        fulfillment: {
+          type: string;
+        };
         updatedAt: string;
         thumbnailUrl?: string | undefined;
       }[];
@@ -5159,7 +6558,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     get: (productId: string) => Promise<{
       productId: string;
       name: string;
-      status: "SALE" | "SUSPENDED" | "OUT_OF_STOCK" | "CLOSED";
+      status: "SUSPENDED" | "CLOSED" | "SALE" | "OUT_OF_STOCK";
       salePrice: number;
       discountedPrice: number | null;
       stockQuantity: number;
@@ -5189,6 +6588,48 @@ export declare function createStoreClient(options: StoreClientOptions): {
         sellerCode: string | null;
         usable: boolean;
       }[];
+      fulfillment: UnknownFulfillment | {
+        type: "SHIPPING";
+        shipping: {
+          deliveryType: "FREE" | "PAID" | "CONDITIONAL_FREE";
+          deliveryFee: number;
+          conditionalFreeAmount: number | null;
+          shippingAddressId: string | null;
+          returnAddressId: string | null;
+        };
+      } | {
+        type: "DOWNLOAD";
+        download: {
+          limit: number;
+          days: number;
+          stockTracking: boolean;
+          withdrawalRestricted: boolean;
+        };
+      } | {
+        type: "CODE";
+        code: {
+          mode: "AUTO" | "MANUAL";
+          withdrawalRestricted: boolean;
+        };
+      } | {
+        type: "SERVICE";
+        service: {
+          mode: "AUTO" | "MANUAL";
+        };
+      } | {
+        type: "PICKUP";
+        pickup: {
+          addressId: string | null;
+        };
+      };
+      fulfillmentTypeLocked: boolean;
+      refundPolicy: {
+        preShipmentDeliveryFeeRefund?: boolean | undefined;
+        returnDeliveryFee?: number | undefined;
+        exchangeDeliveryFee?: number | undefined;
+        sellerFaultFreeShipping?: boolean | undefined;
+        conditionalFreeShortfallCharge?: boolean | undefined;
+      } | null;
       thumbnailUrl?: string | undefined;
       description?: string | undefined;
       descriptionJson?: string | null | undefined;
@@ -5198,26 +6639,20 @@ export declare function createStoreClient(options: StoreClientOptions): {
         attributeId: string;
         value: string;
       }[] | undefined;
-      deliveryType?: "FREE" | "PAID" | "CONDITIONAL_FREE" | undefined;
-      deliveryFee?: number | undefined;
-      conditionalFreeAmount?: number | null | undefined;
-      returnFee?: number | undefined;
-      exchangeFee?: number | undefined;
-      refundPolicy?: {
-        preShipmentDeliveryFeeRefund?: boolean | undefined;
-        returnDeliveryFee?: number | undefined;
-        exchangeDeliveryFee?: number | undefined;
-        sellerFaultFreeShipping?: boolean | undefined;
-        conditionalFreeShortfallCharge?: boolean | undefined;
+      discount?: {
+        productId: string;
+        discountType: "RATE" | "AMOUNT";
+        discountValue: number;
+        discountedPrice: number;
+        startAt: string | null;
+        endAt: string | null;
       } | null | undefined;
-      shippingAddressId?: string | null | undefined;
-      returnAddressId?: string | null | undefined;
       createdAt?: string | undefined;
     }>;
-    create: (body: ProductCreateRequest, idempotencyKey?: string) => Promise<{
+    create: (body: ProductCreateRequestInput, idempotencyKey?: string) => Promise<{
       productId: string;
       name: string;
-      status: "SALE" | "SUSPENDED" | "OUT_OF_STOCK" | "CLOSED";
+      status: "SUSPENDED" | "CLOSED" | "SALE" | "OUT_OF_STOCK";
       salePrice: number;
       discountedPrice: number | null;
       stockQuantity: number;
@@ -5247,6 +6682,48 @@ export declare function createStoreClient(options: StoreClientOptions): {
         sellerCode: string | null;
         usable: boolean;
       }[];
+      fulfillment: UnknownFulfillment | {
+        type: "SHIPPING";
+        shipping: {
+          deliveryType: "FREE" | "PAID" | "CONDITIONAL_FREE";
+          deliveryFee: number;
+          conditionalFreeAmount: number | null;
+          shippingAddressId: string | null;
+          returnAddressId: string | null;
+        };
+      } | {
+        type: "DOWNLOAD";
+        download: {
+          limit: number;
+          days: number;
+          stockTracking: boolean;
+          withdrawalRestricted: boolean;
+        };
+      } | {
+        type: "CODE";
+        code: {
+          mode: "AUTO" | "MANUAL";
+          withdrawalRestricted: boolean;
+        };
+      } | {
+        type: "SERVICE";
+        service: {
+          mode: "AUTO" | "MANUAL";
+        };
+      } | {
+        type: "PICKUP";
+        pickup: {
+          addressId: string | null;
+        };
+      };
+      fulfillmentTypeLocked: boolean;
+      refundPolicy: {
+        preShipmentDeliveryFeeRefund?: boolean | undefined;
+        returnDeliveryFee?: number | undefined;
+        exchangeDeliveryFee?: number | undefined;
+        sellerFaultFreeShipping?: boolean | undefined;
+        conditionalFreeShortfallCharge?: boolean | undefined;
+      } | null;
       thumbnailUrl?: string | undefined;
       description?: string | undefined;
       descriptionJson?: string | null | undefined;
@@ -5256,26 +6733,20 @@ export declare function createStoreClient(options: StoreClientOptions): {
         attributeId: string;
         value: string;
       }[] | undefined;
-      deliveryType?: "FREE" | "PAID" | "CONDITIONAL_FREE" | undefined;
-      deliveryFee?: number | undefined;
-      conditionalFreeAmount?: number | null | undefined;
-      returnFee?: number | undefined;
-      exchangeFee?: number | undefined;
-      refundPolicy?: {
-        preShipmentDeliveryFeeRefund?: boolean | undefined;
-        returnDeliveryFee?: number | undefined;
-        exchangeDeliveryFee?: number | undefined;
-        sellerFaultFreeShipping?: boolean | undefined;
-        conditionalFreeShortfallCharge?: boolean | undefined;
+      discount?: {
+        productId: string;
+        discountType: "RATE" | "AMOUNT";
+        discountValue: number;
+        discountedPrice: number;
+        startAt: string | null;
+        endAt: string | null;
       } | null | undefined;
-      shippingAddressId?: string | null | undefined;
-      returnAddressId?: string | null | undefined;
       createdAt?: string | undefined;
     }>;
-    update: (productId: string, body: ProductCreateRequest) => Promise<{
+    update: (productId: string, body: ProductReplaceRequestInput) => Promise<{
       productId: string;
       name: string;
-      status: "SALE" | "SUSPENDED" | "OUT_OF_STOCK" | "CLOSED";
+      status: "SUSPENDED" | "CLOSED" | "SALE" | "OUT_OF_STOCK";
       salePrice: number;
       discountedPrice: number | null;
       stockQuantity: number;
@@ -5305,6 +6776,48 @@ export declare function createStoreClient(options: StoreClientOptions): {
         sellerCode: string | null;
         usable: boolean;
       }[];
+      fulfillment: UnknownFulfillment | {
+        type: "SHIPPING";
+        shipping: {
+          deliveryType: "FREE" | "PAID" | "CONDITIONAL_FREE";
+          deliveryFee: number;
+          conditionalFreeAmount: number | null;
+          shippingAddressId: string | null;
+          returnAddressId: string | null;
+        };
+      } | {
+        type: "DOWNLOAD";
+        download: {
+          limit: number;
+          days: number;
+          stockTracking: boolean;
+          withdrawalRestricted: boolean;
+        };
+      } | {
+        type: "CODE";
+        code: {
+          mode: "AUTO" | "MANUAL";
+          withdrawalRestricted: boolean;
+        };
+      } | {
+        type: "SERVICE";
+        service: {
+          mode: "AUTO" | "MANUAL";
+        };
+      } | {
+        type: "PICKUP";
+        pickup: {
+          addressId: string | null;
+        };
+      };
+      fulfillmentTypeLocked: boolean;
+      refundPolicy: {
+        preShipmentDeliveryFeeRefund?: boolean | undefined;
+        returnDeliveryFee?: number | undefined;
+        exchangeDeliveryFee?: number | undefined;
+        sellerFaultFreeShipping?: boolean | undefined;
+        conditionalFreeShortfallCharge?: boolean | undefined;
+      } | null;
       thumbnailUrl?: string | undefined;
       description?: string | undefined;
       descriptionJson?: string | null | undefined;
@@ -5314,20 +6827,14 @@ export declare function createStoreClient(options: StoreClientOptions): {
         attributeId: string;
         value: string;
       }[] | undefined;
-      deliveryType?: "FREE" | "PAID" | "CONDITIONAL_FREE" | undefined;
-      deliveryFee?: number | undefined;
-      conditionalFreeAmount?: number | null | undefined;
-      returnFee?: number | undefined;
-      exchangeFee?: number | undefined;
-      refundPolicy?: {
-        preShipmentDeliveryFeeRefund?: boolean | undefined;
-        returnDeliveryFee?: number | undefined;
-        exchangeDeliveryFee?: number | undefined;
-        sellerFaultFreeShipping?: boolean | undefined;
-        conditionalFreeShortfallCharge?: boolean | undefined;
+      discount?: {
+        productId: string;
+        discountType: "RATE" | "AMOUNT";
+        discountValue: number;
+        discountedPrice: number;
+        startAt: string | null;
+        endAt: string | null;
       } | null | undefined;
-      shippingAddressId?: string | null | undefined;
-      returnAddressId?: string | null | undefined;
       createdAt?: string | undefined;
     }>;
     patch: (productId: string, body: ProductPatchRequest) => Promise<void>;
@@ -5419,6 +6926,110 @@ export declare function createStoreClient(options: StoreClientOptions): {
       endAt: string | null;
     }>;
     removeDiscount: (productId: string) => Promise<void>;
+    /**
+     * 코드 일괄 업로드 (이슈 #48) — 코드 발급·자동 제공 상품의 코드 풀에 올린다. `codes`와 `csv` 중 하나만 보낸다.
+     * 받은 코드 수만큼 재고가 는다. 에러: 409 `NOT_CODE_PRODUCT`·`CODE_POOL_NOT_USED`·`CODE_UPLOAD_CONFLICT`, 400 `TOO_MANY_CODES`
+     */
+    uploadCodes: (productId: string, body: FulfillmentCodeUploadRequest, idempotencyKey?: string) => Promise<{
+      batchId: string;
+      productId: string;
+      variantId: string;
+      total: number;
+      accepted: number;
+      duplicates: number;
+      rejected: {
+        line: number;
+        reason: string;
+      }[];
+      expiresAt: string | null;
+      createdAt: string;
+    }>;
+    /** 코드 목록 — 가린 값(`hint`)만 싣는다. `available`은 필터와 무관한 판매 가능 코드 수다 */
+    listCodes: (productId: string, params?: PageParams & Omit<z.input<typeof fulfillmentCodeListQuerySchema>, "page" | "size">) => Promise<{
+      page: number;
+      size: number;
+      totalElements: number;
+      totalPages: number;
+      contents: {
+        codeId: string;
+        productId: string;
+        variantId: string;
+        batchId: string | null;
+        hint: string;
+        status: string;
+        orderItemId: string | null;
+        assignedAt: string | null;
+        revealedAt: string | null;
+        expiresAt: string | null;
+        createdAt: string;
+      }[];
+      available: number;
+    }>;
+    /** 판매 가능 코드 폐기 — 재고가 1 준다. 배정된 코드는 409 `CODE_NOT_AVAILABLE` */
+    voidCode: (productId: string, codeId: string) => Promise<{
+      codeId: string;
+      productId: string;
+      variantId: string;
+      batchId: string | null;
+      hint: string;
+      status: string;
+      orderItemId: string | null;
+      assignedAt: string | null;
+      revealedAt: string | null;
+      expiresAt: string | null;
+      createdAt: string;
+    }>;
+    /**
+     * 판매 파일 연결 (이슈 #48) — `uploads.create({ purpose: "digital-asset" })`로 받은 `key`에 파일을 올린 뒤 연결한다.
+     * 이후 주문부터 이 파일을 준다. 에러: 400 `INVALID_ASSET_KEY`, 409 `NOT_DOWNLOAD_PRODUCT`·`ASSET_ALREADY_ATTACHED`
+     */
+    attachDigitalAsset: (productId: string, body: DigitalAssetAttachRequest) => Promise<{
+      assetId: string;
+      productId: string;
+      variantId: string | null;
+      fileName: string;
+      contentType: string | null;
+      sizeBytes: number | null;
+      status: string;
+      createdAt: string;
+    }>;
+    /** 판매 파일 목록 — 해제한 파일도 싣는다. 객체 키·주소는 없다 */
+    listDigitalAssets: (productId: string) => Promise<{
+      assetId: string;
+      productId: string;
+      variantId: string | null;
+      fileName: string;
+      contentType: string | null;
+      sizeBytes: number | null;
+      status: string;
+      createdAt: string;
+    }[]>;
+    /** 판매 파일 해제 — 새 주문에 주지 않는다. 이미 산 구매자는 계속 받는다 */
+    removeDigitalAsset: (productId: string, assetId: string) => Promise<{
+      assetId: string;
+      productId: string;
+      variantId: string | null;
+      fileName: string;
+      contentType: string | null;
+      sizeBytes: number | null;
+      status: string;
+      createdAt: string;
+    }>;
+    /** 판매 파일 확인 주소 — 수명 300초의 서명 주소 */
+    previewDigitalAsset: (productId: string, assetId: string) => Promise<{
+      url: string;
+      expiresAt: string;
+    }>;
+  };
+  fulfillmentCodes: {
+    /**
+     * 코드 평문 열람 — 콘솔에서 로그인한 OWNER·ADMIN만 된다(403 `INSUFFICIENT_ROLE`). 열람 기록과 감사 로그가 남는다.
+     * 평문은 화면에 보인 뒤 저장하지 않는다
+     */
+    reveal: (codeId: string) => Promise<{
+      codeId: string;
+      code: string;
+    }>;
   };
   categories: {
     list: (params?: {
@@ -5601,6 +7212,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         phone: string;
         email?: string | undefined;
       };
+      requiresShipping: boolean;
       shippingAddress: {
         receiverName: string;
         phone: string;
@@ -5617,6 +7229,15 @@ export declare function createStoreClient(options: StoreClientOptions): {
         productAmount: number;
         deliveryFee: number;
         discountAmount: number;
+        couponDiscountAmount: number;
+        deliveryDiscountAmount: number;
+        discounts: {
+          couponId: string;
+          name: string;
+          kind: string;
+          discountAmount: number;
+          issueId: string | null;
+        }[];
         totalAmount: number;
         paidAt: string | null;
         cashReceipt: {
@@ -5639,6 +7260,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           updatedAt: string;
         } | null;
       };
+      withdrawalAgreedAt: string | null;
       testPayment: boolean;
       items: {
         orderItemId: string;
@@ -5650,16 +7272,76 @@ export declare function createStoreClient(options: StoreClientOptions): {
         optionId: string | null;
         optionName: string | null;
         sellerCode: string | null;
+        fulfillmentSnapshot: UnknownFulfillment | {
+          type: "SHIPPING";
+          shipping: {
+            bundleKey: string | null;
+            returnAddressId: string | null;
+          };
+        } | {
+          type: "DOWNLOAD";
+          download: {
+            limit: number;
+            days: number;
+            stockTracked: boolean;
+            withdrawalRestricted: boolean;
+          };
+        } | {
+          type: "CODE";
+          code: {
+            mode: string;
+            withdrawalRestricted: boolean;
+          };
+        } | {
+          type: "SERVICE";
+          service: {
+            mode: string;
+          };
+        } | {
+          type: "PICKUP";
+          pickup: {
+            addressId: string | null;
+          };
+        };
         quantity: number;
         canceledQuantity: number;
         activeQuantity: number;
         unitPrice: number;
         discountAmount: number;
         totalPrice: number;
+        couponDiscountAmount: number;
         hold: {
           reason: string;
           expectedDispatchDate: string;
         } | null;
+        fulfillment: {
+          status: string;
+          mode: string | null;
+          fulfilledAt: string;
+          note: string | null;
+          codes: {
+            codeId: string;
+            hint: string;
+            status: string;
+            revealedAt: string | null;
+          }[];
+          download: {
+            count: number;
+            limit: number;
+            expiresAt: string | null;
+            firstDownloadedAt: string | null;
+            files: {
+              assetId: string;
+              fileName: string;
+              sizeBytes: number | null;
+            }[];
+          } | null;
+          mail: {
+            status: string;
+            sentAt: string | null;
+            errorCode: string | null;
+          } | null;
+        } | null;
         autoDecisionDate: string | null;
         sellerMemo: string | null;
         orderedAt: string;
@@ -5709,16 +7391,76 @@ export declare function createStoreClient(options: StoreClientOptions): {
         optionId: string | null;
         optionName: string | null;
         sellerCode: string | null;
+        fulfillmentSnapshot: UnknownFulfillment | {
+          type: "SHIPPING";
+          shipping: {
+            bundleKey: string | null;
+            returnAddressId: string | null;
+          };
+        } | {
+          type: "DOWNLOAD";
+          download: {
+            limit: number;
+            days: number;
+            stockTracked: boolean;
+            withdrawalRestricted: boolean;
+          };
+        } | {
+          type: "CODE";
+          code: {
+            mode: string;
+            withdrawalRestricted: boolean;
+          };
+        } | {
+          type: "SERVICE";
+          service: {
+            mode: string;
+          };
+        } | {
+          type: "PICKUP";
+          pickup: {
+            addressId: string | null;
+          };
+        };
         quantity: number;
         canceledQuantity: number;
         activeQuantity: number;
         unitPrice: number;
         discountAmount: number;
         totalPrice: number;
+        couponDiscountAmount: number;
         hold: {
           reason: string;
           expectedDispatchDate: string;
         } | null;
+        fulfillment: {
+          status: string;
+          mode: string | null;
+          fulfilledAt: string;
+          note: string | null;
+          codes: {
+            codeId: string;
+            hint: string;
+            status: string;
+            revealedAt: string | null;
+          }[];
+          download: {
+            count: number;
+            limit: number;
+            expiresAt: string | null;
+            firstDownloadedAt: string | null;
+            files: {
+              assetId: string;
+              fileName: string;
+              sizeBytes: number | null;
+            }[];
+          } | null;
+          mail: {
+            status: string;
+            sentAt: string | null;
+            errorCode: string | null;
+          } | null;
+        } | null;
         autoDecisionDate: string | null;
         sellerMemo: string | null;
         orderedAt: string;
@@ -5747,6 +7489,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
       canceledQuantity: number;
       deliveryFeeRefundAmount: number;
       deliveryFeeChargeAmount: number;
+      couponChargeAmount: number;
+      couponChargeRefundAmount: number;
       refundedAt: string;
     }>;
     updateMemo: (orderItemId: string, memo: string) => Promise<void>;
@@ -5794,16 +7538,76 @@ export declare function createStoreClient(options: StoreClientOptions): {
       optionId: string | null;
       optionName: string | null;
       sellerCode: string | null;
+      fulfillmentSnapshot: UnknownFulfillment | {
+        type: "SHIPPING";
+        shipping: {
+          bundleKey: string | null;
+          returnAddressId: string | null;
+        };
+      } | {
+        type: "DOWNLOAD";
+        download: {
+          limit: number;
+          days: number;
+          stockTracked: boolean;
+          withdrawalRestricted: boolean;
+        };
+      } | {
+        type: "CODE";
+        code: {
+          mode: string;
+          withdrawalRestricted: boolean;
+        };
+      } | {
+        type: "SERVICE";
+        service: {
+          mode: string;
+        };
+      } | {
+        type: "PICKUP";
+        pickup: {
+          addressId: string | null;
+        };
+      };
       quantity: number;
       canceledQuantity: number;
       activeQuantity: number;
       unitPrice: number;
       discountAmount: number;
       totalPrice: number;
+      couponDiscountAmount: number;
       hold: {
         reason: string;
         expectedDispatchDate: string;
       } | null;
+      fulfillment: {
+        status: string;
+        mode: string | null;
+        fulfilledAt: string;
+        note: string | null;
+        codes: {
+          codeId: string;
+          hint: string;
+          status: string;
+          revealedAt: string | null;
+        }[];
+        download: {
+          count: number;
+          limit: number;
+          expiresAt: string | null;
+          firstDownloadedAt: string | null;
+          files: {
+            assetId: string;
+            fileName: string;
+            sizeBytes: number | null;
+          }[];
+        } | null;
+        mail: {
+          status: string;
+          sentAt: string | null;
+          errorCode: string | null;
+        } | null;
+      } | null;
       autoDecisionDate: string | null;
       sellerMemo: string | null;
       orderedAt: string;
@@ -5822,6 +7626,115 @@ export declare function createStoreClient(options: StoreClientOptions): {
         orderItemId?: string | undefined;
       }[];
     }>;
+    /**
+     * 제공 안내 메일 재발송 (이슈 #48) — 제공된 주문상품의 안내 메일을 다시 보낸다. 주문상품당 하루 3회(429).
+     * 코드·파일 주소는 메일에 없다
+     */
+    resendFulfillmentMail: (orderItemId: string) => Promise<{
+      mailStatus: string;
+    }>;
+    /**
+     * 제공 처리 (이슈 #48) — 수동 제공 비실물 주문상품(이용권·방문 수령)을 `PAID`·`CONFIRMED`에서 제공 완료(`DELIVERED`)로
+     * 바꾼다. `note`는 구매자 주문 상세에 이용 안내로 실린다. 배송 상품은 409 `SHIPPING_REQUIRED`
+     */
+    fulfill: (orderItemId: string, body?: FulfillRequest, idempotencyKey?: string) => Promise<{
+      orderItemId: string;
+      orderId: string;
+      status: "PAID" | "CANCELED" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED";
+      claimStatus: "CANCEL_REQUESTED" | "RETURN_REQUESTED" | "EXCHANGE_REQUESTED" | null;
+      productId: string;
+      productName: string;
+      optionId: string | null;
+      optionName: string | null;
+      sellerCode: string | null;
+      fulfillmentSnapshot: UnknownFulfillment | {
+        type: "SHIPPING";
+        shipping: {
+          bundleKey: string | null;
+          returnAddressId: string | null;
+        };
+      } | {
+        type: "DOWNLOAD";
+        download: {
+          limit: number;
+          days: number;
+          stockTracked: boolean;
+          withdrawalRestricted: boolean;
+        };
+      } | {
+        type: "CODE";
+        code: {
+          mode: string;
+          withdrawalRestricted: boolean;
+        };
+      } | {
+        type: "SERVICE";
+        service: {
+          mode: string;
+        };
+      } | {
+        type: "PICKUP";
+        pickup: {
+          addressId: string | null;
+        };
+      };
+      quantity: number;
+      canceledQuantity: number;
+      activeQuantity: number;
+      unitPrice: number;
+      discountAmount: number;
+      totalPrice: number;
+      couponDiscountAmount: number;
+      hold: {
+        reason: string;
+        expectedDispatchDate: string;
+      } | null;
+      fulfillment: {
+        status: string;
+        mode: string | null;
+        fulfilledAt: string;
+        note: string | null;
+        codes: {
+          codeId: string;
+          hint: string;
+          status: string;
+          revealedAt: string | null;
+        }[];
+        download: {
+          count: number;
+          limit: number;
+          expiresAt: string | null;
+          firstDownloadedAt: string | null;
+          files: {
+            assetId: string;
+            fileName: string;
+            sizeBytes: number | null;
+          }[];
+        } | null;
+        mail: {
+          status: string;
+          sentAt: string | null;
+          errorCode: string | null;
+        } | null;
+      } | null;
+      autoDecisionDate: string | null;
+      sellerMemo: string | null;
+      orderedAt: string;
+      lastChangedAt: string;
+      lastChangedType: "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";
+      testPayment: boolean;
+    }>;
+    /** 제공 처리 일괄 — 항목별 부분 성공이다 */
+    fulfillBulk: (orderItemIds: string[], body?: FulfillRequest, idempotencyKey?: string) => Promise<{
+      succeeded: string[];
+      failed: {
+        code: string;
+        message: string;
+        id?: string | undefined;
+        productId?: string | undefined;
+        orderItemId?: string | undefined;
+      }[];
+    }>;
     getDelivery: (orderItemId: string) => Promise<{
       orderItemId: string;
       deliveryMethod: "COURIER" | "DIRECT" | "QUICK" | "NOTHING";
@@ -5882,6 +7795,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           carrierCode: string | null;
           trackingNumber: string | null;
         } | null;
+        fulfillmentType: string;
         requestedAt: string;
         completedAt: string | null;
         holdExpiresAt: string | null;
@@ -5919,6 +7833,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         carrierCode: string | null;
         trackingNumber: string | null;
       } | null;
+      fulfillmentType: string;
       requestedAt: string;
       completedAt: string | null;
       holdExpiresAt: string | null;
@@ -5944,6 +7859,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
       quantity: number;
       deliveryFeeRefundAmount: number;
       deliveryFeeChargeAmount: number;
+      couponChargeAmount: number;
+      couponChargeRefundAmount: number;
       refundedAt: string;
     }>;
     reject: (claimId: string, body: RejectClaimRequest) => Promise<void>;
@@ -5982,6 +7899,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         carrierCode: string | null;
         trackingNumber: string | null;
       } | null;
+      fulfillmentType: string;
       requestedAt: string;
       completedAt: string | null;
       holdExpiresAt: string | null;
@@ -6011,7 +7929,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         productId: string;
         productName: string;
         orderItemId: string | null;
-        category: "ETC" | "DELIVERY" | "RETURN" | "EXCHANGE" | "PRODUCT";
+        category: "ETC" | "PRODUCT" | "DELIVERY" | "RETURN" | "EXCHANGE";
         content: string;
         secret: boolean;
         writerMaskedName: string;
@@ -6029,7 +7947,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       productId: string;
       productName: string;
       orderItemId: string | null;
-      category: "ETC" | "DELIVERY" | "RETURN" | "EXCHANGE" | "PRODUCT";
+      category: "ETC" | "PRODUCT" | "DELIVERY" | "RETURN" | "EXCHANGE";
       content: string;
       secret: boolean;
       writerMaskedName: string;
@@ -6222,45 +8140,432 @@ export declare function createStoreClient(options: StoreClientOptions): {
         inquiryCount: number;
       };
     }>;
-    orders: (customerId: string, params?: PageParams) => Promise<{
+    orders: (customerId: string, params?: PageParams) => Promise<{
+      page: number;
+      size: number;
+      totalElements: number;
+      totalPages: number;
+      contents: {
+        orderId: string;
+        orderedAt: string;
+        totalAmount: number;
+        testPayment: boolean;
+        items: {
+          orderItemId: string;
+          productName: string;
+          optionName: string | null;
+          quantity: number;
+          status: "PAID" | "CANCELED" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED";
+          claimStatus: "CANCEL_REQUESTED" | "RETURN_REQUESTED" | "EXCHANGE_REQUESTED" | null;
+        }[];
+      }[];
+    }>;
+    /** 동의 이력 — 최근 순. 가입·재동의·마케팅 변경이 한 줄씩 남는다 */
+    consents: (customerId: string, params?: PageParams & {
+      kind?: ConsentKind;
+    }) => Promise<{
+      page: number;
+      size: number;
+      totalElements: number;
+      totalPages: number;
+      contents: {
+        consentId: string;
+        kind: "TERMS" | "PRIVACY" | "MARKETING";
+        version: string | null;
+        documentUrl: string | null;
+        action: "WITHDRAWN" | "AGREED";
+        source: "SELLER" | "SIGNUP" | "SOCIAL_SIGNUP" | "DELEGATED" | "RECONSENT" | "MEMBER_UPDATE";
+        occurredAt: string;
+      }[];
+    }>;
+    /** 보유 쿠폰 (이슈 #47) — 최근 지급 순, 최대 500장 */
+    coupons: (customerId: string) => Promise<{
+      issueId: string;
+      couponId: string;
+      customerId: string;
+      customerName: string | null;
+      status: string;
+      validFrom: string;
+      validUntil: string | null;
+      usedOrderId: string | null;
+      issuedAt: string;
+      revokedAt: string | null;
+      couponName: string;
+      kind: "ORDER" | "PRODUCT" | "DELIVERY";
+      benefit: {
+        type: "RATE" | "AMOUNT";
+        value: number;
+        maxDiscountAmount: number | null;
+      };
+    }[]>;
+    withdraw: (customerId: string, body: WithdrawCustomerRequest) => Promise<void>;
+  };
+  /** 쿠폰 (이슈 #47) — 조회 `promotion:r`, 쓰기 `promotion:rw` */
+  coupons: {
+    list: (params?: PageParams & Omit<z.input<typeof couponListQuerySchema>, "page" | "size">) => Promise<{
+      page: number;
+      size: number;
+      totalElements: number;
+      totalPages: number;
+      contents: {
+        couponId: string;
+        name: string;
+        description: string | null;
+        kind: "ORDER" | "PRODUCT" | "DELIVERY";
+        benefit: {
+          type: "RATE" | "AMOUNT";
+          value: number;
+          maxDiscountAmount: number | null;
+        };
+        conditions: {
+          minOrderAmount: number;
+          firstOrderOnly: boolean;
+          memberOnly: boolean;
+          stackWithInstantDiscount: boolean;
+        };
+        target: {
+          includeProductIds: string[];
+          includeCategoryIds: string[];
+          excludeProductIds: string[];
+          excludeCategoryIds: string[];
+        };
+        issueMethod: string;
+        code: string | null;
+        startsAt: string | null;
+        endsAt: string | null;
+        validDaysAfterIssue: number | null;
+        totalIssueLimit: number | null;
+        totalUseLimit: number | null;
+        perMemberIssueLimit: number | null;
+        perMemberUseLimit: number | null;
+        issuedCount: number;
+        reservedCount: number;
+        usedCount: number;
+        status: "ACTIVE" | "PAUSED" | "ENDED";
+        locked: boolean;
+        lockedAt: string | null;
+        createdAt: string;
+        updatedAt: string;
+      }[];
+    }>;
+    create: (body: CreateCouponRequest, idempotencyKey?: string) => Promise<{
+      couponId: string;
+      name: string;
+      description: string | null;
+      kind: "ORDER" | "PRODUCT" | "DELIVERY";
+      benefit: {
+        type: "RATE" | "AMOUNT";
+        value: number;
+        maxDiscountAmount: number | null;
+      };
+      conditions: {
+        minOrderAmount: number;
+        firstOrderOnly: boolean;
+        memberOnly: boolean;
+        stackWithInstantDiscount: boolean;
+      };
+      target: {
+        includeProductIds: string[];
+        includeCategoryIds: string[];
+        excludeProductIds: string[];
+        excludeCategoryIds: string[];
+      };
+      issueMethod: string;
+      code: string | null;
+      startsAt: string | null;
+      endsAt: string | null;
+      validDaysAfterIssue: number | null;
+      totalIssueLimit: number | null;
+      totalUseLimit: number | null;
+      perMemberIssueLimit: number | null;
+      perMemberUseLimit: number | null;
+      issuedCount: number;
+      reservedCount: number;
+      usedCount: number;
+      status: "ACTIVE" | "PAUSED" | "ENDED";
+      locked: boolean;
+      lockedAt: string | null;
+      createdAt: string;
+      updatedAt: string;
+    }>;
+    get: (couponId: string) => Promise<{
+      couponId: string;
+      name: string;
+      description: string | null;
+      kind: "ORDER" | "PRODUCT" | "DELIVERY";
+      benefit: {
+        type: "RATE" | "AMOUNT";
+        value: number;
+        maxDiscountAmount: number | null;
+      };
+      conditions: {
+        minOrderAmount: number;
+        firstOrderOnly: boolean;
+        memberOnly: boolean;
+        stackWithInstantDiscount: boolean;
+      };
+      target: {
+        includeProductIds: string[];
+        includeCategoryIds: string[];
+        excludeProductIds: string[];
+        excludeCategoryIds: string[];
+      };
+      issueMethod: string;
+      code: string | null;
+      startsAt: string | null;
+      endsAt: string | null;
+      validDaysAfterIssue: number | null;
+      totalIssueLimit: number | null;
+      totalUseLimit: number | null;
+      perMemberIssueLimit: number | null;
+      perMemberUseLimit: number | null;
+      issuedCount: number;
+      reservedCount: number;
+      usedCount: number;
+      status: "ACTIVE" | "PAUSED" | "ENDED";
+      locked: boolean;
+      lockedAt: string | null;
+      createdAt: string;
+      updatedAt: string;
+    }>;
+    update: (couponId: string, body: UpdateCouponRequest) => Promise<{
+      couponId: string;
+      name: string;
+      description: string | null;
+      kind: "ORDER" | "PRODUCT" | "DELIVERY";
+      benefit: {
+        type: "RATE" | "AMOUNT";
+        value: number;
+        maxDiscountAmount: number | null;
+      };
+      conditions: {
+        minOrderAmount: number;
+        firstOrderOnly: boolean;
+        memberOnly: boolean;
+        stackWithInstantDiscount: boolean;
+      };
+      target: {
+        includeProductIds: string[];
+        includeCategoryIds: string[];
+        excludeProductIds: string[];
+        excludeCategoryIds: string[];
+      };
+      issueMethod: string;
+      code: string | null;
+      startsAt: string | null;
+      endsAt: string | null;
+      validDaysAfterIssue: number | null;
+      totalIssueLimit: number | null;
+      totalUseLimit: number | null;
+      perMemberIssueLimit: number | null;
+      perMemberUseLimit: number | null;
+      issuedCount: number;
+      reservedCount: number;
+      usedCount: number;
+      status: "ACTIVE" | "PAUSED" | "ENDED";
+      locked: boolean;
+      lockedAt: string | null;
+      createdAt: string;
+      updatedAt: string;
+    }>;
+    pause: (couponId: string) => Promise<{
+      couponId: string;
+      name: string;
+      description: string | null;
+      kind: "ORDER" | "PRODUCT" | "DELIVERY";
+      benefit: {
+        type: "RATE" | "AMOUNT";
+        value: number;
+        maxDiscountAmount: number | null;
+      };
+      conditions: {
+        minOrderAmount: number;
+        firstOrderOnly: boolean;
+        memberOnly: boolean;
+        stackWithInstantDiscount: boolean;
+      };
+      target: {
+        includeProductIds: string[];
+        includeCategoryIds: string[];
+        excludeProductIds: string[];
+        excludeCategoryIds: string[];
+      };
+      issueMethod: string;
+      code: string | null;
+      startsAt: string | null;
+      endsAt: string | null;
+      validDaysAfterIssue: number | null;
+      totalIssueLimit: number | null;
+      totalUseLimit: number | null;
+      perMemberIssueLimit: number | null;
+      perMemberUseLimit: number | null;
+      issuedCount: number;
+      reservedCount: number;
+      usedCount: number;
+      status: "ACTIVE" | "PAUSED" | "ENDED";
+      locked: boolean;
+      lockedAt: string | null;
+      createdAt: string;
+      updatedAt: string;
+    }>;
+    resume: (couponId: string) => Promise<{
+      couponId: string;
+      name: string;
+      description: string | null;
+      kind: "ORDER" | "PRODUCT" | "DELIVERY";
+      benefit: {
+        type: "RATE" | "AMOUNT";
+        value: number;
+        maxDiscountAmount: number | null;
+      };
+      conditions: {
+        minOrderAmount: number;
+        firstOrderOnly: boolean;
+        memberOnly: boolean;
+        stackWithInstantDiscount: boolean;
+      };
+      target: {
+        includeProductIds: string[];
+        includeCategoryIds: string[];
+        excludeProductIds: string[];
+        excludeCategoryIds: string[];
+      };
+      issueMethod: string;
+      code: string | null;
+      startsAt: string | null;
+      endsAt: string | null;
+      validDaysAfterIssue: number | null;
+      totalIssueLimit: number | null;
+      totalUseLimit: number | null;
+      perMemberIssueLimit: number | null;
+      perMemberUseLimit: number | null;
+      issuedCount: number;
+      reservedCount: number;
+      usedCount: number;
+      status: "ACTIVE" | "PAUSED" | "ENDED";
+      locked: boolean;
+      lockedAt: string | null;
+      createdAt: string;
+      updatedAt: string;
+    }>;
+    end: (couponId: string) => Promise<{
+      couponId: string;
+      name: string;
+      description: string | null;
+      kind: "ORDER" | "PRODUCT" | "DELIVERY";
+      benefit: {
+        type: "RATE" | "AMOUNT";
+        value: number;
+        maxDiscountAmount: number | null;
+      };
+      conditions: {
+        minOrderAmount: number;
+        firstOrderOnly: boolean;
+        memberOnly: boolean;
+        stackWithInstantDiscount: boolean;
+      };
+      target: {
+        includeProductIds: string[];
+        includeCategoryIds: string[];
+        excludeProductIds: string[];
+        excludeCategoryIds: string[];
+      };
+      issueMethod: string;
+      code: string | null;
+      startsAt: string | null;
+      endsAt: string | null;
+      validDaysAfterIssue: number | null;
+      totalIssueLimit: number | null;
+      totalUseLimit: number | null;
+      perMemberIssueLimit: number | null;
+      perMemberUseLimit: number | null;
+      issuedCount: number;
+      reservedCount: number;
+      usedCount: number;
+      status: "ACTIVE" | "PAUSED" | "ENDED";
+      locked: boolean;
+      lockedAt: string | null;
+      createdAt: string;
+      updatedAt: string;
+    }>;
+    /** 셀러 지급 — 한 번에 1,000명까지. 한도에 걸린 구매자는 `failed`에 담긴다 */
+    issue: (couponId: string, body: IssueCouponRequest, idempotencyKey?: string) => Promise<{
+      issued: {
+        customerId: string;
+        issueId: string;
+      }[];
+      failed: {
+        customerId: string;
+        code: string;
+        message: string;
+      }[];
+    }>;
+    issues: (couponId: string, params?: PageParams & {
+      status?: "AVAILABLE" | "RESERVED" | "USED" | "REVOKED";
+    }) => Promise<{
       page: number;
       size: number;
       totalElements: number;
       totalPages: number;
       contents: {
-        orderId: string;
-        orderedAt: string;
-        totalAmount: number;
-        testPayment: boolean;
-        items: {
-          orderItemId: string;
-          productName: string;
-          optionName: string | null;
-          quantity: number;
-          status: "PAID" | "CANCELED" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED";
-          claimStatus: "CANCEL_REQUESTED" | "RETURN_REQUESTED" | "EXCHANGE_REQUESTED" | null;
-        }[];
+        issueId: string;
+        couponId: string;
+        customerId: string;
+        customerName: string | null;
+        status: string;
+        validFrom: string;
+        validUntil: string | null;
+        usedOrderId: string | null;
+        issuedAt: string;
+        revokedAt: string | null;
       }[];
     }>;
-    /** 동의 이력 — 최근 순. 가입·재동의·마케팅 변경이 한 줄씩 남는다 */
-    consents: (customerId: string, params?: PageParams & {
-      kind?: ConsentKind;
+    redemptions: (couponId: string, params?: PageParams & {
+      status?: "RESERVED" | "USED" | "RELEASED" | "RESTORED";
     }) => Promise<{
       page: number;
       size: number;
       totalElements: number;
       totalPages: number;
       contents: {
-        consentId: string;
-        kind: "TERMS" | "PRIVACY" | "MARKETING";
-        version: string | null;
-        documentUrl: string | null;
-        action: "WITHDRAWN" | "AGREED";
-        source: "SELLER" | "SIGNUP" | "SOCIAL_SIGNUP" | "DELEGATED" | "RECONSENT" | "MEMBER_UPDATE";
-        occurredAt: string;
+        redemptionId: string;
+        couponId: string;
+        issueId: string | null;
+        customerId: string | null;
+        orderId: string | null;
+        status: string;
+        discountAmount: number;
+        reservedAt: string;
+        usedAt: string | null;
+        releasedAt: string | null;
+        restoredAt: string | null;
+        restoreSkippedReason: string | null;
       }[];
     }>;
-    withdraw: (customerId: string, body: WithdrawCustomerRequest) => Promise<void>;
+    stats: (couponId: string) => Promise<{
+      couponId: string;
+      issuedCount: number;
+      revokedCount: number;
+      reservedCount: number;
+      usedCount: number;
+      restoredCount: number;
+      releasedCount: number;
+      discountTotal: number;
+      orderPaymentTotal: number;
+    }>;
+    /** 발급 쿠폰 회수 — 사용 가능한 발급 쿠폰만 */
+    revokeIssue: (issueId: string) => Promise<{
+      issueId: string;
+      couponId: string;
+      customerId: string;
+      customerName: string | null;
+      status: string;
+      validFrom: string;
+      validUntil: string | null;
+      usedOrderId: string | null;
+      issuedAt: string;
+      revokedAt: string | null;
+    }>;
   };
   customerInquiries: {
     list: (params?: PageParams & {
@@ -7431,7 +9736,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" | "ORDER.CANCELED" | "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" | "ORDER.FULFILLED" | "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;
@@ -7441,7 +9746,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" | "ORDER.CANCELED" | "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" | "ORDER.FULFILLED" | "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;
@@ -7451,7 +9756,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" | "ORDER.CANCELED" | "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" | "ORDER.FULFILLED" | "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;
@@ -7461,7 +9766,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" | "ORDER.CANCELED" | "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" | "ORDER.FULFILLED" | "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;
@@ -7476,7 +9781,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" | "ORDER.CANCELED" | "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" | "ORDER.FULFILLED" | "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;
@@ -7486,7 +9791,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" | "ORDER.CANCELED" | "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" | "ORDER.FULFILLED" | "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;
@@ -7513,7 +9818,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" | "ORDER.CANCELED" | "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" | "ORDER.FULFILLED" | "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;
@@ -7548,7 +9853,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" | "ORDER.CANCELED" | "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" | "ORDER.FULFILLED" | "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;
@@ -7664,7 +9969,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     list: (params?: ApprovalListOptions) => Promise<{
       items: {
         approvalId: string;
-        status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
+        status: "EXPIRED" | "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED";
         operationId: string;
         method: string;
         path: string;
@@ -7714,7 +10019,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     get: (approvalId: string) => Promise<{
       approvalId: string;
-      status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
+      status: "EXPIRED" | "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED";
       operationId: string;
       method: string;
       path: string;
@@ -7766,7 +10071,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
      */
     approve: (approvalId: string, body?: ApprovalDecisionRequest) => Promise<{
       approvalId: string;
-      status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
+      status: "EXPIRED" | "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED";
       operationId: string;
       method: string;
       path: string;
@@ -7814,7 +10119,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     reject: (approvalId: string, body?: ApprovalDecisionRequest) => Promise<{
       approvalId: string;
-      status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
+      status: "EXPIRED" | "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED";
       operationId: string;
       method: string;
       path: string;
@@ -7911,7 +10216,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
   sellerAddresses: {
     list: (type?: AddressType) => Promise<{
       addressId: string;
-      type: "RETURN" | "SHIPPING";
+      type: "SHIPPING" | "PICKUP" | "RETURN";
       name: string;
       isDefault: boolean;
       contactName: string;
@@ -7939,6 +10244,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
       analyticsAllowedOrigins: string[];
       storefrontOrigins: string[];
       guestCheckoutEnabled: boolean;
+      fulfillmentMailEnabled: boolean;
+      withdrawalNotice: string | null;
       autoDeliverDays: number;
       autoConfirmDays: number;
       refundPolicy: {
@@ -7947,6 +10254,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         exchangeDeliveryFee: number;
         sellerFaultFreeShipping: boolean;
         conditionalFreeShortfallCharge: boolean;
+        couponShortfallCharge: boolean;
       };
       shippingPolicy: {
         baseDeliveryFee: number;
@@ -7979,6 +10287,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
       analyticsAllowedOrigins: string[];
       storefrontOrigins: string[];
       guestCheckoutEnabled: boolean;
+      fulfillmentMailEnabled: boolean;
+      withdrawalNotice: string | null;
       autoDeliverDays: number;
       autoConfirmDays: number;
       refundPolicy: {
@@ -7987,6 +10297,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         exchangeDeliveryFee: number;
         sellerFaultFreeShipping: boolean;
         conditionalFreeShortfallCharge: boolean;
+        couponShortfallCharge: boolean;
       };
       shippingPolicy: {
         baseDeliveryFee: number;
@@ -8007,7 +10318,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       userId: string;
       name: string;
       email: string;
-      role: "ADMIN" | "STAFF" | "OWNER";
+      role: "OWNER" | "ADMIN" | "STAFF";
       joinedAt: string;
       lastActiveAt: string | null;
     }[]>;
@@ -8024,7 +10335,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       invitationId: string;
       email: string;
       role: "ADMIN" | "STAFF";
-      status: "PENDING" | "EXPIRED" | "ACCEPTED" | "CANCELED";
+      status: "EXPIRED" | "PENDING" | "ACCEPTED" | "CANCELED";
       invitedBy: string;
       expiresAt: string;
       createdAt: string;
@@ -8042,7 +10353,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       invitationId: string;
       email: string;
       role: "ADMIN" | "STAFF";
-      status: "PENDING" | "EXPIRED" | "ACCEPTED" | "CANCELED";
+      status: "EXPIRED" | "PENDING" | "ACCEPTED" | "CANCELED";
       invitedBy: string;
       expiresAt: string;
       createdAt: string;
@@ -8057,7 +10368,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       invitationId: string;
       email: string;
       role: "ADMIN" | "STAFF";
-      status: "PENDING" | "EXPIRED" | "ACCEPTED" | "CANCELED";
+      status: "EXPIRED" | "PENDING" | "ACCEPTED" | "CANCELED";
       invitedBy: string;
       expiresAt: string;
       createdAt: string;
@@ -8132,6 +10443,333 @@ export declare function exchangeStoreTokenViaOAuth(options: {
   role?: string;
 }>;
 //#endregion
+//#region src/schemas/promotion.d.ts
+/** 쿠폰 종류 */
+export declare const couponKindSchema: z.ZodEnum<{
+  ORDER: "ORDER";
+  PRODUCT: "PRODUCT";
+  DELIVERY: "DELIVERY";
+}>;
+export type CouponKind = z.infer<typeof couponKindSchema>;
+/** 쿠폰 혜택 — 정률은 1~100%, 최대 할인액을 둘 수 있다. 정액은 최대 할인액이 없다 */
+export declare const couponBenefitSchema: z.ZodObject<{
+  type: z.ZodEnum<{
+    RATE: "RATE";
+    AMOUNT: "AMOUNT";
+  }>;
+  value: z.ZodNumber;
+  maxDiscountAmount: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export type CouponBenefit = z.infer<typeof couponBenefitSchema>;
+/** 쿠폰 사용 조건 */
+export declare const couponConditionsSchema: z.ZodObject<{
+  minOrderAmount: z.ZodNumber;
+  firstOrderOnly: z.ZodBoolean;
+  memberOnly: z.ZodBoolean;
+  stackWithInstantDiscount: z.ZodBoolean;
+}, z.core.$strip>;
+export type CouponConditions = z.infer<typeof couponConditionsSchema>;
+/** 조건을 생략했을 때의 값 */
+export declare const COUPON_CONDITIONS_DEFAULTS: CouponConditions;
+/** 상한 — 대상 목록은 규칙 스냅샷에 통째로 복사되므로 크기를 제한한다 */
+export declare const COUPON_TARGET_LIST_MAX = 500;
+/** 쿠폰 대상 — 포함 목록이 모두 비면 전 상품이다. 제외가 포함보다 우선한다 */
+export declare const couponTargetSchema: z.ZodObject<{
+  includeProductIds: z.ZodArray<z.ZodString>;
+  includeCategoryIds: z.ZodArray<z.ZodString>;
+  excludeProductIds: z.ZodArray<z.ZodString>;
+  excludeCategoryIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type CouponTarget = z.infer<typeof couponTargetSchema>;
+export declare const COUPON_TARGET_ALL: CouponTarget;
+/**
+ * 쿠폰 규칙 스냅샷 — 계산에 필요한 값만 담는다. 결제 시작이 쿠폰을 읽어 이 형태로 결제 세션에 굳히고,
+ * 주문 생성·환불 정산은 이 스냅샷만 읽는다. 결제 도중·주문 뒤 셀러가 쿠폰을 바꿔도 그 주문의 금액은 움직이지 않는다.
+ */
+export declare const couponRuleSchema: z.ZodObject<{
+  couponId: z.ZodString;
+  name: z.ZodString;
+  kind: z.ZodEnum<{
+    ORDER: "ORDER";
+    PRODUCT: "PRODUCT";
+    DELIVERY: "DELIVERY";
+  }>;
+  benefit: z.ZodObject<{
+    type: z.ZodEnum<{
+      RATE: "RATE";
+      AMOUNT: "AMOUNT";
+    }>;
+    value: z.ZodNumber;
+    maxDiscountAmount: z.ZodNullable<z.ZodNumber>;
+  }, z.core.$strip>;
+  conditions: z.ZodObject<{
+    minOrderAmount: z.ZodNumber;
+    firstOrderOnly: z.ZodBoolean;
+    memberOnly: z.ZodBoolean;
+    stackWithInstantDiscount: z.ZodBoolean;
+  }, z.core.$strip>;
+  target: z.ZodObject<{
+    includeProductIds: z.ZodArray<z.ZodString>;
+    includeCategoryIds: z.ZodArray<z.ZodString>;
+    excludeProductIds: z.ZodArray<z.ZodString>;
+    excludeCategoryIds: z.ZodArray<z.ZodString>;
+  }, z.core.$strip>;
+  startsAt: z.ZodNullable<z.ZodISODateTime>;
+  endsAt: z.ZodNullable<z.ZodISODateTime>;
+}, z.core.$strip>;
+export type CouponRule = z.infer<typeof couponRuleSchema>;
+/** 쿠폰을 적용하지 못한 사유 */
+export declare const couponRejectReasonSchema: z.ZodEnum<{
+  EXPIRED: "EXPIRED";
+  DUPLICATE_COUPON: "DUPLICATE_COUPON";
+  STACK_LIMIT: "STACK_LIMIT";
+  NOT_STARTED: "NOT_STARTED";
+  MEMBER_ONLY: "MEMBER_ONLY";
+  FIRST_ORDER_ONLY: "FIRST_ORDER_ONLY";
+  NO_ELIGIBLE_ITEMS: "NO_ELIGIBLE_ITEMS";
+  MIN_ORDER_AMOUNT: "MIN_ORDER_AMOUNT";
+  LINE_NOT_ELIGIBLE: "LINE_NOT_ELIGIBLE";
+  NO_DISCOUNT: "NO_DISCOUNT";
+}>;
+export type CouponRejectReason = z.infer<typeof couponRejectReasonSchema>;
+/** 쿠폰 적용 뒤 결제 금액의 하한 — 0원 결제 경로가 없어 이보다 작으면 결제를 시작하지 않는다(400 `PAYMENT_AMOUNT_TOO_LOW`) */
+export declare const MIN_PAYMENT_AMOUNT = 100;
+/** 계산에 넣는 주문상품 한 줄 */
+export interface PricingLine {
+  /** 줄 식별자 — 주문서는 항목 순번, 주문은 주문상품 id. 배분 결과가 이 키로 나온다 */
+  lineId: string;
+  productId: string;
+  /** 상품 카테고리 경로(`/조상/…/자신/`). 없으면 카테고리 대상에 걸리지 않는다 */
+  categoryPath?: string | null;
+  /** 수량 — 계산에는 쓰지 않는다(금액이 이미 수량을 반영한다). 화면·로그용이다 */
+  quantity: number;
+  /** 즉시할인 전 금액 (정가 단가 × 수량) */
+  baseAmount: number;
+  /** 즉시할인 반영 금액 (할인 단가 × 수량) — 쿠폰 계산의 기준이다 */
+  amount: number;
+}
+/** 계산에 넣는 쿠폰 한 장 */
+export interface PricingCoupon {
+  rule: CouponRule;
+  /** 결과·배분의 키. 생략하면 `rule.couponId` */
+  couponKey?: string;
+  /**
+   * 상품 쿠폰을 걸 줄. 생략하면 계산이 고른다 — 줄을 지정한 쿠폰을 먼저 걸고, 나머지는 대상 줄이 적은 쿠폰부터
+   * 할인이 가장 큰 남은 줄(같으면 앞 줄)에 건다
+   */
+  lineId?: string | null;
+  /**
+   * 대상 줄을 이미 정했으면 그 목록 — 환불 정산의 재계산이 쓴다. 주어지면 `target`·즉시할인 조건을 다시
+   * 판정하지 않는다(주문 뒤 상품의 카테고리·즉시할인이 바뀌어도 주문 시점 대상이 그대로다).
+   */
+  eligibleLineIds?: readonly string[] | null;
+  /** 발급 쿠폰의 유효 시작·종료 — 쿠폰 사용 기간과 둘 중 좁은 쪽이 적용된다 */
+  validFrom?: string | null;
+  validUntil?: string | null;
+}
+/**
+ * 배송비 쿠폰이 보는 배송비 견적 — `quoteDelivery` 결과의 묶음 내역이다. 배송비 총액은 묶음의
+ * `fee + remoteSurcharge` 합으로 계산한다(총액을 따로 받으면 묶음과 어긋날 수 있다).
+ */
+export interface PricingDelivery {
+  bundles: ReadonlyArray<{
+    bundleKey: string;
+    fee: number;
+    remoteSurcharge: number;
+  }>;
+}
+export interface PricingInput {
+  lines: readonly PricingLine[];
+  coupons: readonly PricingCoupon[];
+  /** 배송비 견적. 없으면 배송비 0으로 계산하고 배송비 쿠폰은 할인할 금액이 없다 */
+  delivery?: PricingDelivery | null;
+  /** 이 스토어에서 결제 완료 주문이 없는 회원인가 */
+  firstOrder: boolean;
+  /** 회원 주문인가 */
+  isMember: boolean;
+  /** 사용 기간 판정 시각 */
+  now: Date;
+  /**
+   * 사용 기간·회원·첫 구매 조건을 다시 보지 않는다 — **환불 정산의 재계산 전용이다.** 그 조건은 결제 시작에서
+   * 이미 통과했다. 주문 시각(승인 시각)으로 기간을 다시 보면 결제 시작과 승인 사이에 끝난 쿠폰이 조건을 잃은
+   * 것처럼 보이고, 탈퇴한 회원의 반품이 회원 전용 조건에 떨어진다. 대상과 최소 금액만 본다.
+   */
+  ignoreEligibility?: boolean;
+}
+/** 줄 하나에 들어간 쿠폰별 할인 */
+export interface CouponAllocation {
+  couponKey: string;
+  amount: number;
+}
+export interface PricingLineResult {
+  lineId: string;
+  /** 즉시할인 반영 금액 (쿠폰 전) */
+  amount: number;
+  /** 이 줄에 들어간 쿠폰 할인 합계 — 상품 쿠폰 + 주문 쿠폰 배분 */
+  couponDiscount: number;
+  allocations: CouponAllocation[];
+}
+export interface PricingCouponResult {
+  couponKey: string;
+  couponId: string;
+  kind: CouponKind;
+  applied: boolean;
+  /** 이 쿠폰의 할인액. 적용하지 못했으면 0 */
+  discount: number;
+  rejectReason: CouponRejectReason | null;
+  /** 상품 쿠폰이 걸린 줄. 그 밖은 null */
+  lineId: string | null;
+  /** 이 쿠폰의 대상 줄 — 판정에 쓴 순서 그대로다. 환불 정산이 주문 시점 대상을 되살리는 데 쓴다 */
+  eligibleLineIds: string[];
+}
+export interface PricingBundleResult {
+  bundleKey: string;
+  couponDiscount: number;
+}
+export interface PricingResult {
+  lines: PricingLineResult[];
+  coupons: PricingCouponResult[];
+  /** 배송비 쿠폰의 묶음별 배분 */
+  bundles: PricingBundleResult[];
+  /** 상품 금액 합 (즉시할인 반영, 쿠폰 전) */
+  productAmount: number;
+  /** 상품·주문 쿠폰 할인 합계 */
+  couponDiscountAmount: number;
+  /** 배송비 (쿠폰 전) */
+  deliveryFee: number;
+  /** 배송비 쿠폰 할인 */
+  deliveryDiscountAmount: number;
+  /** 결제 금액 = productAmount − couponDiscountAmount + deliveryFee − deliveryDiscountAmount */
+  totalAmount: number;
+}
+/**
+ * 할인액 — 정률은 10원 단위 내림, 최대 할인액과 기준 금액을 넘지 않는다. 기준 금액이 0 이하면 0이다.
+ *
+ * 곱셈을 먼저 하고 나눈다. `base × 율 ÷ 1000`을 내려 10을 곱하면 `floor(base × 율 / 100 / 10) × 10`과 같고
+ * 부동소수 오차가 끼지 않는다.
+ */
+export declare function couponDiscountOf(benefit: CouponBenefit, base: number): number;
+/**
+ * 금액을 가중치 비율로 나눈다 — **누적 내림의 차분**이다.
+ *
+ * `i`번째 몫 = `floor(total × W_i / W) − floor(total × W_{i−1} / W)`(`W_i`는 앞에서부터 누적 가중치).
+ * 합이 `total`과 정확히 같고, 입력 순서가 같으면 결과도 같다. `total ≤ W`이면 몫이 가중치를 넘지 않는다.
+ * 곱이 2^53을 넘을 수 있어 BigInt로 계산한다.
+ */
+export declare function allocateByWeight(total: number, weights: readonly number[]): number[];
+/** 줄이 쿠폰 대상인가 — 제외가 포함보다 우선하고, 포함 목록이 모두 비면 전 상품이다 */
+export declare function isCouponTargetLine(rule: Pick<CouponRule, "target" | "conditions">, line: Pick<PricingLine, "productId" | "categoryPath" | "baseAmount" | "amount">): boolean;
+/**
+ * 쿠폰 금액 계산 — **순수 함수다.** DB를 읽지 않는다. 규칙 스냅샷을 만드는 조회와 한도·보유 판정
+ * (발급 쿠폰 상태, 1인 한도)은 호출부 몫이다.
+ *
+ * 종류별로 상품 쿠폰 → 주문 쿠폰 → 배송비 쿠폰 순으로 적용한다. 같은 종류의 자리와 같은 쿠폰 id는
+ * **적용된** 쿠폰만 차지한다 — 앞선 주문 쿠폰이 최소 금액 미달이면 뒤의 주문 쿠폰이 쓰이고, 같은 쿠폰의 발급
+ * 사본 중 앞 장이 만료됐으면 뒤 장이 쓰인다. 결과의 `coupons`는 입력 순서 그대로다. 입력이 같으면 결과도 같다.
+ */
+export declare function quotePricing(input: PricingInput): PricingResult;
+/**
+ * 주문이 받은 쿠폰 한 장 — 주문 시점 규칙과 대상 줄을 굳힌 값이다(`orders.discounts`의 항목).
+ * 환불 정산은 이 값만 읽는다. 셀러가 쿠폰을 바꾸거나 상품의 카테고리가 바뀌어도 결과가 같다.
+ */
+export interface AppliedCouponSnapshot {
+  couponKey: string;
+  rule: CouponRule;
+  /** 상품 쿠폰이 걸린 주문상품 id. 그 밖은 null */
+  lineId: string | null;
+  /** 주문 시점 대상 주문상품 id — 주문서 항목 순서 그대로다 */
+  eligibleLineIds: string[];
+  /** 주문 시점 할인액 */
+  discount: number;
+}
+/** 정산이 보는 주문상품 한 줄 — 이번 취소를 **반영한 뒤**의 활성 수량이다 */
+export interface CouponSettlementLine {
+  lineId: string;
+  productId: string;
+  quantity: number;
+  /** 남은 활성 수량 (이번 취소 반영 뒤) */
+  activeQuantity: number;
+  /** 주문상품 금액 (즉시할인 반영 단가 × 전체 수량, 쿠폰 전) */
+  totalPrice: number;
+  /** 주문 시점 쿠폰별 배분 */
+  allocations: readonly CouponAllocation[];
+}
+/** 쿠폰 한 장의 정산 누적 — `orders.coupon_settlements[couponKey]` */
+export interface CouponSettlementState {
+  /** 지금까지 환불에서 뺀 조건 미달 차감 (되돌린 금액을 뺀 값) */
+  charged: number;
+  /** 판매자 귀책·정책 꺼짐으로 받지 않기로 한 미달분 — 뒤의 환불이 다시 청구하지 않게 남긴다 */
+  waived: number;
+}
+export interface CouponSettlementInput {
+  coupons: readonly AppliedCouponSnapshot[];
+  lines: readonly CouponSettlementLine[];
+  settlements: Readonly<Record<string, Partial<CouponSettlementState> | undefined>>;
+  /** 스토어 환불 정책 `couponShortfallCharge` */
+  shortfallCharge: boolean;
+  /** 판매자 귀책(직권취소, 불량·오배송 반품) — 미달분을 청구하지 않는다 */
+  sellerFault: boolean;
+  /**
+   * 이번 환불에서 실제로 뺄 수 있는 금액 — 차감의 상한이다. 넘겨 차감하면 환불은 0원으로 잘리는데 기록에는
+   * 전액이 남아, 뒤에 되돌릴 때 받지 않은 돈을 돌려준다(배송비 미달 차감의 `chargeableAmount`와 같은 이유).
+   */
+  chargeableAmount: number;
+}
+export interface CouponSettlementEntry {
+  couponKey: string;
+  /** 남은 주문상품에 배분된 할인 */
+  allocatedRemaining: number;
+  /** 남은 주문상품으로 다시 계산한 할인 — 쿠폰 조건을 잃었으면 0 */
+  recomputed: number;
+  /** 누적 미달분 목표 = 조건을 잃었으면 `allocatedRemaining`, 아니면 0 */
+  target: number;
+  charge: number;
+  refund: number;
+  waive: number;
+  next: CouponSettlementState;
+}
+export interface CouponSettlementResult {
+  /** 이번 환불에서 뺄 금액 — 조건 미달 차감 */
+  chargeAmount: number;
+  /** 이번 환불에 더할 금액 — 앞선 환불에서 뺀 차감을 되돌린 몫 */
+  refundAmount: number;
+  entries: CouponSettlementEntry[];
+}
+export declare const NO_COUPON_SETTLEMENT: CouponSettlementResult;
+/**
+ * 쿠폰 조건 미달 차감 — **순수 함수다.** 부분 취소·반품으로 남은 주문상품이 쿠폰 조건을 잃으면,
+ * 남은 주문상품이 받던 할인만큼을 이번 환불에서 뺀다.
+ *
+ * 쿠폰마다
+ * - `allocatedRemaining` = 남은 수량에 배분된 할인(`proratedRefundBase`로 수량 비율)
+ * - `recomputed` = 주문 시점 규칙 스냅샷과 주문 시점 대상 줄로, 남은 금액만 넣어 `quotePricing`을 다시 돌린 할인
+ * - 쿠폰이 **여전히 적용되면 목표 0**, 조건을 잃었으면 목표 = `allocatedRemaining`이다. 적용되는 쿠폰의
+ *   정률 10원 내림 차이까지 차감하면 조건을 지킨 구매자가 몇 원씩 잃는다 — 조건을 잃은 경우만 본다.
+ *   재계산 할인이 더 커지는 경우(정률 최대 할인액)도 차감하지 않고 더 돌려주지도 않는다.
+ * - `delta` = 목표 − (이미 차감 + 이미 면제). 양수면 청구하고(판매자 귀책·정책 꺼짐이면 면제로 기록),
+ *   음수면 앞서 뺀 차감부터 돌려준다. 마지막 활성 수량까지 취소되면 목표가 0이라 누적 차감이 모두 되돌아가고,
+ *   전량 취소의 환불 합계가 결제액과 같아진다.
+ * - 청구는 이번 환불에서 실제로 뺄 수 있는 금액(`chargeableAmount` + 이번에 되돌린 금액)을 넘지 않고,
+ *   **실제로 뺀 금액만** 기록한다. 못 뺀 나머지는 기록하지 않아 다음 환불이 다시 본다.
+ *
+ * 배송비 쿠폰은 여기서 다루지 않는다. 배송비 쿠폰을 발급하게 되면(3단계) 묶음 배송비 환불
+ * (`computeDeliveryFeeSettlement`)이 그 묶음의 `couponDiscount`를 빼야 한다 — 빼지 않으면 받지 않은 배송비를 돌려준다.
+ */
+export declare function settleCouponShortfall(input: CouponSettlementInput): CouponSettlementResult;
+/**
+ * 주문상품의 실결제 금액 중 이번 취소 수량의 몫 — **실결제 금액(`totalPrice − couponDiscountAmount`)을
+ * 누적 내림의 차분으로 나눈다.**
+ *
+ * 상품 금액과 쿠폰 배분을 따로 나눠 빼면 합은 같지만 한 번의 몫이 −1원이 되는 경우가 있다
+ * (예: 금액 3원·할인 2원·수량 5개에서 셋째 개). 음수를 0으로 자르면 합이 1원 넘친다. 실결제 금액을
+ * 바로 나누면 몫이 항상 0 이상이고 전량 취소의 합이 실결제 금액과 정확히 같다.
+ */
+export declare function proratedPaidRefundBase(item: {
+  totalPrice: number;
+  couponDiscountAmount?: number | null;
+  quantity: number;
+}, settledQuantity: number, cancelQuantity: number): number;
+//#endregion
 //#region src/schemas/refund-policy.d.ts
 /** 유효 환불 정책 — 스토어 기본 + 상품별 덮어쓰기를 합친 결과 */
 export declare const refundPolicySchema: z.ZodObject<{
@@ -8140,6 +10778,7 @@ export declare const refundPolicySchema: z.ZodObject<{
   exchangeDeliveryFee: z.ZodNumber;
   sellerFaultFreeShipping: z.ZodBoolean;
   conditionalFreeShortfallCharge: z.ZodBoolean;
+  couponShortfallCharge: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, z.core.$strip>;
 export type RefundPolicy = z.infer<typeof refundPolicySchema>;
 /**
@@ -8161,40 +10800,49 @@ export declare const refundPolicyPatchSchema: z.ZodObject<{
   exchangeDeliveryFee: z.ZodOptional<z.ZodNumber>;
   sellerFaultFreeShipping: z.ZodOptional<z.ZodBoolean>;
   conditionalFreeShortfallCharge: z.ZodOptional<z.ZodBoolean>;
+  couponShortfallCharge: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
 export type RefundPolicyPatch = z.infer<typeof refundPolicyPatchSchema>;
-/** 정책 해석에 쓰는 상품 값 — 상품별 덮어쓰기와 레거시 배송비 필드 */
+/**
+ * 상품별 덮어쓰기 — 쿠폰 조건 미달 차감(`couponShortfallCharge`)은 주문 단위 규칙이라 상품이 정하지 않는다.
+ * 스토어 정책만 읽는다(이슈 #47).
+ */
+export declare const productRefundPolicyPatchSchema: z.ZodObject<{
+  preShipmentDeliveryFeeRefund: z.ZodOptional<z.ZodBoolean>;
+  returnDeliveryFee: z.ZodOptional<z.ZodNumber>;
+  exchangeDeliveryFee: z.ZodOptional<z.ZodNumber>;
+  sellerFaultFreeShipping: z.ZodOptional<z.ZodBoolean>;
+  conditionalFreeShortfallCharge: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+/** 정책 해석에 쓰는 상품 값 — 상품별 덮어쓰기 */
 export interface RefundPolicyProductInput {
   /** 상품별 덮어쓰기. 없으면 스토어 기본을 그대로 쓴다 */
   refundPolicy?: RefundPolicyPatch | null;
-  /** @deprecated 레거시 상품 반품비 — `refundPolicy`가 없는 옛 상품의 값이다 */
-  returnFee?: number | null;
-  /** @deprecated 레거시 상품 교환비 — `refundPolicy`가 없는 옛 상품의 값이다 */
-  exchangeFee?: number | null;
 }
 /**
  * 유효 정책 해석 — 상품별 덮어쓰기 → 스토어 기본 → `REFUND_POLICY_DEFAULTS` 순이다.
  *
- * 반품비·교환비는 레거시 필드(`products.returnFee`·`exchangeFee`)와 **연결**한다. 상품이
- * `refundPolicy.returnDeliveryFee`를 정하면 그 값이 원천이고(서버가 `returnFee`도 같은 값으로 맞춘다),
- * 정하지 않았으면 레거시 값이 0보다 클 때 그 값을 쓴다. 0이면 스토어 기본을 따른다 —
- * 정책이 생기기 전에 만든 상품(반품비 0)이 스토어 기본을 물려받게 하는 규칙이다.
+ * 반품·교환 배송비의 원천은 정책 하나다(이슈 #57 결정 3). 상품의 레거시 반품비·교환비 필드와의 연결은 없앴고,
+ * 레거시 값은 마이그레이션이 상품별 정책으로 옮겼다.
  */
 export declare function resolveRefundPolicy(storePolicy?: RefundPolicyPatch | null, product?: RefundPolicyProductInput | null): RefundPolicy;
 /**
- * 상품의 **덮어쓰기 자체** — 레거시 반품비·교환비를 같은 형태로 승격한 값이다. 덮어쓰기가 없으면 null.
+ * 상품의 **덮어쓰기 자체** — 덮어쓰기가 없으면 null.
  *
  * `resolveRefundPolicy`가 합친 결과로는 "상품이 정한 값"과 "스토어 기본을 물려받은 값"을 가를 수 없다.
  * 관리 API 응답의 `refundPolicy`와 콘솔 폼의 덮어쓰기 스위치가 이 함수를 원천으로 쓴다 — 가르지 못하면
- * 스토어 기본을 쓰는 상품을 저장할 때 그 순간의 기본값이 상품에 박히거나, 레거시 값이 조용히 사라진다.
+ * 스토어 기본을 쓰는 상품을 저장할 때 그 순간의 기본값이 상품에 박힌다.
  */
 export declare function productRefundPolicyOverride(product?: RefundPolicyProductInput | null): RefundPolicyPatch | null;
+/** 반품·교환 배송비 키 — 배송이 없는 상품의 정책에는 두지 않는다 */
+export declare const REFUND_POLICY_DELIVERY_FEE_KEYS: readonly ["returnDeliveryFee", "exchangeDeliveryFee"];
 /**
  * 수량 단위 부분 취소의 환불 기준액 — **누적 내림의 차분**이다.
  *
  * 원 단위 반올림 규칙: `floor(주문상품 금액 × 누적 수량 ÷ 전체 수량)`을 두 번 구해 그 차를 쓴다.
  * 부분 취소를 몇 번 나눠도 합이 주문상품 금액과 정확히 같아서 1원이 남거나 넘치지 않는다.
- * 할인은 이미 단가에 들어 있어(주문 단위 쿠폰이 없다) 별도 안분이 없다.
+ * 즉시할인은 이미 단가에 들어 있다. 쿠폰 할인은 단가에 들어가지 않으므로 환불은 실결제 금액을 나누는
+ * `proratedPaidRefundBase`(promotion.ts)를 쓴다(이슈 #47).
  *
  * @param totalPrice 주문상품 금액 (할인 반영 단가 × 전체 수량)
  * @param quantity 주문상품 전체 수량
@@ -8231,6 +10879,7 @@ export declare const STORE_SCOPE_RESOURCES: {
   readonly member: readonly ["r", "rw"];
   readonly customer: readonly ["r", "rw"];
   readonly audit: readonly ["r"];
+  readonly promotion: readonly ["r", "rw"];
 };
 export type StoreScopeResource = keyof typeof STORE_SCOPE_RESOURCES;
 export declare const storeScopeResourceSchema: z.ZodEnum<{
@@ -8247,6 +10896,7 @@ export declare const storeScopeResourceSchema: z.ZodEnum<{
   member: "member";
   customer: "customer";
   audit: "audit";
+  promotion: "promotion";
 }>;
 /** 카탈로그상 존재하는 스코프 문자열인가 (예: `settlement:rw`는 false) */
 export declare function isStoreScope(scope: string): boolean;
@@ -8256,9 +10906,9 @@ export declare function isStoreScope(scope: string): boolean;
  * 발급 시 지정한 스코프만 갖는다(발급자 보유 스코프 이내).
  */
 export declare const STORE_ROLE_SCOPES: {
-  readonly OWNER: readonly ["product:rw", "category:rw", "order:rw", "claim:rw", "inquiry:rw", "review:rw", "settlement:r", "analytics:r", "webhook:rw", "store:rw", "member:rw", "customer:rw", "audit:r"];
-  readonly ADMIN: readonly ["product:rw", "category:rw", "order:rw", "claim:rw", "inquiry:rw", "review:rw", "analytics:r", "webhook:rw", "store:rw", "member:rw", "customer:rw", "audit:r"];
-  readonly STAFF: readonly ["product:rw", "category:rw", "order:rw", "claim:rw", "inquiry:rw", "review:rw", "customer:r"];
+  readonly OWNER: readonly ["product:rw", "category:rw", "order:rw", "claim:rw", "inquiry:rw", "review:rw", "settlement:r", "analytics:r", "webhook:rw", "store:rw", "member:rw", "customer:rw", "audit:r", "promotion:rw"];
+  readonly ADMIN: readonly ["product:rw", "category:rw", "order:rw", "claim:rw", "inquiry:rw", "review:rw", "analytics:r", "webhook:rw", "store:rw", "member:rw", "customer:rw", "audit:r", "promotion:rw"];
+  readonly STAFF: readonly ["product:rw", "category:rw", "order:rw", "claim:rw", "inquiry:rw", "review:rw", "customer:r", "promotion:r"];
 };
 //#endregion
 //#region src/schemas/shipping-policy.d.ts
@@ -8369,6 +11019,11 @@ export interface DeliveryBundleProduct {
   conditionalFreeAmount: number | null;
   /** 출고지 주소 id(`seller_addresses`). null이면 스토어 기본 출고지를 쓰는 상품끼리 한 묶음이다 */
   shippingAddressId?: string | null;
+  /**
+   * 상품 유형 (이슈 #48). 생략·null이면 배송 상품이다. 배송이 필요 없는 유형은 묶음을 만들지 않는다.
+   * 줄(`DeliveryFeeLine.fulfillmentType`)에 값이 있으면 그 값이 이긴다.
+   */
+  fulfillmentType?: FulfillmentType | null;
 }
 /**
  * 배송 묶음 키 — **같은 출고지 + 같은 배송 정책이면 같은 키다.**
@@ -8386,6 +11041,11 @@ export interface DeliveryFeeLine {
   productId: string;
   /** 상품 금액 (할인 반영 단가 × 수량) */
   amount: number;
+  /**
+   * 이 줄의 상품 유형 — 주문서 스냅샷 값이다(이슈 #48). 주면 상품의 현재 유형보다 우선한다. 주문서를 만든 뒤 셀러가
+   * 유형을 바꿔도 결제 시작의 견적과 주문상품 스냅샷이 같은 유형을 보게 한다. 생략하면 상품 값을 쓴다.
+   */
+  fulfillmentType?: FulfillmentType | null;
 }
 /**
  * 기본 배송비를 면제한 근거 — 면제하지 않았으면 null이다.
@@ -8430,6 +11090,13 @@ export interface DeliveryQuote {
   remoteArea: RemoteArea;
   /** 스토어 전체 무료 기준(`freeThreshold`) 충족으로 기본 배송비를 면제했는가 */
   freeByThreshold: boolean;
+  /**
+   * 배송이 필요한 줄의 상품 금액 합 — 스토어 전체 무료 기준의 판정 금액이다(이슈 #48). 비실물 줄은 빠진다.
+   * 주문 상품 금액 합(`productAmount`)과 다를 수 있다.
+   */
+  shippableAmount: number;
+  /** 배송이 필요한 줄이 하나라도 있는가 — 배송 묶음이 하나라도 있는가다. false면 배송지를 받지 않는다 */
+  requiresShipping: boolean;
 }
 export interface DeliveryQuoteInput {
   lines: DeliveryFeeLine[];
@@ -8513,8 +11180,107 @@ export declare const orderWebhookEventDataSchema: z.ZodObject<{
     PURCHASE_DECIDED: "PURCHASE_DECIDED";
   }>;
   testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+  couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+  orderItemId: z.ZodOptional<z.ZodString>;
+  fulfillmentSnapshot: z.ZodOptional<z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"SHIPPING">;
+    shipping: z.ZodObject<{
+      bundleKey: z.ZodNullable<z.ZodString>;
+      returnAddressId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"DOWNLOAD">;
+    download: z.ZodObject<{
+      limit: z.ZodNumber;
+      days: z.ZodNumber;
+      stockTracked: z.ZodBoolean;
+      withdrawalRestricted: z.ZodBoolean;
+    }, z.core.$strip>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"CODE">;
+    code: z.ZodObject<{
+      mode: z.ZodString;
+      withdrawalRestricted: z.ZodBoolean;
+    }, z.core.$strip>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"SERVICE">;
+    service: z.ZodObject<{
+      mode: z.ZodString;
+    }, z.core.$strip>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"PICKUP">;
+    pickup: z.ZodObject<{
+      addressId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+  }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
+    type: z.ZodString;
+  }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
+    [x: string]: unknown;
+    type: string;
+  }>>]>>;
 }, z.core.$strip>;
 export type OrderWebhookEventData = z.infer<typeof orderWebhookEventDataSchema>;
+/**
+ * `ORDER.FULFILLED` — 비실물 주문상품(파일·코드·이용권·방문 수령)을 제공했다(이슈 #48). 자동 제공은 결제 확정과 함께,
+ * 수동 제공은 셀러의 제공 처리(`POST /v1/order-items/{orderItemId}/fulfill`)로 온다. 기존 구독자를 위해 같은 순간
+ * `ORDER.DELIVERED`도 함께 보낸다. **코드·파일 주소는 싣지 않는다** — 관리 API로 조회한다.
+ */
+export declare const orderFulfilledWebhookEventDataSchema: 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";
+  }>;
+  fulfillmentSnapshot: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"SHIPPING">;
+    shipping: z.ZodObject<{
+      bundleKey: z.ZodNullable<z.ZodString>;
+      returnAddressId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"DOWNLOAD">;
+    download: z.ZodObject<{
+      limit: z.ZodNumber;
+      days: z.ZodNumber;
+      stockTracked: z.ZodBoolean;
+      withdrawalRestricted: z.ZodBoolean;
+    }, z.core.$strip>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"CODE">;
+    code: z.ZodObject<{
+      mode: z.ZodString;
+      withdrawalRestricted: z.ZodBoolean;
+    }, z.core.$strip>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"SERVICE">;
+    service: z.ZodObject<{
+      mode: z.ZodString;
+    }, z.core.$strip>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"PICKUP">;
+    pickup: z.ZodObject<{
+      addressId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+  }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
+    type: z.ZodString;
+  }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
+    [x: string]: unknown;
+    type: string;
+  }>>]>;
+  fulfillment: z.ZodObject<{
+    mode: z.ZodString;
+  }, z.core.$strip>;
+  fulfilledAt: z.ZodString;
+  testPayment: z.ZodBoolean;
+}, z.core.$strip>;
+export type OrderFulfilledWebhookEventData = z.infer<typeof orderFulfilledWebhookEventDataSchema>;
 /**
  * `ORDER.CANCELED` — 셀러 직권취소(`POST /v1/order-items/{orderItemId}/cancel`)로 주문상품이 취소됐다.
  * 수량 단위 부분 취소도 이 이벤트다(`quantity` < 주문 수량이면 주문상품 상태가 그대로다).
@@ -8549,6 +11315,8 @@ export declare const orderCanceledWebhookEventDataSchema: z.ZodObject<{
   refundAmount: z.ZodNumber;
   deliveryFeeRefundAmount: z.ZodNumber;
   deliveryFeeChargeAmount: z.ZodNumber;
+  couponChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+  couponChargeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   testPayment: z.ZodBoolean;
 }, z.core.$strip>;
 export type OrderCanceledWebhookEventData = z.infer<typeof orderCanceledWebhookEventDataSchema>;
@@ -8577,6 +11345,8 @@ export declare const claimWebhookEventDataSchema: z.ZodObject<{
   deliveryFeeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   deliveryFeeChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   deductAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+  couponChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+  couponChargeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, z.core.$strip>;
 export type ClaimWebhookEventData = z.infer<typeof claimWebhookEventDataSchema>;
@@ -8618,10 +11388,111 @@ export declare const orderWebhookEventSchema: z.ZodObject<{
       PURCHASE_DECIDED: "PURCHASE_DECIDED";
     }>;
     testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    orderItemId: z.ZodOptional<z.ZodString>;
+    fulfillmentSnapshot: z.ZodOptional<z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+      type: z.ZodLiteral<"SHIPPING">;
+      shipping: z.ZodObject<{
+        bundleKey: z.ZodNullable<z.ZodString>;
+        returnAddressId: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"DOWNLOAD">;
+      download: z.ZodObject<{
+        limit: z.ZodNumber;
+        days: z.ZodNumber;
+        stockTracked: z.ZodBoolean;
+        withdrawalRestricted: z.ZodBoolean;
+      }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"CODE">;
+      code: z.ZodObject<{
+        mode: z.ZodString;
+        withdrawalRestricted: z.ZodBoolean;
+      }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"SERVICE">;
+      service: z.ZodObject<{
+        mode: z.ZodString;
+      }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"PICKUP">;
+      pickup: z.ZodObject<{
+        addressId: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>;
+    }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
+      type: z.ZodString;
+    }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
+      [x: string]: unknown;
+      type: string;
+    }>>]>>;
+  }, z.core.$strip>;
+  id: z.ZodString;
+  createdAt: z.ZodString;
+  storeId: z.ZodString;
+  sequence: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const orderFulfilledWebhookEventSchema: z.ZodObject<{
+  type: z.ZodLiteral<"ORDER.FULFILLED">;
+  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";
+    }>;
+    fulfillmentSnapshot: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+      type: z.ZodLiteral<"SHIPPING">;
+      shipping: z.ZodObject<{
+        bundleKey: z.ZodNullable<z.ZodString>;
+        returnAddressId: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"DOWNLOAD">;
+      download: z.ZodObject<{
+        limit: z.ZodNumber;
+        days: z.ZodNumber;
+        stockTracked: z.ZodBoolean;
+        withdrawalRestricted: z.ZodBoolean;
+      }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"CODE">;
+      code: z.ZodObject<{
+        mode: z.ZodString;
+        withdrawalRestricted: z.ZodBoolean;
+      }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"SERVICE">;
+      service: z.ZodObject<{
+        mode: z.ZodString;
+      }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"PICKUP">;
+      pickup: z.ZodObject<{
+        addressId: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>;
+    }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
+      type: z.ZodString;
+    }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
+      [x: string]: unknown;
+      type: string;
+    }>>]>;
+    fulfillment: z.ZodObject<{
+      mode: z.ZodString;
+    }, z.core.$strip>;
+    fulfilledAt: z.ZodString;
+    testPayment: z.ZodBoolean;
   }, z.core.$strip>;
   id: z.ZodString;
   createdAt: z.ZodString;
   storeId: z.ZodString;
+  sequence: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export declare const orderCanceledWebhookEventSchema: z.ZodObject<{
   type: z.ZodLiteral<"ORDER.CANCELED">;
@@ -8654,11 +11525,14 @@ export declare const orderCanceledWebhookEventSchema: z.ZodObject<{
     refundAmount: z.ZodNumber;
     deliveryFeeRefundAmount: z.ZodNumber;
     deliveryFeeChargeAmount: z.ZodNumber;
+    couponChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    couponChargeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     testPayment: z.ZodBoolean;
   }, z.core.$strip>;
   id: z.ZodString;
   createdAt: z.ZodString;
   storeId: z.ZodString;
+  sequence: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export declare const claimWebhookEventSchema: z.ZodObject<{
   type: z.ZodEnum<{
@@ -8692,11 +11566,14 @@ export declare const claimWebhookEventSchema: z.ZodObject<{
     deliveryFeeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     deliveryFeeChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     deductAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    couponChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    couponChargeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
   }, z.core.$strip>;
   id: z.ZodString;
   createdAt: z.ZodString;
   storeId: z.ZodString;
+  sequence: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export declare const inquiryWebhookEventSchema: z.ZodObject<{
   type: z.ZodLiteral<"INQUIRY.CREATED">;
@@ -8707,6 +11584,7 @@ export declare const inquiryWebhookEventSchema: z.ZodObject<{
   id: z.ZodString;
   createdAt: z.ZodString;
   storeId: z.ZodString;
+  sequence: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export declare const reviewWebhookEventSchema: z.ZodObject<{
   type: z.ZodLiteral<"REVIEW.CREATED">;
@@ -8718,6 +11596,7 @@ export declare const reviewWebhookEventSchema: z.ZodObject<{
   id: z.ZodString;
   createdAt: z.ZodString;
   storeId: z.ZodString;
+  sequence: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export declare const productOutOfStockWebhookEventSchema: z.ZodObject<{
   type: z.ZodLiteral<"PRODUCT.OUT_OF_STOCK">;
@@ -8728,6 +11607,7 @@ export declare const productOutOfStockWebhookEventSchema: z.ZodObject<{
   id: z.ZodString;
   createdAt: z.ZodString;
   storeId: z.ZodString;
+  sequence: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 /** 웹훅 요청 본문. `type`으로 판별하며 `data` 형태가 타입별로 다르다 */
 export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -8752,10 +11632,110 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       PURCHASE_DECIDED: "PURCHASE_DECIDED";
     }>;
     testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    orderItemId: z.ZodOptional<z.ZodString>;
+    fulfillmentSnapshot: z.ZodOptional<z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+      type: z.ZodLiteral<"SHIPPING">;
+      shipping: z.ZodObject<{
+        bundleKey: z.ZodNullable<z.ZodString>;
+        returnAddressId: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"DOWNLOAD">;
+      download: z.ZodObject<{
+        limit: z.ZodNumber;
+        days: z.ZodNumber;
+        stockTracked: z.ZodBoolean;
+        withdrawalRestricted: z.ZodBoolean;
+      }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"CODE">;
+      code: z.ZodObject<{
+        mode: z.ZodString;
+        withdrawalRestricted: z.ZodBoolean;
+      }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"SERVICE">;
+      service: z.ZodObject<{
+        mode: z.ZodString;
+      }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"PICKUP">;
+      pickup: z.ZodObject<{
+        addressId: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>;
+    }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
+      type: z.ZodString;
+    }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
+      [x: string]: unknown;
+      type: string;
+    }>>]>>;
+  }, z.core.$strip>;
+  id: z.ZodString;
+  createdAt: z.ZodString;
+  storeId: z.ZodString;
+  sequence: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"ORDER.FULFILLED">;
+  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";
+    }>;
+    fulfillmentSnapshot: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+      type: z.ZodLiteral<"SHIPPING">;
+      shipping: z.ZodObject<{
+        bundleKey: z.ZodNullable<z.ZodString>;
+        returnAddressId: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"DOWNLOAD">;
+      download: z.ZodObject<{
+        limit: z.ZodNumber;
+        days: z.ZodNumber;
+        stockTracked: z.ZodBoolean;
+        withdrawalRestricted: z.ZodBoolean;
+      }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"CODE">;
+      code: z.ZodObject<{
+        mode: z.ZodString;
+        withdrawalRestricted: z.ZodBoolean;
+      }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"SERVICE">;
+      service: z.ZodObject<{
+        mode: z.ZodString;
+      }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"PICKUP">;
+      pickup: z.ZodObject<{
+        addressId: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>;
+    }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
+      type: z.ZodString;
+    }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
+      [x: string]: unknown;
+      type: string;
+    }>>]>;
+    fulfillment: z.ZodObject<{
+      mode: z.ZodString;
+    }, z.core.$strip>;
+    fulfilledAt: z.ZodString;
+    testPayment: z.ZodBoolean;
   }, z.core.$strip>;
   id: z.ZodString;
   createdAt: z.ZodString;
   storeId: z.ZodString;
+  sequence: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>, z.ZodObject<{
   type: z.ZodLiteral<"ORDER.CANCELED">;
   data: z.ZodObject<{
@@ -8787,11 +11767,14 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     refundAmount: z.ZodNumber;
     deliveryFeeRefundAmount: z.ZodNumber;
     deliveryFeeChargeAmount: z.ZodNumber;
+    couponChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    couponChargeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     testPayment: z.ZodBoolean;
   }, z.core.$strip>;
   id: z.ZodString;
   createdAt: z.ZodString;
   storeId: z.ZodString;
+  sequence: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>, z.ZodObject<{
   type: z.ZodEnum<{
     "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
@@ -8824,11 +11807,14 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     deliveryFeeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     deliveryFeeChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     deductAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    couponChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    couponChargeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
   }, z.core.$strip>;
   id: z.ZodString;
   createdAt: z.ZodString;
   storeId: z.ZodString;
+  sequence: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>, z.ZodObject<{
   type: z.ZodLiteral<"INQUIRY.CREATED">;
   data: z.ZodObject<{
@@ -8838,6 +11824,7 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   id: z.ZodString;
   createdAt: z.ZodString;
   storeId: z.ZodString;
+  sequence: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>, z.ZodObject<{
   type: z.ZodLiteral<"REVIEW.CREATED">;
   data: z.ZodObject<{
@@ -8848,6 +11835,7 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   id: z.ZodString;
   createdAt: z.ZodString;
   storeId: z.ZodString;
+  sequence: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>, z.ZodObject<{
   type: z.ZodLiteral<"PRODUCT.OUT_OF_STOCK">;
   data: z.ZodObject<{
@@ -8857,6 +11845,7 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   id: z.ZodString;
   createdAt: z.ZodString;
   storeId: z.ZodString;
+  sequence: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>], "type">;
 export type WebhookEvent = z.infer<typeof webhookEventSchema>;
 export type WebhookEventType = WebhookEvent["type"];