Precios Localizados

​

¿Qué es el Precio Localizado?

​

Casos de Uso

​

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.

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 fallback para cualquier mercado sin una regla, convertido mediante Adaptive Currency.
• Redondea a precios atractivos locales. El objetivo de un importe fijo es obtener un número limpio como ₹999, €9.99 o ¥1000, no un resultado de FX.
• Elige el modo adecuado para cada caso. Usa by_country para precios basados en el poder adquisitivo; usa by_currency cuando sea suficiente tener un precio por zona monetaria.
• Archiva en lugar de recrear para las promociones. Archivar una regla devuelve el mercado al precio base/adaptativo y conserva el historial; recréala o vuelve a definir el precio más adelante según sea necesario.
• Ten en cuenta 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