Định Giá Địa Phương

​

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

​

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

​

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

• Các chế độ định giá — Một sản phẩm luôn chỉ ở đúng một chế độ tại một thời điểm, được xác định bởi pricing_mode của sản phẩm:
  • by_currency: một mức giá cho mỗi loại tiền tệ, bất kể quốc gia. Tất cả khách hàng thanh toán bằng EUR đều thấy €9.99.
  • by_country: một mức giá cụ thể cho một quốc gia (₹999 tại Ấn Độ), ngay cả khi nhiều quốc gia dùng chung một loại tiền tệ.
• Số tiền cố định, tính theo đơn vị nhỏ nhất — Giá trị amount của một quy tắc là một số nguyên theo đơn vị nhỏ nhất của loại tiền tệ, giống như mọi nơi khác trong API: 99900 là ₹999.00, 999 là €9.99. Đây là mức giá bạn đặt, không bao giờ là giá trị được chuyển đổi.
• Quy tắc khớp sẽ được ưu tiên hơn định giá tự động — Khi một quy tắc theo địa phương áp dụng cho một dòng, cả Purchasing Power Parity và Charm Pricing đều bị bỏ qua cho dòng đó. Khách hàng thanh toán đúng số tiền bạn đặt, không thay đổi.
• Khi không có quy tắc khớp — Sản phẩm giữ nguyên cách hoạt động hiện tại: khách hàng ở quốc gia dùng loại tiền tệ cơ sở thanh toán trực tiếp theo giá cơ sở; những khách hàng khác sẽ được chuyển đổi thông qua Adaptive Currency.
• Phí đã bao gồm khi có quy tắc khớp — Khách hàng thanh toán chính xác số tiền bạn đặt. Phí FX của Adaptive Currency do bạn chịu (được xem là đã bao gồm phí cho giao dịch đó) thay vì cộng thêm vào giá, vì vậy mức giá địa phương bạn công bố luôn là mức giá được tính cho khách hàng.

​

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ệ.

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.

• By Country
• By Currency

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.

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ó.

Chọn một loại tiền tệ và nhập số tiền (ví dụ €9.99 cho EUR), sau đó nhấn Thêm.

Loại tiền tệ hiện đã xuất hiện trong bảng Ghi Đè Tiền Tệ, nơi bạn có thể chỉnh sửa hoặc xóa nó.

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

​

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

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

import os
from dodopayments import DodoPayments

client = DodoPayments(
    bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"),
    environment="test_mode",
)

product = client.products.update(
    "pdt_premium_plan",
    pricing_mode="by_country",
)

package main

import (
	"context"
	"os"

	"github.com/dodopayments/dodopayments-go"
	"github.com/dodopayments/dodopayments-go/option"
)

func main() {
	client := dodopayments.NewClient(
		option.WithBearerToken(os.Getenv("DODO_PAYMENTS_API_KEY")),
	)

	_, err := client.Products.Update(
		context.TODO(),
		"pdt_premium_plan",
		dodopayments.ProductUpdateParams{
			PricingMode: dodopayments.F(dodopayments.PricingModeByCountry),
		},
	)
	if err != nil {
		panic(err)
	}
}

​

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

// ₹999.00 for customers in India
const localizedPrice = await client.products.localizedPrices.create('pdt_premium_plan', {
  currency: 'INR',
  country_code: 'IN',
  amount: 99900,
});

# ₹999.00 for customers in India
localized_price = client.products.localized_prices.create(
    "pdt_premium_plan",
    currency="INR",
    country_code="IN",
    amount=99900,
)

// ₹999.00 for customers in India
localizedPrice, err := client.Products.LocalizedPrices.New(
	context.TODO(),
	"pdt_premium_plan",
	dodopayments.ProductLocalizedPriceNewParams{
		Currency:    dodopayments.F(dodopayments.CurrencyInr),
		CountryCode: dodopayments.F(dodopayments.CountryCodeIn),
		Amount:      dodopayments.F(int64(99900)),
	},
)

​

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

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

# List all active rules on a product
rules = client.products.localized_prices.list("pdt_premium_plan")

# Change the amount (e.g. end a promo)
client.products.localized_prices.update(
    "lcp_india_price",
    product_id="pdt_premium_plan",
    amount=119900,
)

# Archive a rule
client.products.localized_prices.archive(
    "lcp_india_price",
    product_id="pdt_premium_plan",
)

// List all active rules on a product
rules, err := client.Products.LocalizedPrices.List(context.TODO(), "pdt_premium_plan")

// Change the amount (e.g. end a promo)
_, err = client.Products.LocalizedPrices.Update(
	context.TODO(),
	"pdt_premium_plan",
	"lcp_india_price",
	dodopayments.ProductLocalizedPriceUpdateParams{
		Amount: dodopayments.F(int64(119900)),
	},
)

// Archive a rule
err = client.Products.LocalizedPrices.Archive(
	context.TODO(),
	"pdt_premium_plan",
	"lcp_india_price",
)

​

Cách Áp Dụng Tại Lúc 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.

​

Cách áp dụng khi thay đổi gói đăng ký

• Theo quốc gia: áp dụng quy tắc khớp với quốc gia thanh toán của gói đăng ký. Nếu loại tiền tệ của quy tắc khác với loại tiền tệ dùng để tính phí gói đăng ký, số tiền của quy tắc sẽ được quy đổi theo tỷ giá FX trực tiếp — quy tắc vẫn được áp dụng, không bị bỏ qua.
• Theo loại tiền tệ: áp dụng quy tắc khớp với loại tiền tệ mà khách hàng được tính phí, và khách hàng sẽ bị tính đúng số tiền của quy tắc.
• Không khớp hoặc không có pricing_mode: áp dụng giá cơ bản của gói mới, được quy đổi qua Adaptive Currency khi cần — cùng cơ chế dự phòng như khi thanh toán.

• Bản xem trước là chính xác. Preview Change Plan trả về đúng số tiền đã bản địa hóa mà thay đổi thực tế sẽ tính phí.
• Các lần gia hạn giữ nguyên giá bản địa hóa. Sau khi thay đổi, gói mới sẽ được gia hạn với số tiền đã bản địa hóa — và vẫn bao gồm phí — chính xác như một gói đăng ký được tạo với mức giá đó.
• Tính phí phân bổ sử dụng số tiền thực tế. Khi nâng cấp, khoản tín dụng cho thời gian chưa sử dụng dựa trên số tiền khách hàng thực tế đã trả cho gói cũ, trong khi gói mới được định giá theo quy tắc bản địa hóa.
• Thay đổi theo lịch sẽ cố định giá tại thời điểm lên lịch. Một thay đổi được lên lịch vào cuối kỳ thanh toán sẽ tính số tiền được xác định tại thời điểm lên lịch, ngay cả khi bạn chỉnh sửa quy tắc trong khoảng thời gian đó.
• Loại tiền tệ thanh toán không bao giờ thay đổi. Thay đổi gói không bao giờ chuyển đổi loại tiền tệ mà gói đăng ký được quyết toán; quy tắc sử dụng loại tiền tệ khác sẽ được quy đổi theo FX sang loại tiền tệ đó.
• Add-on không được bản địa hóa. Giá add-on trên gói mới luôn sử dụng mức giá cơ bản.

​

Các hành vi quan trọng

​

Các phương pháp hay nhất

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

​

Liên quan