feat(cards): add UTC daily transaction count limit contract

[DhruvPareek]

Adds maxTransactionsPerDay to card create, card update, card responses, and platform cardConfigs, mirroring maxSpendPerDay: a card-specific and a platform-level cap on the number of transactions a card may authorize during one UTC calendar day. Grid enforces the lower of the two values without replacing either. On update, omitting the field leaves the card's cap unchanged, null clears it, and a positive int32 sets it.

Each approved authorization counts once for the UTC day it was authorized. Refunds, reversals, and authorization expiries do not restore capacity during the day.

Also updates the path descriptions, request and webhook examples, and the two mintlify card snippets.

Sparkcore persistence and enforcement follow in webdev.

🤖 Generated with Claude Code

https://claude.ai/code/session_01YUkUFAQ1ccTXALipsg5x23

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
Grid	🟢 Ready	View Preview	Sep 9, 2026, 3:12 AM

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

2 Skipped Deployments

Project	Deployment	Actions	Updated
grid-flow-builder	Ignored	Preview	Sep 9, 2026 3:10am UTC
grid-wallet-demo	Ignored	Preview	Sep 9, 2026 3:10am UTC

[DhruvPareek]

• feat(cards): add UTC daily transaction count limit contract #913 👈 (View in Graphite)
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[github-actions]

⚠️ Breaking OpenAPI changes detected

oasdiff reports 2 error / 0 warning changes to openapi.yaml.
This PR will need approval from an API reviewer before merge.

Errors (2)

• POST webhook:card-funding-source-change — added the new required request property allOf[subschema #2]/data/maxTransactionsPerDay [new-required-request-property].
• POST webhook:card-state-change — added the new required request property allOf[subschema #2]/data/maxTransactionsPerDay [new-required-request-property].

---

Detected by oasdiff. Full report: job summary or the oasdiff-report artifact.

[github-actions]

✱ Stainless preview builds for grid

This PR will update the grid SDKs with the following commit messages.

cli
⏳ (generating...)```
feat(cards): add UTC daily transaction count limit contract

**go**
⏳ (generating...)```
feat(cards): add UTC daily transaction count limit contract

kotlin
⏳ (generating...)```
feat(cards): add UTC daily transaction count limit contract

**openapi**
⏳ (generating...)```
feat(cards): add UTC daily transaction count limit contract

php
⏳ (generating...)```
feat(cards): add UTC daily transaction count limit contract

**python**
⏳ (generating...)```
feat(cards): add UTC daily transaction count limit contract

ruby
⏳ (generating...)```
feat(cards): add UTC daily transaction count limit contract

**typescript**
⏳ (generating...)```
feat(cards): add UTC daily transaction count limit contract

Edit this comment to update them. They will appear in their respective SDK's changelogs.

⏳ grid-typescript studio

⏳ grid-openapi studio

⏳ grid-ruby studio

⏳ grid-kotlin studio

⏳ grid-go studio

⏳ grid-python studio

⏳ grid-php studio

⏳ grid-cli studio

⏳ These are partial results; builds are still running.

---

This comment is auto-generated by GitHub Actions and is automatically kept up to date as you push.
If you push custom code to the preview branch, re-run this workflow to update the comment.
Last updated: 2026-09-09 03:21:36 UTC