Zum Hauptinhalt springen
Adaptive Currency ermöglicht es dir, lokalisierte Preise anzuzeigen und Zahlungen in der lokalen Währung deiner Kunden zu akzeptieren. Dies verringert Reibungen beim Checkout und stärkt das Vertrauen.

Was ist Adaptive Currency?

Adaptive Currency zeigt Produktpreise in der lokalen Währung des Kunden an, anstatt in einer festen globalen Währung (zum Beispiel USD). Wenn aktiviert, wird beim Checkout standardmäßig die erkannte lokale Währung für unterstützte Länder verwendet, mit der Option, zu USD zu wechseln. Adaptive Currency konvertiert Ihren Basispreis zu aktuellen Wechselkursen. Um stattdessen einen festen Preis pro Währung oder Land festzulegen, siehe Localized Pricing.

Hauptvorteile

  • Lokalisierte Zahlungserfahrung: Preise werden standardmäßig in der lokalen Währung angezeigt.
  • Mehr Zahlungsmethoden: Schaltet Zahlungsmethoden frei, die für die lokale Währung verfügbar sind.
  • Rückerstattungen in gleicher Währung: Erstatten Sie dem Kunden in der Währung zurück, mit der er gezahlt hat.

Adaptive Currency aktivieren

1

Open Settings

Melden Sie sich im Händler-Dashboard an und gehen Sie zu Einstellungen → Geschäft.
2

Toggle Adaptive Pricing

Aktivieren Sie den Adaptive Pricing-Schalter. Sie können ihn jederzeit deaktivieren.
Änderungen gelten nur für zukünftige Transaktionen.
3

Confirm and Save

Speichern Sie Ihre Einstellungen.
Überprüfen Sie, ob ein Test-Checkout die Preise in Ihrer lokalen Währung anzeigt, sofern unterstützt.
Adaptive Currency

Kundenerfahrung

  1. Erkennung: Das System erkennt das Land des Kunden basierend auf der Rechnungsadresse.
  2. Währungsauswahl: Wenn das Land unterstützt wird, werden Preise standardmäßig in der lokalen Währung angezeigt. Kunden können auf USD wechseln.
  3. Zahlungsmethoden: Lokalisierte Zahlungsmethoden werden, wo anwendbar, angezeigt.
  4. Checkout: Die Zahlung wird in der ausgewählten Währung abgeschlossen.

Umrechnung und Gebühren

Adaptive Currency belastet den Kunden in seiner lokalen Währung zu den neuesten Wechselkursen.
  • Sie zahlen: 0% (Standard) oder 2–4% (wenn Gebühren inklusive aktiviert ist)
  • Ihre Kunden zahlen: 2–4% basierend auf dem Bestellwert (Standard) oder 0% (wenn Gebühren inklusive aktiviert ist)
Gestaffelte Gebühren werden beim Checkout angewendet:
  • 4% für Bestellungen unter 500 $
  • 3% für 500 bis 1.500 $
  • 2% für über 1.500 $

Wählen Sie, wer die Gebühr trägt

Standardmäßig werden Adaptive Currency-Gebühren zum angezeigten Preis hinzugefügt und vom Kunden getragen. Mit der Einstellung Fees Inclusive können Sie die Gebühr selbst tragen: der Kunde sieht den gleichen lokalen Währungspreis wie immer und die Gebühr wird von Ihrem Erlös abgezogen.
1

Enable Adaptive Pricing

Gehen Sie zu Einstellungen → Geschäft und aktivieren Sie den Adaptive Pricing-Schalter, falls Sie es noch nicht getan haben.
2

Toggle Fees Inclusive

Sobald Adaptive Pricing aktiviert ist, aktivieren Sie den Fees Inclusive-Unter-Schalter im selben Abschnitt.
ModusKunde siehtHändler erlöst
Exklusiv (Standard)Lokaler Preis + 2–4% Gebühr oben draufVoller Basispreis
InklusivLokaler Preis (unverändert)Basispreis minus der 2–4% Gebühr
Sie können den Händlersatz auch pro Anfrage überschreiben, indem Sie adaptive_currency_fees_inclusive (boolean) in einer Checkout-Session, Zahlung oder On-Demand-Abonnement übergeben:
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'
});
INR → INR Transaktionen werden immer als inklusive behandelt, unabhängig von den Unternehmenseinstellungen oder der pro Anfrage Überschreibung.
Wenn eine Localized Pricing Regel übereinstimmt, wird die Transaktion immer als inklusive behandelt, unabhängig von Ihren Fees Inclusive Einstellungen oder einer pro Anfrage Überschreibung. Der Kunde zahlt genau den lokalisierten Betrag, den Sie festgelegt haben, und die Umrechnungsgebühr wird von Ihrem Erlös abgezogen.

