Chuyển đến nội dung chính

Định Giá Địa Phương Là Gì?

Mỗi sản phẩm có một giá cơ bản trong một loại tiền tệ cơ bản. Định Giá Địa Phương cho phép bạn ghi đè mức giá đó với giá cố định bạn thiết lập theo loại tiền tệ hoặc quốc gia. Bạn có thể bật tính năng này bằng cách đặt một pricing_mode trên sản phẩm, sau đó đính kèm một quy tắc cho từng thị trường. Đây là một trong ba công cụ độc lập cho định giá quốc tế, mỗi cái giải quyết một vấn đề khác nhau:
Cơ chếNó làm gìSố tiền khách hàng thấy
Định Giá Địa PhươngGiá cố định bạn thiết lập theo loại tiền tệ hoặc quốc giaChính xác số tiền bạn thiết lập
Tiền tệ Thích ứngTự động chuyển đổi giá cơ bản của bạn theo tỷ giá FX thựcGiá cơ bản được chuyển đổi theo tỷ giá hối đoái hiện tại
Mã giảm giáGiảm tỷ lệ phần trăm hoặc giá sàn từ giá cơ bảnGiá cơ bản trừ đi giảm giá
Định Giá Địa Phương và Tiền tệ Thích ứng hoạt động cùng nhau. Khi không có quy tắc nào địa phương khớp, sản phẩm quay trở về giá cơ bản của nó — tính trực tiếp nếu khách hàng đã sử dụng loại tiền cơ bản của bạn, hoặc được chuyển đổi qua Tiền tệ Thích ứng nếu không phải.

Các Trường Hợp Sử Dụng

Purchasing Power Parity (PPP)

Tính phí ít hơn ở các thị trường nhạy cảm với giá mà không giảm giá thị trường nhà của bạn. Một quy tắc by_country cho phép một sản phẩm cơ bản $20 bán với giá ₹999 ở Ấn Độ — điều chỉnh theo sức mua địa phương, không phải chuyển đổi FX thuần túy. Cách thực hiện PPP được khuyến nghị, gốc.

Charm Pricing

Một chuyển đổi FX trực tiếp của $19.99 tạo ra một số không đẹp mắt như €18.43. Một quy tắc by_currency thiết lập giá sạch, tâm lý mà khách hàng mong đợi — €9.99, ¥1000, ₹499 — chính xác như được nhập.

Reversible Market-Entry Promotions

Khởi động ở một quốc gia mới? Thêm quy tắc by_country với giá giới thiệu, sau đó lưu trữ nó khi khuyến mãi kết thúc để trở về định giá cơ bản/thích ứng. Các quy tắc được lưu trữ, không bao giờ xóa, do đó bạn giữ được hồ sơ sạch về những gì đã hoạt động và khi nào.

Competitive Price-Matching

Gắn một thị trường duy nhất để khớp với đối thủ địa phương. Một quy tắc by_country cho £9.00 tại Vương Quốc Anh giữ chính xác giá đó cho dù tỷ giá GBP/USD di chuyển ra sao.

Các Khái Niệm Cốt Lõi

  • Chế độ định giá — Sản phẩm nằm trong chính xác một chế độ tại một thời điểm, được thiết lập bởi pricing_mode của nó:
    • by_currency: một giá mỗi loại tiền tệ, bất kể quốc gia. Mọi người trả bằng EUR sẽ thấy €9.99.
    • by_country: giá cụ thể cho một quốc gia (₹999 ở Ấn Độ), ngay cả khi một số quốc gia sử dụng chung một loại tiền tệ.
  • Giá cố định, trong đơn vị nhỏ nhấtamount của một quy tắc là một số nguyên trong đơn vị nhỏ nhất của tiền tệ, giống như mọi nơi khác trong API: 99900 là ₹999.00, 999 là €9.99. Đó là giá bạn thiết lập, không bao giờ là giá chuyển đổi.
  • Khi không có quy tắc nào khớp — Sản phẩm giữ hành vi hiện có: khách hàng sử dụng loại tiền cơ bản của bạn trả giá cơ bản trực tiếp; mọi người khác thì được chuyển đổi qua Tiền tệ Thích ứng.
  • Phí được bao gồm khi một quy tắc khớp — Khách hàng trả chính xác số tiền bạn thiết lập. Phí FX Tiền tệ Thích ứng được bạn chi trả (được coi là đã bao gồm phí cho giao dịch đó) hơn là thêm vào trên giá, do đó giá địa phương bạn nêu luôn là giá được tính.

