Harga Terlokalisasi

​

Apa itu Harga Terlokalisasi?

​

Kasus Penggunaan

​

Konsep Inti

• Mode penetapan harga — Sebuah produk selalu berada tepat dalam satu mode, yang ditetapkan 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 suatu aturan adalah bilangan bulat dalam unit terkecil mata uang, sama seperti di seluruh API: 99900 adalah ₹999.00, 999 adalah €9.99. Ini adalah harga yang Anda tetapkan, bukan nilai yang dikonversi.
• Aturan yang cocok mengungguli penetapan harga otomatis — Jika aturan lokal berlaku untuk suatu baris, Purchasing Power Parity dan Charm Pricing akan dilewati untuk baris tersebut. Saat checkout, pelanggan membayar jumlah yang Anda tetapkan tanpa perubahan. Saat terjadi perubahan paket langganan, aturan dalam mata uang yang berbeda dari langganan akan dikonversi; lihat Cara Penerapannya pada Perubahan Paket Langganan.
• Jika tidak ada aturan yang cocok — Produk mempertahankan perilaku yang ada: pelanggan dalam mata uang dasar Anda membayar harga dasar secara langsung; pelanggan lainnya akan dikenai harga yang dikonversi melalui Adaptive Currency.
• Biaya sudah termasuk saat aturan cocok — Pelanggan membayar persis 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.

​

Penyiapan di Dasbor

1

Open the product form

Di Merchant Dashboard, buka Products lalu buat produk (atau buka produk yang sudah ada untuk mengeditnya). Tetapkan Price 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, lalu klik Add. Setiap pasar yang Anda tambahkan akan muncul di tabel override, tempat Anda dapat mengedit atau menghapusnya nanti.

• By Country
• By Currency

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

Negara tersebut kini muncul di tabel Country overrides, tempat Anda dapat mengedit atau menghapusnya.

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

Mata uang tersebut kini muncul di tabel Currency overrides, tempat Anda dapat mengedit atau menghapusnya.

4

Save the product

Simpan dengan Add product. Harga lokal akan langsung diterapkan pada checkout mendatang.

Lakukan checkout pengujian dengan negara penagihan yang memiliki aturan, lalu pastikan jumlah lokal ditampilkan.

​

Kelola melalui API

​

Tetapkan Mode Penetapan 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 Lokal

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

​

Cantumkan, 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
_, 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",
)

​

Cara Penerapannya saat Checkout

• By Country: mencari aturan yang cocok dengan negara penagihan. Jika ada, pelanggan ditagihkan jumlah aturan dalam mata uang aturan tersebut.
• By Currency: mencari aturan yang cocok dengan mata uang pelanggan (billing_currency atau mata uang yang ditentukan dari negara pelanggan). Jika ada, pelanggan ditagihkan jumlah aturan dalam mata uang tersebut.
• Tidak ada kecocokan atau tidak ada pricing_mode: harga dasar berlaku, ditagihkan langsung jika mata uang pelanggan sama dengan mata uang dasar; jika tidak, harga dikonversi melalui Adaptive Currency.

​

Cara Penerapannya pada Perubahan Paket Langganan

• By Country: aturan yang cocok dengan negara penagihan langganan akan berlaku. Jika mata uang aturan berbeda dari mata uang penagihan langganan, jumlah aturan dikonversi menggunakan nilai tukar FX terkini — aturan tetap diterapkan, bukan dilewati.
• By Currency: aturan yang cocok dengan mata uang penagihan pelanggan akan berlaku, dan pelanggan ditagihkan persis sejumlah aturan tersebut.
• Tidak ada kecocokan atau tidak ada pricing_mode: harga dasar paket baru berlaku, dikonversi melalui Adaptive Currency jika diperlukan — fallback yang sama seperti checkout.

• Pratinjau bersifat akurat. Preview Change Plan mengembalikan jumlah lokal yang sama dengan jumlah yang ditagihkan oleh perubahan sebenarnya.
• Perpanjangan mempertahankan harga lokal. Setelah perubahan, paket baru diperpanjang dengan jumlah lokalnya — dan tetap menyertakan biaya — persis seperti langganan yang dibuat dengan harga tersebut.
• Prorata menggunakan jumlah sebenarnya. Saat upgrade, kredit untuk waktu yang belum digunakan didasarkan pada jumlah yang sebenarnya dibayar pelanggan untuk paket lama, sedangkan paket baru diberi harga berdasarkan aturan lokalnya.
• Perubahan terjadwal mengunci harga saat dijadwalkan. Perubahan yang dijadwalkan pada akhir periode penagihan akan menagihkan jumlah yang dihitung saat penjadwalan, meskipun Anda mengedit aturan di antaranya.
• Mata uang penagihan tidak pernah berubah. Perubahan paket tidak pernah mengganti mata uang penyelesaian langganan; aturan dalam mata uang lain dikonversi melalui FX ke mata uang tersebut.
• Add-on tidak dilokalkan. Harga add-on pada paket baru selalu menggunakan harga dasarnya.

​

Perilaku Penting

​

Praktik Terbaik

• Pertahankan harga dasar yang wajar. Harga ini menjadi fallback untuk setiap pasar tanpa aturan, dan 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 cukup.
• 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 baris pajak sebelum mengiklankan total. Untuk produk yang pajaknya tidak termasuk, pelanggan membayar jumlah lokal ditambah pajak, jadi jangan menyebutnya sebagai harga akhir dalam iklan.

​

Terkait