Prezzi Localizzati

​

Cosa Sono i Prezzi Localizzati?

​

Casi d’Uso

​

Concetti Chiave

• Modalità di Prezzo — Un prodotto è in una sola modalità alla volta, impostata dal suo pricing_mode:
  • by_currency: un prezzo per valuta, indipendentemente dal paese. Tutti coloro che pagano in EUR vedono €9,99.
  • by_country: un prezzo specifico per un paese (₹999 in India), anche quando diversi paesi condividono una valuta.
• Importi Fissi, nell’unità più piccola — L’amount di una regola è un intero nell’unità più piccola della valuta, lo stesso di ovunque nell’API: 99900 è ₹999,00, 999 è €9,99. È un prezzo che imposti, mai un valore convertito.
• Quando non ci sono regole corrispondenti — Il prodotto mantiene il suo comportamento esistente: i clienti nella tua valuta base pagano direttamente il prezzo base; tutti gli altri ottengono il prezzo convertito tramite Valuta Adattiva.
• Le commissioni sono inclusive quando c’è una regola corrispondente — Il cliente paga esattamente l’importo che imposti. La commissione FX Valuta Adattiva è assorbita da te (trattata come commissioni-inclusive per quella transazione) piuttosto che aggiunta sopra, quindi il prezzo locale dichiarato è 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.
• Arrotonda a prezzi locali attraenti. Il punto di un importo fisso è ottenere un numero pulito come ₹999, €9.99 o ¥1000, non un risultato FX.
• Scegli la modalità adatta all’obiettivo. Usa by_country per la determinazione dei prezzi basata sul potere d’acquisto; usa by_currency quando è sufficiente un prezzo per area valutaria.
• Archivia, non ricreare, per le promozioni. L’archiviazione di una regola riporta il mercato al prezzo base/adattivo preservando lo storico; ricreala o ricalcola il prezzo in seguito secondo necessità.
• Considera la voce delle imposte prima di pubblicizzare un totale. Per i prodotti con imposte escluse, il cliente paga l’importo localizzato più le imposte: non presentarlo quindi come prezzo finale negli annunci.

​

Correlati