Adaptive Currency

Adaptive Currency zeigt Produktpreise in der lokalen Währung des Kunden anstatt nur in deiner Basiswährung an. Wenn aktiviert, verwendet der Checkout für unterstützte Länder standardmäßig die erkannte lokale Währung. Es besteht die Möglichkeit, wieder zu deiner Basiswährung zu wechseln.

So funktioniert es

Deine Basiswährung ist die Währung, in der du das Produkt oder Add-on bepreist hast – sie kann jede Währung sein, die Dodo Payments belasten kann, nicht nur USD. Adaptive Currency rechnet diesen Basispreis zu aktuellen Wechselkursen um. Wenn du stattdessen für jede Währung oder jedes Land einen eigenen Festpreis festlegen möchtest, siehe Localized Pricing.

Zentrale Vorteile

Lokaler Checkout – Preise werden standardmäßig in der lokalen Währung des Kunden angezeigt
Mehr Zahlungsmethoden – Zahlungsmethoden, die nur für die lokale Währung verfügbar sind, werden freigeschaltet
Rückerstattungen in derselben Währung – Erstatte dem Kunden den Betrag in der Währung zurück, in der er bezahlt hat
Erweiterte Preisgestaltung – Aktiviert Purchasing Power Parity und Charm Pricing zur automatischen Preisoptimierung nach Markt

Adaptive Currency aktivieren

Open Settings

Melde dich in deinem Merchant Dashboard an und gehe zu Settings → Business.

Enable Adaptive Currency

Aktiviere Adaptive Currency. Du kannst die Funktion jederzeit deaktivieren.

Die Änderungen gelten nur für zukünftige Transaktionen.

Save and Test

Speichere deine Einstellungen und überprüfe anschließend in einem Test-Checkout, ob die Preise, sofern unterstützt, in deiner lokalen Währung angezeigt werden.

Kundenerlebnis

Wenn Adaptive Currency aktiviert ist:

Erkennung – Das System erkennt das Land des Kunden anhand seiner Rechnungsadresse
Währungsauswahl – Wenn das Land unterstützt wird, werden die Preise standardmäßig in der lokalen Währung angezeigt. Kunden können wieder zu deiner Basiswährung wechseln
Zahlungsmethoden – Lokale Zahlungsmethoden werden, sofern verfügbar, angezeigt
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 und verwendet dabei aktuelle Wechselkurse. Die Gebühren richten sich nach dem Bestellwert:

4 % für Bestellungen unter $500
3 % für Bestellungen von $500 bis $1,500
2 % für Bestellungen über $1,500

Standardmäßig werden diese Gebühren zusätzlich zu deinem angezeigten Preis berechnet und vom Kunden getragen. Mit der Einstellung Fees Inclusive kannst du die Gebühr selbst übernehmen: Der Kunde sieht denselben Preis in lokaler Währung und die Gebühr wird von deiner Auszahlung abgezogen.

Fees Inclusive aktivieren

Open Settings

Gehe zu Settings → Business und aktiviere Adaptive Currency, falls du dies noch nicht getan hast.

Enable Fees Inclusive

Aktiviere anschließend im selben Bereich den Schalter Fees Inclusive.

Modus	Für den Kunden sichtbar	Abrechnung für den Händler
Exclusive (Standard)	Lokaler Preis + 2–4 % zusätzliche Gebühr	Vollständiger Basispreis
Inclusive	Lokaler Preis (unverändert)	Basispreis minus 2–4 % Gebühr

Pro Anfrage überschreiben

Du kannst den Standardwert des Händlers pro Anfrage überschreiben, indem du adaptive_currency_fees_inclusive (boolean) bei einer einmaligen Zahlung, einem On-Demand-Abonnement (on_demand.adaptive_currency_fees_inclusive), einer Abonnementbelastung oder einer Planänderung übergibst. Bei Checkout-Sessions wird dies nur für On-Demand-Abonnements als subscription_data.on_demand.adaptive_currency_fees_inclusive akzeptiert und nicht auf der obersten Ebene der Anfrage:

// 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'
});

Transaktionen von INR → INR werden unabhängig von der Geschäftseinstellung oder der Überschreibung pro Anfrage immer als inklusive behandelt.

Wenn eine Regel für Localized Pricing greift, wird die Transaktion unabhängig von deiner Einstellung Fees Inclusive oder einer Überschreibung pro Anfrage immer als inklusive behandelt. Der Kunde zahlt genau den von dir festgelegten lokalisierten Betrag und die Umrechnungsgebühr wird von deiner Auszahlung abgezogen.

