Skip to main content
POST
/
EVENTS.VOUCHER.LOYALTY_CARD.PENDING_POINTS.ADDED
{
  "voucher": {
    "id": "v_hjQhSsitD6lAATASbRV1Ef7dUCjpy0iw",
    "code": "L0y4L",
    "loyalty_card": {
      "points": 2187,
      "balance": 7,
      "next_expiration_date": "2026-01-31",
      "next_expiration_points": 7,
      "pending_points": 1234
    },
    "type": "LOYALTY_CARD",
    "campaign": "Loyalty program",
    "campaign_id": "camp_AQZ1GLRlbGaC2dETd31VbJQ9",
    "is_referral_code": false,
    "holder_id": "cust_IdgAFZxYwwHctOk9pPuMu308",
    "category_id": "cat_0e156dab8f2e43873a",
    "active": true,
    "created_at": "2024-01-18T15:18:39.015Z",
    "updated_at": "2025-01-27T09:00:51.058Z",
    "redemption": {
      "quantity": null,
      "redeemed_quantity": 19,
      "redeemed_points": 2180
    },
    "start_date": null,
    "expiration_date": null,
    "metadata": {},
    "object": "voucher",
    "categories": [
      {
        "id": "cat_0e156dab8f2e43873a",
        "name": "Star Platinum",
        "hierarchy": 10,
        "created_at": "2024-01-03T10:03:24.092Z",
        "object": "category"
      }
    ],
    "category": "Star Platinum"
  },
  "voucher_pending_points_balance": {
    "points": 1,
    "total": 1234,
    "object": "balance",
    "related_object": {
      "type": "voucher",
      "id": "v_hjQhSsitD6lAATASbRV1Ef7dUCjpy0iw"
    },
    "operation_type": "AUTOMATIC"
  },
  "campaign": {
    "id": "camp_AQZ1GLRlbGaC2dETd31VbJQ9",
    "name": "Loyalty programme",
    "campaign_type": "LOYALTY_PROGRAM",
    "type": "AUTO_UPDATE",
    "is_referral_code": false,
    "voucher": {
      "type": "LOYALTY_CARD",
      "discount": null,
      "gift": null,
      "loyalty_card": {
        "points": 0,
        "expiration_rules": {
          "period_type": "MONTH",
          "period_value": 2,
          "rounding_type": "PARTICULAR_MONTH",
          "rounding_value": 1
        }
      },
      "redemption": {
        "quantity": null,
        "redeemed_quantity": 0
      },
      "code_config": {
        "pattern": "########",
        "length": 8,
        "charset": "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ",
        "prefix": "",
        "postfix": ""
      }
    },
    "auto_join": false,
    "join_once": true,
    "active": true,
    "category_id": null,
    "category": null,
    "metadata": {},
    "start_date": null,
    "expiration_date": null,
    "description": null,
    "created_at": "2024-01-18T15:18:38.577Z",
    "updated_at": "2024-08-12T19:37:49.750Z",
    "object": "campaign"
  },
  "customer": {
    "id": "cust_IdgAFZxYwwHctOk9pPuMu308",
    "name": "Jack Webhook",
    "email": null,
    "source_id": "jck-wbhk",
    "metadata": {
      "region": "EMEA",
      "sign-up": "true"
    },
    "object": "customer"
  },
  "order": {
    "id": "ord_100b7b63c54d4d6ec0",
    "source_id": "test_20250127-001",
    "status": "PAID",
    "customer_id": "cust_IdgAFZxYwwHctOk9pPuMu308",
    "referrer_id": null,
    "amount": 2499,
    "total_amount": 2499,
    "items": [
      {
        "id": "ordli_100b7b63c48d4d6ebd",
        "object": "order_item",
        "product_id": "prod_0f59fdfe17e465fa05",
        "quantity": 1,
        "amount": 500,
        "price": 500,
        "subtotal_amount": 500
      },
      {
        "id": "ordli_100b7b63c48d4d6ebe",
        "object": "order_item",
        "product_id": "prod_0f0a6020cf2c301fdd",
        "quantity": 1,
        "amount": 900,
        "price": 900,
        "subtotal_amount": 900
      },
      {
        "id": "ordli_100b7b63c48d4d6ebf",
        "object": "order_item",
        "product_id": "prod_0ef925321f691a234d",
        "sku_id": "sku_0ef9253223e91a2354",
        "quantity": 1,
        "amount": 1099,
        "price": 1099,
        "subtotal_amount": 1099
      }
    ],
    "created_at": "2025-01-27T09:00:50.320Z",
    "object": "order"
  },
  "pending_points": {
    "id": "lopp_100cc4fac41469454d",
    "voucher_id": "v_hjQhSsitD6lAATASbRV1Ef7dUCjpy0iw",
    "campaign_id": "camp_AQZ1GLRlbGaC2dETd31VbJQ9",
    "customer_id": "cust_IdgAFZxYwwHctOk9pPuMu308",
    "order_id": "ord_100b7b63c54d4d6ec0",
    "points": 1,
    "activates_at": "2025-01-28",
    "details": {
      "holder_loyalty_tier": {
        "id": "ltr_0e30613ad01f044517",
        "name": "Loyal Star Platinum"
      },
      "event": {
        "id": "evcus_100b7b63c78d4d6eca",
        "type": "customer.order.paid",
        "group_id": "v-100b7b63aedd691db6",
        "entity_id": "cust_IdgAFZxYwwHctOk9pPuMu308",
        "created_at": "2025-01-27T09:00:50.321Z",
        "category": "EFFECT",
        "event_source": {
          "channel": "API",
          "api_key": {
            "name": "Primary",
            "app_id": "12abc345-678d-901e-f234-gh5i6j7k8901"
          }
        }
      },
      "earning_rule": {
        "id": "ern_FQxftbKUq9E93k00Z3qkC0sX",
        "source": {
          "banner": "Order-paid"
        }
      },
      "order": {
        "id": "ord_100b7b63c54d4d6ec0",
        "source_id": "test_20250127-001"
      }
    },
    "created_at": "2025-01-27T09:00:51.058Z"
  }
}

Response

200 - application/json

Indicates that pending points were added to a loyalty card.

Event data object schema for voucher.loyalty_card.pending_points.added.

​
customer
object
required

Simplified customer data.

​
campaign
object
required

Simplified campaign data.

​
voucher
object
required

Simplified voucher data.

​
voucher_pending_points_balance
object
required

Contains information on how the balance was affected by the transaction.

​
order
object
required

Order information.

​
pending_points
object
required

Contains details about the pending point entry.

⌘I