Unterstützte Währungen

WährungscodeWährungsnameLänderMindestbetrag
AEDUAE DirhamVereinigte Arabische Emirate2,00 AED
ALLAlbanischer LekAlbanien50,00 ALL
AMDArmenischer DramArmenien500,00 AMD
AUDAustralischer DollarAustralien, Nauru0,50 AUD
AWGAruba-FlorinAruba2,00 AWG
AZNAserbaidschan-ManatAserbaidschan2,00 AZN
BAMBosnisch-Herzegowinische Konvertible MarkBosnien und Herzegowina2,00 BAM
BDTBangladeshi-TakaBangladesch100,00 BDT
BMDBermudadollarBermuda1,00 BMD
BNDBrunei-DollarBrunei1,00 BND
BOBBolivianischer BolivianoBolivien5,00 BOB
BRLBrasilianischer RealBrasilien0,50 BRL
BSDBahama-DollarBahamas1,00 BSD
BWPBotswanischer PulaBotsuana15,00 BWP
BZDBelize-DollarBelize2,00 BZD
CADKanadischer DollarKanada0,50 CAD
CHFSchweizer FrankenSchweiz, Liechtenstein0,50 CHF
CLPChilenischer PesoChile1000,00 CLP
CNYChinesischer YuanChina4,00 CNY
CRCCosta-Rican-ColónCosta Rica500,00 CRC
CZKTschechische KroneTschechische Republik15,00 CZK
DKKDänische KroneDänemark, Grönland2,50 DKK
DOPDominikanischer PesoDominikanische Republik100,00 DOP
EGPÄgyptisches PfundÄgypten50,00 EGP
ETBÄthiopischer BirrÄthiopien100,00 ETB
EUREuroÖsterreich, Belgien, Zypern, Estland, Finnland, Frankreich, Deutschland, Griechenland, Irland, Italien, Lettland, Litauen, Luxemburg, Malta, Niederlande, Portugal, Slowakei, Slowenien, Spanien, Andorra, Monaco, Kroatien, San Marino, Montenegro0,50 EUR
FJDFidschi-DollarFidschi2,00 FJD
GBPBritisches PfundVereinigtes Königreich0,30 GBP
GELGeorgischer LariGeorgien3,00 GEL
GMDGambischer DalasiGambia100,00 GMD
GTQGuatemaltekischer QuetzalGuatemala10,00 GTQ
GYDGuyana-DollarGuyana200,00 GYD
HKDHongkong-DollarHongkong4,00 HKD
HNLHonduranische LempiraHonduras25,00 HNL
HUFUngarischer ForintUngarn175,00 HUF
IDRIndonesische RupiahIndonesien8500,00 IDR
ILSIsraelischer Neuer SchekelIsrael3,00 ILS
INRIndische RupieIndien5,00 INR
JPYJapanische YenJapan50 JPY
KRWSüdkoreanischer WonSüdkorea50 KRW
KZTKasachischer TengeKasachstan500,00 KZT
LKRSri-Lanka-RupieSri Lanka300,00 LKR
LRDLiberianischer DollarLiberia200,00 LRD
LSLLesotho-LotiLesotho20,00 LSL
MADMarokkanischer DirhamMarokko10,00 MAD
MKDMazedonischer DenarNordmazedonien50,00 MKD
MOPMacanesische PatacaMacau10,00 MOP
MURMauritius-RupieMauritius50,00 MUR
MVRMaledivische RufiyaaMalediven15,00 MVR
MWKMalawische KwachaMalawi2000,00 MWK
MXNMexikanischer PesoMexiko10,00 MXN
MYRMalaysischer RinggitMalaysia4,00 MYR
NGNNigerianische NairaNigeria2000,00 NGN
NOKNorwegische KroneNorwegen3,00 NOK
NPRNepalesische RupieNepal150,00 NPR
NZDNeuseeländischer DollarNeuseeland1,00 NZD
PENPeruanischer SolPeru3,00 PEN
PGKPapua-Neuguineische KinaPapua-Neuguinea4,00 PGK
PHPPhilippinischer PesoPhilippinen50,00 PHP
PLNPolnischer ZlotyPolen2,00 PLN
PYGParaguayischer GuaraníParaguay4000 PYG
QARKatar-RialKatar3,00 QAR
RONRumänischer LeuRumänien2,00 RON
RSDSerbischer DinarSerbien60,00 RSD
SARSaudi-RialSaudi-Arabien2,00 SAR
SBDSalomonen-DollarSalomonen10,00 SBD
SCRSeychellen-RupieSeychellen15,00 SCR
SEKSchwedische KroneSchweden3,00 SEK
SGDSingapur-DollarSingapur0,50 SGD
SZLSwasiländischer LilangeniEswatini20,00 SZL
THBThailändischer BahtThailand25,00 THB
TOPTongaische PaʻangaTonga2,00 TOP
TRYTürkische LiraTürkei20,00 TRY
TWDNeuer Taiwan-DollarTaiwan20,00 TWD
TZSTansanischer SchillingTansania3000,00 TZS
UYUUruguayischer PesoUruguay50,00 UYU
VNDVietnamesischer DongVietnam12000 VND
WSTSamoa-TalaSamoa2,00 WST
XAFZentralafrikanischer CFA-FrancKamerun, Zentralafrikanische Republik, Tschad, Republik Kongo, Äquatorialguinea, Gabun300 XAF
XOFWestafrikanischer CFA-FrancBenin, Burkina Faso, Côte d’Ivoire, Guinea-Bissau, Mali, Niger, Senegal, Togo300 XOF
ZARSüdafrikanischer RandSüdafrika20,00 ZAR
ZMWSambischer KwachaSambia30,00 ZMW

