Harga Terlokalisasi

​

Apa itu Harga Terlokalisasi?

​

Kasus Penggunaan

​

Konsep Inti

• Mode harga — Sebuah produk memiliki satu mode pada satu waktu, ditentukan oleh pricing_mode:
  • by_currency: satu harga per mata uang, terlepas dari negara. Setiap orang yang membayar dalam EUR melihat €9.99.
  • by_country: harga khusus untuk negara (₹999 di India), bahkan ketika beberapa negara berbagi mata uang yang sama.
• Jumlah tetap, dalam unit terkecil — amount dari sebuah aturan adalah integer dalam unit terkecil mata uang, sama seperti di API lainnya: 99900 adalah ₹999.00, 999 adalah €9.99. Itu adalah harga yang Anda tetapkan, bukan nilai konversi.
• Ketika tidak ada aturan yang cocok — Produk mempertahankan perilaku saat ini: pelanggan dalam mata uang dasar Anda membayar harga dasar secara langsung; semua orang mendapatkannya dikonversi melalui Mata Uang Adaptif.
• Biaya termasuk ketika aturan cocok — Pelanggan membayar tepat jumlah yang Anda tetapkan. Biaya FX Mata Uang Adaptif diserap oleh Anda (diperlakukan sebagai biaya termasuk untuk transaksi tersebut) daripada ditambahkan di atasnya, jadi harga lokal yang Anda nyatakan selalu menjadi harga yang dikenakan.

​

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 masuk akal. Harga ini menjadi fallback untuk setiap pasar yang tidak memiliki aturan, dan dikonversi melalui Adaptive Currency.
• Bulatkan menjadi harga lokal yang menarik. Tujuan utama jumlah tetap adalah angka yang rapi seperti ₹999, €9.99, atau ¥1000, bukan hasil FX.
• 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 akan mengembalikan pasar ke harga dasar/adaptif sekaligus mempertahankan riwayat; buat ulang atau tetapkan harga baru nanti sesuai kebutuhan.
• Perhatikan komponen pajak sebelum mengiklankan total. Untuk produk yang pajaknya tidak termasuk dalam harga, pelanggan membayar jumlah terlokalisasi ditambah pajak, jadi jangan menyebutnya sebagai harga akhir dalam iklan.

​

Terkait