Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt

Use this file to discover all available pages before exploring further.

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.

Manfaat Utama

  • Pengalaman pembayaran yang dilokalisasi: Harga muncul dalam mata uang lokal secara default.
  • Lebih banyak metode pembayaran: Membuka metode pembayaran yang tersedia untuk mata uang lokal.
  • Pengembalian dana dalam mata uang yang sama: Mengembalikan dana kepada pelanggan dalam mata uang yang mereka bayar.

Aktifkan Mata Uang Adaptif

1

Open Settings

Masuk ke Dashboard Pedagang Anda dan buka Pengaturan → Bisnis.
2

Toggle Adaptive Pricing

Aktifkan toggle Adaptive Pricing. Anda dapat menonaktifkannya kapan saja.
Perubahan hanya berlaku untuk transaksi di masa mendatang.
3

Confirm and Save

Simpan pengaturan Anda.
Verifikasi bahwa test checkout menampilkan harga dalam mata uang lokal Anda saat didukung.
Adaptive Currency

Pengalaman Pelanggan

  1. Deteksi: Sistem mendeteksi negara pelanggan berdasarkan alamat penagihan.
  2. Pemilihan mata uang: Jika negara didukung, harga ditampilkan dalam mata uang lokal secara default. Pelanggan dapat beralih ke USD.
  3. Metode pembayaran: Metode pembayaran yang dilokalisasi muncul di mana berlaku.
  4. Checkout: Pembayaran diselesaikan dalam mata uang yang dipilih.

Konversi dan Biaya

Mata Uang Adaptif mengenakan biaya kepada pelanggan dalam mata uang lokal mereka menggunakan kurs terbaru.
  • Anda membayar: 0% (default) atau 2–4% (ketika biaya inklusif diaktifkan)
  • Pelanggan Anda membayar: 2–4% berdasarkan nilai pesanan (default) atau 0% (ketika biaya inklusif diaktifkan)
Biaya bertingkat diterapkan saat checkout:
  • 4% untuk pesanan di bawah $500
  • 3% untuk 500 hingga $1,500
  • 2% untuk lebih dari $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 menyerap biaya tersebut sendiri: pelanggan melihat harga lokal yang sama seperti biasa, dan biaya dikurangkan dari penyelesaian Anda.
1

Enable Adaptive Pricing

Buka Pengaturan → Bisnis dan aktifkan tombol Adaptif Pricing jika belum.
2

Toggle Fees Inclusive

Setelah Adaptif Pricing aktif, aktifkan sub-tombol Biaya Inklusif di bagian yang sama.
ModePelanggan melihatPedagang menyelesaikan
Eksklusif (default)Harga lokal + biaya 2–4% di atasnyaHarga dasar penuh
InklusifHarga lokal (tidak berubah)Harga dasar dikurangi biaya 2–4%
Anda juga dapat mengesampingkan default pedagang per permintaan dengan mengirimkan 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 penggantian per permintaan.

Mata Uang yang Didukung

