From ed713f7a3dcab247633c365f653392809a901392 Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Wed, 2 Sep 2026 08:19:28 +0000 Subject: [PATCH] docs: document platform-level card spending cap Add documentation for the new `cardConfigs.maxSpendPerTransaction` field introduced in #865. This platform-level cap applies to all cards and Grid enforces the lower of the platform and card-specific values. Updates: - Card issuing docs: mention platform cap interaction - Card freeze/close docs: explain platform cap enforcement - Platform config snippets: add Card Configuration section Co-Authored-By: Claude Opus 4.5 --- .../snippets/cards/freezing-and-closing.mdx | 6 ++++-- mintlify/snippets/cards/issuing-cards.mdx | 2 +- .../snippets/platform-configuration-non-uma.mdx | 17 +++++++++++++++++ .../snippets/platform-configuration-uma.mdx | 17 +++++++++++++++++ 4 files changed, 39 insertions(+), 3 deletions(-) diff --git a/mintlify/snippets/cards/freezing-and-closing.mdx b/mintlify/snippets/cards/freezing-and-closing.mdx index 81a0a6bae..e0bcddb6f 100644 --- a/mintlify/snippets/cards/freezing-and-closing.mdx +++ b/mintlify/snippets/cards/freezing-and-closing.mdx @@ -142,8 +142,10 @@ curl -X PATCH "$GRID_BASE_URL/cards/Card:019542f5-b3e7-1d02-0000-000000000010" \ Supply a positive integer to set the limit (in the smallest unit of the card's currency) or `null` to clear it. Omitting the field leaves the -current limit unchanged. `maxSpendPerTransaction` cannot be supplied -alongside `state: CLOSED`. +current limit unchanged. If the platform config sets +`cardConfigs.maxSpendPerTransaction`, Grid enforces the lower of the card +and platform values without replacing the card-specific value. +`maxSpendPerTransaction` cannot be supplied alongside `state: CLOSED`. ## Sandbox behavior diff --git a/mintlify/snippets/cards/issuing-cards.mdx b/mintlify/snippets/cards/issuing-cards.mdx index 9e157d3f0..079571085 100644 --- a/mintlify/snippets/cards/issuing-cards.mdx +++ b/mintlify/snippets/cards/issuing-cards.mdx @@ -25,7 +25,7 @@ curl -X POST "$GRID_BASE_URL/cards" \ | `platformCardId` | No | Your own identifier. System-generated when omitted, mirroring `platformCustomerId`. | | `form` | Yes | `VIRTUAL` in v1. `PHYSICAL` will be added later. | | `fundingSources` | Yes | Ordered array of `InternalAccount` ids. Each must belong to the cardholder and share one card-eligible currency. The first entry is tried first by Authorization Decisioning. | -| `maxSpendPerTransaction` | No | Largest amount a single card transaction may authorize, in the smallest unit of the card's currency. Omit for no limit. Supported only for card programs where Grid makes the authorization decision. | +| `maxSpendPerTransaction` | No | Largest amount a single card transaction may authorize, in the smallest unit of the card's currency. Omit for no card-specific cap. If the platform config sets `cardConfigs.maxSpendPerTransaction`, Grid enforces the lower of the card and platform values. Supported only for card programs where Grid makes the authorization decision. | The card's `currency` is derived from the funding sources at issue time and surfaces on the returned `Card` resource — all bound sources share diff --git a/mintlify/snippets/platform-configuration-non-uma.mdx b/mintlify/snippets/platform-configuration-non-uma.mdx index 29cb58049..c282c1a13 100644 --- a/mintlify/snippets/platform-configuration-non-uma.mdx +++ b/mintlify/snippets/platform-configuration-non-uma.mdx @@ -91,6 +91,23 @@ The `webhookEndpoint` parameter specifies the URL where Grid will send webhook n - Handle webhook verification (see Webhook Verification Guide) - Process webhook payloads within a reasonable time (recommended: under 5 seconds) +### Card Configuration + +The `cardConfigs` object contains platform-level settings for cards issued by your platform. To set a platform-wide per-transaction spending cap: + +```bash cURL +curl -X PATCH 'https://api.lightspark.com/grid/2025-10-13/config' \ + -u "$GRID_CLIENT_ID:$GRID_CLIENT_SECRET" \ + -H 'Content-Type: application/json' \ + -d '{ + "cardConfigs": { + "maxSpendPerTransaction": 10000 + } + }' +``` + +- `maxSpendPerTransaction`: (Integer or null) Platform-level cap on a single transaction for every card whose authorization decisions are made by Grid. The value is in the smallest unit of each card's currency (for example, cents for USD). Grid enforces the lower of this cap and each card's configured `maxSpendPerTransaction`. Set to `null` to remove the platform cap. + ### Supported Currencies The `supportedCurrencies` array allows you to define settings for each currency your platform will support for payouts payments. Each object in this array can contain: diff --git a/mintlify/snippets/platform-configuration-uma.mdx b/mintlify/snippets/platform-configuration-uma.mdx index 190762869..6b358f5de 100644 --- a/mintlify/snippets/platform-configuration-uma.mdx +++ b/mintlify/snippets/platform-configuration-uma.mdx @@ -134,6 +134,23 @@ The `webhookEndpoint` parameter specifies the URL where Grid will send webhook n - Handle webhook verification (see Webhook Verification Guide) - Process webhook payloads within a reasonable time (recommended: under 5 seconds) +### Card Configuration + +The `cardConfigs` object contains platform-level settings for cards issued by your platform. To set a platform-wide per-transaction spending cap: + +```bash cURL +curl -X PATCH 'https://api.lightspark.com/grid/2025-10-13/config' \ + -u "$GRID_CLIENT_ID:$GRID_CLIENT_SECRET" \ + -H 'Content-Type: application/json' \ + -d '{ + "cardConfigs": { + "maxSpendPerTransaction": 10000 + } + }' +``` + +- `maxSpendPerTransaction`: (Integer or null) Platform-level cap on a single transaction for every card whose authorization decisions are made by Grid. The value is in the smallest unit of each card's currency (for example, cents for USD). Grid enforces the lower of this cap and each card's configured `maxSpendPerTransaction`. Set to `null` to remove the platform cap. + ### Supported Currencies for UMA The `supportedCurrencies` array allows you to define settings for each currency your platform will support for UMA payments. Each object in this array can contain: