Basic Authentication or Basic Auth is all about authentication. It uses your Tango platform name and API Key as the username and password to authenticate your connection with API. API Keys need to be enabled for your Tango platform first before connecting to Tango API.

See how to Sign in to our Tango portal . If you don't have an account with Tango, see how to set up an account . See our great API endpoints.

👍

Best practices:

• You can have up to two active API keys at the same time. We recommend you to keep only one API key active unless when you’re rotating your keys.
• Rotate API keys at least every six months AND whenever someone who's had access to the key leaves the company. To avoid disruption when you rotate the keys, keep two API keys active until your integration is updated successfully. Deactivation cannot be undone.

📘

Note:

To enable Tango API keys for your Tango platform, contact your Customer Success Manager (CSM) or [email protected] with the Tango portal administrator rights. If you don’t yet have a Tango portal, Sign up for one: US users and international users.

How to connect?

Follow the steps below to connect with Tango API using basic auth:

Step 1: Get the platform name and API key

You can only access the Raas API keys in your Tango portal after they have been enabled for your platform. Find your Raas API key and use it in your API integration.

📘

Note:

You must have Integrations as well as Manage Tango API keys permissions in Tango portal to access the Tango API keys. Learn how to Set user permissions and access level.

To get the platform name and API keys:

1. sign in to the Tango portal
2. Click Team settings > Tango API keys on the left menu.
3. Copy the Platform name and the API key . Click the eye icon to reveal the key, then click it again to hide.

📘

Note:

For your security, RaaS API keys are masked by default in the Tango portal. Treat your keys like passwords and do not share them with unauthorized parties or over unsecured communication channels.

To generate new RaaS keys, go to Tango portal and click Generate API key under Team settings > Tango API Keys. a new key is created and immediately accessible for use. The Audit log gets updated to reflect the created key.

• To deactivate RaaS API keys, go to Tango portal and click Deactivate API key under Team settings > Tango API Keys. See Find and manage RaaS API keys in Tango.

Step 2: Test your integration

With your platform name and API key at hand, test your integration in Tango API test console to make sure the integration is working:

1. Go to the Tango API test console.
2. Navigate to the page you want to test such as Customers.
3. Select Basic for AUTHENTICATION.
4. Enter your username (Platform name) and password (API key) you find in Tango portal.
5. Click Try it and check the response.

Step 3: Call the Tango API

Once you test and make sure the integration is working, use your Platform name and API key to to generate an authorization header and call the API as in the example below:

 OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://integration-api.tangocard.com/raas/v2/customers")
  .get()
  .addHeader("accept", "application/json")
  .addHeader("authorization", "Basic Authorization header")
  .build();

Response response = client.newCall(request).execute();
```