O relatório de vendas não é uma previsão suficiente do extrato bancário. Cancelamentos, taxas, prazos, parcelamento e ajustes podem separar o valor dos pedidos do valor repassado. Uma diferença merece explicação, mas não deve ser classificada automaticamente como dinheiro perdido.
A arquitetura deve manter vínculos entre pedido, tentativa de pagamento, transação confirmada e repasse. Sem essas referências, a equipe tende a aproximar valores por data e montante, o que pode parecer funcionar até surgir um estorno parcial ou um lote com várias vendas de mesmo preço.
Neste guia
Quando uma camada de orquestração faz sentido?
Ela pode ser útil quando há regras de roteamento entre provedores, métodos ou mercados que a solução atual não atende. Antes de contratar, descreva o problema: indisponibilidade recorrente, custo contratual, cobertura de métodos ou dificuldade de operação. Cada objetivo exige uma forma própria de avaliar o resultado.
Compare custo total, complexidade e qualidade da informação de retorno. Uma segunda integração acrescenta credenciais, conciliação, suporte e cenários de falha. Se o volume e a necessidade forem pequenos, configurar melhor o provedor existente pode resolver o problema com menos manutenção.
Quando uma tentativa pode ser repetida ou roteada de novo?
| Resultado observado | Conduta a definir |
|---|---|
| Resposta técnica incerta | Consultar o estado antes de criar outra cobrança. |
| Autenticação adicional | Permitir a ação exigida do comprador. |
| Dados corrigíveis | Pedir correção conforme a orientação do provedor. |
| Recusa definitiva | Encerrar a tentativa e seguir o caminho permitido. |
Não trate toda recusa como convite para tentar outro adquirente. Os códigos e as recomendações do provedor distinguem situações diferentes. Uma indisponibilidade de rede também não prova que a cobrança falhou: o pedido pode ter sido processado antes da perda da resposta.
Idempotência ajuda a controlar repetições dentro do contrato de uma API, mas uma chave em um provedor não protege automaticamente uma cobrança em outro. A orquestração precisa manter um controle central das tentativas e impedir que a mesma obrigação seja paga duas vezes.
Como estruturar a conciliação em etapas verificáveis?
Primeiro, compare pedidos e pagamentos para encontrar venda sem pagamento, pagamento sem pedido e duplicidades. Depois, relacione pagamentos e ajustes ao relatório do provedor. Por fim, confira os repasses com o extrato bancário, respeitando datas, moeda e regras do contrato.
A documentação da Adyen distingue conciliação por transação e por lote de repasse. Essa separação ilustra uma necessidade operacional ampla: explicar tanto os componentes do valor quanto sua chegada à conta. Um total correto pode esconder compensações erradas entre duas transações.
Em um exemplo hipotético, um repasse reúne dez vendas e uma devolução parcial. A soma fica abaixo do total vendido, mas a diferença corresponde à devolução e às tarifas contratadas. A investigação deve demonstrar cada componente; ajustar manualmente o total para fazê-lo coincidir destrói essa explicação.
Como lidar com eventos e exceções sem perder o histórico?
Notificações do provedor devem ter origem verificada e processamento tolerante a duplicidades. Eventos podem chegar fora de ordem; por isso, a última mensagem recebida não é necessariamente o estado mais recente da transação. A integração deve consultar a fonte quando precisar resolver uma inconsistência.
Crie uma fila de exceções com motivo, valor, idade e responsável. Diferencie informação ainda não disponível de divergência confirmada. Estorno, contestação, tarifa inesperada e repasse atrasado demandam investigações diferentes, com evidências preservadas e um prazo de resolução definido pela operação.
Quais critérios demonstram que o processo está funcionando?
O aceite deve explicar todos os componentes de uma amostra de repasses, localizar pedidos a partir da transação e impedir duplicidade durante uma falha simulada. Acompanhe pendências por valor e idade, além de taxas de aprovação. Melhorar a aprovação sem observar fraude, ajustes e custo pode produzir uma leitura incompleta.
O curso Software e IA para executivos ajuda a discutir estados e integrações com a equipe. Os guias de checkout e pagamentos por agentes complementam as etapas anteriores à conciliação. Comece por um repasse fechado: reconstrua seus componentes até os pedidos e registre cada vínculo que hoje depende de procura manual.