Cài Đặt trên Bảng Điều Khiển

1

Open the product form

Trong Bảng Điều Khiển Người Bán của bạn, đi đến Sản phẩm và tạo một sản phẩm (hoặc mở sản phẩm hiện có để chỉnh sửa). Đặt Giá cơ bản và loại tiền tệ như thông thường.
2

Enable Localized Pricing and choose a mode

Trong phần Định giá, tích vào Định giá Địa phương, sau đó chọn Theo Quốc gia hoặc Theo Tiền tệ.
Định giá Địa phương kích hoạt trên mẫu sản phẩm với tùy chọn Theo Quốc gia
3

Add a price for each market

Nhấn vào Thêm Giá Quốc Gia hoặc Thêm Giá Tiền tệ, điền vào bảng điều khiển Định giá Địa phương, và nhấn Thêm. Mỗi thị trường bạn thêm sẽ xuất hiện trong bảng ghi đè, nơi bạn có thể chỉnh sửa hoặc xóa sau này.
Chọn một quốc gia, chọn loại tiền tệ, và nhập số tiền (ví dụ ₹999 cho Ấn Độ), sau đó nhấn Thêm.
Thêm một ghi đè 999 INR cho Ấn Độ
Quốc gia hiện đã xuất hiện trong bảng Ghi Đè Quốc Gia, nơi bạn có thể chỉnh sửa hoặc xóa nó.
Bảng ghi đè Quốc Gia hiển thị Ấn Độ ở mức 999 INR
4

Save the product

Lưu bằng Thêm sản phẩm. Giá địa phương áp dụng cho các lần thanh toán trong tương lai ngay lập tức.
Thực hiện một lần thanh toán thử với một quốc gia thanh toán có quy tắc, và xác nhận số tiền địa phương xuất hiện.

Quản Lý qua API

Định Giá Địa Phương hoàn toàn có sẵn qua API. Đầu tiên thiết lập chế độ định giá của sản phẩm, sau đó đính kèm quy tắc.

Thiết lập chế độ định giá

Thiết lập pricing_mode khi bạn tạo sản phẩm (hoặc cập nhật một sản phẩm hiện có). null nghĩa là chỉ có cơ sở, hành vi hiện có.
import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
  environment: 'test_mode',
});

const product = await client.products.update('pdt_premium_plan', {
  pricing_mode: 'by_country',
});

Thêm một giá địa phương

Đính kèm một quy tắc vào sản phẩm. Ở chế độ by_country country_code là bắt buộc; ở chế độ by_currency nó phải được bỏ qua.
// ₹999.00 for customers in India
const localizedPrice = await client.products.localizedPrices.create('pdt_premium_plan', {
  currency: 'INR',
  country_code: 'IN',
  amount: 99900,
});
Đối với sản phẩm by_currency, bỏ qua country_code. Ví dụ, một €9.99 phẳng cho tất cả mọi người trả bằng EUR (currency: 'EUR', amount: 999).

Danh sách, cập nhật và lưu trữ

Bạn chỉ có thể cập nhật amount của một quy tắc; tiền tệ và quốc gia đã cố định khi tạo. Lưu trữ là một xóa mềm idempotent, vì vậy quy tắc ngừng khớp nhưng vẫn ở trong lịch sử của bạn.
// List all active rules on a product
const rules = await client.products.localizedPrices.list('pdt_premium_plan');

// Change the amount (e.g. end a promo)
await client.products.localizedPrices.update('lcp_india_price', {
  product_id: 'pdt_premium_plan',
  amount: 119900,
});

// Archive a rule
await client.products.localizedPrices.archive('lcp_india_price', {
  product_id: 'pdt_premium_plan',
});

API Reference

Xem đầy đủ các điểm cuối Giá địa phương Sản phẩm: tạo, danh sách, truy xuất, cập nhật và lưu trữ.

Cách Áp Dụng Tại Lúc Thanh Toán

