Lokalisierte Preisgestaltung

​

Was ist lokalisierte Preisgestaltung?

​

Anwendungsfälle

​

Kernkonzepte

• Preismodi — Ein Produkt befindet sich zu jedem Zeitpunkt genau in einem Modus, der durch seinen 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 länderspezifischer Preis (₹999 in Indien), auch wenn mehrere Länder dieselbe Währung verwenden.
• Feste Beträge in der kleinsten Einheit — Das amount einer Regel ist eine Ganzzahl in der kleinsten Einheit der Währung, genauso 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 umgerechneten 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. Der Kunde zahlt den von Ihnen festgelegten Betrag unverändert.
• Wenn keine Regel zutrifft — Das Produkt behält sein bestehendes Verhalten bei: Kunden in Ihrer Basiswährung zahlen den Basispreis direkt; alle anderen erhalten den über Adaptive Currency umgerechneten Preis.
• Gebühren sind bei einer passenden Regel inklusive — Der Kunde zahlt genau den von Ihnen festgelegten Betrag. Die FX-Gebühr von Adaptive Currency 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.

​

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.

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.

• By Country
• By Currency

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.

Das Land erscheint nun in der Länderüberschreibung Tabelle, wo Sie es bearbeiten oder entfernen können.

Wählen Sie eine Währung und geben Sie den Betrag ein (zum Beispiel €9,99 für EUR), und klicken Sie dann auf Hinzufügen.

Die Währung erscheint nun in der Währungsüberschreibung Tabelle, wo Sie sie bearbeiten oder entfernen können.

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

​

Setzen Sie den Preisgestaltungsmodus

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

​

Fügen Sie einen lokalisierten Preis hinzu

// ₹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
rules, 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 im Checkout

• 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.

​

Anwendung bei Änderungen des Abonnementplans

• Nach Land: Es gilt eine Regel, die dem Abrechnungsland des Abonnements entspricht. Wenn sich die Währung der Regel von der Abrechnungswährung des Abonnements unterscheidet, wird der Betrag der Regel zum aktuellen FX-Kurs umgerechnet — die Regel wird angewendet und nicht übersprungen.
• Nach Währung: Es gilt eine Regel, die der Währung entspricht, in der der Kunde abgerechnet wird, und dem Kunden wird exakt der Betrag der Regel berechnet.
• Keine Übereinstimmung oder kein pricing_mode: Es gilt der Grundpreis des neuen Plans, der bei Bedarf über Adaptive Currency umgerechnet wird — derselbe Fallback wie beim Checkout.

• Vorschauen sind exakt. Preview Change Plan gibt denselben lokalisierten Betrag zurück, der bei der tatsächlichen Änderung berechnet wird.
• Verlängerungen behalten den lokalisierten Preis bei. Nach der Änderung wird der neue Plan zu seinem lokalisierten Betrag verlängert — und bleibt gebühreninklusiv — genau wie ein Abonnement, das zu diesem Preis erstellt wurde.
• Proration verwendet tatsächliche Beträge. Bei einem Upgrade basiert das Guthaben 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 zum Zeitpunkt 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. Eine Planänderung wechselt niemals die Währung, in der ein Abonnement abgerechnet wird; eine Regel in einer anderen Währung wird per FX in diese Währung umgerechnet.
• Add-ons werden nicht lokalisiert. Add-on-Preise im neuen Plan verwenden immer ihre Grundpreise.

​

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 umgerechnet.
• Geben Sie übersichtliche Zahlen ein. Der Zweck eines festen Betrags ist ein aufgeräumter Preis wie ₹999, €9.99 oder ¥1000, kein FX-Ergebnis. Informationen zum automatischen Runden in jeder Währung finden Sie unter Charm Pricing.
• Wählen Sie den passenden Modus. Verwenden Sie by_country für eine an der Kaufkraft orientierte Preisgestaltung; verwenden Sie by_currency, wenn ein Preis pro Währungszone ausreicht.
• Archivieren Sie Regeln für Aktionen, statt sie neu zu erstellen. Durch das Archivieren einer Regel wird der Markt auf die Basis-/Adaptive-Preisgestaltung zurückgesetzt, während der Verlauf 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 Gesamtbetrag bewerben. Bei Produkten ohne enthaltene Steuern zahlt der Kunde den lokalisierten Betrag zuzüglich Steuern. Geben Sie ihn daher in Anzeigen nicht als Endpreis an.

​

Verwandte Themen