Adds support for limiting the number of allowed payments for Issuing cards
What’s new
Adds the ability to automatically cancel virtual Issuing cards after a certain number of payments by specifying lifecycle_controls.cancel_after.payment_count when creating a card.
A card is automatically cancelled when it makes the specified number of non-zero payment authorizations and transactions. The count includes penny authorizations, but doesn’t include non-payment actions, such as authorization advice.
Impact
You can now configure a virtual Issuing card to automatically be cancelled after making a specified number of payments. You no longer have to track usage and manually cancel virtual cards in order to limit their allowed number of payments.
Changes
| Parameter | Change | Resources or endpoints |
|---|---|---|
| lifecycle_controls | Added | Issuing. Card |
Upgrade
- View your current API version in Workbench.
- If you use an SDK, upgrade to the corresponding SDK version for this API version.
- If you don’t use an SDK, update your API requests to include Stripe-Version: 2026-03-25. dahlia
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
- In Workbench, perform the upgrade . You can roll back the version for 72 hours.
Learn more about Stripe API upgrades.