Consultar status rápido
Retorna apenas o ID e o status da transação. Ideal para polling leve.
Overview
Menor consumo de banda que GET /transactions/{id}. Use quando precisar apenas saber se a transação foi concluída ou falhou.
Endpoint
GETGET /transactions/{transactionId}/status
Base URL:
https://api.onnixpay.com/api/v1/sdkHeaders
| Header | Obrigatório | Descrição |
|---|---|---|
| X-API-Key | Sim | Sua API Key. |
Path Parameters
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| transactionId | string | Sim | ID da transação. |
Exemplo cURL
cURL
curl -X GET "https://api.onnixpay.com/api/v1/sdk/transactions/txn_abc123/status" \
-H "X-API-Key: ox_sua_chave_aqui"Response — Sucesso (200)
JSON
{
"id": "txn_abc123",
"status": "completed"
}Campos da resposta
| Campo | Tipo | Descrição |
|---|---|---|
| id | string | ID da transação. |
| status | string | pending | completed | failed. Resposta enxuta para polling. |
Status codes e erros comuns
| Status | Código | Mensagem |
|---|---|---|
| 404 | RESOURCE_NOT_FOUND | Transação não encontrada. |
| 401 | INVALID_API_KEY | Chave de API inválida ou ausente. |
Exemplo de resposta de erro
JSON
{
"code": "RESOURCE_NOT_FOUND",
"message": "Transação não encontrada."
}