Saltar al contenido principal

¿Qué es el Precio Localizado?

Cada producto tiene un precio base en una moneda base. Los Precios Localizados te permiten reemplazar esa base con precios fijos que estableces por moneda o por país. Actívalo al configurar un pricing_mode en el producto, luego adjunta una regla por mercado. Es uno de los tres mecanismos independientes para la fijación de precios internacionales, cada uno resolviendo un problema diferente:
MecanismoQué haceEl número que ve el cliente
Precio LocalizadoUn precio fijo que estableces por moneda o paísExactamente el monto que estableces
Moneda AdaptativaConvierte automáticamente tu precio base a tasas de cambio en vivoPrecio base convertido a la tasa de cambio actual
Códigos de DescuentoUna reducción porcentual o fija del precio basePrecio base menos el descuento
Precios Localizados y Moneda Adaptativa trabajan juntos. Cuando no coincide ninguna regla localizada, el producto vuelve a su precio base: cobrado directamente si el cliente ya está en tu moneda base, o convertido a través de Moneda Adaptativa si no.

Casos de Uso

Purchasing Power Parity (PPP)

Cobra menos en mercados sensibles al precio sin descontar tu mercado local. Una regla by_country permite que un producto base de $20 se venda por ₹999 en India — ajustado al poder adquisitivo local, no una conversión directa de FX. La manera recomendada y nativa de aplicar PPP.

Charm Pricing

Una conversión en vivo de FX de $19.99 resulta en un número incómodo como €18.43. Una regla by_currency establece el precio limpio, ajustado psicológicamente, que los clientes esperan — €9.99, ¥1000, ₹499 — exactamente como se escribe.

Reversible Market-Entry Promotions

¿Lanzando en un nuevo país? Agrega una regla by_country con un precio introductorio, luego archívalo cuando termine la promoción para volver al precio base/adaptativo. Las reglas son archivadas, nunca eliminadas, por lo que mantienes un registro limpio de lo que estuvo activo y cuándo.

Competitive Price-Matching

Fija un solo mercado para igualar a un competidor local. Una regla by_country para £9.00 en el Reino Unido mantiene ese precio exacto independientemente de cómo se mueva la tasa GBP/USD.

Conceptos Clave

  • Modos de Precio — Un producto está en un solo modo a la vez, configurado 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.
  • Montos 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 cualquier otro lugar de la API: 99900 es ₹999.00, 999 es €9.99. Es un precio que estableces, nunca un valor convertido.
  • Cuando no coincide ninguna regla — El producto mantiene su comportamiento existente: los clientes en tu moneda base pagan el precio base directamente; todos los demás lo obtienen convertido a través de Moneda Adaptativa.
  • Las tarifas están incluidas cuando coincide una regla — El cliente paga exactamente la cantidad que estableciste. La tarifa FX de Moneda Adaptativa es absorbida por ti (se trata como tarifas incluidas para esa transacción) en lugar de añadirse encima, por lo que tu precio local declarado 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.
Precios Localizados habilitados en el formulario del producto con Por País seleccionado
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.
Elige un país, selecciona la moneda e ingresa la cantidad (por ejemplo ₹999 para India), luego haz clic en Agregar.
Añadiendo un reemplazo de 999 INR para India
El país ahora aparece en la tabla de Reemplazos por País, donde puedes editarlo o eliminarlo.
Tabla de reemplazos por país mostrando India en 999 INR
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

Los Precios Localizados están totalmente disponibles en la API. Primero configura el modo de precio del producto, luego adjunta reglas.

Configurar el modo de precio

Establece pricing_mode cuando crees el producto (o actualices uno existente). null significa solo base, el comportamiento existente.
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',
});

Agregar un precio localizado

Adjunta una regla al producto. En el modo by_country se requiere country_code; en el modo by_currency se debe omitir.
// ₹999.00 for customers in India
const localizedPrice = await client.products.localizedPrices.create('pdt_premium_plan', {
  currency: 'INR',
  country_code: 'IN',
  amount: 99900,
});
Para un producto by_currency, omite country_code. Por ejemplo, un €9.99 fijo para todos los que pagan en EUR (currency: 'EUR', amount: 999).

Listar, actualizar y archivar

Puedes actualizar solo el amount de una regla; la moneda y el país son fijos una vez creados. Archivar es un borrado suave idempotente, por lo que la regla deja de coincidir pero permanece en tu historial.
// 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',
});

API Reference

Ver los endpoints completos de Precios Localizados de Producto: crear, listar, recuperar, actualizar y archivar.

Cómo se Aplica en el Pago

El precio localizado se resuelve por línea de carrito, y solo para productos que tienen un pricing_mode configurado. Dodo Payments lee dos señales de la solicitud: el país de facturación del cliente, y un billing_currency opcional (cuando se omite, se deriva una moneda del país de facturación).
  • 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.
Cada línea de carrito se resuelve por sí sola, por lo que puedes localizar un producto y dejar otros en precios base en la misma compra. Si alguna línea coincide con una regla localizada, toda la transacción se fuerza a tarifas incluidas (ver Conceptos Clave).

Comportamientos Importantes

ComportamientoDetalle
Montos antes de impuestosUn monto localizado es el precio antes de impuestos. Para productos exentos de impuestos, los impuestos se añaden en la compra, por lo que el monto localizado no es el total final. Ver Precios Inclusivos de Impuestos.
No para “Paga lo que Quieras”Las reglas localizadas nunca se aplican a productos Paga lo que Quieras, donde el cliente elige la cantidad.
Por moneda difiere del baseUna regla by_currency debe usar una moneda diferente a la moneda base del producto.
Una regla por mercadoUn producto puede tener como máximo una regla activa por moneda (por moneda) o por país (por país).
Todos los tipos de productoSe aplica a productos únicos, de suscripción y basados en uso.
Los cambios en las reglas localizadas no emiten sus propios webhooks. La cantidad resuelta aparece en el pago o suscripción resultante exactamente como cualquier otro precio.

Mejores Prácticas

  • Mantén un precio base sensato. Es el recurso alternativo para cada mercado sin una regla, convertido a través de Moneda Adaptativa.
  • Redondea a precios psicológicos locales. El objetivo de un monto fijo es obtener un número limpio como ₹999, €9.99, o ¥1000, no un resultado de FX.
  • Elige el modo adecuado para la tarea. Usa by_country para precios basados en el poder adquisitivo; usa by_currency cuando un precio por zona de moneda sea suficiente.
  • Archiva, no recrees, para promociones. Archivar una regla devuelve el mercado a base/adaptativo mientras preserva el historial; recrea o vuelve a fijar precios más tarde según sea necesario.
  • Presta atención a la línea de impuestos antes de anunciar un total. Para productos exentos de impuestos el cliente paga la cantidad localizada más impuestos, así que no lo cites como el precio final en anuncios.

Relacionado

Purchasing Power Parity

Precios localizados nativos vs. códigos de descuento basados en la localización para PPP.

Adaptive Currency

Conversión automática de FX y el manejo de tarifas sobre el que se construyen los precios localizados.

Tax-Inclusive Pricing

Controla si tus precios incluyen impuestos.

Pay What You Want

Permite a los clientes elegir la cantidad. Las reglas localizadas no se aplican allí.
Última modificación el 26 de junio de 2026