Rückerstattungen und Anpassungen

Dodo Payments stellt Rückerstattungen in der Währung aus, in der der Kunde ursprünglich gezahlt hat, unter Verwendung des neuesten Wechselkurses. Der globale USD-Betrag bleibt in Ihrem Dashboard, auf Rechnungen und in der Rückerstattung fixiert. Dies bedeutet, dass der Kunde je nach Wechselkursänderungen mehr oder weniger als den ursprünglichen lokalen Währungsbetrag erhalten kann.
Adaptive Currency-Gebühren, die im Allgemeinen die Wechselkursgebühren sind, werden nicht erstattet.
Beispielrückerstattung
  1. Sie verkaufen ein Produkt für 100 USD mit aktiviertem Adaptive Currency.
  2. Ein kanadischer Kunde sieht 137 CAD zu einem Wechselkurs von 1,37 CAD pro 1 USD und schließt den Kauf ab.
  3. Wir verarbeiten die Zahlung, indem wir 137 CAD in 100 USD für Ihre Abwicklung umwandeln.
  4. Später ändert sich der Wechselkurs auf 1,40 CAD pro 1 USD und Sie stellen eine vollständige Rückerstattung aus.
  5. Wir ziehen 100 USD ab und erstatten dem Kunden 140 CAD.

Rechnungen und Besteuerung

  • Auf Rechnungen wird nur der Betrag in der Abwicklungswährung angezeigt.
  • Steuern und Plattformgebühren werden auf der Grundlage des Betrags in der Abwicklungswährung berechnet.
  • Beispiel: ein 10 Verkauf,derin36AEDumgerechnetwird,wirdimDashboardundaufRechnungenweiterhinals10Verkauf, der in 36 AED umgerechnet wird, wird im Dashboard und auf Rechnungen weiterhin als 10 angezeigt.
Alle Beträge werden gemäß der internen Rundungslogik von Dodo Payments gerundet.

Integrationsbeispiele

Checkout-Sitzungen mit Abrechnungswährung Übergeben Sie billing_currency, um die Abrechnungswährung für die Sitzung explizit festzulegen.
Wenn Adaptive Pricing deaktiviert ist, wird billing_currency ignoriert.
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

Konfigurieren Sie die Abrechnungswährung über unsere Checkout Session API.
Zuletzt geändert am 26. Juni 2026