@sayren/store-sdk 0.16.0 → 0.17.0

package/dist/index.d.mts

@@ -33,8 +33,8 @@ export declare const auditLogSourceSchema: z.ZodEnum<{
 }>;
 export type AuditLogSource = z.infer<typeof auditLogSourceSchema>;
 export declare const auditLogOutcomeSchema: z.ZodEnum<{
-  FAILED: "FAILED";
   SUCCEEDED: "SUCCEEDED";
+  FAILED: "FAILED";
   PENDING_APPROVAL: "PENDING_APPROVAL";
   DENIED: "DENIED";
   DRY_RUN: "DRY_RUN";
@@ -69,8 +69,8 @@ export declare const auditLogSchema: z.ZodObject<{
   path: z.ZodNullable<z.ZodString>;
   statusCode: z.ZodNullable<z.ZodNumber>;
   outcome: z.ZodNullable<z.ZodEnum<{
-    FAILED: "FAILED";
     SUCCEEDED: "SUCCEEDED";
+    FAILED: "FAILED";
     PENDING_APPROVAL: "PENDING_APPROVAL";
     DENIED: "DENIED";
     DRY_RUN: "DRY_RUN";
@@ -102,8 +102,8 @@ export declare const auditLogListQuerySchema: z.ZodObject<{
     DOMAIN: "DOMAIN";
   }>>;
   outcome: z.ZodOptional<z.ZodEnum<{
-    FAILED: "FAILED";
     SUCCEEDED: "SUCCEEDED";
+    FAILED: "FAILED";
     PENDING_APPROVAL: "PENDING_APPROVAL";
     DENIED: "DENIED";
     DRY_RUN: "DRY_RUN";
@@ -149,8 +149,8 @@ export declare const auditLogPageSchema: z.ZodObject<{
     path: z.ZodNullable<z.ZodString>;
     statusCode: z.ZodNullable<z.ZodNumber>;
     outcome: z.ZodNullable<z.ZodEnum<{
-      FAILED: "FAILED";
       SUCCEEDED: "SUCCEEDED";
+      FAILED: "FAILED";
       PENDING_APPROVAL: "PENDING_APPROVAL";
       DENIED: "DENIED";
       DRY_RUN: "DRY_RUN";
@@ -166,8 +166,8 @@ export declare const auditLogPageSchema: z.ZodObject<{
 export type AuditLogPage = z.infer<typeof auditLogPageSchema>;
 export declare const agentPolicyDecisionSchema: z.ZodEnum<{
   DENIED: "DENIED";
-  APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
   ALLOW: "ALLOW";
+  APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
 }>;
 export type AgentPolicyDecision = z.infer<typeof agentPolicyDecisionSchema>;
 export declare const writePreviewSchema: z.ZodObject<{
@@ -191,8 +191,8 @@ export declare const writeDryRunResultSchema: z.ZodObject<{
   dryRun: z.ZodLiteral<true>;
   decision: z.ZodEnum<{
     DENIED: "DENIED";
-    APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
     ALLOW: "ALLOW";
+    APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
   }>;
   reason: z.ZodNullable<z.ZodString>;
   preview: z.ZodObject<{
@@ -213,9 +213,9 @@ export declare const writeDryRunResultSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type WriteDryRunResult = z.infer<typeof writeDryRunResultSchema>;
 export declare const approvalStatusSchema: z.ZodEnum<{
-  PENDING: "PENDING";
-  FAILED: "FAILED";
   SUCCEEDED: "SUCCEEDED";
+  FAILED: "FAILED";
+  PENDING: "PENDING";
   EXECUTING: "EXECUTING";
   UNKNOWN: "UNKNOWN";
   REJECTED: "REJECTED";
@@ -225,9 +225,9 @@ export type ApprovalStatus = z.infer<typeof approvalStatusSchema>;
 export declare const approvalRequestSchema: z.ZodObject<{
   approvalId: z.ZodString;
   status: z.ZodEnum<{
-    PENDING: "PENDING";
-    FAILED: "FAILED";
     SUCCEEDED: "SUCCEEDED";
+    FAILED: "FAILED";
+    PENDING: "PENDING";
     EXECUTING: "EXECUTING";
     UNKNOWN: "UNKNOWN";
     REJECTED: "REJECTED";
@@ -287,9 +287,9 @@ 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<{
-    PENDING: "PENDING";
-    FAILED: "FAILED";
     SUCCEEDED: "SUCCEEDED";
+    FAILED: "FAILED";
+    PENDING: "PENDING";
     EXECUTING: "EXECUTING";
     UNKNOWN: "UNKNOWN";
     REJECTED: "REJECTED";
@@ -306,9 +306,9 @@ export declare const approvalPageSchema: z.ZodObject<{
   items: z.ZodArray<z.ZodObject<{
     approvalId: z.ZodString;
     status: z.ZodEnum<{
-      PENDING: "PENDING";
-      FAILED: "FAILED";
       SUCCEEDED: "SUCCEEDED";
+      FAILED: "FAILED";
+      PENDING: "PENDING";
       EXECUTING: "EXECUTING";
       UNKNOWN: "UNKNOWN";
       REJECTED: "REJECTED";
@@ -581,10 +581,10 @@ export declare const analyticsProductsSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type AnalyticsProducts = z.infer<typeof analyticsProductsSchema>;
 export declare const analyticsChannelSchema: z.ZodEnum<{
+  UNKNOWN: "UNKNOWN";
   PAID: "PAID";
   DIRECT: "DIRECT";
   CAMPAIGN: "CAMPAIGN";
-  UNKNOWN: "UNKNOWN";
   ORGANIC_SEARCH: "ORGANIC_SEARCH";
   SOCIAL: "SOCIAL";
   EMAIL: "EMAIL";
@@ -615,10 +615,10 @@ export declare const analyticsSourcesQuerySchema: z.ZodObject<{
 export type AnalyticsSourcesParams = z.infer<typeof analyticsSourcesQuerySchema>;
 export declare const analyticsSourceRowSchema: z.ZodObject<{
   channel: z.ZodNullable<z.ZodEnum<{
+    UNKNOWN: "UNKNOWN";
     PAID: "PAID";
     DIRECT: "DIRECT";
     CAMPAIGN: "CAMPAIGN";
-    UNKNOWN: "UNKNOWN";
     ORGANIC_SEARCH: "ORGANIC_SEARCH";
     SOCIAL: "SOCIAL";
     EMAIL: "EMAIL";
@@ -651,10 +651,10 @@ export declare const analyticsSourcesSchema: z.ZodObject<{
   }>;
   rows: z.ZodArray<z.ZodObject<{
     channel: z.ZodNullable<z.ZodEnum<{
+      UNKNOWN: "UNKNOWN";
       PAID: "PAID";
       DIRECT: "DIRECT";
       CAMPAIGN: "CAMPAIGN";
-      UNKNOWN: "UNKNOWN";
       ORGANIC_SEARCH: "ORGANIC_SEARCH";
       SOCIAL: "SOCIAL";
       EMAIL: "EMAIL";
@@ -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<{
+  EXPIRED: "EXPIRED";
+  REVOKED: "REVOKED";
+  AVAILABLE: "AVAILABLE";
+  ASSIGNED: "ASSIGNED";
+  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<{
+    EXPIRED: "EXPIRED";
+    REVOKED: "REVOKED";
+    AVAILABLE: "AVAILABLE";
+    ASSIGNED: "ASSIGNED";
+    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";
@@ -2352,10 +2833,10 @@ export declare const webhookSecretRotatedSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type WebhookSecretRotated = z.infer<typeof webhookSecretRotatedSchema>;
 export declare const webhookDeliveryStatusSchema: z.ZodEnum<{
+  FAILED: "FAILED";
   PENDING: "PENDING";
   PENDING_RETRY: "PENDING_RETRY";
   SUCCESS: "SUCCESS";
-  FAILED: "FAILED";
 }>;
 export type WebhookDeliveryStatus = z.infer<typeof webhookDeliveryStatusSchema>;
 export declare const webhookDeliveryErrorCodeSchema: z.ZodEnum<{
@@ -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";
@@ -2416,10 +2898,10 @@ export declare const webhookDeliverySchema: z.ZodObject<{
   }>;
   url: z.ZodString;
   status: z.ZodEnum<{
+    FAILED: "FAILED";
     PENDING: "PENDING";
     PENDING_RETRY: "PENDING_RETRY";
     SUCCESS: "SUCCESS";
-    FAILED: "FAILED";
   }>;
   responseStatusCode: z.ZodNullable<z.ZodNumber>;
   responseTimeMs: z.ZodNullable<z.ZodNumber>;
@@ -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";
@@ -2468,10 +2951,10 @@ export declare const webhookDeliveryDetailSchema: z.ZodObject<{
   }>;
   url: z.ZodString;
   status: z.ZodEnum<{
+    FAILED: "FAILED";
     PENDING: "PENDING";
     PENDING_RETRY: "PENDING_RETRY";
     SUCCESS: "SUCCESS";
-    FAILED: "FAILED";
   }>;
   responseStatusCode: z.ZodNullable<z.ZodNumber>;
   responseTimeMs: z.ZodNullable<z.ZodNumber>;
@@ -2506,10 +2989,10 @@ export type WebhookDeliveryDetail = z.infer<typeof webhookDeliveryDetailSchema>;
 /** 전송 기록 조회 쿼리 — `GET /webhooks/{id}/deliveries` */
 export declare const webhookDeliveryListQuerySchema: z.ZodObject<{
   status: z.ZodOptional<z.ZodEnum<{
+    FAILED: "FAILED";
     PENDING: "PENDING";
     PENDING_RETRY: "PENDING_RETRY";
     SUCCESS: "SUCCESS";
-    FAILED: "FAILED";
   }>>;
   eventType: z.ZodOptional<z.ZodEnum<{
     "ORDER.PAID": "ORDER.PAID";
@@ -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,6 +3150,89 @@ export declare const reviewReportResultSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type ReviewReportResult = z.infer<typeof reviewReportResultSchema>;
 //#endregion
+//#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";
+//#endregion
 //#region src/schemas/order.d.ts
 export declare const orderSummarySchema: z.ZodObject<{
   orderId: z.ZodString;
@@ -2694,6 +3263,41 @@ export declare const shippingAddressSchema: z.ZodObject<{
   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;
@@ -2717,16 +3321,46 @@ export declare const orderItemSchema: z.ZodObject<{
   optionId: z.ZodNullable<z.ZodString>;
   optionName: z.ZodNullable<z.ZodString>;
   sellerCode: z.ZodNullable<z.ZodString>;
+  fulfillmentType: z.ZodDefault<z.ZodOptional<z.ZodString>>;
   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;
@@ -2743,9 +3377,19 @@ export declare const orderItemSchema: z.ZodObject<{
     "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
     "CLAIM.COMPLETED": "CLAIM.COMPLETED";
   }>;
+  withdrawalRestricted: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
   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 +3398,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 +3422,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 +3456,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 +3481,46 @@ export declare const orderSchema: z.ZodObject<{
     optionId: z.ZodNullable<z.ZodString>;
     optionName: z.ZodNullable<z.ZodString>;
     sellerCode: z.ZodNullable<z.ZodString>;
+    fulfillmentType: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     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;
@@ -2852,6 +3537,7 @@ export declare const orderSchema: z.ZodObject<{
       "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
       "CLAIM.COMPLETED": "CLAIM.COMPLETED";
     }>;
+    withdrawalRestricted: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     testPayment: z.ZodBoolean;
   }, z.core.$strip>>;
 }, z.core.$strip>;
@@ -2911,16 +3597,46 @@ export declare const orderItemPageSchema: z.ZodObject<{
     optionId: z.ZodNullable<z.ZodString>;
     optionName: z.ZodNullable<z.ZodString>;
     sellerCode: z.ZodNullable<z.ZodString>;
+    fulfillmentType: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     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;
@@ -2937,6 +3653,7 @@ export declare const orderItemPageSchema: z.ZodObject<{
       "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
       "CLAIM.COMPLETED": "CLAIM.COMPLETED";
     }>;
+    withdrawalRestricted: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     testPayment: z.ZodBoolean;
   }, z.core.$strip>>;
 }, z.core.$strip>;
@@ -2962,6 +3679,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 +3716,8 @@ export interface OrderListParams extends PageParams {
   orderedTo?: string;
   status?: z.infer<typeof orderItemStatusSchema>;
   keyword?: string;
+  /** 상품 유형 필터 — 이 유형의 주문상품이 하나라도 있는 주문(이슈 #48) */
+  fulfillmentType?: z.infer<typeof fulfillmentTypeResponseSchema>;
   /** 테스트 결제 필터 — `"true"` 테스트 결제만, `"false"` 실결제만, 생략하면 전부 */
   testPayment?: "true" | "false";
 }
@@ -3122,6 +3842,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 +3865,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>;
@@ -3202,8 +3939,8 @@ export declare const pgEnvironmentSchema: z.ZodEnum<{
 }>;
 export type PgEnvironment = z.infer<typeof pgEnvironmentSchema>;
 export declare const pgVerificationResultSchema: z.ZodEnum<{
-  SUCCESS: "SUCCESS";
   FAILED: "FAILED";
+  SUCCESS: "SUCCESS";
 }>;
 export type PgVerificationResult = z.infer<typeof pgVerificationResultSchema>;
 /**
@@ -3352,8 +4089,8 @@ export declare const paymentCredentialSetSchema: z.ZodObject<{
   }, z.core.$strip>>;
   lastVerification: z.ZodNullable<z.ZodObject<{
     result: z.ZodEnum<{
-      SUCCESS: "SUCCESS";
       FAILED: "FAILED";
+      SUCCESS: "SUCCESS";
     }>;
     message: z.ZodNullable<z.ZodString>;
     checkedAt: z.ZodString;
@@ -3454,8 +4191,8 @@ export declare const paymentProviderSchema: z.ZodObject<{
   }, z.core.$strip>>;
   lastVerification: z.ZodNullable<z.ZodObject<{
     result: z.ZodEnum<{
-      SUCCESS: "SUCCESS";
       FAILED: "FAILED";
+      SUCCESS: "SUCCESS";
     }>;
     message: z.ZodNullable<z.ZodString>;
     checkedAt: z.ZodString;
@@ -3491,8 +4228,8 @@ export declare const paymentProviderSchema: z.ZodObject<{
       }, z.core.$strip>>;
       lastVerification: z.ZodNullable<z.ZodObject<{
         result: z.ZodEnum<{
-          SUCCESS: "SUCCESS";
           FAILED: "FAILED";
+          SUCCESS: "SUCCESS";
         }>;
         message: z.ZodNullable<z.ZodString>;
         checkedAt: z.ZodString;
@@ -3527,8 +4264,8 @@ export declare const paymentProviderSchema: z.ZodObject<{
       }, z.core.$strip>>;
       lastVerification: z.ZodNullable<z.ZodObject<{
         result: z.ZodEnum<{
-          SUCCESS: "SUCCESS";
           FAILED: "FAILED";
+          SUCCESS: "SUCCESS";
         }>;
         message: z.ZodNullable<z.ZodString>;
         checkedAt: z.ZodString;
@@ -3603,8 +4340,8 @@ export declare const paymentSettingsSchema: z.ZodObject<{
     }, z.core.$strip>>;
     lastVerification: z.ZodNullable<z.ZodObject<{
       result: z.ZodEnum<{
-        SUCCESS: "SUCCESS";
         FAILED: "FAILED";
+        SUCCESS: "SUCCESS";
       }>;
       message: z.ZodNullable<z.ZodString>;
       checkedAt: z.ZodString;
@@ -3640,8 +4377,8 @@ export declare const paymentSettingsSchema: z.ZodObject<{
         }, z.core.$strip>>;
         lastVerification: z.ZodNullable<z.ZodObject<{
           result: z.ZodEnum<{
-            SUCCESS: "SUCCESS";
             FAILED: "FAILED";
+            SUCCESS: "SUCCESS";
           }>;
           message: z.ZodNullable<z.ZodString>;
           checkedAt: z.ZodString;
@@ -3676,8 +4413,8 @@ export declare const paymentSettingsSchema: z.ZodObject<{
         }, z.core.$strip>>;
         lastVerification: z.ZodNullable<z.ZodObject<{
           result: z.ZodEnum<{
-            SUCCESS: "SUCCESS";
             FAILED: "FAILED";
+            SUCCESS: "SUCCESS";
           }>;
           message: z.ZodNullable<z.ZodString>;
           checkedAt: z.ZodString;
@@ -3724,8 +4461,8 @@ export declare const paymentProviderVerificationSchema: z.ZodObject<{
     LIVE: "LIVE";
   }>;
   result: z.ZodEnum<{
-    SUCCESS: "SUCCESS";
     FAILED: "FAILED";
+    SUCCESS: "SUCCESS";
   }>;
   message: z.ZodNullable<z.ZodString>;
   checkedAt: z.ZodString;
@@ -3855,8 +4592,8 @@ export type SalesReport = z.infer<typeof salesReportSchema>;
  * - `FAILED`: 승인되지 않고 끝났다(거절·준비 장애·구매자 취소·만료)
  */
 export declare const paymentRecordStatusSchema: z.ZodEnum<{
-  PENDING: "PENDING";
   FAILED: "FAILED";
+  PENDING: "PENDING";
   APPROVED: "APPROVED";
   PARTIALLY_REFUNDED: "PARTIALLY_REFUNDED";
   REFUNDED: "REFUNDED";
@@ -3903,8 +4640,8 @@ export declare const paymentRecordSchema: z.ZodObject<{
   orderName: z.ZodString;
   customerName: z.ZodString;
   status: z.ZodEnum<{
-    PENDING: "PENDING";
     FAILED: "FAILED";
+    PENDING: "PENDING";
     APPROVED: "APPROVED";
     PARTIALLY_REFUNDED: "PARTIALLY_REFUNDED";
     REFUNDED: "REFUNDED";
@@ -3949,8 +4686,8 @@ export declare const paymentRecordPageSchema: z.ZodObject<{
     orderName: z.ZodString;
     customerName: z.ZodString;
     status: z.ZodEnum<{
-      PENDING: "PENDING";
       FAILED: "FAILED";
+      PENDING: "PENDING";
       APPROVED: "APPROVED";
       PARTIALLY_REFUNDED: "PARTIALLY_REFUNDED";
       REFUNDED: "REFUNDED";
@@ -4038,8 +4775,8 @@ export declare const paymentRecordDetailSchema: z.ZodObject<{
   orderName: z.ZodString;
   customerName: z.ZodString;
   status: z.ZodEnum<{
-    PENDING: "PENDING";
     FAILED: "FAILED";
+    PENDING: "PENDING";
     APPROVED: "APPROVED";
     PARTIALLY_REFUNDED: "PARTIALLY_REFUNDED";
     REFUNDED: "REFUNDED";
@@ -4193,6 +4930,7 @@ export declare const productSummarySchema: z.ZodObject<{
   categoryId: z.ZodNullable<z.ZodString>;
   thumbnailUrl: z.ZodOptional<z.ZodURL>;
   hasOptions: z.ZodBoolean;
+  fulfillmentType: z.ZodDefault<z.ZodOptional<z.ZodString>>;
   updatedAt: z.ZodString;
 }, z.core.$strip>;
 export type ProductSummary = z.infer<typeof productSummarySchema>;
@@ -4233,6 +4971,18 @@ 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;
@@ -4249,6 +4999,25 @@ export declare const productSchema: z.ZodObject<{
   thumbnailUrl: z.ZodOptional<z.ZodURL>;
   hasOptions: z.ZodBoolean;
   updatedAt: z.ZodString;
+  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>;
+  fulfillmentType: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+  fulfillmentMode: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+  stockTracking: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+  downloadLimit: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+  downloadDays: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+  withdrawalRestricted: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+  pickupAddressId: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
   description: z.ZodOptional<z.ZodString>;
   descriptionJson: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   originalPrice: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -4298,7 +5067,6 @@ export declare const productSchema: z.ZodObject<{
   }, z.core.$strict>>>;
   shippingAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   returnAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-  createdAt: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type Product = z.infer<typeof productSchema>;
 /** 상품 하나에 등록할 수 있는 이미지 최대 장수 — 첫 장이 대표(썸네일)다 */
@@ -4433,6 +5201,22 @@ export declare const variantStockSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type VariantStock = z.infer<typeof variantStockSchema>;
 export declare const productCreateRequestSchema: z.ZodObject<{
+  fulfillmentType: z.ZodOptional<z.ZodEnum<{
+    SHIPPING: "SHIPPING";
+    DOWNLOAD: "DOWNLOAD";
+    CODE: "CODE";
+    SERVICE: "SERVICE";
+    PICKUP: "PICKUP";
+  }>>;
+  fulfillmentMode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+    AUTO: "AUTO";
+    MANUAL: "MANUAL";
+  }>>>;
+  stockTracking: z.ZodOptional<z.ZodBoolean>;
+  downloadLimit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  downloadDays: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  withdrawalRestricted: z.ZodOptional<z.ZodBoolean>;
+  pickupAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   name: z.ZodString;
   categoryId: z.ZodString;
   salePrice: z.ZodNumber;
@@ -4485,6 +5269,22 @@ export declare const productCreateRequestSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type ProductCreateRequest = z.infer<typeof productCreateRequestSchema>;
 export declare const productPatchRequestSchema: z.ZodObject<{
+  fulfillmentType: z.ZodOptional<z.ZodEnum<{
+    SHIPPING: "SHIPPING";
+    DOWNLOAD: "DOWNLOAD";
+    CODE: "CODE";
+    SERVICE: "SERVICE";
+    PICKUP: "PICKUP";
+  }>>;
+  fulfillmentMode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+    AUTO: "AUTO";
+    MANUAL: "MANUAL";
+  }>>>;
+  stockTracking: z.ZodOptional<z.ZodBoolean>;
+  downloadLimit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  downloadDays: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  withdrawalRestricted: z.ZodOptional<z.ZodBoolean>;
+  pickupAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   name: z.ZodOptional<z.ZodString>;
   salePrice: z.ZodOptional<z.ZodNumber>;
   status: z.ZodOptional<z.ZodEnum<{
@@ -4534,18 +5334,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 +5385,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 +5395,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 +5425,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 +5435,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;
@@ -4746,23 +5540,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 +5577,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 +5596,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 +5617,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 +5644,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 +5652,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
@@ -5125,6 +5935,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
     create: (body: UploadRequest) => Promise<{
       url: string;
       uploadUrl: string;
+      headers: Record<string, string>;
+      key?: string | undefined;
     }>;
     /**
      * 자리 발급 + 바이트 PUT을 한 번에 — 끝나면 `url`이 공개 주소다.
@@ -5152,6 +5964,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         stockQuantity: number;
         categoryId: string | null;
         hasOptions: boolean;
+        fulfillmentType: string;
         updatedAt: string;
         thumbnailUrl?: string | undefined;
       }[];
@@ -5166,6 +5979,13 @@ export declare function createStoreClient(options: StoreClientOptions): {
       categoryId: string | null;
       hasOptions: boolean;
       updatedAt: string;
+      fulfillmentType: string;
+      fulfillmentMode: string | null;
+      stockTracking: boolean;
+      downloadLimit: number | null;
+      downloadDays: number | null;
+      withdrawalRestricted: boolean;
+      pickupAddressId: string | null;
       optionGroups: {
         groupId: string;
         name: string;
@@ -5190,6 +6010,15 @@ export declare function createStoreClient(options: StoreClientOptions): {
         usable: boolean;
       }[];
       thumbnailUrl?: string | undefined;
+      discount?: {
+        productId: string;
+        discountType: "RATE" | "AMOUNT";
+        discountValue: number;
+        discountedPrice: number;
+        startAt: string | null;
+        endAt: string | null;
+      } | null | undefined;
+      createdAt?: string | undefined;
       description?: string | undefined;
       descriptionJson?: string | null | undefined;
       originalPrice?: number | null | undefined;
@@ -5212,7 +6041,6 @@ export declare function createStoreClient(options: StoreClientOptions): {
       } | null | undefined;
       shippingAddressId?: string | null | undefined;
       returnAddressId?: string | null | undefined;
-      createdAt?: string | undefined;
     }>;
     create: (body: ProductCreateRequest, idempotencyKey?: string) => Promise<{
       productId: string;
@@ -5224,6 +6052,13 @@ export declare function createStoreClient(options: StoreClientOptions): {
       categoryId: string | null;
       hasOptions: boolean;
       updatedAt: string;
+      fulfillmentType: string;
+      fulfillmentMode: string | null;
+      stockTracking: boolean;
+      downloadLimit: number | null;
+      downloadDays: number | null;
+      withdrawalRestricted: boolean;
+      pickupAddressId: string | null;
       optionGroups: {
         groupId: string;
         name: string;
@@ -5248,6 +6083,15 @@ export declare function createStoreClient(options: StoreClientOptions): {
         usable: boolean;
       }[];
       thumbnailUrl?: string | undefined;
+      discount?: {
+        productId: string;
+        discountType: "RATE" | "AMOUNT";
+        discountValue: number;
+        discountedPrice: number;
+        startAt: string | null;
+        endAt: string | null;
+      } | null | undefined;
+      createdAt?: string | undefined;
       description?: string | undefined;
       descriptionJson?: string | null | undefined;
       originalPrice?: number | null | undefined;
@@ -5270,7 +6114,6 @@ export declare function createStoreClient(options: StoreClientOptions): {
       } | null | undefined;
       shippingAddressId?: string | null | undefined;
       returnAddressId?: string | null | undefined;
-      createdAt?: string | undefined;
     }>;
     update: (productId: string, body: ProductCreateRequest) => Promise<{
       productId: string;
@@ -5282,6 +6125,13 @@ export declare function createStoreClient(options: StoreClientOptions): {
       categoryId: string | null;
       hasOptions: boolean;
       updatedAt: string;
+      fulfillmentType: string;
+      fulfillmentMode: string | null;
+      stockTracking: boolean;
+      downloadLimit: number | null;
+      downloadDays: number | null;
+      withdrawalRestricted: boolean;
+      pickupAddressId: string | null;
       optionGroups: {
         groupId: string;
         name: string;
@@ -5306,6 +6156,15 @@ export declare function createStoreClient(options: StoreClientOptions): {
         usable: boolean;
       }[];
       thumbnailUrl?: string | undefined;
+      discount?: {
+        productId: string;
+        discountType: "RATE" | "AMOUNT";
+        discountValue: number;
+        discountedPrice: number;
+        startAt: string | null;
+        endAt: string | null;
+      } | null | undefined;
+      createdAt?: string | undefined;
       description?: string | undefined;
       descriptionJson?: string | null | undefined;
       originalPrice?: number | null | undefined;
@@ -5328,7 +6187,6 @@ export declare function createStoreClient(options: StoreClientOptions): {
       } | null | undefined;
       shippingAddressId?: string | null | undefined;
       returnAddressId?: string | null | undefined;
-      createdAt?: string | undefined;
     }>;
     patch: (productId: string, body: ProductPatchRequest) => Promise<void>;
     remove: (productId: string) => Promise<void>;
@@ -5419,6 +6277,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 +6563,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         phone: string;
         email?: string | undefined;
       };
+      requiresShipping: boolean;
       shippingAddress: {
         receiverName: string;
         phone: string;
@@ -5617,6 +6580,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 +6611,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           updatedAt: string;
         } | null;
       };
+      withdrawalAgreedAt: string | null;
       testPayment: boolean;
       items: {
         orderItemId: string;
@@ -5650,21 +6623,52 @@ export declare function createStoreClient(options: StoreClientOptions): {
         optionId: string | null;
         optionName: string | null;
         sellerCode: string | null;
+        fulfillmentType: string;
         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";
+        withdrawalRestricted: boolean;
         testPayment: boolean;
       }[];
     }>;
@@ -5709,21 +6713,52 @@ export declare function createStoreClient(options: StoreClientOptions): {
         optionId: string | null;
         optionName: string | null;
         sellerCode: string | null;
+        fulfillmentType: string;
         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";
+        withdrawalRestricted: boolean;
         testPayment: boolean;
       }[];
     }>;
@@ -5747,6 +6782,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>;
@@ -5779,12 +6816,92 @@ export declare function createStoreClient(options: StoreClientOptions): {
         orderItemId?: string | undefined;
       }[];
     }>;
-    updateTracking: (orderItemId: string, carrierCode: string, trackingNumber: string) => Promise<void>;
+    updateTracking: (orderItemId: string, carrierCode: string, trackingNumber: string) => Promise<void>;
+    /**
+     * 배송완료 처리 — `DISPATCHED`·`DELIVERING`만 넘어간다. 응답의 `autoDecisionDate`가 자동 구매확정 예정일이다
+     * (스토어 설정 `autoConfirmDays`가 0이면 null).
+     */
+    markDelivered: (orderItemId: string, 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;
+      fulfillmentType: string;
+      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";
+      withdrawalRestricted: boolean;
+      testPayment: boolean;
+    }>;
+    /** 배송완료 일괄 처리 — 항목별 부분 성공이다 */
+    markDeliveredBulk: (orderItemIds: string[], idempotencyKey?: string) => Promise<{
+      succeeded: string[];
+      failed: {
+        code: string;
+        message: string;
+        id?: string | undefined;
+        productId?: string | undefined;
+        orderItemId?: string | undefined;
+      }[];
+    }>;
+    /**
+     * 제공 안내 메일 재발송 (이슈 #48) — 제공된 주문상품의 안내 메일을 다시 보낸다. 주문상품당 하루 3회(429).
+     * 코드·파일 주소는 메일에 없다
+     */
+    resendFulfillmentMail: (orderItemId: string) => Promise<{
+      mailStatus: string;
+    }>;
     /**
-     * 배송완료 처리 — `DISPATCHED`·`DELIVERING`만 넘어간다. 응답의 `autoDecisionDate`가 자동 구매확정 예정일이다
-     * (스토어 설정 `autoConfirmDays`가 0이면 null).
+     * 제공 처리 (이슈 #48) — 수동 제공 비실물 주문상품(이용권·방문 수령)을 `PAID`·`CONFIRMED`에서 제공 완료(`DELIVERED`)로
+     * 바꾼다. `note`는 구매자 주문 상세에 이용 안내로 실린다. 배송 상품은 409 `SHIPPING_REQUIRED`
      */
-    markDelivered: (orderItemId: string, idempotencyKey?: string) => Promise<{
+    fulfill: (orderItemId: string, body?: FulfillRequest, idempotencyKey?: string) => Promise<{
       orderItemId: string;
       orderId: string;
       status: "PAID" | "CANCELED" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED";
@@ -5794,25 +6911,56 @@ export declare function createStoreClient(options: StoreClientOptions): {
       optionId: string | null;
       optionName: string | null;
       sellerCode: string | null;
+      fulfillmentType: string;
       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";
+      withdrawalRestricted: boolean;
       testPayment: boolean;
     }>;
-    /** 배송완료 일괄 처리 — 항목별 부분 성공이다 */
-    markDeliveredBulk: (orderItemIds: string[], idempotencyKey?: string) => Promise<{
+    /** 제공 처리 일괄 — 항목별 부분 성공이다 */
+    fulfillBulk: (orderItemIds: string[], body?: FulfillRequest, idempotencyKey?: string) => Promise<{
       succeeded: string[];
       failed: {
         code: string;
@@ -5882,6 +7030,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 +7068,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 +7094,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 +7134,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 +7164,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 +7182,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;
@@ -6260,8 +7413,395 @@ export declare function createStoreClient(options: StoreClientOptions): {
         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: {
+        issueId: string;
+        couponId: string;
+        customerId: string;
+        customerName: string | null;
+        status: string;
+        validFrom: string;
+        validUntil: string | null;
+        usedOrderId: string | null;
+        issuedAt: string;
+        revokedAt: string | null;
+      }[];
+    }>;
+    redemptions: (couponId: string, params?: PageParams & {
+      status?: "RESERVED" | "USED" | "RELEASED" | "RESTORED";
+    }) => Promise<{
+      page: number;
+      size: number;
+      totalElements: number;
+      totalPages: number;
+      contents: {
+        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;
+      }[];
+    }>;
+    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 & {
       answered?: boolean;
@@ -6477,7 +8017,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     sources: (params: AnalyticsSourcesParams) => Promise<{
       groupBy: "CHANNEL" | "SOURCE" | "CAMPAIGN" | "DEVICE";
       rows: {
-        channel: "PAID" | "DIRECT" | "CAMPAIGN" | "UNKNOWN" | "ORGANIC_SEARCH" | "SOCIAL" | "EMAIL" | "REFERRAL" | null;
+        channel: "UNKNOWN" | "PAID" | "DIRECT" | "CAMPAIGN" | "ORGANIC_SEARCH" | "SOCIAL" | "EMAIL" | "REFERRAL" | null;
         source: string | null;
         medium: string | null;
         campaign: string | null;
@@ -6612,7 +8152,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         orderId: string | null;
         orderName: string;
         customerName: string;
-        status: "PENDING" | "FAILED" | "APPROVED" | "PARTIALLY_REFUNDED" | "REFUNDED";
+        status: "FAILED" | "PENDING" | "APPROVED" | "PARTIALLY_REFUNDED" | "REFUNDED";
         amount: number;
         refundedAmount: number;
         provider: "tosspayments" | "portone" | null;
@@ -6636,7 +8176,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       orderId: string | null;
       orderName: string;
       customerName: string;
-      status: "PENDING" | "FAILED" | "APPROVED" | "PARTIALLY_REFUNDED" | "REFUNDED";
+      status: "FAILED" | "PENDING" | "APPROVED" | "PARTIALLY_REFUNDED" | "REFUNDED";
       amount: number;
       refundedAmount: number;
       provider: "tosspayments" | "portone" | null;
@@ -6735,7 +8275,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           masked: string | null;
         }[];
         lastVerification: {
-          result: "SUCCESS" | "FAILED";
+          result: "FAILED" | "SUCCESS";
           message: string | null;
           checkedAt: string;
         } | null;
@@ -6760,7 +8300,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
               masked: string | null;
             }[];
             lastVerification: {
-              result: "SUCCESS" | "FAILED";
+              result: "FAILED" | "SUCCESS";
               message: string | null;
               checkedAt: string;
             } | null;
@@ -6784,7 +8324,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
               masked: string | null;
             }[];
             lastVerification: {
-              result: "SUCCESS" | "FAILED";
+              result: "FAILED" | "SUCCESS";
               message: string | null;
               checkedAt: string;
             } | null;
@@ -6836,7 +8376,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           masked: string | null;
         }[];
         lastVerification: {
-          result: "SUCCESS" | "FAILED";
+          result: "FAILED" | "SUCCESS";
           message: string | null;
           checkedAt: string;
         } | null;
@@ -6861,7 +8401,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
               masked: string | null;
             }[];
             lastVerification: {
-              result: "SUCCESS" | "FAILED";
+              result: "FAILED" | "SUCCESS";
               message: string | null;
               checkedAt: string;
             } | null;
@@ -6885,7 +8425,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
               masked: string | null;
             }[];
             lastVerification: {
-              result: "SUCCESS" | "FAILED";
+              result: "FAILED" | "SUCCESS";
               message: string | null;
               checkedAt: string;
             } | null;
@@ -6942,7 +8482,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         masked: string | null;
       }[];
       lastVerification: {
-        result: "SUCCESS" | "FAILED";
+        result: "FAILED" | "SUCCESS";
         message: string | null;
         checkedAt: string;
       } | null;
@@ -6967,7 +8507,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
             masked: string | null;
           }[];
           lastVerification: {
-            result: "SUCCESS" | "FAILED";
+            result: "FAILED" | "SUCCESS";
             message: string | null;
             checkedAt: string;
           } | null;
@@ -6991,7 +8531,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
             masked: string | null;
           }[];
           lastVerification: {
-            result: "SUCCESS" | "FAILED";
+            result: "FAILED" | "SUCCESS";
             message: string | null;
             checkedAt: string;
           } | null;
@@ -7038,7 +8578,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         masked: string | null;
       }[];
       lastVerification: {
-        result: "SUCCESS" | "FAILED";
+        result: "FAILED" | "SUCCESS";
         message: string | null;
         checkedAt: string;
       } | null;
@@ -7063,7 +8603,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
             masked: string | null;
           }[];
           lastVerification: {
-            result: "SUCCESS" | "FAILED";
+            result: "FAILED" | "SUCCESS";
             message: string | null;
             checkedAt: string;
           } | null;
@@ -7087,7 +8627,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
             masked: string | null;
           }[];
           lastVerification: {
-            result: "SUCCESS" | "FAILED";
+            result: "FAILED" | "SUCCESS";
             message: string | null;
             checkedAt: string;
           } | null;
@@ -7144,7 +8684,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         masked: string | null;
       }[];
       lastVerification: {
-        result: "SUCCESS" | "FAILED";
+        result: "FAILED" | "SUCCESS";
         message: string | null;
         checkedAt: string;
       } | null;
@@ -7169,7 +8709,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
             masked: string | null;
           }[];
           lastVerification: {
-            result: "SUCCESS" | "FAILED";
+            result: "FAILED" | "SUCCESS";
             message: string | null;
             checkedAt: string;
           } | null;
@@ -7193,7 +8733,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
             masked: string | null;
           }[];
           lastVerification: {
-            result: "SUCCESS" | "FAILED";
+            result: "FAILED" | "SUCCESS";
             message: string | null;
             checkedAt: string;
           } | null;
@@ -7240,7 +8780,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         masked: string | null;
       }[];
       lastVerification: {
-        result: "SUCCESS" | "FAILED";
+        result: "FAILED" | "SUCCESS";
         message: string | null;
         checkedAt: string;
       } | null;
@@ -7265,7 +8805,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
             masked: string | null;
           }[];
           lastVerification: {
-            result: "SUCCESS" | "FAILED";
+            result: "FAILED" | "SUCCESS";
             message: string | null;
             checkedAt: string;
           } | null;
@@ -7289,7 +8829,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
             masked: string | null;
           }[];
           lastVerification: {
-            result: "SUCCESS" | "FAILED";
+            result: "FAILED" | "SUCCESS";
             message: string | null;
             checkedAt: string;
           } | null;
@@ -7345,7 +8885,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         masked: string | null;
       }[];
       lastVerification: {
-        result: "SUCCESS" | "FAILED";
+        result: "FAILED" | "SUCCESS";
         message: string | null;
         checkedAt: string;
       } | null;
@@ -7370,7 +8910,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
             masked: string | null;
           }[];
           lastVerification: {
-            result: "SUCCESS" | "FAILED";
+            result: "FAILED" | "SUCCESS";
             message: string | null;
             checkedAt: string;
           } | null;
@@ -7394,7 +8934,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
             masked: string | null;
           }[];
           lastVerification: {
-            result: "SUCCESS" | "FAILED";
+            result: "FAILED" | "SUCCESS";
             message: string | null;
             checkedAt: string;
           } | null;
@@ -7422,7 +8962,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     verify: (provider: PgProvider, body?: VerifyPaymentProviderRequest) => Promise<{
       provider: "tosspayments" | "portone";
       environment: "TEST" | "LIVE";
-      result: "SUCCESS" | "FAILED";
+      result: "FAILED" | "SUCCESS";
       message: string | null;
       checkedAt: string;
     }>;
@@ -7431,7 +8971,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 +8981,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 +8991,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 +9001,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 +9016,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,9 +9026,9 @@ 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";
+      status: "FAILED" | "PENDING" | "PENDING_RETRY" | "SUCCESS";
       responseStatusCode: number | null;
       responseTimeMs: number | null;
       responseBodyExcerpt: string | null;
@@ -7513,9 +9053,9 @@ 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";
+      status: "FAILED" | "PENDING" | "PENDING_RETRY" | "SUCCESS";
       responseStatusCode: number | null;
       responseTimeMs: number | null;
       responseBodyExcerpt: string | null;
@@ -7548,9 +9088,9 @@ 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";
+      status: "FAILED" | "PENDING" | "PENDING_RETRY" | "SUCCESS";
       responseStatusCode: number | null;
       responseTimeMs: number | null;
       responseBodyExcerpt: string | null;
@@ -7646,7 +9186,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         method: string | null;
         path: string | null;
         statusCode: number | null;
-        outcome: "FAILED" | "SUCCEEDED" | "PENDING_APPROVAL" | "DENIED" | "DRY_RUN" | null;
+        outcome: "SUCCEEDED" | "FAILED" | "PENDING_APPROVAL" | "DENIED" | "DRY_RUN" | null;
         errorCode: string | null;
         traceId: string | null;
         idempotencyKey: string | null;
@@ -7664,7 +9204,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     list: (params?: ApprovalListOptions) => Promise<{
       items: {
         approvalId: string;
-        status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
+        status: "SUCCEEDED" | "FAILED" | "PENDING" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
         operationId: string;
         method: string;
         path: string;
@@ -7714,7 +9254,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     get: (approvalId: string) => Promise<{
       approvalId: string;
-      status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
+      status: "SUCCEEDED" | "FAILED" | "PENDING" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
       operationId: string;
       method: string;
       path: string;
@@ -7766,7 +9306,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
      */
     approve: (approvalId: string, body?: ApprovalDecisionRequest) => Promise<{
       approvalId: string;
-      status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
+      status: "SUCCEEDED" | "FAILED" | "PENDING" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
       operationId: string;
       method: string;
       path: string;
@@ -7814,7 +9354,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     reject: (approvalId: string, body?: ApprovalDecisionRequest) => Promise<{
       approvalId: string;
-      status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
+      status: "SUCCEEDED" | "FAILED" | "PENDING" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
       operationId: string;
       method: string;
       path: string;
@@ -7911,7 +9451,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 +9479,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 +9489,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         exchangeDeliveryFee: number;
         sellerFaultFreeShipping: boolean;
         conditionalFreeShortfallCharge: boolean;
+        couponShortfallCharge: boolean;
       };
       shippingPolicy: {
         baseDeliveryFee: number;
@@ -7979,6 +9522,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 +9532,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         exchangeDeliveryFee: number;
         sellerFaultFreeShipping: boolean;
         conditionalFreeShortfallCharge: boolean;
+        couponShortfallCharge: boolean;
       };
       shippingPolicy: {
         baseDeliveryFee: number;
@@ -8132,6 +9678,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 +10013,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,8 +10035,20 @@ 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 {
   /** 상품별 덮어쓰기. 없으면 스토어 기본을 그대로 쓴다 */
@@ -8194,7 +10080,8 @@ export declare function productRefundPolicyOverride(product?: RefundPolicyProduc
  *
  * 원 단위 반올림 규칙: `floor(주문상품 금액 × 누적 수량 ÷ 전체 수량)`을 두 번 구해 그 차를 쓴다.
  * 부분 취소를 몇 번 나눠도 합이 주문상품 금액과 정확히 같아서 1원이 남거나 넘치지 않는다.
- * 할인은 이미 단가에 들어 있어(주문 단위 쿠폰이 없다) 별도 안분이 없다.
+ * 즉시할인은 이미 단가에 들어 있다. 쿠폰 할인은 단가에 들어가지 않으므로 환불은 실결제 금액을 나누는
+ * `proratedPaidRefundBase`(promotion.ts)를 쓴다(이슈 #47).
  *
  * @param totalPrice 주문상품 금액 (할인 반영 단가 × 전체 수량)
  * @param quantity 주문상품 전체 수량
@@ -8231,6 +10118,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 +10135,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 +10145,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 +10258,11 @@ export interface DeliveryBundleProduct {
   conditionalFreeAmount: number | null;
   /** 출고지 주소 id(`seller_addresses`). null이면 스토어 기본 출고지를 쓰는 상품끼리 한 묶음이다 */
   shippingAddressId?: string | null;
+  /**
+   * 상품 유형 (이슈 #48). 생략·null이면 배송 상품이다. 배송이 필요 없는 유형은 묶음을 만들지 않는다.
+   * 줄(`DeliveryFeeLine.fulfillmentType`)에 값이 있으면 그 값이 이긴다.
+   */
+  fulfillmentType?: FulfillmentType | null;
 }
 /**
  * 배송 묶음 키 — **같은 출고지 + 같은 배송 정책이면 같은 키다.**
@@ -8386,6 +10280,11 @@ export interface DeliveryFeeLine {
   productId: string;
   /** 상품 금액 (할인 반영 단가 × 수량) */
   amount: number;
+  /**
+   * 이 줄의 상품 유형 — 주문서 스냅샷 값이다(이슈 #48). 주면 상품의 현재 유형보다 우선한다. 주문서를 만든 뒤 셀러가
+   * 유형을 바꿔도 결제 시작의 견적과 주문상품 스냅샷이 같은 유형을 보게 한다. 생략하면 상품 값을 쓴다.
+   */
+  fulfillmentType?: FulfillmentType | null;
 }
 /**
  * 기본 배송비를 면제한 근거 — 면제하지 않았으면 null이다.
@@ -8430,6 +10329,13 @@ export interface DeliveryQuote {
   remoteArea: RemoteArea;
   /** 스토어 전체 무료 기준(`freeThreshold`) 충족으로 기본 배송비를 면제했는가 */
   freeByThreshold: boolean;
+  /**
+   * 배송이 필요한 줄의 상품 금액 합 — 스토어 전체 무료 기준의 판정 금액이다(이슈 #48). 비실물 줄은 빠진다.
+   * 주문 상품 금액 합(`productAmount`)과 다를 수 있다.
+   */
+  shippableAmount: number;
+  /** 배송이 필요한 줄이 하나라도 있는가 — 배송 묶음이 하나라도 있는가다. false면 배송지를 받지 않는다 */
+  requiresShipping: boolean;
 }
 export interface DeliveryQuoteInput {
   lines: DeliveryFeeLine[];
@@ -8513,8 +10419,35 @@ 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>;
+  fulfillmentType: z.ZodOptional<z.ZodString>;
 }, 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";
+  }>;
+  fulfillmentType: z.ZodString;
+  fulfillmentMode: z.ZodNullable<z.ZodString>;
+  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 +10482,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 +10512,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 +10555,39 @@ 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>;
+    fulfillmentType: z.ZodOptional<z.ZodString>;
+  }, 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";
+    }>;
+    fulfillmentType: z.ZodString;
+    fulfillmentMode: z.ZodNullable<z.ZodString>;
+    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 +10620,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 +10661,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 +10679,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 +10691,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 +10702,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 +10727,38 @@ 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>;
+    fulfillmentType: z.ZodOptional<z.ZodString>;
+  }, 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";
+    }>;
+    fulfillmentType: z.ZodString;
+    fulfillmentMode: z.ZodNullable<z.ZodString>;
+    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 +10790,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 +10830,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 +10847,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 +10858,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 +10868,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"];