Mata Uang Adaptif

Adaptive Currency menampilkan harga produk dalam mata uang lokal pelanggan, bukan hanya mata uang dasar Anda. Saat diaktifkan, checkout secara default menggunakan mata uang lokal yang terdeteksi untuk negara yang didukung, dengan opsi untuk kembali ke mata uang dasar Anda.

Cara Kerjanya

Mata uang dasar Anda adalah mata uang yang digunakan untuk menetapkan harga produk atau add-on — mata uang tersebut dapat berupa mata uang apa pun yang dapat ditagihkan oleh Dodo Payments, bukan hanya USD. Adaptive Currency mengonversi harga dasar tersebut menggunakan nilai tukar langsung. Untuk menetapkan harga tetap Anda sendiri berdasarkan mata uang atau negara, lihat Localized Pricing.

Manfaat Utama

Checkout terlokalisasi — Harga ditampilkan dalam mata uang lokal pelanggan secara default
Lebih banyak metode pembayaran — Membuka metode pembayaran yang hanya tersedia untuk mata uang lokal
Refund dalam mata uang yang sama — Mengembalikan dana pelanggan dalam mata uang yang mereka gunakan untuk membayar
Advanced pricing — Mengaktifkan Purchasing Power Parity dan Charm Pricing untuk mengoptimalkan harga secara otomatis berdasarkan pasar

Mengaktifkan Adaptive Currency

Open Settings

Masuk ke Merchant Dashboard dan buka Settings → Business.

Enable Adaptive Currency

Aktifkan Adaptive Currency. Anda dapat menonaktifkannya kapan saja.

Perubahan hanya berlaku untuk transaksi mendatang.

Save and Test

Simpan pengaturan Anda, lalu pastikan checkout pengujian menampilkan harga dalam mata uang lokal Anda jika didukung.

Pengalaman Pelanggan

Saat Adaptive Currency diaktifkan:

Deteksi — Sistem mendeteksi negara pelanggan berdasarkan alamat penagihan mereka
Pemilihan mata uang — Jika negara tersebut didukung, harga ditampilkan dalam mata uang lokal secara default. Pelanggan dapat kembali ke mata uang dasar Anda
Metode pembayaran — Metode pembayaran lokal ditampilkan jika berlaku
Checkout — Pembayaran diselesaikan dalam mata uang yang dipilih

Konversi dan Biaya

Adaptive Currency menagih pelanggan dalam mata uang lokal mereka menggunakan nilai tukar langsung. Biaya ditentukan berdasarkan tingkatan nilai pesanan:

4% untuk pesanan di bawah $500
3% untuk pesanan $500 hingga $1,500
2% untuk pesanan di atas $1,500

Secara default, biaya ini ditambahkan di atas harga yang ditampilkan dan ditanggung oleh pelanggan. Dengan pengaturan Fees Inclusive, Anda dapat menanggung biaya tersebut sendiri: pelanggan melihat harga dalam mata uang lokal yang sama, dan biaya dikurangkan dari settlement Anda.

Mengaktifkan Fees Inclusive

Open Settings

Buka Settings → Business dan aktifkan Adaptive Currency jika Anda belum mengaktifkannya.

Enable Fees Inclusive

Setelah Adaptive Currency aktif, aktifkan toggle Fees Inclusive di bagian yang sama.

Mode	Yang Dilihat Pelanggan	Settlement Merchant
Exclusive (default)	Harga lokal + biaya 2–4% di atasnya	Harga dasar penuh
Inclusive	Harga lokal (tidak berubah)	Harga dasar dikurangi biaya 2–4%

Penggantian Per Request

Anda dapat mengganti default merchant untuk setiap request dengan meneruskan adaptive_currency_fees_inclusive (boolean) pada pembayaran satu kali, subscription on-demand (on_demand.adaptive_currency_fees_inclusive), tagihan subscription, atau perubahan plan. Pada checkout sessions, parameter ini hanya diterima untuk subscription on-demand, sebagai subscription_data.on_demand.adaptive_currency_fees_inclusive, dan bukan pada level teratas request:

// Note: POST /payments is deprecated. Checkout sessions don't accept
// `adaptive_currency_fees_inclusive` for one-time payments, so this override
// still runs through the one-time payment route.
const payment = await client.payments.create({
  product_cart: [{ product_id: 'pdt_abc', quantity: 1 }],
  customer: { customer_id: 'cus_123' },
  billing: { country: 'US' },
  adaptive_currency_fees_inclusive: true, // override the business setting for this payment
  return_url: 'https://yoursite.com/return'
});

Transaksi INR → INR selalu diperlakukan sebagai inclusive, terlepas dari pengaturan bisnis atau penggantian per request.

Saat aturan Localized Pricing cocok, transaksi selalu diperlakukan sebagai inclusive, terlepas dari pengaturan Fees Inclusive atau penggantian per request apa pun. Pelanggan membayar tepat sebesar jumlah terlokalisasi yang Anda tetapkan, dan biaya konversi dikurangkan dari settlement Anda.

Mata Uang yang Didukung

