Event Message

The table below describes the structure of the event.

Field	Description
`customer_id`	The customer identifier that this event relates to
`corrections`	Object containing all the transactions that have been completed as part of a single request
`transaction_id`	Id of the transaction that has been corrected
`attribute`	Will be listed as `Merchant`
`from`	Name of the merchant that the transaction has changed from
`to`	Name of the merchant that the transaction has changed to
`completed_at`	An RFC3339 timestamp of the generation time

Examples

{
  "customer_id": "db8345bd-a658-4e84-868f-9b4c22634f00",
  "corrections": [
    {
      "transaction_id": "d107794e-3b0b-47fc-9bd7-bf12d9700506",
      "attribute": "merchant",
      "from": "Amazon Prime",
      "to": "Amazon Fresh",
    },
    ...
  ],
  "completed_at": "2024-05-26T11:55:55Z"
}

{
  "customer_id": "db8345bd-a658-4e84-868f-9b4c22634f00",
  "corrections": [
    {
      "transaction_id": "d107794e-3b0b-47fc-9bd7-bf12d9700506",
      "attribute": "merchant",
      "from": "Amazon Prime",
      "to": "Amazon Fresh",
    },
    {
      "transaction_id": "03594bd8-25c3-4c9e-bdac-3dd95c2e59b0",
      "attribute": "merchant",
      "from": "Amazon Prime",
      "to": "Amazon Fresh",
    },
    {
      "transaction_id": "1f346d75-e3f9-486b-87de-e299dc8abfaa",
      "attribute": "merchant",
      "from": "Amazon Prime",
      "to": "Amazon Fresh",
    }
    ...
  ],
  "completed_at": "2024-05-26T11:55:55Z"
}

How And When Is This Event Triggered

This webhook triggers each time a transaction has had the merchant corrected, such as; when a transaction is corrected as part of a successful call to corrections/v2/merchants or when future transactions are ingested that are similar to existing transactions that have been corrected and when the include_similar flag has been set to true.

More information about category corrections can be found in this guide.

You can subscribe to this webhook within Bud's developer console.