Manage Choice products

At Tango, we offer Choice Products such as Reward Link® (RL), Promo Link (PL), and Disbursement Link (DL):

Reward Link

Reward Link is a web link distributed by your program or organization to your recipients that allows them to make their own gift card selection. Reward link holds monetary value and allows your recipient to spend that balance on a variety of popular gift cards or prepaid cards of their choice. Some links also provide the option to donate all or a portion of their balance to a select number of charities.

Promo Link

Promo Link is a web link sent by your program or organization to your recipients to incentivize your audience with a choice of digital gift cards and reclaim any unredeemed funds.

Promo Link acceptance criteria

The following rules and acceptance criteria applies to Promo Link when placing an order:

  • Set a specific expiration date (such as12/31/24) for a Promo Link at the time of order via Tango API.
  • The expiration date must be at least one (1) day in the future (compared to the order date/time) and should not be longer than 1 year into the future.
  • Specify the timezone, with the timezone specified by (+/-) X hours offset from UTC (see ISO 8601). For example, 2023-10-12T09:18:12.123-07:00 is PDT. If no timezone is specified, it is assumed to be in the timezone the server is set to.

Disbursement Link

Disbursement Link is a web link sent by your program or organization to your recipients to save time on payouts, and your recipients choose how they get paid. With Disbursement Link, your recipients can get money directly.

How to view the Choice products in your catalog

To determine what Choice Products are in your Tango platform's catalog, view the catalog contents of a specific Choice Product, or view the details for a specific Choice product, see our endpoints and instructions below:

Get all available Choice products

Use the GET {URI}/choiceProducts endpoint to get a list of the Choice Products in your Tango platform's catalog:

FunctionPurpose
GET {URI}/choiceProductsGet all available Choice products.

Here are the query parameters for theGET {URI}/choiceProducts\ :

ParameterData typeDescription
rewardNamestringSpecify the reward name to be queried.
currencyCodestringSpecify the currency code to be queried.
countriesarray of stringsSpecify the list of countries to be queried.

TheGET {URI}/choiceProducts payload returns all available Choice Products in your Tango platform's catalog:

{
  "choiceProducts": [
    {
      "utid": "string",
      "rewardName": "string",
      "currencyCode": "string",
      "countries": [
        "string"
      ]
    }
  ]
}

The following payload is an example of Tango Choice products in a platform's catalog:

{
  "choiceProducts": [
    {
      "utid": "U346020",
      "rewardName": "Disbursement Link",
      "currencyCode": "USD",
      "status": "active",
      "countries": [
        "US"
      ],
   },
    {
      "utid": "U088323",
      "rewardName": "Promo Link",
      "currencyCode": "USD",
      "status": "active",
      "countries": [
        "US"
      ]
    },
    {
          "utid": "U561593",
          "rewardName": "Reward Link Preferred + Donations",
          "currencyCode": "USD",
          "status": "active",
          "countries": [
            "US"
          ]
    }
]
}

The possible HTTP response status codes for this endpoint are:

  • 200 OK
  • 400 Bad request
  • 401 Unauthorized
  • 403 Forbidden

Get catalog for a specific Choice product UTID

Use the GET {URI}/choiceProducts/{choiceProductUtid}/catalog endpoint to get the catalog for a specific Choice Product in your Tango platform:

FunctionPurpose
GET {URI}/choiceProducts/{choiceProductUtid}/catalogGet catalog for a specific Choice product utid.

The following path parameter is used forGET {URI}/choiceProducts/{choiceProductUtid}/catalog:

ParameterData typeDescription
choiceProductUtidstringSpecify the reward name to be queried.

The following query parameters are used forGET {URI}/choiceProducts/{choiceProductUtid}/catalog:

ParameterData typeDescription
verbosebooleanWhen true, will return the additional brand fields: status, disclaimer, description, shortDescription, terms, brandRequirements collection, and imageUrls collection.
brandKeystringReturns the brand and item details for a specific brand ID.
brandNamestringReturns the brand and item details for a specific brand name.
utidstringReturns the brand and item details for a specific utid. The utid is the unique identifier for a specific reward.
rewardNamestringReturns the brand and item details of the specified reward name.
statusstringReturns all brands and item details with the specified status. Possible statuses are: Test, Active, Inactive, Deleted.
currencyCodestringReturn all brands and item details associated with a specific currency.
countrystringReturns all brands and item details from a specific country.
fulfillmentTypearray of stringsReturns all brands and item details for a specific fulfillment type: digital and physical.
categoryIdsarray of stringsReturns all brands and item details for specific brand categories. (coming in Q1 of 2024)

The GET {URI}/choiceProducts/{choiceProductUtid}/catalog endpoint payload returns the catalog for a specific Choice Product UTID for when verbose=true.

