From 340469a1cac0912de580848b9f09e40d0726442d Mon Sep 17 00:00:00 2001 From: Bolt Agent Date: Thu, 25 Jun 2026 20:56:42 +0000 Subject: [PATCH 1/2] docs(openapi): add processorRef to Card; correct issuerRef to issuer-of-record MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The Card schema exposed only issuerRef, with a Lithic example — but Lithic is the card *processor*; the issuer of record is Lead Bank. Split them to match the data model (and the Card response): processorRef carries the Lithic card token (parallel to CardTransaction.issuerTransactionToken), issuerRef carries the Lead identifier. --- mintlify/openapi.yaml | 9 +++++++-- openapi.yaml | 9 +++++++-- openapi/components/schemas/cards/Card.yaml | 16 ++++++++++++---- 3 files changed, 26 insertions(+), 8 deletions(-) diff --git a/mintlify/openapi.yaml b/mintlify/openapi.yaml index 65956615a..550d97a28 100644 --- a/mintlify/openapi.yaml +++ b/mintlify/openapi.yaml @@ -19317,6 +19317,11 @@ components: type: string description: Platform-specific card identifier. Optional on create — system-generated if omitted, mirroring `platformCustomerId` semantics. example: card-emp-aary-001 + processorRef: + type: string + description: Opaque processor-side reference for the card (e.g. the Lithic card token). Useful for cross-referencing in the processor's dashboards; not used for any Grid request routing. + example: card_b81c2a4f + readOnly: true state: $ref: '#/components/schemas/CardState' stateReason: @@ -19362,8 +19367,8 @@ components: readOnly: true issuerRef: type: string - description: Opaque identifier for the card on the underlying issuer. Useful for cross-referencing in issuer dashboards; not used for any Grid request routing. - example: lithic_card_4f8d3a2b1c + description: Opaque identifier for the card on the issuer of record (e.g. the Lead Bank account/card identifier). Useful for cross-referencing in issuer dashboards; not used for any Grid request routing. + example: lead_card_7a1b9c3d readOnly: true createdAt: type: string diff --git a/openapi.yaml b/openapi.yaml index 65956615a..550d97a28 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -19317,6 +19317,11 @@ components: type: string description: Platform-specific card identifier. Optional on create — system-generated if omitted, mirroring `platformCustomerId` semantics. example: card-emp-aary-001 + processorRef: + type: string + description: Opaque processor-side reference for the card (e.g. the Lithic card token). Useful for cross-referencing in the processor's dashboards; not used for any Grid request routing. + example: card_b81c2a4f + readOnly: true state: $ref: '#/components/schemas/CardState' stateReason: @@ -19362,8 +19367,8 @@ components: readOnly: true issuerRef: type: string - description: Opaque identifier for the card on the underlying issuer. Useful for cross-referencing in issuer dashboards; not used for any Grid request routing. - example: lithic_card_4f8d3a2b1c + description: Opaque identifier for the card on the issuer of record (e.g. the Lead Bank account/card identifier). Useful for cross-referencing in issuer dashboards; not used for any Grid request routing. + example: lead_card_7a1b9c3d readOnly: true createdAt: type: string diff --git a/openapi/components/schemas/cards/Card.yaml b/openapi/components/schemas/cards/Card.yaml index 46f1c6145..b9d0bb817 100644 --- a/openapi/components/schemas/cards/Card.yaml +++ b/openapi/components/schemas/cards/Card.yaml @@ -23,6 +23,14 @@ properties: Platform-specific card identifier. Optional on create — system-generated if omitted, mirroring `platformCustomerId` semantics. example: card-emp-aary-001 + processorRef: + type: string + description: >- + Opaque processor-side reference for the card (e.g. the Lithic card token). + Useful for cross-referencing in the processor's dashboards; not used for + any Grid request routing. + example: card_b81c2a4f + readOnly: true state: $ref: ./CardState.yaml stateReason: @@ -81,10 +89,10 @@ properties: issuerRef: type: string description: >- - Opaque identifier for the card on the underlying issuer. Useful for - cross-referencing in issuer dashboards; not used for any Grid request - routing. - example: lithic_card_4f8d3a2b1c + Opaque identifier for the card on the issuer of record (e.g. the Lead Bank + account/card identifier). Useful for cross-referencing in issuer + dashboards; not used for any Grid request routing. + example: lead_card_7a1b9c3d readOnly: true createdAt: type: string From ec8f2c383403a717c337c5447cd0dd0a239ab34e Mon Sep 17 00:00:00 2001 From: Bolt Agent Date: Thu, 25 Jun 2026 21:31:52 +0000 Subject: [PATCH 2/2] =?UTF-8?q?docs(openapi):=20address=20Greptile=20?= =?UTF-8?q?=E2=80=94=20group=20processorRef=20with=20issuerRef,=20fix=20pr?= =?UTF-8?q?ocessor=20wording?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - place processorRef adjacent to issuerRef so the processor-vs-issuer pair reads together - panEmbedUrl: 'card issuer's iframe' -> 'card processor's iframe' (it's a Lithic/embed.lithic.com endpoint) - card-state-change webhook example: drop stale issuerRef: lithic_..., show processorRef (Lithic) + issuerRef (Lead) --- mintlify/openapi.yaml | 15 ++++++++------- openapi.yaml | 15 ++++++++------- openapi/components/schemas/cards/Card.yaml | 18 +++++++++--------- openapi/webhooks/card-state-change.yaml | 3 ++- 4 files changed, 27 insertions(+), 24 deletions(-) diff --git a/mintlify/openapi.yaml b/mintlify/openapi.yaml index 550d97a28..8b44eac25 100644 --- a/mintlify/openapi.yaml +++ b/mintlify/openapi.yaml @@ -8511,7 +8511,8 @@ webhooks: fundingSources: - InternalAccount:019542f5-b3e7-1d02-0000-000000000002 currency: USD - issuerRef: lithic_card_4f8d3a2b1c + processorRef: card_b81c2a4f + issuerRef: lead_card_7a1b9c3d createdAt: '2026-05-08T14:10:00Z' updatedAt: '2026-05-08T14:11:00Z' issuerRejected: @@ -19317,11 +19318,6 @@ components: type: string description: Platform-specific card identifier. Optional on create — system-generated if omitted, mirroring `platformCustomerId` semantics. example: card-emp-aary-001 - processorRef: - type: string - description: Opaque processor-side reference for the card (e.g. the Lithic card token). Useful for cross-referencing in the processor's dashboards; not used for any Grid request routing. - example: card_b81c2a4f - readOnly: true state: $ref: '#/components/schemas/CardState' stateReason: @@ -19350,7 +19346,7 @@ components: panEmbedUrl: type: string format: uri - description: URL of the card issuer's iframe that securely displays the PAN, CVV, and expiry to the cardholder. The full PAN and CVV never cross Grid's servers — render this URL in an iframe in your client to reveal card details. + description: URL of the card processor's iframe that securely displays the PAN, CVV, and expiry to the cardholder. The full PAN and CVV never cross Grid's servers — render this URL in an iframe in your client to reveal card details. example: https://embed.lithic.com/iframe/...?t=... fundingSources: type: array @@ -19365,6 +19361,11 @@ components: description: Currency the card transacts in (ISO 4217 for fiat, tickers for crypto). Derived from the funding sources at issue time — all funding sources bound to a card must be denominated in the same card-eligible currency. example: USD readOnly: true + processorRef: + type: string + description: Opaque processor-side reference for the card (e.g. the Lithic card token). Useful for cross-referencing in the processor's dashboards; not used for any Grid request routing. + example: card_b81c2a4f + readOnly: true issuerRef: type: string description: Opaque identifier for the card on the issuer of record (e.g. the Lead Bank account/card identifier). Useful for cross-referencing in issuer dashboards; not used for any Grid request routing. diff --git a/openapi.yaml b/openapi.yaml index 550d97a28..8b44eac25 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -8511,7 +8511,8 @@ webhooks: fundingSources: - InternalAccount:019542f5-b3e7-1d02-0000-000000000002 currency: USD - issuerRef: lithic_card_4f8d3a2b1c + processorRef: card_b81c2a4f + issuerRef: lead_card_7a1b9c3d createdAt: '2026-05-08T14:10:00Z' updatedAt: '2026-05-08T14:11:00Z' issuerRejected: @@ -19317,11 +19318,6 @@ components: type: string description: Platform-specific card identifier. Optional on create — system-generated if omitted, mirroring `platformCustomerId` semantics. example: card-emp-aary-001 - processorRef: - type: string - description: Opaque processor-side reference for the card (e.g. the Lithic card token). Useful for cross-referencing in the processor's dashboards; not used for any Grid request routing. - example: card_b81c2a4f - readOnly: true state: $ref: '#/components/schemas/CardState' stateReason: @@ -19350,7 +19346,7 @@ components: panEmbedUrl: type: string format: uri - description: URL of the card issuer's iframe that securely displays the PAN, CVV, and expiry to the cardholder. The full PAN and CVV never cross Grid's servers — render this URL in an iframe in your client to reveal card details. + description: URL of the card processor's iframe that securely displays the PAN, CVV, and expiry to the cardholder. The full PAN and CVV never cross Grid's servers — render this URL in an iframe in your client to reveal card details. example: https://embed.lithic.com/iframe/...?t=... fundingSources: type: array @@ -19365,6 +19361,11 @@ components: description: Currency the card transacts in (ISO 4217 for fiat, tickers for crypto). Derived from the funding sources at issue time — all funding sources bound to a card must be denominated in the same card-eligible currency. example: USD readOnly: true + processorRef: + type: string + description: Opaque processor-side reference for the card (e.g. the Lithic card token). Useful for cross-referencing in the processor's dashboards; not used for any Grid request routing. + example: card_b81c2a4f + readOnly: true issuerRef: type: string description: Opaque identifier for the card on the issuer of record (e.g. the Lead Bank account/card identifier). Useful for cross-referencing in issuer dashboards; not used for any Grid request routing. diff --git a/openapi/components/schemas/cards/Card.yaml b/openapi/components/schemas/cards/Card.yaml index b9d0bb817..10ac4acad 100644 --- a/openapi/components/schemas/cards/Card.yaml +++ b/openapi/components/schemas/cards/Card.yaml @@ -23,14 +23,6 @@ properties: Platform-specific card identifier. Optional on create — system-generated if omitted, mirroring `platformCustomerId` semantics. example: card-emp-aary-001 - processorRef: - type: string - description: >- - Opaque processor-side reference for the card (e.g. the Lithic card token). - Useful for cross-referencing in the processor's dashboards; not used for - any Grid request routing. - example: card_b81c2a4f - readOnly: true state: $ref: ./CardState.yaml stateReason: @@ -62,7 +54,7 @@ properties: type: string format: uri description: >- - URL of the card issuer's iframe that securely displays the PAN, CVV, + URL of the card processor's iframe that securely displays the PAN, CVV, and expiry to the cardholder. The full PAN and CVV never cross Grid's servers — render this URL in an iframe in your client to reveal card details. @@ -86,6 +78,14 @@ properties: bound to a card must be denominated in the same card-eligible currency. example: USD readOnly: true + processorRef: + type: string + description: >- + Opaque processor-side reference for the card (e.g. the Lithic card token). + Useful for cross-referencing in the processor's dashboards; not used for + any Grid request routing. + example: card_b81c2a4f + readOnly: true issuerRef: type: string description: >- diff --git a/openapi/webhooks/card-state-change.yaml b/openapi/webhooks/card-state-change.yaml index 454c238da..da96c3bb1 100644 --- a/openapi/webhooks/card-state-change.yaml +++ b/openapi/webhooks/card-state-change.yaml @@ -62,7 +62,8 @@ post: fundingSources: - InternalAccount:019542f5-b3e7-1d02-0000-000000000002 currency: USD - issuerRef: lithic_card_4f8d3a2b1c + processorRef: card_b81c2a4f + issuerRef: lead_card_7a1b9c3d createdAt: '2026-05-08T14:10:00Z' updatedAt: '2026-05-08T14:11:00Z' issuerRejected: