v1.78.0 (February 2, 2026)

Communication preferences with push notifications, custom fields for checkout sessions, and expanded checkout language support

​

새로운 기능

​

1. 커뮤니케이션 환경설정

개편된 커뮤니케이션 환경설정을 통해 알림 수신 방식을 직접 관리하세요. 이메일, 푸시, 인앱 알림을 워크플로에 맞게 구성할 수 있습니다.

주요 기능

• 개편된 이메일 디자인: 명확한 CTA와 향상된 가독성을 갖춘 새롭고 현대적인 이메일 템플릿
• 푸시 알림: 신규 판매, 분쟁, 정산 등 주요 이벤트에 대해 모바일 기기에서 즉시 알림을 받으세요
• 세분화된 제어: 어떤 이벤트가 어떤 채널을 통해 알림을 전송할지 정확히 선택하세요
• 다중 이메일 지원: 알림을 받을 이메일 주소를 여러 개 추가하세요
• 고객 이메일 환경설정: 고객이 받을 이메일을 구성하세요

알림 카테고리

카테고리	설명
판매 및 결제 (Sales & Payments)	신규 판매, 성공적인 결제, 실패한 결제
정산 및 환불 (Payouts & Refunds)	정산 완료, 환불 요청, 환불 완료
구독 (Subscriptions)	신규 구독, 갱신, 취소, 요금제 변경
분쟁 (Disputes)	분쟁 발생, 증거 필요, 분쟁 해결

결과: 원하는 시간과 방식으로 알림을 받아 비즈니스 정보를 계속 파악하세요.

자세히 알아보기: 커뮤니케이션 환경설정 가이드

​

2. 체크아웃 세션의 커스텀 필드

커스텀 필드를 통해 체크아웃 중 고객으로부터 추가 정보를 수집하세요. 텍스트 입력, 드롭다운, 날짜 등 필요한 데이터를 수집할 수 있습니다.

지원되는 필드 유형

유형	설명	사용 사례
text	단일 행 텍스트 입력	회사명, 주문 메모
number	숫자 입력	수량, 나이
email	유효성 검사를 포함한 이메일 입력	청구 연락처 이메일
url	유효성 검사 포함 URL 입력	웹사이트, 소셜 프로필
date	날짜 선택기	배송 날짜, 이벤트 날짜
dropdown	사전 정의된 옵션 선택	사이즈, 색상, 요금제 유형
boolean	예/아니오 값을 위한 체크박스	약관 동의, 뉴스레터 수신 동의

작동 방식

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  custom_fields: [
    {
      name: 'company_name',
      label: 'Company Name',
      type: 'text',
      required: true
    },
    {
      name: 'team_size',
      label: 'Team Size',
      type: 'dropdown',
      options: ['1-10', '11-50', '51-200', '200+'],
      required: true
    },
    {
      name: 'newsletter',
      label: 'Subscribe to our newsletter',
      type: 'boolean',
      required: false
    }
  ],
  return_url: 'https://yoursite.com/success'
});

혜택

• 유연한 데이터 수집: 이행 또는 개인화에 필요한 모든 정보를 수집하세요
• 내장된 유효성 검사: 이메일 및 URL 필드는 입력 형식을 자동으로 검증합니다
• 필수/선택 제어: 필요에 따라 필드를 필수 또는 선택으로 지정하세요
• 웹훅 전달: 커스텀 필드 값이 결제 웹훅 이벤트에 포함됩니다

커스텀 필드 값은 결제 및 체크아웃 세션 응답 내 custom_fields 객체에 반환됩니다.

자세히 알아보기: 체크아웃 세션 커스텀 필드

​

3. 확장된 체크아웃 언어 지원

체크아웃 페이지가 기존 16개에서 21개 언어를 지원합니다. 고객이 사용하는 모국어로 더 나은 체크아웃 경험을 제공하세요.

추가된 새로운 언어

언어	코드
한국어	ko
말레이어	ms
루마니아어	ro
러시아어	ru
태국어	th

지원되는 모든 언어

아랍어, 중국어, 네덜란드어, 영어, 프랑스어, 독일어, 힌디어, 인도네시아어, 이탈리아어, 일본어, 한국어, 말레이어, 포르투갈어, 루마니아어, 러시아어, 스페인어, 스웨덴어, 태국어, 터키어, 우크라이나어, 베트남어.

특정 언어 강제 설정

자동 언어 감지를 재정의하려면 force_language 매개변수를 사용하세요:

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  force_language: 'ko', // Force Korean language
  return_url: 'https://yoursite.com/success'
});

기본적으로 체크아웃 페이지는 고객의 브라우저 설정에서 선호하는 언어를 자동으로 감지합니다. 웹사이트 언어와 일관성을 유지하려면 force_language를 사용하세요.

자세히 알아보기: 체크아웃 언어 지원

​

4. 일반 버그 수정 및 개선사항

이번 릴리스에는 성능 향상, UI 다듬기, 소규모 버그 해결이 포함되어 더 안정적이고 간소화된 경험을 제공합니다.