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..."
}

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.

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.