1. Transações
PushPag API
  • Bem-vindo à PushPag API
  • Autenticação
    • Gerar Token de Acesso
      POST
  • Transações
    • Criar Cobrança PIX
      POST
    • Consultar Status da Transação
      GET
  • Utilitários
    • Verificar Token
      GET
  • Raiz
  • Esquemas
    • AuthRequest
    • AuthResponse
    • CreateTransactionRequest
    • CustomerRequest
    • ItemRequest
    • TransactionResponse
    • Transaction
    • PixData
    • CustomerResponse
    • ItemResponse
    • Error
    • ValidationErrorResponse
  1. Transações

Consultar Status da Transação

GET
/transactions/{id}
Retorna os detalhes e o status atual de uma transação. Use para polling.

Estratégia de polling recomendada#

intervalo: 3 segundos
timeout máximo: 10 minutos (600s / ~200 requisições)
parar quando: status !== "PENDING"

Status possíveis#

StatusDescriçãoAção sugerida
PENDINGAguardando pagamentoContinuar polling
PAIDPagoLiberar produto/acesso
EXPIREDQR Code expirouCriar nova cobrança
FAILEDFalha no processamentoNotificar cliente
REFUNDEDEstornadoRegistrar estorno

Requisição

Authorization
Bearer Token
Forneça seu token bearer no cabeçalho
Authorization
ao fazer requisições para recursos protegidos.
Exemplo:
Authorization: Bearer ********************
or
Parâmetros de Caminho

Respostas

🟢200
application/json
Detalhes da transação
Body

🟠401Unauthorized
🟠404NotFound
🔴502GatewayError
Request Request Example
Shell
JavaScript
Java
Swift
curl -X GET https://api.pushpag.com/v1/transactions/f1da0134-1c97-4b55-b791-1ebc657b62ef \
  -H "Authorization: Bearer SEU_TOKEN"
Response Response Example
200 - Aguardando pagamento
{
    "status": true,
    "data": {
        "id": "f1da0134-1c97-4b55-b791-1ebc657b62ef",
        "amount": 1990,
        "status": "PENDING",
        "method": "PIX",
        "paidAt": null,
        "end2endId": null,
        "pix": {
            "id": "de79cd76-6870-4174-b805-edf1a0f426f9",
            "qrcode": "00020101021226870014br.gov.bcb.pix...",
            "copyPaste": "00020101021226870014br.gov.bcb.pix...",
            "expirationDate": "2025-12-12T03:00:00.000Z",
            "createdAt": "2025-12-11T14:06:03.000Z",
            "updatedAt": "2025-12-11T14:06:03.000Z",
            "transactionId": "f1da0134-1c97-4b55-b791-1ebc657b62ef"
        },
        "metadata": {
            "sellerExternalRef": "pedido-00123"
        },
        "createdAt": "2025-12-11T14:06:00.000Z"
    }
}
Modificado em 2026-04-06 06:57:52
Página anterior
Criar Cobrança PIX
Próxima página
Verificar Token
Built with