Pular para o conteúdo principal

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 role diz qual é o caso: OWNER quando a conta é dona, COPRODUCER quando 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:
  • status do 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 em payment.decline_message.
Para listar as recusas, filtre 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 existe status 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.
  • tracking e navigator vêm null para 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. navigator traz 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.
Depois de copiados para o seu sistema, cuidar desses dados passa a ser responsabilidade da sua empresa.