# Integrate with Tango Card for Advocate Programs

Tango Card allows you to reward your participants with a wide variety of digital gift cards. Integrating Tango Card into your Advocate referral program makes it simple to automate, manage, and deliver [gift card rewards](https://help.impact.com/en/support/solutions/articles/155000000752-gift-card-rewards-explained).

## Tango Card account types

There are two ways to connect Tango Card to your Advocate referral program: a direct Tango Card account or a sub-account managed by Advocate. The right choice depends on how much control you want and how much setup your team is willing to manage.

| Criteria               | Direct Tango Card account                                                                                        | Sub-account managed by Advocate                                                                   |
| ---------------------- | ---------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| **Best for**           | Brands that want full control and are comfortable managing their own Tango Card account.                         | Brands that want a managed experience and prefer not to maintain a Tango Card account themselves. |
| **Setup effort**       | Higher: your team configures and maintains the account.                                                          | Lower: Advocate handles setup and most ongoing management.                                        |
| **API key access**     | Yes, you have your own.                                                                                          | No, Advocate manages a central API key.                                                           |
| **Reward catalog**     | Fully customizable.                                                                                              | Preconfigured catalog with a wide selection of gift cards.                                        |
| **KYC requirements**   | May be required for open-loop cards (such as Visa or Mastercard) that aren't already available through Advocate. | Not required unless requesting a new open-loop card not already available.                        |
| **Account management** | Your internal team handles account issues, balance monitoring, and fulfilment errors.                            | Advocate adds users and configures low-balance alerts on your behalf.                             |
| **Support**            | Standard support channels.                                                                                       | Faster, hands-on troubleshooting from the Advocate team.                                          |

#### Direct Tango Card account

A direct Tango Card account gives you the most functionality and control within Tango Card. You'll have full access to funding, users, reporting, and order management, as well as the ability to customize your reward catalog, use your own API key, and control groups and accounts within your Tango Card setup.

Your internal team is responsible for managing account issues, balance monitoring, and fulfilment errors. Open-loop cards (also known as prepaid cards, such as Visa or Mastercard) may require extra compliance steps like completing a Know Your Customer (KYC) process. If the card is already available through Advocate, it can be used without additional setup.

If you don't yet have a Tango Card account and would like to create one, follow these instructions to sign up.

#### Sub-account managed by Advocate

Sub-accounts are created and managed under Advocate's master Tango Card account. They offer a streamlined setup with fewer internal responsibilities and access to a preconfigured reward catalog with a wide selection of gift cards. Advocate handles user management and low-balance alerts on your behalf, and your team benefits from faster, hands-on troubleshooting from Advocate.

In exchange for the simpler setup, sub-accounts have a few restrictions. You won't have access to your own API key (Advocate manages a central one), and you'll need Advocate to add users or configure low-balance alerts. You won't need to complete KYC unless you request a new open-loop card that isn't already available.

Not sure which to choose? Contact your Advocate Program Strategy Manager or contact [support](mailto:saasquatch-support@impact.com) for guidance.

### Connect your Tango Card account to Advocate

Choose the appropriate setup steps based on your selected account type.

#### Connect your direct Tango Card account to Advocate

If you’re using your own Tango Card account:

1. In your Advocate account, from the top navigation bar, select ![](/files/UDyrrRTGbHJFFllCZxyw) **\[User profile] →** [**Settings**](https://app.impact.com/secure/advertiser/account-settings-flow.ihtml).
2. In the *Advocate Settings* section, select **Integrations**.
3. Scroll down to the Tango integration and expand the integration view by selecting **+ \[Add]**.
4. Below *API Platform Options*, select **Custom TangoCard Account (Advanced)** from the drop-down menu.
5. Enter your Tango Card account information:
   * **Account Identifier** and **Group Identifier**. Refer to [Tango Card’s help documentation](https://help.rewardsgenius.com/s/article/Find-account-and-customer-identifiers-for-Tango-API) on how to locate these identifiers.
   * **Tango Card Username**
   * **API Key**. Refer to [Tango Card's help documentation](https://help.rewardsgenius.com/s/article/manae-basic-auth-api-keys-in-tango) on how to locate it.
6. Select **Connect** at the bottom of the *Tango Card integration* section to save and connect your account.

#### Connect your Advocate-managed Tango Card Account

If you are using a sub-account managed by Advocate:

1. In your Advocate account, from the top navigation bar, select ![](/files/UDyrrRTGbHJFFllCZxyw) **\[User profile] →** [**Settings**](https://app.impact.com/secure/advertiser/account-settings-flow.ihtml).
2. In the *Advocate Settings* section, select **Integrations**.
3. Scroll down to the Tango integration and expand the integration view by selecting **+ \[Add]**.
4. Below *API Platform Options*, select **Advocate Hosted (Recommended)** from the drop-down menu.
5. Enter your Tango Card Account information:
   * **Account Identifier** and **Group Identifier**. Refer to  [Tango Card’s help documentation](https://help.rewardsgenius.com/s/article/Find-account-and-customer-identifiers-for-Tango-API) on how to locate these identifiers.
6. Select **Connect** at the bottom of the *Tango Card integration* section to save and connect your account.

### Fund Your Tango Card Account

Both direct accounts and Advocate-managed sub-accounts must be funded before rewards can be issued. Without funding, rewards will not be sent, even if the integration is successfully connected.

To fund your account, follow the instructions from Tango Card on  [How to Fund Your Account](https://help.rewardsgenius.com/s/topic/0TO1U000000Pnk2WAC/payment-options). For further funding questions visit  [Tango Card's Funding FAQ](https://help.rewardsgenius.com/s/article/FundingFAQ).

### Testing Your Tango Card Reward

Whether you’re using a direct or Advocate-managed sub-account, you can test your reward setup using the Tango Card sandbox environment. The sandbox lets you simulate delivery and preview custom emails without spending real currency.

To enable sandbox testing for a direct Tango Card account:

1. In your Advocate account, from the top navigation bar, select ![](/files/UDyrrRTGbHJFFllCZxyw) **\[User profile] →** [**Settings**](https://app.impact.com/secure/advertiser/account-settings-flow.ihtml).
2. In the *Advocate Settings* section, select **Integrations**.
3. Scroll down to the Tango integration and expand the integration view by selecting **+** **\[Add]**.
4. Below *API Platform Options*, select **Advocate Hosted (Recommended)** from the drop-down menu.
5. Enter the sandbox **Account Identifier** and **Group Identifier**. Refer to [Tango Card’s help documentation for work environments](https://developers.tangocard.com/docs/set-up-work-environment).
6. &#x20;![](/files/nF7DY0rLLPpjNDQb5LMS)**\[Toggle on]** the Sandbox account option.
7. Select **Connect** at the bottom of the *Tango Card integration* section to save and connect your account.

To enable sandbox testing of your Advocate-Managed Tango Card Sub-Account please reach out to your Advocate Program Strategy Manager or contact [support](https://app.impact.com/support/portal.ihtml?createTicket=true) for help setting up sandbox access.

You can ![](/files/2t5Z86O6Zq5FIwJNttNP) **\[Toggle off]** sandbox at any time to begin sending live rewards. When testing in the live environment, reduce the reward value to *$0.01* or *$0.05* to avoid unnecessary costs.

### \[Optional] Configure Custom Tango Card Email Templates

Tango Card allows you to send branded, personalized emails along with your gift card rewards. These email templates are identified using an Email Template ID (ETID).

You can apply an ETID when:

* Editing an existing gift card reward
* Creating a new gift card reward in your Advocate reward catalog

{% stepper %}
{% step %}

#### Create Your Email Template in Tango Card

1. Log in to your Tango Card account.
2. Follow  [Tango Card's instructions](https://help.rewardsgenius.com/s/article/HowtoCreateaCustomEmailTemplate) to create an email template.
3. Copy the Email Template ID (ETID) — it should look like: `Exxxxxxx`.
   {% endstep %}

{% step %}

#### Add the ETID in Your Advocate Account

If editing an existing gift card reward:

1. Navigate to your Advocate program.
2. In the left navigation menu, navigate to ![](https://res.cloudinary.com/product-enablement/image/upload/v1768905009/Accessibility%20Icons/engage-v2.svg) **Engage → Program Rules.**
3. Select the rule you want to edit the action of, then select ![](/files/eHosQ7egwdLcFW9kKpVu) **\[Edit action]**.
4. Select **Next**.
5. Paste the ETID into the Custom Tango Card Email Template ID field.
6. Select **Next**.
7. Review your changes and select **Save**.

<div data-with-frame="true"><figure><img src="/files/m2iwF72hiQimlAEaq57I" alt="" width="472"><figcaption></figcaption></figure></div>

If creating a new gift card reward:

1. In the left navigation menu, navigate to ![](https://res.cloudinary.com/product-enablement/image/upload/v1768905009/Accessibility%20Icons/engage-v2.svg) **Engage → Rewards → Catalog** and select **Create Reward**.
2. Enter a clear, descriptive name for the reward (e.g., $20 Advocate Gift Card) so it’s easy to recognize later.
3. Set the *Reward Type* to **Gift Card**.
4. Select the gift card you’d like to offer from the available options, and enter the corresponding reward amount.
5. Paste the ETID into the Custom Tango Card Email Template ID field.
6. Select **Save**.

<div data-with-frame="true"><figure><img src="/files/XwU9xgBu3wflNe7VKUJS" alt="" width="563"><figcaption></figcaption></figure></div>

Once issued, the reward will trigger the custom email linked to that ETID.

**Sandbox vs. Live ETIDs**

If you’re testing in the sandbox environment using an Advocate-managed sub-account, be aware of the following:

* ETIDs are account-specific. Templates created in the live account will not work in the sandbox account.
* If you try to use a live ETID while the integration is connected to the sandbox, the reward will enter a *pending/fulfillment* error state with the error reason: `UNHANDLED_ERROR`.
* The gift card will not be sent until the correct ETID is available or the integration is switched to the live environment.

When testing in the live environment, reduce the reward value to *$0.01* or *$0.05* to avoid unnecessary costs.

Need more guidance? Visit  [Tango Card's Email Templates FAQ](https://help.rewardsgenius.com/s/article/EmailTemplatesFAQ) for tips on template creation and troubleshooting.
{% endstep %}
{% endstepper %}

#### Troubleshooting Tips

<details>

<summary>If you experience issues with your Tango integration, check the following solutions:</summary>

* **Credentials error**: Double-check your Account ID, Group ID, Username, and API Key.
* **No rewards sent**: Ensure your Tango account has sufficient funds.
* **Email not customized**: Confirm that your ETID is correctly entered and active.
* **Integration not saving**: Verify that all required fields are completed.

</details>


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-plugin-integration/tango-card-integration-overview-for-advocate/integrate-with-tango-card-for-advocate-programs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
