Pedidos e status
Um pedido nasce no POST /pedidos e só anda para frente. Consulte pelo id da Yuupe ou pelo seu número.
Status do pedido
| Status | Significa | O que o site faz |
|---|---|---|
aguardando_pagamento | Pix gerado, ainda não pago | Mostrar o QR |
aguardando_autenticacao | Cartão esperando a confirmação do banco | Chamar YuupePay.autenticar |
em_analise | Antifraude da operadora analisando | Aguardar o webhook |
aprovado | Pago | Liberar a compra |
recusado | Não autorizado | Mostrar motivo.mensagem_comprador |
expirado | Pix não pago ou 3DS não concluído a tempo | Oferecer nova tentativa (novo numero_pedido) |
erro | Falha antes de cobrar | Mostrar motivo.mensagem_comprador |
estorno_em_processamento | Estorno de Pix já liquidado, em andamento | Aguardar pedido.estornado |
estorno_parcial | Parte do valor devolvida | Atualizar o pedido |
estornado | Valor devolvido por completo | Cancelar a compra |
contestado | Chargeback aberto pelo comprador | Avisar o financeiro |
recusado, expirado e erro são finais: a nova tentativa do comprador é um pedido novo. O status só muda depois de confirmado na operadora, e nunca volta (um aprovado não vira aguardando_pagamento).
Consultar um pedido
GET/pedidos/{id}GET/pedidos/por-numero/{numero_pedido}Se o pedido está aguardando, a Yuupe confere na operadora antes de responder, então a consulta já traz o estado mais novo.
curl "https://yuupe.me/api/v1/pay/pedidos/por-numero/NIC-2026-000123" \
-H "Authorization: Bearer yp_test_SUA_CHAVE"Listar pedidos
GET/pedidos?status=&desde=&ate=&limite=&antes_de=Mais novos primeiro, até 100 por página. Para a página seguinte, passe em antes_de o valor de proximo da resposta. Útil para conciliação diária.
Idempotência
O numero_pedido do seu site é a chave: repetir o POST /pedidos com o mesmo número devolve o pedido que já existe (HTTP 200 em vez de 201) e nunca cobra duas vezes. Assim, uma falha de rede no meio da chamada pode ser repetida sem medo.
NIC-2026-000123, depois NIC-2026-000123-2 se o primeiro for recusado ou expirar. O número original fica nos metadados, se quiser agrupar.