GuíasPortal de cliente

Portal de cliente

El portal de cliente es una página alojada por Rekurra donde el cliente final de tu negocio puede gestionar su propia suscripción y su método de pago, sin que tengas que construir esas pantallas tú mismo.

Tu backend crea una sesión de portal autenticándose con tu API key de desarrollador y recibe una url de un solo uso, ya lista para enviar al cliente — tu backend no construye ni manipula el token, solo reenvía o redirige al cliente a esa url.

Crea la sesión de portal desde tu backend

Esta llamada debe hacerse siempre desde tu servidor, nunca desde el navegador del cliente, porque usa tu API key de desarrollador.

POST /v1/portal-sessions

CampoTipoRequeridoDescripción
customer_idstringSíCliente para el que se abre el portal.
curl -X POST https://api.rekurra.dev/v1/portal-sessions \
  -H "Authorization: Bearer rk_test_XXXXXXXXXXXXXXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "cus_01HZK3M9P2Q7X4R8T1V6W3A2B5"
  }'
201 Created
{
  "url": "https://checkout.rekurra.dev/s/eyJhbGciOiJIUzI1NiJ9.st_01HZK3M9P2Q7X4R8T1V6W3A2B5",
  "expires_at": "2026-08-27T18:45:00Z"
}

Lee la url y el expires_at

La url es un enlace de capacidad completo (https://checkout.rekurra.dev/s/{token}), de un solo uso y de vida corta — úsala antes de expires_at o deberás crear una sesión nueva. No es necesario que interpretes el token: es opaco y lo resuelve la SPA de checkout, no tu backend.

Redirige o envía al cliente a esa url

Puedes redirigir al cliente directamente (por ejemplo, window.location.href = url) o enviársela por correo si el flujo es asíncrono (por ejemplo, desde un enlace en un email de “gestiona tu suscripción”). Al abrir la url, la SPA de checkout intercambia el token por una sesión de forma automática y muestra al cliente su suscripción y su método de pago actuales, permitiéndole actualizarlos.