Skip to content

Commit 8b9cc8d

Browse files
pengyingclaude
andauthored
Remove Plaid integration from documentation and API (#304)
This PR removes all Plaid integration support from the codebase, including documentation, API specifications, and code examples. ## Summary Plaid integration has been completely removed from the platform. This includes all user-facing documentation, API endpoint definitions, and code examples across multiple product areas (ramps, payouts, rewards, and global P2P). ## Key Changes - **Removed documentation files:** - `mintlify/ramps/accounts/plaid.mdx` - Comprehensive Plaid integration guide for ramps - `mintlify/payouts-and-b2b/depositing-funds/plaid.mdx` - Plaid guide for payouts - `mintlify/rewards/developer-guides/plaid.mdx` - Plaid guide for rewards - `mintlify/global-p2p/managing-accounts/plaid.mdx` - Plaid guide for global P2P - `mintlify/snippets/plaid-integration.mdx` - Shared Plaid integration snippet - **Removed API specifications:** - `/plaid/link-tokens` POST endpoint for requesting Plaid Link tokens - `/plaid/callback/{plaid_link_token}` POST endpoint for submitting public tokens - All associated OpenAPI schema definitions (`PlaidLinkTokenRequest`, `PlaidLinkTokenResponse`, `PlaidCallbackRequest`, `PlaidCallbackResponse`) - OpenAPI path files in `openapi/paths/plaid/` - OpenAPI schema files in `openapi/components/schemas/plaid/` - **Updated documentation references:** - Removed Plaid links from external accounts guides across all product areas - Updated platform capabilities documentation to remove Plaid mentions - Updated account model and transaction lifecycle docs to remove Plaid-specific references - Updated navigation structure in `mintlify/docs.json` to remove Plaid pages ## Implementation Details The removal is comprehensive and affects both the OpenAPI specification files (modular YAML structure) and the consolidated OpenAPI definitions. All references to Plaid in code examples and best practices have been removed, with some documentation updated to reflect alternative approaches (e.g., "debit cards" instead of "Plaid-linked accounts"). https://claude.ai/code/session_01QR8JWd4u4hM9iuvH8t7EVU --------- Co-authored-by: Claude <noreply@anthropic.com>
1 parent 008bf83 commit 8b9cc8d

28 files changed

Lines changed: 125 additions & 1372 deletions

.claude/skills/grid-api/SKILL.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -200,7 +200,7 @@ curl -s -u "$GRID_CLIENT_ID:$GRID_CLIENT_SECRET" \
200200
"$GRID_BASE_URL/customers/external-accounts" | jq .
201201
```
202202

203-
For all 24 supported fiat account types and 6 crypto wallet types with their field requirements, read `references/account-types.md`.
203+
For all 27 supported fiat account types and 7 crypto wallet types with their field requirements, read `references/account-types.md`.
204204

205205
### Exchange Rates (Pre-Quote FX Rates)
206206

@@ -259,7 +259,7 @@ Returns:
259259
- `totalFee` — total cost in withdrawal currency (network fee converted + application fee)
260260
- `netAmount` — amount recipient receives after all fees
261261

262-
Supported networks: `SOLANA_MAINNET`, `SOLANA_DEVNET`, `ETHEREUM_MAINNET`, `POLYGON_MAINNET`, `TRON_MAINNET`
262+
Supported networks: `SOLANA_MAINNET`, `SOLANA_DEVNET`, `ETHEREUM_MAINNET`, `POLYGON_MAINNET`, `BASE_MAINNET`, `TRON_MAINNET`
263263

264264
### Quotes (Cross-Currency Transfers)
265265

@@ -471,7 +471,7 @@ Use this flow when the user asks for a "realtime quote" or "just in time" funded
471471

472472
**Compatible instant methods:**
473473

474-
- **Crypto:** BTC (Lightning, Spark), USDC (Solana, Base, Polygon), USDT (Tron)
474+
- **Crypto:** BTC (Lightning, Spark), USDC (Solana, Base, Polygon, Ethereum), USDT (Tron)
475475
- **Fiat:** RTP, SEPA Instant, and other instant payment rails
476476

477477
**Flow:**

.claude/skills/grid-api/references/account-types.md

Lines changed: 114 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,10 @@ This reference maps countries/regions to their required account types and fields
66

77
| Country/Region | Account Type | Currency | Payment Rail(s) | Primary Identifier |
88
|----------------|--------------|----------|-----------------|-------------------|
9+
| Botswana | BWP_ACCOUNT | BWP | MOBILE_MONEY | Phone number + Provider |
910
| Brazil | BRL_ACCOUNT | BRL | PIX | PIX key |
1011
| Canada | CAD_ACCOUNT | CAD | BANK_TRANSFER | Bank code + Branch code + Account number |
12+
| Central Africa (CFA) | XAF_ACCOUNT | XAF | MOBILE_MONEY | Phone number + Provider + Region |
1113
| Denmark | DKK_ACCOUNT | DKK | SEPA, SEPA_INSTANT | IBAN |
1214
| Europe (SEPA) | EUR_ACCOUNT | EUR | SEPA, SEPA_INSTANT | IBAN |
1315
| Hong Kong | HKD_ACCOUNT | HKD | BANK_TRANSFER | Bank name + SWIFT + Account number |
@@ -24,6 +26,7 @@ This reference maps countries/regions to their required account types and fields
2426
| South Africa | ZAR_ACCOUNT | ZAR | BANK_TRANSFER | Bank name + Account number |
2527
| Tanzania | TZS_ACCOUNT | TZS | MOBILE_MONEY | Phone number + Provider |
2628
| Thailand | THB_ACCOUNT | THB | BANK_TRANSFER | Bank name + SWIFT + Account number |
29+
| UAE | AED_ACCOUNT | AED | BANK_TRANSFER | IBAN |
2730
| Uganda | UGX_ACCOUNT | UGX | MOBILE_MONEY | Phone number + Provider |
2831
| United Kingdom | GBP_ACCOUNT | GBP | FASTER_PAYMENTS | Sort code + Account number |
2932
| United States | USD_ACCOUNT | USD | ACH, WIRE, RTP, FEDNOW | Routing number + Account number |
@@ -37,6 +40,7 @@ This reference maps countries/regions to their required account types and fields
3740
|------|----------|-------------------|
3841
| SPARK_WALLET | BTC | Spark wallet address |
3942
| LIGHTNING | BTC | Lightning invoice, bolt12 offer, or lightning address |
43+
| ETHEREUM_WALLET | USDC | Ethereum L1 wallet address (0x...) |
4044
| SOLANA_WALLET | USDC | Solana wallet address |
4145
| TRON_WALLET | USDT | TRON wallet address |
4246
| POLYGON_WALLET | USDC | Polygon wallet address (0x...) |
@@ -46,6 +50,68 @@ This reference maps countries/regions to their required account types and fields
4650

4751
**IMPORTANT**: All fiat account types now require a `paymentRails` field specifying the payment rail to use.
4852

53+
### Botswana (BWP_ACCOUNT)
54+
55+
```bash
56+
curl -s -u "$GRID_CLIENT_ID:$GRID_CLIENT_SECRET" \
57+
-X POST -H "Content-Type: application/json" \
58+
-d '{
59+
"customerId": "<customerId>",
60+
"currency": "BWP",
61+
"accountInfo": {
62+
"accountType": "BWP_ACCOUNT",
63+
"paymentRails": ["MOBILE_MONEY"],
64+
"phoneNumber": "+2671234567",
65+
"provider": "Orange Money",
66+
"beneficiary": {
67+
"beneficiaryType": "INDIVIDUAL",
68+
"fullName": "Full Name",
69+
"birthDate": "1990-01-15",
70+
"nationality": "BW"
71+
}
72+
}
73+
}' \
74+
"$GRID_BASE_URL/customers/external-accounts" | jq .
75+
```
76+
77+
Required fields:
78+
79+
- `paymentRails`: `MOBILE_MONEY`
80+
- `phoneNumber`: International format (pattern: `^\+[0-9]{6,14}$`)
81+
- `provider`: Mobile money provider name
82+
83+
### Central Africa CFA (XAF_ACCOUNT)
84+
85+
```bash
86+
curl -s -u "$GRID_CLIENT_ID:$GRID_CLIENT_SECRET" \
87+
-X POST -H "Content-Type: application/json" \
88+
-d '{
89+
"customerId": "<customerId>",
90+
"currency": "XAF",
91+
"accountInfo": {
92+
"accountType": "XAF_ACCOUNT",
93+
"paymentRails": ["MOBILE_MONEY"],
94+
"phoneNumber": "+237612345678",
95+
"provider": "MTN Mobile Money",
96+
"region": "CM",
97+
"beneficiary": {
98+
"beneficiaryType": "INDIVIDUAL",
99+
"fullName": "Full Name",
100+
"birthDate": "1990-01-15",
101+
"nationality": "CM"
102+
}
103+
}
104+
}' \
105+
"$GRID_BASE_URL/customers/external-accounts" | jq .
106+
```
107+
108+
Required fields:
109+
110+
- `paymentRails`: `MOBILE_MONEY`
111+
- `phoneNumber`: International format (pattern: `^\+[0-9]{6,14}$`)
112+
- `provider`: Mobile money provider name
113+
- `region`: Country code in Central African CFA franc zone (enum: `CM` for Cameroon, `CG` for Congo)
114+
49115
### Mexico (MXN_ACCOUNT)
50116

51117
**Individual beneficiary:**
@@ -265,6 +331,36 @@ curl -s -u "$GRID_CLIENT_ID:$GRID_CLIENT_SECRET" \
265331

266332
UPI VPA format: `username@bankhandle` (e.g., `john@okaxis`, `jane@ybl`)
267333

334+
### UAE (AED_ACCOUNT)
335+
336+
```bash
337+
curl -s -u "$GRID_CLIENT_ID:$GRID_CLIENT_SECRET" \
338+
-X POST -H "Content-Type: application/json" \
339+
-d '{
340+
"customerId": "<customerId>",
341+
"currency": "AED",
342+
"accountInfo": {
343+
"accountType": "AED_ACCOUNT",
344+
"paymentRails": ["BANK_TRANSFER"],
345+
"iban": "AE070331234567890123456",
346+
"swiftCode": "EBILAEAD",
347+
"beneficiary": {
348+
"beneficiaryType": "INDIVIDUAL",
349+
"fullName": "Full Name",
350+
"birthDate": "1990-01-15",
351+
"nationality": "AE"
352+
}
353+
}
354+
}' \
355+
"$GRID_BASE_URL/customers/external-accounts" | jq .
356+
```
357+
358+
Required fields:
359+
360+
- `paymentRails`: `BANK_TRANSFER`
361+
- `iban`: UAE IBAN (23 characters, pattern: `^AE[0-9]{21}$`)
362+
- `swiftCode`: SWIFT/BIC code (8 or 11 characters) — optional
363+
268364
### United Kingdom (GBP_ACCOUNT)
269365

270366
```bash
@@ -689,7 +785,7 @@ Mobile money required fields:
689785
- `paymentRails`: `MOBILE_MONEY`
690786
- `phoneNumber`: Country-specific format (see patterns above)
691787
- `provider`: Mobile money provider name
692-
- `countries`: Required for XOF_ACCOUNT (enum: `SN`, `BJ`, `CI`), MWK_ACCOUNT (`MW`), UGX_ACCOUNT (`UG`)
788+
- `countries`: Required for XOF_ACCOUNT (enum: `SN`, `BJ`, `CI`), XAF_ACCOUNT uses `region` (enum: `CM`, `CG`), MWK_ACCOUNT (`MW`), UGX_ACCOUNT (`UG`)
693789