Mindestbeträge

Jede Zahlung muss den Mindestbetrag für die Währung erfüllen, in der der Kunde bezahlt. Für Abonnements gelten höhere Mindestbeträge als für einmalige Zahlungen. Für jede Zahlungsmethode gelten dieselben Mindestbeträge. Die Prüfung verwendet den Gesamtbetrag einschließlich Steuern.

Abrechnungswährung	Einmalige Zahlungen	Abonnements
USD	$0.50	$1.00
EUR und GBP	0.50 EUR, 0.30 GBP	0.50 EUR, 0.30 GBP
Jede andere Währung	Der Mindestbetrag unter Unterstützte Währungen, mindestens jedoch der Gegenwert von $0.50	Der Mindestbetrag unter Unterstützte Währungen, mindestens jedoch der Gegenwert von $1.00

Zahlungen in anderen Währungen als USD, EUR und GBP werden in USD abgerechnet. Für diese Währungen prüft der Checkout zunächst den in USD umgerechneten Preis, bevor die Adaptive Currency-Gebühr hinzugefügt wird, und prüft anschließend den Betrag in der Währung des Kunden. Der Betrag muss beide Prüfungen bestehen. Daher kann der effektive Mindestbetrag höher sein als der für die Währung aufgeführte Mindestbetrag. Beispielsweise beträgt der aufgeführte Mindestbetrag für AED 2.00 AED. Ein Abonnement in AED muss jedoch mindestens einen Wert von $1.00 haben, was etwa 3.70 AED entspricht. Ein Abonnement über 2.00 AED besteht die USD-Prüfung nicht. Liegt eine Zahlung unter dem Mindestbetrag, gibt die API TOTAL_PAYMENT_AMOUNT_BELOW_MINIMUM_AMOUNT zurück. Die Meldung nennt den nicht erfüllten Mindestbetrag. Bei einer Zahlung in einer anderen Währung kann dies der USD-Mindestbetrag sein, beispielsweise Minimum amount of 1.00 USD is required to process payment.

Unterstützte Währungen

Die Tabelle enthält den Mindestbetrag für jede Währung. Der Mindestbetrag gilt für einmalige Zahlungen und Abonnements. Weitere Informationen zur zusätzlichen USD-Prüfung finden Sie unter Mindestbeträge.

