@sayren/store-sdk 0.7.0 → 0.8.0

package/dist/index.d.mts

@@ -2042,6 +2042,7 @@ export declare const orderSchema: z.ZodObject<{
       MIXED: "MIXED";
     }>;
     approvedMethod: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    easyPayProvider: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     productAmount: z.ZodNumber;
     deliveryFee: z.ZodNumber;
     discountAmount: z.ZodNumber;
@@ -2401,18 +2402,23 @@ export declare const pgPaymentMethodSchema: z.ZodEnum<{
   EASY_PAY: "EASY_PAY";
 }>;
 export type PgPaymentMethod = z.infer<typeof pgPaymentMethodSchema>;
-export declare const paymentRoutingModeSchema: z.ZodEnum<{
-  PRIORITY_DISPLAY: "PRIORITY_DISPLAY";
-  AUTO_FAILOVER: "AUTO_FAILOVER";
-}>;
-export type PaymentRoutingMode = z.infer<typeof paymentRoutingModeSchema>;
-export declare const effectivePaymentRoutingModeSchema: z.ZodEnum<{
-  PRIORITY_DISPLAY: "PRIORITY_DISPLAY";
-  AUTO_FAILOVER: "AUTO_FAILOVER";
-  NONE: "NONE";
-  SINGLE: "SINGLE";
+/**
+ * 간편결제사 — 결제 옵션(스토어프론트 `paymentOptions`)과 PG 설정의 `easyPayProviders`에 쓴다.
+ * `@sayren/storefront-sdk`의 `easyPayProviderSchema`와 같은 값이다(api 계약 테스트가 고정한다)
+ */
+export declare const easyPayProviderSchema: z.ZodEnum<{
+  NAVERPAY: "NAVERPAY";
+  KAKAOPAY: "KAKAOPAY";
+  TOSSPAY: "TOSSPAY";
+  PAYCO: "PAYCO";
 }>;
-export type EffectivePaymentRoutingMode = z.infer<typeof effectivePaymentRoutingModeSchema>;
+export type EasyPayProvider = z.infer<typeof easyPayProviderSchema>;
+/**
+ * 응답에 실리는 간편결제사 — 서버가 간편결제사를 추가해도 파싱이 깨지지 않게 문자열로 받는다
+ * (`pgProvider`·결제수단과 같은 방식). 요청(`easyPayProviders`)은 값을 골라 보내는 자리라 enum 그대로다.
+ * 현재 값은 `NAVERPAY`·`KAKAOPAY`·`TOSSPAY`·`PAYCO`이고 화면은 모르는 값을 원문 그대로 보여 준다.
+ */
+export declare const easyPayProviderResponseSchema: z.ZodString;
 export declare const pgEnvironmentSchema: z.ZodEnum<{
   TEST: "TEST";
   LIVE: "LIVE";
@@ -2512,6 +2518,12 @@ export type UpsertPortOneProviderRequest = z.infer<typeof upsertPortOneProviderR
 export declare const updatePaymentProviderRequestSchema: z.ZodObject<{
   enabled: z.ZodOptional<z.ZodBoolean>;
   sandboxMode: z.ZodOptional<z.ZodBoolean>;
+  easyPayProviders: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+    NAVERPAY: "NAVERPAY";
+    KAKAOPAY: "KAKAOPAY";
+    TOSSPAY: "TOSSPAY";
+    PAYCO: "PAYCO";
+  }>>>;
 }, z.core.$strip>;
 export type UpdatePaymentProviderRequest = z.infer<typeof updatePaymentProviderRequestSchema>;
 export declare const verifyPaymentProviderRequestSchema: z.ZodObject<{
@@ -2522,14 +2534,11 @@ export declare const verifyPaymentProviderRequestSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type VerifyPaymentProviderRequest = z.infer<typeof verifyPaymentProviderRequestSchema>;
 export declare const updatePaymentSettingsRequestSchema: z.ZodObject<{
-  routingMode: z.ZodEnum<{
-    PRIORITY_DISPLAY: "PRIORITY_DISPLAY";
-    AUTO_FAILOVER: "AUTO_FAILOVER";
-  }>;
-  priority: z.ZodArray<z.ZodEnum<{
+  priority: z.ZodOptional<z.ZodArray<z.ZodEnum<{
     tosspayments: "tosspayments";
     portone: "portone";
-  }>>;
+  }>>>;
+  checkoutOrigins: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export type UpdatePaymentSettingsRequest = z.infer<typeof updatePaymentSettingsRequestSchema>;
 export declare const maskedSecretSchema: z.ZodObject<{
@@ -2768,6 +2777,7 @@ export declare const paymentProviderSchema: z.ZodObject<{
     }, z.core.$strip>>;
     openedAt: z.ZodNullable<z.ZodString>;
   }, z.core.$strip>;
+  easyPayProviders: z.ZodArray<z.ZodString>;
   retiredCredentialCount: z.ZodNumber;
   routingExclusion: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
 }, z.core.$strip>;
@@ -2779,16 +2789,7 @@ export type PaymentProvider = z.infer<typeof paymentProviderSchema>;
 export declare const PAYMENT_ROUTING_EXCLUSION_CODES: readonly ["NOT_CONNECTED", "DISABLED", "CREDENTIAL_MISSING", "SANDBOX_IN_LIVE_STORE", "PLATFORM_BLOCKED", "MODE_MISMATCH"];
 export type KnownPaymentRoutingExclusion = (typeof PAYMENT_ROUTING_EXCLUSION_CODES)[number];
 export declare const paymentSettingsSchema: z.ZodObject<{
-  routingMode: z.ZodEnum<{
-    PRIORITY_DISPLAY: "PRIORITY_DISPLAY";
-    AUTO_FAILOVER: "AUTO_FAILOVER";
-  }>;
-  effectiveRoutingMode: z.ZodEnum<{
-    PRIORITY_DISPLAY: "PRIORITY_DISPLAY";
-    AUTO_FAILOVER: "AUTO_FAILOVER";
-    NONE: "NONE";
-    SINGLE: "SINGLE";
-  }>;
+  checkoutOrigins: z.ZodArray<z.ZodString>;
   providers: z.ZodArray<z.ZodObject<{
     provider: z.ZodEnum<{
       tosspayments: "tosspayments";
@@ -2925,6 +2926,7 @@ export declare const paymentSettingsSchema: z.ZodObject<{
       }, z.core.$strip>>;
       openedAt: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>;
+    easyPayProviders: z.ZodArray<z.ZodString>;
     retiredCredentialCount: z.ZodNumber;
     routingExclusion: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
   }, z.core.$strip>>;
@@ -3109,6 +3111,7 @@ export declare const paymentRecordSchema: z.ZodObject<{
     MOBILE: "MOBILE";
     EASY_PAY: "EASY_PAY";
   }>>;
+  easyPayProvider: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
   environment: z.ZodNullable<z.ZodEnum<{
     TEST: "TEST";
     LIVE: "LIVE";
@@ -3153,6 +3156,7 @@ export declare const paymentRecordPageSchema: z.ZodObject<{
       MOBILE: "MOBILE";
       EASY_PAY: "EASY_PAY";
     }>>;
+    easyPayProvider: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     environment: z.ZodNullable<z.ZodEnum<{
       TEST: "TEST";
       LIVE: "LIVE";
@@ -3183,6 +3187,7 @@ export declare const paymentAttemptRecordSchema: z.ZodObject<{
     MOBILE: "MOBILE";
     EASY_PAY: "EASY_PAY";
   }>;
+  easyPayProvider: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
   approvedMethod: z.ZodNullable<z.ZodEnum<{
     CARD: "CARD";
     BANK_TRANSFER: "BANK_TRANSFER";
@@ -3190,6 +3195,7 @@ export declare const paymentAttemptRecordSchema: z.ZodObject<{
     MOBILE: "MOBILE";
     EASY_PAY: "EASY_PAY";
   }>>;
+  approvedEasyPayProvider: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
   amount: z.ZodNumber;
   environment: z.ZodEnum<{
     TEST: "TEST";
@@ -3238,6 +3244,7 @@ export declare const paymentRecordDetailSchema: z.ZodObject<{
     MOBILE: "MOBILE";
     EASY_PAY: "EASY_PAY";
   }>>;
+  easyPayProvider: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
   environment: z.ZodNullable<z.ZodEnum<{
     TEST: "TEST";
     LIVE: "LIVE";
@@ -3267,6 +3274,7 @@ export declare const paymentRecordDetailSchema: z.ZodObject<{
       MOBILE: "MOBILE";
       EASY_PAY: "EASY_PAY";
     }>;
+    easyPayProvider: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     approvedMethod: z.ZodNullable<z.ZodEnum<{
       CARD: "CARD";
       BANK_TRANSFER: "BANK_TRANSFER";
@@ -3274,6 +3282,7 @@ export declare const paymentRecordDetailSchema: z.ZodObject<{
       MOBILE: "MOBILE";
       EASY_PAY: "EASY_PAY";
     }>>;
+    approvedEasyPayProvider: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     amount: z.ZodNumber;
     environment: z.ZodEnum<{
       TEST: "TEST";
@@ -4570,6 +4579,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       payment: {
         method: "CARD" | "BANK_TRANSFER" | "VIRTUAL_ACCOUNT" | "MOBILE" | "POINT" | "MIXED";
         approvedMethod: string | null;
+        easyPayProvider: string | null;
         productAmount: number;
         deliveryFee: number;
         discountAmount: number;
@@ -5396,6 +5406,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         refundedAmount: number;
         provider: "tosspayments" | "portone" | null;
         method: "CARD" | "BANK_TRANSFER" | "VIRTUAL_ACCOUNT" | "MOBILE" | "EASY_PAY" | null;
+        easyPayProvider: string | null;
         environment: "TEST" | "LIVE" | null;
         testPayment: boolean;
         pgTransactionId: string | null;
@@ -5418,6 +5429,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       refundedAmount: number;
       provider: "tosspayments" | "portone" | null;
       method: "CARD" | "BANK_TRANSFER" | "VIRTUAL_ACCOUNT" | "MOBILE" | "EASY_PAY" | null;
+      easyPayProvider: string | null;
       environment: "TEST" | "LIVE" | null;
       testPayment: boolean;
       pgTransactionId: string | null;
@@ -5435,7 +5447,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
         provider: "tosspayments" | "portone";
         status: string;
         method: "CARD" | "BANK_TRANSFER" | "VIRTUAL_ACCOUNT" | "MOBILE" | "EASY_PAY";
+        easyPayProvider: string | null;
         approvedMethod: "CARD" | "BANK_TRANSFER" | "VIRTUAL_ACCOUNT" | "MOBILE" | "EASY_PAY" | null;
+        approvedEasyPayProvider: string | null;
         amount: number;
         environment: "TEST" | "LIVE";
         pgTransactionId: string | null;
@@ -5465,8 +5479,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
   paymentSettings: {
     /** `GET /v1/store/payment-settings` — 라우팅 모드와 지원 PG 전부(연결된 것은 우선순위순) */
     get: () => Promise<{
-      routingMode: "PRIORITY_DISPLAY" | "AUTO_FAILOVER";
-      effectiveRoutingMode: "PRIORITY_DISPLAY" | "AUTO_FAILOVER" | "NONE" | "SINGLE";
+      checkoutOrigins: string[];
       providers: {
         provider: "tosspayments" | "portone";
         displayName: string;
@@ -5555,6 +5568,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           }[];
           openedAt: string | null;
         };
+        easyPayProviders: string[];
         retiredCredentialCount: number;
         routingExclusion: string | null;
       }[];
@@ -5566,8 +5580,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
      * (빠지거나 중복되면 400 `INVALID_PRIORITY`). 진행 중인 결제에는 적용되지 않는다.
      */
     update: (body: UpdatePaymentSettingsRequest) => Promise<{
-      routingMode: "PRIORITY_DISPLAY" | "AUTO_FAILOVER";
-      effectiveRoutingMode: "PRIORITY_DISPLAY" | "AUTO_FAILOVER" | "NONE" | "SINGLE";
+      checkoutOrigins: string[];
       providers: {
         provider: "tosspayments" | "portone";
         displayName: string;
@@ -5656,6 +5669,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           }[];
           openedAt: string | null;
         };
+        easyPayProviders: string[];
         retiredCredentialCount: number;
         routingExclusion: string | null;
       }[];
@@ -5761,6 +5775,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         }[];
         openedAt: string | null;
       };
+      easyPayProviders: string[];
       retiredCredentialCount: number;
       routingExclusion: string | null;
     }>;
@@ -5856,6 +5871,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         }[];
         openedAt: string | null;
       };
+      easyPayProviders: string[];
       retiredCredentialCount: number;
       routingExclusion: string | null;
     }>;
@@ -5961,6 +5977,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         }[];
         openedAt: string | null;
       };
+      easyPayProviders: string[];
       retiredCredentialCount: number;
       routingExclusion: string | null;
     }>;
@@ -6056,6 +6073,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         }[];
         openedAt: string | null;
       };
