Zum Hauptinhalt springen

Was ist lokalisierte Preisgestaltung?

Jedes Produkt hat einen Basispreis in einer Basiswährung. Mit der lokalisierten Preisgestaltung können Sie diesen Basispreis durch feste Preise, die Sie pro Währung oder pro Land festlegen, überschreiben. Aktivieren Sie es, indem Sie eine pricing_mode für das Produkt festlegen und dann eine Regel pro Markt anhängen. Es ist einer von drei unabhängigen Hebeln für internationale Preisgestaltung, die jeweils ein anderes Problem lösen:
MechanismusWas es tutDer Betrag, den der Kunde sieht
Lokalisierte PreisgestaltungEin fester Preis pro Währung oder LandGenau der Betrag, den Sie festgelegt haben
Adaptive CurrencyWandelt Ihren Basispreis automatisch zu aktuellen Wechselkursen umBasispreis, umgerechnet zum aktuellen Wechselkurs
RabattcodesEin Prozentsatz oder ein fester Abzug vom BasispreisBasispreis minus Rabatt
Lokalisierte Preisgestaltung und Adaptive Currency arbeiten zusammen. Wenn keine lokalisierte Regel übereinstimmt, fällt das Produkt auf seinen Basispreis zurück — bei Kunden, die sich bereits in Ihrer Basiswährung befinden, direkt abgerechnet oder durch Adaptive Currency umgerechnet.

Anwendungsfälle

Purchasing Power Parity (PPP)

In preissensiblen Märkten weniger verlangen, ohne Ihren Heimatmarkt zu rabattieren. Eine by_country Regel lässt ein Produkt zu ₹999 in Indien verkaufen — angepasst an die lokale Kaufkraft, nicht an eine einfache FX-Umrechnung. Die empfohlene, native Methode zur Durchführung von PPP.

Charm Pricing

Eine Live-FX-Umrechnung von $19,99 führt zu einer ungeraden Zahl wie €18,43. Eine by_currency Regel setzt den sauberen, psychologisch abgestimmten Preis, den Kunden erwarten — €9,99, ¥1.000, ₹499 — genau wie eingegeben.

Reversible Market-Entry Promotions

Starten Sie in einem neuen Land? Fügen Sie eine by_country Regel mit einem Einführungspreis hinzu und archivieren Sie diese, wenn die Aktion endet, um auf Basis-/Adaptive-Pricing zurückzufallen. Regeln werden archiviert, niemals gelöscht, sodass Sie einen sauberen Verlauf dessen behalten, was und wann live war.

Competitive Price-Matching

Befestigen Sie einen einzelnen Markt, um einen lokalen Wettbewerber zu treffen. Eine by_country Regel für £9,00 in Großbritannien hält diesen genauen Preis unabhängig davon, wie sich der GBP/USD-Kurs bewegt.

Kernkonzepte

  • Preisgestaltungsmodi — Ein Produkt befindet sich zu einem Zeitpunkt in genau einem Modus, festgelegt durch seinen pricing_mode:
    • by_currency: ein Preis pro Währung, unabhängig vom Land. Jeder, der in EUR zahlt, sieht €9,99.
    • by_country: ein landesspezifischer Preis (₹999 in Indien), selbst wenn mehrere Länder eine Währung teilen.
  • Feste Beträge in der kleinsten Einheit — Ein amount einer Regel ist eine Ganzzahl in der kleinsten Einheit der Währung, wie überall sonst in der API: 99900 ist ₹999,00, 999 ist €9,99. Es ist ein Preis, den Sie festlegen, niemals ein umgerechneter Wert.
  • Wenn keine Regel übereinstimmt — Das Produkt behält sein bestehendes Verhalten bei: Kunden in Ihrer Basiswährung zahlen den Basispreis direkt; alle anderen erhalten es umgerechnet durch die Adaptive Currency.
  • Gebühren sind inklusive, wenn eine Regel zutrifft — Der Kunde zahlt genau den Betrag, den Sie festgelegt haben. Die Adaptive Currency FX-Gebühr wird von Ihnen übernommen (behandelt als gebühreninklusive für diese Transaktion), anstatt zusätzlich erhoben zu werden, sodass Ihr angegebener lokaler Preis immer der tatsächlich berechnete Preis ist.

