自适应货币

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.

​

什么是自适应货币？

​

主要好处

• 本地化支付体验：价格默认以本地货币显示。
• 更多支付方式：解锁可用于本地货币的支付方式。
• 同币种退款：以客户支付的货币退款。

​

启用自适应货币

​

客户体验

1. 检测：系统根据账单地址检测客户的国家。
2. 货币选择：如果国家被支持，价格默认以本地货币显示。客户可以切换到美元。
3. 支付方式：在适用的地方显示本地化支付方式。
4. 结账：以所选货币完成支付。

​

转换和费用

• 您支付：0%（默认）或 2-4%（启用费用包含时）
• 您的客户支付：基于订单金额支付 2-4%（默认）或 0%（启用费用包含时）

• 订单金额低于500美元时为4%
• 500到1500美元的订单为3%
• 超过1500美元的订单为2%

​

选择由谁承担费用

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_abc', quantity: 1 }],
  adaptive_currency_fees_inclusive: true, // override the business setting for this session
  return_url: 'https://yoursite.com/return'
});

​

支持的货币

​

退款和调整

1. 您以 100 美元出售产品并启用了自适应货币。
2. 加拿大客户看到的价格为 137 加元，汇率为 1 美元兑换 1.37 加元并完成购买。
3. 我们处理付款，将 137 加元转换为 100 美元用于您的结算。
4. 后来，汇率变为 1 美元兑换 1.40 加元，您进行全额退款。
5. 我们扣除 100 美元并退还客户140 加元。

​

发票和税务

• 发票仅显示结算货币金额。
• 税收和平台费用基于结算货币金额计算。
• 示例：10 美元的销售转换为 36 阿联酋迪拉姆，在仪表板和发票中仍然显示为 10 美元。

​

集成示例

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'prod_one_time_or_subscription',
      quantity: 1
    }
  ],
  billing_currency: 'AED',
  return_url: 'https://example.com/return'
});