Mata Uang Adaptif - Dodo Payments Documentation

Adaptive Currency memungkinkan Anda menampilkan harga yang dilokalkan dan menerima pembayaran dalam mata uang lokal pelanggan. Ini mengurangi hambatan saat checkout dan membangun kepercayaan.

Apa Itu Mata Uang Adaptif?

Mata Uang Adaptif menampilkan harga produk dalam mata uang lokal pelanggan alih-alih mata uang global tetap (misalnya, USD). Ketika diaktifkan, checkout secara default menggunakan mata uang lokal yang terdeteksi untuk negara yang didukung, dengan opsi untuk beralih ke USD. Adaptive Currency mengonversi harga dasar Anda menggunakan nilai tukar langsung. Untuk menetapkan harga tetap per mata uang atau negara Anda sendiri, lihat Localized Pricing.

Manfaat Utama

Pengalaman pembayaran lokal: Harga muncul dalam mata uang lokal secara default.
Lebih banyak metode pembayaran: Membuka metode pembayaran tersedia untuk mata uang lokal.
Pengembalian dana mata uang yang sama: Kembalikan uang pelanggan dalam mata uang yang mereka gunakan untuk membayar.

Aktifkan Adaptive Currency

Open Settings

Masuk ke Merchant Dashboard Anda dan buka Pengaturan → Bisnis.

Toggle Adaptive Pricing

Aktifkan toggle Adaptive Pricing. Anda dapat menonaktifkannya kapan saja.

Perubahan hanya berlaku untuk transaksi di masa mendatang.

Confirm and Save

Simpan pengaturan Anda.

Pastikan checkout tes menunjukkan harga dalam mata uang lokal Anda saat didukung.

Pengalaman Konsumen

Deteksi: Sistem mendeteksi negara pelanggan berdasarkan alamat penagihan.
Pemilihan mata uang: Jika negara didukung, harga muncul dalam mata uang lokal secara default. Pelanggan dapat beralih ke USD.
Metode pembayaran: Metode pembayaran lokal muncul jika tersedia.
Checkout: Pembayaran diselesaikan dalam mata uang yang dipilih.

Konversi dan Biaya

Adaptive Currency mengenakan biaya kepada pelanggan dalam mata uang lokal mereka menggunakan nilai tukar terbaru.

Anda membayar: 0% (default) atau 2–4% (saat biaya inklusif diaktifkan)
Pelanggan Anda membayar: 2–4% berdasarkan nilai pesanan (default) atau 0% (saat biaya inklusif diaktifkan)

Biaya bertingkat diterapkan pada saat checkout:

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

Pilih siapa yang menanggung biaya

Secara default, biaya mata uang adaptif ditambahkan di atas harga yang ditampilkan dan ditanggung oleh pelanggan. Dengan pengaturan Biaya Inklusif, Anda dapat menanggung biaya sendiri: pelanggan melihat harga mata uang lokal yang sama seperti biasanya, dan biaya dikurangi dari penyelesaian Anda.

Enable Adaptive Pricing

Buka Pengaturan → Bisnis dan aktifkan toggle Adaptive Pricing jika Anda belum melakukannya.

Toggle Fees Inclusive

Setelah Adaptive Pricing diaktifkan, aktifkan sub-toggle Fees Inclusive di bagian yang sama.

Mode	Pelanggan melihat	Pedagang menyelesaikan
Eksklusif (default)	Harga lokal + biaya 2–4% di atasnya	Harga dasar penuh
Inklusif	Harga lokal (tidak berubah)	Harga dasar dikurangi biaya 2–4%

Anda juga dapat mengesampingkan default pedagang per permintaan dengan meneruskan adaptive_currency_fees_inclusive (boolean) pada sesi checkout, pembayaran, atau langganan sesuai permintaan:

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_abc', quantity: 1 }],
  adaptive_currency_fees_inclusive: true, // override the business setting for this session
  return_url: 'https://yoursite.com/return'
});

Transaksi INR → INR selalu diperlakukan sebagai inklusif tanpa memandang pengaturan bisnis atau pengesampingan per-permintaan.

Saat aturan Localized Pricing cocok, transaksi selalu diperlakukan sebagai inklusif, tanpa memandang pengaturan Biaya Inklusif Anda atau pengesampingan per-permintaan apa pun. Pelanggan membayar persis jumlah terlokalisasi yang Anda tetapkan, dan biaya konversi dikurangi dari penyelesaian 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 Chili	Chili	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 Etiopia	Etiopia	100.00 ETB
EUR	Euro	Austria, Belgia, Siprus, Estonia, Finlandia, Prancis, Jerman, Yunani, Irlandia, Italia, Latvia, Lithuania, 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 Hongaria	Hongaria	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 Romania	Romania	2.00 RON
RSD	Dinar Serbia	Serbia	60.00 RSD
SAR	Riyal 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 Swazi	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 mengeluarkan pengembalian dana dalam mata uang yang awalnya dibayar pelanggan, menggunakan nilai tukar terbaru. Jumlah USD global tetap di dasbor Anda, faktur, dan dalam pengembalian dana. Ini berarti pelanggan mungkin menerima lebih atau kurang dari jumlah mata uang lokal asli tergantung pada perubahan FX.

Biaya Adaptive Currency yang umumnya adalah biaya FX tidak dikembalikan.

Contoh pengembalian dana

Anda menjual produk seharga 100 USD dengan Adaptive Currency diaktifkan.
Pelanggan Kanada melihat 137 CAD pada nilai tukar 1.37 CAD per 1 USD dan menyelesaikan pembelian.
Kami memproses pembayaran, mengonversi 137 CAD menjadi 100 USD untuk penyelesaian Anda.
Kemudian, nilai tukar berubah menjadi 1.40 CAD per 1 USD dan Anda mengeluarkan pengembalian dana penuh.
Kami memotong 100 USD dan mengembalikan dana kepada pelanggan 140 CAD.

Faktur dan Perpajakan

Faktur hanya menunjukkan jumlah mata uang penyelesaian.
Pajak dan biaya platform dihitung berdasarkan jumlah mata uang penyelesaian.
Contoh: penjualan $10 yang dikonversi menjadi 36 AED tetap tercatat sebagai$ 10 di Dasbor dan faktur.

Semua jumlah dibulatkan sesuai dengan logika pembulatan internal Dodo Payments.

Contoh Integrasi

Checkout Sessions dengan mata uang penagihan Terapkan billing_currency untuk menetapkan mata uang penagihan secara eksplisit untuk sesi tersebut.

Saat Adaptive Pricing dinonaktifkan, billing_currency diabaikan.

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

Checkout Session

Konfigurasikan Mata Uang Penagihan menggunakan API Sesi Checkout kami.

​Apa Itu Mata Uang Adaptif?

​Manfaat Utama

​Aktifkan Adaptive Currency

​Pengalaman Konsumen

​Konversi dan Biaya

​Pilih siapa yang menanggung biaya

​Mata Uang yang Didukung

​Pengembalian Dana dan Penyesuaian

​Faktur dan Perpajakan

​Contoh Integrasi

Checkout Session

Apa Itu Mata Uang Adaptif?

Manfaat Utama

Aktifkan Adaptive Currency

Pengalaman Konsumen

Konversi dan Biaya

Pilih siapa yang menanggung biaya

Mata Uang yang Didukung

Pengembalian Dana dan Penyesuaian

Faktur dan Perpajakan

Contoh Integrasi