Tango API has numerous endpoints to help you perform a variety of activities in your Tango platform. See the list of endpoints below. For detailed information and use cases, refer to their related article in this guide.

📘

Notes:

• Tango API v2 is a RESTful JSON API.
• Tango API authentication is handled via HTTP Basic Auth or OAuth 2.0
• Sandbox URI: https://integration-api.tangocard.com/raas/v2
• Production URI: https://api.tangocard.com/raas/v2

Customers

Use the following endpoints to create and view customers (groups) on the platform. You can manage customers (groups) on your platform. A group is a collection of accounts to hold funds and place orders.

For details, refer to our document on Manage customers.

Low balance alerts

Use the following endpoints to set , view, update and delete low balance alerts:

For details, refer to our document on Manage low balance alerts.

Accounts

Use the following endpoints to get detailed information, such as balance, for the accounts in your platform. Accounts are nested within groups in Tango and they contain funds.

For details, refer to our document on Manage accounts.

Fund

Use the following endpoints to register, fund, and un-register credit cards. Funds are needed to send rewards to the recipients.

For details, refer to our document on Fund your account.

Get exchange rates

Use the following endpoint for exchange rates:

For details, refer to our document Get exchange rates.

Manage catalog

Use the following endpoint to get catalog items:

For details, refer to our document in Manage catalog.

Manage Choice products

Use the following endpoint to manage Choice Products such as: Reward Link® (RL), Promo Link ™(PL), and Disbursement Link (DL).

For details, refer to our document Manage Choice products.

Get brand categories

Use the following endpoint to filter a catalog by category such as grocery, beauty, health and wellness, etc. Categories have a Universal Unique Identifier (UUID).

For details, refer to our document Get brand categories.

Manage countries and currencies

Use the following endpoints to get a list of countries and their preferred currency:

For details, refer to our document Manage countries and currencies.

Manage digital templates

Use the following endpoints to create, view, update and delete digital templates for reward delivery.

For details, refer to our document on Manage digital templates.

Manage orders

Use the following endpoints to create, view, and resend orders.

For details. refer to our document on Manage orders.

Manage line items

Orders consist of one or more line items. Each line item represents a single gift card, reward, disbursement, or promotional link and has its unique reference number, customer's first name, last name, email address, dollar amount, etc. Each line item can be managed separately when a request fails due to an undeliverable email or a misspelled recipient's name, for example.

Use the following endpoints to page through or filter a list of line items, including their non-sensitive details and reward status. You can also view details for a specific line item, including sensitive details, reward history, reward redemption, or resend a specific line item.

For details, refer to our document on Manage line items.

Credential types

Use GET {URI}/credentialtypes to get a list of credential types. There is no parameters for this endpoint.

For details, refer to our document on Get credential types.

Webhooks

We support webhooks in or API. Check out Webhook endpoints for the latest.

Error messages

See Tango Response classes and error messages for more information.