Währungscode	Währungsname	Länder	Mindestbetrag
AED	VAE-Dirham	Vereinigte Arabische Emirate	2.00 AED
ALL	Albanischer Lek	Albanien	50.00 ALL
AMD	Armenischer Dram	Armenien	500.00 AMD
AUD	Australischer Dollar	Australien, Nauru	0.50 AUD
AWG	Aruba-Florin	Aruba	2.00 AWG
AZN	Aserbaidschanischer Manat	Aserbaidschan	2.00 AZN
BAM	Konvertible Mark von Bosnien und Herzegowina	Bosnien und Herzegowina	2.00 BAM
BDT	Bangladeschischer Taka	Bangladesch	100.00 BDT
BMD	Bermudischer Dollar	Bermuda	1.00 BMD
BND	Brunei-Dollar	Brunei	1.00 BND
BOB	Bolivianischer Boliviano	Bolivien	5.00 BOB
BRL	Brasilianischer Real	Brasilien	0.50 BRL
BSD	Bahama-Dollar	Bahamas	1.00 BSD
BWP	Botswanischer Pula	Botswana	15.00 BWP
BZD	Belize-Dollar	Belize	2.00 BZD
CAD	Kanadischer Dollar	Kanada	0.50 CAD
CHF	Schweizer Franken	Schweiz, Liechtenstein	0.50 CHF
CLP	Chilenischer Peso	Chile	500 CLP
CNY	Chinesischer Yuan	China	4.00 CNY
CRC	Costa-Rica-Colón	Costa Rica	500.00 CRC
CZK	Tschechische Krone	Tschechien	15.00 CZK
DKK	Dänische Krone	Dänemark, Grönland	2.50 DKK
DOP	Dominikanischer Peso	Dominikanische Republik	100.00 DOP
EGP	Ägyptisches Pfund	Ägypten	50.00 EGP
ETB	Äthiopischer Birr	Äthiopien	100.00 ETB
EUR	Euro	Österreich, Belgien, Zypern, Estland, Finnland, Frankreich, Deutschland, Griechenland, Irland, Italien, Lettland, Litauen, Luxemburg, Malta, Niederlande, Portugal, Slowakei, Slowenien, Spanien, Andorra, Monaco, Kroatien, San Marino, Montenegro	0.50 EUR
FJD	Fidschi-Dollar	Fidschi	2.00 FJD
GBP	Britisches Pfund	Vereinigtes Königreich	0.30 GBP
GEL	Georgischer Lari	Georgien	3.00 GEL
GMD	Gambischer Dalasi	Gambia	100.00 GMD
GTQ	Guatemaltekischer Quetzal	Guatemala	10.00 GTQ
GYD	Guyana-Dollar	Guyana	200.00 GYD
HKD	Hongkong-Dollar	Hongkong	4.00 HKD
HNL	Honduranische Lempira	Honduras	25.00 HNL
HUF	Ungarischer Forint	Ungarn	175.00 HUF
IDR	Indonesische Rupiah	Indonesien	8500.00 IDR
ILS	Israelischer Neuer Schekel	Israel	3.00 ILS
INR	Indische Rupie	Indien	5.00 INR
JPY	Japanischer Yen	Japan	50 JPY
KRW	Südkoreanischer Won	Südkorea	50 KRW
KZT	Kasachischer Tenge	Kasachstan	500.00 KZT
LKR	Sri-Lanka-Rupie	Sri Lanka	300.00 LKR
LRD	Liberianischer Dollar	Liberia	200.00 LRD
LSL	Lesothischer Loti	Lesotho	20.00 LSL
MAD	Marokkanischer Dirham	Marokko	10.00 MAD
MKD	Mazedonischer Denar	Nordmazedonien	50.00 MKD
MOP	Macao-Pataca	Macau	10.00 MOP
MUR	Mauritius-Rupie	Mauritius	50.00 MUR
MVR	Maledivische Rufiyaa	Malediven	15.00 MVR
MWK	Malawischer Kwacha	Malawi	2000.00 MWK
MXN	Mexikanischer Peso	Mexiko	10.00 MXN
MYR	Malaysischer Ringgit	Malaysia	4.00 MYR
NGN	Nigerianischer Naira	Nigeria	2000.00 NGN
NOK	Norwegische Krone	Norwegen	3.00 NOK
NPR	Nepalische Rupie	Nepal	150.00 NPR
NZD	Neuseeland-Dollar	Neuseeland	1.00 NZD
PEN	Peruanischer Sol	Peru	3.00 PEN
PGK	Papua-Neuguinea-Kina	Papua-Neuguinea	4.00 PGK
PHP	Philippinischer Peso	Philippinen	50.00 PHP
PLN	Polnischer Złoty	Polen	2.00 PLN
PYG	Paraguayischer Guaraní	Paraguay	4000 PYG
QAR	Katar-Riyal	Katar	3.00 QAR
RON	Rumänischer Leu	Rumänien	2.00 RON
RSD	Serbischer Dinar	Serbien	60.00 RSD
SAR	Saudi-Riyal	Saudi-Arabien	2.00 SAR
SBD	Salomonen-Dollar	Salomonen	10.00 SBD
SCR	Seychellen-Rupie	Seychellen	15.00 SCR
SEK	Schwedische Krone	Schweden	3.00 SEK
SGD	Singapur-Dollar	Singapur	0.50 SGD
SZL	Swasi-Lilangeni	Eswatini	20.00 SZL
THB	Thailändischer Baht	Thailand	25.00 THB
TOP	Tonga-Paʻanga	Tonga	2.00 TOP
TRY	Türkische Lira	Türkei	20.00 TRY
TWD	Neuer Taiwan-Dollar	Taiwan	20.00 TWD
TZS	Tansania-Schilling	Tansania	3000.00 TZS
UYU	Uruguayischer Peso	Uruguay	50.00 UYU
VND	Vietnamesischer Dong	Vietnam	12000 VND
WST	Samoanischer Tala	Samoa	2.00 WST
XAF	Zentralafrikanischer CFA-Franc	Kamerun, Zentralafrikanische Republik, Tschad, Republik Kongo, Äquatorialguinea, Gabun	300 XAF
XOF	Westafrikanischer CFA-Franc	Benin, Burkina Faso, Côte d’Ivoire, Guinea-Bissau, Mali, Niger, Senegal, Togo	300 XOF
ZAR	Südafrikanischer Rand	Südafrika	20.00 ZAR
ZMW	Sambischer Kwacha	Sambia	30.00 ZMW

