docs(openapi): split Card processorRef (Lithic) from issuerRef (Lead)

[ls-bolt]

This PR has been claimed. The active PR is now #620.

Summary

Companion docs change to the card-id standardization (webdev#29318).

• Adds processorRef to the Card schema — the Lithic card token, parallel to CardTransaction.issuerTransactionToken. This is the field the implementation now returns alongside the Card:<uuid> id (the spec's id was already Card:<uuid>; the implementation was the side that diverged).
• Corrects issuerRef: its example was a Lithic token (lithic_card_...), but Lithic is the card processor — the issuer of record is Lead Bank. issuerRef now describes the Lead identifier; the Lithic ref lives in processorRef. This matches the data model (processor_ref = Lithic, issuer_ref = Lead).

Test plan

• make build (rebundles openapi.yaml + mintlify/openapi.yaml)
• make lint-openapi → exit 0 (no new findings on the Card schema)

Proof-of-concept companion to the implementation PR; leaving as a draft.

Slack thread: https://lightsparkgroup.slack.com/archives/D0AJJH3A4J1/p1782347206097239

---

🤖 sovereign-reactor-4(#4) | Feedback

[vercel]

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

2 Skipped Deployments

Project	Deployment	Actions	Updated (UTC)
grid-flow-builder	Ignored	Preview	Jun 25, 2026 8:57pm
grid-wallet-demo	Ignored	Preview	Jun 25, 2026 8:57pm

[akanter]

• docs(openapi): split Card processorRef (Lithic) from issuerRef (Lead) #619 👈 (View in Graphite)
• main

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

[github-actions]

✱ Stainless preview builds for grid

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

cli

chore(internal): regenerate SDK with no functional changes

csharp

feat(api): add ProcessorRef field to Card model

go

feat(api): add processor_ref field to card

kotlin

feat(api): add processorRef field and update issuerRef docs in Card

openapi

feat(api): add processorRef field to Card

php

feat(api): add processorRef field to Card model

python

feat(api): add processor_ref field to Card model

ruby

feat(api): add processor_ref field to Card model

typescript

feat(api): add processorRef field to Card response

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

✅ grid-cli studio · code · diff

Your SDK build had at least one "warning" diagnostic, but this did not represent a regression.
generate ⚠️ → build ❗ → lint ❗ → test ❗

✅ grid-openapi studio · code · diff

Your SDK build had at least one "note" diagnostic, but this did not represent a regression.
generate ✅

✅ grid-go studio · code · diff

Your SDK build had at least one "note" diagnostic, but this did not represent a regression.
generate ✅ → build ✅ → lint ❗ → test ❗

go get github.com/stainless-sdks/grid-go@cefc04705ad3c969252247e31eee68090eea26d0

✅ grid-kotlin studio · code · diff

Your SDK build had at least one "note" diagnostic, but this did not represent a regression.
generate ✅ → build ✅ → lint ✅ → test ✅

✅ grid-typescript studio · code · diff

Your SDK build had at least one "note" diagnostic, but this did not represent a regression.
generate ✅ → build ✅ → lint ✅ → test ✅

npm install https://pkg.stainless.com/s/grid-typescript/353fce43b527955ad520892031415c80ab49308d/dist.tar.gz

✅ grid-ruby studio · code · diff

Your SDK build had at least one "note" diagnostic, but this did not represent a regression.
generate ✅ → build ✅ → lint ✅ → test ✅

✅ grid-python studio · code · diff

Your SDK build had at least one "note" diagnostic, but this did not represent a regression.
generate ✅ → build ✅ → lint ❗ → test ❗

pip install https://pkg.stainless.com/s/grid-python/84a0919e05ce35a14ad119581a95c8eb45b33930/grid-0.0.1-py3-none-any.whl

✅ grid-csharp studio · code · diff

Your SDK build had at least one "warning" diagnostic, but this did not represent a regression.
generate ⚠️ → build ❗ → lint ✅ → test ❗

✅ grid-php studio · code · diff

Your SDK build had at least one "note" diagnostic, but this did not represent a regression.
generate ✅ → lint ✅ → test ✅

---

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-06-25 21:03:09 UTC