> For the complete documentation index, see [llms.txt](https://help.dscout.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.dscout.com/private-panels/integrations/private-panels-integrations/tango-card-integration/troubleshoot-the-tango-card-integration.md).

# Troubleshoot the Tango Card integration

If you run into issues when using the Tango Card integration, refer to the errors below for advice on how to resolve them:

### Setting up the integration

<details>

<summary>An error is displayed when connecting: <code>We could not sign in to Tango Card with those details. Check the platform name and API key and try again.</code></summary>

Tango Card rejected the credentials, so nothing was saved.

To resolve, open your Tango Card portal and confirm your **platform name** and **API key** under **Team settings** → **API credentials**. Common causes include a typo, an API key that's been rotated or revoked, and sandbox credentials entered on a production account (or the reverse).

</details>

<details>

<summary>An error is displayed when connecting: <code>Tango Card is not responding right now. Your details were not saved — wait a moment and try again.</code></summary>

Tango Card didn't answer in time, or answered with a server error. This says nothing about your credentials—they may be perfectly fine.

To resolve, wait a moment and try connecting again.

</details>

<details>

<summary>An error is displayed when connecting: <code>Enter both your Tango Card platform name and API key.</code></summary>

One of the two fields was submitted empty. Both are required.

</details>

<details>

<summary>An error is displayed during setup: <code>You do not have permission to take this action.</code></summary>

This error is displayed to view-only users who attempt to connect or disconnect an integration. To set up the integration, speak with one of your Private Panels admins.

</details>

### Choosing a reward or funding account

<details>

<summary>The <strong>Tango Card Reward</strong> drop-down is empty, or a brand you expect is missing</summary>

Private Panels only lists rewards it can send with a researcher-entered amount. A reward appears only when it's variable-amount, priced in USD, and active in your Tango Card catalog.

To resolve, check the reward's details in your Tango Card portal. Fixed-value cards—ones that only come in set denominations—can't be used for Private Panels incentives.

</details>

<details>

<summary>An error is displayed in Study Settings: <code>Error loading Tango Card rewards.</code> or <code>Error loading Tango Card funding accounts.</code></summary>

Private Panels couldn't reach Tango Card to load the list.

{% hint style="success" %}
**Tip:** This error is often temporary. Reload the page before digging further.
{% endhint %}

If it persists, confirm your integration is still connected on the **Settings** → **Integrations** page, and that your API key hasn't been revoked in Tango Card.

</details>

<details>

<summary>An error is displayed in Study Settings: <code>We could not load your connected incentive providers, so reward selection is unavailable.</code></summary>

The list of your connected integrations couldn't be loaded, so Private Panels can't show the reward fields.

To resolve, reload the page.

</details>

<details>

<summary>The <strong>Tango Card Funding account</strong> drop-down isn't displayed</summary>

This is expected when your Tango Card platform has exactly one usable funding account—payments draw from it automatically, so there's nothing to choose.

If you expect several accounts, confirm each one is active and denominated in USD in Tango Card. Inactive, frozen, and non-USD accounts are excluded.

</details>

### Paying participants

<details>

<summary>An error is displayed in the payment modal: <code>Missing Tango Card reward - please update in Study Settings.</code></summary>

The study doesn't have a Tango Card reward selected yet.

To resolve, open **Study Settings** and select a **Tango Card Reward**. For more information, see [Set up Tango Card for a study](/private-panels/integrations/private-panels-integrations/tango-card-integration/set-up-tango-card-for-a-study.md).

</details>

<details>

<summary>A warning is displayed in the payment modal: <code>This payment method supports USD only.</code></summary>

Tango Card payments are processed in USD, and this study's incentive currency is something else.

To resolve, change the study's incentive currency to **USD** in **Study Settings**, or pay this study with another method.

</details>

<details>

<summary>An error is displayed: <code>Choose which Tango Card funding account this study pays from in Study Settings.</code></summary>

Your Tango Card platform holds several funding accounts, and this study hasn't been pointed at one.

To resolve, open **Study Settings** and select a **Tango Card Funding account**.

</details>

<details>

<summary>An error is displayed: <code>Your Tango Card platform has no funding account to pay from. Create and fund one in Tango Card, then try again.</code></summary>

Private Panels found no usable funding account on your platform. An account has to be active and denominated in USD to pay from.

To resolve, create and fund an account in your Tango Card portal, then try the payment again.

</details>

<details>

<summary>An error is displayed: <code>Tango Card funding account is not active; pick another one in Study Settings.</code></summary>

The account this study pays from has since been deactivated or frozen in Tango Card.

To resolve, reactivate it in Tango Card, or select a different **Tango Card Funding account** in **Study Settings**.

</details>

<details>

<summary>An error is displayed: <code>That Tango Card funding account is no longer available. Pick another one in Study Settings.</code></summary>

The account this study pays from can't be found on your platform anymore. This also happens when the integration has been reconnected to a *different* Tango Card platform, since the account IDs stored on your studies only existed on the old one.

To resolve, select a different **Tango Card Funding account** in **Study Settings**.

</details>

<details>

<summary>An error is displayed: <code>Tango Card funding account currency is EUR; USD required.</code></summary>

The account this study pays from isn't denominated in USD, and Tango Card payments are processed in USD only.

To resolve, select a USD account as the study's **Tango Card Funding account** in **Study Settings**.

</details>

<details>

<summary>An error is displayed: <code>Not enough balance in your Tango Card balance. Balance: $X, Needed: $Y. Please fund your Tango Card balance and try again.</code></summary>

The payment is refused before anyone is paid, because your funding account doesn't hold enough to cover the amount multiplied by the number of participants you selected.

To resolve, add funds to the account in your Tango Card portal, then try the payment again. You can also pay participants in smaller batches.

</details>

<details>

<summary>An error is displayed: <code>Error checking balance. Please try again later.</code> or <code>We could not check your Tango Card funding account. Please try again.</code></summary>

Private Panels couldn't read your balance from Tango Card, so it won't let the payment through on an unverified budget.

{% hint style="success" %}
**Tip:** This error is often temporary. Try again in a moment before digging further.
{% endhint %}

</details>

<details>

<summary><strong>Tango Card</strong> isn't listed as a payment method</summary>

This usually means one of the following:

* The integration isn't connected. Check the **Settings** → **Integrations** page.
* Your organization pays incentives in points, in which case connected incentive integrations aren't offered as payment methods.
* The list of connected payment methods failed to load, in which case you'll also see: `We could not load your connected payment methods, so this list is incomplete. Please reload the page and try again.` Reload the page.

</details>

<details>

<summary>An error is displayed: <code>Only Admin user roles can pay incentives in this Organization</code></summary>

Your organization restricts incentive payments to admins.

To resolve, ask one of your Private Panels admins to send the payment, or to change the restriction in your organization's settings.

</details>

<details>

<summary>A participant is marked <strong>Payment failed</strong> after a payment was sent</summary>

Tango Card refused the order for that participant, so Private Panels returned them to an unpaid state rather than leaving them recorded as paid. The person who sent the payment receives an email naming the study and the participant.

To resolve, confirm the participant has a valid payment email and that your funding account is active and funded, then pay them again. If it keeps failing, contact the [Dscout Support Team](mailto:support@dscout.com).

</details>

If the above guidance doesn't help, reach out to your Account Director or the [Dscout Support Team](mailto:support@dscout.com) for assistance.

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

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>Set up the Tango Card integration</td><td><a href="/private-panels/integrations/private-panels-integrations/tango-card-integration/set-up-the-tango-card-integration.md">Set up the Tango Card integration</a></td></tr><tr><td>Set up Tango Card for a study</td><td><a href="/private-panels/integrations/private-panels-integrations/tango-card-integration/set-up-tango-card-for-a-study.md">Set up Tango Card for a study</a></td></tr><tr><td>Pay incentives with Tango Card</td><td><a href="/private-panels/integrations/private-panels-integrations/tango-card-integration/pay-incentives-with-tango-card.md">Pay incentives with Tango Card</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.dscout.com/private-panels/integrations/private-panels-integrations/tango-card-integration/troubleshoot-the-tango-card-integration.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.