> ## 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（2026年2月2日）

> 通信偏好设置支持推送通知、结账会话的自定义字段以及扩展的结账语言支持

## 新功能

### 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>

**主要功能**

* **焕然一新的电子邮件设计**：采用清晰号召性用语和更佳可读性的现代模板
* **推送通知**：在移动设备上即时接收新销售、纠纷和付款等关键事件的提醒
* **细化控制**：精确选择触发通知的事件以及使用的渠道
* **多邮件支持**：添加多个电子邮件地址以接收通知
* **客户邮件偏好**：配置客户将收到哪些电子邮件

**通知类别**

| 类别        | 描述             |
| --------- | -------------- |
| **销售与支付** | 新销售、支付成功、支付失败  |
| **付款与退款** | 付款完成、退款请求、退款完成 |
| **订阅**    | 新订阅、续订、取消、方案变更 |
| **纠纷**    | 发起纠纷、需要证据、纠纷解决 |

<Check>
  结果：以您希望的方式和时间接收通知，实时掌握业务动态。
</Check>

了解详情：[沟通偏好设置指南](/features/communication-preferences)

### 2. **结账会话中的自定义字段**

在结账过程中通过自定义字段收集客户的附加信息。添加文本输入、下拉菜单、日期等字段，以获取所需数据。

**支持的字段类型**

| 类型         | 描述         | 应用场景       |
| ---------- | ---------- | ---------- |
| `text`     | 单行文本输入     | 公司名称、订单备注  |
| `number`   | 数字输入       | 数量、年龄      |
| `email`    | 带验证的电子邮件输入 | 账单联系人邮箱    |
| `url`      | 带验证的网址输入   | 网站、社交资料    |
| `date`     | 日期选择器      | 交付日期、活动日期  |
| `dropdown` | 预定义选项选择    | 尺码、颜色、方案类型 |
| `boolean`  | 用于是/否值的复选框 | 接受条款、订阅通讯  |

**工作原理**

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

**优势**

* **灵活的数据收集**：为履约或个性化体验收集所需的任何信息
* **内置验证**：电子邮件和网址字段会自动验证输入格式
* **必填/可选控制**：根据需求将字段标记为必填或可选
* **Webhook 交付**：自定义字段值包含在付款 Webhook 事件中

<Info>
  自定义字段值会在支付和订阅响应中的 `custom_field_responses` 数组内返回。
</Info>

了解更多：[Checkout Session 自定义字段](/developer-resources/checkout-session#15-collecting-custom-fields)

### 3. **扩展的结账语言支持**

结账页面现已支持 **21 种语言**，比之前的 16 种更多。以客户的母语提升他们的结账体验。

**新增语言**

| 语言       | 代码   |
| -------- | ---- |
| Korean   | `ko` |
| Malay    | `ms` |
| Romanian | `ro` |
| Russian  | `ru` |
| Thai     | `th` |

**所有支持的语言**

阿拉伯语、中文、荷兰语、英语、法语、德语、印地语、印度尼西亚语、意大利语、日语、韩语、马来语、葡萄牙语、罗马尼亚语、俄语、西班牙语、瑞典语、泰语、土耳其语、乌克兰语、越南语。

**强制指定语言**

使用 `force_language` 参数覆盖自动语言检测：

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

<Tip>
  默认情况下，结账页面会根据浏览器设置自动检测客户的首选语言。当您希望与网站语言保持一致时，请使用 `force_language`。
</Tip>

了解详情：[结账语言支持](/features/checkout#supported-languages)

### 4. **一般性错误修复与增强**

此版本包括性能优化、界面润色，并修复了一些小错误，提供更可靠、流畅的体验。