Inicio rápido

Integra un cobro de punta a punta en 4 pasos.

Obtén tus claves

Entra a tu panel de comercio → Claves de API y genera:

Una clave secreta (sk_test_…) para tu servidor.
Una clave publicable (pk_test_…) para el checkout.

Empieza siempre en modo test.

Crea una sesión de pago (en tu servidor)

curl


curl -X POST https://api.seif.pagosripei.com/v1/sessions \
  -H "Authorization: Bearer sk_test_tu_clave" \
  -H "Content-Type: application/json" \
  -d '{
    "amountMinor": 105000,
    "currency": "VES",
    "customerRef": "usuario_123",
    "description": "Pedido #1042",
    "returnUrl": "https://mitienda.com/gracias"
  }'

Respuesta:


{
  "id": "9f0c...e3",
  "reference": "cs_8sKd2...Aa",
  "status": "created",
  "amountMinor": 105000,
  "currency": "VES",
  "expiresAt": "2026-06-09T18:30:00.000Z",
  "checkoutUrl": "https://checkout.seif.pagosripei.com/checkout?session=cs_8sKd2...Aa",
  "description": "Pedido #1042"
}

Lleva al comprador al checkout

Abre el checkoutUrl en el navegador del comprador. Tienes dos opciones:

Redirección simple: redirige a checkoutUrl.
Incrustado (iframe): monta el checkout dentro de tu página. Ver Checkout incrustado.

El comprador ingresa su tarjeta (los datos viven en los campos seguros de VGS, nunca en tu sitio) y paga.

Recibe el resultado

Al aprobarse, Seif redirige al comprador a tu returnUrl (si lo enviaste).
Tu servidor recibe un webhook charge.approved / charge.declined / charge.failed. Ver Webhooks.
Puedes consultar la transacción en GET /v1/transactions.

¿Quieres almacenar la tarjeta del cliente para volver a cobrarla? Solo envía tu customerRef al crear la sesión: al aprobarse el cobro, la tarjeta queda guardada y asociada a ese cliente. Ver Tarjetas guardadas.