Setup im Dashboard

1

Open the product form

Gehen Sie in Ihrem Merchant-Dashboard zu Produkte und erstellen Sie ein Produkt (oder öffnen Sie ein bestehendes zur Bearbeitung). Legen Sie den Basis Preis und die Währung wie üblich fest.
2

Enable Localized Pricing and choose a mode

Im Abschnitt Preisgestaltung aktivieren Sie Lokalisierte Preisgestaltung und wählen dann Nach Land oder Nach Währung.
Lokalisierte Preisgestaltung auf dem Produktformular mit Nach Land ausgewählt
3

Add a price for each market

Klicken Sie auf Länderpreis hinzufügen oder Währungspreis hinzufügen, füllen Sie das Lokalisierte Preisgestaltung Panel aus und klicken Sie auf Hinzufügen. Jeder hinzugefügte Markt erscheint in der Überschreibungstabelle, wo Sie ihn später bearbeiten oder entfernen können.
Wählen Sie ein Land, wählen Sie die Währung und geben Sie den Betrag ein (zum Beispiel ₹999 für Indien), und klicken Sie dann auf Hinzufügen.
Hinzufügen einer 999 INR Überschreibung für Indien
Das Land erscheint nun in der Länderüberschreibung Tabelle, wo Sie es bearbeiten oder entfernen können.
Länderüberschreibungstabelle mit Indien bei 999 INR
4

Save the product

Speichern Sie mit Produkt hinzufügen. Lokalisierte Preise gelten sofort für zukünftige Checkouts.
Führen Sie einen Testcheckout mit einem Rechnungsland durch, das eine Regel hat, und bestätigen Sie, dass der lokalisierte Betrag angezeigt wird.

Verwaltung über die API

Lokalisierte Preisgestaltung ist vollständig über die API verfügbar. Setzen Sie zuerst den Preisgestaltungsmodus des Produkts und fügen Sie dann Regeln an.

Setzen Sie den Preisgestaltungsmodus

Setzen Sie pricing_mode, wenn Sie das Produkt erstellen (oder ein bestehendes aktualisieren). null bedeutet nur Basis, das bestehende Verhalten.
import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
  environment: 'test_mode',
});

const product = await client.products.update('pdt_premium_plan', {
  pricing_mode: 'by_country',
});

Fügen Sie einen lokalisierten Preis hinzu

Fügen Sie dem Produkt eine Regel hinzu. Im by_country Modus ist country_code erforderlich; im by_currency Modus muss er weggelassen werden.
// ₹999.00 for customers in India
const localizedPrice = await client.products.localizedPrices.create('pdt_premium_plan', {
  currency: 'INR',
  country_code: 'IN',
  amount: 99900,
});
Für ein by_currency Produkt, weglassen country_code. Zum Beispiel, ein fester €9.99 für alle, die in EUR bezahlen (currency: 'EUR', amount: 999).

Auflisten, aktualisieren und archivieren

Sie können nur das amount einer Regel aktualisieren; Währung und Land sind einmal erstellt festgelegt. Archivierung ist ein idempotentes Soft-Delete, damit die Regel nicht mehr übereinstimmt, aber in Ihrem Verlauf bleibt.
// List all active rules on a product
const rules = await client.products.localizedPrices.list('pdt_premium_plan');

// Change the amount (e.g. end a promo)
await client.products.localizedPrices.update('lcp_india_price', {
  product_id: 'pdt_premium_plan',
  amount: 119900,
});

// Archive a rule
await client.products.localizedPrices.archive('lcp_india_price', {
  product_id: 'pdt_premium_plan',
});

API Reference

Sehen Sie die vollständigen Produktlokalisierungspreisendpunkte: erstellen, auflisten, abrufen, aktualisieren und archivieren.

Anwendung im Checkout

