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

​

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

​

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

​

Khái niệm cốt lõi

• 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 thiết lập bởi pricing_mode:
  • by_currency: một mức giá cho mỗi loại tiền tệ, bất kể quốc gia. Mọi người thanh toán bằng EUR đều thấy €9.99.
  • by_country: một mức giá riêng cho từng 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 — amount của một quy tắc là 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ị đã chuyển đổi.
• Quy tắc khớp được ưu tiên hơn định giá tự động — Khi một quy tắc bản địa hóa áp dụng cho một dòng, Purchasing Power Parity và Charm Pricing đều được bỏ qua cho dòng đó. Tại checkout, khách hàng thanh toán đúng số tiền bạn đặt, không thay đổi. Khi thay đổi gói đăng ký, một quy tắc dùng loại tiền tệ khác với gói đăng ký sẽ được chuyển đổi; xem Cách áp dụng khi thay đổi gói đăng ký.
• Khi không có quy tắc khớp — Sản phẩm giữ nguyên hành vi hiện tại: khách hàng dùng loại tiền tệ cơ sở thanh toán trực tiếp theo giá cơ sở; những người khác sẽ được chuyển đổi qua Adaptive Currency.
• Phí được 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 xử lý như đã bao gồm phí cho giao dịch đó) thay vì cộng thêm, vì vậy mức giá địa phương bạn công bố luôn là số tiền được tính.

​

Thiết lập trong Dashboard

1

Open the product form

Trong Merchant Dashboard, đi đến Products và tạo một sản phẩm (hoặc mở sản phẩm hiện có để chỉnh sửa). Thiết lập Price cơ sở và loại tiền tệ như bình thường.

2

Enable Localized Pricing and choose a mode

Trong phần Pricing, chọn Localized Pricing, sau đó chọn By Country hoặc By Currency.

3

Add a price for each market

Nhấp Add Country Price hoặc Add Currency Price, điền vào bảng Localized pricing, rồi nhấp Add. 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 Độ), rồi nhấp Add.

Quốc gia hiện xuất hiện trong bảng Country overrides, nơi bạn có thể chỉnh sửa hoặc xóa quốc gia đó.

Chọn một loại tiền tệ và nhập số tiền (ví dụ €9.99 cho EUR), rồi nhấp Add.

Loại tiền tệ hiện xuất hiện trong bảng Currency overrides, nơi bạn có thể chỉnh sửa hoặc xóa loại tiền tệ đó.

4

Save the product

Lưu bằng Add product. Giá bản địa hóa sẽ áp dụng ngay cho các checkout trong tương lai.

Thực hiện một checkout thử nghiệm với quốc gia thanh toán có quy tắc, rồi xác nhận rằng số tiền bản địa hóa được hiển thị.

​

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 giá bản địa hóa

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

​

Liệt kê, 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
_, 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 checkout

• By Country: tìm quy tắc khớp với billing country. Nếu có, khách hàng sẽ bị tính số tiền của quy tắc bằng loại tiền tệ của quy tắc đó.
• By Currency: tìm quy tắc khớp với loại tiền tệ của khách hàng (billing_currency hoặc loại tiền tệ được suy ra từ quốc gia của họ). Nếu có, khách hàng sẽ bị tính số tiền của quy tắc bằng loại tiền tệ đó.
• Không khớp hoặc không có pricing_mode: giá cơ sở được áp dụng; khách hàng sẽ thanh toán trực tiếp khi loại tiền tệ của họ trùng với loại tiền tệ cơ sở, nếu không thì được chuyển đổi qua Adaptive Currency.

​

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

• By Country: áp dụng quy tắc khớp với billing country của gói đăng ký. Nếu currency của quy tắc khác với currency mà gói đăng ký được tính phí, số tiền của quy tắc sẽ được chuyển đổi theo tỷ giá FX hiện tại — quy tắc vẫn được áp dụng, không bị bỏ qua.
• By Currency: áp dụng quy tắc khớp với currency mà khách hàng được tính phí và khách hàng sẽ thanh toán chính xác số tiền của quy tắc.
• Không khớp hoặc không có pricing_mode: áp dụng giá cơ sở của gói mới, chuyển đổi qua Adaptive Currency khi cần — giống như phương án dự phòng tại checkout.

• 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.
• Gia hạn giữ nguyên giá bản địa hóa. Sau khi thay đổi, gói mới được gia hạn với số tiền bản địa hóa — và vẫn bao gồm phí — giống hệt gói đăng ký được tạo ngay từ đầu với mức giá đó.
• Proration 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 sự đã 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 được lên lịch sẽ khóa 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 tí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 đó.
• Currency thanh toán không bao giờ thay đổi. Thay đổi gói không bao giờ chuyển đổi currency mà gói đăng ký được quyết toán; quy tắc dùng currency khác sẽ được chuyển đổi FX sang currency đó.
• Add-on không được bản địa hóa. Giá add-on trong gói mới luôn sử dụng giá cơ sở.

​

Hành vi quan trọng

​

Thực tiễn tốt nhất

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

​

Liên quan