Mit JeriCommerce können Sie Tokens für zwei Arten von Kundenlinks erstellen: Downloadlinks für den Wallet-Pass (Apple Wallet oder Google Wallet) und Sitzungslinks, die Kunden direkt in der Kunden-App anmelden.

Diese Links eignen sich zum Versenden per E-Mail oder SMS sowie zum Einfügen in die eigene Website oder App.

Das benötigen Sie

  • Ihren API Key unter Settings > Technical > API keys. Ist der Schlüssel eingeschränkt, braucht er die Berechtigung Customer tokens. Siehe Authentifizierung über die API.
  • Ihren Program-Slug oder Ihre Program ID unter Settings > Technical > Program Information.
  • Die E-Mail-Adresse des Kunden

Funktionsweise

  • Rufen Sie den unten beschriebenen Endpunkt mit der E-Mail-Adresse des Kunden und dem gewünschten Tokentyp auf.
  • Die API gibt ein accessToken zurück.
  • Kodieren Sie das Token mit Base64 und erstellen Sie die URL in einem der unten gezeigten Formate.

Endpunkt

GET https://api.jericommerce.com/v1/programs/{program_slug}/customers/token?email={customerEmail}&token_type=download&expires_in=7d
Parameter Erforderlich Hinweise
email Ja Die E-Mail-Adresse des Kunden, URL-kodiert.
token_type Ja download für einen Downloadlink der Treuekarte oder auth für einen Sitzungslink der Kunden-App.
expires_in Nein Wie lange das Token gültig ist, in Sekunden oder als Zeitspanne wie 10h, 2 days oder 7d. Ohne diesen Parameter läuft das Token nach 7 Tagen ab.

Wenn Sie expires_in nicht senden, läuft das Token nach 7 Tagen ab. Bis dahin kann jeder, der den Link kennt, ihn nutzen. Legen Sie deshalb eine Ablaufzeit fest, die dazu passt, wie Sie den Link weitergeben.

Eine erfolgreiche Anfrage gibt 200 zurück:

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

Um einen Link zu erstellen, über den ein Kunde seine Treuekarte herunterladen kann, fordern Sie ein Token mit token_type=download an und erstellen Sie die folgende URL:

https://jeri.link/{program-slug}/download?token={base64Token} Wenn Kunden diesen Link öffnen, können sie zwischen Apple Wallet und Google Wallet wählen.

JeriCommerce synchronisiert diese Download-URL bereits automatisch über Integrationen. Wenn Sie Shopify oder Klaviyo verwenden, müssen Sie den Link möglicherweise nicht manuell erstellen. Weitere Informationen: Download-URL der Treuekarte mit Shopify-Profilen synchronisieren, Custom Fields mit Shopify synchronisieren und Custom Fields mit Klaviyo synchronisieren.

Um einen Link zu erstellen, über den ein Kunde direkt in einem bestimmten Bereich der Kunden-App angemeldet wird, fordern Sie ein Token mit token_type=auth an und erstellen Sie die URL mit einem redirectTo-Pfad:

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

Der Kunde muss für diesen Tokentyp bereits eine Treuekarte haben.

Verfügbare Bereiche

Pfad Ziel
profile Kundenprofil
loyalty/rewards Verfügbare Prämien
loyalty/earning-flows Sammelaktionen für Punkte
referrals Empfehlungsprogramm
coupons Coupons des Kunden
transactions Transaktionsverlauf

Verwenden Sie beispielsweise den Pfad loyalty/rewards, um Kunden aus einer Werbe-E-Mail direkt zur Prämienseite zu leiten.

URL-Formate auf einen Blick

Linktyp URL-Format
Download https://jeri.link/{slug}/download?token={base64Token}
Sitzung https://jeri.link/{slug}/{base64Token}?redirectTo={path}

Fehler

Code Status Bedeutung
CUSTOMER_NOT_REGISTERED 400 Im Programm gibt es keinen Kunden mit dieser E-Mail-Adresse.
CUSTOMER_HAS_NO_USER_DATA 412 Der Kunde hat noch keine Profildaten. Legen Sie sie über den Kundenendpunkt an.
CUSTOMER_HAS_NO_PASSES_FOR_THIS_PROGRAM 412 Nur bei auth. Der Kunde hat noch keine Treuekarte.