Precios Localizados

​

¿Qué es el Precio Localizado?

​

Casos de Uso

​

Conceptos básicos

• Modos de precios — Un producto está exactamente en un modo a la vez, establecido por su pricing_mode:
  • by_currency: un precio por moneda, independientemente del país. Todos los que pagan en EUR ven €9.99.
  • by_country: un precio específico para un país (₹999 en India), incluso cuando varios países comparten una moneda.
• Importes fijos, en la unidad más pequeña — El amount de una regla es un entero en la unidad más pequeña de la moneda, igual que en el resto de la API: 99900 es ₹999.00, 999 es €9.99. Es un precio que estableces, nunca un valor convertido.
• Una regla coincidente prevalece sobre los precios automáticos — Cuando una regla localizada se aplica a una línea, Purchasing Power Parity y Charm Pricing se omiten para esa línea. En el checkout, el cliente paga el importe que estableciste, sin cambios. Al cambiar de plan de suscripción, una regla en una moneda diferente a la de la suscripción se convierte; consulta Cómo se aplica al cambiar de plan de suscripción.
• Cuando ninguna regla coincide — El producto mantiene su comportamiento actual: los clientes en tu moneda base pagan directamente el precio base; para el resto, se convierte mediante Adaptive Currency.
• Las comisiones están incluidas cuando coincide una regla — El cliente paga exactamente el importe que estableciste. La comisión de FX de Adaptive Currency la absorbes tú (se trata como comisiones incluidas para esa transacción) en lugar de añadirla, por lo que el precio local indicado siempre es el precio cobrado.

​

Configurar en el Dashboard

1

Open the product form

En tu Merchant Dashboard, ve a Products y crea un producto (o abre uno existente para editarlo). Establece el Price y la moneda base como de costumbre.

2

Enable Localized Pricing and choose a mode

En la sección Pricing, marca Localized Pricing y, a continuación, elige By Country o By Currency.

3

Add a price for each market

Haz clic en Add Country Price o Add Currency Price, completa el panel de Localized pricing y haz clic en Add. Cada mercado que añadas aparece en la tabla de anulaciones, donde podrás editarlo o eliminarlo más adelante.

• By Country
• By Currency

Elige un país, selecciona la moneda e introduce el importe (por ejemplo, ₹999 para India); después, haz clic en Add.

El país aparece ahora en la tabla de Country overrides, donde puedes editarlo o eliminarlo.

Elige una moneda e introduce el importe (por ejemplo, €9.99 para EUR); después, haz clic en Add.

La moneda aparece ahora en la tabla de Currency overrides, donde puedes editarla o eliminarla.

4

Save the product

Guarda con Add product. Los precios localizados se aplican inmediatamente a los futuros checkouts.

Realiza un checkout de prueba con un país de facturación que tenga una regla y confirma que aparece el importe localizado.

​

Gestionar mediante la API

​

Establecer el modo de precios

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

​

Añadir un precio localizado

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

​

Enumerar, actualizar y archivar

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

​

Cómo se aplica en el checkout

• By Country: busca una regla que coincida con el país de facturación. Si existe, se cobra al cliente el importe de la regla en la moneda de la regla.
• By Currency: busca una regla que coincida con la moneda del cliente (el billing_currency o la moneda obtenida de su país). Si existe, se cobra al cliente el importe de la regla en esa moneda.
• Sin coincidencia o sin pricing_mode: se aplica el precio base; se cobra directamente cuando la moneda del cliente coincide con la moneda base; de lo contrario, se convierte mediante Adaptive Currency.

​

Cómo se aplica al cambiar de plan de suscripción

• By Country: se aplica una regla que coincida con el país de facturación de la suscripción. Si la moneda de la regla difiere de la moneda en la que se factura la suscripción, el importe de la regla se convierte según los tipos de cambio actuales: la regla se aplica, no se omite.
• By Currency: se aplica una regla que coincida con la moneda en la que se factura al cliente, y se le cobra exactamente el importe de la regla.
• Sin coincidencia o sin pricing_mode: se aplica el precio base del nuevo plan, convertido mediante Adaptive Currency cuando sea necesario, el mismo fallback que en el checkout.

• Las vistas previas son exactas. Preview Change Plan devuelve el mismo importe localizado que se cobra en el cambio real.
• Las renovaciones mantienen el precio localizado. Después del cambio, el nuevo plan se renueva por su importe localizado y mantiene las comisiones incluidas, exactamente igual que una suscripción creada con ese precio.
• La prorrata usa importes reales. En una actualización, el crédito por el tiempo no utilizado se basa en lo que el cliente pagó realmente por el plan anterior, mientras que el nuevo plan se fija según su regla localizada.
• Los cambios programados fijan el precio al programarse. Un cambio programado para el final del periodo de facturación cobra el importe calculado al programarlo, incluso si editas la regla mientras tanto.
• La moneda de facturación nunca cambia. Un cambio de plan nunca cambia la moneda en la que se liquida una suscripción; una regla en otra moneda se convierte mediante FX a dicha moneda.
• Los complementos no se localizan. Los precios de los complementos del nuevo plan siempre usan sus precios base.

​

Comportamientos importantes

​

Prácticas recomendadas

• Mantén un precio base razonable. Es el fallback para cualquier mercado sin una regla, convertido mediante Adaptive Currency.
• Introduce números limpios. El objetivo de un importe fijo es un precio ordenado como ₹999, €9.99 o ¥1000, no un resultado de FX. Para redondear automáticamente en todas las monedas, consulta Charm Pricing.
• Elige el modo adecuado. Usa by_country para precios basados en el poder adquisitivo; usa by_currency cuando sea suficiente un precio por zona monetaria.
• Archiva en lugar de recrear para las promociones. Archivar una regla devuelve el mercado a los precios base/adaptativos y conserva el historial; recréala o vuelve a fijar el precio más adelante según sea necesario.
• Ten en cuenta los impuestos antes de anunciar un total. En productos con impuestos no incluidos, el cliente paga el importe localizado más los impuestos, así que no lo presentes como el precio final en los anuncios.

​

Relacionado