Payload reference

Processor payloads

Processor events fire when a payment provider integration is connected to, removed from, or updated in your workspace. The entity that changed arrives under data.object as a ProcessorFatPayload, wrapped in the standard webhook envelope.

The underlying model is SystemIntegration - the record that represents a payment provider integration (Stripe, Whop, etc.). On the wire, data.object.object is payment_processor.

Base fields

Every payload arrives inside the standard webhook envelope.

Field	Type	Nullable	Notes
`event_id`	string	No	Stable event UUID, prefixed `evt_`.
`event_type`	string	No	e.g. `processor.added`.
`api_version`	string	No	`2026-06-01`.
`created_at`	datetime	No	ISO 8601 envelope timestamp.
`workspace_id`	string	No	Workspace UUID, prefixed `ws_`.
`livemode`	boolean	No	`true` in production, `false` otherwise.

Processor object fields

The processor object lives at data.object.

Field	Type	Nullable	Notes
`object`	string	No	Always `payment_processor`.
`id`	string	No	Integration UUID, prefixed `pp_`.
`name`	string	No	Display name of the integration.
`category`	string	No	Integration category, e.g. payment provider.
`provider`	string	Yes	The provider - `stripe`, `whop`, etc.
`account_id`	string	Yes	The connected account's ID in the provider's system.
`connection_state`	string	No	e.g. `connected` or `disconnected`.
`user`	object	Yes	Lean reference to the connecting user: `{ object: "user", id }`, `id` prefixed `usr_`.
`workspace`	object	Yes	Snapshot of the owning workspace (see below).
`owner`	object	Yes	Snapshot of the integration owner (see below).
`team_member`	object	Yes	Snapshot of the associated team member (see below).

Nested objects

workspace is { object: "workspace", id, name, country, currency, platform, created_at } - id prefixed wsp_, country is { name, code }.

owner is { object: "user", id, first_name, last_name, email, user_type } - id prefixed usr_.

team_member is { object: "team_member", id, first_name, last_name, email, roles, department, is_active } - id prefixed tm_, roles an array of strings. When only the team member id is known, a lean { object: "team_member", id } is sent instead.

processor.added

Fires when a new payment provider integration is connected to your workspace. connection_state is typically connected.

processor.added payload


Code
{
  "event_id": "evt_a71e4c33-8b50-4f72-ad13-3c7f1e2d9b40",
  "event_type": "processor.added",
  "api_version": "2026-06-01",
  "created_at": "2026-06-20T12:12:44.650821Z",
  "workspace_id": "ws_7c448c98-390c-4994-abe8-21d0f7b899a8",
  "livemode": false,
  "data": {
    "object": {
      "object": "payment_processor",
      "id": "pp_5b2d9a14-0000-0000-0000-000000000000",
      "name": "Stripe",
      "category": "payment_provider",
      "provider": "stripe",
      "account_id": "acct_1T1gOsHll432c94e",
      "connection_state": "connected",
      "user": {
        "object": "user",
        "id": "usr_0c9f8e21-0000-0000-0000-000000000000"
      },
      "workspace": {
        "object": "workspace",
        "id": "wsp_7c448c98-390c-4994-abe8-21d0f7b899a8",
        "name": "Acme Inc",
        "country": { "name": "United States", "code": "US" },
        "currency": "USD",
        "platform": "web",
        "created_at": "2026-05-01T08:00:00.000Z"
      },
      "owner": {
        "object": "user",
        "id": "usr_0c9f8e21-0000-0000-0000-000000000000",
        "first_name": "Nikhil",
        "last_name": "Gupta",
        "email": "owner@example.com",
        "user_type": "owner"
      },
      "team_member": {
        "object": "team_member",
        "id": "tm_b04d07fe-0000-0000-0000-000000000000",
        "first_name": "Nikhil",
        "last_name": "Gupta",
        "email": "owner@example.com",
        "roles": ["manager"],
        "department": "operations",
        "is_active": true
      }
    }
  }
}

processor.removed

Fires when an integration is disconnected or removed. connection_state is typically disconnected. The data.object carries the integration as it stood at removal.

processor.updated

Fires when an existing integration changes - for example a reconnection or a settings change. The data.object shape matches processor.added; reconcile on connection_state and the entity's own fields rather than arrival order.

Last modified on September 25, 2026

Refund Nested objects

Base fields

Every payload arrives inside the standard webhook envelope.

Field

Type

Nullable

Notes

event_id

string

Stable event UUID, prefixed evt_.

event_type

string

e.g. processor.added.

api_version

string

2026-06-01.

created_at

datetime

ISO 8601 envelope timestamp.

workspace_id

string

Workspace UUID, prefixed ws_.

livemode

boolean

true in production, false otherwise.

Processor object fields

The processor object lives at data.object.

Field

Type

Nullable

Notes

object

string

Always payment_processor.

id

string

Integration UUID, prefixed pp_.

name

string

Display name of the integration.

category

string

Integration category, e.g. payment provider.

provider

string

Yes

The provider - stripe, whop, etc.

account_id

string

Yes

The connected account's ID in the provider's system.

connection_state

string

e.g. connected or disconnected.

user

object

Yes

Lean reference to the connecting user: { object: "user", id }, id prefixed usr_.

workspace

object

Yes

Snapshot of the owning workspace (see below).

owner

object

Yes

Snapshot of the integration owner (see below).

team_member

object

Yes

Snapshot of the associated team member (see below).

Nested objects

workspace is { object: "workspace", id, name, country, currency, platform, created_at } - id prefixed wsp_, country is { name, code }.

owner is { object: "user", id, first_name, last_name, email, user_type } - id prefixed usr_.

processor.added

Fires when a new payment provider integration is connected to your workspace. connection_state is typically connected.

processor.added payload


Code
{
  "event_id": "evt_a71e4c33-8b50-4f72-ad13-3c7f1e2d9b40",
  "event_type": "processor.added",
  "api_version": "2026-06-01",
  "created_at": "2026-06-20T12:12:44.650821Z",
  "workspace_id": "ws_7c448c98-390c-4994-abe8-21d0f7b899a8",
  "livemode": false,
  "data": {
    "object": {
      "object": "payment_processor",
      "id": "pp_5b2d9a14-0000-0000-0000-000000000000",
      "name": "Stripe",
      "category": "payment_provider",
      "provider": "stripe",
      "account_id": "acct_1T1gOsHll432c94e",
      "connection_state": "connected",
      "user": {
        "object": "user",
        "id": "usr_0c9f8e21-0000-0000-0000-000000000000"
      },
      "workspace": {
        "object": "workspace",
        "id": "wsp_7c448c98-390c-4994-abe8-21d0f7b899a8",
        "name": "Acme Inc",
        "country": { "name": "United States", "code": "US" },
        "currency": "USD",
        "platform": "web",
        "created_at": "2026-05-01T08:00:00.000Z"
      },
      "owner": {
        "object": "user",
        "id": "usr_0c9f8e21-0000-0000-0000-000000000000",
        "first_name": "Nikhil",
        "last_name": "Gupta",
        "email": "owner@example.com",
        "user_type": "owner"
      },
      "team_member": {
        "object": "team_member",
        "id": "tm_b04d07fe-0000-0000-0000-000000000000",
        "first_name": "Nikhil",
        "last_name": "Gupta",
        "email": "owner@example.com",
        "roles": ["manager"],
        "department": "operations",
        "is_active": true
      }
    }
  }
}