Lançamos um miniprograma num mercado novo e o preço saiu como $9.99. Não porque alguém tivesse decidido cobrar em dólares: ninguém decidiu isso. Uma constante de texto num componente compartilhado simplesmente sobreviveu a três rodadas de revisão. O usuário viu um cifrão, achou que era uma moeda que não conhecia e foi embora. O trilho de pagamentos teria cobrado em moeda local sem problema nenhum. A única que mentiu foi a etiqueta.

Dinheiro parece o dado mais portátil do app: um número, um símbolo, pronto. Não é. Um preço num miniprograma é ao mesmo tempo uma decisão de apresentação, uma declaração legal sobre imposto, uma promessa sobre em que você vai liquidar e um hábito pegado de como as pessoas pagam naquele mercado. Achate isso num float e todas essas decisões acabam tomadas por acidente.

Onde acontece o achatamento

Percorra o caminho de um preço numa planilha até um número na tela. Quase todo bug barato mora numa dessas passagens.

DecisãoO jeito ingênuoO que você tem de considerarQuem é dono do campo
Símbolo da moedaFixar $Posição do símbolo, espaço, separador decimal e de milharO formatador, nunca uma constante de texto
Moeda de apresentaçãoUma tabela de preços globalPoder de compra, preços psicológicos locais, imposto dentro ou foraProduto e finanças, mercado por mercado
Moeda de liquidaçãoPresumir que é a que o usuário viuCâmbio na captura, quando você recebe, conciliaçãoO livro de pagamentos
ArredondamentoDois decimais em todo lugarJPY não tem unidade fracionária; alguns mercados esperam .99Uma regra de arredondamento por moeda
ParcelamentoMostrar só o total«3x sem juros» é decisão de apresentação, não contaO meio de pagamento local
Campo de valorGuardar um númeroValor mais código da moeda, sempre, como um valor sóSeu schema

A última linha é a que a gente defenderia em revisão de código. Valor sem moeda não é número, é chute, e chute acumula: um serviço assume USD, outro multiplica por uma taxa, e seis semanas depois o financeiro concilia um total que ninguém consegue reproduzir. Guarde o par e deixe o tipo brigar por você.

O custo, sem disfarce

Aqui fica desconfortável. Você não pode compartilhar uma tabela de preços entre mercados, e isso quebra uma ideia que era mesmo boa. Um número global único é fácil de raciocinar, fácil de dar desconto, fácil de jogar num config. Quando você localiza, passa a ter preços por mercado que derivam separados, um motor de promoção que não pode mais assumir preço base e um suporte que precisa explicar por que o mesmo item custa diferente. Já tentamos manter a tabela global e converter só na hora de mostrar: compra um código limpo e te vende um preço que termina em decimais esquisitos que ninguém escolheria de propósito.

O câmbio é a próxima conta. A taxa com que você mostra o preço, a taxa da captura e a taxa com que realmente recebe são três números em três dias diferentes. Se você precifica numa moeda e liquida em outra, está tocando uma pequena tesouraria, queira ou não. Pode fazer hedge, pode aceitar o spread e botar folga no preço — mas «é só usar a taxa em tempo real» é a decisão de absorver a volatilidade na sua margem, e isso devia ser dito em voz alta.

O meio de pagamento local decide a apresentação, não o contrário. No Brasil, o número de parcelas fica ao lado do preço e faz parte da oferta; em mercados onde o imposto entra no checkout, preço com imposto incluso parece erro; em outros, é lei. Forçar uma apresentação única em todos significa que a interface vai estar errada em algum lugar, e justo no ponto em que o cliente é mais sensível. A gente prefere deixar o meio de pagamento dono de um pedaço da UI de preço a fingir que preço é número puro.

E tem um imposto de manutenção que ninguém menciona: taxas, regras fiscais e convenções de arredondamento mudam. O formatador resolve os separadores, sim, mas as decisões acima dele são decisões de produto, com dono, data de revisão e o hábito de serem reescritas em silêncio por um experimento de crescimento. Dá pra rebater aquela frase de que «localizar é só traduzir». Traduzir é a parte barata. É no preço que localizar deixa de ser problema de string e vira problema de financeiro.

Dê passaporte pra cada valor

Modele dinheiro como valor mais código de moeda desde a primeira linha do schema, não como uma migração que você faz antes do segundo mercado. Deixe um formatador ciente do locale cuidar do símbolo, dos separadores e da posição, e nunca deixe um componente concatenar um sinal na mão. Mantenha apresentação, captura e liquidação como campos separados, cada um com sua taxa e seu timestamp, pra uma pergunta de conciliação ter resposta em vez de um dar de ombros. Ponha preço por mercado e regra de arredondamento por moeda num config que gente de produto consiga ler de verdade.

Teste rápido: mude uma conta de teste pra um locale em que você ainda não opera e compre algo. Se aparecer um $ sozinho, um total com decimais impossíveis ou um número sem moeda no registro do pedido, o bug não é cosmético. Em algum ponto adiante, alguém está prestes a receber o valor errado, e vai perceber antes de você.

Fontes