Harga Terlokalisasi

​

Apa itu Harga Terlokalisasi?

​

Kasus Penggunaan

​

Konsep Inti

• Mode penetapan harga — Produk hanya berada dalam satu mode pada satu waktu, yang ditentukan oleh pricing_mode:
  • by_currency: satu harga per mata uang, terlepas dari negara. Semua orang yang membayar dalam EUR akan melihat €9.99.
  • by_country: harga khusus untuk suatu negara (₹999 di India), meskipun beberapa negara menggunakan mata uang yang sama.
• Jumlah tetap, dalam unit terkecil — amount dari suatu aturan adalah bilangan bulat dalam unit terkecil mata uang tersebut, sama seperti di seluruh API: 99900 adalah ₹999.00, 999 adalah €9.99. Ini adalah harga yang Anda tetapkan, bukan nilai hasil konversi.
• Aturan yang cocok mengalahkan penetapan harga otomatis — Jika aturan terlokalisasi berlaku untuk suatu baris, Purchasing Power Parity dan Charm Pricing akan dilewati untuk baris tersebut. Pelanggan membayar jumlah yang Anda tetapkan, tanpa perubahan.
• Saat tidak ada aturan yang cocok — Produk mempertahankan perilaku yang ada: pelanggan dalam mata uang dasar Anda membayar harga dasar secara langsung; pelanggan lainnya mendapatkan harga yang dikonversi melalui Adaptive Currency.
• Biaya sudah termasuk saat aturan cocok — Pelanggan membayar persis sebesar jumlah yang Anda tetapkan. Biaya FX Adaptive Currency ditanggung oleh Anda (diperlakukan sebagai biaya yang sudah termasuk untuk transaksi tersebut), bukan ditambahkan di atasnya, sehingga harga lokal yang Anda nyatakan selalu menjadi harga yang ditagihkan.

​

Persiapan di Dasbor

1

Open the product form

Di Dasbor Merchant Anda, masuk ke Products dan buat produk (atau buka yang sudah ada untuk diedit). Atur Harga dasar dan mata uang seperti biasa.

2

Enable Localized Pricing and choose a mode

Di bagian Pricing, centang Localized Pricing, lalu pilih By Country atau By Currency.

3

Add a price for each market

Klik Add Country Price atau Add Currency Price, isi panel Localized pricing, dan klik Add. Setiap pasar yang Anda tambahkan muncul dalam tabel override, di mana Anda dapat mengedit atau menghapusnya kemudian.

• By Country
• By Currency

Pilih negara, pilih mata uang, dan masukkan jumlah (misalnya ₹999 untuk India), lalu klik Add.

Negara tersebut sekarang muncul di tabel Country overrides, di mana Anda dapat mengedit atau menghapusnya.

Pilih mata uang dan masukkan jumlah (misalnya €9.99 untuk EUR), lalu klik Add.

Mata uang tersebut sekarang muncul di tabel Currency overrides, di mana Anda dapat mengedit atau menghapusnya.

4

Save the product

Simpan dengan Add product. Harga terlokalisasi berlaku untuk checkout mendatang segera.

Lakukan uji coba checkout dengan negara tagihan yang memiliki aturan, dan konfirmasi jumlah terlokalisasi muncul.

​

Kelola melalui API

​

Atur mode harga

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)
	}
}

​

Tambahkan harga terlokalisasi

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

​

Daftar, perbarui, dan arsipkan

// 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",
)

​

Bagaimana Itu Berlaku saat Checkout

• By Country: mencari aturan yang cocok dengan negara penagihan. Jika ada, pelanggan dikenakan biaya sesuai dengan jumlah aturan dalam mata uang aturan tersebut.
• By Currency: mencari aturan yang cocok dengan mata uang pelanggan (billing_currency, atau mata uang yang diturunkan dari negara mereka). Jika ada, pelanggan dikenakan biaya sesuai dengan jumlah aturan dalam mata uang tersebut.
• Tidak cocok, atau tidak ada pricing_mode: harga dasar berlaku, dikenakan secara langsung ketika mata uang pelanggan sama dengan mata uang dasar, jika tidak, dikonversi melalui Mata Uang Adaptif.

​

Cara Penerapannya pada Perubahan Paket Langganan

• Berdasarkan Negara: aturan yang cocok dengan negara penagihan langganan akan diterapkan. Jika mata uang aturan berbeda dari mata uang yang digunakan untuk menagih langganan, jumlah dalam aturan dikonversi menggunakan nilai tukar FX langsung — aturan tetap diterapkan, bukan dilewati.
• Berdasarkan Mata Uang: aturan yang cocok dengan mata uang yang digunakan untuk menagih pelanggan akan diterapkan, dan pelanggan ditagih tepat sebesar jumlah dalam aturan.
• Tidak ada kecocokan, atau tidak ada pricing_mode: harga dasar paket baru diterapkan, dikonversi melalui Adaptive Currency bila diperlukan — fallback yang sama seperti checkout.

• Pratinjau bersifat akurat. Preview Change Plan mengembalikan jumlah terlokalisasi yang sama dengan yang ditagihkan oleh perubahan sebenarnya.
• Perpanjangan mempertahankan harga terlokalisasi. Setelah perubahan, paket baru diperpanjang dengan jumlah terlokalisasinya — dan tetap sudah termasuk biaya — sama seperti langganan yang dibuat dengan harga tersebut.
• Prorata menggunakan jumlah sebenarnya. Saat upgrade, kredit untuk waktu yang tidak terpakai didasarkan pada jumlah yang benar-benar dibayarkan pelanggan untuk paket lama, sedangkan harga paket baru ditentukan oleh aturan terlokalisasinya.
• Perubahan terjadwal mengunci harga saat dijadwalkan. Perubahan yang dijadwalkan pada akhir periode penagihan akan menagihkan jumlah yang dihitung saat penjadwalan, meskipun Anda mengedit aturan tersebut setelahnya.
• Mata uang penagihan tidak pernah berubah. Perubahan paket tidak pernah mengganti mata uang penyelesaian langganan; aturan dalam mata uang lain dikonversi menggunakan FX ke mata uang tersebut.
• Add-on tidak dilokalkan. Harga add-on pada paket baru selalu menggunakan harga dasarnya.

​

Perilaku Penting

​

Praktik Terbaik

• Tetapkan harga dasar yang wajar. Harga ini menjadi pilihan cadangan untuk setiap pasar tanpa aturan, yang dikonversi melalui Adaptive Currency.
• Masukkan angka yang rapi. Tujuan utama jumlah tetap adalah harga yang rapi seperti ₹999, €9.99, atau ¥1000, bukan hasil FX. Untuk pembulatan otomatis di semua mata uang, lihat Charm Pricing.
• Pilih mode sesuai kebutuhan. Gunakan by_country untuk penetapan harga berdasarkan daya beli; gunakan by_currency jika satu harga per zona mata uang sudah memadai.
• Arsipkan, jangan buat ulang, untuk promosi. Mengarsipkan aturan mengembalikan pasar ke harga dasar/adaptif sekaligus mempertahankan riwayat; buat ulang atau tetapkan harga baru nanti sesuai kebutuhan.
• Perhatikan komponen pajak sebelum mengiklankan total harga. Untuk produk yang pajaknya belum termasuk, pelanggan membayar jumlah terlokalisasi ditambah pajak, jadi jangan mencantumkannya sebagai harga final dalam iklan.

​

Terkait