invoice updated

EVENT

invoice.updated

Published when an Invoice is updated.

Permissions:INVOICES_READ

Link to section

Event payload

Example code

Link to section

merchant_id

string

The ID of the target merchant associated with the event.

Link to section

type

string

The type of event this represents, "invoice.updated".

Link to section

event_id

string

A unique ID for the event.

Link to section

created_at

string

Read only Timestamp of when the event was created, in RFC 3339 format.

Examples for January 25th, 2020 6:25:34pm Pacific Standard Time:

UTC: 2020-01-26T02:25:34Z

Pacific Standard Time with UTC offset: 2020-01-25T18:25:34-08:00

Link to section

data

InvoiceUpdatedEventData

Data associated with the event.

Show attributes

Link to section

Examples

API version2026-08-19

All versions ->

Response JSON

{
  "merchant_id": "031FEV2Q6VMPK",
  "location_id": "ES0RJRZYEC39A",
  "type": "invoice.updated",
  "event_id": "0312a8c5-af0f-49f4-ba29-291ef08dcd7e",
  "created_at": "2020-06-18T18:23:11Z",
  "data": {
    "type": "invoice",
    "id": "inv:0-ChCHu2mZEabLeeHahQnXDjZQECY",
    "object": {
      "invoice": {
        "id": "inv:0-ChCHu2mZEabLeeHahQnXDjZQECY",
        "version": 2,
        "location_id": "ES0RJRZYEC39A",
        "order_id": "CAISENgvlJ6jLWAzERDzjyHVybY",
        "payment_requests": [
          {
            "uid": "2da7964f-f3d2-4f43-81e8-5aa220bf3355",
            "request_type": "BALANCE",
            "due_date": "2030-01-24",
            "tipping_enabled": false,
            "automatic_payment_source": "NONE",
            "reminders": [
              {
                "uid": "beebd363-e47f-4075-8785-c235aaa7df11",
                "relative_scheduled_days": -1,
                "message": "Your invoice is due tomorrow",
                "status": "PENDING"
              }
            ],
            "computed_amount_money": {
              "amount": 10000,
              "currency": "USD"
            },
            "total_completed_amount_money": {
              "amount": 0,
              "currency": "USD"
            }
          }
        ],
        "invoice_number": "inv-100",
        "title": "Event Planning Services",
        "description": "We appreciate your business!",
        "delivery_method": "EMAIL",
        "scheduled_at": "2030-01-13T10:00:00Z",
        "status": "UNPAID",
        "timezone": "America/Los_Angeles",
        "created_at": "2020-06-18T17:45:13Z",
        "updated_at": "2020-06-18T18:23:11Z",
        "primary_recipient": {
          "customer_id": "JDKYHBWT1D4F8MFH63DBMEN8Y4",
          "given_name": "Amelia",
          "family_name": "Earhart",
          "email_address": "[email protected]",
          "phone_number": "1-212-555-4240"
        },
        "accepted_payment_methods": {
          "card": true,
          "square_gift_card": false,
          "bank_account": false,
          "buy_now_pay_later": false,
          "cash_app_pay": false
        },
        "custom_fields": [
          {
            "label": "Event Reference Number",
            "value": "Ref. #1234",
            "placement": "ABOVE_LINE_ITEMS"
          },
          {
            "label": "Terms of Service",
            "value": "The terms of service are...",
            "placement": "BELOW_LINE_ITEMS"
          }
        ],
        "next_payment_amount_money": {
          "amount": 10000,
          "currency": "USD"
        },
        "sale_or_service_date": "2030-01-24",
        "store_payment_method_enabled": false,
        "attachments": [
          {
            "id": "inva:0-ChBIMZJ99MugJFCUBjUVfdwY",
            "filename": "terms_and_agreements.pdf",
            "description": "Service contract",
            "filesize": 81839,
            "hash": "273ee02cb6f5f8a3a8ca23604930dd53",
            "mime_type": "application/pdf",
            "uploaded_at": "2023-03-03T00:07:52Z"
          }
        ]
      }
    }
  }
}