Pedidos (Orders)

Um pedido registra a venda de uma oferta — produto e preço — e liga os pagamentos a ela. O checkout hospedado cria o pedido sozinho; pela API você cria e paga pedidos no seu próprio fluxo.

Operações

• post /v1/orders — Criar pedido
• get /v1/orders — Listar pedidos
• get /v1/orders/{id} — Consultar pedido
• post /v1/orders/{id}/payment-intents — Criar PaymentIntent do pedido
• post /v1/orders/{id}/cancel — Cancelar pedido
• post /v1/orders/{id}/expire — Expirar pedido

Fluxo pela API

1. Crie o pedido de uma oferta active: POST /v1/orders com {"offer_id": "off_..."}. O valor e a moeda vêm da oferta.
2. Crie o pagamento do pedido: POST /v1/orders/{id}/payment-intents. O PaymentIntent nasce com o valor do pedido e order_id preenchido; um pedido tem no máximo um pagamento vivo.
3. Confirme o PaymentIntent (Pix ou cartão de teste). Quando ele vira succeeded, a Wolf processa o evento do pagamento e marca o pedido como paid — exatamente uma vez, mesmo com eventos repetidos — e emite order.paid.

Cancelar ou expirar só funciona em pending_payment sem pagamento em andamento (409 INVALID_STATE_TRANSITION caso contrário). Criar, pagar, cancelar e expirar exigem Idempotency-Key.

Pedidos do checkout hospedado

Ao pagar uma sessão de checkout (inclusive as abertas por Payment Links), a Wolf cria um pedido da oferta da sessão — um por sessão — com checkout_session_id preenchido.

Estados

O objeto Order

Objeto Order