Consultar transacción

Esta sección detalla el uso del endpoint para consultar el detalle de una transacción procesada, incluyendo su estado, referencia, datos de la tarjeta utilizada y el historial de intentos de pago.

Detalles del endpoint

Método: GET
URL: /api/v1/transactions/:paymentIntentToken

El endpoint devuelve la información completa de una transacción a partir de su paymentIntentToken.

Configuración de la solicitud

Headers

Header	Descripción
`X-API-KEY`	API Key generada en Cubo Admin.

Si aún no has generado tu API Key, revisa nuestra sección de autenticación.

Parámetros de ruta

Parámetro	Tipo	Descripción
`paymentIntentToken`	`string`	Token único de la transacción que deseas consultar.

Ejemplos de uso

JavaScript


fetch('https://<CUBO_API_URL>/api/v1/transactions/UDXVRKLFI', {
  method: 'GET',
  headers: {
    'X-API-KEY': 'TU_API_KEY_AQUI',
  },
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

Respuestas del servidor

✅ Respuesta exitosa

Devuelve el detalle completo de la transacción:


{
  "paymentIntentToken": "UDXVRKLFI",
  "status": "SUCCEEDED",
  "reference": "607715445287",
  "authorizationCode": "999999",
  "maskedCardNumber": "**** **** **** 5848",
  "cardBrand": "visa",
  "processedAt": "2026-03-18T21:43:50.889Z",
  "amount": "1.00",
  "currency": "USD",
  "description": "Test API",
  "createdAt": "2026-03-18T21:43:48.041Z",
  "paymentAttempts": [
    {
      "status": "SUCCEEDED",
      "rejectionReason": null,
      "authorizationCode": "999999",
      "reference": "607715445287",
      "maskedCardNumber": "**** **** **** 5848",
      "cardBrand": "visa",
      "processedAt": "2026-03-18T21:43:50.889Z"
    }
  ]
}

Campo	Tipo	Descripción
`paymentIntentToken`	`string`	Token único de la transacción.
`status`	`string`	Estado de la transacción (`SUCCEEDED`, `FAILED`, etc.).
`reference`	`string`	Número de referencia de la transacción.
`authorizationCode`	`string`	Código de autorización del emisor.
`maskedCardNumber`	`string`	Número de tarjeta enmascarado.
`cardBrand`	`string \| null`	Marca de la tarjeta (Visa, Mastercard, etc.).
`processedAt`	`string`	Fecha y hora en que se procesó la transacción (formato ISO 8601).
`amount`	`string`	Monto de la transacción.
`currency`	`string`	Moneda de la transacción (ISO 4217).
`description`	`string`	Descripción de la transacción.
`createdAt`	`string`	Fecha y hora de creación de la transacción (formato ISO 8601).
`paymentAttempts`	`array`	Historial de intentos de pago asociados a la transacción.

Campos de `paymentAttempts`

Campo	Tipo	Descripción
`status`	`string`	Estado del intento (`SUCCEEDED`, `FAILED`, etc.).
`rejectionReason`	`string \| null`	Motivo de rechazo (si aplica).
`authorizationCode`	`string`	Código de autorización del emisor.
`reference`	`string`	Número de referencia del intento.
`maskedCardNumber`	`string`	Número de tarjeta enmascarado.
`cardBrand`	`string \| null`	Marca de la tarjeta.
`processedAt`	`string`	Fecha y hora en que se procesó el intento (formato ISO 8601).

❌ Respuesta de error


{
  "statusCode": 404,
  "message": "Transaction not found",
  "error": "Not Found"
}