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
accessTokenzurü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..."
}
Downloadlinks für Wallet-Pässe ¶
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.
Sitzungslinks für die Kunden-App ¶
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. |