Skip to main content
Adaptive Currency hiển thị giá sản phẩm bằng đơn vị tiền tệ địa phương của khách hàng thay vì chỉ bằng đơn vị tiền tệ cơ sở của bạn. Khi được bật, checkout sẽ mặc định sử dụng đơn vị tiền tệ địa phương được phát hiện cho các quốc gia được hỗ trợ, đồng thời cho phép chuyển lại sang đơn vị tiền tệ cơ sở.

Cách thức hoạt động

Đơn vị tiền tệ cơ sở là đơn vị tiền tệ mà bạn đã định giá sản phẩm hoặc tiện ích bổ sung — có thể là bất kỳ đơn vị tiền tệ nào mà Dodo Payments có thể tính phí, không chỉ USD. Adaptive Currency chuyển đổi giá cơ sở theo tỷ giá hối đoái trực tiếp. Để đặt giá cố định riêng cho từng đơn vị tiền tệ hoặc quốc gia, hãy xem Localized Pricing.

Lợi ích chính

  • Checkout được bản địa hóa — Giá mặc định hiển thị bằng đơn vị tiền tệ địa phương của khách hàng
  • Nhiều phương thức thanh toán hơn — Mở khóa các phương thức thanh toán chỉ khả dụng với đơn vị tiền tệ địa phương
  • Hoàn tiền bằng cùng đơn vị tiền tệ — Hoàn tiền cho khách hàng bằng đơn vị tiền tệ họ đã thanh toán
  • Định giá nâng cao — Cho phép sử dụng Purchasing Power Parity và Charm Pricing để tự động tối ưu giá theo từng thị trường

Bật Adaptive Currency

1

Open Settings

Đăng nhập vào Merchant Dashboard và đi đến Settings → Business.
2

Enable Adaptive Currency

Bật Adaptive Currency. Bạn có thể tắt tính năng này bất kỳ lúc nào.
Các thay đổi chỉ áp dụng cho những giao dịch trong tương lai.
3

Save and Test

Lưu cài đặt, sau đó xác minh rằng checkout thử nghiệm hiển thị giá bằng đơn vị tiền tệ địa phương của bạn khi được hỗ trợ.
Công tắc Adaptive Currency trong Settings

Trải nghiệm khách hàng

Khi Adaptive Currency được bật:
  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 đơn vị tiền tệ — Nếu quốc gia được hỗ trợ, giá mặc định hiển thị bằng đơn vị tiền tệ địa phương. Khách hàng có thể chuyển lại sang đơn vị tiền tệ cơ sở của bạn
  3. Phương thức thanh toán — Các phương thức thanh toán được bản địa hóa sẽ xuất hiện khi phù hợp
  4. Checkout — Thanh toán được hoàn tất bằng đơn vị tiền tệ đã chọn

Chuyển đổi và phí

Adaptive Currency tính phí khách hàng bằng đơn vị tiền tệ địa phương theo tỷ giá hối đoái trực tiếp. Phí được phân theo giá trị đơn hàng:
  • 4% cho đơn hàng dưới $500
  • 3% cho đơn hàng từ $500 đến $1,500
  • 2% cho đơn hàng trên $1,500
Theo mặc định, các khoản phí này được cộng thêm vào giá hiển thị và do khách hàng chịu. Với cài đặt Fees Inclusive, bạn có thể tự chịu khoản phí này: khách hàng vẫn thấy cùng một mức giá bằng đơn vị tiền tệ địa phương, còn phí sẽ được khấu trừ khỏi khoản thanh toán quyết toán của bạn.

Bật Fees Inclusive

1

Open Settings

Đi đến Settings → Business và bật Adaptive Currency nếu bạn chưa thực hiện.
2

Enable Fees Inclusive

Sau khi bật Adaptive Currency, hãy bật công tắc Fees Inclusive trong cùng mục đó.

Ghi đè theo từng request

Bạn có thể ghi đè mặc định của merchant theo từng request bằng cách truyền adaptive_currency_fees_inclusive (boolean) trong một khoản thanh toán một lần, subscription on-demand (on_demand.adaptive_currency_fees_inclusive), khoản phí subscription hoặc thay đổi plan. Trong checkout session, tham số này chỉ được chấp nhận cho subscription on-demand, dưới dạng subscription_data.on_demand.adaptive_currency_fees_inclusive, và không được đặt ở cấp cao nhất của request:
Các giao dịch INR → INR luôn được xử lý là inclusive, bất kể cài đặt của doanh nghiệp hay giá trị ghi đè theo từng request.
Khi một quy tắc Localized Pricing khớp, giao dịch luôn được xử lý là inclusive, bất kể cài đặt Fees Inclusive hay bất kỳ giá trị ghi đè theo từng request nào. Khách hàng thanh toán chính xác số tiền bản địa hóa bạn đã đặt, còn phí chuyển đổi được khấu trừ khỏi khoản thanh toán quyết toán của bạn.

