Downgraded

Event data sent for a Loyalty v2 DOWNGRADED transaction handled by Workflows

WEBHOOK DOWNGRADED

DOWNGRADED

{
  "transaction": {
    "id": "lttx_91f6b2e84a37",
    "card_id": "lcrd_28c4e7b195fa",
    "program_id": "lprg_3e8a1c74d952",
    "member_id": "lmbr_91f6b2e84a37",
    "card_definition_id": "lcdef_6a2d9f41c783",
    "tier_structure_id": "lts_3e8a1c74d952",
    "tier_id": "lt_6a2d9f41c783",
    "status": "APPROVED",
    "created_at": "2026-09-09T10:15:43.091Z",
    "updated_at": "2026-09-09T10:15:43.284Z",
    "object": "tier_transaction",
    "type": "DOWNGRADED",
    "details": {
      "points": 400,
      "tier_from": "lt_91f6b2e84a37",
      "tier_to": "lt_6a2d9f41c783",
      "origin": {
        "type": "daily_task_operations"
      },
      "rejection": null,
      "start_at": "2026-09-09T10:15:43.091Z",
      "expires_at": "2027-09-09T23:59:59.999Z"
    }
  }
}

The DOWNGRADED event indicates that a member moved to a lower Loyalty v2 tier.

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 Tier transactions group and the DOWNGRADED 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, APPROVED, or REJECTED. The matched status is available in data.trigger.transaction.status; it does not create a separate event type.

Voucherify creates this transaction when the member no longer qualifies for the current tier and a lower tier still applies. If no tier applies, the transaction is LEFT.

• The tier structure has no retention, and the member’s points qualify for a lower tier.
• The member’s retention period has ended and the member qualifies for a lower tier. While retention is still active, Voucherify keeps the current tier and creates an EXPIRATION_CHANGED transaction instead. The downgrade is created when the expired tier is recalculated.
• MULTI_LEVEL moves the member to the tier the points qualify for. SINGLE_LEVEL moves the member one tier below the highest tier reached in the current cycle, even when the points qualify for a lower tier or for none. A later drop in the same cycle does not drop another level. That recalculation is an EVALUATION_REFRESHED transaction.

A tier structure with NO_DOWNGRADE never creates this transaction. The member stays in the current tier, and the recalculation is an EVALUATION_REFRESHED transaction.

details.tier_from and details.tier_to are tier IDs. They are not nested tier objects.

Body

application/json

Event data object schema for DOWNGRADED.

transaction · Loyalty Tier Downgraded Transaction · object · required

A Loyalty v2 tier transaction with the DOWNGRADED type.

Show child attributes

Response

200

Webhook accepted