diff --git a/mintlify/openapi.yaml b/mintlify/openapi.yaml
index 65956615..8b44eac2 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:
@@ -19345,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
@@ -19360,10 +19361,15 @@ 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 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 65956615..8b44eac2 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:
@@ -19345,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
@@ -19360,10 +19361,15 @@ 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 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 46f1c614..10ac4aca 100644
--- a/openapi/components/schemas/cards/Card.yaml
+++ b/openapi/components/schemas/cards/Card.yaml
@@ -54,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.
@@ -78,13 +78,21 @@ 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: >-
-      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
diff --git a/openapi/webhooks/card-state-change.yaml b/openapi/webhooks/card-state-change.yaml
index 454c238d..da96c3bb 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: