Skip to main content
WEBHOOK
EVENTS.REDEMPTION.FAILED
{
  "order": null,
  "holder": null,
  "voucher": null,
  "campaign": null,
  "customer": {
    "id": "cust_1g637SqVZnkdPNdAIZ7Ra879",
    "name": "Jane Doe",
    "email": "jane@jane.io",
    "object": "customer",
    "metadata": {
      "lang": "en",
      "region": "EMEA"
    },
    "source_id": "test_customer_id_2"
  },
  "created_at": "2024-02-02T12:12:12.919Z",
  "redemption": {
    "id": "rf_0e3ac5685ba431c104",
    "date": "2024-02-02T12:12:12.918Z",
    "object": "redemption",
    "result": "FAILURE",
    "status": "FAILED",
    "customer": {
      "id": "cust_1g637SqVZnkdPNdAIZ7Ra879",
      "name": "Jane Doe",
      "email": "jane@jane.io",
      "object": "customer",
      "metadata": {
        "lang": "en",
        "region": "EMEA"
      },
      "source_id": "test_customer_id_2"
    },
    "metadata": {},
    "customer_id": "cust_1g637SqVZnkdPNdAIZ7Ra879",
    "tracking_id": "track_Pw6r3ejnml43kIwNS4Zj09KZ67xOfLUy",
    "failure_code": "no_applicable_redeemables",
    "failure_message": "No applicable redeemables"
  },
  "promotion_tier": null
}
The EVENTS.REDEMPTION.FAILED event indicates that the redemption process encountered issues while applying the voucher codes or promotions tiers. As a result, the redemption was unsuccessful. This event is used in a webhook configured in Project settings in Voucherify dashboard.
This page documents only the event. If you need more details about the webhook payload data that includes this event, go to Introduction to webhooks page.

Body

application/json

Event data object schema for redemption.failed.

customer
Simple Customer · object | null

Simplified customer data.

order
Simple Order · object | null

Order information.

campaign
Simple Campaign · object | null

Simplified campaign data.

voucher
Simple Voucher · object | null

Simplified voucher data.

holder
Simple Customer · object | null

Details about the redeemable holder.

promotion_tier
Simple Promotion Tier · object | null

Simplified promotion tier data.

promotion_stack
Simple Promotion Stack · object | null

Simplified promotion stack data.

redemption
Simple Redemption · object | null

Simplified redemption data.

created_at
string<date-time>

Timestamp representing the date and time when the redemption failed in the ISO 8601 format.

Example:

"2024-01-01T11:11:11.111Z"

Response

Webhook accepted

Last modified on May 4, 2026