Lokala Priser

​

Vad är Lokala Priser?

​

Användningsområden

​

Grundläggande begrepp

• Prissättningslägen — En produkt är alltid i exakt ett läge, som anges med 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:et: 99900 är ₹999.00 och 999 är €9.99. Det är ett pris som 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 både Purchasing Power Parity och Charm Pricing över för den raden. I kassan betalar kunden exakt det belopp du anger, oförändrat. Vid byte av prenumerationsplan omvandlas en regel i en annan valuta än prenumerationen. Se Så tillämpas det vid byte av prenumerationsplan.
• När ingen regel matchar — Produkten behåller sitt befintliga beteende: kunder i din basvaluta betalar baspriset direkt, medan alla andra får priset omvandlat via Adaptive Currency.
• Avgifter inkluderas när en regel matchar — Kunden betalar exakt det belopp du anger. FX-avgiften för Adaptive Currency absorberas av dig (och behandlas som avgiftsinkluderad för transaktionen) i stället för att läggas ovanpå. Ditt angivna lokala pris är därför alltid det debiterade priset.

​

Konfigurera i Dashboard

1

Open the product form

Gå till Products i din Merchant Dashboard och skapa en produkt (eller öppna en befintlig för redigering). Ange baspriset under Price och välj valuta som vanligt.

2

Enable Localized Pricing and choose a mode

I avsnittet Pricing markerar du Localized Pricing och väljer sedan By Country eller By Currency.

3

Add a price for each market

Klicka på Add Country Price eller Add Currency Price, fyll i panelen Localized pricing och klicka på Add. Varje marknad du lägger till visas i tabellen över åsidosättningar, där du senare kan redigera eller ta bort den.

• By Country
• By Currency

Välj ett land, välj valuta och ange beloppet (till exempel ₹999 för Indien). Klicka sedan på Add.

Landet visas nu i tabellen Country overrides, 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å Add.

Valutan visas nu i tabellen Currency overrides, där du kan redigera eller ta bort den.

4

Save the product

Spara med Add product. Localized prices tillämpas omedelbart på framtida kassatransaktioner.

Genomför en testbetalning med ett faktureringsland som har en regel och bekräfta att det lokaliserade beloppet visas.

​

Hantera via API

​

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

​

Visa, 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
_, 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",
)

​

Så tillämpas det i kassan

• By Country: söker efter en regel som matchar faktureringslandet. Om en sådan finns debiteras kunden regelns belopp i regelns valuta.
• By Currency: söker efter en regel som matchar kundens valuta (billing_currency eller den valuta som härleds från kundens land). Om en sådan finns debiteras kunden regelns belopp i den valutan.
• Ingen matchning eller inget pricing_mode: baspriset gäller. Det debiteras direkt när kundens valuta motsvarar basvalutan och omvandlas annars via Adaptive Currency.

​

Så tillämpas det vid byte av prenumerationsplan

• By Country: en regel som matchar prenumerationens faktureringsland tillämpas. Om regelns valuta skiljer sig från valutan som prenumerationen faktureras i, omvandlas regelns belopp enligt aktuella FX-kurser — regeln tillämpas, den hoppas inte över.
• By Currency: en regel som matchar valutan kunden faktureras i tillämpas, och kunden debiteras exakt regelns belopp.
• Ingen matchning eller inget pricing_mode: det nya planens baspris gäller och omvandlas via Adaptive Currency vid behov — samma reservbeteende som i kassan.

• 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 avgiftsinkluderad — precis som en prenumeration som skapats till det priset.
• Proportionering använder verkliga belopp. Vid en uppgradering baseras krediten 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 schemaläggs 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 valutan som prenumerationen regleras i; en regel i en annan valuta omvandlas till den.
• Tillägg lokaliseras inte. Tilläggspriser på den nya planen använder alltid sin basprissättning.

​

Viktiga beteenden

​

Bästa praxis

• Ha ett rimligt baspris. Det används som reservpris på alla marknader utan regel och omvandlas via Adaptive Currency.
• Ange jämna belopp. 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. 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 återskapa vid kampanjer. När du arkiverar en regel återgår marknaden till baspris/Adaptive Pricing samtidigt som historiken bevaras. Skapa en ny regel eller prissätt om senare vid behov.
• Tänk på skatten innan du marknadsför ett totalpris. För produkter exklusive skatt betalar kunden det lokaliserade beloppet plus skatt. Ange därför inte beloppet som slutpris i annonser.

​

Relaterat