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, da Settings > Technical > API keys. Se la chiave ha restrizioni, ha bisogno del permesso Customer tokens. Consulta Autenticazione tramite API.
  • Lo slug del programma o l'ID del programma, da Settings > Technical > Program Information.
  • L'indirizzo email del cliente

Come funziona

  • Chiama l'endpoint qui sotto 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.

Endpoint

GET https://api.jericommerce.com/v1/programs/{program_slug}/customers/token?email={customerEmail}&token_type=download&expires_in=7d
Parametro Obbligatorio Note
email Sì L'indirizzo email del cliente, con codifica URL.
token_type Sì download per un link di download della carta fedeltà, oppure auth per un link di sessione della Customer App.
expires_in No Per quanto tempo il token è valido, in secondi o come intervallo di tempo, per esempio 10h, 2 days o 7d. Se non lo invii, il token scade dopo 7 giorni.

Se non invii expires_in, il token scade dopo 7 giorni. Fino ad allora chiunque abbia il link può usarlo, quindi imposta una scadenza adatta al modo in cui condividi il link.

Una richiesta riuscita restituisce 200:

{
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

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}

Il cliente deve avere già una carta fedeltà per questo tipo di token.

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}

Errori

Codice Stato Significato
CUSTOMER_NOT_REGISTERED 400 Nel programma non esiste nessun cliente con questa email.
CUSTOMER_HAS_NO_USER_DATA 412 Il cliente non ha ancora dati di profilo. Creali con l'endpoint cliente.
CUSTOMER_HAS_NO_PASSES_FOR_THIS_PROGRAM 412 Solo per auth. Il cliente non ha ancora una carta fedeltà.