Skip to main content
GET
/
api
/
transactions
/
:id
Checar Status
curl --request GET \
  --url https://api.example.com/api/transactions/:id
{
  "data.status": "<string>",
  "data.paidAt": {}
}

​
Checar Status

Retorna os detalhes completos de uma transação, incluindo status de pagamento e dados do cliente. Se a transação estiver expirada, o status será atualizado automaticamente para expired.

​
Autenticação

Authorization: Bearer sk_test_xxx

​
Path Parameters

​
id
string
required
ID da transação (formato CUID).

​
Response (200)

{
  "success": true,
  "data": {
    "id": "clx7a8b9c0d1e2f3g4h5",
    "externalId": "ext_123456",
    "transactionCode": null,
    "pixCode": "00020126580014br.gov.bcb.pix...",
    "expirationDate": "2026-01-17T10:00:00.000Z",
    "status": "paid",
    "amountCents": 10000,
    "product": "Plano Premium",
    "quantity": 1,
    "paidAt": "2026-01-16T10:05:00.000Z",
    "refundedAt": null,
    "createdAt": "2026-01-16T10:00:00.000Z",
    "updatedAt": "2026-01-16T10:05:00.000Z",
    "customer": {
      "id": "cly1234567890",
      "name": "João Silva",
      "document": "12345678900",
      "email": "[email protected]",
      "phone": "11999999999"
    }
  }
}
​
data.status
string
Status atual da transação. Valores possíveis: waiting_payment, processing, paid, expired, cancelled, refunded, failed.
​
data.paidAt
string | null
Data/hora do pagamento (ISO 8601). null se não foi pago.

​
Erros

HTTPCódigoDescrição
401ERR_AUTH_009Token inválido
403ERR_TRANSACTION_003Transação pertence a outro projeto
404ERR_TRANSACTION_001Transação não encontrada

Precisa de ajuda?

Nossa equipe está disponível para auxiliar no processo de desenvolvimento. Entre em contato pelo e-mail [email protected].