Si votre programme de fidélité fonctionne dans un autre système, vous pouvez envoyer le solde et le statut de niveau de chaque client à JeriCommerce pour que leur carte de fidélité les affiche. Vous utilisez le même point de terminaison que pour les données client, avec loyalty comme fonctionnalité. Il accepte dans le corps de la requête un tableau d'un maximum de 250 objets.
POST https://api.jericommerce.com/v1/programs/{program_slug}/integrations/api
Ce point de terminaison fait partie de l'intégration Custom API. Il nécessite que l'intégration soit active sous Settings > Integrations > API, avec la fonctionnalité Loyalty activée. Sinon, il répond 403 avec API_INTEGRATION_REQUIRED ou API_LOYALTY_REQUIRED.
Pour ajouter des points à un programme de fidélité JeriCommerce au lieu de remplacer le solde, utilisez Augmenter le solde.
Le client doit déjà exister avant que vous puissiez lui ajouter des informations de fidélité. S'il n'existe pas, l'élément de fidélité est ignoré sans erreur.
Vous pouvez transmettre les informations du client et celles de fidélité dans la même requête API, à condition de respecter leur ordre : ajoutez d'abord les informations du client.
Voici un exemple de corps pour mettre à jour un client :
[
{
"email": "{{customer_email}}",
"feature": "loyalty",
"payload": {
"loyaltyCustomerId": "{{customer_loyalty_id}}",
"balance": "{{balance_to_apply}}",
"memberSince": "{{customer_join_date}}",
"tierStatus": "{{customer_tier}}"
}
}
]
Propriétés de la charge utile ¶
loyaltyCustomerId ¶
Référence externe des informations de fidélité, utile lorsque vous devez les associer à une autre base de données. Cette propriété est obligatoire pour chaque requête. Elle est enregistrée la première fois, puis conservée.
Balance ¶
Le solde du client est l'une des propriétés les plus importantes. Notre API ne calcule pas sa valeur : elle remplace simplement le solde par la valeur fournie dans la requête. Ce champ est obligatoire. Envoyez un nombre égal ou supérieur à 0. Les décimales sont arrondies à l'entier le plus proche.
memberSince ¶
Date d'inscription du client à votre programme de fidélité, au format ISO 8601 (par exemple, 2026-01-31).
Ce champ est facultatif. Si vous ne l'envoyez pas, JeriCommerce conserve la date actuelle, ou utilise la date du jour pour un nouveau client.
tierStatus ¶
Selon votre programme de fidélité, les clients peuvent avoir un statut de niveau ou non. Vous pouvez indiquer ici le nom du niveau. Cette propriété facultative est une chaîne qui peut contenir la valeur souhaitée.
Réponse ¶
La réponse suit les mêmes règles que pour le point de terminaison client : 201 lorsque tous les éléments sont enregistrés. Lorsque le solde ou le niveau change, le client reçoit une notification Wallet s'il a activé ces notifications.
Le catalogue de récompenses du programme a son propre point de terminaison : Lister les récompenses.