Kode Mata Uang	Nama Mata Uang	Negara	Jumlah Minimum
AED	Dirham UEA	Uni Emirat Arab	2.00 AED
ALL	Lek Albania	Albania	50.00 ALL
AMD	Dram Armenia	Armenia	500.00 AMD
AUD	Dolar Australia	Australia, Nauru	0.50 AUD
AWG	Florin Aruba	Aruba	2.00 AWG
AZN	Manat Azerbaijan	Azerbaijan	2.00 AZN
BAM	Mark Konvertibel Bosnia-Herzegovina	Bosnia dan Herzegovina	2.00 BAM
BDT	Taka Bangladesh	Bangladesh	100.00 BDT
BMD	Dolar Bermuda	Bermuda	1.00 BMD
BND	Dolar Brunei	Brunei	1.00 BND
BOB	Boliviano Bolivia	Bolivia	5.00 BOB
BRL	Real Brasil	Brasil	0.50 BRL
BSD	Dolar Bahama	Bahama	1.00 BSD
BWP	Pula Botswana	Botswana	15.00 BWP
BZD	Dolar Belize	Belize	2.00 BZD
CAD	Dolar Kanada	Kanada	0.50 CAD
CHF	Franc Swiss	Swiss, Liechtenstein	0.50 CHF
CLP	Peso Cile	Cile	1000.00 CLP
CNY	Yuan Tiongkok	Tiongkok	4.00 CNY
CRC	Colón Kosta Rika	Kosta Rika	500.00 CRC
CZK	Koruna Ceko	Republik Ceko	15.00 CZK
DKK	Krone Denmark	Denmark, Greenland	2.50 DKK
DOP	Peso Dominika	Republik Dominika	100.00 DOP
EGP	Pound Mesir	Mesir	50.00 EGP
ETB	Birr Ethiopia	Ethiopia	100.00 ETB
EUR	Euro	Austria, Belgia, Siprus, Estonia, Finlandia, Prancis, Jerman, Yunani, Irlandia, Italia, Latvia, Lituania, Luksemburg, Malta, Belanda, Portugal, Slovakia, Slovenia, Spanyol, Andorra, Monako, Kroasia, San Marino, Montenegro	0.50 EUR
FJD	Dolar Fiji	Fiji	2.00 FJD
GBP	Pound Inggris	Britania Raya	0.30 GBP
GEL	Lari Georgia	Georgia	3.00 GEL
GMD	Dalasi Gambia	Gambia	100.00 GMD
GTQ	Quetzal Guatemala	Guatemala	10.00 GTQ
GYD	Dolar Guyana	Guyana	200.00 GYD
HKD	Dolar Hong Kong	Hong Kong	4.00 HKD
HNL	Lempira Honduras	Honduras	25.00 HNL
HUF	Forint Hungaria	Hungaria	175.00 HUF
IDR	Rupiah Indonesia	Indonesia	8500.00 IDR
ILS	Shekel Baru Israel	Israel	3.00 ILS
INR	Rupee India	India	5.00 INR
JPY	Yen Jepang	Jepang	50 JPY
KRW	Won Korea Selatan	Korea Selatan	50 KRW
KZT	Tenge Kazakhstan	Kazakhstan	500.00 KZT
LKR	Rupee Sri Lanka	Sri Lanka	300.00 LKR
LRD	Dolar Liberia	Liberia	200.00 LRD
LSL	Loti Lesotho	Lesotho	20.00 LSL
MAD	Dirham Maroko	Maroko	10.00 MAD
MKD	Denar Makedonia	Makedonia Utara	50.00 MKD
MOP	Pataca Makau	Makau	10.00 MOP
MUR	Rupee Mauritius	Mauritius	50.00 MUR
MVR	Rufiyaa Maladewa	Maladewa	15.00 MVR
MWK	Kwacha Malawi	Malawi	2000.00 MWK
MXN	Peso Meksiko	Meksiko	10.00 MXN
MYR	Ringgit Malaysia	Malaysia	4.00 MYR
NGN	Naira Nigeria	Nigeria	2000.00 NGN
NOK	Krone Norwegia	Norwegia	3.00 NOK
NPR	Rupee Nepal	Nepal	150.00 NPR
NZD	Dolar Selandia Baru	Selandia Baru	1.00 NZD
PEN	Sol Peru	Peru	3.00 PEN
PGK	Kina Papua Nugini	Papua Nugini	4.00 PGK
PHP	Peso Filipina	Filipina	50.00 PHP
PLN	Zloty Polandia	Polandia	2.00 PLN
PYG	Guaraní Paraguay	Paraguay	4000 PYG
QAR	Rial Qatar	Qatar	3.00 QAR
RON	Leu Rumania	Rumania	2.00 RON
RSD	Dinar Serbia	Serbia	60.00 RSD
SAR	Riyal Arab Saudi	Arab Saudi	2.00 SAR
SBD	Dolar Kepulauan Solomon	Kepulauan Solomon	10.00 SBD
SCR	Rupee Seychelles	Seychelles	15.00 SCR
SEK	Krona Swedia	Swedia	3.00 SEK
SGD	Dolar Singapura	Singapura	0.50 SGD
SZL	Lilangeni Eswatini	Eswatini	20.00 SZL
THB	Baht Thailand	Thailand	25.00 THB
TOP	Paʻanga Tonga	Tonga	2.00 TOP
TRY	Lira Turki	Turki	20.00 TRY
TWD	Dolar Taiwan Baru	Taiwan	20.00 TWD
TZS	Shilling Tanzania	Tanzania	3000.00 TZS
UYU	Peso Uruguay	Uruguay	50.00 UYU
VND	Dong Vietnam	Vietnam	12000 VND
WST	Tala Samoa	Samoa	2.00 WST
XAF	Franc CFA Afrika Tengah	Kamerun, Republik Afrika Tengah, Chad, Republik Kongo, Guinea Khatulistiwa, Gabon	300 XAF
XOF	Franc CFA Afrika Barat	Benin, Burkina Faso, Pantai Gading, Guinea-Bissau, Mali, Niger, Senegal, Togo	300 XOF
ZAR	Rand Afrika Selatan	Afrika Selatan	20.00 ZAR
ZMW	Kwacha Zambia	Zambia	30.00 ZMW

