GET/v1/charges/:id

Buscar Cobrança

Retorna os dados de uma cobrança pelo ID.

Refresh automático: Se a cobrança estiver com status pending e tiver sido criada há mais de 30 segundos, o Hubpay consulta o PSP em tempo real para atualizar o status antes de responder.

Parâmetros de rota

Parâmetro	Descrição
`id`	ID da cobrança (formato `chg_...`)

Exemplos

bash

curl https://api.hubpay.dev/v1/charges/chg_abc123 \
  -H "Authorization: Bearer hpx_test_sua_chave"

Resposta 200

json

{
  "id": "chg_a1b2c3d4e5f6...",
  "object": "charge",
  "status": "paid",
  "amount": 5000,
  "currency": "BRL",
  "description": "Pedido #1234",
  "provider": "asaas",
  "environment": "test",
  "pix": {
    "copy_paste": "00020126580014br.gov.bcb.pix...",
    "qr_code_base64": null
  },
  "payer": {
    "name": "Maria Souza",
    "document": "12345678901",
    "email": "maria@exemplo.com"
  },
  "metadata": { "order_id": "1234" },
  "expires_at": "2026-04-16T14:00:00.000Z",
  "paid_at": "2026-04-15T15:30:00.000Z",
  "created_at": "2026-04-15T14:00:00.000Z",
  "updated_at": "2026-04-15T15:30:00.000Z"
}

Erros possíveis

Status	type	Quando
`401`	unauthorized	API key inválida
`404`	not_found	Cobrança não encontrada ou de outro usuário