+      easyPayProviders: string[];
       retiredCredentialCount: number;
       routingExclusion: string | null;
     }>;
@@ -6160,6 +6178,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         }[];
         openedAt: string | null;
       };
+      easyPayProviders: string[];
       retiredCredentialCount: number;
       routingExclusion: string | null;
     }>;

package/dist/index.mjs

@@ -1182,205 +1182,6 @@ const reviewReportResultSchema = z.object({
 	status: z.literal("PENDING_REVIEW")
 });
 //#endregion
-//#region src/schemas/order.ts
-const orderSummarySchema = z.object({
-	orderId: z.string(),
-	ordererName: z.string(),
-	itemCount: z.number().int(),
-	totalAmount: z.number().int(),
-	representativeStatus: orderItemStatusSchema,
-	orderedAt: z.string(),
-	testPayment: z.boolean().describe("테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았어요. 상품을 발송하지 않도록 주의하세요")
-});
-const shippingAddressSchema = z.object({
-	receiverName: z.string(),
-	phone: z.string(),
-	zipCode: z.string(),
-	address1: z.string(),
-	address2: z.string().nullish(),
-	deliveryMemo: z.string().nullish(),
-	entranceCode: z.string().nullish()
-});
-const orderItemSchema = z.object({
-	orderItemId: z.string(),
-	orderId: z.string(),
-	status: orderItemStatusSchema,
-	claimStatus: z.enum([
-		"CANCEL_REQUESTED",
-		"RETURN_REQUESTED",
-		"EXCHANGE_REQUESTED"
-	]).nullable(),
-	productId: z.string(),
-	productName: z.string(),
-	optionId: z.string().nullable(),
-	optionName: z.string().nullable(),
-	sellerCode: z.string().nullable(),
-	quantity: z.number().int(),
-	unitPrice: z.number().int(),
-	discountAmount: z.number().int(),
-	totalPrice: z.number().int(),
-	hold: z.object({
-		reason: z.string(),
-		expectedDispatchDate: z.string()
-	}).nullable(),
-	autoDecisionDate: z.string().nullable(),
-	sellerMemo: z.string().nullable(),
-	orderedAt: z.string(),
-	lastChangedAt: z.string(),
-	lastChangedType: changeTypeSchema,
-	testPayment: z.boolean().describe("소속 주문이 테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았어요")
-});
-const orderSchema = z.object({
-	orderId: z.string(),
-	orderedAt: z.string(),
-	orderer: z.object({
-		name: z.string(),
-		phone: z.string(),
-		email: z.email().optional()
-	}),
-	shippingAddress: shippingAddressSchema,
-	payment: z.object({
-		method: z.enum([
-			"CARD",
-			"BANK_TRANSFER",
-			"VIRTUAL_ACCOUNT",
-			"MOBILE",
-			"POINT",
-			"MIXED"
-		]).describe("method는 호환용이며 간편결제를 CARD로 표시한다. 실제 수단은 approvedMethod를 본다"),
-		approvedMethod: z.string().nullable().optional().default(null).describe("실제 결제수단. method는 호환용이며 간편결제를 CARD로 표시한다. 실제 수단은 approvedMethod를 본다. 현재 값은 `pgPaymentMethodSchema`(`PgPaymentMethod`: CARD·BANK_TRANSFER·VIRTUAL_ACCOUNT·MOBILE·EASY_PAY)이고 매출 리포트·스토어프론트·환불 원장과 같은 값이다. 값이 추가될 수 있어 문자열로 받는다. PG가 알려 주지 않았으면 요청 수단, 시도 기록이 없는 오래된 주문은 null. 서버는 항상 싣는다"),
-		productAmount: z.number().int(),
-		deliveryFee: z.number().int(),
-		discountAmount: z.number().int(),
-		totalAmount: z.number().int(),
-		paidAt: z.string().nullable()
-	}),
-	testPayment: z.boolean().describe("테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았어요. 상품을 발송하지 않도록 주의하세요"),
-	items: z.array(orderItemSchema)
-});
-/** 주문 목록 응답 — `GET /v1/orders` */
-const orderSummaryPageSchema = pageSchema(orderSummarySchema);
-/** 주문상품 변경 목록 응답 — `GET /v1/order-items` */
-const orderItemPageSchema = pageSchema(orderItemSchema);
-const testPaymentQuery = z.enum(["true", "false"]).optional().describe("테스트 결제(샌드박스 결제) 필터. `true`면 테스트 결제만, `false`면 실결제만, 생략하면 전부예요");
-const pageQuery = { page: z.string().optional().describe("페이지 번호 (1부터, 기본 1)") };
-/**
-* `GET /v1/orders` 쿼리 — OpenAPI 문서용 형태(값은 쿼리 문자열). 검증 규칙은 서버가 적용한다:
-* `orderedFrom` 누락 400 `MISSING_PARAMETER`, 날짜 형식 오류 400 `INVALID_PARAMETER`, 31일 초과 400 `RANGE_TOO_WIDE`,
-* `testPayment`가 `true`·`false`가 아니면 400 `INVALID_PARAMETER`
-*/
-const orderListQuerySchema = z.object({
-	orderedFrom: z.string().describe("조회 시작 시각 (ISO 8601 날짜 또는 일시, 포함). 필수"),
-	orderedTo: z.string().optional().describe("조회 끝 시각 (ISO 8601, 포함). 생략하면 orderedFrom부터 31일. 기간은 최대 31일"),
-	status: orderItemStatusSchema.optional().describe("주문상품 상태 필터 — 이 상태의 주문상품이 하나라도 있는 주문"),
-	keyword: z.string().optional().describe("주문번호(일치)·주문자명·수령인명(포함) 검색"),
-	testPayment: testPaymentQuery,
-	...pageQuery,
-	size: z.string().optional().describe("페이지 크기 (기본 20, 최대 100)")
-});
-/**
-* `GET /v1/order-items` 쿼리 — OpenAPI 문서용 형태. `lastChangedFrom` 누락 400 `MISSING_PARAMETER`, 형식 오류 400
-* `INVALID_PARAMETER`, 24시간 초과 400 `RANGE_TOO_WIDE`, `testPayment` 값 오류 400 `INVALID_PARAMETER`
-*/
-const orderItemListQuerySchema = z.object({
-	lastChangedFrom: z.string().describe("마지막 변경 시각 조회 시작 (ISO 8601, 포함). 필수"),
-	lastChangedTo: z.string().optional().describe("마지막 변경 시각 조회 끝 (ISO 8601, 포함). 생략하면 시작부터 24시간. 기간은 최대 24시간"),
-	lastChangedType: changeTypeSchema.optional().describe("마지막 변경 유형 필터"),
-	testPayment: testPaymentQuery,
-	...pageQuery,
-	size: z.string().optional().describe("페이지 크기 (기본 100, 최대 300)")
-});
-const deliveryMethodSchema = z.enum([
-	"COURIER",
-	"DIRECT",
-	"QUICK",
-	"NOTHING"
-]);
-const dispatchRequestSchema = z.object({
-	deliveryMethod: deliveryMethodSchema,
-	carrierCode: z.string().optional(),
-	trackingNumber: z.string().optional(),
-	dispatchedAt: z.string().optional()
-}).refine((value) => value.deliveryMethod === "DIRECT" || value.deliveryMethod === "NOTHING" ? true : !!value.carrierCode && !!value.trackingNumber, { message: "COURIER/QUICK 발송은 carrierCode와 trackingNumber가 필수입니다" });
-const deliveryInfoSchema = z.object({
-	orderItemId: z.string(),
-	deliveryMethod: deliveryMethodSchema,
-	carrierCode: z.string().nullable(),
-	carrierName: z.string().nullable(),
-	trackingNumber: z.string().nullable(),
-	trackingUrl: z.url().nullable(),
-	status: z.enum([
-		"DISPATCHED",
-		"DELIVERING",
-		"DELIVERED"
-	]),
-	dispatchedAt: z.string(),
-	deliveredAt: z.string().nullable()
-});
-/** `GET /v1/order-items/{orderItemId}/delivery` 응답 — 배송 정보 + 배송 추적 이벤트 */
-const deliveryStatusSchema = deliveryInfoSchema.extend({ trackingEvents: z.array(z.object({
-	status: z.string(),
-	location: z.string(),
-	occurredAt: z.string()
-})).optional() });
-/** `PUT /v1/order-items/{orderItemId}/dispatch/tracking` 응답 — 바뀐 송장 */
-const trackingUpdateResultSchema = z.object({
-	orderItemId: z.string(),
-	carrierCode: z.string(),
-	trackingNumber: z.string()
-});
-const carrierSchema = z.object({
-	carrierCode: z.string(),
-	name: z.string(),
-	trackingUrlTemplate: z.string()
-});
-const holdOrderItemRequestSchema = z.object({
-	reason: z.enum([
-		"OUT_OF_STOCK",
-		"CUSTOMER_REQUEST",
-		"CUSTOMS",
-		"ETC"
-	]),
-	detail: z.string().max(500).optional(),
-	expectedDispatchDate: z.string()
-});
-const cancelBySellerRequestSchema = z.object({
-	reason: z.enum([
-		"OUT_OF_STOCK",
-		"PRICE_ERROR",
-		"DELIVERY_IMPOSSIBLE",
-		"ETC"
-	]),
-	detail: z.string().max(500).optional()
-});
-/** `POST /v1/order-items/{orderItemId}/cancel` 응답 — 셀러 직권취소 환불 결과 */
-const cancelBySellerResultSchema = z.object({
-	orderItemId: z.string(),
-	refundAmount: z.number().int(),
-	refundedAt: z.string()
-});
-/** `PUT /v1/order-items/{orderItemId}/memo` 응답 — 빈 문자열로 저장하면 메모가 지워져 `null`이다 */
-const orderItemMemoResultSchema = z.object({
-	orderItemId: z.string(),
-	sellerMemo: z.string().nullable()
-});
-/** `POST /v1/order-items/{orderItemId}/purchase-decision/request` 응답 */
-const purchaseDecisionRequestResultSchema = z.object({
-	orderItemId: z.string(),
-	requestedAt: z.string()
-});
-/** `POST /v1/order-items/{orderItemId}/purchase-decision/extend` 응답 — 연장은 최대 2회 */
-const purchaseDecisionExtendResultSchema = z.object({
-	orderItemId: z.string(),
-	autoDecisionDate: z.string(),
-	extendCount: z.number().int().max(2)
-});
-/**
-* `GET /v1/orders/{orderId}/address-change-requests` 응답 — 배송지 변경 요청 플로우는 아직 제공하지 않아
-* 현재는 항상 빈 배열이다
-*/
-const addressChangeRequestListSchema = z.array(z.record(z.string(), z.unknown())).describe("배송지 변경 요청 목록 (현재 항상 빈 배열)");
-//#endregion
 //#region src/schemas/payment.ts
 /**
 * 스토어 결제(PG) 설정과 매출 리포트 계약.
@@ -1397,13 +1198,22 @@ const pgPaymentMethodSchema = z.enum([
 	"MOBILE",
 	"EASY_PAY"
 ]).describe("결제수단 (스토어프론트 결제 요청의 `paymentMethod`와 같은 값)");
-const paymentRoutingModeSchema = z.enum(["PRIORITY_DISPLAY", "AUTO_FAILOVER"]).describe("PG가 둘 이상 사용 중일 때의 라우팅 방식. `PRIORITY_DISPLAY`=결제창에 사용 중인 PG를 모두 보여 주고 1순위를 기본 선택, `AUTO_FAILOVER`=1순위로 결제창을 열고, 결제창을 띄우기 전 장애(PG 준비 실패)일 때만 다음 순위로 자동 전환");
-const effectivePaymentRoutingModeSchema = z.enum([
-	"NONE",
-	"SINGLE",
-	"PRIORITY_DISPLAY",
-	"AUTO_FAILOVER"
-]).describe("실제로 적용되는 라우팅. 사용 중인 PG가 0개면 `NONE`(결제 불가), 1개면 `SINGLE`, 2개 이상이면 `routingMode` 값");
+/**
+* 간편결제사 — 결제 옵션(스토어프론트 `paymentOptions`)과 PG 설정의 `easyPayProviders`에 쓴다.
+* `@sayren/storefront-sdk`의 `easyPayProviderSchema`와 같은 값이다(api 계약 테스트가 고정한다)
+*/
+const easyPayProviderSchema = z.enum([
+	"NAVERPAY",
+	"KAKAOPAY",
+	"TOSSPAY",
+	"PAYCO"
+]);
+/**
+* 응답에 실리는 간편결제사 — 서버가 간편결제사를 추가해도 파싱이 깨지지 않게 문자열로 받는다
+* (`pgProvider`·결제수단과 같은 방식). 요청(`easyPayProviders`)은 값을 골라 보내는 자리라 enum 그대로다.
+* 현재 값은 `NAVERPAY`·`KAKAOPAY`·`TOSSPAY`·`PAYCO`이고 화면은 모르는 값을 원문 그대로 보여 준다.
+*/
+const easyPayProviderResponseSchema = z.string();
 const pgEnvironmentSchema = z.enum(["TEST", "LIVE"]).describe("PG 결제 환경. `TEST`=PG 샌드박스(테스트 키, 실제로 돈이 오가지 않음), `LIVE`=실결제(운영 키)");
 const pgVerificationResultSchema = z.enum(["SUCCESS", "FAILED"]).describe("연결 테스트 결과");
 /** 비밀 값 입력 — 저장 후 다시 조회할 수 없다 */
