Lokalisierte Preisgestaltung

​

Was ist lokalisierte Preisgestaltung?

​

Anwendungsfälle

​

Grundlegende Konzepte

• Preismodi — Ein Produkt befindet sich immer genau in einem Modus, der durch pricing_mode festgelegt wird:
  • by_currency: ein Preis pro Währung, unabhängig vom Land. Jeder, der in EUR bezahlt, sieht 9,99 €.
  • by_country: ein landesspezifischer Preis (₹999 in Indien), auch wenn mehrere Länder dieselbe Währung verwenden.
• Feste Beträge in der kleinsten Einheit — Der amount einer Regel ist eine Ganzzahl in der kleinsten Einheit der Währung, wie überall sonst in der API: 99900 entspricht ₹999,00, 999 entspricht 9,99 €. Es handelt sich um einen von Ihnen festgelegten Preis, niemals um einen konvertierten Wert.
• Eine passende Regel hat Vorrang vor der automatischen Preisgestaltung — Wenn eine lokalisierte Regel auf eine Position zutrifft, werden Purchasing Power Parity und Charm Pricing für diese Position übersprungen. Beim Checkout bezahlt der Kunde unverändert den von Ihnen festgelegten Betrag. Bei einem Wechsel des Abonnementplans wird eine Regel in einer anderen Währung als das Abonnement konvertiert; siehe Anwendung bei Änderungen des Abonnementplans.
• Wenn keine Regel passt — Das Produkt behält sein bisheriges Verhalten bei: Kunden in Ihrer Basiswährung bezahlen den Basispreis direkt; für alle anderen wird er über Adaptive Currency konvertiert.
• Gebühren sind bei einer passenden Regel inklusive — Der Kunde bezahlt genau den von Ihnen festgelegten Betrag. Die Adaptive Currency-Wechselkursgebühr wird von Ihnen übernommen (für diese Transaktion als gebühreninklusive behandelt), statt zusätzlich berechnet zu werden. Dadurch entspricht Ihr angegebener lokaler Preis immer dem berechneten Preis.

​

Im Dashboard einrichten

1

Open the product form

Gehen Sie in Ihrem Merchant Dashboard zu Products und erstellen Sie ein Produkt (oder öffnen Sie ein vorhandenes Produkt zur Bearbeitung). Legen Sie Price und Währung wie gewohnt fest.

2

Enable Localized Pricing and choose a mode

Aktivieren Sie im Abschnitt Pricing die Option Localized Pricing und wählen Sie anschließend By Country oder By Currency.

3

Add a price for each market

Klicken Sie auf Add Country Price oder Add Currency Price, füllen Sie das Fenster Localized pricing aus und klicken Sie auf Add. Jeder hinzugefügte Markt erscheint in der Tabelle mit Überschreibungen, wo Sie ihn später bearbeiten oder entfernen können.

• By Country
• By Currency

Wählen Sie ein Land und die Währung aus und geben Sie den Betrag ein (zum Beispiel ₹999 für Indien). Klicken Sie anschließend auf Add.

Das Land wird nun in der Tabelle Country overrides angezeigt, wo Sie es bearbeiten oder entfernen können.

Wählen Sie eine Währung aus, geben Sie den Betrag ein (zum Beispiel 9,99 € für EUR) und klicken Sie anschließend auf Add.

Die Währung wird nun in der Tabelle Currency overrides angezeigt, wo Sie sie bearbeiten oder entfernen können.

4

Save the product

Speichern Sie mit Add product. Lokalisierte Preise gelten sofort für zukünftige Checkouts.

Führen Sie einen Test-Checkout mit einem Abrechnungsland durch, für das eine Regel existiert, und bestätigen Sie, dass der lokalisierte Betrag angezeigt wird.

​

Über die API verwalten

​

Preismodus festlegen

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

import os
from dodopayments import DodoPayments

client = DodoPayments(
    bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"),
    environment="test_mode",
)

product = client.products.update(
    "pdt_premium_plan",
    pricing_mode="by_country",
)

package main

import (
	"context"
	"os"

	"github.com/dodopayments/dodopayments-go"
	"github.com/dodopayments/dodopayments-go/option"
)

func main() {
	client := dodopayments.NewClient(
		option.WithBearerToken(os.Getenv("DODO_PAYMENTS_API_KEY")),
	)

	err := client.Products.Update(
		context.TODO(),
		"pdt_premium_plan",
		dodopayments.ProductUpdateParams{
			PricingMode: dodopayments.F(dodopayments.PricingModeByCountry),
		},
	)
	if err != nil {
		panic(err)
	}
}

​

Lokalen Preis hinzufügen

// ₹999.00 for customers in India
const localizedPrice = await client.products.localizedPrices.create('pdt_premium_plan', {
  currency: 'INR',
  country_code: 'IN',
  amount: 99900,
});

# ₹999.00 for customers in India
localized_price = client.products.localized_prices.create(
    "pdt_premium_plan",
    currency="INR",
    country_code="IN",
    amount=99900,
)

// ₹999.00 for customers in India
localizedPrice, err := client.Products.LocalizedPrices.New(
	context.TODO(),
	"pdt_premium_plan",
	dodopayments.ProductLocalizedPriceNewParams{
		Currency:    dodopayments.F(dodopayments.CurrencyInr),
		CountryCode: dodopayments.F(dodopayments.CountryCodeIn),
		Amount:      dodopayments.F(int64(99900)),
	},
)

