Canjear una recompensa

Esta acción canjea una recompensa para un cliente, igual que lo haría él desde su Customer App. JeriCommerce comprueba las reglas de la recompensa, resta los puntos y da al cliente un código de descuento. Úsala cuando los clientes canjeen desde tu propia web, tu aplicación o tu punto de venta, o para canjear automáticamente desde un flujo de Klaviyo.

Qué ocurre ¶

• Los puntos de la recompensa se restan del saldo del cliente.
• El cliente recibe un código de descuento: un código nuevo de Shopify de un solo uso o el siguiente código de tu lote subido, según el descuento de la recompensa.
• El cliente recibe un correo con el código, y el código aparece en sus cupones.
• Se envían a tu webhook de eventos un evento Reward redeemed con el code y un evento Balance changed. Escucha Reward redeemed si tu sistema necesita el código.

Una Fixed reward siempre cuesta lo que indica su Points cost. Una recompensa Points as cash permite que el cliente elija cuántos puntos usar, entre el mínimo y el máximo de la recompensa. El descuento son los puntos multiplicados por el valor de cada punto, redondeado a dos decimales. Por ejemplo, 500 puntos que valen 0,02 cada uno dan un descuento de 10,00.

El canje se rechaza, sin restar puntos, cuando:

• El cliente no tiene puntos suficientes, o algunos de sus puntos siguen retenidos.
• El cliente no cumple las reglas de visibilidad o de segmento de la recompensa.
• El descuento de la recompensa se ha quedado sin códigos.
• Faltan los puntos que canjear en una recompensa Points as cash, o están fuera de su mínimo y su máximo.

Configúralo ¶

[
  {
    "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": ""
  }
]'