Định giá địa phương được xác định theo từng dòng giỏ hàng, và chỉ đối với các sản phẩm có pricing_mode được thiết lập. Dodo Payments đọc hai tín hiệu từ yêu cầu: quốc gia thanh toán của khách hàng, và billing_currency tùy chọn (khi bỏ qua, một loại tiền tệ được suy ra từ quốc gia thanh toán).
  • Theo Quốc Gia: tìm kiếm một quy tắc phù hợp với quốc gia thanh toán. Nếu tồn tại, khách hàng bị tính giá trị quy tắc ở loại tiền tệ quy tắc.
  • Theo Tiền tệ: tìm kiếm một quy tắc phù hợp với loại tiền tệ của khách hàng (billing_currency, hoặc loại tiền tệ suy ra từ quốc gia của họ). Nếu tồn tại, khách hàng bị tính giá trị quy tắc ở loại tiền tệ đó.
  • Không có quy tắc nào khớp, hoặc không pricing_mode: giá cơ bản được áp dụng, tính trực tiếp khi loại tiền tệ của khách hàng bằng với loại tiền cơ bản, nếu không thì chuyển đổi qua Tiền tệ Thích ứng.
Mỗi dòng giỏ hàng được xác định riêng lẻ, do đó bạn có thể địa phương hóa một sản phẩm và để lại các sản phẩm khác theo định giá cơ bản trong cùng một lần thanh toán. Nếu bất kỳ dòng nào khớp với một quy tắc địa phương, toàn bộ giao dịch bị ép buộc bao gồm phí (xem Các Khái Niệm Cốt Lõi).

Các Hành Vi Quan Trọng

Hành viChi tiết
Số tiền trước thuếMột số tiền địa phương là giá trước thuế. Đối với các sản phẩm không bao gồm thuế, thuế được thêm vào tại lúc thanh toán, do đó số tiền địa phương không phải là tổng hoàn chỉnh. Xem Định Giá Bao Gồm Thuế.
Không áp dụng cho Trả Những Gì Bạn MuốnCác quy tắc địa phương không bao giờ áp dụng cho các sản phẩm Trả Những Gì Bạn Muốn, nơi khách hàng chọn số tiền.
Theo tiền tệ khác với cơ bảnQuy tắc by_currency phải sử dụng một loại tiền tệ khác với loại tiền cơ bản của sản phẩm.
Một quy tắc cho mỗi thị trườngMột sản phẩm có thể có tối đa một quy tắc hoạt động cho mỗi loại tiền tệ (theo tiền tệ) hoặc mỗi quốc gia (theo quốc gia).
Tất cả các loại sản phẩmÁp dụng cho sản phẩm một lần, đăng ký và theo sử dụng.
Các thay đổi quy tắc địa phương không gửi các webhook của riêng chúng. Số tiền đã giải quyết xuất hiện trên thanh toán hoặc đăng ký kết quả giống như bất kỳ giá nào khác.

Thực Hành Tốt Nhất

  • Giữ một giá cơ sở hợp lý. Đây là phương pháp dự phòng cho mỗi thị trường không có quy tắc, được chuyển đổi qua Tiền tệ Thích ứng.
  • Làm tròn đến các giá hấp dẫn địa phương. Mục đích của số tiền cố định là để có được một số sạch như ₹999, €9.99 hoặc ¥1000, không phải là kết quả FX.
  • Chọn chế độ cho công việc. Sử dụng by_country cho định giá sức mua; sử dụng by_currency khi một mức giá mỗi khu vực tiền tệ là đủ.
  • Lưu trữ, không tạo lại, cho khuyến mãi. Lưu trữ một quy tắc đưa thị trường trở về cơ bản/thích ứng trong khi giữ lịch sử; tạo lại hoặc định giá lại sau khi cần.
  • Lưu ý dòng thuế trước khi quảng cáo tổng số. Đối với các sản phẩm không bao gồm thuế, khách hàng trả số tiền địa phương cộng thuế, vì vậy không nên báo cáo nó là giá cuối cùng trong quảng cáo.

Liên Quan

Purchasing Power Parity

Định giá địa phương gốc vs mã giảm giá dựa trên vị trí cho PPP.

Adaptive Currency

Chuyển đổi FX tự động và xử lý phí mà định giá địa phương dựa vào.

Tax-Inclusive Pricing

Kiểm soát nếu giá của bạn đã bao gồm thuế.

Pay What You Want

Cho phép khách hàng chọn số tiền. Các quy tắc địa phương không áp dụng ở đây.
Lần sửa đổi cuối 26 tháng 6, 2026