Manage line items
Each line item represents a single gift card, reward, disbursement, or promotional link. A line item includes unique information about a single-issued reward, such as the reward brand, reward unique ID, and reward value. It can also include recipient information, such as first name, last name, and email address, where applicable.
Each line item can be managed separately when a request fails due to an undeliverable email, a misspelled recipient's name, etc. An Order may have one or more line items.
Note:
Orders and line items include sensitive information such as Personally Identifiable Information (PII). PII must be used for internal logging and support only. To protect your users, do not reveal the orders and rewards sensitive information to any other user except the reward recipient.
Line item status
The following line item statuses in an order are available in Tango API:
| Line Item status | Description |
|---|---|
| Complete | The rewards that have been successfully provisioned by Tango. The line item email has been successfully sent to the recipient's email address and we've received confirmation from the recipient's email server that the email is received. If you have selected "sendEmail": false no email is sent to the recipient.Only digital rewards will show as Delivered. For Printed Reward Links, it means the line item has been mailed and will be received by the recipient in 7–10 business days. |
| Pending | The rewards will be processed and delivered within one (1) business day/ on the following business day. Once delivered, the order status changes to Complete. |
| Failed | The line item has failed to be sent due to a potential error. See Orders and Reports FAQ .You are refunded for the reward’s value. We recommend placing a new order to ensure your reward is still sent. For more information on brand outages and deprecation see our Tango Rewards Status page, or email [email protected]. Make sure to include the Reference Order ID of your failed order. |
| Canceled | The line item has been canceled and cannot be resent to the recipient. The funds have also been refunded for this line item. Place a new order if needed. |
Note:
You must set the
sendEmailproperty value to true for recipients to receive emails. If the property value is set to false, no email will be sent to the recipient. See Email status with Tango.
Email status
The following email statuses are available in Tango API:
| Email status | Description |
|---|---|
| Delivered | The email is delivered. The email is sent if sendEmail= true. |
| Not delivered | The email is not delivered. An email is not sent if sendEmail=false, so the reward can’t be re-sent either since there is no original email to resend. We suggest requesting a different email address from the recipient to which you can resend the reward. You can Resend a reward email to a new email address for the same recipient. See Resend a specific order for rules and exceptions. |
| Pending | Our email server has attempted to deliver the reward email. If an order is showing Processed as its most recent status, wait a few minutes and check again for a Delivered or Not Delivered status. |
| Sent | The reward email is sent successfully to the recipient's email address. The email may have arrived in the recipient’s mailbox, but we haven't received confirmation from the recipient's email server that the email is received. |
| Deferred | The reward email cannot be delivered immediately, and it hasn’t been completely rejected. We will continue to try for 72 hours to deliver a deferred message. |
| Dropped | We were unable to deliver to this recipient. Resend reward email to an alternative email address. See Resend a specific order for rules and exceptions. |
| Bounced | The recipient's email server cannot deliver the email to the email address entered. Use Resend to send it to a new email address for the same recipient. See Resend a specific order for rules and exceptions. |
| Blocked | The email is blocked by an Internet Service Provider (ISP) or messaging organization. We recommend trying the following troubleshooting techniques before resending the reward email: - Make sure recipient has [[email protected]] added to safelist for their email account where they receive the rewards. - Update your email template to avoid use of spam language in the email subjects or excessive use of punctuation like ($$!!) and resend the reward email. |
Updated 9 days ago