> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.thepennyinc.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.thepennyinc.com/_mcp/server. # cardholder.deletion.completed POST Sent when a `cardholder.deletion.completed` event occurs. Reference: https://docs.thepennyinc.com/banking/api-reference/webhook-payloads/cardholder/cardholder-deletion-completed-webhook ## Request ### Payload - `event_id` (string, required) — Penny's unique identifier for this notification event. - `business_id` (string, required) — The business the event belongs to. When the event originated from a different business, this contains the originating business. - `type` ("cardholder.deletion.completed", required) — The notification event type. This identifies the specific occurrence represented by the event and determines how its data should be interpreted. - `category` ("object", required) — The category of the event payload. This groups related notification event types and describes the general kind of data contained in ``data``. - `schema_version` ("1.0", required) — The version of the JSON notification event schema used to encode this webhook payload. - `event_time` (datetime, required) — The date and time Penny generated the notification event. - `occurrence_time` (datetime, required) — The date and time the underlying occurrence represented by this notification event took place. - `data` (WebhooksCardholderDeletionCompletedWebhookPayloadContentApplicationJsonSchemaData, required) — A notification about a domain object being created, updated, or deleted. ## Types ### WebhooksCardholderDeletionCompletedWebhookPayloadContentApplicationJsonSchemaData A notification about a domain object being created, updated, or deleted. - `operation` (enum, required) — The change that produced this event: 'created', 'updated', or 'deleted'. - Allowed values: `created`, `updated`, `deleted` - `subject` (ObjectReferenceResponse, required) — The object this event concerns. - `category` ("object", optional, default: object) — Identifies this payload as an object change. - `object` (WebhooksCardholderDeletionCompletedWebhookPayloadContentApplicationJsonSchemaDataObject, optional) - `previous_attributes` (map from string to any, optional, nullable) — The object's attributes before this change, if included. ### ObjectReferenceResponse A pointer to the object this event concerns. - `object_type` (string, required) — The kind of object this event concerns. - `object_id` (string, required) — The unique identifier of the object this event concerns. - `version` (integer, optional, nullable) — The object's version at the time of this event, if known. - `stage` (integer, optional, nullable) — The object's lifecycle stage at the time of this event, if applicable. ### WebhooksCardholderDeletionCompletedWebhookPayloadContentApplicationJsonSchemaDataObject - IndividualCardholderWebhookPayload: IndividualCardholderWebhookPayload - CorporateCardholderWebhookPayload: CorporateCardholderWebhookPayload ### IndividualCardholderWebhookPayload An individual cardholder, as delivered in webhook event payloads. - `cardholder_id` (string, required) — Penny's unique identifier for this cardholder. - `version` (integer, required) — A number that increases each time this cardholder's details change. Use it to confirm you are looking at the latest information. - `version_time` (datetime, required) — The date and time this cardholder's details were last changed. - `business_id` (string, required) — The business this cardholder belongs to. - `business_entity_id` (string, required) — The business entity this cardholder belongs to. - `program_id` (string, required) — The program this cardholder is issued under. - `status` (enum, required) — This cardholder's current lifecycle status: 'active', 'deactivated' (cannot be issued new cards), 'suspended' (restricted, typically pending review), 'deleting' (removal has been requested and is in progress), or 'deleted'. - Allowed values: `active`, `deactivated`, `suspended`, `deleting`, `deleted` - `active` (boolean, required) — Whether this cardholder is currently active. - `given_name` (string, required) — The cardholder's given (first) name. Shown as a masked placeholder unless the request explicitly asks to reveal personal information. - `family_name` (string, required) — The cardholder's family (last) name. Shown as a masked placeholder unless the request explicitly asks to reveal personal information. - `user_id` (string, optional, nullable) — The Penny user linked to this cardholder, if one is linked. - `address` (AddressResponse, optional, nullable) — The cardholder's registered physical address, if on file. - `email` (string, optional, nullable) — The cardholder's contact email address, if on file. Shown as a masked placeholder unless the request explicitly asks to reveal personal information. - `phone` (string, optional, nullable) — The cardholder's contact phone number, if one is on file. Shown as a masked placeholder unless the request explicitly asks to reveal personal information. - `spend_control_id` (string, optional, nullable) — The spend control policy applied to this cardholder's cards, if one is set. - `type` (enum, optional, default: individual) — Distinguishes between natural-person and business cardholders. - Allowed values: `individual`, `corporate` ### CorporateCardholderWebhookPayload A corporate cardholder, as delivered in webhook event payloads. - `cardholder_id` (string, required) — Penny's unique identifier for this cardholder. - `version` (integer, required) — A number that increases each time this cardholder's details change. Use it to confirm you are looking at the latest information. - `version_time` (datetime, required) — The date and time this cardholder's details were last changed. - `business_id` (string, required) — The business this cardholder belongs to. - `business_entity_id` (string, required) — The business entity this cardholder belongs to. - `program_id` (string, required) — The program this cardholder is issued under. - `status` (enum, required) — This cardholder's current lifecycle status: 'active', 'deactivated' (cannot be issued new cards), 'suspended' (restricted, typically pending review), 'deleting' (removal has been requested and is in progress), or 'deleted'. - Allowed values: `active`, `deactivated`, `suspended`, `deleting`, `deleted` - `active` (boolean, required) — Whether this cardholder is currently active. - `business_name` (string, required) — The legal name of the business this cardholder represents. - `user_id` (string, optional, nullable) — The Penny user linked to this cardholder, if one is linked. - `address` (AddressResponse, optional, nullable) — The cardholder's registered physical address, if on file. - `email` (string, optional, nullable) — The cardholder's contact email address, if on file. Shown as a masked placeholder unless the request explicitly asks to reveal personal information. - `phone` (string, optional, nullable) — The cardholder's contact phone number, if one is on file. Shown as a masked placeholder unless the request explicitly asks to reveal personal information. - `spend_control_id` (string, optional, nullable) — The spend control policy applied to this cardholder's cards, if one is set. - `type` (enum, optional, default: corporate) — Distinguishes between natural-person and business cardholders. - Allowed values: `individual`, `corporate` ### AddressResponse External API representation of a physical address. Country is normalized to ISO 3166-1 alpha-2. State/province is normalized to its subdivision code where applicable. - `line_1` (string, required) — Primary address line. - `city` (string, required) — City or locality. - `zip_code` (string, required) — Postal or ZIP code. - `country` (string, required) — Country in ISO 3166-1 alpha-2 format. - `line_2` (string, optional, nullable) — Secondary address line. - `state_or_province` (string, optional, nullable) — State or province code (if applicable).