Skip to content

Docs: add SWIFT payout documentation to external-account examples #662

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
shreyav merged 2 commits into from
Jul 7, 2026
+43 −1
Merged

Docs: add SWIFT payout documentation to external-account examples #662

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
554444c
Docs: add SWIFT payout documentation (searchable guide + external-acc…
shreyav Jul 6, 2026
a1f9d1f
Remove dedicated SWIFT Payouts page; keep the external-accounts SWIFT…
shreyav Jul 7, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion mintlify/platform-overview/core-concepts/currencies-and-rails.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ Grid supports a wide range of fiat currencies and cryptocurrencies, with automat
<CountrySupport />

<Note>
Grid automatically selects the optimal rail based on currency, country, and amount. You don't need to specify the rail in your API requests.
Grid automatically selects the optimal rail based on currency, country, and amount. You don't need to specify the rail in your API requests. For destinations without a local rail, create a SWIFT external account to pay out over international wire — see [External Accounts](/payouts-and-b2b/depositing-funds/external-accounts).
</Note>

## Currency Conversion
Expand Down
42 changes: 42 additions & 0 deletions mintlify/snippets/external-accounts.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -789,6 +789,48 @@ curl -X POST 'https://api.lightspark.com/grid/2025-10-13/customers/external-acco
</Note>
</Tab>

<Tab title="SWIFT (International)">
**SWIFT / International Wire**

Use a SWIFT account to send payouts to bank accounts in countries or currencies where Grid doesn't offer a local payment rail. Provide the bank's SWIFT/BIC code and the beneficiary's account number (or IBAN for IBAN-based corridors).

```bash cURL
curl -X POST 'https://api.lightspark.com/grid/2025-10-13/customers/external-accounts' \
-H 'Authorization: Basic $GRID_CLIENT_ID:$GRID_CLIENT_SECRET' \
-H 'Content-Type: application/json' \
-d '{
"currency": "USD",
"platformAccountId": "swift_usd_001",
"accountInfo": {
"accountType": "SWIFT_ACCOUNT",
"country": "NG",
"swiftCode": "GTBINGLA",
"bankName": "Guaranty Trust Bank",
"accountNumber": "1234567890",
"beneficiary": {
"beneficiaryType": "INDIVIDUAL",
"fullName": "Adaeze Okafor",
"birthDate": "1991-03-22",
"nationality": "NG",
"address": {
"line1": "15 Broad Street",
"city": "Lagos",
"state": "Lagos",
"postalCode": "101233",
"country": "NG"
}
}
}
}'
```

<Note>
`currency` is the currency the destination account holds, and `country` is where the bank
account is located — they can differ. Provide `accountNumber` for most corridors; use `iban`
instead for IBAN-only corridors (e.g. GB, BR).
Comment thread
ls-bolt[bot] marked this conversation as resolved.
</Note>
</Tab>

<Tab title="Cryptocurrency">
**Bitcoin Lightning (Spark Wallet)**

Expand Down
Loading