@@ -1462,13 +1272,14 @@ const upsertPortOneProviderRequestSchema = z.object({
 });
 const updatePaymentProviderRequestSchema = z.object({
 	enabled: z.boolean().optional().describe("사용 여부. 켜려면 활성 환경(샌드박스면 TEST, 아니면 LIVE) 자격 증명이 모두 저장돼 있어야 한다(`PAYMENT_PROVIDER_INCOMPLETE`)"),
-	sandboxMode: z.boolean().optional().describe("샌드박스 스위치. `true`면 새 결제에 TEST 세트를 쓴다(항상 허용). `false`(라이브 전환)는 라이브 개방 조건을 모두 충족해야 한다(`LIVE_GATE_NOT_MET`)")
-}).refine((body) => body.enabled !== void 0 || body.sandboxMode !== void 0, { message: "enabled 또는 sandboxMode 중 하나는 보내야 해요" });
+	sandboxMode: z.boolean().optional().describe("샌드박스 스위치. `true`면 새 결제에 TEST 세트를 쓴다(항상 허용). `false`(라이브 전환)는 라이브 개방 조건을 모두 충족해야 한다(`LIVE_GATE_NOT_MET`)"),
+	easyPayProviders: z.array(easyPayProviderSchema).max(easyPayProviderSchema.options.length).optional().describe("이 PG로 받는 간편결제사 — 통째로 바꾼다. PG 계약(포트원은 채널)에 추가한 간편결제만 켠다. 켠 간편결제사마다 스토어프론트 결제 옵션이 하나씩 생긴다(포트원은 간편결제를 받는 채널이 있어야 한다)")
+}).refine((body) => body.enabled !== void 0 || body.sandboxMode !== void 0 || body.easyPayProviders !== void 0, { message: "enabled·sandboxMode·easyPayProviders 중 하나는 보내야 해요" });
 const verifyPaymentProviderRequestSchema = z.object({ environment: pgEnvironmentSchema.optional().describe("연결 테스트할 자격 증명 세트. 생략하면 활성 환경(샌드박스면 TEST, 아니면 LIVE)") });
 const updatePaymentSettingsRequestSchema = z.object({
-	routingMode: paymentRoutingModeSchema,
-	priority: z.array(pgProviderSchema).min(1).max(50).describe("PG 우선순위(앞이 1순위). 연결된 PG 수만큼 **모두 한 번씩** 나열한다(길이 상한 50은 안전장치다). 빠지거나 중복되거나 연결되지 않은 PG가 있으면 `INVALID_PRIORITY`")
-});
+	priority: z.array(pgProviderSchema).min(1).max(50).optional().describe("PG 우선순위(앞이 1순위) — 스토어프론트 결제 옵션 목록의 PG 순서다. 연결된 PG 수만큼 **모두 한 번씩** 나열한다(길이 상한 50은 안전장치다). 빠지거나 중복되거나 연결되지 않은 PG가 있으면 `INVALID_PRIORITY`"),
+	checkoutOrigins: z.array(z.string().max(200)).max(20).optional().describe("결제 도메인 — 통째로 바꾼다. 결제를 마친 구매자가 돌아올 스토어프론트 origin(`https://shop.example.com`, https·경로 없음). 결제 시작의 `returnUrl`은 이 목록 안이어야 한다. 비어 있으면 실결제를 시작할 수 없다(테스트 결제는 localhost 허용). 같은 도메인을 PG 가맹 정보에도 등록한다. 형식이 틀리면 `INVALID_CHECKOUT_ORIGIN`")
+}).refine((body) => body.priority !== void 0 || body.checkoutOrigins !== void 0, { message: "priority 또는 checkoutOrigins 중 하나는 보내야 해요" });
 const maskedSecretSchema = z.object({
 	field: z.string().describe("비밀 필드 이름 (`secretKey`·`apiSecret`·`webhookSecret`)"),
 	configured: z.boolean().describe("값이 저장돼 있는가"),
@@ -1529,6 +1340,7 @@ const paymentProviderSchema = z.object({
 		LIVE: paymentCredentialSetSchema.nullable()
 	}).describe("환경별 자격 증명 세트. 등록되지 않은 세트는 null"),
 	liveGate: liveGateSchema.describe("라이브 개방 조건. 조건을 모두 충족해야 샌드박스를 끌 수 있다"),
+	easyPayProviders: z.array(easyPayProviderResponseSchema).describe("이 PG로 받는 간편결제사. 연결되지 않았으면 빈 목록. 현재 값은 `NAVERPAY`·`KAKAOPAY`·`TOSSPAY`·`PAYCO`이고 값이 추가될 수 있어 문자열로 받는다"),
 	retiredCredentialCount: z.number().int().describe("보관된(가맹점 교체·연결 해제로 새 결제에 더 쓰이지 않는) 자격 증명 수. 그 가맹점으로 받은 결제의 환불·대사에 계속 쓰인다"),
 	routingExclusion: z.string().nullable().optional().default(null).describe("지금 새 결제의 후보가 아닌 사유. 후보면 null. 판정 원천은 서버 라우팅이다(콘솔이 다시 계산하지 않는다). 후보가 아닌 PG에는 항상 사유 코드를 붙인다(연결 안 된 PG 포함) — 모든 PG는 `candidates`에 있거나 이 값이 null이 아니다. 현재 값: `NOT_CONNECTED`(연결 안 됨) · `DISABLED`(사용 중지) · `CREDENTIAL_MISSING`(활성 환경 자격 증명 없음) · `SANDBOX_IN_LIVE_STORE`(다른 PG가 라이브라 이 샌드박스 PG는 실구매자 결제에 쓰지 않음) · `PLATFORM_BLOCKED`(플랫폼이 실결제를 막음) · `MODE_MISMATCH`(라이브를 연 서버 모드와 현재 모드가 다름). 값이 추가될 수 있어 문자열로 받는다 — 모르는 값은 후보 아님으로 다룬다. 서버는 항상 싣는다. 이 필드가 없는 이전 서버 응답은 기본값(null)으로 읽는다")
 });
