Depois de enviar pedidos pela API, o seu sistema precisa acompanhá-los. As operações de consulta fecham o ciclo da integração.

Consulta de status do pedido

Com o número do pedido retornado no envio, a consulta de status informa a situação atual: aguardando processamento, em andamento, concluído, parcial ou com erro. Os parâmetros exatos estão na documentação da página API do painel.

O que fazer com cada situação no seu sistema:

• Em andamento: apenas aguarde e consulte novamente mais tarde;
• Concluído: marque como entregue e, se você revende, notifique o seu cliente;
• Parcial: parte foi entregue e o valor da parte não entregue retornou como saldo. Registre a quantidade final;
• Erro: o valor retornou como saldo. Verifique o motivo, corrija (geralmente o link) e reenvie.

Consulta de saldo

A operação de saldo retorna o valor disponível na conta. Use antes de lotes grandes de pedidos e em rotinas de monitoramento, para o seu sistema avisar quando estiver na hora de um novo depósito.

Frequência das consultas: o bom senso vale pontos

Não é necessário consultar o mesmo pedido a cada poucos segundos: os serviços têm prazos de início que variam de minutos a horas. Uma rotina de verificação a cada 5 ou 10 minutos para pedidos em andamento é mais do que suficiente, mantém sua integração leve e evita tráfego desnecessário.

Registre o histórico do seu lado

Guarde no seu banco as mudanças de status com data e hora. Além de facilitar o suporte aos seus clientes, esse histórico é a sua fonte de auditoria para qualquer verificação futura.