​

Auflisten, aktualisieren und archivieren

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

# List all active rules on a product
rules = client.products.localized_prices.list("pdt_premium_plan")

# Change the amount (e.g. end a promo)
client.products.localized_prices.update(
    "lcp_india_price",
    product_id="pdt_premium_plan",
    amount=119900,
)

# Archive a rule
client.products.localized_prices.archive(
    "lcp_india_price",
    product_id="pdt_premium_plan",
)

// List all active rules on a product
_, err := client.Products.LocalizedPrices.List(context.TODO(), "pdt_premium_plan")

// Change the amount (e.g. end a promo)
_, err = client.Products.LocalizedPrices.Update(
	context.TODO(),
	"pdt_premium_plan",
	"lcp_india_price",
	dodopayments.ProductLocalizedPriceUpdateParams{
		Amount: dodopayments.F(int64(119900)),
	},
)

// Archive a rule
err = client.Products.LocalizedPrices.Archive(
	context.TODO(),
	"pdt_premium_plan",
	"lcp_india_price",
)

​

Anwendung beim Checkout

• By Country: Sucht nach einer Regel, die dem Abrechnungsland entspricht. Wenn eine solche Regel existiert, wird dem Kunden der Betrag der Regel in deren Währung berechnet.
• By Currency: Sucht nach einer Regel, die der Währung des Kunden entspricht (billing_currency oder der aus dem Land abgeleiteten Währung). Wenn eine solche Regel existiert, wird dem Kunden der Betrag der Regel in dieser Währung berechnet.
• Keine Übereinstimmung oder kein pricing_mode: Der Basispreis gilt. Er wird direkt berechnet, wenn die Währung des Kunden der Basiswährung entspricht, andernfalls über Adaptive Currency konvertiert.

​

Anwendung bei Änderungen des Abonnementplans

• By Country: Eine Regel, die dem Abrechnungsland des Abonnements entspricht, wird angewendet. Wenn sich die Währung der Regel von der Abrechnungswährung des Abonnements unterscheidet, wird der Betrag der Regel zu aktuellen Wechselkursen konvertiert — die Regel wird angewendet und nicht übersprungen.
• By Currency: Eine Regel, die der Abrechnungswährung des Kunden entspricht, wird angewendet, und dem Kunden wird genau der Betrag der Regel berechnet.
• Keine Übereinstimmung oder kein pricing_mode: Der Basispreis des neuen Plans gilt und wird bei Bedarf über Adaptive Currency konvertiert — derselbe Fallback wie beim Checkout.

• Vorschauen sind exakt. Preview Change Plan gibt denselben lokalisierten Betrag zurück, der beim tatsächlichen Wechsel berechnet wird.
• Verlängerungen behalten den lokalisierten Preis. Nach dem Wechsel wird der neue Plan zu seinem lokalisierten Betrag verlängert und bleibt gebühreninklusive — genau wie ein Abonnement, das zu diesem Preis erstellt wurde.
• Anteilsberechnung verwendet tatsächliche Beträge. Bei einem Upgrade basiert die Gutschrift für die ungenutzte Zeit auf dem Betrag, den der Kunde tatsächlich für den alten Plan bezahlt hat, während der neue Plan anhand seiner lokalisierten Regel bepreist wird.
• Geplante Änderungen legen den Preis bei der Planung fest. Bei einer für das Ende des Abrechnungszeitraums geplanten Änderung wird der zum Zeitpunkt der Planung berechnete Betrag berechnet, selbst wenn Sie die Regel zwischenzeitlich bearbeiten.
• Die Abrechnungswährung ändert sich nie. Ein Planwechsel ändert niemals die Währung, in der ein Abonnement abgerechnet wird; eine Regel in einer anderen Währung wird per FX-Konvertierung in diese Währung umgerechnet.
• Add-ons werden nicht lokalisiert. Für Add-on-Preise im neuen Plan gilt immer die Basispreisgestaltung.

​

Wichtige Verhaltensweisen

​

Best Practices

• Legen Sie einen sinnvollen Basispreis fest. Er dient als Fallback für jeden Markt ohne Regel und wird über Adaptive Currency konvertiert.
• Geben Sie übersichtliche Zahlen ein. Der Zweck eines festen Betrags ist ein klarer Preis wie ₹999, 9,99 € oder ¥1000 — kein Wechselkursergebnis. Für automatische Rundungen in jeder Währung siehe Charm Pricing.
• Wählen Sie den passenden Modus. Verwenden Sie by_country für eine kaufkraftbasierte Preisgestaltung und by_currency, wenn ein Preis pro Währungszone ausreicht.
• Archivieren Sie Regeln, statt sie für Aktionen neu zu erstellen. Durch das Archivieren einer Regel kehrt der Markt zu Basispreis/Adaptive Currency zurück, während die Historie erhalten bleibt. Erstellen Sie später bei Bedarf eine neue Regel oder legen Sie den Preis neu fest.
• Beachten Sie die Steuerzeile, bevor Sie einen Gesamtpreis bewerben. Bei Produkten ohne Steuerinklusion zahlt der Kunde den lokalisierten Betrag plus Steuer. Geben Sie ihn daher in Anzeigen nicht als Endpreis an.

​

Verwandte Themen