Rename card status PENDING_ISSUE → PROCESSING#587
Closed
ls-bolt[bot] wants to merge 1 commit into
Closed
Conversation
Rename the Grid API card lifecycle state PENDING_ISSUE to PROCESSING so that PENDING_* states consistently denote waiting on user/platform action while PROCESSING denotes Grid/the issuer doing work — matching the convention already used by the quotes and transactions resources. PENDING_KYC is unchanged (it waits on the cardholder). Updates the OpenAPI source under openapi/, the Mintlify card doc snippets, and the regenerated openapi.yaml / mintlify/openapi.yaml bundles.
|
The latest updates on your projects. Learn more about Vercel for GitHub. 1 Skipped Deployment
|
github-actions
Bot
added
the
breaking-change
Contributor
|
Contributor
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
AaryamanBhute
added a commit
that referenced
this pull request
Jun 16, 2026
## Summary Renames the Grid API card lifecycle state `PENDING_ISSUE` to `PROCESSING`. Per the [Slack thread](https://lightsparkgroup.slack.com/archives/C0B21R3219Q/p1781643588222029), the `PENDING_*` states should consistently mean *waiting on user/platform action*, while `PROCESSING` means *Grid (or the issuer) is doing work* — matching the convention already used by the **quotes** and **transactions** resources. `PENDING_ISSUE` (card being provisioned by the issuer) is Grid-side work, so it becomes `PROCESSING`. This also makes room for Dhruv's upcoming `PENDING_AUTH` (delegated-auth setup pending on user+platform). `PENDING_KYC` is intentionally unchanged — it waits on the cardholder. ## Changes OpenAPI source (`openapi/`): - `components/schemas/cards/CardState.yaml` — enum value + description table - `components/schemas/cards/CardStateReason.yaml` — `ISSUER_REJECTED` description reference - `paths/cards/cards.yaml` — `POST /cards` description - `webhooks/card-state-change.yaml` — webhook description + example summary Mintlify card doc snippets (`mintlify/snippets/cards/`): `intro`, `quickstart`, `issuing-cards` (incl. lifecycle diagram), `implementation-overview`, `webhooks`, `sandbox-testing`. Regenerated bundles via `make build`: `openapi.yaml`, `mintlify/openapi.yaml`. ## Note: breaking change & follow-ups This is a breaking change to the public `CardState` enum (affects `Card.state`, the `CARD.STATE_CHANGE` webhook, and the `GET /cards?state=` filter). It's safe to land as a clean rename rather than a dual-value migration because the API surface is early-stage and **no backend currently emits the `PENDING_ISSUE` string** — sparkcore's internal `CardStatus` enum is `ACTIVE/INACTIVE/SUSPENDED/CLOSED` and the public `CardState` values aren't produced yet. Follow-up (separate repo, not run here — needs the custom OpenAPI generator toolchain): regenerate the Python SDK in `webdev/grid-api` via `update_schema.sh` once this merges. ## Verification - `make build` — bundles regenerate cleanly; bundle diff is exactly the 6 rename occurrences, no reformatting. - `make lint` — **0 errors** (pre-existing warnings/infos on unrelated beneficiary schemas only). - `grep -rn PENDING_ISSUE` across the repo returns nothing. --- 🤖 [inverted-obsidian](https://zeus.dev.dev.sparkinfra.net/#/arc?id=inverted-obsidian)[(#1)](https://zeus.dev.dev.sparkinfra.net/#/instance?id=inverted-obsidian) | [Feedback](https://zeus.dev.dev.sparkinfra.net/feedback) Original PR: #587
AaryamanBhute
deleted the
06-16-rename-card-status-pending-issue-to-processing
branch
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Renames the Grid API card lifecycle state
PENDING_ISSUEtoPROCESSING.Per the Slack thread, the
PENDING_*states should consistently mean waiting on user/platform action, whilePROCESSINGmeans Grid (or the issuer) is doing work — matching the convention already used by the quotes and transactions resources.PENDING_ISSUE(card being provisioned by the issuer) is Grid-side work, so it becomesPROCESSING. This also makes room for Dhruv's upcomingPENDING_AUTH(delegated-auth setup pending on user+platform).PENDING_KYCis intentionally unchanged — it waits on the cardholder.Changes
OpenAPI source (
openapi/):components/schemas/cards/CardState.yaml— enum value + description tablecomponents/schemas/cards/CardStateReason.yaml—ISSUER_REJECTEDdescription referencepaths/cards/cards.yaml—POST /cardsdescriptionwebhooks/card-state-change.yaml— webhook description + example summaryMintlify card doc snippets (
mintlify/snippets/cards/):intro,quickstart,issuing-cards(incl. lifecycle diagram),implementation-overview,webhooks,sandbox-testing.Regenerated bundles via
make build:openapi.yaml,mintlify/openapi.yaml.Note: breaking change & follow-ups
This is a breaking change to the public
CardStateenum (affectsCard.state, theCARD.STATE_CHANGEwebhook, and theGET /cards?state=filter). It's safe to land as a clean rename rather than a dual-value migration because the API surface is early-stage and no backend currently emits thePENDING_ISSUEstring — sparkcore's internalCardStatusenum isACTIVE/INACTIVE/SUSPENDED/CLOSEDand the publicCardStatevalues aren't produced yet.Follow-up (separate repo, not run here — needs the custom OpenAPI generator toolchain): regenerate the Python SDK in
webdev/grid-apiviaupdate_schema.shonce this merges.Verification
make build— bundles regenerate cleanly; bundle diff is exactly the 6 rename occurrences, no reformatting.make lint— 0 errors (pre-existing warnings/infos on unrelated beneficiary schemas only).grep -rn PENDING_ISSUEacross the repo returns nothing.🤖 inverted-obsidian(#1) | Feedback