Skip to main content
WEBHOOK
The POINTS_RETURNED event indicates that points spent on a reward were returned to a Loyalty v2 card.
This page documents only the event data nested under data. See Introduction to webhooks for the shared webhook structure, and Workflows webhooks for the full Workflows webhook payload.
This event can trigger a workflow when Loyalty transaction is configured with the Card transactions group and the POINTS_RETURNED transaction type. If the workflow reaches a Webhook callout action, Voucherify sends a webhook to the action’s target URL. Workflows send this transaction in the data.trigger object. The example uses the APPROVED status. A workflow can filter the trigger by transaction status: PENDING or APPROVED. The matched status is available in data.trigger.transaction.status; it does not create a separate event type. Refunding a reward also creates a separate REFUND reward transaction. That payload is not included in this event. Use the Refund event to get details about the reward transaction. When the original reward was loyalty card points, Voucherify also creates a separate POINTS_PURCHASE_REVERSED transaction on the destination card. A POINTS_RETURNED event can also occur without POINTS_PURCHASE_REVERSED when the original reward was not loyalty card points. Use the Points purchase reversed event to get details about the destination card transaction.

Body

application/json

Event data object schema for POINTS_RETURNED.

transaction
Loyalty Points Returned Transaction · object
required

A Loyalty v2 card transaction with the POINTS_RETURNED type.

Response

Webhook accepted

Last modified on September 25, 2026