Supported Regions

A crypto holder must reside in one of the supported regions to be able to order and use Immersve cards.

Below is an indicative list of regions supported by Immersve.

Live

Argentina, Australia, Austria, Belgium, Bulgaria, Brazil, Chile, Colombia, Croatia, Cyprus, Czech Republic (Czechia), Denmark, Estonia, Finland, France, Germany, Greece, Guatemala, Hungary, Iceland, Ireland, Italy, Latvia, Liechtenstein, Lithuania, Luxembourg, Malta, Mexico, Netherlands, New Zealand, Norway, Peru, Poland, Portugal, Romania, Slovakia, Slovenia, Spain, Sweden, United Kingdom.

Coming soon

Bolivia, Dominican Republic, Ecuador, El Salvador, Malaysia, Paraguay, Puerto Rico, Thailand, Uruguay, Vietnam, Venezuela, United Arab Emirates, United States.

Supported Regions Endpoint

The availability of regions may vary between partners. A region may be supported by Immersve but not be accessible to a given partner. The supported regions endpoint allow you to:

• Get Supported Regions and Codes
  Checking if a partner can issue cards in a region, getting the region code for a region when populating regions in UI elements (such as dropdowns).

• Get Legal Documents
  Getting partner specific legal documents for a region. See Presenting Legal Documents.

For the most up-to-date list of the supported regions for a partner, use the supported regions endpoint.

Custodial Wallets

If you are authenticating with Immersve using API Key Authentication as part of a Custodial Wallets integration.

Setup environment variables

The following variables are referenced from the example bash scripts throughout the next section of this guide.

card_issuer_api_key="<your_card_issuer_api_key>"
card_issuer_api_secret="<your_card_issuer_api_secret>"
partner_account_id="<your_partner_account_id>"

Getting supported regions

Calling the endpoint using an api key.

curl "https://test.immersve.com/api/accounts/${partner_account_id}/supported-regions" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "x-api-key: ${card_issuer_api_key}" \
  -H "x-api-secret: ${card_issuer_api_secret}"

Web3 Wallets

If you are authenticating with Immersve using User Session Authentication as part of a Web3 Wallets integration.

Setup environment variables

The following variables are referenced from the example bash scripts throughout the next section of this guide.

partner_account_id="<your_partner_account_id>"
imsv_access_token="<access token from login response>"

Getting supported regions

Calling the endpoint using a bearer token.

curl "https://test.immersve.com/api/accounts/${partner_account_id}/supported-regions" \
 -H "Authorization: Bearer ${imsv_access_token}"

Regional Exceptions

The following table shows which identity documents are accepted for verification in each supported country: