글로벌 오더 패치 노트

​

2025년 6월 26일 업데이트 공지

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

​

주요 변경사항

1. 옵션 시스템 재설계

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

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

2. 수량 제어 기능 추가

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

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

3. 데이터 구조 개선

• CartProduct에 quantity 필드 추가로 상품별 수량 관리

• selectedOptions가 새로운 SelectedOptionGroup[] 타입으로 변경

• 옵션이 없는 상품은 빈 배열([])로 처리

​

업그레이드 가이드

기존 구조 (v1.1.5 이하)

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

새로운 구조 (v1.1.6)

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 문서 확인하기

​

2025년 4월 18일 업데이트 공지

​

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

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

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

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

업데이트된 SDK 문서 확인하기

​

2025년 3월 27일 업데이트 공지

​

ProductRequest에 sellerClientKey 필드 추가

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

업데이트된 SDK 문서 확인하기

​

2025년 2월 12일 업데이트 공지

​

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

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

업데이트된 SDK 문서 확인하기