Loyalität: Informationen aktualisieren und erstellen

Sie können die Kundenbindungsdaten eines Kunden über die spezielle Funktion "Kundenbindung" erstellen oder aktualisieren. POST API-Endpunkt, der ein Array von Objekten als Anforderungskörper akzeptiert.
‍

https://api.jericommerce.com/v1/programs/{{program_id}}/integrations/api

‍

Es ist wichtig zu wissen, dass der Benutzer in der API existieren muss, bevor Sie Loyalitätsinformationen hinzufügen können.

Sie können sowohl die Kunden- als auch die Treueinformationen in derselben API-Anfrage hinzufügen, aber Sie sollten sicherstellen, dass die Reihenfolge erhalten bleibt, indem Sie zuerst die Kundeninformationen hinzufügen.

‍

Für die Treueinformationen sollte bereits ein Kunde angelegt sein

‍

Hier ein Beispiel für die Aktualisierung eines Kunden:

1[
2  {
3    "email": "string",
4    "feature": "loyalty",
5    "payload": {
6      "loyaltyCustomerId": "string",
7      "balance": number,
8      "memberSince": IsoDate,
9      "tierStatus": "string"
10    }
11  }
12]

‍

Eigenschaften der Nutzlast

‍

loyaltyCustomerId

Ist der externe Verweis auf diese Informationen, der nützlich ist, wenn Sie diese Informationen mit einer anderen Datenbank verknüpfen müssen.
Ist für jede Anfrage obligatorisch.

Bilanz

Eine der wichtigsten Eigenschaften ist der Kundensaldo. Unsere API berechnet hier keinen Wert, sondern aktualisiert den Wert einfach mit dem in der Anfrage angegebenen Wert.
Es ist ein Pflichtfeld, sollte ein Zahlenformat haben und immer größer als 0 sein.

‍

memberSince

Ist das Datum, an dem der Kunde in Ihrem Loyalitätsprogramm registriert wurde.
Das erforderliche Feld sollte im ISO-String-Format sein.
Das Feld ist obligatorisch und für jeden Anruf erforderlich.

‍

tierStatus

Die Abhängigkeit vom Treueprogramm kann einen abgestuften Status haben oder nicht, so dass Sie hier den Namen der Stufe hinzufügen können.
Die optionale String-Eigenschaft kann der gewünschte Wert sein.