JeriCommerce permite generar tokens para crear dos tipos de enlaces: enlaces para descargar el wallet pass (Apple Wallet / Google Wallet) y enlaces de sesión para iniciar la sesión del cliente en Customer App.
Estos enlaces son ideales para enviarlos por correo o SMS, o insertarlos en tu propio sitio web o aplicación.
Qué necesitas ¶
- Tu API Key — está en JeriCommerce Admin → Settings → Technical → API Keys.
- Tu Program ID (o slug) — aparece en la configuración del programa.
- La dirección de correo del cliente.
Cómo funciona ¶
- Llama al endpoint Get Customer Token con el correo del cliente y el tipo de token necesario.
- La API devuelve un
accessToken. - Codifica el token en Base64 y construye la URL con los formatos siguientes.
Enlaces para descargar el wallet pass ¶
Para generar un enlace de descarga de la tarjeta de fidelización, solicita un token con token_type=download y construye la URL:
https://jeri.link/{program-slug}/download?token={base64Token} Al abrirla, el cliente verá una página para elegir Apple Wallet o Google Wallet.
JeriCommerce ya sincroniza esta URL automáticamente mediante las integraciones. Si usas Shopify o Klaviyo, quizá no tengas que generarla a mano. Consulta Sincronizar la URL de descarga de la tarjeta con perfiles de Shopify, Sincronizar campos personalizados con Shopify y Sincronizar campos personalizados con Klaviyo.
Enlaces de sesión de Customer App ¶
Para iniciar la sesión del cliente directamente en una sección de Customer App, solicita un token con token_type=auth y construye la URL con una ruta redirectTo:
https://jeri.link/{program-slug}/{base64Token}?redirectTo={path}
Secciones disponibles ¶
| Ruta | Destino |
|---|---|
profile |
Perfil del cliente |
loyalty/rewards |
Recompensas disponibles |
loyalty/earning-flows |
Formas de obtener puntos |
referrals |
Programa de referidos |
coupons |
Cupones del cliente |
transactions |
Historial de transacciones |
Por ejemplo, usa loyalty/rewards para dirigir desde un correo promocional a la página de recompensas.
Resumen de formatos de URL ¶
| Tipo de enlace | Formato de URL |
|---|---|
| Descarga | https://jeri.link/{slug}/download?token={base64Token} |
| Sesión | https://jeri.link/{slug}/{base64Token}?redirectTo={path} |
Documentación de la API ¶
Consulta la especificación del endpoint, parámetros, ejemplos de código y gestión de errores en Get Customer Token, dentro de la documentación de la API de JeriCommerce.