Secure your connection with Basic Auth

In Basic Auth, the API key and platform name are used for authentication with the Tango APIs. To start, log in to your Tango portal and get your platform name and generate the API key. Encode your platform name and API key in base64 and use it for authentication. 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 practice:

We recommend only one active key at a time. Rotate your 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, you can have two active keys at a time.

Step 1: Get the platform name and generate the API key

  1. Sign in to the Tango portal.
  2. Navigate to Team settings on the left menu.
  1. Go to RaaS API keys and click Manage.

  1. Click Generate API Key to create a new API key.
  2. To make the key visible, click the eye icon next to your Active key.
  3. To Copy, hover with your mouse on top of the API Key and click.

Step 2. Call the Tango API

Use the platform name and API key to call the Tango API

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 YOUR_API_KEY")
  .build();

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

Step 3: Try it in test console

  1. In the Tango API test console, navigate to a Tango API you want to test such as Customers.
  2. Select Basic under AUTHENTICATION.

  1. Enter your platform name for the username, and enter your API key for the password.
  2. Click Try it and check the response.

For questions and more information, email us at [email protected].


What’s Next