@@ -1545,8 +1357,7 @@ const PAYMENT_ROUTING_EXCLUSION_CODES = [
 	"MODE_MISMATCH"
 ];
 const paymentSettingsSchema = z.object({
-	routingMode: paymentRoutingModeSchema.describe("저장된 라우팅 방식 (기본 `AUTO_FAILOVER`). PG가 하나뿐이면 무시된다"),
-	effectiveRoutingMode: effectivePaymentRoutingModeSchema,
+	checkoutOrigins: z.array(z.string()).describe("결제 도메인 — 결제를 마친 구매자가 돌아올 스토어프론트 origin 목록"),
 	providers: z.array(paymentProviderSchema).describe("지원하는 모든 PG. 연결된 것은 우선순위순, 연결되지 않은 것은 뒤에 온다"),
 	environment: pgEnvironmentSchema.nullable().optional().default(null).describe("지금 결제를 시작하면 쓰는 결제 환경. 사용 가능한 PG 중 하나라도 라이브면 `LIVE`(샌드박스 PG는 제외), 아니면 `TEST`. 사용 가능한 PG가 없으면 null. 서버는 항상 싣는다. 이 필드가 없는 이전 서버 응답은 기본값(null)으로 읽는다"),
 	candidates: z.array(z.string()).optional().default(() => []).describe("지금 결제를 시작하면 쓰는 PG, 우선순위순(`tosspayments`·`portone`). 비어 있으면 구매자가 결제할 수 없다. 빠진 PG의 사유는 `providers[].routingExclusion` — 후보가 아닌 PG에는 항상 사유 코드를 붙인다. 서버는 항상 싣는다. 이 필드가 없는 이전 서버 응답은 기본값(빈 배열)으로 읽는다")
@@ -1623,6 +1434,7 @@ const paymentRecordSchema = z.object({
 	refundedAmount: z.number().int().describe("환불 완료 금액 합계. 실패한 환불은 빼고 센다"),
 	provider: pgProviderSchema.nullable().describe("승인한 PG. 승인 전에 끝났으면 마지막 시도의 PG"),
 	method: pgPaymentMethodSchema.nullable().describe("실제 결제수단. 모르면 요청 수단"),
+	easyPayProvider: easyPayProviderResponseSchema.nullable().optional().default(null).describe("간편결제사. `method`가 `EASY_PAY`일 때만 값이 있고, PG가 알려 주지 않았으면 요청한 간편결제사다. 그 밖의 결제수단과 간편결제 이전 결제는 null. 서버는 항상 싣는다. 현재 값은 `NAVERPAY`·`KAKAOPAY`·`TOSSPAY`·`PAYCO`이고 값이 추가될 수 있어 문자열로 받는다"),
 	environment: pgEnvironmentSchema.nullable().describe("결제 환경"),
 	testPayment: z.boolean().describe("샌드박스 결제인가"),
 	pgTransactionId: z.string().nullable().describe("PG 거래 id (토스 paymentKey, 포트원 txId)"),
@@ -1640,7 +1452,9 @@ const paymentAttemptRecordSchema = z.object({
 	provider: pgProviderSchema,
 	status: paymentAttemptStatusSchema,
 	method: pgPaymentMethodSchema.describe("주문서에서 고른 결제수단"),
+	easyPayProvider: easyPayProviderResponseSchema.nullable().optional().default(null).describe("주문서에서 고른 간편결제사. 간편결제가 아니면 null. 서버는 항상 싣는다(값이 추가될 수 있어 문자열)"),
 	approvedMethod: pgPaymentMethodSchema.nullable().describe("PG가 보고한 실제 결제수단"),
+	approvedEasyPayProvider: easyPayProviderResponseSchema.nullable().optional().default(null).describe("PG가 보고한 실제 간편결제사. 모르거나 간편결제가 아니면 null. 서버는 항상 싣는다(값이 추가될 수 있어 문자열)"),
 	amount: z.number().int(),
 	environment: pgEnvironmentSchema,
 	pgTransactionId: z.string().nullable(),
@@ -1678,6 +1492,206 @@ const paymentListQuerySchema = z.object({
 	size: z.string().optional().describe("페이지 크기 (기본 20, 최대 100)")
 });
 //#endregion
+//#region src/schemas/order.ts
+const orderSummarySchema = z.object({
+	orderId: z.string(),
+	ordererName: z.string(),
+	itemCount: z.number().int(),
+	totalAmount: z.number().int(),
+	representativeStatus: orderItemStatusSchema,
+	orderedAt: z.string(),
+	testPayment: z.boolean().describe("테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았어요. 상품을 발송하지 않도록 주의하세요")
+});
+const shippingAddressSchema = z.object({
+	receiverName: z.string(),
+	phone: z.string(),
+	zipCode: z.string(),
+	address1: z.string(),
+	address2: z.string().nullish(),
+	deliveryMemo: z.string().nullish(),
+	entranceCode: z.string().nullish()
+});
+const orderItemSchema = z.object({
+	orderItemId: z.string(),
+	orderId: z.string(),
+	status: orderItemStatusSchema,
+	claimStatus: z.enum([
+		"CANCEL_REQUESTED",
+		"RETURN_REQUESTED",
+		"EXCHANGE_REQUESTED"
+	]).nullable(),
+	productId: z.string(),
+	productName: z.string(),
+	optionId: z.string().nullable(),
+	optionName: z.string().nullable(),
+	sellerCode: z.string().nullable(),
+	quantity: z.number().int(),
+	unitPrice: z.number().int(),
+	discountAmount: z.number().int(),
+	totalPrice: z.number().int(),
+	hold: z.object({
+		reason: z.string(),
+		expectedDispatchDate: z.string()
+	}).nullable(),
+	autoDecisionDate: z.string().nullable(),
+	sellerMemo: z.string().nullable(),
+	orderedAt: z.string(),
+	lastChangedAt: z.string(),
+	lastChangedType: changeTypeSchema,
+	testPayment: z.boolean().describe("소속 주문이 테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았어요")
+});
+const orderSchema = z.object({
+	orderId: z.string(),
+	orderedAt: z.string(),
+	orderer: z.object({
+		name: z.string(),
+		phone: z.string(),
+		email: z.email().optional()
+	}),
+	shippingAddress: shippingAddressSchema,
+	payment: z.object({
+		method: z.enum([
+			"CARD",
+			"BANK_TRANSFER",
+			"VIRTUAL_ACCOUNT",
+			"MOBILE",
+			"POINT",
+			"MIXED"
+		]).describe("method는 호환용이며 간편결제를 CARD로 표시한다. 실제 수단은 approvedMethod를 본다"),
+		approvedMethod: z.string().nullable().optional().default(null).describe("실제 결제수단. method는 호환용이며 간편결제를 CARD로 표시한다. 실제 수단은 approvedMethod를 본다. 현재 값은 `pgPaymentMethodSchema`(`PgPaymentMethod`: CARD·BANK_TRANSFER·VIRTUAL_ACCOUNT·MOBILE·EASY_PAY)이고 매출 리포트·스토어프론트·환불 원장과 같은 값이다. 값이 추가될 수 있어 문자열로 받는다. PG가 알려 주지 않았으면 요청 수단, 시도 기록이 없는 오래된 주문은 null. 서버는 항상 싣는다"),
+		easyPayProvider: easyPayProviderResponseSchema.nullable().optional().default(null).describe("승인된 간편결제사. `approvedMethod`가 `EASY_PAY`일 때만 값이 있고, PG가 알려 주지 않았으면 요청한 간편결제사다. 그 밖의 결제수단과 간편결제 이전 주문은 null. 서버는 항상 싣는다. 현재 값은 `NAVERPAY`·`KAKAOPAY`·`TOSSPAY`·`PAYCO`이고 값이 추가될 수 있어 문자열로 받는다"),
+		productAmount: z.number().int(),
+		deliveryFee: z.number().int(),
+		discountAmount: z.number().int(),
+		totalAmount: z.number().int(),
+		paidAt: z.string().nullable()
+	}),
+	testPayment: z.boolean().describe("테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았어요. 상품을 발송하지 않도록 주의하세요"),
+	items: z.array(orderItemSchema)
+});
+/** 주문 목록 응답 — `GET /v1/orders` */
+const orderSummaryPageSchema = pageSchema(orderSummarySchema);
+/** 주문상품 변경 목록 응답 — `GET /v1/order-items` */
+const orderItemPageSchema = pageSchema(orderItemSchema);
+const testPaymentQuery = z.enum(["true", "false"]).optional().describe("테스트 결제(샌드박스 결제) 필터. `true`면 테스트 결제만, `false`면 실결제만, 생략하면 전부예요");
+const pageQuery = { page: z.string().optional().describe("페이지 번호 (1부터, 기본 1)") };
+/**
+* `GET /v1/orders` 쿼리 — OpenAPI 문서용 형태(값은 쿼리 문자열). 검증 규칙은 서버가 적용한다:
+* `orderedFrom` 누락 400 `MISSING_PARAMETER`, 날짜 형식 오류 400 `INVALID_PARAMETER`, 31일 초과 400 `RANGE_TOO_WIDE`,
+* `testPayment`가 `true`·`false`가 아니면 400 `INVALID_PARAMETER`
+*/
+const orderListQuerySchema = z.object({
+	orderedFrom: z.string().describe("조회 시작 시각 (ISO 8601 날짜 또는 일시, 포함). 필수"),
+	orderedTo: z.string().optional().describe("조회 끝 시각 (ISO 8601, 포함). 생략하면 orderedFrom부터 31일. 기간은 최대 31일"),
+	status: orderItemStatusSchema.optional().describe("주문상품 상태 필터 — 이 상태의 주문상품이 하나라도 있는 주문"),
+	keyword: z.string().optional().describe("주문번호(일치)·주문자명·수령인명(포함) 검색"),
+	testPayment: testPaymentQuery,
+	...pageQuery,
+	size: z.string().optional().describe("페이지 크기 (기본 20, 최대 100)")
+});
+/**
+* `GET /v1/order-items` 쿼리 — OpenAPI 문서용 형태. `lastChangedFrom` 누락 400 `MISSING_PARAMETER`, 형식 오류 400
+* `INVALID_PARAMETER`, 24시간 초과 400 `RANGE_TOO_WIDE`, `testPayment` 값 오류 400 `INVALID_PARAMETER`
+*/
+const orderItemListQuerySchema = z.object({
+	lastChangedFrom: z.string().describe("마지막 변경 시각 조회 시작 (ISO 8601, 포함). 필수"),
+	lastChangedTo: z.string().optional().describe("마지막 변경 시각 조회 끝 (ISO 8601, 포함). 생략하면 시작부터 24시간. 기간은 최대 24시간"),
+	lastChangedType: changeTypeSchema.optional().describe("마지막 변경 유형 필터"),
+	testPayment: testPaymentQuery,
+	...pageQuery,
+	size: z.string().optional().describe("페이지 크기 (기본 100, 최대 300)")
+});
+const deliveryMethodSchema = z.enum([
+	"COURIER",
+	"DIRECT",
+	"QUICK",
+	"NOTHING"
+]);
+const dispatchRequestSchema = z.object({
+	deliveryMethod: deliveryMethodSchema,
+	carrierCode: z.string().optional(),
+	trackingNumber: z.string().optional(),
+	dispatchedAt: z.string().optional()
+}).refine((value) => value.deliveryMethod === "DIRECT" || value.deliveryMethod === "NOTHING" ? true : !!value.carrierCode && !!value.trackingNumber, { message: "COURIER/QUICK 발송은 carrierCode와 trackingNumber가 필수입니다" });
+const deliveryInfoSchema = z.object({
+	orderItemId: z.string(),
+	deliveryMethod: deliveryMethodSchema,
+	carrierCode: z.string().nullable(),
+	carrierName: z.string().nullable(),
+	trackingNumber: z.string().nullable(),
+	trackingUrl: z.url().nullable(),
+	status: z.enum([
+		"DISPATCHED",
+		"DELIVERING",
+		"DELIVERED"
+	]),
+	dispatchedAt: z.string(),
+	deliveredAt: z.string().nullable()
+});
+/** `GET /v1/order-items/{orderItemId}/delivery` 응답 — 배송 정보 + 배송 추적 이벤트 */
+const deliveryStatusSchema = deliveryInfoSchema.extend({ trackingEvents: z.array(z.object({
+	status: z.string(),
+	location: z.string(),
+	occurredAt: z.string()
+})).optional() });
+/** `PUT /v1/order-items/{orderItemId}/dispatch/tracking` 응답 — 바뀐 송장 */
+const trackingUpdateResultSchema = z.object({
+	orderItemId: z.string(),
+	carrierCode: z.string(),
+	trackingNumber: z.string()
+});
+const carrierSchema = z.object({
+	carrierCode: z.string(),
+	name: z.string(),
+	trackingUrlTemplate: z.string()
+});
+const holdOrderItemRequestSchema = z.object({
+	reason: z.enum([
+		"OUT_OF_STOCK",
+		"CUSTOMER_REQUEST",
+		"CUSTOMS",
+		"ETC"
+	]),
+	detail: z.string().max(500).optional(),
+	expectedDispatchDate: z.string()
+});
+const cancelBySellerRequestSchema = z.object({
+	reason: z.enum([
+		"OUT_OF_STOCK",
+		"PRICE_ERROR",
+		"DELIVERY_IMPOSSIBLE",
+		"ETC"
+	]),
+	detail: z.string().max(500).optional()
+});
+/** `POST /v1/order-items/{orderItemId}/cancel` 응답 — 셀러 직권취소 환불 결과 */
+const cancelBySellerResultSchema = z.object({
+	orderItemId: z.string(),
+	refundAmount: z.number().int(),
+	refundedAt: z.string()
+});
+/** `PUT /v1/order-items/{orderItemId}/memo` 응답 — 빈 문자열로 저장하면 메모가 지워져 `null`이다 */
+const orderItemMemoResultSchema = z.object({
+	orderItemId: z.string(),
+	sellerMemo: z.string().nullable()
+});
+/** `POST /v1/order-items/{orderItemId}/purchase-decision/request` 응답 */
+const purchaseDecisionRequestResultSchema = z.object({
+	orderItemId: z.string(),
+	requestedAt: z.string()
+});
+/** `POST /v1/order-items/{orderItemId}/purchase-decision/extend` 응답 — 연장은 최대 2회 */
+const purchaseDecisionExtendResultSchema = z.object({
+	orderItemId: z.string(),
+	autoDecisionDate: z.string(),
+	extendCount: z.number().int().max(2)
+});
+/**
+* `GET /v1/orders/{orderId}/address-change-requests` 응답 — 배송지 변경 요청 플로우는 아직 제공하지 않아
+* 현재는 항상 빈 배열이다
+*/
+const addressChangeRequestListSchema = z.array(z.record(z.string(), z.unknown())).describe("배송지 변경 요청 목록 (현재 항상 빈 배열)");
+//#endregion
 //#region src/schemas/product.ts
 const productStatusSchema = z.enum([
 	"SALE",
@@ -2912,4 +2926,4 @@ function createStoreSession(options) {
 	};
 }
 //#endregion
-export { ApiError, MAX_ANALYTICS_ALLOWED_ORIGINS, MAX_OPTION_GROUPS, MAX_VALUES_PER_GROUP, MAX_VARIANTS, PAYMENT_ROUTING_EXCLUSION_CODES, PORTONE_CHANNEL_NAME_MAX_LENGTH, PORTONE_MAX_CHANNELS, PORTONE_MIN_CHANNELS, RESERVED_STORE_CODES, STORE_CODE_PATTERN, STORE_ROLE_SCOPES, STORE_SCOPE_RESOURCES, STORE_SESSION_KEYS, TOSS_WIDGET_CLIENT_KEY_PATTERN, TOSS_WIDGET_KEY_MESSAGE, TOSS_WIDGET_SECRET_KEY_PATTERN, VARIANT_STOCK_EXCLUSIVE_MESSAGE, WEBHOOK_DEFAULT_TOLERANCE_SEC, WEBHOOK_DELIVERY_ID_HEADER, WEBHOOK_EVENT_ID_HEADER, WEBHOOK_EVENT_TYPE_HEADER, WEBHOOK_HEADERS, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_USER_AGENT, addressChangeRequestListSchema, addressTypeSchema, analyticsChannelSchema, analyticsCheckoutOutcomeSchema, analyticsCheckoutSchema, analyticsDeviceRowSchema, analyticsDevicesSchema, analyticsFunnelStepSchema, analyticsOriginSchema, analyticsOverviewSchema, analyticsPagesQuerySchema, analyticsPagesSchema, analyticsProductRowSchema, analyticsProductSortSchema, analyticsProductsQuerySchema, analyticsProductsSchema, analyticsRangeQuerySchema, analyticsRealtimeSchema, analyticsSearchQuerySchema, analyticsSearchSchema, analyticsSourceGroupBySchema, analyticsSourceRowSchema, analyticsSourcesQuerySchema, analyticsSourcesSchema, analyticsTotalsSchema, apiClientListQuerySchema, apiClientSchema, apiClientSecretRotatedSchema, apiClientStatusSchema, apiClientTypeSchema, apiLogErrorSchema, apiLogListQuerySchema, apiLogPageSchema, apiLogPrincipalSchema, apiLogPrincipalTypeSchema, apiLogSchema, apiLogStatusFilterSchema, apiLogSummarySchema, apiTokenCreateRequestSchema, apiTokenCreatedSchema, apiTokenSchema, approveClaimResultSchema, buildAuthorizeUrl, buildQuery, bulkResultSchema, cancelBySellerRequestSchema, cancelBySellerResultSchema, carrierSchema, categoryAttributeSchema, categoryCreateRequestSchema, categoryDeleteQuerySchema, categoryDeleteStrategySchema, categoryListQuerySchema, categoryPatchRequestSchema, categoryProductSortSchema, categorySchema, categorySearchResultSchema, categoryTreeNodeSchema, categoryWithPathSchema, changeTypeSchema, claimDetailSchema, claimHoldResultSchema, claimListQuerySchema, claimReasonSchema, claimSchema, claimStatusSchema, claimTypeSchema, claimWebhookEventDataSchema, claimWebhookEventSchema, clientCredentialsTokenResponseSchema, createPkcePair, createStoreClient, createStoreSession, customerAddressSchema, customerDetailSchema, customerInquiryCategorySchema, customerInquiryListQuerySchema, customerListQuerySchema, customerOrderSchema, customerSortSchema, customerStatsSchema, customerSummarySchema, customerWithdrawalBlockedDetailsSchema, deliveryInfoSchema, deliveryMethodSchema, deliveryStatusSchema, deliveryTypeSchema, discountRequestSchema, discountSchema, dispatchRequestSchema, effectivePaymentRoutingModeSchema, eventTypeSchema, exchangeAuthorizationCode, exchangeStoreTokenViaOAuth, holdOrderItemRequestSchema, inquiryListQuerySchema, inquirySchema, inquiryWebhookEventDataSchema, inquiryWebhookEventSchema, invitationListQuerySchema, invitationSchema, isReservedStoreCode, isStoreScope, isWebOrigin, liveGateConditionCodeSchema, liveGateConditionSchema, liveGateErrorDetailsSchema, liveGateSchema, loginProviderSchema, loginProviderStatusSchema, loginProviderTestSchema, loginSettingsSchema, maskedSecretSchema, myAccountSchema, myStoreSchema, oauthClientRegistrationRequestSchema, oauthClientRegistrationResponseSchema, oauthTokenResponseSchema, optionGroupRequestSchema, optionGroupSchema, optionModelRequestSchema, optionModelSchema, optionValueRequestSchema, optionValueSchema, orderItemListQuerySchema, orderItemMemoResultSchema, orderItemPageSchema, orderItemSchema, orderItemStatusSchema, orderListQuerySchema, orderSchema, orderSummaryPageSchema, orderSummarySchema, orderWebhookEventDataSchema, orderWebhookEventSchema, pageInfoSchema, pageQueryShape, pageSchema, paymentAttemptRecordSchema, paymentAttemptStatusSchema, paymentCredentialSetSchema, paymentListQuerySchema, paymentProviderSchema, paymentProviderVerificationSchema, paymentRecordDetailSchema, paymentRecordPageSchema, paymentRecordSchema, paymentRecordStatusSchema, paymentRefundRecordSchema, paymentRoutingModeSchema, paymentSettingsSchema, pgEnvironmentSchema, pgPaymentMethodSchema, pgProviderSchema, pgVerificationResultSchema, portOneChannelSchema, portOneCredentialsInputSchema, productCreateRequestSchema, productImageUploadResultSchema, productListQuerySchema, productOutOfStockWebhookEventDataSchema, productOutOfStockWebhookEventSchema, productPatchRequestSchema, productSchema, productSortSchema, productStatusSchema, productSummarySchema, productVariantRequestSchema, productVariantSchema, purchaseDecisionExtendResultSchema, purchaseDecisionRequestResultSchema, refreshUserToken, rejectClaimRequestSchema, reviewListQuerySchema, reviewReportResultSchema, reviewSchema, reviewSortSchema, reviewWebhookEventDataSchema, reviewWebhookEventSchema, salesReportGroupBySchema, salesReportQuerySchema, salesReportRowSchema, salesReportSchema, salesTotalsSchema, saveLoginProviderRequestSchema, scopeAccessSchema, sellerAddressListQuerySchema, sellerAddressRequestSchema, sellerAddressSchema, sellerCustomerInquirySchema, settlementDetailQuerySchema, settlementDetailSchema, settlementListQuerySchema, settlementStatusSchema, settlementSummarySchema, settlementWithDetailsSchema, shippingAddressSchema, storeCodeSchema, storeMemberRoleUpdatedSchema, storeMemberSchema, storeRoleSchema, storeSchema, storeScopeResourceSchema, storeTokenResponseSchema, tossPaymentsCredentialsInputSchema, trackingUpdateResultSchema, updateLoginProviderRequestSchema, updateLoginSettingsRequestSchema, updatePaymentProviderRequestSchema, updatePaymentSettingsRequestSchema, updateStoreRequestSchema, uploadRequestSchema, uploadTicketSchema, upsertPortOneProviderRequestSchema, upsertTossPaymentsProviderRequestSchema, userTokenResponseSchema, variantStockRequestSchema, variantStockSchema, verifyPaymentProviderRequestSchema, webhookCreatedSchema, webhookDeliveryErrorCodeSchema, webhookDeliveryListQuerySchema, webhookDeliverySchema, webhookDeliveryStatusSchema, webhookEventSchema, webhookRedeliverFailedResultSchema, webhookRequestSchema, webhookSchema, webhookSecretRotatedSchema, webhookStatusSchema, webhookTestRequestSchema, webhookTestResultSchema, withdrawCustomerRequestSchema };
+export { ApiError, MAX_ANALYTICS_ALLOWED_ORIGINS, MAX_OPTION_GROUPS, MAX_VALUES_PER_GROUP, MAX_VARIANTS, PAYMENT_ROUTING_EXCLUSION_CODES, PORTONE_CHANNEL_NAME_MAX_LENGTH, PORTONE_MAX_CHANNELS, PORTONE_MIN_CHANNELS, RESERVED_STORE_CODES, STORE_CODE_PATTERN, STORE_ROLE_SCOPES, STORE_SCOPE_RESOURCES, STORE_SESSION_KEYS, TOSS_WIDGET_CLIENT_KEY_PATTERN, TOSS_WIDGET_KEY_MESSAGE, TOSS_WIDGET_SECRET_KEY_PATTERN, VARIANT_STOCK_EXCLUSIVE_MESSAGE, WEBHOOK_DEFAULT_TOLERANCE_SEC, WEBHOOK_DELIVERY_ID_HEADER, WEBHOOK_EVENT_ID_HEADER, WEBHOOK_EVENT_TYPE_HEADER, WEBHOOK_HEADERS, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_USER_AGENT, addressChangeRequestListSchema, addressTypeSchema, analyticsChannelSchema, analyticsCheckoutOutcomeSchema, analyticsCheckoutSchema, analyticsDeviceRowSchema, analyticsDevicesSchema, analyticsFunnelStepSchema, analyticsOriginSchema, analyticsOverviewSchema, analyticsPagesQuerySchema, analyticsPagesSchema, analyticsProductRowSchema, analyticsProductSortSchema, analyticsProductsQuerySchema, analyticsProductsSchema, analyticsRangeQuerySchema, analyticsRealtimeSchema, analyticsSearchQuerySchema, analyticsSearchSchema, analyticsSourceGroupBySchema, analyticsSourceRowSchema, analyticsSourcesQuerySchema, analyticsSourcesSchema, analyticsTotalsSchema, apiClientListQuerySchema, apiClientSchema, apiClientSecretRotatedSchema, apiClientStatusSchema, apiClientTypeSchema, apiLogErrorSchema, apiLogListQuerySchema, apiLogPageSchema, apiLogPrincipalSchema, apiLogPrincipalTypeSchema, apiLogSchema, apiLogStatusFilterSchema, apiLogSummarySchema, apiTokenCreateRequestSchema, apiTokenCreatedSchema, apiTokenSchema, approveClaimResultSchema, buildAuthorizeUrl, buildQuery, bulkResultSchema, cancelBySellerRequestSchema, cancelBySellerResultSchema, carrierSchema, categoryAttributeSchema, categoryCreateRequestSchema, categoryDeleteQuerySchema, categoryDeleteStrategySchema, categoryListQuerySchema, categoryPatchRequestSchema, categoryProductSortSchema, categorySchema, categorySearchResultSchema, categoryTreeNodeSchema, categoryWithPathSchema, changeTypeSchema, claimDetailSchema, claimHoldResultSchema, claimListQuerySchema, claimReasonSchema, claimSchema, claimStatusSchema, claimTypeSchema, claimWebhookEventDataSchema, claimWebhookEventSchema, clientCredentialsTokenResponseSchema, createPkcePair, createStoreClient, createStoreSession, customerAddressSchema, customerDetailSchema, customerInquiryCategorySchema, customerInquiryListQuerySchema, customerListQuerySchema, customerOrderSchema, customerSortSchema, customerStatsSchema, customerSummarySchema, customerWithdrawalBlockedDetailsSchema, deliveryInfoSchema, deliveryMethodSchema, deliveryStatusSchema, deliveryTypeSchema, discountRequestSchema, discountSchema, dispatchRequestSchema, easyPayProviderResponseSchema, easyPayProviderSchema, eventTypeSchema, exchangeAuthorizationCode, exchangeStoreTokenViaOAuth, holdOrderItemRequestSchema, inquiryListQuerySchema, inquirySchema, inquiryWebhookEventDataSchema, inquiryWebhookEventSchema, invitationListQuerySchema, invitationSchema, isReservedStoreCode, isStoreScope, isWebOrigin, liveGateConditionCodeSchema, liveGateConditionSchema, liveGateErrorDetailsSchema, liveGateSchema, loginProviderSchema, loginProviderStatusSchema, loginProviderTestSchema, loginSettingsSchema, maskedSecretSchema, myAccountSchema, myStoreSchema, oauthClientRegistrationRequestSchema, oauthClientRegistrationResponseSchema, oauthTokenResponseSchema, optionGroupRequestSchema, optionGroupSchema, optionModelRequestSchema, optionModelSchema, optionValueRequestSchema, optionValueSchema, orderItemListQuerySchema, orderItemMemoResultSchema, orderItemPageSchema, orderItemSchema, orderItemStatusSchema, orderListQuerySchema, orderSchema, orderSummaryPageSchema, orderSummarySchema, orderWebhookEventDataSchema, orderWebhookEventSchema, pageInfoSchema, pageQueryShape, pageSchema, paymentAttemptRecordSchema, paymentAttemptStatusSchema, paymentCredentialSetSchema, paymentListQuerySchema, paymentProviderSchema, paymentProviderVerificationSchema, paymentRecordDetailSchema, paymentRecordPageSchema, paymentRecordSchema, paymentRecordStatusSchema, paymentRefundRecordSchema, paymentSettingsSchema, pgEnvironmentSchema, pgPaymentMethodSchema, pgProviderSchema, pgVerificationResultSchema, portOneChannelSchema, portOneCredentialsInputSchema, productCreateRequestSchema, productImageUploadResultSchema, productListQuerySchema, productOutOfStockWebhookEventDataSchema, productOutOfStockWebhookEventSchema, productPatchRequestSchema, productSchema, productSortSchema, productStatusSchema, productSummarySchema, productVariantRequestSchema, productVariantSchema, purchaseDecisionExtendResultSchema, purchaseDecisionRequestResultSchema, refreshUserToken, rejectClaimRequestSchema, reviewListQuerySchema, reviewReportResultSchema, reviewSchema, reviewSortSchema, reviewWebhookEventDataSchema, reviewWebhookEventSchema, salesReportGroupBySchema, salesReportQuerySchema, salesReportRowSchema, salesReportSchema, salesTotalsSchema, saveLoginProviderRequestSchema, scopeAccessSchema, sellerAddressListQuerySchema, sellerAddressRequestSchema, sellerAddressSchema, sellerCustomerInquirySchema, settlementDetailQuerySchema, settlementDetailSchema, settlementListQuerySchema, settlementStatusSchema, settlementSummarySchema, settlementWithDetailsSchema, shippingAddressSchema, storeCodeSchema, storeMemberRoleUpdatedSchema, storeMemberSchema, storeRoleSchema, storeSchema, storeScopeResourceSchema, storeTokenResponseSchema, tossPaymentsCredentialsInputSchema, trackingUpdateResultSchema, updateLoginProviderRequestSchema, updateLoginSettingsRequestSchema, updatePaymentProviderRequestSchema, updatePaymentSettingsRequestSchema, updateStoreRequestSchema, uploadRequestSchema, uploadTicketSchema, upsertPortOneProviderRequestSchema, upsertTossPaymentsProviderRequestSchema, userTokenResponseSchema, variantStockRequestSchema, variantStockSchema, verifyPaymentProviderRequestSchema, webhookCreatedSchema, webhookDeliveryErrorCodeSchema, webhookDeliveryListQuerySchema, webhookDeliverySchema, webhookDeliveryStatusSchema, webhookEventSchema, webhookRedeliverFailedResultSchema, webhookRequestSchema, webhookSchema, webhookSecretRotatedSchema, webhookStatusSchema, webhookTestRequestSchema, webhookTestResultSchema, withdrawCustomerRequestSchema };

package/package.json

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

package/src/schemas/order.ts

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { changeTypeSchema, orderItemStatusSchema, type PageParams, pageSchema } from "./common";
+import { easyPayProviderResponseSchema } from "./payment";
 
 export const orderSummarySchema = z.object({
   orderId: z.string(),
@@ -84,6 +85,15 @@ export const orderSchema = z.object({
           "매출 리포트·스토어프론트·환불 원장과 같은 값이다. 값이 추가될 수 있어 문자열로 받는다. PG가 알려 주지 않았으면 요청 수단, " +
           "시도 기록이 없는 오래된 주문은 null. 서버는 항상 싣는다",
       ),
+    easyPayProvider: easyPayProviderResponseSchema
+      .nullable()
+      .optional()
+      .default(null)
+      .describe(
+        "승인된 간편결제사. `approvedMethod`가 `EASY_PAY`일 때만 값이 있고, PG가 알려 주지 않았으면 요청한 간편결제사다. " +
+          "그 밖의 결제수단과 간편결제 이전 주문은 null. 서버는 항상 싣는다. " +
+          "현재 값은 `NAVERPAY`·`KAKAOPAY`·`TOSSPAY`·`PAYCO`이고 값이 추가될 수 있어 문자열로 받는다",
+      ),
     productAmount: z.number().int(),
     deliveryFee: z.number().int(),
     discountAmount: z.number().int(),

package/src/schemas/payment.ts

@@ -19,20 +19,19 @@ export const pgPaymentMethodSchema = z
   .describe("결제수단 (스토어프론트 결제 요청의 `paymentMethod`와 같은 값)");
 export type PgPaymentMethod = z.infer<typeof pgPaymentMethodSchema>;
 
-export const paymentRoutingModeSchema = z
-  .enum(["PRIORITY_DISPLAY", "AUTO_FAILOVER"])
-  .describe(
-    "PG가 둘 이상 사용 중일 때의 라우팅 방식. `PRIORITY_DISPLAY`=결제창에 사용 중인 PG를 모두 보여 주고 1순위를 기본 선택, " +
-      "`AUTO_FAILOVER`=1순위로 결제창을 열고, 결제창을 띄우기 전 장애(PG 준비 실패)일 때만 다음 순위로 자동 전환",
-  );
-export type PaymentRoutingMode = z.infer<typeof paymentRoutingModeSchema>;
+/**
+ * 간편결제사 — 결제 옵션(스토어프론트 `paymentOptions`)과 PG 설정의 `easyPayProviders`에 쓴다.
+ * `@sayren/storefront-sdk`의 `easyPayProviderSchema`와 같은 값이다(api 계약 테스트가 고정한다)
+ */
+export const easyPayProviderSchema = z.enum(["NAVERPAY", "KAKAOPAY", "TOSSPAY", "PAYCO"]);
+export type EasyPayProvider = z.infer<typeof easyPayProviderSchema>;
 
-export const effectivePaymentRoutingModeSchema = z
-  .enum(["NONE", "SINGLE", "PRIORITY_DISPLAY", "AUTO_FAILOVER"])
-  .describe(
-    "실제로 적용되는 라우팅. 사용 중인 PG가 0개면 `NONE`(결제 불가), 1개면 `SINGLE`, 2개 이상이면 `routingMode` 값",
-  );
-export type EffectivePaymentRoutingMode = z.infer<typeof effectivePaymentRoutingModeSchema>;
+/**
+ * 응답에 실리는 간편결제사 — 서버가 간편결제사를 추가해도 파싱이 깨지지 않게 문자열로 받는다
+ * (`pgProvider`·결제수단과 같은 방식). 요청(`easyPayProviders`)은 값을 골라 보내는 자리라 enum 그대로다.
+ * 현재 값은 `NAVERPAY`·`KAKAOPAY`·`TOSSPAY`·`PAYCO`이고 화면은 모르는 값을 원문 그대로 보여 준다.
+ */
+export const easyPayProviderResponseSchema = z.string();
 
 export const pgEnvironmentSchema = z
   .enum(["TEST", "LIVE"])
@@ -174,10 +173,22 @@ export const updatePaymentProviderRequestSchema = z
         "샌드박스 스위치. `true`면 새 결제에 TEST 세트를 쓴다(항상 허용). `false`(라이브 전환)는 라이브 개방 조건을 " +
           "모두 충족해야 한다(`LIVE_GATE_NOT_MET`)",
       ),
+    easyPayProviders: z
+      .array(easyPayProviderSchema)
+      .max(easyPayProviderSchema.options.length)
+      .optional()
+      .describe(
+        "이 PG로 받는 간편결제사 — 통째로 바꾼다. PG 계약(포트원은 채널)에 추가한 간편결제만 켠다. " +
+          "켠 간편결제사마다 스토어프론트 결제 옵션이 하나씩 생긴다(포트원은 간편결제를 받는 채널이 있어야 한다)",
+      ),
   })
-  .refine((body) => body.enabled !== undefined || body.sandboxMode !== undefined, {
-    message: "enabled 또는 sandboxMode 중 하나는 보내야 해요",
-  });
+  .refine(
+    (body) =>
+      body.enabled !== undefined ||
+      body.sandboxMode !== undefined ||
+      body.easyPayProviders !== undefined,
+    { message: "enabled·sandboxMode·easyPayProviders 중 하나는 보내야 해요" },
+  );
 export type UpdatePaymentProviderRequest = z.infer<typeof updatePaymentProviderRequestSchema>;
 
 export const verifyPaymentProviderRequestSchema = z.object({
@@ -187,18 +198,31 @@ export const verifyPaymentProviderRequestSchema = z.object({
 });
 export type VerifyPaymentProviderRequest = z.infer<typeof verifyPaymentProviderRequestSchema>;
 
-export const updatePaymentSettingsRequestSchema = z.object({
-  routingMode: paymentRoutingModeSchema,
-  priority: z
-    .array(pgProviderSchema)
-    .min(1)
-    // PG 개수와 무관한 안전장치 — 거대한 배열이 파싱을 거치지 않게만 막는다. 실제 개수는 서버가 본다
-    .max(50)
-    .describe(
-      "PG 우선순위(앞이 1순위). 연결된 PG 수만큼 **모두 한 번씩** 나열한다(길이 상한 50은 안전장치다). " +
-        "빠지거나 중복되거나 연결되지 않은 PG가 있으면 `INVALID_PRIORITY`",
-    ),
-});
+export const updatePaymentSettingsRequestSchema = z
+  .object({
+    priority: z
+      .array(pgProviderSchema)
+      .min(1)
+      // PG 개수와 무관한 안전장치 — 거대한 배열이 파싱을 거치지 않게만 막는다. 실제 개수는 서버가 본다
+      .max(50)
+      .optional()
+      .describe(
+        "PG 우선순위(앞이 1순위) — 스토어프론트 결제 옵션 목록의 PG 순서다. 연결된 PG 수만큼 **모두 한 번씩** 나열한다" +
+          "(길이 상한 50은 안전장치다). 빠지거나 중복되거나 연결되지 않은 PG가 있으면 `INVALID_PRIORITY`",
+      ),
+    checkoutOrigins: z
+      .array(z.string().max(200))
+      .max(20)
+      .optional()
+      .describe(
+        "결제 도메인 — 통째로 바꾼다. 결제를 마친 구매자가 돌아올 스토어프론트 origin(`https://shop.example.com`, https·경로 없음). " +
+          "결제 시작의 `returnUrl`은 이 목록 안이어야 한다. 비어 있으면 실결제를 시작할 수 없다(테스트 결제는 localhost 허용). " +
+          "같은 도메인을 PG 가맹 정보에도 등록한다. 형식이 틀리면 `INVALID_CHECKOUT_ORIGIN`",
+      ),
+  })
+  .refine((body) => body.priority !== undefined || body.checkoutOrigins !== undefined, {
+    message: "priority 또는 checkoutOrigins 중 하나는 보내야 해요",
+  });
 export type UpdatePaymentSettingsRequest = z.infer<typeof updatePaymentSettingsRequestSchema>;
 
 // ─── 조회 응답 ─────────────────────────────────────────────
@@ -318,6 +342,12 @@ export const paymentProviderSchema = z.object({
     })
     .describe("환경별 자격 증명 세트. 등록되지 않은 세트는 null"),
   liveGate: liveGateSchema.describe("라이브 개방 조건. 조건을 모두 충족해야 샌드박스를 끌 수 있다"),
+  easyPayProviders: z
+    .array(easyPayProviderResponseSchema)
+    .describe(
+      "이 PG로 받는 간편결제사. 연결되지 않았으면 빈 목록. " +
+        "현재 값은 `NAVERPAY`·`KAKAOPAY`·`TOSSPAY`·`PAYCO`이고 값이 추가될 수 있어 문자열로 받는다",
+    ),
   retiredCredentialCount: z
     .number()
     .int()
@@ -356,10 +386,9 @@ export const PAYMENT_ROUTING_EXCLUSION_CODES = [
 export type KnownPaymentRoutingExclusion = (typeof PAYMENT_ROUTING_EXCLUSION_CODES)[number];
 
 export const paymentSettingsSchema = z.object({
-  routingMode: paymentRoutingModeSchema.describe(
-    "저장된 라우팅 방식 (기본 `AUTO_FAILOVER`). PG가 하나뿐이면 무시된다",
-  ),
-  effectiveRoutingMode: effectivePaymentRoutingModeSchema,
+  checkoutOrigins: z
+    .array(z.string())
+    .describe("결제 도메인 — 결제를 마친 구매자가 돌아올 스토어프론트 origin 목록"),
   providers: z
     .array(paymentProviderSchema)
     .describe("지원하는 모든 PG. 연결된 것은 우선순위순, 연결되지 않은 것은 뒤에 온다"),
@@ -495,6 +524,15 @@ export const paymentRecordSchema = z.object({
   refundedAmount: z.number().int().describe("환불 완료 금액 합계. 실패한 환불은 빼고 센다"),
   provider: pgProviderSchema.nullable().describe("승인한 PG. 승인 전에 끝났으면 마지막 시도의 PG"),
   method: pgPaymentMethodSchema.nullable().describe("실제 결제수단. 모르면 요청 수단"),
+  easyPayProvider: easyPayProviderResponseSchema
+    .nullable()
+    .optional()
+    .default(null)
+    .describe(
+      "간편결제사. `method`가 `EASY_PAY`일 때만 값이 있고, PG가 알려 주지 않았으면 요청한 간편결제사다. " +
+        "그 밖의 결제수단과 간편결제 이전 결제는 null. 서버는 항상 싣는다. " +
+        "현재 값은 `NAVERPAY`·`KAKAOPAY`·`TOSSPAY`·`PAYCO`이고 값이 추가될 수 있어 문자열로 받는다",
+    ),
   environment: pgEnvironmentSchema.nullable().describe("결제 환경"),
   testPayment: z.boolean().describe("샌드박스 결제인가"),
   pgTransactionId: z.string().nullable().describe("PG 거래 id (토스 paymentKey, 포트원 txId)"),
@@ -516,7 +554,21 @@ export const paymentAttemptRecordSchema = z.object({
   provider: pgProviderSchema,
   status: paymentAttemptStatusSchema,
   method: pgPaymentMethodSchema.describe("주문서에서 고른 결제수단"),
+  easyPayProvider: easyPayProviderResponseSchema
+    .nullable()
+    .optional()
+    .default(null)
+    .describe(
+      "주문서에서 고른 간편결제사. 간편결제가 아니면 null. 서버는 항상 싣는다(값이 추가될 수 있어 문자열)",
+    ),
   approvedMethod: pgPaymentMethodSchema.nullable().describe("PG가 보고한 실제 결제수단"),
+  approvedEasyPayProvider: easyPayProviderResponseSchema
+    .nullable()
+    .optional()
+    .default(null)
+    .describe(
+      "PG가 보고한 실제 간편결제사. 모르거나 간편결제가 아니면 null. 서버는 항상 싣는다(값이 추가될 수 있어 문자열)",
+    ),
   amount: z.number().int(),
   environment: pgEnvironmentSchema,
   pgTransactionId: z.string().nullable(),