Prezzi Localizzati

​

Cosa Sono i Prezzi Localizzati?

​

Casi d’Uso

​

Concetti Chiave

• Modalità di determinazione dei prezzi — Un prodotto si trova in una sola modalità alla volta, definita dal suo pricing_mode:
  • by_currency: un prezzo per valuta, indipendentemente dal paese. Chiunque paghi in EUR vede €9.99.
  • by_country: un prezzo specifico per un paese (₹999 in India), anche quando diversi paesi condividono la stessa valuta.
• Importi fissi, nell’unità minima — Il campo amount di una regola è un numero intero espresso nell’unità minima della valuta, come in qualsiasi altra parte dell’API: 99900 corrisponde a ₹999.00, mentre 999 corrisponde a €9.99. È un prezzo che imposti tu, mai un valore convertito.
• Una regola corrispondente prevale sui prezzi automatici — Quando una regola localizzata si applica a una riga, Purchasing Power Parity e Charm Pricing vengono entrambi ignorati per quella riga. Il cliente paga l’importo che hai impostato, senza modifiche.
• Quando nessuna regola corrisponde — Il prodotto mantiene il comportamento esistente: i clienti nella tua valuta base pagano direttamente il prezzo base; per tutti gli altri il prezzo viene convertito tramite Adaptive Currency.
• Le commissioni sono incluse quando si applica una regola — Il cliente paga esattamente l’importo che hai impostato. La commissione FX di Adaptive Currency viene assorbita da te (ed è considerata inclusa nelle commissioni per quella transazione) invece di essere aggiunta, quindi il prezzo locale indicato è sempre il prezzo addebitato.

​

Imposta nel Cruscotto

1

Open the product form

Nel tuo Cruscotto del commerciante, vai a Prodotti e crea un prodotto (o aprine uno esistente per modificarlo). Imposta il Prezzo di base e la valuta come di consueto.

2

Enable Localized Pricing and choose a mode

Nella sezione Prezzi, seleziona Prezzi Localizzati, quindi scegli Per Paese o Per Valuta.

3

Add a price for each market

Fai clic su Aggiungi Prezzo Paese o Aggiungi Prezzo Valuta, compila il pannello Prezzi Localizzati e fai clic su Aggiungi. Ogni mercato che aggiungi appare nella tabella delle sostituzioni, dove puoi modificarlo o rimuoverlo in seguito.

• By Country
• By Currency

Scegli un paese, seleziona la valuta ed inserisci l’importo (ad esempio ₹999 per l’India), quindi fai clic su Aggiungi.

Il paese ora appare nella tabella Sostituzioni per Paese, dove puoi modificarlo o rimuoverlo.

Scegli una valuta ed inserisci l’importo (ad esempio €9,99 per l’EUR), quindi fai clic su Aggiungi.

La valuta ora appare nella tabella Sostituzioni per Valuta, dove puoi modificarla o rimuoverla.

4

Save the product

Salva con Aggiungi prodotto. I prezzi localizzati si applicano immediatamente ai futuri check-out.

Esegui un test di check-out con un paese di fatturazione che ha una regola e conferma che l’importo localizzato appaia.

​

Gestione tramite API

​

Imposta la modalità di prezzo

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

​

Aggiungi un prezzo localizzato

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

​

Elenca, aggiorna e archivia

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

​

Come si Applica al Checkout

• Per Paese: cerca una regola che corrisponda al paese di fatturazione. Se esiste, al cliente viene addebitato l’importo della regola nella valuta della regola.
• Per Valuta: cerca una regola che corrisponda alla valuta del cliente (l’billing_currency, o la valuta derivata dal loro paese). Se esiste, al cliente viene addebitato l’importo della regola in quella valuta.
• Nessuna corrispondenza o nessun pricing_mode: si applica il prezzo base, addebitato direttamente quando la valuta del cliente è uguale a quella base, altrimenti convertito tramite Valuta Adattiva.

​

Come si applica ai cambi di piano degli abbonamenti

• Per paese: si applica una regola corrispondente al paese di fatturazione dell’abbonamento. Se la valuta della regola è diversa da quella in cui viene fatturato l’abbonamento, l’importo della regola viene convertito ai tassi FX correnti: la regola viene applicata, non ignorata.
• Per valuta: si applica una regola corrispondente alla valuta in cui viene addebitato il cliente, che paga esattamente l’importo della regola.
• Nessuna corrispondenza o nessun pricing_mode: si applica il prezzo base del nuovo piano, convertito tramite Adaptive Currency quando necessario, con lo stesso fallback del checkout.

• Le anteprime sono esatte. Preview Change Plan restituisce lo stesso importo localizzato addebitato dal cambio effettivo.
• I rinnovi mantengono il prezzo localizzato. Dopo il cambio, il nuovo piano si rinnova al suo importo localizzato, che continua a includere le commissioni, esattamente come un abbonamento creato a quel prezzo.
• La proroga utilizza gli importi effettivi. In caso di upgrade, il credito per il tempo non utilizzato si basa su quanto il cliente ha effettivamente pagato per il vecchio piano, mentre il nuovo piano viene valutato in base alla sua regola localizzata.
• I cambi programmati bloccano il prezzo al momento della programmazione. Un cambio programmato per la fine del periodo di fatturazione addebita l’importo calcolato al momento della programmazione, anche se nel frattempo modifichi la regola.
• La valuta di fatturazione non cambia mai. Un cambio di piano non modifica mai la valuta in cui viene regolato un abbonamento; una regola in un’altra valuta viene convertita tramite FX nella valuta dell’abbonamento.
• Gli add-on non sono localizzati. I prezzi degli add-on sul nuovo piano utilizzano sempre il prezzo base.

​

Comportamenti importanti

​

Best practice

• Mantieni un prezzo base sensato. È il fallback per ogni mercato senza una regola, convertito tramite Adaptive Currency.
• Inserisci numeri ordinati. Lo scopo di un importo fisso è ottenere un prezzo chiaro come ₹999, €9.99 o ¥1000, non un risultato FX. Per l’arrotondamento automatico in ogni valuta, consulta Charm Pricing.
• Scegli la modalità adatta allo scopo. Usa by_country per i prezzi basati sul potere d’acquisto; usa by_currency quando è sufficiente un prezzo per zona valutaria.
• Archivia invece di ricreare per le promozioni. L’archiviazione di una regola riporta il mercato ai prezzi base/adattivi preservando la cronologia; ricrea o modifica il prezzo in seguito secondo necessità.
• Controlla la voce fiscale prima di pubblicizzare un totale. Per i prodotti con imposte escluse, il cliente paga l’importo localizzato più le imposte: non indicarlo quindi come prezzo finale negli annunci.

​

Correlati