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
orGET {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.
Updated 25 days ago