Refund dan Penyesuaian

Dodo Payments menerbitkan refund dalam mata uang yang awalnya digunakan pelanggan untuk membayar, menggunakan nilai tukar terbaru. Jumlah dalam mata uang dasar Anda tetap sama di dashboard, invoice, dan refund. Pelanggan dapat menerima jumlah dalam mata uang lokal yang lebih besar atau lebih kecil daripada jumlah awal, bergantung pada perubahan FX.

Biaya Adaptive Currency (biaya FX) tidak dikembalikan.

Contoh Refund

Anda menjual produk seharga 100 USD dengan Adaptive Currency yang diaktifkan
Pelanggan dari Kanada melihat harga 137 CAD dengan nilai tukar 1,37 CAD per 1 USD dan menyelesaikan pembelian
Dodo Payments memproses pembayaran tersebut dengan mengonversi 137 CAD menjadi 100 USD untuk settlement Anda
Kemudian, nilai tukar berubah menjadi 1,40 CAD per 1 USD dan Anda menerbitkan refund penuh
Dodo Payments memotong 100 USD dan mengembalikan 140 CAD kepada pelanggan

Invoice dan Perpajakan

Invoice hanya menampilkan jumlah dalam mata uang settlement
Pajak dan biaya platform dihitung berdasarkan jumlah dalam mata uang settlement
Contoh: penjualan sebesar $10 yang dikonversi menjadi 36 AED tetap ditampilkan sebagai $10 di Dashboard dan invoice

Semua jumlah dibulatkan sesuai logika pembulatan internal Dodo Payments.

Menetapkan Mata Uang Penagihan Per Checkout

Teruskan billing_currency untuk menetapkan mata uang penagihan secara eksplisit untuk checkout session:

Saat Adaptive Currency dinonaktifkan, billing_currency diabaikan.

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_one_time_or_subscription',
      quantity: 1
    }
  ],
  billing_currency: 'AED',
  return_url: 'https://example.com/return'
});

Halaman Terkait

Purchasing Power Parity

Kurangi harga berdasarkan negara secara otomatis. Memerlukan Adaptive Currency.

Charm Pricing

Bulatkan harga yang dikonversi ke akhiran yang rapi seperti 49.99. Memerlukan Adaptive Currency.

Localized Pricing

Tetapkan harga pasti untuk setiap negara atau mata uang, bukan menggunakan konversi otomatis.

Tax-Inclusive Pricing

Atur apakah harga Anda sudah termasuk pajak.

Checkout Session

Buat checkout sessions dengan konfigurasi mata uang penagihan.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Cara Kerjanya

Manfaat Utama

Mengaktifkan Adaptive Currency

Pengalaman Pelanggan

Konversi dan Biaya

Mengaktifkan Fees Inclusive

Penggantian Per Request

Mata Uang yang Didukung

Refund dan Penyesuaian

Contoh Refund

Invoice dan Perpajakan

Menetapkan Mata Uang Penagihan Per Checkout

Halaman Terkait

Purchasing Power Parity

Charm Pricing

Localized Pricing

Tax-Inclusive Pricing

Checkout Session

​Cara Kerjanya

​Manfaat Utama

​Mengaktifkan Adaptive Currency

​Pengalaman Pelanggan

​Konversi dan Biaya

​Mengaktifkan Fees Inclusive

​Penggantian Per Request

​Mata Uang yang Didukung

​Refund dan Penyesuaian

​Contoh Refund

​Invoice dan Perpajakan

​Menetapkan Mata Uang Penagihan Per Checkout

​Halaman Terkait

Purchasing Power Parity

Charm Pricing

Localized Pricing

Tax-Inclusive Pricing

Checkout Session

Cara Kerjanya

Manfaat Utama

Mengaktifkan Adaptive Currency

Pengalaman Pelanggan

Konversi dan Biaya

Mengaktifkan Fees Inclusive

Penggantian Per Request

Mata Uang yang Didukung

Refund dan Penyesuaian

Contoh Refund

Invoice dan Perpajakan

Menetapkan Mata Uang Penagihan Per Checkout

Halaman Terkait