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, que encontrarás en Settings > Technical > API keys. Si la clave está restringida, necesita el permiso Customer tokens. Consulta Autenticación mediante la API.
- El slug o el ID de tu programa, que encontrarás en Settings > Technical > Program Information.
- La dirección de correo del cliente.
Cómo funciona ¶
- Llama al endpoint siguiente 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.
Endpoint ¶
GET https://api.jericommerce.com/v1/programs/{program_slug}/customers/token?email={customerEmail}&token_type=download&expires_in=7d
| Parámetro | Obligatorio | Notas |
|---|---|---|
email |
Sí | La dirección de correo del cliente, codificada para URL. |
token_type |
Sí | download para un enlace de descarga de la tarjeta de fidelización, o auth para un enlace de sesión de Customer App. |
expires_in |
No | Cuánto tiempo es válido el token, en segundos o como un periodo de tiempo, por ejemplo 10h, 2 days o 7d. Si no lo envías, el token caduca a los 7 días. |
Si no envías expires_in, el token caduca a los 7 días. Hasta entonces, cualquiera que tenga el enlace podrá usarlo, así que define una caducidad acorde con la forma en que compartes el enlace.
Una solicitud correcta devuelve 200:
{
"accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}
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}
El cliente debe tener ya una tarjeta de fidelización para este tipo de token.
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} |
Errores ¶
| Código | Estado | Significado |
|---|---|---|
CUSTOMER_NOT_REGISTERED |
400 |
No existe ningún cliente con ese correo en el programa. |
CUSTOMER_HAS_NO_USER_DATA |
412 |
El cliente todavía no tiene datos de perfil. Créalos con el endpoint de clientes. |
CUSTOMER_HAS_NO_PASSES_FOR_THIS_PROGRAM |
412 |
Solo con auth. El cliente todavía no tiene una tarjeta de fidelización. |