Tarjetas guardadas

Cuando un cobro es aprobado, Seif puede almacenar la tarjeta para volver a cobrarla luego. Cada tarjeta se identifica con un token de Seif (tok_seif_…) y, si lo enviaste, con tu customerRef.

Para que una tarjeta se guarde, crea la sesión de pago con un customerRef (tu id de cliente). Al aprobarse el cobro, la tarjeta queda asociada a ese cliente.

Listar tarjetas


GET /v1/cards

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

Parámetros de consulta

Parámetro	Tipo	Descripción
`customerRef`	string	Tu id de cliente. Devuelve solo las tarjetas de ese cliente.

Ejemplo


curl "https://api.seif.pagosripei.com/v1/cards?customerRef=usuario_123" \
  -H "Authorization: Bearer sk_test_tu_clave"

Respuesta `200`


[
  {
    "id": "c0a2...-9f",
    "seifToken": "tok_seif_Xa92...kQ",
    "brand": "visa",
    "lastFour": "4242",
    "expMonth": 8,
    "expYear": 2028,
    "holderName": null,
    "status": "active",
    "customerRef": "usuario_123",
    "createdAt": "2026-06-09T18:05:10.000Z"
  }
]

Campo	Descripción
`seifToken`	El token con el que vuelves a cobrar la tarjeta (`tok_seif_…`).
`brand` / `lastFour`	Marca y últimos 4 dígitos.
`expMonth` / `expYear`	Vencimiento.
`status`	`active` · `expired` · `deleted`.
`customerRef`	Tu id de cliente asociado.

Las respuestas nunca incluyen el número real de la tarjeta ni el identificador del vault. Solo el tok_seif_…. Trátalo como un dato sensible de tu lado: con él se puede iniciar un cobro a esa tarjeta.

¿Cómo asocio una tarjeta a uno de mis usuarios?

Usa customerRef — es tu identificador, el que ya usas en tu sistema (un id, un correo, un uuid). El flujo:

Tu cliente inicia un pago → creas la sesión con "customerRef": "usuario_123".
El cobro se aprueba → la tarjeta se guarda etiquetada con usuario_123.
Más tarde recuperas sus tarjetas: GET /v1/cards?customerRef=usuario_123.

Así un mismo cliente puede tener varias tarjetas, y tú las identificas con tus propios ids — sin manejar nunca datos sensibles.

Notas

El CVV no se almacena (por diseño es de un solo uso). Para volver a cobrar una tarjeta guardada en flujos que exigen CVV, el comprador deberá reingresarlo.
Tarjetas repetidas se deduplican: si el mismo cliente paga dos veces con la misma tarjeta, se reutiliza un único registro.