Voucher loyalty_card points_expired

EVENT: "EVENTS.CUSTOMER.VOUCHER.LOYALTY_CARD.POINTS_EXPIRED"
HTTP method: POST

The EVENTS.CUSTOMER.VOUCHER.LOYALTY_CARD.POINTS_EXPIRED event indicates that loyalty points have expired on a customer's loyalty card. It informs about the loyalty points that were removed under the expiration rules set in the loyalty campaign.

📘

Webhook documentation

This page documents only the event. If you need more details about the webhook payload data that includes this event, go to Webhook v2024-01-01 page.

Example: customer.voucher.loyalty card.points expired

{
  "customer": {
    "id": "cust_IdgAFZxYwwHctOk9pPuMu308",
    "name": "Jack Webhook",
    "source_id": "jck-wbhk",
    "metadata": {
      "region": "EMEA",
      "sign-up": "true"
    },
    "object": "customer"
  },
  "campaign": {
    "id": "camp_AQZ1GLRlbGaC2dETd31VbJQ9",
    "name": "Loyalty programme",
    "campaign_type": "LOYALTY_PROGRAM",
    "type": "AUTO_UPDATE",
    "voucher": {
      "type": "LOYALTY_CARD",
      "loyalty_card": {
        "points": 0
      },
      "redemption": {
        "quantity": null
      },
      "code_config": {
        "length": 8,
        "charset": "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ",
        "pattern": "########"
      }
    },
    "auto_join": false,
    "join_once": true,
    "active": true,
    "category_id": null,
    "metadata": {},
    "created_at": "2024-01-18T15:18:38.577Z",
    "updated_at": "2024-03-14T10:01:16.596Z",
    "object": "campaign"
  },
  "voucher": {
    "id": "v_hjQhSsitD6lAATASbRV1Ef7dUCjpy0iw",
    "code": "MBOpskws",
    "loyalty_card": {
      "points": 992,
      "balance": 262,
      "next_expiration_date": "2024-05-30"
    },
    "type": "LOYALTY_CARD",
    "campaign": "Loyalty programme",
    "campaign_id": "camp_AQZ1GLRlbGaC2dETd31VbJQ9",
    "is_referral_code": false,
    "holder_id": "cust_IdgAFZxYwwHctOk9pPuMu308",
    "category_id": null,
    "active": true,
    "created_at": "2024-01-18T15:18:39.015Z",
    "updated_at": "2024-03-15T00:02:09.334Z",
    "redemption": {
      "quantity": null,
      "redeemed_quantity": 7,
      "redeemed_points": 730
    },
    "start_date": null,
    "expiration_date": null,
    "metadata": {},
    "object": "voucher"
  },
  "points": 70,
  "buckets": [
    {
      "id": "lopb_wQey6iuachtxVonzt51V01Qx",
      "voucher_id": "v_hjQhSsitD6lAATASbRV1Ef7dUCjpy0iw",
      "campaign_id": "camp_AQZ1GLRlbGaC2dETd31VbJQ9",
      "bucket": {
        "total_points": 70
      },
      "status": "ACTIVE",
      "expires_at": "2024-03-14",
      "created_at": "2024-03-13T17:39:56.818Z",
      "updated_at": "2024-03-14T15:29:33.239Z",
      "object": "loyalty_points_bucket"
    }
  ],
  "transaction": {
    "id": "vtx_0e719686512773b205",
    "source_id": null,
    "voucher_id": "v_hjQhSsitD6lAATASbRV1Ef7dUCjpy0iw",
    "campaign_id": "camp_AQZ1GLRlbGaC2dETd31VbJQ9",
    "source": "Automation",
    "reason": null,
    "type": "POINTS_EXPIRATION",
    "details": {
      "balance": {
        "type": "loyalty_card",
        "total": 992,
        "object": "balance",
        "points": -70,
        "balance": 262,
        "related_object": {
          "id": "v_hjQhSsitD6lAATASbRV1Ef7dUCjpy0iw",
          "type": "voucher"
        }
      }
    },
    "related_transaction_id": null,
    "created_at": "2024-03-15T00:02:09.334Z"
  }
}
Language
Click Try It! to start a request and see the response here!