Mata Uang Adaptif

Tampilkan harga dalam mata uang lokal setiap pelanggan untuk mengurangi hambatan dan meningkatkan konversi. Deteksi, konversi, dan refund dalam mata uang yang sama secara otomatis.

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

1. Open Settings

   Masuk ke Merchant Dashboard dan buka Settings → Business.

2. Enable Adaptive Currency

   Aktifkan Adaptive Currency. Anda dapat menonaktifkannya kapan saja.

   Perubahan hanya berlaku untuk transaksi mendatang.

3. 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:

1. Deteksi — Sistem mendeteksi negara pelanggan berdasarkan alamat penagihan mereka
2. Pemilihan mata uang — Jika negara tersebut didukung, harga ditampilkan dalam mata uang lokal secara default. Pelanggan dapat kembali ke mata uang dasar Anda
3. Metode pembayaran — Metode pembayaran lokal ditampilkan jika berlaku
4. 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

1. Open Settings

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

2. 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.

​

Jumlah Minimum

Setiap pembayaran harus memenuhi jumlah minimum untuk mata uang yang digunakan pelanggan untuk membayar, dan langganan memiliki jumlah minimum yang lebih tinggi daripada pembayaran satu kali. Jumlah minimum yang sama berlaku untuk setiap metode pembayaran. Pemeriksaan menggunakan total, termasuk pajak.

Mata Uang Penagihan	Pembayaran Satu Kali	Langganan
USD	$0.50	$1.00
EUR dan GBP	0.50 EUR, 0.30 GBP	0.50 EUR, 0.30 GBP
Semua mata uang lainnya	Jumlah minimum dalam Mata Uang yang Didukung, dan setidaknya setara dengan $0.50	Jumlah minimum dalam Mata Uang yang Didukung, dan setidaknya setara dengan $1.00

Pembayaran dalam mata uang selain USD, EUR, dan GBP diselesaikan dalam USD. Untuk mata uang ini, checkout terlebih dahulu memeriksa harga yang dikonversi ke USD, sebelum biaya Adaptive Currency ditambahkan, lalu memeriksa jumlah dalam mata uang pelanggan. Jumlah tersebut harus lolos dari kedua pemeriksaan, sehingga jumlah minimum efektif dapat lebih tinggi daripada jumlah minimum yang tercantum untuk mata uang tersebut.

Sebagai contoh, jumlah minimum yang tercantum untuk AED adalah 2.00 AED, tetapi langganan dalam AED harus bernilai setidaknya $1.00, yang kira-kira setara dengan 3.70 AED. Langganan sebesar 2.00 AED gagal dalam pemeriksaan USD.

Jika pembayaran berada di bawah jumlah minimum, API mengembalikan TOTAL_PAYMENT_AMOUNT_BELOW_MINIMUM_AMOUNT. Pesan tersebut menyebutkan jumlah minimum yang gagal dipenuhi. Untuk pembayaran dalam mata uang lain, jumlah minimum tersebut dapat berupa jumlah minimum USD, seperti Minimum amount of 1.00 USD is required to process payment.

​

Mata Uang yang Didukung

Tabel ini mencantumkan jumlah minimum untuk setiap mata uang. Jumlah minimum berlaku untuk pembayaran satu kali dan langganan. Lihat Jumlah Minimum untuk pemeriksaan USD tambahan.

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	500 CLP
CNY	Yuan Tiongkok	Tiongkok	4.00 CNY
CRC	Koló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 Republik Dominika	Republik Dominika	100.00 DOP
EGP	Pound Mesir	Mesir	50.00 EGP
ETB	Birr Etiopia	Etiopia	100.00 ETB
EUR	Euro	Austria, Belgia, Siprus, Estonia, Finlandia, Prancis, Jerman, Yunani, Irlandia, Italia, Latvia, Lituania, Luksemburg, Malta, Belanda, Portugal, Slowakia, Slovenia, Spanyol, Andorra, Monako, Kroasia, San Marino, Montenegro	0.50 EUR
FJD	Dolar Fiji	Fiji	2.00 FJD
GBP	Pound Britania	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, Côte d’Ivoire, Guinea-Bissau, Mali, Niger, Senegal, Togo	300 XOF
ZAR	Rand Afrika Selatan	Afrika Selatan	20.00 ZAR
ZMW	Kwacha Zambia	Zambia	30.00 ZMW

​

Pengembalian Dana dan Penyesuaian

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

Biaya Adaptive Currency (biaya FX) tidak dikembalikan.

​

Contoh Pengembalian Dana

1. Anda menjual produk seharga 100 USD dengan Adaptive Currency diaktifkan
2. Pelanggan dari Kanada melihat harga 137 CAD dengan nilai tukar 1.37 CAD per 1 USD dan menyelesaikan pembelian
3. Dodo Payments memproses pembayaran dengan mengonversi 137 CAD menjadi 100 USD untuk settlement Anda
4. Kemudian, nilai tukar berubah menjadi 1.40 CAD per 1 USD dan Anda menerbitkan pengembalian dana penuh
5. 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 senilai $10 yang dikonversi menjadi 36 AED tetap ditampilkan sebagai $10 di Dashboard dan invoice

Semua jumlah dibulatkan sesuai dengan logika pembulatan internal Dodo Payments.

​

Tetapkan Mata Uang Penagihan untuk Setiap Checkout

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

Saat Adaptive Currency dinonaktifkan, billing_currency akan 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 yang persis untuk setiap negara atau mata uang, bukan menggunakan konversi otomatis.

Tax-Inclusive Pricing

Kontrol apakah harga Anda sudah termasuk pajak.

Checkout Session

Buat sesi checkout dengan konfigurasi mata uang penagihan.