Consultar cobrança

Lê uma cobrança pelo id devolvido na criação.

GET/v1/charges/{id}escopo: charge:read

cURL

curl https://api.transakto.io/v1/charges/8f1c2a90-1f4b-4f0e-9d33-5a2c1b7e9a10 \
  -H "x-api-key: sk_live_..."

Estados

status

`processing` stringopcional	Gravada, aguardando o adquirente devolver o Pix. Dura segundos: termina em pending ou failed.
`pending` stringopcional	Criada, aguardando pagamento.
`paid` stringopcional	Paga e confirmada pelo adquirente.
`expired` stringopcional	Passou de expires_at sem pagamento.
`canceled` stringopcional	Cancelada antes do pagamento.
`failed` stringopcional	O adquirente recusou a emissão ou o pagamento. O motivo vem em failure_reason.
`refunded` stringopcional	Valor devolvido ao pagador.
`charged_back` stringopcional	Contestada pelo pagador.
`infraction` stringopcional	Pix pago com infração aberta no MED. Ainda sem desfecho: termina em charged_back (devolvido) ou volta a paid.

expired é derivado de expires_at no momento da leitura: uma cobrança pendente cuja data já passou é devolvida como expirada, sem depender de rotina de varredura.

Campos da resposta

charge

`id` uuidopcional	Identificador da cobrança.
`amount` inteiroopcional	Valor em centavos.
`method` stringopcional	Meio de pagamento: pix na v1.
`reference` string \| nullopcional	O identificador que você enviou.
`customer` objeto \| nullopcional	Nome, e-mail e documento do pagador.
`pix.br_code` string \| nullopcional	Copia e cola do Pix.
`pix.end_to_end_id` string \| nullopcional	Identificador da liquidação, preenchido após o pagamento.
`receiver` objeto \| nullopcional	Dados da conta que recebeu: nome, documento, chave Pix, instituição, ISPB, agência e conta. null quando o adquirente não informa, e cada campo interno pode vir null.
`expires_at` ISO 8601 \| nullopcional	Quando a cobrança deixa de aceitar pagamento.
`paid_at` ISO 8601 \| nullopcional	Quando o pagamento foi confirmado.
`failure_reason` string \| nullopcional	Por que a emissão falhou, quando o status é failed. null nos demais casos.
`created_at` ISO 8601opcional	Quando a cobrança foi criada.

Cobranças criadas pelo checkout não são visíveis por aqui: a API pública enxerga apenas o que ela mesma criou. Consultar o id de uma delas devolve 404 com CHARGE_NOT_FOUND, o mesmo retorno de um id de outra conta.

Estados#

status

Campos da resposta#

charge

Não encontrado#

Estados

Campos da resposta

Não encontrado