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

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

Coming soon

Argentina, Brazil, Chile, Colombia, Mexico, Peru, United Arab Emirates, United States.

Supported Regions Endpoint

API Reference: Get Supported Regions

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}"