Resend a specific order

Did your recipient accidentally delete or misplace their reward email? They may have mistaken it for spam or perhaps they don’t have access to that email address anymore. Tango portal allows you to resend an email to the recipient using POST /orders/{referenceOrderID}/resends. Resending a reward doesn't mean you're placing a new order, but simply resending the original reward email. There are no additional fees associated with resending a reward.

📘

Note:

• You can resend an order to a new email address, but has to be the same recipient.
• You must have the original order number to resend an order. The Tango order history call allows searching past orders. The order number is included in the order result.
• Resend orders once every 30 seconds. The error message timestamp notifies you if a second attempt has been made less than 30 seconds following the last send.
• Retrieve delivered rewards using GET {URI}/orders/{referenceOrderId} if you've delivered the reward credentials directly to your recipients, or if you don't wish Tango to deliver them.

To resend an order via mail, you must set the sendEmail=true. Tango will send the original email. If sendEmail has been set to false, it indicates that you have never sent the original email, therefore, cannot resend it.

🚧

Coming soon:

This endpoint will soon be modified to allow resending a specific order via SMS using deliveryMethod and newPhoneNumber as body parameters:

• If both newEmail and newPhoneNumber are submitted (not NULL) you can update both email and phone number but resend your reward based on deliveryMethod.
• If an original order was sent using EMAIL , you can resend withSMS, and vice versa.
• If deliveryMethod=NONE , you can update the existing email and phone number, but cannot resend the message.
• If your original order had not used Tango for delivery (deliveryMethod=NONE), you can resend the order using Tango (deliveryMethod=EMAIL or deliveryMethod=SMS).
• If deliveryMethod is NULL, you can use the original order’s deliveryMethod or sendEmail value.

👍

Best practice:

If you need to verify reward information for a given order, consider getting information on a list of orders GET {URI}/orders instead of resending the reward email using this endpoint.

Resending an email does not guarantee its delivery. If the recipient does not receive an email due to spam filter settings, corporate firewalls, etc. resending an email may not be enough. The underlying problem must be determined and resolved.

The resend endpoint allows you to resend reward emails to the original recipient on demand. Use the following endpoint to resend a specific order:

The following path parameter is used to identify the order to resend:

The following body parameters are available for resending orders with this endpoint:

The following payload example shows an order is being resent using POST {URI}/orders/{referenceOrderID}/resends.

{
  "id": 0,
  "legacyId": "string",
  "createdAt": "2024-03-25T22:46:39.922Z",
  "email": "string"
}

The possible response codes for this endpoint are as follows. For details, see i18nkey codes and their error messages:

• 201 Created
• 400 Bad Request
• 401 Unauthorized
• 403 Forbidden