Identificadores que amarram tudo
merchant_reference
Sua referência única para a cobrança. Envie sempre ao criar
pedidos e assinaturas — é a
chave para reconciliar do seu lado.
UUID do pagamento
Identificador da Autorizou retornado na criação e usado em
Consultar Pagamento.
external_reference (recebedores)
Liga seus recebedores aos da Autorizou; útil em
Recebedores Incompletos.
payment_id (payables)
Liga cada recebível ao pagamento de origem no arquivo de conciliação.
Estratégia recomendada
1
Webhooks como gatilho
Atualize o estado em tempo real a partir dos
webhooks — tratados como gatilho, já que hoje não vêm assinados.
2
Reconciliação ativa (listagem)
Periodicamente, liste os pagamentos por período e status com
GET /payments (ver Visibilidade pós-venda) — ex.: “as vendas de ontem
autorizadas”. A listagem é paginada e filtra por status, payment_method, merchant_reference
e datas (from/to), fechando as lacunas de qualquer evento perdido.3
Split e taxas na própria venda
Ao ler um pagamento (
GET /payments/{identifier}, que aceita uuid, hash ou
merchant_reference), a resposta traz split (quem recebeu quanto) e fees (taxa da plataforma) —
então você concilia a divisão sem depender de outra fonte.4
Recebedores
Verifique recebedores com cadastro incompleto em
Recebedores Incompletos — ou consulte o
status
de um recebedor direto em GET /recipients/{uuid} — e regularize antes do repasse.5
Saldo da carteira
Acompanhe quanto já está disponível e quanto ainda vai liberar em
Saldo da Carteira, por moeda. O
pending já vem
líquido das taxas, então é o valor que efetivamente vai cair.