@sayren/store-sdk 0.8.0 → 0.10.0

package/dist/index.d.mts

@@ -1050,6 +1050,7 @@ export declare const changeTypeSchema: z.ZodEnum<{
   "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
   "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
   "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
+  "CLAIM.COMPLETED": "CLAIM.COMPLETED";
 }>;
 export type ChangeType = z.infer<typeof changeTypeSchema>;
 //#endregion
@@ -1118,6 +1119,7 @@ export declare const claimSchema: z.ZodObject<{
   }>;
   claimDeliveryFee: z.ZodNumber;
   expectedRefundAmount: z.ZodNullable<z.ZodNumber>;
+  expectedDeliveryFeeRefundAmount: z.ZodNullable<z.ZodNumber>;
   exchangeOption: z.ZodNullable<z.ZodObject<{
     optionId: z.ZodString;
     optionName: z.ZodString;
@@ -1196,6 +1198,7 @@ export declare const claimDetailSchema: z.ZodObject<{
   }>;
   claimDeliveryFee: z.ZodNumber;
   expectedRefundAmount: z.ZodNullable<z.ZodNumber>;
+  expectedDeliveryFeeRefundAmount: z.ZodNullable<z.ZodNumber>;
   exchangeOption: z.ZodNullable<z.ZodObject<{
     optionId: z.ZodString;
     optionName: z.ZodString;
@@ -1255,6 +1258,9 @@ export declare const approveClaimResultSchema: z.ZodObject<{
   claimId: z.ZodString;
   refundAmount: z.ZodNumber;
   deductAmount: z.ZodNumber;
+  quantity: z.ZodNumber;
+  deliveryFeeRefundAmount: z.ZodNumber;
+  deliveryFeeChargeAmount: z.ZodNumber;
   refundedAt: z.ZodString;
 }, z.core.$strip>;
 export type ApproveClaimResult = z.infer<typeof approveClaimResultSchema>;
@@ -1318,6 +1324,125 @@ export declare const customerAddressSchema: z.ZodObject<{
   address1: z.ZodString;
   address2: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
+/** 동의 종류 — 이용약관·개인정보 수집이용은 가입 필수, 마케팅 수신은 선택 */
+export declare const consentKindSchema: z.ZodEnum<{
+  TERMS: "TERMS";
+  PRIVACY: "PRIVACY";
+  MARKETING: "MARKETING";
+}>;
+export type ConsentKind = z.infer<typeof consentKindSchema>;
+export declare const consentActionSchema: z.ZodEnum<{
+  WITHDRAWN: "WITHDRAWN";
+  AGREED: "AGREED";
+}>;
+export type ConsentAction = z.infer<typeof consentActionSchema>;
+/**
+ * 동의가 일어난 경로. 값이 추가될 수 있어 모르는 값은 그대로 보여 준다.
+ * `SIGNUP` 비밀번호 가입 · `SOCIAL_SIGNUP` 소셜 가입 · `DELEGATED` 셀러 자체 회원 연동 ·
+ * `RECONSENT` 약관 개정 재동의 · `MEMBER_UPDATE` 구매자가 직접 변경 · `SELLER` 셀러가 처리
+ */
+export declare const consentSourceSchema: z.ZodEnum<{
+  SELLER: "SELLER";
+  SIGNUP: "SIGNUP";
+  SOCIAL_SIGNUP: "SOCIAL_SIGNUP";
+  DELEGATED: "DELEGATED";
+  RECONSENT: "RECONSENT";
+  MEMBER_UPDATE: "MEMBER_UPDATE";
+}>;
+export type ConsentSource = z.infer<typeof consentSourceSchema>;
+/** 동의 이력 한 줄 — 추가만 되고 지워지지 않는다(구매자 탈퇴 시에만 함께 지워진다) */
+export declare const customerConsentSchema: z.ZodObject<{
+  consentId: z.ZodString;
+  kind: z.ZodEnum<{
+    TERMS: "TERMS";
+    PRIVACY: "PRIVACY";
+    MARKETING: "MARKETING";
+  }>;
+  version: z.ZodNullable<z.ZodString>;
+  documentUrl: z.ZodNullable<z.ZodString>;
+  action: z.ZodEnum<{
+    WITHDRAWN: "WITHDRAWN";
+    AGREED: "AGREED";
+  }>;
+  source: z.ZodEnum<{
+    SELLER: "SELLER";
+    SIGNUP: "SIGNUP";
+    SOCIAL_SIGNUP: "SOCIAL_SIGNUP";
+    DELEGATED: "DELEGATED";
+    RECONSENT: "RECONSENT";
+    MEMBER_UPDATE: "MEMBER_UPDATE";
+  }>;
+  occurredAt: z.ZodString;
+}, z.core.$strip>;
+export type CustomerConsent = z.infer<typeof customerConsentSchema>;
+/** 종류별 현재 동의 상태 */
+export declare const customerConsentStateSchema: z.ZodObject<{
+  kind: z.ZodEnum<{
+    TERMS: "TERMS";
+    PRIVACY: "PRIVACY";
+    MARKETING: "MARKETING";
+  }>;
+  agreed: z.ZodBoolean;
+  agreedVersion: z.ZodNullable<z.ZodString>;
+  currentVersion: z.ZodNullable<z.ZodString>;
+  currentDocumentUrl: z.ZodNullable<z.ZodString>;
+  updatedAt: z.ZodNullable<z.ZodString>;
+  reconsentRequired: z.ZodBoolean;
+}, z.core.$strip>;
+export type CustomerConsentState = z.infer<typeof customerConsentStateSchema>;
+export declare const customerConsentsSchema: z.ZodObject<{
+  terms: z.ZodObject<{
+    kind: z.ZodEnum<{
+      TERMS: "TERMS";
+      PRIVACY: "PRIVACY";
+      MARKETING: "MARKETING";
+    }>;
+    agreed: z.ZodBoolean;
+    agreedVersion: z.ZodNullable<z.ZodString>;
+    currentVersion: z.ZodNullable<z.ZodString>;
+    currentDocumentUrl: z.ZodNullable<z.ZodString>;
+    updatedAt: z.ZodNullable<z.ZodString>;
+    reconsentRequired: z.ZodBoolean;
+  }, z.core.$strip>;
+  privacy: z.ZodObject<{
+    kind: z.ZodEnum<{
+      TERMS: "TERMS";
+      PRIVACY: "PRIVACY";
+      MARKETING: "MARKETING";
+    }>;
+    agreed: z.ZodBoolean;
+    agreedVersion: z.ZodNullable<z.ZodString>;
+    currentVersion: z.ZodNullable<z.ZodString>;
+    currentDocumentUrl: z.ZodNullable<z.ZodString>;
+    updatedAt: z.ZodNullable<z.ZodString>;
+    reconsentRequired: z.ZodBoolean;
+  }, z.core.$strip>;
+  marketing: z.ZodObject<{
+    kind: z.ZodEnum<{
+      TERMS: "TERMS";
+      PRIVACY: "PRIVACY";
+      MARKETING: "MARKETING";
+    }>;
+    agreed: z.ZodBoolean;
+    agreedVersion: z.ZodNullable<z.ZodString>;
+    currentVersion: z.ZodNullable<z.ZodString>;
+    currentDocumentUrl: z.ZodNullable<z.ZodString>;
+    updatedAt: z.ZodNullable<z.ZodString>;
+    reconsentRequired: z.ZodBoolean;
+  }, z.core.$strip>;
+  reconsentRequired: z.ZodBoolean;
+}, z.core.$strip>;
+export type CustomerConsents = z.infer<typeof customerConsentsSchema>;
+/** `GET /v1/customers/{id}/consents` 쿼리 — 최근 순이다 */
+export declare const customerConsentListQuerySchema: z.ZodObject<{
+  page: z.ZodOptional<z.ZodString>;
+  size: z.ZodOptional<z.ZodString>;
+  kind: z.ZodOptional<z.ZodEnum<{
+    TERMS: "TERMS";
+    PRIVACY: "PRIVACY";
+    MARKETING: "MARKETING";
+  }>>;
+}, z.core.$strip>;
 /** 구매자 상세 — 휴대폰 전체를 보여 준다 */
 export declare const customerDetailSchema: z.ZodObject<{
   customerId: z.ZodString;
@@ -1336,6 +1461,48 @@ export declare const customerDetailSchema: z.ZodObject<{
     }>;
     linkedAt: z.ZodString;
   }, z.core.$strip>>;
+  consents: z.ZodObject<{
+    terms: z.ZodObject<{
+      kind: z.ZodEnum<{
+        TERMS: "TERMS";
+        PRIVACY: "PRIVACY";
+        MARKETING: "MARKETING";
+      }>;
+      agreed: z.ZodBoolean;
+      agreedVersion: z.ZodNullable<z.ZodString>;
+      currentVersion: z.ZodNullable<z.ZodString>;
+      currentDocumentUrl: z.ZodNullable<z.ZodString>;
+      updatedAt: z.ZodNullable<z.ZodString>;
+      reconsentRequired: z.ZodBoolean;
+    }, z.core.$strip>;
+    privacy: z.ZodObject<{
+      kind: z.ZodEnum<{
+        TERMS: "TERMS";
+        PRIVACY: "PRIVACY";
+        MARKETING: "MARKETING";
+      }>;
+      agreed: z.ZodBoolean;
+      agreedVersion: z.ZodNullable<z.ZodString>;
+      currentVersion: z.ZodNullable<z.ZodString>;
+      currentDocumentUrl: z.ZodNullable<z.ZodString>;
+      updatedAt: z.ZodNullable<z.ZodString>;
+      reconsentRequired: z.ZodBoolean;
+    }, z.core.$strip>;
+    marketing: z.ZodObject<{
+      kind: z.ZodEnum<{
+        TERMS: "TERMS";
+        PRIVACY: "PRIVACY";
+        MARKETING: "MARKETING";
+      }>;
+      agreed: z.ZodBoolean;
+      agreedVersion: z.ZodNullable<z.ZodString>;
+      currentVersion: z.ZodNullable<z.ZodString>;
+      currentDocumentUrl: z.ZodNullable<z.ZodString>;
+      updatedAt: z.ZodNullable<z.ZodString>;
+      reconsentRequired: z.ZodBoolean;
+    }, z.core.$strip>;
+    reconsentRequired: z.ZodBoolean;
+  }, z.core.$strip>;
   addresses: z.ZodArray<z.ZodObject<{
     addressId: z.ZodString;
     alias: z.ZodString;
@@ -1990,6 +2157,8 @@ export declare const orderItemSchema: z.ZodObject<{
   optionName: z.ZodNullable<z.ZodString>;
   sellerCode: z.ZodNullable<z.ZodString>;
   quantity: z.ZodNumber;
+  canceledQuantity: z.ZodNumber;
+  activeQuantity: z.ZodNumber;
   unitPrice: z.ZodNumber;
   discountAmount: z.ZodNumber;
   totalPrice: z.ZodNumber;
@@ -2011,6 +2180,7 @@ export declare const orderItemSchema: z.ZodObject<{
     "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
     "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
     "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
+    "CLAIM.COMPLETED": "CLAIM.COMPLETED";
   }>;
   testPayment: z.ZodBoolean;
 }, z.core.$strip>;
@@ -2074,6 +2244,8 @@ export declare const orderSchema: z.ZodObject<{
     optionName: z.ZodNullable<z.ZodString>;
     sellerCode: z.ZodNullable<z.ZodString>;
     quantity: z.ZodNumber;
+    canceledQuantity: z.ZodNumber;
+    activeQuantity: z.ZodNumber;
     unitPrice: z.ZodNumber;
     discountAmount: z.ZodNumber;
     totalPrice: z.ZodNumber;
@@ -2095,6 +2267,7 @@ export declare const orderSchema: z.ZodObject<{
       "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
       "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
       "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
+      "CLAIM.COMPLETED": "CLAIM.COMPLETED";
     }>;
     testPayment: z.ZodBoolean;
   }, z.core.$strip>>;
@@ -2156,6 +2329,8 @@ export declare const orderItemPageSchema: z.ZodObject<{
     optionName: z.ZodNullable<z.ZodString>;
     sellerCode: z.ZodNullable<z.ZodString>;
     quantity: z.ZodNumber;
+    canceledQuantity: z.ZodNumber;
+    activeQuantity: z.ZodNumber;
     unitPrice: z.ZodNumber;
     discountAmount: z.ZodNumber;
     totalPrice: z.ZodNumber;
@@ -2177,6 +2352,7 @@ export declare const orderItemPageSchema: z.ZodObject<{
       "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
       "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
       "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
+      "CLAIM.COMPLETED": "CLAIM.COMPLETED";
     }>;
     testPayment: z.ZodBoolean;
   }, z.core.$strip>>;
@@ -2227,6 +2403,7 @@ export declare const orderItemListQuerySchema: z.ZodObject<{
     "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
     "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
     "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
+    "CLAIM.COMPLETED": "CLAIM.COMPLETED";
   }>>;
   testPayment: z.ZodOptional<z.ZodEnum<{
     true: "true";
@@ -2347,12 +2524,17 @@ export declare const cancelBySellerRequestSchema: z.ZodObject<{
     DELIVERY_IMPOSSIBLE: "DELIVERY_IMPOSSIBLE";
   }>;
   detail: z.ZodOptional<z.ZodString>;
+  quantity: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type CancelBySellerRequest = z.infer<typeof cancelBySellerRequestSchema>;
 /** `POST /v1/order-items/{orderItemId}/cancel` 응답 — 셀러 직권취소 환불 결과 */
 export declare const cancelBySellerResultSchema: z.ZodObject<{
   orderItemId: z.ZodString;
   refundAmount: z.ZodNumber;
+  quantity: z.ZodNumber;
+  canceledQuantity: z.ZodNumber;
+  deliveryFeeRefundAmount: z.ZodNumber;
+  deliveryFeeChargeAmount: z.ZodNumber;
   refundedAt: z.ZodString;
 }, z.core.$strip>;
 export type CancelBySellerResult = z.infer<typeof cancelBySellerResultSchema>;
@@ -3453,11 +3635,45 @@ export declare const productSchema: z.ZodObject<{
   conditionalFreeAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
   returnFee: z.ZodOptional<z.ZodNumber>;
   exchangeFee: z.ZodOptional<z.ZodNumber>;
+  refundPolicy: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    preShipmentDeliveryFeeRefund: z.ZodOptional<z.ZodBoolean>;
+    returnDeliveryFee: z.ZodOptional<z.ZodNumber>;
+    exchangeDeliveryFee: z.ZodOptional<z.ZodNumber>;
+    sellerFaultFreeShipping: z.ZodOptional<z.ZodBoolean>;
+    conditionalFreeShortfallCharge: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strict>>>;
   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>;
+/** 상품 하나에 등록할 수 있는 이미지 최대 장수 — 첫 장이 대표(썸네일)다 */
+export declare const MAX_PRODUCT_IMAGES = 10;
+/**
+ * 상품 이미지 주소의 와이어 형식 — URL이고 2048자 이하다.
+ *
+ * https·확장자 규칙은 여기서 강제하지 않고 `productImageRejection`이 판정한다. 서버가
+ * **새로 추가된 주소에만** 그 규칙을 적용해야 하기 때문이다(규칙이 생기기 전에 저장된
+ * 주소 하나로 상품 수정 전체가 막히면 셀러가 빠져나갈 길이 없다).
+ *
+ * 응답 스키마(`productSchema.images`)도 넓게 둔다. 과거에 저장된 주소를 파싱 오류로
+ * 만들면 상품 조회 자체가 막힌다.
+ */
+export declare const productImageUrlSchema: z.ZodURL;
+export interface ProductImageRejection {
+  code: "INVALID_IMAGE_URL" | "UNSUPPORTED_FILE_TYPE";
+  message: string;
+}
+/**
+ * 상품에 **새로 붙이는** 이미지 주소의 규칙. 통과하면 `null`.
+ *
+ * - https만 받는다. http는 https 스토어프론트에서 혼합 콘텐츠로 차단되고 `data:`·`javascript:`는
+ *   상세 화면에 박히는 주입 경로가 된다.
+ * - 호스트는 제한하지 않는다 — 셀러가 이미 쓰는 이미지 호스트를 그대로 붙일 수 있어야 한다.
+ * - 경로에 확장자가 있으면 상품 이미지 형식이어야 한다(svg·동영상 거부). **확장자가 없으면 통과시킨다**
+ *   — 외부 이미지 CDN은 확장자 없는 키를 쓰는 경우가 흔하고, 주소만으로는 실제 형식을 알 수 없다.
+ */
+export declare function productImageRejection(url: string): ProductImageRejection | null;
 /** 옵션 축(그룹) 최대 개수 — 스키마 상한의 단일 원천 */
 export declare const MAX_OPTION_GROUPS = 3;
 /** 축 하나가 가질 수 있는 값의 최대 개수 */
@@ -3583,6 +3799,13 @@ export declare const productCreateRequestSchema: z.ZodObject<{
   conditionalFreeAmount: z.ZodOptional<z.ZodNumber>;
   returnFee: z.ZodDefault<z.ZodNumber>;
   exchangeFee: z.ZodDefault<z.ZodNumber>;
+  refundPolicy: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    preShipmentDeliveryFeeRefund: z.ZodOptional<z.ZodBoolean>;
+    returnDeliveryFee: z.ZodOptional<z.ZodNumber>;
+    exchangeDeliveryFee: z.ZodOptional<z.ZodNumber>;
+    sellerFaultFreeShipping: z.ZodOptional<z.ZodBoolean>;
+    conditionalFreeShortfallCharge: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strict>>>;
   shippingAddressId: z.ZodOptional<z.ZodString>;
   returnAddressId: z.ZodOptional<z.ZodString>;
   optionGroups: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -3655,15 +3878,6 @@ export declare const productListQuerySchema: z.ZodObject<{
     "updatedAt.desc": "updatedAt.desc";
   }>>;
 }, z.core.$strip>;
-/** `POST /v1/product-images` 응답 — 업로드된 이미지의 CDN 주소 */
-export declare const productImageUploadResultSchema: z.ZodObject<{
-  images: z.ZodArray<z.ZodObject<{
-    url: z.ZodURL;
-    width: z.ZodNumber;
-    height: z.ZodNumber;
-  }, z.core.$strip>>;
-}, z.core.$strip>;
-export type ProductImageUploadResult = z.infer<typeof productImageUploadResultSchema>;
 export declare const discountSchema: z.ZodObject<{
   productId: z.ZodString;
   discountType: z.ZodEnum<{
@@ -3706,6 +3920,18 @@ export declare function isWebOrigin(value: string): boolean;
 export declare const analyticsOriginSchema: z.ZodString;
 /** 허용 오리진 상한 */
 export declare const MAX_ANALYTICS_ALLOWED_ORIGINS = 20;
+/** 자동 배송완료·자동 구매확정 대기일 상한 */
+export declare const MAX_AUTO_TRANSITION_DAYS = 30;
+/**
+ * 약관 버전 — 스토어가 정하는 문자열이다(`1`·`2`·`2026-09-26`·`v1.2` 등). 형식은 강제하지 않고 값이 다르면 다른 버전이다.
+ * 올리면 그 약관에 동의한 구매자의 `reconsentRequired`가 켜지고, 재동의가 이력에 남는다. 되돌리면 재동의 요구도 풀린다.
+ */
+export declare const policyVersionSchema: z.ZodString;
+/**
+ * 약관 문서 주소 — 구매자에게 보여 주는 약관 본문의 주소다. 동의 시점 값이 이력 행에 복사되므로
+ * 나중에 주소를 바꿔도 "무엇에 동의했는지"가 남는다. `null`로 지울 수 있다.
+ */
+export declare const policyDocumentUrlSchema: z.ZodNullable<z.ZodURL>;
 /** `PATCH /v1/store` 본문 — 바꿀 필드만 보낸다 */
 export declare const updateStoreRequestSchema: z.ZodObject<{
   name: z.ZodOptional<z.ZodString>;
@@ -3715,6 +3941,19 @@ 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>;
+  autoDeliverDays: z.ZodOptional<z.ZodNumber>;
+  autoConfirmDays: z.ZodOptional<z.ZodNumber>;
+  refundPolicy: z.ZodOptional<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>>;
+  termsVersion: z.ZodOptional<z.ZodString>;
+  privacyVersion: z.ZodOptional<z.ZodString>;
+  termsUrl: z.ZodOptional<z.ZodNullable<z.ZodURL>>;
+  privacyUrl: z.ZodOptional<z.ZodNullable<z.ZodURL>>;
 }, z.core.$strip>;
 export type UpdateStoreRequest = z.infer<typeof updateStoreRequestSchema>;
 export declare const storeSchema: z.ZodObject<{
@@ -3733,6 +3972,21 @@ export declare const storeSchema: z.ZodObject<{
   analyticsAllowedOrigins: z.ZodArray<z.ZodString>;
   storefrontOrigins: z.ZodArray<z.ZodString>;
   guestCheckoutEnabled: z.ZodBoolean;
+  autoDeliverDays: z.ZodNumber;
+  autoConfirmDays: z.ZodNumber;
+  refundPolicy: z.ZodObject<{
+    preShipmentDeliveryFeeRefund: z.ZodBoolean;
+    returnDeliveryFee: z.ZodNumber;
+    exchangeDeliveryFee: z.ZodNumber;
+    sellerFaultFreeShipping: z.ZodBoolean;
+    conditionalFreeShortfallCharge: z.ZodBoolean;
+  }, z.core.$strip>;
+  termsVersion: z.ZodString;
+  privacyVersion: z.ZodString;
+  termsVersionUpdatedAt: z.ZodNullable<z.ZodString>;
+  privacyVersionUpdatedAt: z.ZodNullable<z.ZodString>;
+  termsUrl: z.ZodNullable<z.ZodString>;
+  privacyUrl: z.ZodNullable<z.ZodString>;
   memberCount: z.ZodNumber;
   createdAt: z.ZodString;
 }, z.core.$strip>;
@@ -3829,6 +4083,42 @@ export declare const sellerAddressRequestSchema: z.ZodObject<{
 export type SellerAddressRequest = z.infer<typeof sellerAddressRequestSchema>;
 //#endregion
 //#region src/schemas/upload.d.ts
+/**
+ * 업로드 용도. 허용 확장자와 크기 상한이 용도별로 다르다.
+ *
+ * - `product-image`: 상품 목록·상세의 상품 이미지. 목록 썸네일로 쓰이므로 정지 이미지만 받는다.
+ * - `description`: 상세설명 본문에 삽입하는 미디어. 동영상과 svg도 받는다.
+ */
+export declare const uploadPurposeSchema: z.ZodEnum<{
+  "product-image": "product-image";
+  description: "description";
+}>;
+export type UploadPurpose = z.infer<typeof uploadPurposeSchema>;
+export interface UploadPurposeLimit {
+  /** 소문자 확장자 목록 */
+  extensions: readonly string[];
+  maxBytes: number;
+}
+/**
+ * 용도별 업로드 제한 — 서버(`POST /v1/uploads`)와 클라이언트가 공유하는 단일 원천이다.
+ *
+ * 크기는 **요청이 스스로 신고한 값**으로만 검사한다. 바이트는 api를 거치지 않고 CDN으로
+ * 직접 PUT되므로 이 검사는 셀러가 올리기 전에 알게 하는 장치이고, 실제 상한은 CDN이 강제한다.
+ */
+export declare const UPLOAD_PURPOSE_LIMITS: Record<UploadPurpose, UploadPurposeLimit>;
+/** 파일명의 소문자 확장자. 확장자가 없으면 `""` */
+export declare function uploadExtensionOf(filename: string): string;
+export interface UploadRejection {
+  /** 400 형식 불일치 / 413 크기 초과 */
+  status: 400 | 413;
+  code: "UNSUPPORTED_FILE_TYPE" | "FILE_TOO_LARGE";
+  message: string;
+}
+/**
+ * 용도 제한 위반 여부. 통과하면 `null`.
+ * 서버가 던지는 오류와 콘솔이 먼저 띄우는 안내가 갈리지 않도록 한 함수로 판정한다.
+ */
+export declare function uploadRejection(purpose: UploadPurpose, filename: string, size?: number): UploadRejection | null;
 /**
  * 미디어 업로드 자리 발급 — `POST /v1/uploads`.
  *
@@ -3838,6 +4128,11 @@ export type SellerAddressRequest = z.infer<typeof sellerAddressRequestSchema>;
  */
 export declare const uploadRequestSchema: z.ZodObject<{
   filename: z.ZodString;
+  purpose: z.ZodDefault<z.ZodEnum<{
+    "product-image": "product-image";
+    description: "description";
+  }>>;
+  size: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type UploadRequest = z.infer<typeof uploadRequestSchema>;
 export declare const uploadTicketSchema: z.ZodObject<{
@@ -4123,6 +4418,16 @@ export declare function createStoreClient(options: StoreClientOptions): {
       url: string;
       uploadUrl: string;
     }>;
+    /**
+     * 자리 발급 + 바이트 PUT을 한 번에 — 끝나면 `url`이 공개 주소다.
+     *
+     * 용도 제한(확장자·크기)은 서버가 판정하지만, 같은 규칙으로 여기서 먼저 걸러
+     * 큰 파일을 CDN까지 보내고 나서 거절되는 왕복을 없앤다.
+     */
+    upload: (file: Blob, options?: {
+      purpose?: UploadPurpose;
+      filename?: string;
+    }) => Promise<UploadTicket>;
   };
   products: {
     list: (params?: ProductListParams) => Promise<{
@@ -4190,6 +4495,13 @@ export declare function createStoreClient(options: StoreClientOptions): {
       conditionalFreeAmount?: number | null | undefined;
       returnFee?: number | undefined;
       exchangeFee?: number | undefined;
+      refundPolicy?: {
+        preShipmentDeliveryFeeRefund?: boolean | undefined;
+        returnDeliveryFee?: number | undefined;
+        exchangeDeliveryFee?: number | undefined;
+        sellerFaultFreeShipping?: boolean | undefined;
+        conditionalFreeShortfallCharge?: boolean | undefined;
+      } | null | undefined;
       shippingAddressId?: string | null | undefined;
       returnAddressId?: string | null | undefined;
       createdAt?: string | undefined;
@@ -4241,6 +4553,13 @@ export declare function createStoreClient(options: StoreClientOptions): {
       conditionalFreeAmount?: number | null | undefined;
       returnFee?: number | undefined;
       exchangeFee?: number | undefined;
+      refundPolicy?: {
+        preShipmentDeliveryFeeRefund?: boolean | undefined;
+        returnDeliveryFee?: number | undefined;
+        exchangeDeliveryFee?: number | undefined;
+        sellerFaultFreeShipping?: boolean | undefined;
+        conditionalFreeShortfallCharge?: boolean | undefined;
+      } | null | undefined;
       shippingAddressId?: string | null | undefined;
       returnAddressId?: string | null | undefined;
       createdAt?: string | undefined;
@@ -4292,6 +4611,13 @@ export declare function createStoreClient(options: StoreClientOptions): {
       conditionalFreeAmount?: number | null | undefined;
       returnFee?: number | undefined;
       exchangeFee?: number | undefined;
+      refundPolicy?: {
+        preShipmentDeliveryFeeRefund?: boolean | undefined;
+        returnDeliveryFee?: number | undefined;
+        exchangeDeliveryFee?: number | undefined;
+        sellerFaultFreeShipping?: boolean | undefined;
+        conditionalFreeShortfallCharge?: boolean | undefined;
+      } | null | undefined;
       shippingAddressId?: string | null | undefined;
       returnAddressId?: string | null | undefined;
       createdAt?: string | undefined;
@@ -4598,6 +4924,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
         optionName: string | null;
         sellerCode: string | null;
         quantity: number;
+        canceledQuantity: number;
+        activeQuantity: number;
         unitPrice: number;
         discountAmount: number;
         totalPrice: number;
@@ -4609,7 +4937,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         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";
+        lastChangedType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED";
         testPayment: boolean;
       }[];
     }>;
@@ -4632,6 +4960,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
         optionName: string | null;
         sellerCode: string | null;
         quantity: number;
+        canceledQuantity: number;
+        activeQuantity: number;
         unitPrice: number;
         discountAmount: number;
         totalPrice: number;
@@ -4643,7 +4973,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         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";
+        lastChangedType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED";
         testPayment: boolean;
       }[];
     }>;
@@ -4663,6 +4993,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
     cancelBySeller: (orderItemId: string, body: CancelBySellerRequest, idempotencyKey?: string) => Promise<{
       orderItemId: string;
       refundAmount: number;
+      quantity: number;
+      canceledQuantity: number;
+      deliveryFeeRefundAmount: number;
+      deliveryFeeChargeAmount: number;
       refundedAt: string;
     }>;
     updateMemo: (orderItemId: string, memo: string) => Promise<void>;
@@ -4696,6 +5030,48 @@ export declare function createStoreClient(options: StoreClientOptions): {
       }[];
     }>;
     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" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED" | "CANCELED";
+      claimStatus: "CANCEL_REQUESTED" | "RETURN_REQUESTED" | "EXCHANGE_REQUESTED" | null;
+      productId: string;
+      productName: string;
+      optionId: string | null;
+      optionName: string | null;
+      sellerCode: string | null;
+      quantity: number;
+      canceledQuantity: number;
+      activeQuantity: number;
+      unitPrice: number;
+      discountAmount: number;
+      totalPrice: number;
+      hold: {
+        reason: string;
+        expectedDispatchDate: string;
+      } | null;
+      autoDecisionDate: string | null;
+      sellerMemo: string | null;
+      orderedAt: string;
+      lastChangedAt: string;
+      lastChangedType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED";
+      testPayment: boolean;
+    }>;
+    /** 배송완료 일괄 처리 — 항목별 부분 성공이다 */
+    markDeliveredBulk: (orderItemIds: string[], idempotencyKey?: string) => Promise<{
+      succeeded: string[];
+      failed: {
+        code: string;
+        message: string;
+        id?: string | undefined;
+        productId?: string | undefined;
+        orderItemId?: string | undefined;
+      }[];
+    }>;
     getDelivery: (orderItemId: string) => Promise<{
       orderItemId: string;
       deliveryMethod: "COURIER" | "DIRECT" | "QUICK" | "NOTHING";
@@ -4739,6 +5115,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         responsibility: "BUYER" | "SELLER";
         claimDeliveryFee: number;
         expectedRefundAmount: number | null;
+        expectedDeliveryFeeRefundAmount: number | null;
         exchangeOption: {
           optionId: string;
           optionName: string;
@@ -4767,6 +5144,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       responsibility: "BUYER" | "SELLER";
       claimDeliveryFee: number;
       expectedRefundAmount: number | null;
+      expectedDeliveryFeeRefundAmount: number | null;
       exchangeOption: {
         optionId: string;
         optionName: string;
@@ -4790,6 +5168,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
       claimId: string;
       refundAmount: number;
       deductAmount: number;
+      quantity: number;
+      deliveryFeeRefundAmount: number;
+      deliveryFeeChargeAmount: number;
       refundedAt: string;
     }>;
     reject: (claimId: string, body: RejectClaimRequest) => Promise<void>;
@@ -4818,6 +5199,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       responsibility: "BUYER" | "SELLER";
       claimDeliveryFee: number;
       expectedRefundAmount: number | null;
+      expectedDeliveryFeeRefundAmount: number | null;
       exchangeOption: {
         optionId: string;
         optionName: string;
@@ -5010,6 +5392,36 @@ export declare function createStoreClient(options: StoreClientOptions): {
         method: "kakao" | "naver" | "google" | "password";
         linkedAt: string;
       }[];
+      consents: {
+        terms: {
+          kind: "TERMS" | "PRIVACY" | "MARKETING";
+          agreed: boolean;
+          agreedVersion: string | null;
+          currentVersion: string | null;
+          currentDocumentUrl: string | null;
+          updatedAt: string | null;
+          reconsentRequired: boolean;
+        };
+        privacy: {
+          kind: "TERMS" | "PRIVACY" | "MARKETING";
+          agreed: boolean;
+          agreedVersion: string | null;
+          currentVersion: string | null;
+          currentDocumentUrl: string | null;
+          updatedAt: string | null;
+          reconsentRequired: boolean;
+        };
+        marketing: {
+          kind: "TERMS" | "PRIVACY" | "MARKETING";
+          agreed: boolean;
+          agreedVersion: string | null;
+          currentVersion: string | null;
+          currentDocumentUrl: string | null;
+          updatedAt: string | null;
+          reconsentRequired: boolean;
+        };
+        reconsentRequired: boolean;
+      };
       addresses: {
         addressId: string;
         alias: string;
@@ -5049,6 +5461,24 @@ export declare function createStoreClient(options: StoreClientOptions): {
         }[];
       }[];
     }>;
+    /** 동의 이력 — 최근 순. 가입·재동의·마케팅 변경이 한 줄씩 남는다 */
+    consents: (customerId: string, params?: PageParams & {
+      kind?: ConsentKind;
+    }) => Promise<{
+      page: number;
+      size: number;
+      totalElements: number;
+      totalPages: number;
+      contents: {
+        consentId: string;
+        kind: "TERMS" | "PRIVACY" | "MARKETING";
+        version: string | null;
+        documentUrl: string | null;
+        action: "WITHDRAWN" | "AGREED";
+        source: "SELLER" | "SIGNUP" | "SOCIAL_SIGNUP" | "DELEGATED" | "RECONSENT" | "MEMBER_UPDATE";
+        occurredAt: string;
+      }[];
+    }>;
     withdraw: (customerId: string, body: WithdrawCustomerRequest) => Promise<void>;
   };
   customerInquiries: {
@@ -6418,6 +6848,21 @@ export declare function createStoreClient(options: StoreClientOptions): {
       analyticsAllowedOrigins: string[];
       storefrontOrigins: string[];
       guestCheckoutEnabled: boolean;
+      autoDeliverDays: number;
+      autoConfirmDays: number;
+      refundPolicy: {
+        preShipmentDeliveryFeeRefund: boolean;
+        returnDeliveryFee: number;
+        exchangeDeliveryFee: number;
+        sellerFaultFreeShipping: boolean;
+        conditionalFreeShortfallCharge: boolean;
+      };
+      termsVersion: string;
+      privacyVersion: string;
+      termsVersionUpdatedAt: string | null;
+      privacyVersionUpdatedAt: string | null;
+      termsUrl: string | null;
+      privacyUrl: string | null;
       memberCount: number;
       createdAt: string;
     }>;
@@ -6437,6 +6882,21 @@ export declare function createStoreClient(options: StoreClientOptions): {
       analyticsAllowedOrigins: string[];
       storefrontOrigins: string[];
       guestCheckoutEnabled: boolean;
+      autoDeliverDays: number;
+      autoConfirmDays: number;
+      refundPolicy: {
+        preShipmentDeliveryFeeRefund: boolean;
+        returnDeliveryFee: number;
+        exchangeDeliveryFee: number;
+        sellerFaultFreeShipping: boolean;
+        conditionalFreeShortfallCharge: boolean;
+      };
+      termsVersion: string;
+      privacyVersion: string;
+      termsVersionUpdatedAt: string | null;
+      privacyVersionUpdatedAt: string | null;
+      termsUrl: string | null;
+      privacyUrl: string | null;
       memberCount: number;
       createdAt: string;
     }>;
@@ -6520,6 +6980,77 @@ export declare function exchangeStoreTokenViaOAuth(options: {
   role?: string;
 }>;
 //#endregion
+//#region src/schemas/refund-policy.d.ts
+/** 유효 환불 정책 — 스토어 기본 + 상품별 덮어쓰기를 합친 결과 */
+export declare const refundPolicySchema: z.ZodObject<{
+  preShipmentDeliveryFeeRefund: z.ZodBoolean;
+  returnDeliveryFee: z.ZodNumber;
+  exchangeDeliveryFee: z.ZodNumber;
+  sellerFaultFreeShipping: z.ZodBoolean;
+  conditionalFreeShortfallCharge: z.ZodBoolean;
+}, z.core.$strip>;
+export type RefundPolicy = z.infer<typeof refundPolicySchema>;
+/**
+ * 스토어가 정하지 않았을 때 서버가 쓰는 값.
+ *
+ * `as const`가 아니라 `RefundPolicy`로 타입을 좁힌다 — 리터럴 타입이면 `Partial<typeof …>`로 일부만 바꿀 때
+ * `true` 자리에 `false`를 넣을 수 없다.
+ */
+export declare const REFUND_POLICY_DEFAULTS: RefundPolicy;
+/**
+ * 부분 정책 — 스토어 설정 요청과 상품별 덮어쓰기가 쓴다. 준 항목만 바뀐다.
+ *
+ * `strictObject`라 모르는 키는 400이다. 오타(`returnFee` 등)를 조용히 무시하면 셀러는 저장됐다고
+ * 믿는데 정책은 기본값으로 남는다.
+ */
+export declare const refundPolicyPatchSchema: 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 type RefundPolicyPatch = z.infer<typeof refundPolicyPatchSchema>;
+/** 정책 해석에 쓰는 상품 값 — 상품별 덮어쓰기와 레거시 배송비 필드 */
+export interface RefundPolicyProductInput {
+  /** 상품별 덮어쓰기. 없으면 스토어 기본을 그대로 쓴다 */
+  refundPolicy?: RefundPolicyPatch | null;
+  /** @deprecated 레거시 상품 반품비 — `refundPolicy`가 없는 옛 상품의 값이다 */
+  returnFee?: number | null;
+  /** @deprecated 레거시 상품 교환비 — `refundPolicy`가 없는 옛 상품의 값이다 */
+  exchangeFee?: number | null;
+}
+/**
+ * 유효 정책 해석 — 상품별 덮어쓰기 → 스토어 기본 → `REFUND_POLICY_DEFAULTS` 순이다.
+ *
+ * 반품비·교환비는 레거시 필드(`products.returnFee`·`exchangeFee`)와 **연결**한다. 상품이
+ * `refundPolicy.returnDeliveryFee`를 정하면 그 값이 원천이고(서버가 `returnFee`도 같은 값으로 맞춘다),
+ * 정하지 않았으면 레거시 값이 0보다 클 때 그 값을 쓴다. 0이면 스토어 기본을 따른다 —
+ * 정책이 생기기 전에 만든 상품(반품비 0)이 스토어 기본을 물려받게 하는 규칙이다.
+ */
+export declare function resolveRefundPolicy(storePolicy?: RefundPolicyPatch | null, product?: RefundPolicyProductInput | null): RefundPolicy;
+/**
+ * 상품의 **덮어쓰기 자체** — 레거시 반품비·교환비를 같은 형태로 승격한 값이다. 덮어쓰기가 없으면 null.
+ *
+ * `resolveRefundPolicy`가 합친 결과로는 "상품이 정한 값"과 "스토어 기본을 물려받은 값"을 가를 수 없다.
+ * 관리 API 응답의 `refundPolicy`와 콘솔 폼의 덮어쓰기 스위치가 이 함수를 원천으로 쓴다 — 가르지 못하면
+ * 스토어 기본을 쓰는 상품을 저장할 때 그 순간의 기본값이 상품에 박히거나, 레거시 값이 조용히 사라진다.
+ */
+export declare function productRefundPolicyOverride(product?: RefundPolicyProductInput | null): RefundPolicyPatch | null;
+/**
+ * 수량 단위 부분 취소의 환불 기준액 — **누적 내림의 차분**이다.
+ *
+ * 원 단위 반올림 규칙: `floor(주문상품 금액 × 누적 수량 ÷ 전체 수량)`을 두 번 구해 그 차를 쓴다.
+ * 부분 취소를 몇 번 나눠도 합이 주문상품 금액과 정확히 같아서 1원이 남거나 넘치지 않는다.
+ * 할인은 이미 단가에 들어 있어(주문 단위 쿠폰이 없다) 별도 안분이 없다.
+ *
+ * @param totalPrice 주문상품 금액 (할인 반영 단가 × 전체 수량)
+ * @param quantity 주문상품 전체 수량
+ * @param settledQuantity 이미 취소·반품된 누적 수량
+ * @param cancelQuantity 이번에 취소·반품할 수량
+ */
+export declare function proratedRefundBase(totalPrice: number, quantity: number, settledQuantity: number, cancelQuantity: number): number;
+//#endregion
 //#region src/schemas/scope.d.ts
 /**
  * 스토어 스코프 카탈로그 (auth-spec §7) — 형식 `{리소스}:{r|rw}`, rw는 r을 함의한다.
@@ -6612,6 +7143,11 @@ export declare const claimWebhookEventDataSchema: z.ZodObject<{
     COMPLETED: "COMPLETED";
     WITHDRAWN: "WITHDRAWN";
   }>;
+  quantity: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+  refundAmount: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+  deliveryFeeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+  deliveryFeeChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+  deductAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, z.core.$strip>;
 export type ClaimWebhookEventData = z.infer<typeof claimWebhookEventDataSchema>;
@@ -6685,6 +7221,11 @@ export declare const claimWebhookEventSchema: z.ZodObject<{
       COMPLETED: "COMPLETED";
       WITHDRAWN: "WITHDRAWN";
     }>;
+    quantity: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    refundAmount: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+    deliveryFeeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    deliveryFeeChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    deductAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
   }, z.core.$strip>;
   id: z.ZodString;
@@ -6776,6 +7317,11 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       COMPLETED: "COMPLETED";
       WITHDRAWN: "WITHDRAWN";
     }>;
+    quantity: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    refundAmount: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+    deliveryFeeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    deliveryFeeChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    deductAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
   }, z.core.$strip>;
   id: z.ZodString;