Rückerstattungen und Anpassungen

Dodo Payments stellt Rückerstattungen in der Währung aus, in der der Kunde ursprünglich bezahlt hat, und verwendet dabei den aktuellen Wechselkurs. Der Betrag in Ihrer Basiswährung bleibt in Ihrem Dashboard, auf Rechnungen und in der Rückerstattung unverändert. Je nach Änderungen der Wechselkurse kann der Kunde mehr oder weniger als den ursprünglichen Betrag in der Landeswährung erhalten.

Adaptive Currency-Gebühren (FX-Gebühren) werden nicht erstattet.

Beispiel für eine Rückerstattung

Sie verkaufen ein Produkt für 100 USD mit aktivierter Adaptive Currency
Ein kanadischer Kunde sieht 137 CAD bei einem Wechselkurs von 1.37 CAD pro 1 USD und schließt den Kauf ab
Dodo Payments verarbeitet die Zahlung und rechnet 137 CAD für Ihre Abrechnung in 100 USD um
Später ändert sich der Wechselkurs auf 1.40 CAD pro 1 USD und Sie veranlassen eine vollständige Rückerstattung
Dodo Payments zieht 100 USD ab und erstattet dem Kunden 140 CAD

Rechnungen und Besteuerung

Rechnungen zeigen nur den Betrag in der Abrechnungswährung
Steuern und Plattformgebühren werden auf Grundlage des Betrags in der Abrechnungswährung berechnet
Beispiel: Ein Verkauf über $10, der in 36 AED umgerechnet wird, wird im Dashboard und auf Rechnungen weiterhin als $10 ausgewiesen

Alle Beträge werden gemäß der internen Rundungslogik von Dodo Payments gerundet.

Abrechnungswährung pro Checkout festlegen

Übergeben Sie billing_currency, um die Abrechnungswährung für eine Checkout-Sitzung ausdrücklich festzulegen:

Wenn Adaptive Currency deaktiviert ist, wird billing_currency ignoriert.

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'
});

Purchasing Power Parity

Preise automatisch nach Land reduzieren. Erfordert Adaptive Currency.

Charm Pricing

Umgerechnete Preise auf runde Endungen wie 49.99 abrunden. Erfordert Adaptive Currency.

Localized Pricing

Einen exakten Preis pro Land oder Währung festlegen, statt automatisch umzurechnen.

Tax-Inclusive Pricing

Festlegen, ob Ihre Preise Steuern enthalten.

Checkout Session

Checkout-Sitzungen mit Konfiguration der Abrechnungswährung erstellen.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

So funktioniert es

Zentrale Vorteile

Adaptive Currency aktivieren

Kundenerlebnis

Umrechnung und Gebühren

Fees Inclusive aktivieren

Pro Anfrage überschreiben

Mindestbeträge

Unterstützte Währungen

Rückerstattungen und Anpassungen

Beispiel für eine Rückerstattung

Rechnungen und Besteuerung

Abrechnungswährung pro Checkout festlegen

Verwandte Seiten

Purchasing Power Parity

Charm Pricing

Localized Pricing

Tax-Inclusive Pricing

Checkout Session

​So funktioniert es

​Zentrale Vorteile

​Adaptive Currency aktivieren

​Kundenerlebnis

​Umrechnung und Gebühren

​Fees Inclusive aktivieren

​Pro Anfrage überschreiben

​Mindestbeträge

​Unterstützte Währungen

​Rückerstattungen und Anpassungen

​Beispiel für eine Rückerstattung

​Rechnungen und Besteuerung

​Abrechnungswährung pro Checkout festlegen

​Verwandte Seiten

Purchasing Power Parity

Charm Pricing

Localized Pricing

Tax-Inclusive Pricing

Checkout Session

So funktioniert es

Zentrale Vorteile

Adaptive Currency aktivieren

Kundenerlebnis

Umrechnung und Gebühren

Fees Inclusive aktivieren

Pro Anfrage überschreiben

Mindestbeträge

Unterstützte Währungen

Rückerstattungen und Anpassungen

Beispiel für eine Rückerstattung

Rechnungen und Besteuerung

Abrechnungswährung pro Checkout festlegen

Verwandte Seiten