Prezzi Localizzati

​

Cosa Sono i Prezzi Localizzati?

​

Casi d’Uso

​

Concetti fondamentali

• Modalità di prezzo — Un prodotto si trova esattamente in una modalità alla volta, impostata dal relativo pricing_mode:
  • by_currency: un prezzo per valuta, indipendentemente dal paese. Chiunque paghi in EUR visualizza €9.99.
  • by_country: un prezzo specifico per paese (₹999 in India), anche quando più paesi condividono la stessa valuta.
• Importi fissi, nell’unità minima — Il valore amount di una regola è un intero nell’unità minima della valuta, come ovunque nell’API: 99900 equivale a ₹999.00, mentre 999 equivale a €9.99. È un prezzo impostato da te, mai un valore convertito.
• Una regola corrispondente prevale sui prezzi automatici — Quando una regola localizzata si applica a una riga, Parità del potere d’acquisto e Prezzi psicologici vengono saltati per quella riga. Al checkout, il cliente paga l’importo impostato da te, senza modifiche. Durante il cambio di piano di un abbonamento, una regola in una valuta diversa da quella dell’abbonamento viene convertita; consulta Come si applica ai cambi di piano degli abbonamenti.
• Quando nessuna regola corrisponde — Il prodotto mantiene il comportamento esistente: i clienti nella valuta di base pagano direttamente il prezzo di 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 impostato da te. La commissione FX di Adaptive Currency viene assorbita da te (la transazione viene trattata come comprensiva delle commissioni) invece di essere aggiunta, così il prezzo locale dichiarato corrisponde sempre al prezzo addebitato.

​

Configurazione nella Dashboard

1

Open the product form

Nel Merchant Dashboard, vai su Products e crea un prodotto (oppure aprine uno esistente per modificarlo). Imposta normalmente il Price di base e la valuta.

2

Enable Localized Pricing and choose a mode

Nella sezione Pricing, seleziona Localized Pricing, quindi scegli By Country o By Currency.

3

Add a price for each market

Fai clic su Add Country Price o Add Currency Price, compila il pannello Localized pricing e fai clic su Add. Ogni mercato aggiunto viene visualizzato nella tabella degli override, dove puoi modificarlo o rimuoverlo in seguito.

• By Country
• By Currency

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

Il paese viene ora visualizzato nella tabella Country overrides, dove puoi modificarlo o rimuoverlo.

Scegli una valuta e inserisci l’importo (ad esempio €9.99 per EUR), quindi fai clic su Add.

La valuta viene ora visualizzata nella tabella Currency overrides, dove puoi modificarla o rimuoverla.

4

Save the product

Salva con Add product. I prezzi localizzati vengono applicati immediatamente ai checkout futuri.

Esegui un checkout di test con un paese di fatturazione che dispone di una regola e verifica che venga visualizzato l’importo localizzato.

​

Gestione tramite API

​

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

​

Aggiunta di 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)),
	},
)

​

Elenco, aggiornamento e archiviazione

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

​

Come si applica al checkout

• By Country: cerca una regola corrispondente al paese di fatturazione. Se ne trova una, al cliente viene addebitato l’importo della regola nella valuta della regola.
• By Currency: cerca una regola corrispondente alla valuta del cliente (billing_currency oppure la valuta ricavata dal paese). Se ne trova una, al cliente viene addebitato l’importo della regola in quella valuta.
• Nessuna corrispondenza o nessun pricing_mode: si applica il prezzo di base, addebitato direttamente quando la valuta del cliente coincide con quella di base; in caso contrario viene convertito tramite Adaptive Currency.

​

Come si applica ai cambi di piano degli abbonamenti

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

• Le anteprime sono precise. 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 relativo importo localizzato e rimane comprensivo delle commissioni, esattamente come un abbonamento creato a quel prezzo.
• La ripartizione proporzionale usa gli importi effettivi. Durante un 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 secondo la relativa 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 del nuovo piano utilizzano sempre il prezzo di base.

​

Comportamenti importanti

​

Best practice

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

​

Correlati