Skip to main content
Consultar ativamente o estado mais recente do método de pagamento correspondente ao pedido e sincronizá-lo com a plataforma. Esta solicitação pode acessar o serviço de pagamento e alterar o estado do pedido; use-a apenas quando o callback estiver atrasado ou for necessária confirmação imediata.

​
Preparação

​
Visão geral da API

Em caso de sucesso, retorna o objeto Order completo após a atualização. Use state para determinar o resultado e finished_at como o horário de conclusão; o modelo atual não possui o campo paid_at. Os valores de estado incluem Pending, Paid, Finished, Expired, Failed, Refunded. O prazo de pagamento apenas altera pedidos que ainda estão em Pending para Expired. Pedidos Refunded já reembolsados permanecem no estado reembolsado após a atualização ou o recebimento de um callback de pagamento atrasado.

​
Recomendações de repetição

  • Para pagamentos normais, priorize depender do callback da plataforma; faça refresh ativamente apenas quando o estado demorar a ser atualizado.
  • Não faça polling frequente fixo. Recomenda-se backoff exponencial e interromper após um estado terminal claro.
  • 401 indica token inválido; 403 indica que não é o proprietário do pedido; 404 indica que o pedido não existe.
  • Quando a consulta ao serviço de pagamento falhar, mantenha o ID do pedido e o ID de rastreamento, tente novamente mais tarde; não crie pedidos duplicados para substituir a confirmação de estado.

​
APIs relacionadas