Tiền Tệ Thích Ứng

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.

​

Tiền Tệ Thích Ứng Là Gì?

​

Lợi Ích Chính

• Trải nghiệm thanh toán địa phương hóa: Giá cả xuất hiện bằng tiền tệ địa phương theo mặc định.
• Nhiều phương thức thanh toán hơn: Mở khóa các phương thức thanh toán có sẵn cho tiền tệ địa phương.
• Hoàn tiền cùng loại tiền tệ: Hoàn tiền cho khách hàng bằng loại tiền tệ mà họ đã thanh toán.

​

Kích Hoạt Tiền Tệ Thích Ứng

​

Trải Nghiệm Khách Hàng

1. Phát hiện: Hệ thống phát hiện quốc gia của khách hàng dựa trên địa chỉ thanh toán.
2. Chọn tiền tệ: Nếu quốc gia được hỗ trợ, giá sẽ hiển thị bằng tiền tệ địa phương theo mặc định. Khách hàng có thể chuyển sang USD.
3. Phương thức thanh toán: Các phương thức thanh toán địa phương hóa xuất hiện khi có thể.
4. Thanh toán: Thanh toán được hoàn tất bằng loại tiền tệ đã chọn.

​

Chuyển Đổi và Phí

• Bạn trả: 0% (mặc định) hoặc 2–4% (khi phí bao gồm được kích hoạt)
• Khách hàng của bạn trả: 2–4% dựa trên giá trị đơn hàng (mặc định) hoặc 0% (khi phí bao gồm được kích hoạt)

• 4% cho các đơn hàng dưới 500 USD
• 3% cho từ 500 đến 1,500 USD
• 2% cho trên 1,500 USD

​

Chọn người chịu phí

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'
});

​

Tiền Tệ Hỗ Trợ

​

Hoàn tiền và điều chỉnh

1. Bạn bán một sản phẩm với giá 100 USD với Tính tiền tệ Linh hoạt được kích hoạt.
2. Một khách hàng Canada thấy giá 137 CAD với tỷ giá 1.37 CAD cho 1 USD và hoàn thành giao dịch.
3. Chúng tôi xử lý thanh toán, chuyển đổi 137 CAD thành 100 USD cho khoản kết toán của bạn.
4. Sau đó, tỷ giá hối đoái thay đổi thành 1.40 CAD cho 1 USD và bạn thực hiện hoàn tiền toàn bộ.
5. Chúng tôi khấu trừ 100 USD và hoàn trả cho khách hàng 140 CAD.

​

Hóa đơn và Thuế

• Hóa đơn chỉ hiển thị số tiền theo đơn vị tiền tệ kết toán.
• Thuế và phí nền tảng được tính trên số tiền theo đơn vị tiền tệ kết toán.
• Ví dụ: một giao dịch bán $10 được chuyển đổi thành 36 AED vẫn được phản ánh là $10 trên Bảng điều khiển và hóa đơn.

​

Ví dụ Tích hợp

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'
});