Stripe needs to collect certain pieces of information about each account created. These requirements can differ depending on the account’s country. The Country Specs API makes these rules available to your integration.
You can also view the information from this API call as an online guide.
Attributes
- idstring
Unique identifier for the object. Represented as the ISO country code for this country.
- default_
currencystring The default currency for this country. This applies to both payment methods and bank accounts.
- supported_
bank_ account_ currenciesobject Currencies that can be accepted in the specific country (for transfers).
- supported_
payment_ currenciesarray of strings Currencies that can be accepted in the specified country (for payments).
- supported_
payment_ methodsarray of strings Payment methods available in the specified country. You may need to enable some payment methods (e.g., ACH) on your account before they appear in this list. The
stripe
payment method refers to charging through your platform. - supported_
transfer_ countriesarray of strings Countries that can accept transfers from the specified country.
More attributes
- objectstring
- verification_
fieldsobject
{ "id": "US", "object": "country_spec", "default_currency": "usd", "supported_bank_account_currencies": { "usd": [ "US" ] }, "supported_payment_currencies": [ "usd", "aed", "afn", "..." ], "supported_payment_methods": [ "ach", "card", "stripe" ], "supported_transfer_countries": [ "US", "AE", "AG", "AL", "AM", "AR", "AT", "AU", "BA", "BE", "BG", "BH", "BO", "CA", "CH", "CI", "CL", "CO", "CR", "CY", "CZ", "DE", "DK", "DO", "EC", "EE", "EG", "ES", "ET", "FI", "FR", "GB", "GH", "GM", "GR", "GT", "GY", "HK", "HR", "HU", "ID", "IE", "IL", "IS", "IT", "JM", "JO", "JP", "KE", "KH", "KR", "KW", "LC", "LI", "LK", "LT", "LU", "LV", "MA", "MD", "MG", "MK", "MN", "MO", "MT", "MU", "MX", "MY", "NA", "NG", "NL", "NO", "NZ", "OM", "PA", "PE", "PH", "PL", "PT", "PY", "QA", "RO", "RS", "RW", "SA", "SE", "SG", "SI", "SK", "SN", "SV", "TH", "TN", "TR", "TT", "TZ", "UY", "UZ", "VN", "ZA", "BD", "BJ", "MC", "NE", "SM", "AZ", "BN", "BT", "AO", "DZ", "TW", "BS", "BW", "GA", "LA", "MZ", "KZ", "PK" ], "verification_fields": { "company": { "additional": [], "minimum": [ "business_profile.mcc", "business_profile.url", "business_type", "company.address.city", "company.address.line1", "company.address.postal_code", "company.address.state", "company.name", "company.owners_provided", "company.phone", "company.tax_id", "external_account", "owners.address.city", "owners.address.line1", "owners.address.postal_code", "owners.address.state", "owners.dob.day", "owners.dob.month", "owners.dob.year", "owners.email", "owners.first_name", "owners.id_number", "owners.last_name", "owners.phone", "owners.ssn_last_4", "owners.verification.document", "representative.address.city", "representative.address.line1", "representative.address.postal_code", "representative.address.state", "representative.dob.day", "representative.dob.month", "representative.dob.year", "representative.email", "representative.first_name", "representative.id_number", "representative.last_name", "representative.phone", "representative.relationship.executive", "representative.relationship.title", "representative.ssn_last_4", "representative.verification.document", "tos_acceptance.date", "tos_acceptance.ip" ] }, "individual": { "additional": [], "minimum": [ "business_profile.mcc", "business_profile.url", "business_type", "external_account", "individual.address.city", "individual.address.line1", "individual.address.postal_code", "individual.address.state", "individual.dob.day", "individual.dob.month", "individual.dob.year", "individual.email", "individual.first_name", "individual.id_number", "individual.last_name", "individual.phone", "individual.ssn_last_4", "individual.verification.document", "tos_acceptance.date", "tos_acceptance.ip" ] } }}
Returns a Country Spec for a given Country code.
Parameters
No parameters.
Returns
Returns a country_spec object if a valid country code is provided, and raises an error otherwise.
{ "id": "US", "object": "country_spec", "default_currency": "usd", "supported_bank_account_currencies": { "usd": [ "US" ] }, "supported_payment_currencies": [ "usd", "aed", "afn", "..." ], "supported_payment_methods": [ "ach", "card", "stripe" ], "supported_transfer_countries": [ "US", "AE", "AG", "AL", "AM", "AR", "AT", "AU", "BA", "BE", "BG", "BH", "BO", "CA", "CH", "CI", "CL", "CO", "CR", "CY", "CZ", "DE", "DK", "DO", "EC", "EE", "EG", "ES", "ET", "FI", "FR", "GB", "GH", "GM", "GR", "GT", "GY", "HK", "HR", "HU", "ID", "IE", "IL", "IS", "IT", "JM", "JO", "JP", "KE", "KH", "KR", "KW", "LC", "LI", "LK", "LT", "LU", "LV", "MA", "MD", "MG", "MK", "MN", "MO", "MT", "MU", "MX", "MY", "NA", "NG", "NL", "NO", "NZ", "OM", "PA", "PE", "PH", "PL", "PT", "PY", "QA", "RO", "RS", "RW", "SA", "SE", "SG", "SI", "SK", "SN", "SV", "TH", "TN", "TR", "TT", "TZ", "UY", "UZ", "VN", "ZA", "BD", "BJ", "MC", "NE", "SM", "AZ", "BN", "BT", "AO", "DZ", "TW", "BS", "BW", "GA", "LA", "MZ", "KZ", "PK" ], "verification_fields": { "company": { "additional": [], "minimum": [ "business_profile.mcc", "business_profile.url", "business_type", "company.address.city", "company.address.line1", "company.address.postal_code", "company.address.state", "company.name", "company.owners_provided", "company.phone", "company.tax_id", "external_account", "owners.address.city", "owners.address.line1", "owners.address.postal_code", "owners.address.state", "owners.dob.day", "owners.dob.month", "owners.dob.year", "owners.email", "owners.first_name", "owners.id_number", "owners.last_name", "owners.phone", "owners.ssn_last_4", "owners.verification.document", "representative.address.city", "representative.address.line1", "representative.address.postal_code", "representative.address.state", "representative.dob.day", "representative.dob.month", "representative.dob.year", "representative.email", "representative.first_name", "representative.id_number", "representative.last_name", "representative.phone", "representative.relationship.executive", "representative.relationship.title", "representative.ssn_last_4", "representative.verification.document", "tos_acceptance.date", "tos_acceptance.ip" ] }, "individual": { "additional": [], "minimum": [ "business_profile.mcc", "business_profile.url", "business_type", "external_account", "individual.address.city", "individual.address.line1", "individual.address.postal_code", "individual.address.state", "individual.dob.day", "individual.dob.month", "individual.dob.year", "individual.email", "individual.first_name", "individual.id_number", "individual.last_name", "individual.phone", "individual.ssn_last_4", "individual.verification.document", "tos_acceptance.date", "tos_acceptance.ip" ] } }}
Lists all Country Spec objects available in the API.
Parameters
No parameters.
More parameters
- ending_
beforestring - limitinteger
- starting_
afterstring
Returns
Returns a list of country_spec objects.
{ "object": "list", "url": "/v1/country_specs", "has_more": false, "data": [ { "id": "US", "object": "country_spec", "default_currency": "usd", "supported_bank_account_currencies": { "usd": [ "US" ] }, "supported_payment_currencies": [ "usd", "aed", "afn", "..." ], "supported_payment_methods": [ "ach", "card", "stripe" ], "supported_transfer_countries": [ "US", "AE", "AG", "AL", "AM", "AR", "AT", "AU", "BA", "BE", "BG", "BH", "BO", "CA", "CH", "CI", "CL", "CO", "CR", "CY", "CZ", "DE", "DK", "DO", "EC", "EE", "EG", "ES", "ET", "FI", "FR", "GB", "GH", "GM", "GR", "GT", "GY", "HK", "HR", "HU", "ID", "IE", "IL", "IS", "IT", "JM", "JO", "JP", "KE", "KH", "KR", "KW", "LC", "LI", "LK", "LT", "LU", "LV", "MA", "MD", "MG", "MK", "MN", "MO", "MT", "MU", "MX", "MY", "NA", "NG", "NL", "NO", "NZ", "OM", "PA", "PE", "PH", "PL", "PT", "PY", "QA", "RO", "RS", "RW", "SA", "SE", "SG", "SI", "SK", "SN", "SV", "TH", "TN", "TR", "TT", "TZ", "UY", "UZ", "VN", "ZA", "BD", "BJ", "MC", "NE", "SM", "AZ", "BN", "BT", "AO", "DZ", "TW", "BS", "BW", "GA", "LA", "MZ", "KZ", "PK" ], "verification_fields": { "company": { "additional": [], "minimum": [ "business_profile.mcc", "business_profile.url", "business_type", "company.address.city", "company.address.line1", "company.address.postal_code", "company.address.state", "company.name", "company.owners_provided", "company.phone", "company.tax_id", "external_account", "owners.address.city", "owners.address.line1", "owners.address.postal_code", "owners.address.state", "owners.dob.day", "owners.dob.month", "owners.dob.year", "owners.email", "owners.first_name", "owners.id_number", "owners.last_name", "owners.phone", "owners.ssn_last_4", "owners.verification.document", "representative.address.city", "representative.address.line1", "representative.address.postal_code", "representative.address.state", "representative.dob.day", "representative.dob.month", "representative.dob.year", "representative.email", "representative.first_name", "representative.id_number", "representative.last_name", "representative.phone", "representative.relationship.executive", "representative.relationship.title", "representative.ssn_last_4", "representative.verification.document", "tos_acceptance.date", "tos_acceptance.ip" ] }, "individual": { "additional": [], "minimum": [ "business_profile.mcc", "business_profile.url", "business_type", "external_account", "individual.address.city", "individual.address.line1", "individual.address.postal_code", "individual.address.state", "individual.dob.day", "individual.dob.month", "individual.dob.year", "individual.email", "individual.first_name", "individual.id_number", "individual.last_name", "individual.phone", "individual.ssn_last_4", "individual.verification.document", "tos_acceptance.date", "tos_acceptance.ip" ] } } } ]}
External bank accounts are financial accounts associated with a Stripe platform’s connected accounts for the purpose of transferring funds to or from the connected account’s Stripe balance.