694790
### Crypto Wallets
695791

@@ -727,6 +823,22 @@ curl -s -u "$GRID_CLIENT_ID:$GRID_CLIENT_SECRET" \
727823

728824
Lightning supports one of: `invoice` (bolt11), `bolt12` (bolt12 offer), or `lightningAddress` (user@domain format).
729825

826+
#### Ethereum Wallet (USDC)
827+
828+
```bash
829+
curl -s -u "$GRID_CLIENT_ID:$GRID_CLIENT_SECRET" \
830+
-X POST -H "Content-Type: application/json" \
831+
-d '{
832+
"customerId": "<customerId>",
833+
"currency": "USDC",
834+
"accountInfo": {
835+
"accountType": "ETHEREUM_WALLET",
836+
"address": "0xAbCDEF1234567890aBCdEf1234567890ABcDef12"
837+
}
838+
}' \
839+
"$GRID_BASE_URL/customers/external-accounts" | jq .
840+
```
841+
730842
#### Solana Wallet (USDC)
731843

732844
```bash
@@ -748,6 +860,7 @@ curl -s -u "$GRID_CLIENT_ID:$GRID_CLIENT_SECRET" \
748860
- **TRON_WALLET**: USDT, requires `address`
749861
- **POLYGON_WALLET**: USDC, requires `address` (0x format)
750862
- **BASE_WALLET**: USDC, requires `address` (0x format)
863+
- **ETHEREUM_WALLET**: USDC, requires `address` (0x format)
751864

752865
**Note:** Crypto wallets do NOT require beneficiary information.
753866

.claude/skills/grid-api/references/endpoints.md

Lines changed: 0 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -211,13 +211,6 @@ Use these account number endings for testing:
211211
|--------|----------|-------------|
212212
| GET | `/uma-providers` | List UMA provider domains |
213213

214-
## Plaid Integration
215-
216-
| Method | Endpoint | Description |
217-
|--------|----------|-------------|
218-
| POST | `/plaid/link-tokens` | Create Plaid Link token |
219-
| POST | `/plaid/callback/{plaid_link_token}` | Plaid Link callback |
220-
221214
## Pagination
222215

223216
List endpoints support cursor-based pagination:

.stainless/stainless.yml

Lines changed: 0 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -186,11 +186,6 @@ resources:
186186
vnd_account_info: "#/components/schemas/VndAccountInfo"
187187
# base_external_account_info: "#/components/schemas/BaseExternalAccountInfo"
188188

189-
plaid:
190-
methods:
191-
create_link_token: post /plaid/link-tokens
192-
submit_public_token: post /plaid/callback/{plaid_link_token}
193-
194189
transfer_in:
195190
models:
196191
transaction: "#/components/schemas/TransactionOneOf"

mintlify/docs.json

Lines changed: 4 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -95,8 +95,7 @@
9595
"group": "Managing Accounts",
9696
"pages": [
9797
"payouts-and-b2b/depositing-funds/internal-accounts",
98-
"payouts-and-b2b/depositing-funds/external-accounts",
99-
"payouts-and-b2b/depositing-funds/plaid"
98+
"payouts-and-b2b/depositing-funds/external-accounts"
10099
]
101100
},
102101
{
@@ -142,8 +141,7 @@
142141
"group": "Managing Accounts",
143142
"pages": [
144143
"ramps/accounts/internal-accounts",
145-
"ramps/accounts/external-accounts",
146-
"ramps/accounts/plaid"
144+
"ramps/accounts/external-accounts"
147145
]
148146
},
149147
{
@@ -186,8 +184,7 @@
186184
"group": "Managing Accounts",
187185
"pages": [
188186
"rewards/developer-guides/internal-accounts",
189-
"rewards/developer-guides/external-accounts",
190-
"rewards/developer-guides/plaid"
187+
"rewards/developer-guides/external-accounts"
191188
]
192189
},
193190
{
@@ -231,8 +228,7 @@
231228
"group": "Managing Accounts",
232229
"pages": [
233230
"global-p2p/managing-accounts/internal-accounts",
234-
"global-p2p/managing-accounts/external-accounts",
235-
"global-p2p/managing-accounts/plaid"
231+
"global-p2p/managing-accounts/external-accounts"
236232
]
237233
},
238234
{

mintlify/global-p2p/managing-accounts/plaid.mdx

Lines changed: 0 additions & 12 deletions
This file was deleted.

0 commit comments

Comments
 (0)