diff --git a/mintlify/platform-overview/core-concepts/currencies-and-rails.mdx b/mintlify/platform-overview/core-concepts/currencies-and-rails.mdx index 7a086ce2e..694a807e0 100644 --- a/mintlify/platform-overview/core-concepts/currencies-and-rails.mdx +++ b/mintlify/platform-overview/core-concepts/currencies-and-rails.mdx @@ -14,7 +14,7 @@ Grid supports a wide range of fiat currencies and cryptocurrencies, with automat -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). ## Currency Conversion diff --git a/mintlify/snippets/external-accounts.mdx b/mintlify/snippets/external-accounts.mdx index 16fb671ec..461760d5e 100644 --- a/mintlify/snippets/external-accounts.mdx +++ b/mintlify/snippets/external-accounts.mdx @@ -789,6 +789,48 @@ curl -X POST 'https://api.lightspark.com/grid/2025-10-13/customers/external-acco + +**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" + } + } + } + }' +``` + + + `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). + + + **Bitcoin Lightning (Spark Wallet)**