Buscar Pagamento
Pagamentos
Buscar Pagamento
Consultar status e detalhes de uma transação específica
GET
Buscar Pagamento
Este endpoint permite recuperar as informações detalhadas de um pagamento específico usando o UUID ou a Hash do pagamento.
Casos de Uso
- 📊 Consultar status de pagamentos em tempo real
- 💰 Verificar valores e detalhes da transação
- 🔍 Auditoria e reconciliação financeira
- 📱 Exibir dados na interface do usuário
Parâmetros de URL
Identificador do pagamento. Pode ser:
- UUID do pagamento (ex: `0026621e-ae0c-477b-998d-6442fa0645b2)
- Hash do pagamento (ex:
AUTCUS01K8RSCH3T5FNB7EVACV8DQVNX)
Exemplo de Requisição
Resposta de Sucesso
Detalhes da Resposta
Dados Principais
| Campo | Tipo | Descrição |
|---|---|---|
id | string | UUID único do pagamento |
hash | string | Hash do pagamento |
merchant_reference | string | Referência do merchant |
status | string | Status atual da transação |
payment_method | string | Método: credit_card, pix, bank_slip, google_pay |
amount | integer | Valor em centavos |
original_amount | integer | Valor em centavos |
installments | integer | Número de parcelas |
currency | string | Moeda |
description | string | Descrição da transação |
notification_url | string | Url da notificação |
acquirer_reference | string | Rerefencia do adquirente |
return_code | string | Código de autorização |
metadata | array | Dados adicionais do pagamento |
Status Possíveis
| Status | Descrição | Finalizado |
|---|---|---|
authorized | Autorizado (aguarda captura) | ❌ |
authentication_requested | Autenticação solicitada | ❌ |
waiting_payment | Aguardando pagamento | ❌ |
refused | Recusado pelo banco | ✅ |
refunded | Estornado | ✅ |
error | Erro | ✅ |
processing | Sendo processado | ❌ |
Códigos de Erro
404 - Not Found
404 - Not Found
Pagamento não encontradoPossíveis causas:
- UUID ou hash não existe
- Pagamento pertence a outro merchant
- UUID ou hash mal formado
400 - Bad Request
400 - Bad Request
UUID inválido
Casos de Uso Práticos
Verificação de Status
Formatação para Display
Polling de Status
Considerações de Performance
Polling eficiente: Para pagamentos em processamento, use intervalos de 5-10 segundos para verificar status.