Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Set up the Tango Card integration

This guide walks you through setting up the Tango Card integration in your Private Panels account.

Note: The Tango Card integration is configured at the organization level, meaning it will be available to everyone with access to your Private Panels organization once configured without them needing to set it up themselves.

Requirements

To set up the Tango Card integration, you'll need:

  • An active Tango Card account.

  • The following details about your Tango Card account:

    • Platform name.

    • API key.

  • At least one Tango Card funding account that's active, denominated in USD, and funded.

  • A User or Admin seat in Private Panels. Viewers can't connect integrations.

Tip: Your platform name and API key live in your Tango Card portal, under Team settings → API credentials. These are typically only available to users with administrator access to your Tango Card account. If you don't have this access, partner with the person on your team who does.

Set up the integration

You can connect Private Panels to your Tango Card account from the Settings page within Private Panels.

To connect Private Panels to Tango Card:

1

Navigate to the Settings tab in Private Panels. Then, select Integrations.

2

Under Tango Card, click Connect. The integration settings modal is displayed.

3

Enter your Tango Card Platform name. This is the name of your organization's Tango Card platform, and it looks something like acme-platform.

4

Enter your Tango Card API key.

Note: Your API key is stored encrypted and isn't displayed again after you connect.

5

Click Connect.

Now, a confirmation message is displayed and your Private Panels organization is connected to your Tango Card account. Your platform name is displayed on the Integrations page:

Note: Private Panels checks your details with Tango Card before saving them. If Tango Card rejects them, nothing is stored and you'll see an error explaining why. For more information, see Troubleshoot the Tango Card integration.

You can return to this page to Edit your Tango Card details at any time, or to Disconnect the integration altogether.

Tip: When you click Edit, your platform name is filled in for you, but you'll need to re-enter your API key. This is by design—we never display a stored key back to you.

Good to know

  • Tango Card payments are USD only. A study can only be paid with Tango Card when its incentive currency is USD.

  • Organizations that pay in points don't see Tango Card as a payment method. Points-based incentives are handled manually, using the Mark as paid option.

  • Disconnecting doesn't clear your studies' Tango Card selections. That way, rotating an API key or reconnecting the same platform leaves your studies untouched. If you connect a different Tango Card platform, re-select the reward and funding account on each study.

Tip: Once you've set up the Tango Card integration, you'll still need to choose a reward for each study before you can pay anyone. For more information, see Set up Tango Card for a study.

For more information on the Tango Card integration, see the following resources:

Set up Tango Card for a study

Pay incentives with Tango Card

Troubleshoot the Tango Card integration