Skip to content

Status dos Pedidos

Um pedido passa pelo seguinte ciclo de vida:

new → paid → processing → completed
         ↘               ↘ failed
cancel →  cancelled
ttl expires → expired

Tabela de status

StatusTerminalDescrição
newNãoPedido criado, aguardando o depósito de TRX de address_from.
paidNãoDepósito correspondente recebido. Pedido na fila para processamento.
processingNãoEnergia e/ou bandwidth sendo entregues para address_to.
completedSimRecursos entregues. Comissão de indicação creditada ao parceiro.
failedSimO pedido não pôde ser cumprido.
cancelledSimCancelado pelo cliente via POST /v1/orders/cancel.
expiredSimNenhum depósito correspondente recebido dentro do período ttl.

Observações importantes

  • Somente pedidos no status new podem ser cancelados.
  • Um depósito recebido para um pedido cancelled ou expired não é reembolsado automaticamente.
  • A comissão de indicação é creditada somente quando o pedido atinge o status completed.
  • Faça polling em Verificar Pedido até que o status seja terminal (completed, failed, cancelled ou expired) para saber quando a entrega está concluída.

Intervalo de polling recomendado

Faça polling a cada 5–10 segundos após detectar o pagamento. A maioria dos pedidos é concluída em 5–10 segundos após a confirmação do pagamento.

TronZap Partner Documentation