Échanger une récompense

Cette action échange une récompense pour un client, comme il le ferait depuis sa Customer App. JeriCommerce vérifie les règles de la récompense, retire les points et donne au client un code de réduction. Utilisez-la quand les clients échangent depuis votre propre site, application ou point de vente, ou pour échanger automatiquement depuis un flow Klaviyo.

Ce qui se passe ¶

• Les points de la récompense sont retirés du solde du client.
• Le client reçoit un code de réduction : un nouveau code Shopify à usage unique ou le prochain code de votre lot importé, selon la remise de la récompense.
• Le client reçoit un e-mail avec le code, et le code apparaît dans ses coupons.
• Un événement Reward redeemed avec le code et un événement Balance changed sont envoyés à votre webhook d’événements. Écoutez Reward redeemed si votre système a besoin du code.

Une Fixed reward coûte toujours son Points cost. Une récompense Points as cash laisse le client choisir combien de points utiliser, entre le minimum et le maximum de la récompense. La réduction est égale aux points multipliés par la valeur de chaque point, arrondie à deux décimales. Par exemple, 500 points valant 0,02 chacun donnent une réduction de 10,00.

L’échange est refusé, sans retirer de points, quand :

• Le client n’a pas assez de points, ou certains de ses points sont encore en attente.
• Le client ne respecte pas les règles de visibilité ou de segment de la récompense.
• La remise de la récompense n’a plus de codes.
• Les points à échanger sont absents pour une récompense Points as cash, ou en dehors de son minimum et de son maximum.

Mise en place ¶

[
  {
    "email": "{{ person.email|default:'' }}",
    "rewardId": ""
  }
]

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

[
  {
    "email": "customer@example.com",
    "rewardId": "2f6c1a2e-8f3b-4f0e-9a51-1d2b3c4d5e6f"
  }
]

curl --request POST \
  --url 'https://api.jericommerce.com/v1/programs/your-program-slug/reward/redeem' \
  --header 'api-key: your-api-key' \
  --header 'Content-Type: application/json' \
  --data '[
  {
    "email": "customer@example.com",
    "rewardId": ""
  }
]'