Hoppa till huvudinnehåll

Vad är Lokala Priser?

Varje produkt har ett baspris i en basvaluta. Lokala Priser låter dig åsidosätta det baspriset med fasta priser du ställer in per valuta eller per land. Aktivera det genom att ställa in en pricing_mode på produkten, och bifoga sedan en regel per marknad. Det är en av tre oberoende hävstångar för internationell prissättning, var och en löser ett annat problem:
MekanismVad den görNumret kunden ser
Lokala PriserEtt fast pris du ställer in per valuta eller landExakt det belopp du ställer in
Adaptiv ValutaKonverterar automatiskt ditt baspris vid aktuella valutakurserBaspriset omräknat till nuvarande växelkurs
RabattkoderEn procentuell eller fast minskning av basprisetBaspris minus rabatten
Lokala Priser och Adaptiv Valuta fungerar tillsammans. När ingen lokal regel matchar faller produkten tillbaka till sitt baspris — debiteras direkt om kunden redan är i din basvaluta, eller konverteras via Adaptiv Valuta om inte.

Användningsområden

Purchasing Power Parity (PPP)

Ta ut mindre på priskänsliga marknader utan att rabattera din hemmamarknad. En by_country regel låter en $20 basprodukt säljas för ₹999 i Indien — anpassad till lokal köpkraft, inte en rak FX-konvertering. Det rekommenderade, inhemska sättet att köra PPP.

Charm Pricing

En live FX-konvertering av $19.99 landar på ett obekvämt nummer som €18.43. En by_currency regel ställer in det rena, psykologiskt anpassade priset kunder förväntar sig — €9.99, ¥1000, ₹499 — exakt som skrivet.

Reversible Market-Entry Promotions

Lanserar i ett nytt land? Lägg till en by_country regel med ett introduktionspris, sedan arkivera det när kampanjen slutar för att falla tillbaka till bas/adaptiv prissättning. Regler är arkiverade, aldrig raderade, så du håller en ren uppdatering av vad som var live och när.

Competitive Price-Matching

Fäst en enda marknad för att matcha en lokal konkurrent. En by_country regel för £9.00 i Storbritannien håller det exakta priset oavsett hur GBP/USD-kursen rör sig.

Kärnkoncept

  • Prissättningslägen — En produkt är i exakt ett läge åt gången, inställt av sin pricing_mode:
    • by_currency: ett pris per valuta, oavsett land. Alla som betalar i EUR ser €9.99.
    • by_country: ett pris specifikt för ett land (₹999 i Indien), även när flera länder delar en valuta.
  • Fasta belopp, i den minsta enheten — En regelns amount är ett heltal i valutans minsta enhet, samma som överallt annars i API:et: 99900 är ₹999.00, 999 är €9.99. Det är ett pris du sätter, aldrig ett omräknat värde.
  • När ingen regel matchar — Produkten bibehåller sitt befintliga beteende: kunder i din basvaluta betalar baspriset direkt; alla andra får det konverterat via Adaptiv Valuta.
  • Avgifter är inkluderade när en regel matchar — Kunden betalar exakt det belopp du ställer in. Adaptiv Valuta FX-avgiften absorberas av dig (behandlas som avgifter inkluderade för den transaktionen) snarare än läggas på, så ditt uppgivna 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.
Localized Pricing enabled on the product form with By Country selected
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.
Välj ett land, välj valutan och ange beloppet (till exempel ₹999 för Indien), klicka sedan på Lägg till.
Adding a 999 INR override for India
Landet visas nu i tabellen Land överskridningar, där du kan redigera eller ta bort det.
Country overrides table showing India at 999 INR
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

Lokala Priser är fullt tillgängliga via API. Ställ först in produktens prissättningsläge, sedan bifogar du regler.

Ställ in prissättningsläget

Ställ in pricing_mode när du skapar produkten (eller uppdaterar en befintlig). null betyder bas-endast, det befintliga beteendet.
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',
});

Lägg till ett lokaliserat pris

Bifoga en regel till produkten. I by_country läge är country_code obligatorisk; i by_currency läge måste den utelämnas.
// ₹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 en by_currency produkt, utelämna country_code. Till exempel, ett platt €9.99 för alla som betalar i EUR (currency: 'EUR', amount: 999).

Lista, uppdatera och arkivera

Du kan endast uppdatera en regels amount; valuta och land är fasta när de skapats. Arkivering är en idempotent mjuk-radering, så regeln slutar att matcha men stannar i din historik.
// 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

Se de fullständiga Produkt Lokala Priser endpunkterna: skapa, lista, hämta, uppdatera och arkivera.

Hur det tillämpas vid Kassa

Lokala priser löses per varurad, och endast för produkter som har en pricing_mode satt. Dodo Payments läser två signaler från förfrågan: kundens faktureringsland samt en valfri billing_currency (när den utelämnas härleds en valuta från faktureringslandet).
  • 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.
Varje varurad löses på egen hand, så du kan lokalisera en produkt och lämna andra på basprissättning inom samma kassa. Om någon rad matchar en lokaliserad regel, tvingas hela transaktionen till avgifter inklusive (se Kärnkoncept).

Viktiga Beteenden

BeteendeDetalj
Före skatt-beloppEtt lokaliserat belopp är priset före skatt. För produkterna med exkluderad skatt adderas skatt på toppen vid kassan, så det lokaliserade beloppet är inte den slutliga totalsumman. Se Skatt-Inkluderande Priser.
Inte för Betala Vad Du VillLokaliserade regler gäller aldrig för Betala Vad Du Vill produkter, där kunden väljer beloppet.
Per valuta skiljer sig från basEn by_currency regel måste använda en annan valuta än produktens basvaluta.
En regel per marknadEn produkt kan ha högst en aktiv regel per valuta (per-valuta) eller per land (per-land).
Alla produkttyperGäller för engångs-, abonnemangs- och användningsbaserade produkter.
Ändringar av lokaliserade regler ger inte ut sina egna webhooks. Det lösta beloppet visas på den resulterande betalningen eller prenumerationen precis som vilket annat pris som helst.

Bästa Praxis

  • Behåll ett vettigt baspris. Det är fallback för varje marknad utan regel, konverterad genom Adaptiv Valuta.
  • Runda till lokala charmpriser. Hela poängen med ett fast belopp är ett rent nummer som ₹999, €9.99 eller ¥1000, inte ett FX-resultat.
  • Välj rätt läge för jobbet. Använd by_country för köpkraftsprissättning; använd by_currency när ett pris per valutazon räcker.
  • Arkivera, återskapa inte, för kampanjer. Genom att arkivera en regel återgår marknaden till bas/adaptiv samtidigt som historiken bevaras; återskapa eller sätt om priserna senare vid behov.
  • Håll koll på skattrad innan du annonserar en totalsumma. För produkter med exkluderad skatt betalar kunden det lokaliserade beloppet plus skatt, så ange inte det som slutpriset i annonser.

Relaterade

Purchasing Power Parity

Inhemsk lokaliserad prissättning kontra platsbaserade rabattkoder för PPP.

Adaptive Currency

Automatisk FX-konvertering och avgiftshantering lokaliserad prissättning bygger på.

Tax-Inclusive Pricing

Kontrollera om dina priser inkluderar skatt.

Pay What You Want

Låt kunderna välja beloppet. Lokaliserade regler gäller inte där.
Senast ändrad 26 juni 2026