Số tiền tối thiểu

Mỗi khoản thanh toán phải đáp ứng mức tối thiểu của loại tiền mà khách hàng thanh toán, và các gói đăng ký có mức tối thiểu cao hơn so với các khoản thanh toán một lần. Các mức tối thiểu giống nhau được áp dụng cho mọi phương thức thanh toán. Việc kiểm tra sử dụng tổng số tiền, bao gồm cả thuế. Các khoản thanh toán bằng loại tiền khác USD, EUR và GBP sẽ được quyết toán bằng USD. Đối với các loại tiền này, checkout trước tiên kiểm tra giá đã quy đổi sang USD, trước khi thêm phí Adaptive Currency, sau đó kiểm tra số tiền bằng loại tiền của khách hàng. Số tiền phải vượt qua cả hai lần kiểm tra, vì vậy mức tối thiểu thực tế có thể cao hơn mức tối thiểu được liệt kê cho loại tiền đó. Ví dụ: mức tối thiểu được liệt kê cho AED là 2.00 AED, nhưng một gói đăng ký bằng AED phải có giá trị ít nhất là $1.00, tương đương khoảng 3.70 AED. Gói đăng ký trị giá 2.00 AED sẽ không vượt qua bước kiểm tra bằng USD. Nếu khoản thanh toán thấp hơn mức tối thiểu, API trả về TOTAL_PAYMENT_AMOUNT_BELOW_MINIMUM_AMOUNT. Thông báo sẽ nêu mức tối thiểu không đạt. Đối với khoản thanh toán bằng loại tiền khác, đó có thể là mức tối thiểu bằng USD, chẳng hạn như Minimum amount of 1.00 USD is required to process payment.

Các loại tiền được hỗ trợ

Bảng liệt kê số tiền tối thiểu của từng loại tiền. Mức tối thiểu áp dụng cho cả các khoản thanh toán một lần và gói đăng ký. Xem Số tiền tối thiểu để biết thêm về bước kiểm tra bằng USD.

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

Dodo Payments hoàn tiền bằng loại tiền mà khách hàng đã thanh toán ban đầu, sử dụng tỷ giá hối đoái mới nhất. Số tiền bằng loại tiền cơ sở của bạn vẫn cố định trên dashboard, hóa đơn và khoản hoàn tiền. Tùy thuộc vào biến động FX, khách hàng có thể nhận được nhiều hơn hoặc ít hơn số tiền bằng nội tệ ban đầu.
Phí Adaptive Currency (phí FX) không được hoàn lại.

Ví dụ về hoàn tiền

  1. Bạn bán một sản phẩm với giá 100 USD khi Adaptive Currency được bậ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 tất giao dịch mua
  3. Dodo Payments xử lý khoản thanh toán, quy đổi 137 CAD thành 100 USD để quyết toán cho bạn
  4. Sau đó, tỷ giá 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. Dodo Payments khấu trừ 100 USD và hoàn lại cho khách hàng 140 CAD

Hóa đơn và thuế

  • Hóa đơn chỉ hiển thị số tiền bằng loại tiền quyết toán
  • Thuế và phí nền tảng được tính trên số tiền bằng loại tiền quyết toán
  • Ví dụ: một giao dịch bán hàng trị giá $10 được quy đổi thành 36 AED vẫn được hiển thị là $10 trong Dashboard và hóa đơn
Tất cả số tiền được làm tròn theo logic làm tròn nội bộ của Dodo Payments.

Thiết lập loại tiền thanh toán cho từng checkout

Truyền billing_currency để đặt rõ loại tiền thanh toán cho một phiên checkout:
Khi Adaptive Currency bị tắt, billing_currency sẽ bị bỏ qua.

Các trang liên quan

Purchasing Power Parity

Tự động giảm giá theo quốc gia. Yêu cầu Adaptive Currency.

Charm Pricing

Làm tròn giá đã quy đổi thành các đuôi số đẹp như 49.99. Yêu cầu Adaptive Currency.

Localized Pricing

Đặt giá chính xác theo từng quốc gia hoặc loại tiền thay vì tự động quy đổi.

Tax-Inclusive Pricing

Kiểm soát việc giá của bạn đã bao gồm thuế hay chưa.

Checkout Session

Tạo các phiên checkout với cấu hình loại tiền thanh toán.
Lần sửa đổi cuối 26 tháng 9, 2026