order.credited

EVENTOrders

Fires when an order is accepted and its points are credited, after POST /v1/orders succeeds. Points are earned on the subtotal after discounts: here $12.50 minus the $3.50 pastry is $9.00, which earns 90 Beans at 10 per dollar, rounded down.

Points earned at the register also show up. In-store Square visits fire order.credited with "channel": "in_store", and their own points.changed, so you see every point change in one stream. You didn't create these orders, so they have no external_order_id from you.

data.object is the order, with the member's balance and tier right after it was credited.

Event JSON

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40{
  "id": "2d7e9b4c-6f1a-4c83-b5e2-9a0f3d8c7e14",
  "type": "order.credited",
  "created_at": "2026-11-05T14:08:52Z",
  "api_version": "v1",
  "livemode": true,
  "brand_id": "e5a1c7d9-2f4b-4c8e-a3d6-8b0f1e9c2a57",
  "data": {
    "object": {
      "id": "c9e5a3f1-7d2b-4e8c-a0f6-3b1d9e5c7a24",
      "external_order_id": "app-30417",
      "status": "credited",
      "member_id": "3f2b8c1e-6d0a-4e7b-9f3c-2a1d5e8b7c40",
      "location_id": "8d4e2a17-3b9c-4f5e-a6d1-7c0b9e2f4a53",
      "channel": "app",
      "fulfillment": "pickup",
      "placed_at": "2026-11-05T14:08:49Z",
      "currency": "USD",
      "subtotal_cents": 1250,
      "discount_cents": 350,
      "tax_cents": 74,
      "tip_cents": 150,
      "total_cents": 1124,
      "items": [
        { "line_id": "1", "pos_item_id": "HV4MZ2TQ7LW3KXRB5P8NJ6DC", "name": "Oat latte", "quantity": 1, "unit_price_cents": 575, "pos_category_ids": ["C4RZ8NQ2MXK7WTP3LHB6V5JD"], "modifiers": [] },
        { "line_id": "2", "pos_item_id": "3NZQ7XKJ2Y5PLVKCW6RQ4G2T", "name": "Drip coffee", "quantity": 1, "unit_price_cents": 325, "pos_category_ids": ["C4RZ8NQ2MXK7WTP3LHB6V5JD"], "modifiers": [] },
        { "line_id": "3", "pos_item_id": "7PKD3RXN2WQ6ZLHM4TB5JV8C", "name": "Butter croissant", "quantity": 1, "unit_price_cents": 350, "pos_category_ids": ["P9MT2XQ6KZR4WLN8HCB3J7VD"], "modifiers": [] }
      ],
      "points_earned": 90,
      "bonus_points": 0,
      "redemptions": [ { "id": "4b8d2f6a-9c1e-4a3d-b7f5-0e6c8a2d1b59", "status": "captured" } ],
      "member": {
        "points_balance": 510,
        "tier": { "id": "2b9e4f7a-1c3d-4e6b-8a5f-9d0c2e7b4a13", "name": "Green" }
      },
      "created_at": "2026-11-05T14:08:52Z"
    },
    "previous_attributes": {}
  }
}