Atraso de alguns segundos
Os pedidos são lidos do índice de busca da Zouti, que acompanha o banco com alguns segundos de atraso. Uma leitura feita logo depois de uma mudança (um pagamento aprovado, um reembolso) pode ainda trazer a versão anterior. Repita a leitura em alguns segundos. A sincronização já cobre esse atraso com a janela de 5 minutos.Quais pedidos entram
- Só pedidos de infoproduto, os mesmos que aparecem no dashboard.
- Pedidos da conta e de coprodução. O campo
rolediz qual é o caso:OWNERquando a conta é dona,COPRODUCERquando participa por coprodução. - Nunca pedidos de outra conta. Um pedido de outra conta recebe
404, como um pedido que não existe.
Pagamento recusado aparece
Um cartão recusado no checkout, inclusive pelo antifraude, gera um pedido visível na API:statusdo pedido:UNPAID;payment.status:DECLINED;payment.decline_code: o motivo no código padronizado da Zouti (ZT-seguido de 4 dígitos), com o texto empayment.decline_message.
status=UNPAID e confira payment.status. Veja o
objeto pedido.
Falha técnica da Zouti não aparece
Quando a cobrança no checkout não chega ao banco por uma falha técnica do lado da Zouti (a comunicação com o adquirente falhou), o pedido não entra na API: não existestatus FAILED no
pedido. Isso não é uma recusa: o banco não chegou a avaliar a compra.
Não confunda com payment.status FAILED: ele indica um pagamento que não chegou ao banco por
falha de comunicação e pode aparecer num pedido visível, como numa renovação de assinatura.
Coprodução
- A conta vê o pedido quando é coprodutora do último pagamento dele. Quem foi coprodutor só de um pagamento anterior do mesmo pedido não vê o pedido. O dashboard segue a mesma regra.
- Os valores (
amount_total,payment.amount,payment.fee…) são os do pedido inteiro, não a parte da conta na coprodução. trackingenavigatorvêmnullpara o coprodutor.
Dados de cartão e do navegador
- Cartão: só a bandeira (
payment.card.brand) e os últimos 4 dígitos (payment.card.last4). Nenhum outro dado de cartão é exposto. - IP do comprador: nunca é exposto.
navigatortraz o navegador e a origem da visita (user_agent,referer,device,browser,origin), sem o IP.
Dados pessoais do comprador
Os pedidos trazem dados pessoais do comprador: nome, e-mail, telefone, CPF ou CNPJ e endereço. Trate-os como dado pessoal, nos termos da LGPD:- guarde só os campos que a integração usa;
- limite quem acessa a cópia local e a chave de API;
- apague o que não precisar mais.

