> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# v1.78.0 (February 2, 2026)

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

## 새로운 기능

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

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

<Frame>
  <img src="https://mintcdn.com/dodopayments/YvuokxDCslyAwOyr/images/communication-preferences/overview.png?fit=max&auto=format&n=YvuokxDCslyAwOyr&q=85&s=f600972c9d588b5427d250073bf15aac" alt="커뮤니케이션 환경 설정 개요가 알림 설정을 보여줌" style={{ maxHeight: '500px', width: 'auto' }} width="2848" height="1548" data-path="images/communication-preferences/overview.png" />
</Frame>

**주요 기능**

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

**알림 카테고리**

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

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

자세히 알아보기: [커뮤니케이션 환경설정 가이드](/features/communication-preferences)

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

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

**지원되는 필드 유형**

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

**작동 방식**

```typescript theme={null}
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 필드는 입력 형식을 자동으로 검증합니다
* **필수/선택 제어**: 필요에 따라 필드를 필수 또는 선택으로 지정하세요
* **웹훅 전달**: 커스텀 필드 값이 결제 웹훅 이벤트에 포함됩니다

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

자세히 알아보기: [체크아웃 세션 커스텀 필드](/developer-resources/checkout-session#custom-fields)

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

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

**추가된 새로운 언어**

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

**지원되는 모든 언어**

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

**특정 언어 강제 설정**

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

```typescript theme={null}
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'
});
```

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

자세히 알아보기: [체크아웃 언어 지원](/features/checkout#supported-languages)

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

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