Precios Localizados

​

¿Qué es el Precio Localizado?

​

Casos de Uso

​

Conceptos Clave

• Modalidades de precios — Un producto está exactamente en una modalidad a la vez, definida por su pricing_mode:
  • by_currency: un precio por moneda, independientemente del país. Todas las personas que paguen en EUR verán €9.99.
  • by_country: un precio específico para un país (₹999 en India), incluso cuando varios países compartan una moneda.
• Importes fijos, en la unidad mínima — El amount de una regla es un entero expresado en la unidad mínima de la moneda, igual que en el resto de la API: 99900 equivale a ₹999.00; 999 equivale a €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, se omiten tanto Paridad del poder adquisitivo como Precios psicológicos para esa línea. El cliente paga el importe que estableciste, sin modificaciones.
• Cuando ninguna regla coincide — El producto conserva su comportamiento actual: los clientes que pagan en tu moneda base pagan directamente el precio base; al resto se le aplica una conversión mediante Adaptive Currency.
• Las comisiones están incluidas cuando coincide una regla — El cliente paga exactamente el importe que estableciste. La comisión FX de Adaptive Currency la absorbes tú (se trata como incluida en las comisiones para esa transacción) en lugar de añadirla al importe, por lo que el precio local indicado siempre es el precio cobrado.

​

Configuración en el Panel

1

Open the product form

En tu Panel de Comerciante, ve a Productos y crea un producto (o abre uno existente para editar). Establece la Precio base y la moneda como de costumbre.

2

Enable Localized Pricing and choose a mode

En la sección de Precio, marca Precios Localizados, luego elige Por País o Por Moneda.

3

Add a price for each market

Haz clic en Agregar Precio por País o Agregar Precio por Moneda, completa el panel de precios localizados, y haz clic en Agregar. Cada mercado que añadas aparecerá en la tabla de reemplazos, donde podrás editarlo o eliminarlo más tarde.

• By Country
• By Currency

Elige un país, selecciona la moneda e ingresa la cantidad (por ejemplo ₹999 para India), luego haz clic en Agregar.

El país ahora aparece en la tabla de Reemplazos por País, donde puedes editarlo o eliminarlo.

Elige una moneda e ingresa la cantidad (por ejemplo €9.99 para EUR), luego haz clic en Agregar.

La moneda ahora aparece en la tabla de Reemplazos por Moneda, donde puedes editarla o eliminarla.

4

Save the product

Guarda con Agregar producto. Los precios localizados se aplican inmediatamente en futuras compras.

Realiza una prueba de compra con un país de facturación que tenga una regla y confirma que la cantidad localizada aparezca.

​

Gestión a través de API

​

Configurar el modo de precio

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

​

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

​

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

​

Cómo se Aplica en el Pago

• Por País: busca una regla que coincida con el país de facturación. Si existe, al cliente se le cobra la cantidad de la regla en la moneda de la regla.
• Por Moneda: busca una regla que coincida con la moneda del cliente (el billing_currency, o la moneda derivada de su país). Si existe, al cliente se le cobra la cantidad de la regla en esa moneda.
• Sin coincidencia, o sin pricing_mode: se aplica el precio base, cobrado directamente cuando la moneda del cliente es igual a la moneda base, de lo contrario, convertido a través de Moneda Adaptativa.

​

Cómo se aplica a los cambios de plan de suscripción

• Por país: 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 en tiempo real; la regla se aplica, no se omite.
• Por moneda: se aplica una regla que coincida con la moneda en la que se factura al cliente, y se 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; es 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 conservan el precio localizado. Después del cambio, el nuevo plan se renueva por su importe localizado y mantiene las tarifas incluidas, exactamente igual que una suscripción creada con ese precio.
• La prorrateación utiliza 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 calcula 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 momento de programarlo, aunque edites la regla entre 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 esa moneda.
• Los complementos no se localizan. Los precios de los complementos del nuevo plan siempre utilizan su precio base.

​

Comportamientos importantes

​

Prácticas recomendadas

• Mantén un precio base razonable. Es el valor de respaldo para cualquier mercado sin una regla y se convierte mediante Adaptive Currency.
• Introduce números sencillos. El objetivo de un importe fijo es obtener un precio ordenado como ₹999, €9.99 o ¥1000, no un resultado de FX. Para redondear automáticamente en todas las monedas, consulta Precios psicológicos.
• Elige la modalidad adecuada para cada caso. Usa by_country para precios basados en el poder adquisitivo; usa by_currency cuando sea suficiente con un precio por zona monetaria.
• Archiva, no vuelvas a crear, las reglas de las promociones. Archivar una regla devuelve el mercado a los precios base/adaptativos y conserva el historial; puedes volver a crearla o cambiar el precio más adelante según sea necesario.
• Revisa los impuestos antes de anunciar un total. En los 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