Referencia del API · tag transactions
Transacciones
Estado de una transacción asíncrona del gateway por su transaction_id.
Esta página se genera desde el contrato (data/gateway-v1.json): cada operación muestra su verbo,
ruta, parámetros, cuerpo, respuestas, si lleva Idempotency-Key y el método equivalente en los cinco SDK.
Para el flujo de punta a punta con ejemplos completos, ve a la guía de implementación.
Operaciones del tag transactions #
Descripción en el contrato: Asynchronous transaction status lookup.
| Método | Ruta | Operación | Scope | Idem. |
|---|---|---|---|---|
| GET | /v1/gateway/transactions/{tx_id}/ | Transaction status | — | — |
Transaction status #
GET/v1/gateway/transactions/{tx_id}/
Parámetros
| Nombre | En | Tipo | Descripción |
|---|---|---|---|
tx_id obligatorio | ruta | string | Gateway transaction id. Ej.: a1b2c3d4-0000-4a1b-9c2d-000000000001 |
Respuestas
| Código | Descripción | Cuerpo |
|---|---|---|
| 200 | Transaction record. | TransactionStatus
application/json |
Errores posibles (400, 401, 403, 404, 409, 422, 429, 500) — application/problem+json
| 400 | Malformed request. | about:blank |
| 401 | Missing or invalid API key. | about:blank |
| 403 | The key is valid but lacks the required scope, or the source IP is not allow-listed. | about:blank |
| 404 | The requested resource does not exist. | about:blank |
| 409 | Idempotency conflict — same key, original still processing. | https://errors.compense.co/gateway/idempotency-conflict |
| 422 | Request body failed validation. | https://errors.compense.co/gateway/validation |
| 429 | Per-key rate limit or monthly quota exceeded; see Retry-After. | https://errors.compense.co/gateway/rate-limited |
| 500 | Unexpected gateway error; quote the trace_id to support. | about:blank |
Ver Errores problem+json para la excepción equivalente en cada SDK.
Ejemplo
client.transactions.get()client.transactions.get()$client->transactions->get()await client.Transactions.GetAsync()client.Transactions.Get(ctx, …)curl "https://sandbox.dev.compense.co/gw/v1/gateway/transactions/a1b2c3d4-0000-4a1b-9c2d-000000000001/" \
-H "X-API-Key: $COMPENSE_API_KEY"Los métodos de cada SDK salen de su suite de paridad con el contrato. El cURL va contra el sandbox; los valores <campo> son marcadores.