Visão Geral
Os Pedidos (Orders) são gerados automaticamente quando uma cobrança é criada. Um pedido pode conter múltiplas cobranças (charges).
Status de um Pedido
Pedidos Desafiados (Challenged)
Quando um pedido entra no statusChallenged, o cliente precisa confirmar a identidade antes que o pagamento seja processado. Isso pode ocorrer por:
- OTP — código de verificação enviado por SMS ou e-mail
- Magic Link — link de verificação enviado por e-mail
Fluxo de confirmação
Campos de uma Confirmação
Confirmações têm prazo de expiração (15 minutos). Após expirar, use a rota
/resend para gerar um novo código.Formato de resposta
A rota de listagem de confirmações (GET .../confirmations) retorna diretamente {"data": [...]}, sem o envelope padrão APIReturnUtil.
Já as rotas de verificação e reenvio utilizam o envelope padrão com os campos mensagem, erro, mensagenserro, codigoretorno, id e data.
A rota de verificação (
/verify) processa as cobranças pendentes do pedido e retorna o mesmo formato da criação de cobrança (HTTP 201 com dados da cobrança no campo data).