Pular para o conteúdo principal

Dinheiro: confira a unidade do campo

Os contratos atuais não usam uma única unidade em todas as superfícies.
Não aplique a regra “todo valor está em centavos” ao webhook. Para conciliação, consulte a transação pela API e compare valores na mesma unidade.
Use inteiros em centavos na sua aplicação. Ao receber valores decimais em reais, converta com uma estratégia decimal apropriada antes de calcular ou comparar dinheiro.

Status dependem da superfície

O nome do evento e o status do corpo não são o mesmo campo. Preserve valores desconhecidos para investigar mudanças do contrato; não os converta automaticamente em “aprovado”.

Identificadores

  • link.id identifica o link nas operações de consulta, edição e arquivamento.
  • link.slug compõe a URL pública do checkout.
  • transaction.id identifica um pagamento. Um link pode ter várias transações.
  • data.id, em eventos transaction.*, identifica a transação relacionada.
Guarde a relação entre o seu pedido e os identificadores retornados. Não use valor, e-mail ou nome como chave única de um pagamento.

Datas

Leia timestamps em ISO 8601 respeitando o fuso informado. Armazene uma referência consistente, como UTC, e converta para o fuso do usuário na exibição.