Event: merchant.status.updated | Welcome to cash-app Documentation

When is this event triggered?

This event is created whenever a merchant’s status is changed. The status change can be due to do many different things:

An API client-initiated action to disable / enable the merchant
An asynchronous merchant registration process completing, moving the merchant from pending to active
A compliance ban on the merchant, moving them to disabled

**When is this event triggered?** This event is created whenever a merchant's status is changed. The status change can be due to do many different things: - An API client-initiated action to disable / enable the merchant - An asynchronous merchant registration process completing, moving the merchant from pending to active - A compliance ban on the merchant, moving them to disabled

Payload

The payload of this webhook request is an object.

typestringRequired

The type of event that occurred. merchant.status.updated for this event.

event_idstringRequired

A unique identifier provided by Cash App for the event.

created_atstringRequiredformat: "date-time"

When this event occured in RFC 3339 format (UTC).

The time that the event is delivered may be significantly later than this timestamp due to webhooks being retried for up to 72 hours.

dataobjectRequired

Data about the merchant that had a status change.

Response

200

any

Return a 200 status to indicate that the data was received successfully.

1	{
2	"type": "merchant.status.updated",
3	"event_id": "WE_78lusoltpu8r9shziq5hdnx96",
4	"created_at": "2022-12-07T20:21:46.282Z",
5	"data": {
6	"id": "MMI_4vxs5egfk7hmta3qx2h6rp91x",
7	"object": {
8	"merchant": {
9	"id": "MMI_4vxs5egfk7hmta3qx2h6rp91x",
10	"brand_id": "BRD_7n2hmta3qx2h6rp91x",
11	"name": "Sample Merchant",
12	"country": "US",
13	"currency": "USD",
14	"category": "5432",
15	"reference_id": "external-id",
16	"status": "ACTIVE",
17	"created_at": "2021-01-01T00:00:00Z",
18	"updated_at": "2022-12-07T20:21:46.282Z",
19	"address": {
20	"country": "US"
21	}
22	}
23	},
24	"type": "merchant"
25	}
26	}