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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
customer_id | string | Sí | 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"
}'{
"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.