Sellers

Subscribe to webhook events for Merchant of Record seller status changes during seller KYB screening.

The following webhook events are available when you manage Merchant of Record sellers with the Seller API. For how to create a subscription and verify signatures, see Listen for webhook events.

Event	Description
seller.in_review	The seller was created and is under review.
seller.active	The seller was approved and is usable.
seller.rejected	The seller was rejected. Reason codes may be included.
seller.pending_deactivation	A deactivation request was received and is under review.
seller.inactive	Deactivation completed.
seller.suspended	The seller was suspended, for example for risk reasons after an initial approval.

Payload examples

In each payload, the top-level id is the webhook event ID. The seller ID is data.seller_id, which matches the id returned by Create a sellerAPI and Retrieve a sellerAPI.

seller.in_review

JSON

1{
2  "id": "86b69f91-06f0-3fe8-8faf-4de58954ca8e",
3  "name": "seller.in_review",
4  "account_id": "acct_TOslkS7-MnyXlQuV8Lb4og",
5  "data": {
6    "seller_id": "2ec93632-07c6-4afc-8519-25da56f3931a",
7    "status": "IN_REVIEW",
8    "updated_at": "2025-10-24T06:15:09+0000",
9    "details": {
10      "reason_codes": []
11    }
12  },
13  "created_at": "2025-10-24T06:15:09+0000",
14  "version": "2024-09-27"
15}

data.seller_id is the seller ID. Retrieve full seller details with Retrieve a sellerAPI.

seller.active

JSON

1{
2  "id": "a1c2d3e4-5f60-7a8b-9c0d-1e2f3a4b5c6d",
3  "name": "seller.active",
4  "account_id": "acct_TOslkS7-MnyXlQuV8Lb4og",
5  "data": {
6    "seller_id": "2ec93632-07c6-4afc-8519-25da56f3931a",
7    "status": "ACTIVE",
8    "updated_at": "2025-10-24T06:45:12+0000",
9    "details": {
10      "reason_codes": []
11    }
12  },
13  "created_at": "2025-10-24T06:45:12+0000",
14  "version": "2024-09-27"
15}

seller.rejected

JSON

1{
2  "id": "b2d3e4f5-6071-8b9c-0d1e-2f3a4b5c6d7e",
3  "name": "seller.rejected",
4  "account_id": "acct_TOslkS7-MnyXlQuV8Lb4og",
5  "data": {
6    "seller_id": "2ec93632-07c6-4afc-8519-25da56f3931a",
7    "status": "REJECTED",
8    "updated_at": "2025-10-24T06:45:12+0000",
9    "details": {
10      "reason_codes": []
11    }
12  },
13  "created_at": "2025-10-24T06:45:12+0000",
14  "version": "2024-09-27"
15}

seller.pending_deactivation

JSON

1{
2  "id": "c3e4f5a6-7182-9c0d-1e2f-3a4b5c6d7e8f",
3  "name": "seller.pending_deactivation",
4  "account_id": "acct_TOslkS7-MnyXlQuV8Lb4og",
5  "data": {
6    "seller_id": "2ec93632-07c6-4afc-8519-25da56f3931a",
7    "status": "PENDING_DEACTIVATION",
8    "updated_at": "2025-10-24T06:45:12+0000",
9    "details": {
10      "reason_codes": []
11    }
12  },
13  "created_at": "2025-10-24T06:45:12+0000",
14  "version": "2024-09-27"
15}

seller.inactive

JSON

1{
2  "id": "d4f5a6b7-8293-0d1e-2f3a-4b5c6d7e8f90",
3  "name": "seller.inactive",
4  "account_id": "acct_TOslkS7-MnyXlQuV8Lb4og",
5  "data": {
6    "seller_id": "2ec93632-07c6-4afc-8519-25da56f3931a",
7    "status": "INACTIVE",
8    "updated_at": "2025-10-24T06:45:12+0000",
9    "details": {
10      "reason_codes": []
11    }
12  },
13  "created_at": "2025-10-24T06:45:12+0000",
14  "version": "2024-09-27"
15}

seller.suspended

JSON

1{
2  "id": "e5a6b7c8-93a4-1e2f-3a4b-5c6d7e8f9012",
3  "name": "seller.suspended",
4  "account_id": "acct_TOslkS7-MnyXlQuV8Lb4og",
5  "data": {
6    "seller_id": "2ec93632-07c6-4afc-8519-25da56f3931a",
7    "status": "SUSPENDED",
8    "updated_at": "2025-10-24T06:45:12+0000",
9    "details": {
10      "reason_codes": []
11    }
12  },
13  "created_at": "2025-10-24T06:45:12+0000",
14  "version": "2024-09-27"
15}

Was this page helpful?