The Country Spec object 

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_currenciesmap

    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_fieldsmap

The Country Spec object
{
"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"
]
}
}
}

Retrieve a Country Spec 

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 returns an error otherwise.

GET /v1/country_specs/:id
stripe.Key = "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2"
params := &stripe.CountrySpecParams{}
result, err := countryspec.Get("US", params)
Response
{
"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"
]
}
}
}

List Country Specs 

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.

GET /v1/country_specs
stripe.Key = "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2"
params := &stripe.CountrySpecListParams{}
params.Limit = stripe.Int64(3)
result := countryspec.List(params)
Response
{
"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 

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.

External Account Cards 

External account cards are debit cards associated with a Stripe platform’s connected accounts for the purpose of transferring funds to or from the connected accounts Stripe balance.

This API is only available for users enrolled in the public preview for Accounts v2 on Stripe Connect. If you are not in this preview, please use the Accounts v1 API to manage your connected accounts’ external bank accounts instead.