From 1612327f4016a28e793c99c3fe625f353017b1fa Mon Sep 17 00:00:00 2001
From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com>
Date: Thu, 4 Jun 2026 09:26:38 +0000
Subject: [PATCH] docs: sync account type fields with OpenAPI schemas

Update documentation and Grid Visualizer to match recent schema changes:

- Add missing bankName field to COP mobile money example in docs
- Update Grid Visualizer account-types.ts:
  - BDT_ACCOUNT: add required bankName field
  - COP_ACCOUNT: add required bankName and bankAccountType fields
  - EGP_ACCOUNT: fix fields to match schema (iban for bank transfer, not accountNumber)
  - GHS_ACCOUNT: add required bankName field
  - PKR_ACCOUNT: reorder fields with bankName first (required for all rails)

Syncs with:
- bfdf3e7 chore: Sync account schemas (#546)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 .../grid-visualizer/src/data/account-types.ts | 28 +++++++++++--------
 mintlify/snippets/external-accounts.mdx       |  1 +
 2 files changed, 17 insertions(+), 12 deletions(-)

diff --git a/components/grid-visualizer/src/data/account-types.ts b/components/grid-visualizer/src/data/account-types.ts
index 6c8e1dfa..d0860fc8 100644
--- a/components/grid-visualizer/src/data/account-types.ts
+++ b/components/grid-visualizer/src/data/account-types.ts
@@ -288,9 +288,10 @@ export const accountTypeSpecs: Record<string, AccountTypeSpec> = {
   BDT_ACCOUNT: {
     accountType: 'BDT_ACCOUNT',
     fields: [
-      { name: 'accountNumber', example: '1234567890123' },
-      { name: 'branchCode', example: '12345', description: '5-digit branch code' },
-      { name: 'phoneNumber', example: '+8801712345678' },
+      { name: 'bankName', example: 'BRAC Bank' },
+      { name: 'accountNumber', example: '1234567890123', description: 'For bank transfer' },
+      { name: 'branchCode', example: '12345', description: '5-digit branch code (optional)' },
+      { name: 'phoneNumber', example: '+8801712345678', description: 'For mobile money' },
       { name: 'swiftCode', example: 'BABORUMMYYY', description: 'Optional' },
     ],
     beneficiaryRequired: true,
@@ -298,7 +299,9 @@ export const accountTypeSpecs: Record<string, AccountTypeSpec> = {
   COP_ACCOUNT: {
     accountType: 'COP_ACCOUNT',
     fields: [
+      { name: 'bankName', example: 'Bancolombia' },
       { name: 'accountNumber', example: '1234567890', description: 'For bank transfer' },
+      { name: 'bankAccountType', example: 'CHECKING', description: 'CHECKING or SAVINGS (for bank transfer)' },
       { name: 'phoneNumber', example: '+573001234567', description: 'For mobile money' },
     ],
     beneficiaryRequired: true,
@@ -306,17 +309,18 @@ export const accountTypeSpecs: Record<string, AccountTypeSpec> = {
   EGP_ACCOUNT: {
     accountType: 'EGP_ACCOUNT',
     fields: [
-      { name: 'accountNumber', example: '1234567890123456' },
-      { name: 'iban', example: 'EG380019000500000000263180002', description: 'Optional' },
-      { name: 'swiftCode', example: 'NBEGEGCX', description: 'Optional' },
+      { name: 'bankName', example: 'National Bank of Egypt' },
+      { name: 'iban', example: 'EG380019000500000000263180002', description: 'For bank transfer (29 chars, starts with EG)' },
+      { name: 'phoneNumber', example: '+201012345678', description: 'For mobile money' },
     ],
     beneficiaryRequired: true,
   },
   GHS_ACCOUNT: {
     accountType: 'GHS_ACCOUNT',
     fields: [
-      { name: 'accountNumber', example: '1234567890' },
-      { name: 'phoneNumber', example: '+233241234567' },
+      { name: 'bankName', example: 'GCB Bank' },
+      { name: 'accountNumber', example: '1234567890', description: 'For bank transfer' },
+      { name: 'phoneNumber', example: '+233241234567', description: 'For mobile money' },
     ],
     beneficiaryRequired: true,
   },
@@ -347,10 +351,10 @@ export const accountTypeSpecs: Record<string, AccountTypeSpec> = {
   PKR_ACCOUNT: {
     accountType: 'PKR_ACCOUNT',
     fields: [
-      { name: 'accountNumber', example: '1234567890123456' },
-      { name: 'phoneNumber', example: '+923001234567' },
-      { name: 'iban', example: 'PK36SCBL0000001123456702', description: 'Optional' },
-      { name: 'bankName', example: 'HBL', description: 'Required for Mobile Money' },
+      { name: 'bankName', example: 'HBL' },
+      { name: 'accountNumber', example: '1234567890123456', description: 'For bank transfer' },
+      { name: 'iban', example: 'PK36SCBL0000001123456702', description: 'Optional (24 chars, starts with PK)' },
+      { name: 'phoneNumber', example: '+923001234567', description: 'For mobile money' },
     ],
     beneficiaryRequired: true,
   },
diff --git a/mintlify/snippets/external-accounts.mdx b/mintlify/snippets/external-accounts.mdx
index f56440bb..16fb671e 100644
--- a/mintlify/snippets/external-accounts.mdx
+++ b/mintlify/snippets/external-accounts.mdx
@@ -198,6 +198,7 @@ curl -X POST 'https://api.lightspark.com/grid/2025-10-13/customers/external-acco
     "platformAccountId": "co_mobile_001",
     "accountInfo": {
       "accountType": "COP_ACCOUNT",
+      "bankName": "Nequi",
       "phoneNumber": "+573001234567",
       "beneficiary": {
         "beneficiaryType": "INDIVIDUAL",