JeriCommerce permette di generare token per creare due tipi di link: link per scaricare il wallet pass (Apple Wallet o Google Wallet) e link di sessione per accedere direttamente alla Customer App.

Puoi inviare questi link tramite email, SMS oppure inserirli nel tuo sito o nella tua app.

Cosa ti serve

  • La API Key, disponibile in JeriCommerce Admin → Settings → Technical → API Keys
  • Il Program ID o lo slug, visibile nelle impostazioni del programma
  • L'indirizzo email del cliente

Come funziona

  • Chiama l'endpoint Get Customer Token con l'email del cliente e il tipo di token necessario.
  • L'API restituisce un accessToken.
  • Codifica il token in Base64 e crea l'URL usando i formati qui sotto.

Per creare un link con cui il cliente può scaricare la carta fedeltà, richiedi un token con token_type=download e crea l'URL:

https://jeri.link/{program-slug}/download?token={base64Token} Quando il cliente apre il link, può scegliere tra Apple Wallet e Google Wallet.

JeriCommerce sincronizza già automaticamente questo URL tramite le integrazioni. Se usi Shopify o Klaviyo, potresti non doverlo generare manualmente. Per i dettagli, consulta Sincronizza l'URL di download della carta fedeltà con i profili Shopify, Sincronizza i campi personalizzati con Shopify e Sincronizza i campi personalizzati con Klaviyo.

Per creare un link che faccia accedere direttamente il cliente a una sezione specifica della Customer App, richiedi un token con token_type=auth e crea l'URL includendo un percorso redirectTo:

https://jeri.link/{program-slug}/{base64Token}?redirectTo={path}

Sezioni disponibili

Percorso Destinazione
profile Profilo cliente
loyalty/rewards Premi disponibili
loyalty/earning-flows Modi per accumulare punti
referrals Programma referral
coupons Coupon del cliente
transactions Cronologia delle transazioni

Per esempio, usa il percorso loyalty/rewards per indirizzare i clienti alla pagina dei premi da un'email promozionale.

Riepilogo dei formati URL

Tipo di link Formato URL
Download https://jeri.link/{slug}/download?token={base64Token}
Sessione https://jeri.link/{slug}/{base64Token}?redirectTo={path}

Documentazione API

Per la specifica completa dell'endpoint, i parametri della richiesta, gli esempi di codice e la gestione degli errori, consulta l'endpoint Get Customer Token nella documentazione API di JeriCommerce.