Transações
GET /transactions/:id
Obter detalhes completos de uma transação
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
Bearer token JWT obtido no login
Path Parameters
ID da transação
Query Parameters
Tipo de pagamento para consulta e sincronização com a adquirente (opcional)
PIX- Consulta PIX na Firebank e sincroniza status automaticamenteCREDIT_CARD- Consulta cartão de crédito na FirebankBILLET- Consulta boleto na Firebank
- Consulta o status atualizado na Firebank
- Sincroniza automaticamente o status local se estiver desatualizado
- Retorna dados atualizados no campo
acquirer_status
Response
ID da transação
Número do pedido
Código numérico do status (sincronizado automaticamente quando
payment_type é fornecido)1= PENDING2= APPROVED3= FAILED4= REFUNDED
Nome legível do status do pagamento
PENDING- Aguardando pagamentoAPPROVED- Pagamento aprovado ✅FAILED- Pagamento falhou ❌REFUNDED- Pagamento estornado 💰
Status atualizado consultado diretamente na Firebank (apenas quando
payment_type é fornecido)Valor total em centavos
Tipo de pagamento: pix, credit, debit, invoice
Número de parcelas
Lista de itens do pedido
QR Code PIX (apenas para PIX)
URL da imagem do QR Code (apenas para PIX)
URL do boleto (apenas para boleto)
Código de barras (apenas para boleto)
Data de criação (ISO 8601)
Data da última atualização (ISO 8601)
Data do pagamento (ISO 8601)
Data do estorno (ISO 8601)
Status das Transações
| Código | Status | Descrição | Ações Disponíveis |
|---|---|---|---|
| 1 | PENDING | Aguardando pagamento | Cancelar |
| 2 | APPROVED | Pagamento aprovado | Estornar |
| 3 | FAILED | Pagamento falhou | Tentar novamente |
| 4 | REFUNDED | Pagamento estornado | Nenhuma |
Exemplos de Uso
Verificar Status
Exibir QR Code PIX
Gerar Recibo
Polling de Status
Próximos Passos
Listar Transações
Consultar histórico
Reembolso
Estornar transação
Webhooks
Notificações em tempo real
Criar Pagamento
Novo pagamento