Transacciones

Una transacción (referencia txn_…) es un movimiento de dinero. Se crea cuando un comprador paga una sesión.

Listar transacciones


GET /v1/transactions

Autenticación: clave secreta (Authorization: Bearer sk_…).

Parámetros de consulta

Parámetro	Tipo	Descripción
`page`	entero	Página (desde `1`). Por defecto `1`.
`pageSize`	entero	Tamaño de página. Por defecto `10`.
`status`	string	Filtra por estado: `approved`, `declined`, `failed`, `pending`, `refunded`.

Ejemplo


curl "https://api.seif.pagosripei.com/v1/transactions?status=declined&page=1&pageSize=20" \
  -H "Authorization: Bearer sk_test_tu_clave"

Respuesta `200`


{
  "data": [
    {
      "id": "b1d3...-aa",
      "reference": "txn_2nFp9...Zk",
      "amountCents": 105000,
      "currency": "VES",
      "status": "declined",
      "cardBrand": "visa",
      "cardLast4": "4242",
      "description": "Pedido #1042",
      "errorCode": "0051",
      "errorReason": "Saldo insuficiente",
      "createdAt": "2026-06-09T18:05:00.000Z"
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 20
}

Campo	Descripción
`reference`	Referencia pública (`txn_…`).
`amountCents`	Monto en unidades menores.
`status`	`pending` · `approved` · `declined` · `failed` · `refunded`.
`cardBrand` / `cardLast4`	Marca y últimos 4 dígitos (enmascarado).
`errorCode`	Código del procesador, presente en `declined`/`failed`.
`errorReason`	Motivo técnico para tu depuración (no es el mensaje del comprador).

El errorReason te dice por qué falló un cobro sin tener que revisar logs. Para la lista completa de códigos y cómo resolverlos, ver Errores.

Estados de una transacción

Estado	¿Qué pasó?	¿Acción?
`pending`	En proceso.	Espera el webhook o consulta de nuevo.
`approved`	Aprobada por el banco.	Entrega el producto/servicio.
`declined`	Rechazada por el banco/tarjeta.	Muestra el motivo al comprador; sugiérele otra tarjeta.
`failed`	No se pudo procesar (config/red/procesador).	Revisa `errorReason`; reintenta más tarde.
`refunded`	Reembolsada.	—

Para reaccionar en tiempo real, suscríbete a webhooks (charge.approved, charge.declined, charge.failed) en vez de hacer polling. Ver Webhooks.