Đị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

• 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ất — amount 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ệ.

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

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

​

Liên quan