Docs/docs/api-reference/orders/retrieve
GET/api/v1/orders/{id}

Obter Pedido

Retorna o detalhe completo de um pedido (sale) com sua transação associada.

Escoporead + orders

Parâmetros de caminho

ParâmetroTipoDescrição
id
required
uuidID do pedido.

Exemplo de requisição

bash
curl https://devexpay-v3.vercel.app/api/v1/orders/9f1c0e8c-... \
  -H "Authorization: Bearer $TOKEN"

Resposta

json
{
  "id": "9f1c0e8c-...",
  "amount": 297.00,
  "payment_status": "paid",
  "payment_method": "credit_card",
  "pagarme_transaction_id": "tr_xxxxxx",
  "offer_id": "cdc93c57-...",
  "product_id": "252735b3-...",
  "customer_id": "193df9e8-...",
  "created_at": "2026-06-08T10:00:00Z",
  "updated_at": "2026-06-08T10:00:05Z",
  "transaction": {
    "boleto_url": null,
    "card_last_digits": "1234",
    "card_brand": "visa",
    "installments": 3,
    "antifraud_status": "approved",
    "splits": null,
    "status": "paid"
  }
}

Erros possíveis

StatusDescrição
401Token inválido ou ausente.
403Chave sem escopo read + orders.
404Pedido não encontrado ou não pertence à sua conta.