Tango API suggested flow

Below is a typical workflow to help get you started with Tango API:

Step 1: Manage customers (groups)

Perform POST {URI}/customers to create a Group. The customerIdentifier must be lowercase and 5-100 characters. See our instructions and examples in Manage customers (groups) for more details.

Step 2: Manage accounts

Accounts are located under groups. Groups (customers) are the second level under a platform. See more information about accounts in Mange accounts

Step 3: Fund your account

Follow the instructions below to fund your account. For details, see how to fund your Account.

• Fund your account: Perform POST {URI}/creditCardDeposits to fund your account.
• Check balance: Perform GET {URI}/accounts to confirm the funding of your account and view your balance.
• For Wire Transfers, ACH Deposits, or POs login to the Tango Portal or contact your CSM.

Step 4: Get catalog information to display in your application

Perform GET {URI}/catalogs to view items in your platform’s catalog and see what you can order. For details, see View catalog.

Step 5: Place and manage orders

Place an order, get a list of placed orders, get details for a specific order, or resend an undelivered order. For details, see Manage order.

• Create an order: Perform POST {URI}/orders to order one of the UTIDs that was returned in your GET catalog call.
• Check balance: Perform GET {URI}/accounts or GET {URI}/accounts/{accountName} to see the adjusted balance of your account following the order.
• Retrieve an order: Perform GET {URI}/orders/{referenceOrderID} to view the details of an order you have already sent in the past.
• Resend an order: Perform POST {URI}/orders/{referenceOrderID}/resends to resend a previous-sent order.

Step 6: Manage line items

Perform GET {URI} /lineItems to retrieve a list of line items ordered. For details, see Manage line Items.

• Retrieve details of a specific line item: Perform GET {URI} /lineItems/{referenceLineItemID} to retrieve the details such as reward credentials of a specific line item and the redemption history. For the real-time balance of the reward, subtract the redemption history from the total amount issued.
• Resend a line item: Perform POST {URI}/ lineItems/{referenceLineItemId}/resends to resend a specific line item to the same email address. The identification of the line item you requested will be resent. The system autogenerates it, and you can find it by using the line Item endpoint.

For our recommendations and best practices, see our Best practices.