Kode Mata UangNama Mata UangNegaraJumlah Minimum
AEDDirham UAEUni Emirat Arab2.00 AED
ALLLek AlbaniaAlbania50.00 ALL
AMDDram ArmeniaArmenia500.00 AMD
ARSPeso ArgentinaArgentina1000.00 ARS
AUDDolar AustraliaAustralia, Nauru0.50 AUD
AWGFlorin ArubaAruba2.00 AWG
AZNManat AzerbaijanAzerbaijan2.00 AZN
BAMMarka Konvertibel Bosnia-HerzegovinaBosnia dan Herzegovina2.00 BAM
BDTTaka BangladeshBangladesh100.00 BDT
BMDDolar BermudaBermuda1.00 BMD
BNDDolar BruneiBrunei1.00 BND
BOBBoliviano BoliviaBolivia5.00 BOB
BRLReal BrasilBrasil0.50 BRL
BSDDolar BahamaBahama1.00 BSD
BWPPula BotswanaBotswana15.00 BWP
BZDDolar BelizeBelize2.00 BZD
CADDolar KanadaKanada0.50 CAD
CHFFranc SwissSwiss, Liechtenstein0.50 CHF
CLPPeso CileCile1000.00 CLP
CNYYuan CinaChina4.00 CNY
CRCColón Kosta RikaKosta Rika500.00 CRC
CZKKoruna CekoRepublik Ceko15.00 CZK
DKKKrone DenmarkDenmark, Greenland2.50 DKK
DOPPeso DominikaRepublik Dominika100.00 DOP
EGPPound MesirMesir50.00 EGP
ETBBirr EthiopiaEthiopia100.00 ETB
EUREuroAustria, Belgia, Siprus, Estonia, Finlandia, Prancis, Jerman, Yunani, Irlandia, Italia, Latvia, Lithuania, Luksemburg, Malta, Belanda, Portugal, Slovakia, Slovenia, Spanyol, Andorra, San Marino, Montenegro0.50 EUR
FJDDolar FijiFiji2.00 FJD
GBPPound InggrisInggris Raya0.30 GBP
GELLari GeorgiaGeorgia3.00 GEL
GMDDalasi GambiaGambia100.00 GMD
GTQQuetzal GuatemalaGuatemala10.00 GTQ
GYDDolar GuyanaGuyana200.00 GYD
HKDDolar Hong KongHong Kong4.00 HKD
HNLLempira HondurasHonduras25.00 HNL
HUFForint HungariaHongaria175.00 HUF
IDRRupiah IndonesiaIndonesia8500.00 IDR
ILSShekel Baru IsraelIsrael3.00 ILS
INRRupee IndiaIndia5.00 INR
KZTTenge KazakhstanKazakhstan500.00 KZT
LKRRupee Sri LankaSri Lanka300.00 LKR
LRDDolar LiberiaLiberia200.00 LRD
LSLLoti LesothoLesotho20.00 LSL
MADDirham MarokoMaroko10.00 MAD
MKDDenar MakedoniaMakedonia Utara50.00 MKD
MOPPataca MakauMakau10.00 MOP
MURRupee MauritiusMauritius50.00 MUR
MVRRufiyaa MaladewaMaladewa15.00 MVR
MWKKwacha MalawiMalawi2000.00 MWK
MXNPeso MeksikoMeksiko10.00 MXN
MYRRinggit MalaysiaMalaysia4.00 MYR
NGNNaira NigeriaNigeria2000.00 NGN
NOKKrone NorwegiaNorwegia3.00 NOK
NPRRupee NepalNepal150.00 NPR
NZDDolar Selandia BaruSelandia Baru1.00 NZD
PENSol PeruPeru3.00 PEN
PGKKina Papua NuginiPapua Nugini4.00 PGK
PHPPeso FilipinaFilipina50.00 PHP
PLNZloty PolandiaPolandia2.00 PLN
QARRiyal QatarQatar3.00 QAR
RONLeu RumaniaRumania2.00 RON
RSDDinar SerbiaSerbia60.00 RSD
SARRiyal SaudiArab Saudi2.00 SAR
SBDDolar Kepulauan SolomonKepulauan Solomon10.00 SBD
SCRRupee SeychellesSeychelles15.00 SCR
SEKKrona SwediaSwedia3.00 SEK
SGDDolar SingapuraSingapura0.50 SGD
SZLLilangeni SwaziEswatini20.00 SZL
THBBaht ThailandThailand25.00 THB
TOPPaʻanga TongaTonga2.00 TOP
TRYLira TurkiTurki20.00 TRY
TWDDolar Taiwan BaruTaiwan20.00 TWD
TZSShilling TanzaniaTanzania3000.00 TZS
UYUPeso UruguayUruguay50.00 UYU
WSTTala SamoaSamoa2.00 WST
ZARRand Afrika SelatanAfrika Selatan20.00 ZAR
ZMWKwacha ZambiaZambia30.00 ZMW

Pengembalian Dana dan Penyesuaian

Dodo Payments mengeluarkan pengembalian dana dalam mata uang yang dibayar pelanggan awalnya, menggunakan nilai tukar terbaru. Jumlah USD global tetap tetap di dasbor, faktur, dan pengembalian dana. Artinya, pelanggan mungkin menerima lebih banyak atau lebih sedikit dari jumlah mata uang lokal asli tergantung pada perubahan FX.
Biaya Mata Uang Adaptif yang umumnya merupakan biaya FX tidak dikembalikan.
Contoh pengembalian dana
  1. Anda menjual produk seharga 100 USD dengan Mata Uang Adaptif diaktifkan.
  2. Pelanggan Kanada melihat 137 CAD pada nilai tukar 1.37 CAD per 1 USD dan menyelesaikan pembelian.
  3. Kami memproses pembayaran, mengonversi 137 CAD menjadi 100 USD untuk penyelesaian Anda.
  4. Kemudian, nilai tukar berubah menjadi 1.40 CAD per 1 USD dan Anda mengeluarkan pengembalian dana penuh.
  5. Kami mengurangi 100 USD dan mengembalikan 140 CAD kepada pelanggan.

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 tercermin sebagai $10 di Dasbor dan faktur.
Semua jumlah dibulatkan sesuai dengan logika pembulatan internal Dodo Payments.

Contoh Integrasi

Sesi Checkout dengan mata uang penagihan Pasangkan billing_currency untuk menetapkan mata uang penagihan secara eksplisit untuk sesi tersebut.
Ketika Adaptif 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

Konfigurasi Mata Uang Penagihan menggunakan API Sesi Checkout kami.
Last modified on May 14, 2026