Wenn Ihr Treueprogramm in einem anderen System läuft, können Sie Punktestand und Stufenstatus jedes Kunden an JeriCommerce senden, damit seine Treuekarte sie anzeigt. Dafür verwenden Sie denselben Endpunkt wie für Kundendaten, mit loyalty als Funktion. Als Anfrage-Body wird ein Array von bis zu 250 Objekten übergeben.

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

Dieser Endpunkt ist Teil der Custom-API-Integration. Er setzt voraus, dass die Integration unter Settings > Integrations > API aktiv und die Funktion Loyalty eingeschaltet ist. Andernfalls antwortet er mit 403 und API_INTEGRATION_REQUIRED oder API_LOYALTY_REQUIRED.

Wenn Sie einem JeriCommerce-Treueprogramm Punkte hinzufügen möchten, statt den Punktestand zu ersetzen, verwenden Sie Increase balance.

Der Kunde muss bereits existieren, bevor Sie Treueinformationen hinzufügen. Existiert er nicht, wird der Treueeintrag ohne Fehlermeldung übersprungen.

Sie können Kunden- und Treueinformationen in derselben API-Anfrage senden. Achten Sie darauf, zuerst die Kundeninformationen anzugeben.

Beispiel für den Body zum Aktualisieren eines Kunden:

[
  {
    "email": "{{customer_email}}",
    "feature": "loyalty",
    "payload": {
      "loyaltyCustomerId": "{{customer_loyalty_id}}",
      "balance": "{{balance_to_apply}}",
      "memberSince": "{{customer_join_date}}",
      "tierStatus": "{{customer_tier}}"
    }
  }
]

Payload-Eigenschaften

loyaltyCustomerId

Dies ist die externe Kennung dieser Treueinformationen. Sie ist hilfreich, wenn Sie die Daten mit einer anderen Datenbank verknüpfen müssen. Sie ist bei jeder Anfrage erforderlich. Sie wird beim ersten Mal gespeichert und danach beibehalten.

Balance

Der Kundenpunktestand ist eine der wichtigsten Eigenschaften. Die API berechnet keinen Wert, sondern ersetzt den Punktestand durch den in der Anfrage übergebenen Wert. Das Feld ist erforderlich. Senden Sie eine Zahl ab 0. Dezimalstellen werden auf die nächste ganze Zahl gerundet.

memberSince

Das Datum, an dem sich der Kunde für Ihr Treueprogramm registriert hat, im ISO-8601-Format (zum Beispiel 2026-01-31). Das Feld ist optional. Wenn Sie es nicht senden, behält JeriCommerce das aktuelle Datum bei oder verwendet bei einem neuen Kunden das heutige Datum.

tierStatus

Je nach Treueprogramm können Stufen vorhanden sein oder nicht. Hier können Sie den Stufennamen eintragen. Diese optionale Eigenschaft ist ein String und kann den gewünschten Wert enthalten.

Response

Für die Antwort gelten dieselben Regeln wie beim Kundenendpunkt: 201, wenn alle Einträge gespeichert wurden. Ändern sich Punktestand oder Stufe, erhält der Kunde eine Wallet-Benachrichtigung, sofern er diese Benachrichtigungen eingeschaltet hat.

Der Prämienkatalog des Programms hat einen eigenen Endpunkt: List rewards.