{
  "catalogName": "string",
  "brands": [
    {
      "brandKey": "string",
      "brandName": "string",
      "disclaimer": "string",
      "description": "string",
      "shortDescription": "string",
      "terms": "string",
      "createdDate": "2023-10-13T19:36:05.393Z",
      "lastUpdateDate": "2023-10-13T19:36:05.393Z",
      "brandRequirements": {
        "displayInstructions": "string",
        "termsAndConditionsInstructions": "string",
        "disclaimerInstructions": "string",
        "alwaysShowDisclaimer": true
      },
      "imageUrls": {
        "additionalProp": "string"
      },
      "status": "string",
      "items": [
        {
          "utid": "string",
          "rewardName": "string",
          "currencyCode": "string",
          "status": "string",
          "valueType": "string",
          "rewardType": "string",
          "isWholeAmountValueRequired": true,
          "exchangeRateRule": "string",
          "minValue": 0,
          "maxValue": 0,
          "faceValue": 0,
          "fee": {
            "type": "string",
            "value": 0
          },
          "createdDate": "2023-10-13T19:36:05.393Z",
          "lastUpdateDate": "2023-10-13T19:36:05.393Z",
          "countries": [
            "string"
          ],
          "credentialTypes": [
            "string"
          ],
          "redemptionInstructions": "string",
          "itemAvailability": {
            "itemAvailabilityStatus": "OPERATIONAL",
            "note": "string",
            "resolutionDate": "2023-10-13T19:36:05.393Z",
            "statusPageUrl": "string",
            "lastModifiedDate": "2023-10-13T19:36:05.393Z"
          },
          "fulfillmentType": "DIGITAL"
        }
      ],
      "categories": [
        {
          "identifier": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "description": "string"
        }
      ]
    }
  ]
}

The GET {URI}/choiceProducts/{choiceProductUtid}/catalog endpoint payload returns the catalog for a specific Choice Product UTID when the verbose=false:

{
  "catalogName": "string",
  "brands": [
    {
      "brandKey": "string",
      "brandName": "string",
      "disclaimer": "string",
      "description": "string",
      "shortDescription": "string",
      "terms": "string",
      "createdDate": "2023-10-13T19:36:05.393Z",
      "lastUpdateDate": "2023-10-13T19:36:05.393Z",
      "brandRequirements": {
        "displayInstructions": "string",
        "termsAndConditionsInstructions": "string",
        "disclaimerInstructions": "string",
        "alwaysShowDisclaimer": true
      },
      "imageUrls": {
        "additionalProp": "string"
      },
      "status": "string",
      "items": [
        {
          "utid": "string",
          "rewardName": "string",
          "currencyCode": "string",
          "status": "string",
          "valueType": "string",
          "rewardType": "string",
          "isWholeAmountValueRequired": true,
          "exchangeRateRule": "string",
          "minValue": 0,
          "maxValue": 0,
          "faceValue": 0,
          "fee": {
            "type": "string",
            "value": 0
          },
          "createdDate": "2023-10-13T19:36:05.393Z",
          "lastUpdateDate": "2023-10-13T19:36:05.393Z",
          "countries": [
            "string"
          ],
          "credentialTypes": [
            "string"
          ],
          "redemptionInstructions": "string",
          "itemAvailability": {
            "itemAvailabilityStatus": "OPERATIONAL",
            "note": "string",
            "resolutionDate": "2023-10-13T19:36:05.393Z",
            "statusPageUrl": "string",
            "lastModifiedDate": "2023-10-13T19:36:05.393Z"
          },
          "fulfillmentType": "DIGITAL"
        }
      ],
      "categories": [
        {
          "identifier": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "description": "string"
        }
      ]
    }
  ]
}

The response message for this endpoint is:

  • 200 OK
  • 400 Bad request
  • 401 Unauthorized
  • 403 Forbidden

Get details for a specific Choice product

Use theGET {URI}/choiceProducts/{utid}endpoint to return the details for a specific Choice Product on your Tango platform:

FunctionPurpose
GET {URI}/choiceProducts/{utid}Get details for a specific Choice Product.

The following path parameter is used forGET {URI}/choiceProducts/{utid}:

ParameterData typeDescription
utidstring(Required) Specify the unique identifier of the Choice Product to be queried.

The GET {URI}/choiceProducts/{utid} endpoint payload returns details for a specific Choice Product on your Tango platform:

{
  "utid": "string",
  "rewardName": "string",
  "currencyCode": "string",
  "countries": [
    "string"
  ]
}

The response message for this endpoint is:

  • 200 OK
  • 400 Bad request
  • 401 Unauthorized
  • 403 Forbidden