> ## Documentation Index
> Fetch the complete documentation index at: https://developers-partners.delivered.co.kr/llms.txt
> Use this file to discover all available pages before exploring further.

# 글로벌체크아웃 패치 노트

> 글로벌체크아웃과 관련된 업데이트 내역을 알려드려요

<Update label="2025-11-17" description="v1.2.5">
  ## **2025년 11월 17일 업데이트 공지**

  ### **글로벌체크아웃 주문 정보 조회 open API 응답값의 지불 수단에 값 추가**

  **1. response의 `payment.paymentMethod`에 Alipay Payment Service 값 `ALIPAY`, `ALIPAYHK`, `BILLEASE`, `BOOST`, `BPI`, `DANA`, `GCASH`, `RABBIT_LINE_PAY`, `TOUCHNGO`, `TRUEMONEY` 추가**

  [**업데이트된 API 문서 확인하기**](https://deliveredkorea.mintlify.app/reference/global-checkout/api/orders)
</Update>

<Update label="2025-10-16" description="v1.2.4">
  ## **2025년 10월 16일 업데이트 공지**

  ### **글로벌체크아웃 주문 정보 조회 open API 스펙 변경**

  **1. request parameter에 orderNumber 추가**

  * orderKey, orderNumber 중 1개 이상 입력 필수입니다.

  **2. response의 payment에 관부가세 합계 금액 `totalDutyVatAmountKrw`, `totalDutyVatAmountUsd` 추가**

  [**업데이트된 API 문서 확인하기**](https://deliveredkorea.mintlify.app/reference/global-checkout/api/orders)
</Update>

<Update label="2025-09-18" description="v1.2.3">
  ## **2025년 9월 18일 업데이트 공지**

  ### **글로벌체크아웃 주문 정보 조회 open API 추가**

  글로벌체크아웃의 주문 정보를 orderKey로 조회할 수 있는 open API가 추가되었습니다.

  [**업데이트된 API 문서 확인하기**](https://deliveredkorea.mintlify.app/reference/global-checkout/api/orders)
</Update>

<Update label="2025-08-28" description="v1.2.2">
  ## **2025년 8월 28일 업데이트 공지**

  **상품 고유값 property 추가**

  ### **주요 변경사항**

  **1. request에서 판매사의 상품 고유값을 글로벌체크아웃에 전달하는 property 추가**

  ```typescript theme={null}
  interface ProductRequest {
    sellerClientKey: string;
    title: string;
    prices: PricesByCurrency;
    originalPrices?: PricesByCurrency;
    discountRate: number;
    originUrl: string;
    images: string[];
    options: OptionGroupT[];
    quantityControl: QuantityControlT;
    sellerProductId?: string;
  }
  ```

  [**업데이트된 SDK 문서 확인하기**](https://deliveredkorea.mintlify.app/reference/global-checkout/connecting#param-seller-product-id)

  **2. iframe의 카트 페이지에서 상품 삭제 시 부모 창에 상품 삭제 메세지 전달 기능 추가**

  * 상품 삭제 시 부모 창에서 sellerProductId를 받는 기능이 추가되었습니다.

  ```typescript theme={null}
    const eventListener = (e: MessageEvent<any>) => {
      const { type, payload } = e.data;

      if (type === "dk-global-order-delete-product") {
        // {type: 'dk-global-order-delete-product', payload: '1'} 형태로 전달됩니다.
      }
    };
  ```

  [**업데이트된 SDK 문서 확인하기**](https://deliveredkorea.mintlify.app/guide/global-checkout/integration-service/how-to-use#2-3-%EC%95%84%EC%9D%B4%ED%94%84%EB%A0%88%EC%9E%84-%EB%B0%A9%EC%8B%9D-iframe-%EC%BB%B4%ED%8F%AC%EB%84%8C%ED%8A%B8-%EC%BD%94%EB%93%9C)
</Update>

<Update label="2025-06-26" description="v1.1.6">
  ## **2025년 6월 26일 업데이트 공지**

  **옵션 시스템 전면 개편 및 수량 제어 기능 추가**

  <img src="https://mintcdn.com/deliveredkorea/qw6M9AVN3AeRpr_q/images/20250626_go_update_2.png?fit=max&auto=format&n=qw6M9AVN3AeRpr_q&q=85&s=2aece3dc6042d4cc864de30f667083c0" alt="" width="4800" height="3000" data-path="images/20250626_go_update_2.png" />

  ### **주요 변경사항**

  **1. 옵션 시스템 재설계**

  * 기존의 단순한 옵션 구조에서 **그룹 기반 옵션 시스템**으로 전면 개편되었습니다.
  * **3가지 옵션 타입** 지원: `text` (텍스트 입력), `select` (선택형), `image` (이미지 업로드)
  * **필수/선택 옵션** 구분 가능

  ```typescript theme={null}
  // 새로운 옵션 구조
  interface OptionGroup {
    groupName: string; // 옵션 그룹명
    type: "text" | "select" | "image"; // 옵션 타입
    required: boolean; // 필수 옵션 여부
    options?: SelectTypeOption[]; // select 타입인 경우 필수
    extraPrice?: PricesByCurrency; // 추가 가격
  }
  ```

  **2. 수량 제어 기능 추가**

  * 상품별로 **수량 변경 허용 여부** 설정 가능
  * **최소/최대 수량 제한** 설정 가능

  ```typescript theme={null}
  interface QuantityControl {
    allowQuantityChange: boolean; // 수량 변경 허용 여부
    minQuantity?: number; // 최소 수량
    maxQuantity?: number; // 최대 수량
  }
  ```

  **3. 데이터 구조 개선**

  * `CartProduct`에 `quantity` 필드 추가로 상품별 수량 관리
  * `selectedOptions`가 새로운 `SelectedOptionGroup[]` 타입으로 변경
  * 옵션이 없는 상품은 빈 배열(`[]`)로 처리

  ### **업그레이드 가이드**

  **기존 구조 (v1.1.5 이하)**

  ```javascript theme={null}
  options: [
    { title: "색상: 흰색", prices: { krw: 0 } },
    { title: "색상: 검정", prices: { krw: 1000 } }
  ],
  selectedOptions: [
    { title: "색상: 흰색", quantity: 1 }
  ]
  ```

  **새로운 구조 (v1.1.6)**

  ```javascript theme={null}
  options: [
    {
      groupName: "색상",
      type: "select",
      required: true,
      options: [
        { label: "흰색", extraPrice: { krw: 0 } },
        { label: "검정", extraPrice: { krw: 1000 } }
      ]
    }
  ],
  selectedOptions: [
    { groupName: "색상", value: "흰색" }
  ],
  quantity: 1,
  quantityControl: {
    allowQuantityChange: true,
    minQuantity: 1,
    maxQuantity: 10
  }
  ```

  [**업데이트된 SDK 문서 확인하기**](https://developers-partners.delivered.co.kr/reference/sdk/connecting)
</Update>

<Update label="2025-04-18" description="v1.1.3">
  ## **2025년 4월 18일 업데이트 공지**

  ### **가격 정보 타입 업데이트 안내**

  상품 및 옵션 가격 정보 전달 시 새로운 `PricesByCurrency` 타입이 도입되었습니다.

  ```typescript theme={null}
  interface PricesByCurrency {
    krw: number; // 필수: 한국 원화 가격
    usd?: number; // 옵션: 미국 달러 가격
  }

  // 사용 예시 (ProductRequest 또는 OptionRequest 내)
  prices: { krw: number; usd?: number; }
  originalPrices?: { krw: number; usd?: number; } // 상품 할인 전 가격 (옵션)
  ```

  [**업데이트된 SDK 문서 확인하기**](https://developers-partners.delivered.co.kr/reference/sdk/connecting)
</Update>

<Update label="2025-03-19" description="v1.1.2">
  ## **2025년 3월 27일 업데이트 공지**

  ### **ProductRequest에 sellerClientKey 필드 추가**

  * ProductRequest 인터페이스에 판매자 클라이언트 키 (`sellerClientKey`) 필드가 새로운 필수값으로 추가되었습니다. `sellerClientKey`는 딜리버드 파트너스의 [API 키](https://partners.delivered.co.kr/service/api-key) 메뉴에서 확인할 수 있습니다.
  * `sellerSecretKey`의 사용은 더 이상 권장되지 않으며(deprecated), 향후 버전에서 제거될 예정입니다.
  * 하위 호환성을 위해 SDK 내부에서는 `sellerClientKey`가 없는 경우 `sellerSecretKey` 값을 사용합니다. 단, `sellerSecretKey`를 단독으로 사용하는 방법은 더 이상 권장되지 않습니다.
  * `sellerSecretKey`와 `sellerClientKey` 모두 없는 경우 에러가 발생합니다.

  [**업데이트된 SDK 문서 확인하기**](https://developers-partners.delivered.co.kr/reference/sdk/connecting)
</Update>

<Update label="2025-02-12" description="v1.1.0">
  ## **2025년 2월 12일 업데이트 공지**

  <img src="https://mintcdn.com/deliveredkorea/qw6M9AVN3AeRpr_q/images/20250212_go_update_1.png?fit=max&auto=format&n=qw6M9AVN3AeRpr_q&q=85&s=24f1fd89843aceef3eadb53a5c799fa1" alt="" width="436" height="219" data-path="images/20250212_go_update_1.png" />

  ### **`상품 정보에 할인율(discountRate) 및 상품원가(originalPrice) 필드 추가`**

  * `ProductRequest` 인터페이스에 `discountRate` 및 `originalPrice` 필드가 추가되었습니다.
  * 할인율이 0보다 큰 경우 `originalPrice`는 필수 입력값입니다.
  * 할인율이 0이면 `originalPrice`는 선택사항이며, 입력해도 적용되지 않습니다.

  [**업데이트된 SDK 문서 확인하기**](https://developers-partners.delivered.co.kr/reference/sdk/connecting)
</Update>