Skip to main content
GET

Descrição

Retorna informações detalhadas de uma transação específica, incluindo dados do cliente, itens, status e informações de pagamento.
Consulta na Adquirente: Use o query parameter payment_type para consultar o status atualizado diretamente na Firebank (PIX, CREDIT_CARD, BILLET).

Headers

string
required
Bearer token JWT obtido no login

Path Parameters

number
required
ID da transação

Query Parameters

string
Tipo de pagamento para consulta e sincronização com a adquirente (opcional)
  • PIX - Consulta PIX na Firebank e sincroniza status automaticamente
  • CREDIT_CARD - Consulta cartão de crédito na Firebank
  • BILLET - Consulta boleto na Firebank
Importante: Quando fornecido, o sistema:
  1. Consulta o status atualizado na Firebank
  2. Sincroniza automaticamente o status local se estiver desatualizado
  3. Retorna dados atualizados no campo acquirer_status
Se não informado, retorna apenas dados do banco local (sem sincronização).

Response

number
ID da transação
string
Número do pedido
number
Código numérico do status (sincronizado automaticamente quando payment_type é fornecido)
  • 1 = PENDING
  • 2 = APPROVED
  • 3 = FAILED
  • 4 = REFUNDED
string
Nome legível do status do pagamento
  • PENDING - Aguardando pagamento
  • APPROVED - Pagamento aprovado ✅
  • FAILED - Pagamento falhou ❌
  • REFUNDED - Pagamento estornado 💰
object
Status atualizado consultado diretamente na Firebank (apenas quando payment_type é fornecido)
number
Valor total em centavos
string
Tipo de pagamento: pix, credit, debit, invoice
number
Número de parcelas
object
array
Lista de itens do pedido
string
QR Code PIX (apenas para PIX)
string
URL da imagem do QR Code (apenas para PIX)
string
URL do boleto (apenas para boleto)
string
Código de barras (apenas para boleto)
string
Data de criação (ISO 8601)
string
Data da última atualização (ISO 8601)
string
Data do pagamento (ISO 8601)
string
Data do estorno (ISO 8601)

Status das Transações

Exemplos de Uso

Verificar Status

Exibir QR Code PIX

Gerar Recibo

Polling de Status

Importante: Use webhooks em vez de polling sempre que possível. Polling consome recursos e pode ter atrasos.

Próximos Passos

Listar Transações

Consultar histórico

Reembolso

Estornar transação

Webhooks

Notificações em tempo real

Criar Pagamento

Novo pagamento