Lanzamos un miniprograma en un mercado nuevo y el precio salió como $9.99. No porque nadie hubiera decidido cobrar en dólares: nadie lo había decidido. Una constante de texto en un componente compartido sencillamente sobrevivió a tres rondas de revisión. El usuario vio un signo de dólar, pensó en una moneda que no le sonaba y se fue. El riel de pagos le habría cobrado en moneda local sin problema. La única que mintió fue la etiqueta.
El dinero parece el dato más portable de tu app: un número, un símbolo, listo. No lo es. Un precio en un miniprograma es a la vez una decisión de presentación, una declaración legal sobre impuestos, una promesa sobre en qué vas a liquidar y una costumbre tomada de cómo paga la gente en ese mercado. Si lo aplanas a un float, todas esas decisiones se toman por accidente.
Dónde se produce el aplanamiento
Recorre el camino desde un precio en una hoja de cálculo hasta un número en pantalla. Casi todos los bugs baratos viven en uno de estos relevos.
| Decisión | La jugada ingenua | Lo que hay que tener en cuenta de verdad | Quién es dueño del campo |
|---|---|---|---|
| Símbolo de moneda | Fijar $ | Posición del símbolo, espacios, separadores decimales y de miles | El formateador, jamás una constante de texto |
| Moneda de presentación | Una tabla de precios global | Poder adquisitivo, precios psicológicos locales, si el impuesto va dentro | Producto y finanzas, mercado por mercado |
| Moneda de liquidación | Dar por hecho que es la que vio el usuario | FX en el momento del cargo, cuándo cobras, conciliación | El libro de pagos |
| Redondeo | Dos decimales en todas partes | El JPY no tiene unidad fraccionaria; en algunos mercados se espera .99 | Una regla de redondeo por moneda |
| Plazos | Mostrar solo el total | «3x sem juros» es una decisión de presentación, no una cuenta | El método de pago local |
| Campo de importe | Guardar un número | Importe más código de moneda, siempre, como un solo valor | Tu esquema |
La última fila es la que defenderíamos en una revisión de código. Un importe sin su moneda no es un número, es una suposición, y las suposiciones se acumulan: un servicio asume USD, otro multiplica por un tipo de cambio, y seis semanas después finanzas concilia un total que nadie sabe reproducir. Guarda la pareja y deja que el tipo de dato discuta por ti.
El coste, sin disfrazarlo
Aquí se pone incómodo. No puedes compartir una sola tabla de precios entre mercados, y eso rompe una idea que era realmente cómoda. Un número global único es fácil de razonar, fácil de descontar, fácil de meter en un config. En cuanto localizas, pasas a tener precios por mercado que se separan, un motor de promociones que ya no puede asumir un precio base y un equipo de soporte que tiene que explicar por qué el mismo artículo cuesta distinto. Intentamos mantener la tabla global y convertir solo al mostrar: te compra un código limpio y te vende un precio que termina en decimales raros que nadie elegiría a propósito.
El FX es la siguiente factura. El tipo al que muestras un precio, el tipo al que se captura el cargo y el tipo al que realmente te pagan son tres números en tres días distintos. Si pones precio en una moneda y liquidas en otra, estás llevando una pequeña tesorería lo quieras o no. Puedes cubrirte, o puedes aceptar el diferencial y meter un colchón en el precio, pero «usamos el tipo en vivo y ya» es la decisión de absorber la volatilidad en tu margen, y conviene decirla en voz alta.
Los métodos de pago locales deciden la presentación, no al revés. En Brasil, el número de plazos va al lado del precio y forma parte de la oferta; en mercados donde el impuesto se añade en el checkout, una etiqueta con impuesto incluido parece un error; en otros es ley. Forzar una sola presentación en todos significa que la interfaz estará mal en algún sitio, y lo estará justo donde el cliente es más sensible. Preferimos que el método de pago sea dueño de un trozo de la UI de precio antes que fingir que el precio es un número puro.
Y hay un impuesto de mantenimiento del que nadie habla: los tipos, las normas fiscales y las convenciones de redondeo cambian. El formateador resuelve los separadores, sí, pero las decisiones de encima son decisiones de producto, con dueño, fecha de revisión y la manía de ser reescritas en silencio por un experimento de crecimiento. Rebatiríamos eso de que «localizar es solo traducir». Traducir es la parte barata. En los precios, localizar deja de ser un problema de cadenas y pasa a ser un problema de finanzas.
Dale pasaporte a cada importe
Modela el dinero como importe más código de moneda desde la primera línea del esquema, no como una migración que harás antes del segundo mercado. Deja que un formateador consciente del locale sea dueño del símbolo, los separadores y la posición, y no permitas que un componente concatene un signo a mano. Mantén presentación, captura y liquidación como campos separados, cada uno con su tipo y su marca de tiempo, para que una pregunta de conciliación tenga respuesta y no un encogimiento de hombros. Pon el precio por mercado y la regla de redondeo por moneda en un config que producto pueda leer de verdad.
Prueba rápida: cambia una cuenta de prueba a un locale en el que aún no operas y compra algo. Si ves un $ solitario, un total con decimales imposibles o un número sin moneda en el registro del pedido, el bug no es cosmético. En algún punto aguas abajo, alguien está a punto de cobrar de menos, y se dará cuenta antes que tú.
Fuentes
- MDN — Intl.NumberFormat — formateo de moneda según el locale, en vez de cadenas hechas a mano.
- W3C — Internacionalización — por qué texto, números y maquetación no se pueden localizar por separado.
- Stripe — Documentación de monedas — la diferencia entre moneda de presentación, de cargo y de liquidación.
- Banco Central de Brasil — de dónde salen las costumbres de pago locales y la presentación en plazos.
- OCDE — trabajo sobre IVA/GST y precios al consumidor que moldea las reglas de impuesto incluido.