Lokala Priser

​

Vad är Lokala Priser?

​

Användningsområden

​

Kärnkoncept

• Prissättningslägen — En produkt är alltid i exakt ett läge, vilket anges av dess pricing_mode:
  • by_currency: ett pris per valuta, oavsett land. Alla som betalar i EUR ser €9.99.
  • by_country: ett landsspecifikt pris (₹999 i Indien), även när flera länder delar valuta.
• Fasta belopp i den minsta enheten — En regels amount är ett heltal i valutans minsta enhet, precis som överallt annars i API:t: 99900 är ₹999.00 och 999 är €9.99. Det är ett pris du anger, aldrig ett omvandlat värde.
• En matchande regel vinner över automatisk prissättning — När en lokaliserad regel gäller för en rad hoppas Purchasing Power Parity och Charm Pricing båda över för den raden. Kunden betalar det belopp du anger, oförändrat.
• När ingen regel matchar — Produkten behåller sitt befintliga beteende: kunder i din basvaluta betalar baspriset direkt, medan alla andra får det omvandlat genom Adaptive Currency.
• Avgifter inkluderas när en regel matchar — Kunden betalar exakt det belopp du anger. FX-avgiften för Adaptive Currency betalas av dig (hanteras som avgiftsinkluderad för den transaktionen) i stället för att läggas ovanpå, så ditt angivna lokala pris alltid är det pris som debiteras.

​

Installera i Dashboard

1

Open the product form

Gå till Produkter i ditt Handlardashboard och skapa en produkt (eller öppna en befintlig för att redigera). Ställ in basPris och valuta som vanligt.

2

Enable Localized Pricing and choose a mode

I Prissättningssektionen, kryssa i Lokala Priser, välj sedan Per Land eller Per Valuta.

3

Add a price for each market

Klicka på Lägg till Land Pris eller Lägg till Valuta Pris, fyll i panelen Lokala priser, och klicka på Lägg till. Varje marknad du lägger till visas i överskrivningstabellen, där du kan redigera eller ta bort det senare.

• By Country
• By Currency

Välj ett land, välj valutan och ange beloppet (till exempel ₹999 för Indien), klicka sedan på Lägg till.

Landet visas nu i tabellen Land överskridningar, där du kan redigera eller ta bort det.

Välj en valuta och ange beloppet (till exempel €9.99 för EUR), klicka sedan på Lägg till.

Valutan visas nu i tabellen Valuta översikter, där du kan redigera eller ta bort det.

4

Save the product

Spara med Lägg till produkt. Lokala priser gäller framtida kassor omedelbart.

Kör ett testköp med ett faktureringsland som har en regel, och bekräfta att det lokaliserade beloppet visas.

​

Hantera via API

​

Ställ in prissättningsläget

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

​

Lägg till ett lokaliserat pris

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

​

Lista, uppdatera och arkivera

// 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",
)

​

Hur det tillämpas vid Kassa

• Per Land: söker efter en regel som matchar faktureringslandet. Om en sådan finns debiteras kunden regelns belopp i regelns valuta.
• Per Valuta: söker efter en regel som matchar kundens valuta (billing_currency, eller valutan härledd från deras land). Om en sådan finns debiteras kunden regelns belopp i den valutan.
• Ingen match, eller ingen pricing_mode: baspriset gäller, debiteras direkt när kundens valuta motsvarar basvalutan, annars konverteras via Adaptiv Valuta.

​

Så fungerar det vid ändringar av prenumerationsplaner

• Per land: en regel som matchar prenumerationens faktureringsland tillämpas. Om regelns valuta skiljer sig från valutan som prenumerationen faktureras i, konverteras regelns belopp enligt aktuella FX-kurser — regeln tillämpas, den hoppas inte över.
• Per valuta: en regel som matchar valutan som kunden faktureras i tillämpas, och kunden debiteras exakt regelns belopp.
• Ingen matchning eller ingen pricing_mode: den nya planens grundpris tillämpas och konverteras via Adaptive Currency vid behov — samma reservlösning som vid checkout.

• Förhandsvisningar är exakta. Preview Change Plan returnerar samma lokaliserade belopp som den faktiska ändringen debiterar.
• Förnyelser behåller det lokaliserade priset. Efter ändringen förnyas den nya planen till sitt lokaliserade belopp — och förblir inklusive avgifter — precis som en prenumeration som skapats till det priset.
• Proportionell debitering använder verkliga belopp. Vid en uppgradering baseras krediteringen för outnyttjad tid på vad kunden faktiskt betalade för den gamla planen, medan den nya planen prissätts enligt sin lokaliserade regel.
• Schemalagda ändringar låser priset när de schemaläggs. En ändring som schemalagts till slutet av faktureringsperioden debiterar det belopp som beräknades när den schemalades, även om du redigerar regeln däremellan.
• Faktureringsvalutan ändras aldrig. Ett planbyte byter aldrig den valuta som en prenumeration regleras i; en regel i en annan valuta konverteras till den med FX.
• Tillägg lokaliseras inte. Tilläggspriser på den nya planen använder alltid sin grundprissättning.

​

Viktiga beteenden

​

Bästa praxis

• Håll ett rimligt baspris. Det används som reservpris på alla marknader utan regel och omvandlas genom Adaptive Currency.
• Ange tydliga belopp. Hela poängen med ett fast belopp är ett snyggt pris som ₹999, €9.99 eller ¥1000, inte ett FX-resultat. För automatisk avrundning i alla valutor, se Charm Pricing.
• Välj rätt läge för ändamålet. Använd by_country för köpkraftsbaserad prissättning och by_currency när ett pris per valutaområde räcker.
• Arkivera i stället för att skapa om vid kampanjer. När du arkiverar en regel återgår marknaden till bas-/Adaptive Currency-prissättning samtidigt som historiken bevaras. Skapa om eller prissätt på nytt senare efter behov.
• Tänk på skatteraden innan du annonserar ett totalpris. För produkter där skatt inte ingår betalar kunden det lokaliserade beloppet plus skatt, så ange inte detta som slutpris i annonser.

​

Relaterat