Lokalisierte Preisgestaltung

​

Was ist lokalisierte Preisgestaltung?

​

Anwendungsfälle

​

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.

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 Grundpreis fest. Er dient als Fallback für jeden Markt ohne Regel und wird über Adaptive Currency umgerechnet.
• Runden Sie auf attraktive lokale Preise. Der Zweck eines festen Betrags ist eine klare Zahl wie ₹999, €9.99 oder ¥1000, nicht ein FX-Ergebnis.
• Wählen Sie den passenden Modus. Verwenden Sie by_country für eine Preisgestaltung nach Kaufkraft; 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 den Grundpreis bzw. Adaptive Currency zurückgesetzt, während die Historie erhalten bleibt; erstellen Sie sie später bei Bedarf neu oder legen Sie den Preis neu fest.
• Beachten Sie die Steuer vor der Werbung mit einem Gesamtpreis. Bei Produkten ohne enthaltene Steuern zahlt der Kunde den lokalisierten Betrag zuzüglich Steuern. Geben Sie ihn in Anzeigen daher nicht als Endpreis an.

​

Verwandte Themen