> 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.

# card.terminated

POST 

Sent when a `card.terminated` event occurs.

Reference: https://docs.thepennyinc.com/api-reference/penny-banking/webhook-payloads/card/card-terminated-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` ("card.terminated", 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` (WebhooksCardTerminatedWebhookPayloadContentApplicationJsonSchemaData, required) — A notification about a domain object being created, updated, or deleted.

## Types

### WebhooksCardTerminatedWebhookPayloadContentApplicationJsonSchemaData

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` (VirtualCardWebhookPayload, optional) — A virtual card, as delivered in webhook event payloads.
- `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.

### VirtualCardWebhookPayload

A virtual card, as delivered in webhook event payloads.

- `card_id` (string, required) — Penny's unique identifier for this card.
- `version` (integer, required) — A number that increases each time this card's details change. Use it to confirm you are looking at the latest information.
- `version_time` (datetime, required) — The date and time this card's details were last changed.
- `issued_time` (datetime, required) — The date and time this card was issued.
- `expiration_date` (date, required) — The date this card expires and can no longer be used.
- `bin_id` (string, required) — The BIN this card was issued under.
- `bin_range_id` (string, required) — The BIN range this card was issued under.
- `card_product_id` (string, required) — The card product this card was issued under.
- `business_id` (string, required) — The business that owns this card.
- `business_entity_id` (string, required) — The business entity associated with this card.
- `program_id` (string, required) — The program this card was issued under.
- `capital_account_id` (string, required) — The account this card draws funds from.
- `cardholder_id` (string, required) — The cardholder this card is issued to.
- `status` (enum, required) — This card's current lifecycle status.
  - Allowed values: `pending`, `active`, `deactivated`, `suspended`, `terminated`
- `active` (boolean, required) — Whether this card is currently able to authorize transactions.
- `terminated` (boolean, required) — Whether this card has been permanently terminated.
- `currency` (enum, required) — The currency this card transacts in.
  - Allowed values: `USD`
- `country` (string, required) — The country this card was issued in, as an ISO 3166-1 alpha-2 code.
- `usage_type` (enum, required) — The usage type this card was issued for.
  - Allowed values: `single_use`, `single_reload`, `reloadable`
- `scheme_details` (CardSchemeResponse, required) — The card network scheme details for this card.
- `terminated_time` (datetime, optional, nullable) — The date and time this card was terminated, if it has been.
- `bin` (string, optional, nullable) — The first 6-8 digits of the card number, as displayed to end users.
- `last_four` (string, optional, nullable) — The last four digits of the card number, as displayed to end users.
- `control_account_id` (string, optional, nullable) — The control account controlling this card's spend, if one is delegated.
- `usage_limits` (CardUsageLimitsResponse, optional, nullable) — The limits enforcing `usage_type` and how much of them is used. Present on single_use and single_reload cards only.
- `alias` (string, optional, nullable) — A human-readable name for this card, if one has been set.
- `description` (string, optional, nullable) — A description of this card's purpose, if one has been set.
- `spend_control_id` (string, optional, nullable) — The spend control policy applied to this card, if one is set.
- `client_reference` (ClientReferenceResponse, optional, nullable) — An opaque reference the client attached to this card for their own tracking purposes.
- `form_factor` (enum, optional, default: virtual) — The form of this card.
  - Allowed values: `virtual`

### CardSchemeResponse

The card network scheme configuration for this card: the network brand, funding type, and product type used in authorization and clearing.

- `network` (enum, required) — The card network for this card, such as Visa or Mastercard.
  - Allowed values: `visa`, `mastercard`
- `funding_type` (enum, optional, nullable) — This card's funding type, if defined.
  - Allowed values: `debit`, `credit`, `prepaid`
- `product_type` (enum, optional, nullable) — This card's network product category, if defined.
  - Allowed values: `consumer`, `corporate`, `commercial`

### CardUsageLimitsResponse

The limits enforcing this card's usage type, and how much of them is used. Amounts are in the card's currency.

- `authorizations_maximum` (integer, optional, nullable) — How many authorizations the card permits. Set on single_use cards.
- `authorizations_used` (integer, optional, nullable) — How many authorizations are counted against `authorizations_maximum`. An authorization that expires or is cancelled before settling is no longer counted.
- `amount_limit` (string, optional, nullable) — The lifetime spend budget set by `load_amount` at issuance. Set on single_reload cards; it cannot be raised.
- `amount_remaining` (string, optional, nullable) — The budget still available. Pending authorizations and settled spend reduce it; authorizations that expire or are cancelled return it.

### ClientReferenceResponse

An opaque reference the client attached to this card for their own tracking purposes.

- `id` (string, optional, nullable) — The client's own identifier for this card in their system.
- `data` (map from string to string, optional, nullable) — Additional metadata the client attached to this card.