@sayren/store-sdk 0.29.2 → 0.29.3

package/dist/index.d.mts

@@ -165,8 +165,8 @@ export declare const auditLogPageSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type AuditLogPage = z.infer<typeof auditLogPageSchema>;
 export declare const agentPolicyDecisionSchema: z.ZodEnum<{
-  DENIED: "DENIED";
   APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
+  DENIED: "DENIED";
   ALLOW: "ALLOW";
 }>;
 export type AgentPolicyDecision = z.infer<typeof agentPolicyDecisionSchema>;
@@ -190,8 +190,8 @@ export type WritePreview = z.infer<typeof writePreviewSchema>;
 export declare const writeDryRunResultSchema: z.ZodObject<{
   dryRun: z.ZodLiteral<true>;
   decision: z.ZodEnum<{
-    DENIED: "DENIED";
     APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
+    DENIED: "DENIED";
     ALLOW: "ALLOW";
   }>;
   reason: z.ZodNullable<z.ZodString>;
@@ -213,11 +213,11 @@ export declare const writeDryRunResultSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type WriteDryRunResult = z.infer<typeof writeDryRunResultSchema>;
 export declare const approvalStatusSchema: z.ZodEnum<{
-  UNKNOWN: "UNKNOWN";
   PENDING: "PENDING";
   FAILED: "FAILED";
   SUCCEEDED: "SUCCEEDED";
   EXECUTING: "EXECUTING";
+  UNKNOWN: "UNKNOWN";
   REJECTED: "REJECTED";
   EXPIRED: "EXPIRED";
 }>;
@@ -225,11 +225,11 @@ export type ApprovalStatus = z.infer<typeof approvalStatusSchema>;
 export declare const approvalRequestSchema: z.ZodObject<{
   approvalId: z.ZodString;
   status: z.ZodEnum<{
-    UNKNOWN: "UNKNOWN";
     PENDING: "PENDING";
     FAILED: "FAILED";
     SUCCEEDED: "SUCCEEDED";
     EXECUTING: "EXECUTING";
+    UNKNOWN: "UNKNOWN";
     REJECTED: "REJECTED";
     EXPIRED: "EXPIRED";
   }>;
@@ -287,11 +287,11 @@ 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<{
-    UNKNOWN: "UNKNOWN";
     PENDING: "PENDING";
     FAILED: "FAILED";
     SUCCEEDED: "SUCCEEDED";
     EXECUTING: "EXECUTING";
+    UNKNOWN: "UNKNOWN";
     REJECTED: "REJECTED";
     EXPIRED: "EXPIRED";
   }>>>>;
@@ -306,11 +306,11 @@ export declare const approvalPageSchema: z.ZodObject<{
   items: z.ZodArray<z.ZodObject<{
     approvalId: z.ZodString;
     status: z.ZodEnum<{
-      UNKNOWN: "UNKNOWN";
       PENDING: "PENDING";
       FAILED: "FAILED";
       SUCCEEDED: "SUCCEEDED";
       EXECUTING: "EXECUTING";
+      UNKNOWN: "UNKNOWN";
       REJECTED: "REJECTED";
       EXPIRED: "EXPIRED";
     }>;
@@ -448,11 +448,11 @@ export declare const analyticsTotalsSchema: z.ZodObject<{
 export type AnalyticsTotals = z.infer<typeof analyticsTotalsSchema>;
 export declare const analyticsFunnelStepSchema: z.ZodObject<{
   step: z.ZodEnum<{
+    PURCHASE: "PURCHASE";
     SESSION: "SESSION";
     PRODUCT_VIEW: "PRODUCT_VIEW";
     ADD_TO_CART: "ADD_TO_CART";
     BEGIN_CHECKOUT: "BEGIN_CHECKOUT";
-    PURCHASE: "PURCHASE";
   }>;
   sessions: z.ZodNumber;
   rateFromPrevious: z.ZodNullable<z.ZodNumber>;
@@ -477,11 +477,11 @@ export declare const analyticsOverviewSchema: z.ZodObject<{
   }, z.core.$strip>;
   funnel: z.ZodArray<z.ZodObject<{
     step: z.ZodEnum<{
+      PURCHASE: "PURCHASE";
       SESSION: "SESSION";
       PRODUCT_VIEW: "PRODUCT_VIEW";
       ADD_TO_CART: "ADD_TO_CART";
       BEGIN_CHECKOUT: "BEGIN_CHECKOUT";
-      PURCHASE: "PURCHASE";
     }>;
     sessions: z.ZodNumber;
     rateFromPrevious: z.ZodNullable<z.ZodNumber>;
@@ -581,20 +581,20 @@ export declare const analyticsProductsSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type AnalyticsProducts = z.infer<typeof analyticsProductsSchema>;
 export declare const analyticsChannelSchema: z.ZodEnum<{
+  PAID: "PAID";
   DIRECT: "DIRECT";
+  CAMPAIGN: "CAMPAIGN";
+  UNKNOWN: "UNKNOWN";
   ORGANIC_SEARCH: "ORGANIC_SEARCH";
   SOCIAL: "SOCIAL";
-  PAID: "PAID";
   EMAIL: "EMAIL";
-  CAMPAIGN: "CAMPAIGN";
   REFERRAL: "REFERRAL";
-  UNKNOWN: "UNKNOWN";
 }>;
 export type AnalyticsChannel = z.infer<typeof analyticsChannelSchema>;
 export declare const analyticsSourceGroupBySchema: z.ZodEnum<{
-  CAMPAIGN: "CAMPAIGN";
   CHANNEL: "CHANNEL";
   SOURCE: "SOURCE";
+  CAMPAIGN: "CAMPAIGN";
   DEVICE: "DEVICE";
 }>;
 export type AnalyticsSourceGroupBy = z.infer<typeof analyticsSourceGroupBySchema>;
@@ -606,23 +606,23 @@ export declare const analyticsSourcesQuerySchema: z.ZodObject<{
     false: "false";
   }>>;
   groupBy: z.ZodOptional<z.ZodEnum<{
-    CAMPAIGN: "CAMPAIGN";
     CHANNEL: "CHANNEL";
     SOURCE: "SOURCE";
+    CAMPAIGN: "CAMPAIGN";
     DEVICE: "DEVICE";
   }>>;
 }, z.core.$strip>;
 export type AnalyticsSourcesParams = z.infer<typeof analyticsSourcesQuerySchema>;
 export declare const analyticsSourceRowSchema: z.ZodObject<{
   channel: z.ZodNullable<z.ZodEnum<{
+    PAID: "PAID";
     DIRECT: "DIRECT";
+    CAMPAIGN: "CAMPAIGN";
+    UNKNOWN: "UNKNOWN";
     ORGANIC_SEARCH: "ORGANIC_SEARCH";
     SOCIAL: "SOCIAL";
-    PAID: "PAID";
     EMAIL: "EMAIL";
-    CAMPAIGN: "CAMPAIGN";
     REFERRAL: "REFERRAL";
-    UNKNOWN: "UNKNOWN";
   }>>;
   source: z.ZodNullable<z.ZodString>;
   medium: z.ZodNullable<z.ZodString>;
@@ -644,21 +644,21 @@ export declare const analyticsSourceRowSchema: z.ZodObject<{
 export type AnalyticsSourceRow = z.infer<typeof analyticsSourceRowSchema>;
 export declare const analyticsSourcesSchema: z.ZodObject<{
   groupBy: z.ZodEnum<{
-    CAMPAIGN: "CAMPAIGN";
     CHANNEL: "CHANNEL";
     SOURCE: "SOURCE";
+    CAMPAIGN: "CAMPAIGN";
     DEVICE: "DEVICE";
   }>;
   rows: z.ZodArray<z.ZodObject<{
     channel: z.ZodNullable<z.ZodEnum<{
+      PAID: "PAID";
       DIRECT: "DIRECT";
+      CAMPAIGN: "CAMPAIGN";
+      UNKNOWN: "UNKNOWN";
       ORGANIC_SEARCH: "ORGANIC_SEARCH";
       SOCIAL: "SOCIAL";
-      PAID: "PAID";
       EMAIL: "EMAIL";
-      CAMPAIGN: "CAMPAIGN";
       REFERRAL: "REFERRAL";
-      UNKNOWN: "UNKNOWN";
     }>>;
     source: z.ZodNullable<z.ZodString>;
     medium: z.ZodNullable<z.ZodString>;
@@ -807,12 +807,12 @@ export declare const analyticsSearchSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type AnalyticsSearch = z.infer<typeof analyticsSearchSchema>;
 export declare const analyticsCheckoutOutcomeSchema: z.ZodEnum<{
+  OTHER: "OTHER";
   COMPLETED: "COMPLETED";
   NOT_OPENED: "NOT_OPENED";
   USER_CANCELED: "USER_CANCELED";
   DECLINED: "DECLINED";
   PREPARE_FAILURE: "PREPARE_FAILURE";
-  OTHER: "OTHER";
   IN_PROGRESS: "IN_PROGRESS";
 }>;
 export type AnalyticsCheckoutOutcome = z.infer<typeof analyticsCheckoutOutcomeSchema>;
@@ -820,12 +820,12 @@ export declare const analyticsCheckoutSchema: z.ZodObject<{
   sessions: z.ZodNumber;
   outcomes: z.ZodArray<z.ZodObject<{
     outcome: z.ZodEnum<{
+      OTHER: "OTHER";
       COMPLETED: "COMPLETED";
       NOT_OPENED: "NOT_OPENED";
       USER_CANCELED: "USER_CANCELED";
       DECLINED: "DECLINED";
       PREPARE_FAILURE: "PREPARE_FAILURE";
-      OTHER: "OTHER";
       IN_PROGRESS: "IN_PROGRESS";
     }>;
     sessions: z.ZodNumber;
@@ -1264,7 +1264,6 @@ export declare const claimTypeSchema: z.ZodEnum<{
 }>;
 export type ClaimType = z.infer<typeof claimTypeSchema>;
 export declare const claimStatusSchema: z.ZodEnum<{
-  COMPLETED: "COMPLETED";
   REJECTED: "REJECTED";
   REQUESTED: "REQUESTED";
   HELD: "HELD";
@@ -1272,6 +1271,7 @@ export declare const claimStatusSchema: z.ZodEnum<{
   COLLECTED: "COLLECTED";
   REDELIVERING: "REDELIVERING";
   APPROVED: "APPROVED";
+  COMPLETED: "COMPLETED";
   WITHDRAWN: "WITHDRAWN";
 }>;
 export type ClaimStatus = z.infer<typeof claimStatusSchema>;
@@ -1308,7 +1308,6 @@ export declare const claimSchema: z.ZodObject<{
     CANCEL: "CANCEL";
   }>;
   status: z.ZodEnum<{
-    COMPLETED: "COMPLETED";
     REJECTED: "REJECTED";
     REQUESTED: "REQUESTED";
     HELD: "HELD";
@@ -1316,6 +1315,7 @@ export declare const claimSchema: z.ZodObject<{
     COLLECTED: "COLLECTED";
     REDELIVERING: "REDELIVERING";
     APPROVED: "APPROVED";
+    COMPLETED: "COMPLETED";
     WITHDRAWN: "WITHDRAWN";
   }>;
   orderId: z.ZodString;
@@ -1338,6 +1338,7 @@ export declare const claimSchema: z.ZodObject<{
   claimDeliveryFee: z.ZodNumber;
   expectedRefundAmount: z.ZodNullable<z.ZodNumber>;
   expectedDeliveryFeeRefundAmount: z.ZodNullable<z.ZodNumber>;
+  expectedPointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   exchangeOption: z.ZodNullable<z.ZodObject<{
     optionId: z.ZodString;
     optionName: z.ZodString;
@@ -1396,7 +1397,6 @@ export declare const claimDetailSchema: z.ZodObject<{
     CANCEL: "CANCEL";
   }>;
   status: z.ZodEnum<{
-    COMPLETED: "COMPLETED";
     REJECTED: "REJECTED";
     REQUESTED: "REQUESTED";
     HELD: "HELD";
@@ -1404,6 +1404,7 @@ export declare const claimDetailSchema: z.ZodObject<{
     COLLECTED: "COLLECTED";
     REDELIVERING: "REDELIVERING";
     APPROVED: "APPROVED";
+    COMPLETED: "COMPLETED";
     WITHDRAWN: "WITHDRAWN";
   }>;
   orderId: z.ZodString;
@@ -1426,6 +1427,7 @@ export declare const claimDetailSchema: z.ZodObject<{
   claimDeliveryFee: z.ZodNumber;
   expectedRefundAmount: z.ZodNullable<z.ZodNumber>;
   expectedDeliveryFeeRefundAmount: z.ZodNullable<z.ZodNumber>;
+  expectedPointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   exchangeOption: z.ZodNullable<z.ZodObject<{
     optionId: z.ZodString;
     optionName: z.ZodString;
@@ -1453,7 +1455,6 @@ export declare const claimDetailSchema: z.ZodObject<{
   }, z.core.$strip>>;
   histories: z.ZodOptional<z.ZodArray<z.ZodObject<{
     status: z.ZodEnum<{
-      COMPLETED: "COMPLETED";
       REJECTED: "REJECTED";
       REQUESTED: "REQUESTED";
       HELD: "HELD";
@@ -1461,6 +1462,7 @@ export declare const claimDetailSchema: z.ZodObject<{
       COLLECTED: "COLLECTED";
       REDELIVERING: "REDELIVERING";
       APPROVED: "APPROVED";
+      COMPLETED: "COMPLETED";
       WITHDRAWN: "WITHDRAWN";
     }>;
     actor: z.ZodEnum<{
@@ -1499,6 +1501,7 @@ export declare const approveClaimResultSchema: z.ZodObject<{
   deliveryFeeChargeAmount: z.ZodNumber;
   couponChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   couponChargeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+  pointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   refundedAt: z.ZodString;
 }, z.core.$strip>;
 export type ApproveClaimResult = z.infer<typeof approveClaimResultSchema>;
@@ -2523,10 +2526,10 @@ export type CustomerOrder = z.infer<typeof customerOrderSchema>;
 /** `POST /v1/customers/{id}/withdraw` 본문 */
 export declare const withdrawCustomerRequestSchema: z.ZodObject<{
   reason: z.ZodEnum<{
-    OTHER: "OTHER";
     BUYER_REQUEST: "BUYER_REQUEST";
     DORMANT: "DORMANT";
     ABUSE: "ABUSE";
+    OTHER: "OTHER";
   }>;
   memo: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
@@ -3260,8 +3263,8 @@ export declare function requiresCollection(type: string | null | undefined): boo
 export declare const NO_SHIPPING_BUNDLE_KEY = "none";
 /** 배송비 유형 — 무료·유료·조건부 무료 */
 export declare const deliveryTypeSchema: z.ZodEnum<{
-  PAID: "PAID";
   FREE: "FREE";
+  PAID: "PAID";
   CONDITIONAL_FREE: "CONDITIONAL_FREE";
 }>;
 export type DeliveryType = z.infer<typeof deliveryTypeSchema>;
@@ -3272,8 +3275,8 @@ export declare const productFulfillmentCreateSchema: z.ZodDiscriminatedUnion<[z.
   type: z.ZodLiteral<"SHIPPING">;
   shipping: z.ZodOptional<z.ZodObject<{
     deliveryType: z.ZodDefault<z.ZodEnum<{
-      PAID: "PAID";
       FREE: "FREE";
+      PAID: "PAID";
       CONDITIONAL_FREE: "CONDITIONAL_FREE";
     }>>;
     deliveryFee: z.ZodOptional<z.ZodNumber>;
@@ -3295,8 +3298,8 @@ export declare const productFulfillmentUpdateSchema: z.ZodDiscriminatedUnion<[z.
   type: z.ZodLiteral<"SHIPPING">;
   shipping: z.ZodObject<{
     deliveryType: z.ZodEnum<{
-      PAID: "PAID";
       FREE: "FREE";
+      PAID: "PAID";
       CONDITIONAL_FREE: "CONDITIONAL_FREE";
     }>;
     deliveryFee: z.ZodNumber;
@@ -3316,8 +3319,8 @@ export declare const productFulfillmentSchema: z.ZodDiscriminatedUnion<[z.ZodObj
   type: z.ZodLiteral<"SHIPPING">;
   shipping: z.ZodObject<{
     deliveryType: z.ZodEnum<{
-      PAID: "PAID";
       FREE: "FREE";
+      PAID: "PAID";
       CONDITIONAL_FREE: "CONDITIONAL_FREE";
     }>;
     deliveryFee: z.ZodNumber;
@@ -3355,8 +3358,8 @@ export declare const productFulfillmentResponseSchema: z.ZodUnion<readonly [z.Zo
   type: z.ZodLiteral<"SHIPPING">;
   shipping: z.ZodObject<{
     deliveryType: z.ZodEnum<{
-      PAID: "PAID";
       FREE: "FREE";
+      PAID: "PAID";
       CONDITIONAL_FREE: "CONDITIONAL_FREE";
     }>;
     deliveryFee: z.ZodNumber;
@@ -3495,6 +3498,7 @@ export declare const orderItemSchema: z.ZodObject<{
   discountAmount: z.ZodNumber;
   totalPrice: z.ZodNumber;
   couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+  pointAllocation: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   hold: z.ZodNullable<z.ZodObject<{
     reason: z.ZodString;
     expectedDispatchDate: z.ZodString;
@@ -3567,6 +3571,7 @@ export declare const orderSchema: z.ZodObject<{
     discountAmount: z.ZodNumber;
     couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     deliveryDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    pointAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     discounts: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
       couponId: z.ZodString;
       name: z.ZodString;
@@ -3654,6 +3659,7 @@ export declare const orderSchema: z.ZodObject<{
     discountAmount: z.ZodNumber;
     totalPrice: z.ZodNumber;
     couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    pointAllocation: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     hold: z.ZodNullable<z.ZodObject<{
       reason: z.ZodString;
       expectedDispatchDate: z.ZodString;
@@ -3770,6 +3776,7 @@ export declare const orderItemPageSchema: z.ZodObject<{
     discountAmount: z.ZodNumber;
     totalPrice: z.ZodNumber;
     couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    pointAllocation: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     hold: z.ZodNullable<z.ZodObject<{
       reason: z.ZodString;
       expectedDispatchDate: z.ZodString;
@@ -3871,16 +3878,16 @@ export interface OrderItemListParams extends PageParams {
   testPayment?: "true" | "false";
 }
 export declare const deliveryMethodSchema: z.ZodEnum<{
-  DIRECT: "DIRECT";
   COURIER: "COURIER";
+  DIRECT: "DIRECT";
   QUICK: "QUICK";
   NOTHING: "NOTHING";
 }>;
 export type DeliveryMethod = z.infer<typeof deliveryMethodSchema>;
 export declare const dispatchRequestSchema: z.ZodObject<{
   deliveryMethod: z.ZodEnum<{
-    DIRECT: "DIRECT";
     COURIER: "COURIER";
+    DIRECT: "DIRECT";
     QUICK: "QUICK";
     NOTHING: "NOTHING";
   }>;
@@ -3892,8 +3899,8 @@ export type DispatchRequest = z.infer<typeof dispatchRequestSchema>;
 export declare const deliveryInfoSchema: z.ZodObject<{
   orderItemId: z.ZodString;
   deliveryMethod: z.ZodEnum<{
-    DIRECT: "DIRECT";
     COURIER: "COURIER";
+    DIRECT: "DIRECT";
     QUICK: "QUICK";
     NOTHING: "NOTHING";
   }>;
@@ -3919,8 +3926,8 @@ export declare const trackingStageResponseSchema: z.ZodString;
 export declare const deliveryStatusSchema: z.ZodObject<{
   orderItemId: z.ZodString;
   deliveryMethod: z.ZodEnum<{
-    DIRECT: "DIRECT";
     COURIER: "COURIER";
+    DIRECT: "DIRECT";
     QUICK: "QUICK";
     NOTHING: "NOTHING";
   }>;
@@ -4008,6 +4015,7 @@ export declare const cancelBySellerResultSchema: z.ZodObject<{
   deliveryFeeChargeAmount: z.ZodNumber;
   couponChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   couponChargeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+  pointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   refundedAt: z.ZodString;
 }, z.core.$strip>;
 export type CancelBySellerResult = z.infer<typeof cancelBySellerResultSchema>;
@@ -4926,6 +4934,7 @@ export type PaymentAttemptRecord = z.infer<typeof paymentAttemptRecordSchema>;
 export declare const paymentRefundRecordSchema: z.ZodObject<{
   refundId: z.ZodString;
   amount: z.ZodNumber;
+  pointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   reason: z.ZodString;
   kind: z.ZodString;
   status: z.ZodString;
@@ -5013,6 +5022,7 @@ export declare const paymentRecordDetailSchema: z.ZodObject<{
   refunds: z.ZodArray<z.ZodObject<{
     refundId: z.ZodString;
     amount: z.ZodNumber;
+    pointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     reason: z.ZodString;
     kind: z.ZodString;
     status: z.ZodString;
@@ -5094,6 +5104,21 @@ export declare const purchaseEarnPolicySchema: z.ZodObject<{
   rateBp: z.ZodNumber;
 }, z.core.$strip>;
 export type PurchaseEarnPolicy = z.infer<typeof purchaseEarnPolicySchema>;
+/** 사용 단위 — 1·10·100원 */
+export declare const POINT_USE_UNITS: readonly [1, 10, 100];
+/**
+ * 적립금 사용 규칙(P3) — 주문서에서 결제 금액을 줄인다. 적용 순서는 즉시할인 → 쿠폰 → 적립금이고, 상품 금액(쿠폰 뒤)에 먼저 쓰고
+ * 남으면 배송비에 쓴다(`includeDeliveryFee`). 결제 금액이 100원 아래로 내려가지 않게 적립금을 줄인다.
+ */
+export declare const pointUsePolicySchema: z.ZodObject<{
+  enabled: z.ZodBoolean;
+  minBalance: z.ZodNumber;
+  minAmount: z.ZodNumber;
+  unit: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<10>, z.ZodLiteral<100>]>;
+  maxRatioBp: z.ZodNumber;
+  includeDeliveryFee: z.ZodBoolean;
+}, z.core.$strip>;
+export type PointUsePolicy = z.infer<typeof pointUsePolicySchema>;
 /** 저장된 상점 정책(`stores.point_policy`) — 해석은 `resolvePointPolicy` */
 export declare const pointPolicySchema: z.ZodObject<{
   reviewReward: z.ZodObject<{
@@ -5105,6 +5130,14 @@ export declare const pointPolicySchema: z.ZodObject<{
     enabled: z.ZodBoolean;
     rateBp: z.ZodNumber;
   }, z.core.$strip>;
+  use: z.ZodObject<{
+    enabled: z.ZodBoolean;
+    minBalance: z.ZodNumber;
+    minAmount: z.ZodNumber;
+    unit: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<10>, z.ZodLiteral<100>]>;
+    maxRatioBp: z.ZodNumber;
+    includeDeliveryFee: z.ZodBoolean;
+  }, z.core.$strip>;
   expiryDays: z.ZodNullable<z.ZodNumber>;
 }, z.core.$strip>;
 export type PointPolicy = z.infer<typeof pointPolicySchema>;
@@ -5137,7 +5170,7 @@ export declare function pointExpiresAtOf(earnedAt: Date, days: number | null): D
 /** 적립 묶음 출처 — 같은 출처 id에는 묶음이 하나뿐이다(DB 부분 유니크) */
 export declare const POINT_LOT_SOURCES: readonly ["REVIEW", "PURCHASE", "ADJUST", "REFUND_RESTORE", "OPENING"];
 export type PointLotSource = (typeof POINT_LOT_SOURCES)[number];
-/** 원장 항목 유형. 지금 쓰는 것은 리뷰 적립·회수이고 나머지는 다음 단계 자리다 */
+/** 원장 항목 유형 */
 export declare const POINT_ENTRY_TYPES: readonly ["EARN_REVIEW", "REVOKE_REVIEW", "EARN_PURCHASE", "USE_RESERVE", "USE_RELEASE", "REFUND_RESTORE", "EXPIRE", "ADJUST", "OPENING"];
 export type PointEntryType = (typeof POINT_ENTRY_TYPES)[number];
 /** 상점 플랫폼 알림 — `REVIEW_REWARD_PAUSED` 리뷰 자동 적립이 멈춤 · `POINTS_AVAILABLE` 적립금 설정을 쓸 수 있음 */
@@ -5159,6 +5192,15 @@ export declare const storePointPolicySchema: z.ZodObject<{
     enabled: z.ZodBoolean;
     rateBp: z.ZodNumber;
   }, z.core.$strip>;
+  useAvailable: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+  use: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+    enabled: z.ZodBoolean;
+    minBalance: z.ZodNumber;
+    minAmount: z.ZodNumber;
+    unit: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<10>, z.ZodLiteral<100>]>;
+    maxRatioBp: z.ZodNumber;
+    includeDeliveryFee: z.ZodBoolean;
+  }, z.core.$strip>>>;
   expiryDays: z.ZodNullable<z.ZodNumber>;
   notice: z.ZodNullable<z.ZodEnum<{
     REVIEW_REWARD_PAUSED: "REVIEW_REWARD_PAUSED";
@@ -5180,6 +5222,14 @@ export declare const updatePointPolicyRequestSchema: z.ZodObject<{
     enabled: z.ZodBoolean;
     rateBp: z.ZodNumber;
   }, z.core.$strip>>;
+  use: z.ZodOptional<z.ZodObject<{
+    enabled: z.ZodBoolean;
+    minBalance: z.ZodNumber;
+    minAmount: z.ZodNumber;
+    unit: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<10>, z.ZodLiteral<100>]>;
+    maxRatioBp: z.ZodNumber;
+    includeDeliveryFee: z.ZodBoolean;
+  }, z.core.$strip>>;
   expiryDays: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type UpdatePointPolicyRequest = z.infer<typeof updatePointPolicyRequestSchema>;
@@ -5223,11 +5273,11 @@ export type PointEntry = z.infer<typeof pointEntrySchema>;
 export declare const pointLotSchema: z.ZodObject<{
   lotId: z.ZodString;
   source: z.ZodUnion<readonly [z.ZodEnum<{
-    PURCHASE: "PURCHASE";
     REFUND_RESTORE: "REFUND_RESTORE";
     ADJUST: "ADJUST";
     OPENING: "OPENING";
     REVIEW: "REVIEW";
+    PURCHASE: "PURCHASE";
   }>, z.ZodString]>;
   amount: z.ZodNumber;
   remaining: z.ZodNumber;
@@ -5242,11 +5292,11 @@ export declare const customerPointsSchema: z.ZodObject<{
   lots: z.ZodArray<z.ZodObject<{
     lotId: z.ZodString;
     source: z.ZodUnion<readonly [z.ZodEnum<{
-      PURCHASE: "PURCHASE";
       REFUND_RESTORE: "REFUND_RESTORE";
       ADJUST: "ADJUST";
       OPENING: "OPENING";
       REVIEW: "REVIEW";
+      PURCHASE: "PURCHASE";
     }>, z.ZodString]>;
     amount: z.ZodNumber;
     remaining: z.ZodNumber;
@@ -5304,6 +5354,30 @@ export declare const pointAdjustmentResultSchema: z.ZodObject<{
   balance: z.ZodNumber;
 }, z.core.$strip>;
 export type PointAdjustmentResult = z.infer<typeof pointAdjustmentResultSchema>;
+/** 결제 시작에 쓴 적립 묶음 — 해제·환불 반환이 이 값으로 되돌리고 반환 적립금의 만료를 정한다 */
+export interface PointLotUsage {
+  lotId: string;
+  amount: number;
+  expiresAt: string | null;
+}
+/**
+ * 환불로 돌려주는 적립금의 만료 — 결제에 쓴 묶음 중 가장 늦은 만료이고, 그 시각이 이미 지났으면 지금 + 30일(KST 날짜 끝)이다.
+ * 쓴 묶음 중 만료 없는 묶음(기존 잔액 등)이 있으면 만료 없음(null)이다. 쓴 기록이 없으면 지금 + 30일이다(사용자 결정 2026-10-02).
+ */
+export declare function pointRestoreExpiresAtOf(usages: readonly PointLotUsage[], now: Date): Date | null;
+/**
+ * 환불 금액 나누기 — 현금 몫·적립금 몫에서 차감(반품 배송비·쿠폰 조건 미달·추가 차감)을 **현금에서 먼저** 빼고 모자란 몫만 적립금에서 뺀다.
+ * 둘 다 모자라면 0에서 멈추고 못 받은 차감액(`uncollected`)을 돌려준다(호출부가 감사 로그에 남긴다).
+ */
+export declare function splitRefund(input: {
+  cash: number;
+  points: number;
+  charges: number;
+}): {
+  cashRefund: number;
+  pointRefund: number;
+  uncollected: number;
+};
 //#endregion
 //#region src/schemas/product.d.ts
 export declare const productStatusSchema: z.ZodEnum<{
@@ -5582,8 +5656,8 @@ export declare const productSchema: z.ZodObject<{
     type: z.ZodLiteral<"SHIPPING">;
     shipping: z.ZodObject<{
       deliveryType: z.ZodEnum<{
-        PAID: "PAID";
         FREE: "FREE";
+        PAID: "PAID";
         CONDITIONAL_FREE: "CONDITIONAL_FREE";
       }>;
       deliveryFee: z.ZodNumber;
@@ -5805,8 +5879,8 @@ export declare const productCreateRequestSchema: z.ZodObject<{
     type: z.ZodLiteral<"SHIPPING">;
     shipping: z.ZodOptional<z.ZodObject<{
       deliveryType: z.ZodDefault<z.ZodEnum<{
-        PAID: "PAID";
         FREE: "FREE";
+        PAID: "PAID";
         CONDITIONAL_FREE: "CONDITIONAL_FREE";
       }>>;
       deliveryFee: z.ZodOptional<z.ZodNumber>;
@@ -5891,8 +5965,8 @@ export declare const productReplaceRequestSchema: z.ZodObject<{
     type: z.ZodLiteral<"SHIPPING">;
     shipping: z.ZodObject<{
       deliveryType: z.ZodEnum<{
-        PAID: "PAID";
         FREE: "FREE";
+        PAID: "PAID";
         CONDITIONAL_FREE: "CONDITIONAL_FREE";
       }>;
       deliveryFee: z.ZodNumber;
@@ -5985,8 +6059,8 @@ export declare const productPatchRequestSchema: z.ZodObject<{
     type: z.ZodLiteral<"SHIPPING">;
     shipping: z.ZodObject<{
       deliveryType: z.ZodEnum<{
-        PAID: "PAID";
         FREE: "FREE";
+        PAID: "PAID";
         CONDITIONAL_FREE: "CONDITIONAL_FREE";
       }>;
       deliveryFee: z.ZodNumber;
@@ -6010,9 +6084,9 @@ export type ProductPatchRequest = z.infer<typeof productPatchRequestSchema>;
 export declare const productSortSchema: z.ZodEnum<{
   "createdAt.desc": "createdAt.desc";
   "createdAt.asc": "createdAt.asc";
+  "updatedAt.desc": "updatedAt.desc";
   "salePrice.asc": "salePrice.asc";
   "salePrice.desc": "salePrice.desc";
-  "updatedAt.desc": "updatedAt.desc";
 }>;
 export type ProductSort = z.infer<typeof productSortSchema>;
 export interface ProductListParams extends PageParams {
@@ -6038,9 +6112,9 @@ export declare const productListQuerySchema: z.ZodObject<{
   sort: z.ZodOptional<z.ZodEnum<{
     "createdAt.desc": "createdAt.desc";
     "createdAt.asc": "createdAt.asc";
+    "updatedAt.desc": "updatedAt.desc";
     "salePrice.asc": "salePrice.asc";
     "salePrice.desc": "salePrice.desc";
-    "updatedAt.desc": "updatedAt.desc";
   }>>;
 }, z.core.$strip>;
 export declare const discountRequestSchema: z.ZodObject<{
@@ -6947,9 +7021,9 @@ export type StorefrontDeploymentLog = z.infer<typeof storefrontDeploymentLogSche
 export declare const storefrontDeploymentSchema: z.ZodObject<{
   siteId: z.ZodString;
   status: z.ZodEnum<{
-    IN_PROGRESS: "IN_PROGRESS";
     FAILED: "FAILED";
     SUCCEEDED: "SUCCEEDED";
+    IN_PROGRESS: "IN_PROGRESS";
   }>;
   url: z.ZodString;
   startedAt: z.ZodString;
@@ -7407,8 +7481,8 @@ export declare const runStorefrontCheckRequestSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type RunStorefrontCheckRequest = z.infer<typeof runStorefrontCheckRequestSchema>;
 export declare const storefrontCheckStatusSchema: z.ZodEnum<{
-  UNKNOWN: "UNKNOWN";
   FAILED: "FAILED";
+  UNKNOWN: "UNKNOWN";
   RUNNING: "RUNNING";
   QUEUED: "QUEUED";
   PASSED: "PASSED";
@@ -7421,8 +7495,8 @@ export declare const storefrontCheckSchema: z.ZodObject<{
   checkId: z.ZodString;
   check: z.ZodString;
   status: z.ZodEnum<{
-    UNKNOWN: "UNKNOWN";
     FAILED: "FAILED";
+    UNKNOWN: "UNKNOWN";
     RUNNING: "RUNNING";
     QUEUED: "QUEUED";
     PASSED: "PASSED";
@@ -8243,7 +8317,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       fulfillment: UnknownFulfillment | {
         type: "SHIPPING";
         shipping: {
-          deliveryType: "PAID" | "FREE" | "CONDITIONAL_FREE";
+          deliveryType: "FREE" | "PAID" | "CONDITIONAL_FREE";
           deliveryFee: number;
           conditionalFreeAmount: number | null;
           shippingAddressId: string | null;
@@ -8341,7 +8415,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       fulfillment: UnknownFulfillment | {
         type: "SHIPPING";
         shipping: {
-          deliveryType: "PAID" | "FREE" | "CONDITIONAL_FREE";
+          deliveryType: "FREE" | "PAID" | "CONDITIONAL_FREE";
           deliveryFee: number;
           conditionalFreeAmount: number | null;
           shippingAddressId: string | null;
@@ -8439,7 +8513,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       fulfillment: UnknownFulfillment | {
         type: "SHIPPING";
         shipping: {
-          deliveryType: "PAID" | "FREE" | "CONDITIONAL_FREE";
+          deliveryType: "FREE" | "PAID" | "CONDITIONAL_FREE";
           deliveryFee: number;
           conditionalFreeAmount: number | null;
           shippingAddressId: string | null;
@@ -9226,6 +9300,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         discountAmount: number;
         couponDiscountAmount: number;
         deliveryDiscountAmount: number;
+        pointAmount: number;
         discounts: {
           couponId: string;
           name: string;
@@ -9292,6 +9367,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         discountAmount: number;
         totalPrice: number;
         couponDiscountAmount: number;
+        pointAllocation: number;
         hold: {
           reason: string;
           expectedDispatchDate: string;
@@ -9377,6 +9453,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         discountAmount: number;
         totalPrice: number;
         couponDiscountAmount: number;
+        pointAllocation: number;
         hold: {
           reason: string;
           expectedDispatchDate: string;
@@ -9417,6 +9494,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       deliveryFeeChargeAmount: number;
       couponChargeAmount: number;
       couponChargeRefundAmount: number;
+      pointRefundAmount: number;
       refundedAt: string;
     }>;
     updateMemo: (orderItemId: string, memo: string) => Promise<void>;
@@ -9428,7 +9506,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     dispatch: (orderItemId: string, body: DispatchRequest, idempotencyKey?: string) => Promise<{
       orderItemId: string;
-      deliveryMethod: "DIRECT" | "COURIER" | "QUICK" | "NOTHING";
+      deliveryMethod: "COURIER" | "DIRECT" | "QUICK" | "NOTHING";
       carrierCode: string | null;
       carrierName: string | null;
       trackingNumber: string | null;
@@ -9490,6 +9568,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       discountAmount: number;
       totalPrice: number;
       couponDiscountAmount: number;
+      pointAllocation: number;
       hold: {
         reason: string;
         expectedDispatchDate: string;
@@ -9558,6 +9637,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       discountAmount: number;
       totalPrice: number;
       couponDiscountAmount: number;
+      pointAllocation: number;
       hold: {
         reason: string;
         expectedDispatchDate: string;
@@ -9588,7 +9668,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     getDelivery: (orderItemId: string) => Promise<{
       orderItemId: string;
-      deliveryMethod: "DIRECT" | "COURIER" | "QUICK" | "NOTHING";
+      deliveryMethod: "COURIER" | "DIRECT" | "QUICK" | "NOTHING";
       carrierCode: string | null;
       carrierName: string | null;
       trackingNumber: string | null;
@@ -9626,7 +9706,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       contents: {
         claimId: string;
         type: "RETURN" | "EXCHANGE" | "CANCEL";
-        status: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
+        status: "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "COMPLETED" | "WITHDRAWN";
         orderId: string;
         orderItemId: string;
         productName: string;
@@ -9637,6 +9717,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         claimDeliveryFee: number;
         expectedRefundAmount: number | null;
         expectedDeliveryFeeRefundAmount: number | null;
+        expectedPointRefundAmount: number;
         exchangeOption: {
           optionId: string;
           optionName: string;
@@ -9664,7 +9745,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     get: (claimId: string) => Promise<{
       claimId: string;
       type: "RETURN" | "EXCHANGE" | "CANCEL";
-      status: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
+      status: "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "COMPLETED" | "WITHDRAWN";
       orderId: string;
       orderItemId: string;
       productName: string;
@@ -9675,6 +9756,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       claimDeliveryFee: number;
       expectedRefundAmount: number | null;
       expectedDeliveryFeeRefundAmount: number | null;
+      expectedPointRefundAmount: number;
       exchangeOption: {
         optionId: string;
         optionName: string;
@@ -9698,7 +9780,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         address2: string | null;
       } | null;
       histories?: {
-        status: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
+        status: "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "COMPLETED" | "WITHDRAWN";
         actor: "SYSTEM" | "BUYER" | "SELLER";
         occurredAt: string;
       }[] | undefined;
@@ -9712,6 +9794,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       deliveryFeeChargeAmount: number;
       couponChargeAmount: number;
       couponChargeRefundAmount: number;
+      pointRefundAmount: number;
       refundedAt: string;
     }>;
     reject: (claimId: string, body: RejectClaimRequest) => Promise<void>;
@@ -9730,7 +9813,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     completeExchange: (claimId: string) => Promise<{
       claimId: string;
       type: "RETURN" | "EXCHANGE" | "CANCEL";
-      status: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
+      status: "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "COMPLETED" | "WITHDRAWN";
       orderId: string;
       orderItemId: string;
       productName: string;
@@ -9741,6 +9824,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       claimDeliveryFee: number;
       expectedRefundAmount: number | null;
       expectedDeliveryFeeRefundAmount: number | null;
+      expectedPointRefundAmount: number;
       exchangeOption: {
         optionId: string;
         optionName: string;
@@ -10650,7 +10734,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         conversionRate: number | null;
       };
       funnel: {
-        step: "SESSION" | "PRODUCT_VIEW" | "ADD_TO_CART" | "BEGIN_CHECKOUT" | "PURCHASE";
+        step: "PURCHASE" | "SESSION" | "PRODUCT_VIEW" | "ADD_TO_CART" | "BEGIN_CHECKOUT";
         sessions: number;
         rateFromPrevious: number | null;
       }[];
@@ -10704,9 +10788,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     /** `GET /v1/analytics/sources` — 채널·소스·캠페인·기기별 세션과 구매 */
     sources: (params: AnalyticsSourcesParams) => Promise<{
-      groupBy: "CAMPAIGN" | "CHANNEL" | "SOURCE" | "DEVICE";
+      groupBy: "CHANNEL" | "SOURCE" | "CAMPAIGN" | "DEVICE";
       rows: {
-        channel: "DIRECT" | "ORGANIC_SEARCH" | "SOCIAL" | "PAID" | "EMAIL" | "CAMPAIGN" | "REFERRAL" | "UNKNOWN" | null;
+        channel: "PAID" | "DIRECT" | "CAMPAIGN" | "UNKNOWN" | "ORGANIC_SEARCH" | "SOCIAL" | "EMAIL" | "REFERRAL" | null;
         source: string | null;
         medium: string | null;
         campaign: string | null;
@@ -10811,7 +10895,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     checkout: (params: AnalyticsRangeParams) => Promise<{
       sessions: number;
       outcomes: {
-        outcome: "COMPLETED" | "NOT_OPENED" | "USER_CANCELED" | "DECLINED" | "PREPARE_FAILURE" | "OTHER" | "IN_PROGRESS";
+        outcome: "OTHER" | "COMPLETED" | "NOT_OPENED" | "USER_CANCELED" | "DECLINED" | "PREPARE_FAILURE" | "IN_PROGRESS";
         sessions: number;
       }[];
       from: string;
@@ -10903,6 +10987,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       refunds: {
         refundId: string;
         amount: number;
+        pointRefundAmount: number;
         reason: string;
         kind: string;
         status: string;
@@ -11911,7 +11996,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     list: (params?: ApprovalListOptions) => Promise<{
       items: {
         approvalId: string;
-        status: "UNKNOWN" | "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "REJECTED" | "EXPIRED";
+        status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
         operationId: string;
         method: string;
         path: string;
@@ -11961,7 +12046,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     get: (approvalId: string) => Promise<{
       approvalId: string;
-      status: "UNKNOWN" | "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "REJECTED" | "EXPIRED";
+      status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
       operationId: string;
       method: string;
       path: string;
@@ -12013,7 +12098,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
      */
     approve: (approvalId: string, body?: ApprovalDecisionRequest) => Promise<{
       approvalId: string;
-      status: "UNKNOWN" | "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "REJECTED" | "EXPIRED";
+      status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
       operationId: string;
       method: string;
       path: string;
@@ -12061,7 +12146,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     reject: (approvalId: string, body?: ApprovalDecisionRequest) => Promise<{
       approvalId: string;
-      status: "UNKNOWN" | "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "REJECTED" | "EXPIRED";
+      status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
       operationId: string;
       method: string;
       path: string;
@@ -12305,7 +12390,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     /** `GET /v1/storefront/site/deployment` — 배포 진행(단계·기록). 만든 뒤 반영이 끝날 때까지 폴링한다 */
     getDeployment: () => Promise<{
       siteId: string;
-      status: "IN_PROGRESS" | "FAILED" | "SUCCEEDED";
+      status: "FAILED" | "SUCCEEDED" | "IN_PROGRESS";
       url: string;
       startedAt: string;
       finishedAt: string | null;
@@ -12327,7 +12412,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     /** `POST /v1/storefront/site/deployment/retry` (202) — 밀린 반영을 곧바로 다시 시도한다. 이미 반영됐으면 그대로다 */
     retryDeployment: () => Promise<{
       siteId: string;
-      status: "IN_PROGRESS" | "FAILED" | "SUCCEEDED";
+      status: "FAILED" | "SUCCEEDED" | "IN_PROGRESS";
       url: string;
       startedAt: string;
       finishedAt: string | null;
@@ -12902,7 +12987,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     runCheck: (body: RunStorefrontCheckRequest) => Promise<{
       checkId: string;
       check: string;
-      status: "UNKNOWN" | "FAILED" | "RUNNING" | "QUEUED" | "PASSED" | "TIMED_OUT";
+      status: "FAILED" | "UNKNOWN" | "RUNNING" | "QUEUED" | "PASSED" | "TIMED_OUT";
       exitCode: number | null;
       durationMs: number | null;
       outputTail: string | null;
@@ -12916,7 +13001,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     getCheck: (checkId: string) => Promise<{
       checkId: string;
       check: string;
-      status: "UNKNOWN" | "FAILED" | "RUNNING" | "QUEUED" | "PASSED" | "TIMED_OUT";
+      status: "FAILED" | "UNKNOWN" | "RUNNING" | "QUEUED" | "PASSED" | "TIMED_OUT";
       exitCode: number | null;
       durationMs: number | null;
       outputTail: string | null;
@@ -13496,6 +13581,15 @@ export declare function createStoreClient(options: StoreClientOptions): {
         enabled: boolean;
         rateBp: number;
       };
+      useAvailable: boolean;
+      use: {
+        enabled: boolean;
+        minBalance: number;
+        minAmount: number;
+        unit: 1 | 100 | 10;
+        maxRatioBp: number;
+        includeDeliveryFee: boolean;
+      };
       expiryDays: number | null;
       notice: "REVIEW_REWARD_PAUSED" | "POINTS_AVAILABLE" | null;
     }>;
@@ -13515,6 +13609,15 @@ export declare function createStoreClient(options: StoreClientOptions): {
         enabled: boolean;
         rateBp: number;
       };
+      useAvailable: boolean;
+      use: {
+        enabled: boolean;
+        minBalance: number;
+        minAmount: number;
+        unit: 1 | 100 | 10;
+        maxRatioBp: number;
+        includeDeliveryFee: boolean;
+      };
       expiryDays: number | null;
       notice: "REVIEW_REWARD_PAUSED" | "POINTS_AVAILABLE" | null;
     }>;
@@ -13799,8 +13902,29 @@ export interface PricingDelivery {
     remoteSurcharge: number;
   }>;
 }
+/**
+ * 적립금 사용 입력(#93 P3) — 쿠폰 뒤 금액에 쓴다. 규칙은 상점 정책 `use`(`PointUsePolicy`)의 값이다.
+ * 금액은 요청·잔액·최대 비율 중 작은 값을 `unit`으로 내리고, 남는 결제 금액이 100원 아래로 내려가지 않게 줄인다(적립금 전액 결제는 아직 받지 않는다).
+ */
+export interface PricingPoints {
+  /** 구매자가 쓰겠다는 금액 */
+  requested: number;
+  /** 지금 잔액 */
+  balance: number;
+  rules: {
+    minBalance: number;
+    minAmount: number;
+    unit: number;
+    maxRatioBp: number;
+    includeDeliveryFee: boolean;
+  };
+}
+/** 적립금을 쓰지 못한 이유 */
+export type PointRejectReason = "MIN_BALANCE" | "MIN_AMOUNT" | "NOT_PAYABLE";
 export interface PricingInput {
   lines: readonly PricingLine[];
+  /** 적립금 사용(#93 P3). 없으면 쓰지 않는다 — 결과는 적립금 이전과 같다 */
+  points?: PricingPoints | null;
   coupons: readonly PricingCoupon[];
   /** 배송비 견적. 없으면 배송비 0으로 계산하고 배송비 쿠폰은 할인할 금액이 없다 */
   delivery?: PricingDelivery | null;
@@ -13829,6 +13953,8 @@ export interface PricingLineResult {
   /** 이 줄에 들어간 쿠폰 할인 합계 — 상품 쿠폰 + 주문 쿠폰 배분 */
   couponDiscount: number;
   allocations: CouponAllocation[];
+  /** 이 줄에 배분한 사용 적립금(#93 P3). 적립금을 쓰지 않으면 0 */
+  pointAllocation: number;
 }
 export interface PricingCouponResult {
   couponKey: string;
@@ -13846,6 +13972,8 @@ export interface PricingCouponResult {
 export interface PricingBundleResult {
   bundleKey: string;
   couponDiscount: number;
+  /** 이 배송 묶음에 배분한 사용 적립금(#93 P3) */
+  pointAllocation: number;
 }
 export interface PricingResult {
   lines: PricingLineResult[];
@@ -13860,7 +13988,15 @@ export interface PricingResult {
   deliveryFee: number;
   /** 배송비 쿠폰 할인 */
   deliveryDiscountAmount: number;
-  /** 결제 금액 = productAmount − couponDiscountAmount + deliveryFee − deliveryDiscountAmount */
+  /** 사용 적립금(#93 P3). 쓰지 않으면 0 */
+  pointAmount: number;
+  /** 지금 쓸 수 있는 최대 적립금 — 주문서 안내값(잔액을 모두 요청했을 때의 금액). 적립금 입력이 없으면 0 */
+  pointMaxUsable: number;
+  /** 요청보다 적게 썼다면 그 이유 — `MIN_PAYMENT`: 결제 금액 100원을 남기려고 줄였다 */
+  pointAdjustReason: "MIN_PAYMENT" | null;
+  /** 요청했지만 쓰지 못했다면 그 이유 */
+  pointRejectReason: PointRejectReason | null;
+  /** 결제 금액 = productAmount − couponDiscountAmount + deliveryFee − deliveryDiscountAmount − pointAmount */
   totalAmount: number;
 }
 /**
@@ -13889,6 +14025,20 @@ export declare function isCouponTargetLine(rule: Pick<CouponRule, "target" | "co
  * 사본 중 앞 장이 만료됐으면 뒤 장이 쓰인다. 결과의 `coupons`는 입력 순서 그대로다. 입력이 같으면 결과도 같다.
  */
 export declare function quotePricing(input: PricingInput): PricingResult;
+/**
+ * 사용 적립금 금액(순수) — 요청·잔액·최대 비율·「결제 금액 100원 남기기」 중 작은 값을 단위로 내린다.
+ * 최소 보유액·최소 사용액에 못 미치면 0이다. 결제 금액이 0원이 되는 사용(적립금 전액 결제)은 아직 받지 않는다(P4).
+ */
+export declare function pointUseOf(points: PricingPoints | null, amounts: {
+  productPaid: number;
+  deliveryPaid: number;
+  total: number;
+}): {
+  amount: number;
+  maxUsable: number;
+  adjustReason: "MIN_PAYMENT" | null;
+  rejectReason: PointRejectReason | null;
+};
 /**
  * 주문이 받은 쿠폰 한 장 — 주문 시점 규칙과 대상 줄을 굳힌 값이다(`orders.discounts`의 항목).
  * 환불 정산은 이 값만 읽는다. 셀러가 쿠폰을 바꾸거나 상품의 카테고리가 바뀌어도 결과가 같다.
@@ -13988,6 +14138,16 @@ export declare function settleCouponShortfall(input: CouponSettlementInput): Cou
 export declare function proratedPaidRefundBase(item: {
   totalPrice: number;
   couponDiscountAmount?: number | null;
+  /** 주문상품에 배분된 사용 적립금(#93 P3) — 현금 환불 기준에서 뺀다. 없으면 0 */
+  pointAllocation?: number | null;
+  quantity: number;
+}, settledQuantity: number, cancelQuantity: number): number;
+/**
+ * 주문상품의 사용 적립금 중 이번 취소 수량의 몫(#93 P3) — 누적 내림의 차분이라 나눠 취소해도 합이 배분액과 같다.
+ * 현금 환불(`proratedPaidRefundBase`)과 따로 돌려준다(`pointRefundAmount`).
+ */
+export declare function proratedPointRefund(item: {
+  pointAllocation?: number | null;
   quantity: number;
 }, settledQuantity: number, cancelQuantity: number): number;
 //#endregion
@@ -14709,6 +14869,7 @@ export declare const orderWebhookEventDataSchema: z.ZodObject<{
   }>;
   testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
   couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+  pointAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   orderItemId: z.ZodOptional<z.ZodString>;
   fulfillmentSnapshot: z.ZodOptional<z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"SHIPPING">;
@@ -14813,6 +14974,7 @@ export declare const orderCanceledWebhookEventDataSchema: z.ZodObject<{
   deliveryFeeChargeAmount: z.ZodNumber;
   couponChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   couponChargeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+  pointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   testPayment: z.ZodBoolean;
 }, z.core.$strip>;
 export type OrderCanceledWebhookEventData = z.infer<typeof orderCanceledWebhookEventDataSchema>;
@@ -14826,7 +14988,6 @@ export declare const claimWebhookEventDataSchema: z.ZodObject<{
     CANCEL: "CANCEL";
   }>;
   status: z.ZodEnum<{
-    COMPLETED: "COMPLETED";
     REJECTED: "REJECTED";
     REQUESTED: "REQUESTED";
     HELD: "HELD";
@@ -14834,6 +14995,7 @@ export declare const claimWebhookEventDataSchema: z.ZodObject<{
     COLLECTED: "COLLECTED";
     REDELIVERING: "REDELIVERING";
     APPROVED: "APPROVED";
+    COMPLETED: "COMPLETED";
     WITHDRAWN: "WITHDRAWN";
   }>;
   quantity: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -14843,6 +15005,7 @@ export declare const claimWebhookEventDataSchema: z.ZodObject<{
   deductAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   couponChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   couponChargeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+  pointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, z.core.$strip>;
 export type ClaimWebhookEventData = z.infer<typeof claimWebhookEventDataSchema>;
@@ -14885,6 +15048,7 @@ export declare const orderWebhookEventSchema: z.ZodObject<{
     }>;
     testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    pointAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     orderItemId: z.ZodOptional<z.ZodString>;
     fulfillmentSnapshot: z.ZodOptional<z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
       type: z.ZodLiteral<"SHIPPING">;
@@ -14992,6 +15156,7 @@ export declare const orderCanceledWebhookEventSchema: z.ZodObject<{
     deliveryFeeChargeAmount: z.ZodNumber;
     couponChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     couponChargeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    pointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     testPayment: z.ZodBoolean;
   }, z.core.$strip>;
   id: z.ZodString;
@@ -15016,7 +15181,6 @@ export declare const claimWebhookEventSchema: z.ZodObject<{
       CANCEL: "CANCEL";
     }>;
     status: z.ZodEnum<{
-      COMPLETED: "COMPLETED";
       REJECTED: "REJECTED";
       REQUESTED: "REQUESTED";
       HELD: "HELD";
@@ -15024,6 +15188,7 @@ export declare const claimWebhookEventSchema: z.ZodObject<{
       COLLECTED: "COLLECTED";
       REDELIVERING: "REDELIVERING";
       APPROVED: "APPROVED";
+      COMPLETED: "COMPLETED";
       WITHDRAWN: "WITHDRAWN";
     }>;
     quantity: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -15033,6 +15198,7 @@ export declare const claimWebhookEventSchema: z.ZodObject<{
     deductAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     couponChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     couponChargeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    pointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
   }, z.core.$strip>;
   id: z.ZodString;
@@ -15098,6 +15264,7 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }>;
     testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    pointAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     orderItemId: z.ZodOptional<z.ZodString>;
     fulfillmentSnapshot: z.ZodOptional<z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
       type: z.ZodLiteral<"SHIPPING">;
@@ -15203,6 +15370,7 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     deliveryFeeChargeAmount: z.ZodNumber;
     couponChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     couponChargeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    pointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     testPayment: z.ZodBoolean;
   }, z.core.$strip>;
   id: z.ZodString;
@@ -15226,7 +15394,6 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       CANCEL: "CANCEL";
     }>;
     status: z.ZodEnum<{
-      COMPLETED: "COMPLETED";
       REJECTED: "REJECTED";
       REQUESTED: "REQUESTED";
       HELD: "HELD";
@@ -15234,6 +15401,7 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       COLLECTED: "COLLECTED";
       REDELIVERING: "REDELIVERING";
       APPROVED: "APPROVED";
+      COMPLETED: "COMPLETED";
       WITHDRAWN: "WITHDRAWN";
     }>;
     quantity: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -15243,6 +15411,7 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     deductAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     couponChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     couponChargeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    pointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
   }, z.core.$strip>;
   id: z.ZodString;