Lokalisierte Preisgestaltung wird pro Warenkorbposition gelöst und nur für Produkte, die ein pricing_mode gesetzt haben. Dodo Payments liest zwei Signale aus der Anfrage: das Abrechnungsland des Kunden und eine optionale billing_currency (wenn nicht angegeben, wird eine Währung aus dem Abrechnungsland abgeleitet).
  • Nach Land: sucht nach einer Regel, die mit dem Abrechnungsland übereinstimmt. Wenn dies der Fall ist, wird beim Kunden die Betragsregel in der Währung der Regel berechnet.
  • Nach Währung: sucht nach einer Regel, die mit der Währung des Kunden übereinstimmt (die billing_currency, oder die Währung, die aus ihrem Land abgeleitet wird). Wenn dies der Fall ist, wird der Kunde in dieser Währung zum Regelbetrag belastet.
  • Keine Übereinstimmung oder kein pricing_mode: Der Basispreis gilt, der direkt berechnet wird, wenn die Währung des Kunden der Basiswährung entspricht, andernfalls umgerechnet durch Adaptive Currency.
Jede Warenkorbposition wird für sich gelöst, sodass Sie ein Produkt lokalisieren und andere beim Basispreis im selben Checkout belassen können. Wenn eine Position mit einer lokalisierten Regel übereinstimmt, wird die gesamte Transaktion zwangsweise gebühreninklusive durchgeführt (siehe Kernkonzepte).

Wichtige Verhaltensweisen

VerhaltenDetail
Beträge vor SteuernEin lokalisierter Betrag ist der Preis vor Steuern. Bei steuerexklusiven Produkten wird die Steuer beim Checkout aufgeschlagen, sodass der lokalisierte Betrag nicht die endgültige Summe ist. Siehe Steuerinklusive Preisgestaltung.
Nicht für Bezahle, was du willstLokalisierte Regeln gelten niemals für Produkte, bei denen der Kunde den Betrag wählt.
Währungsbezogen unterscheidet sich vom BasiswertEine by_currency Regel muss eine Währung nutzen, die sich von der Basiswährung des Produkts unterscheidet.
Eine Regel pro MarktEin Produkt kann höchstens eine aktive Regel pro Währung (nach Währung) oder pro Land (nach Land) haben.
Alle ProdukttypenGilt für einmalige, abonnementbasierte und nutzungsbasierte Produkte.
Änderungen an lokalisierten Regeln lösen keine eigenen Webhooks aus. Der aufgelöste Betrag erscheint auf der resultierenden Zahlung oder dem Abonnement wie jeder andere Preis.

Best Practices

  • Halten Sie einen sinnvollen Basispreis. Er ist das Fallback für jeden Markt ohne Regel, umgerechnet durch Adaptive Currency.
  • Runden Sie auf lokale Attraktivpreise. Der ganze Sinn eines festen Betrags besteht darin, eine saubere Zahl zu erhalten, wie ₹999, €9,99 oder ¥1.000, nicht ein FX-Ergebnis.
  • Wählen Sie den Modus für die Aufgabe. Verwenden Sie by_country für kaufkraftbasierte Preisgestaltung; verwenden Sie by_currency, wenn ein Preis pro Währungszone ausreicht.
  • Archivieren, nicht neu erstellen, für Aktionen. Das Archivieren einer Regel stellt den Markt auf Basis-/Adaptive-Pricing zurück, wobei die Historie erhalten bleibt; später neu erstellen oder neu bewerten, wie nötig.
  • Achten Sie auf die Steuerlinie, bevor Sie einen Gesamtbetrag bewerben. Bei steuerexklusiven Produkten zahlt der Kunde den lokalisierten Betrag plus Steuer, also geben Sie es nicht als endgültigen Preis in Anzeigen an.

Verwandte Themen

Purchasing Power Parity

Native lokalisierte Preisgestaltung vs. standortbasierte Rabattcodes für PPP.

Adaptive Currency

Automatische FX-Umrechnung und die Gebührenhandhabung, auf der die lokalisierte Preisgestaltung aufbaut.

Tax-Inclusive Pricing

Steuern kontrollieren, ob Ihre Preise inklusive Steuern sind.

Pay What You Want

Lassen Sie Kunden den Betrag wählen. Lokalisierte Regeln gelten dort nicht.
Zuletzt geändert am 26. Juni 2026