Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.loyaltylion.com/llms.txt

Use this file to discover all available pages before exploring further.

This webhook is triggered when a customer uploads a receipt that requires manual review before it can be approved or declined. To subscribe to this webhook, your access token needs to contain the read_customers scope.

​
Payload

​
customer
object
required
Customer object with the same shape as the Customers API response
​
receipt
object
required
​
rule
object
required

​
Example

Example
{
  "id": "bff1bddb-6cd8-4c2c-9619-18744657053c",
  "topic": "receipts/manual_approval_required",
  "created_at": "2025-03-15T10:30:00.000Z",
  "payload": {
    "customer": {
      "id": 6932,
      "merchant_id": "2134606599",
      "email": "jessica@example.com",
      "points_approved": 200,
      "points_pending": 0,
      "points_spent": 500,
      "rewards_claimed": 5,
      "rewards_used": 0,
      "properties": {
        "name": "Jessica White"
      },
      "metadata": {},
      "birthday": "1990-01-29",
      "blocked": false,
      "guest": false,
      "enrolled": true,
      "enrolled_at": "2015-12-10T03:00:00.000Z",
      "referral_id": null,
      "referred_by": null,
      "loyalty_tier_membership": null,
      "tier_eligibility": null,
      "insights_segment": "Loyal",
      "referral_url": null,
      "created_at": "2016-12-10T03:00:00.000Z",
      "updated_at": "2025-03-15T10:30:00.000Z"
    },
    "receipt": {
      "id": 42,
      "status": "awaiting_manual_review",
      "retailer_name": "Walmart",
      "total_paid": 85.5,
      "tax_paid": 7.5,
      "currency": "USD",
      "fraud_score": 55,
      "duplicate": false,
      "retailer_receipt_date": "2025-03-14T00:00:00.000Z",
      "created_at": "2025-03-14T18:22:00.000Z"
    },
    "rule": {
      "id": 1234,
      "name": "$retail_purchase"
    }
  }
}