Resend a specific order

Use the following endpoint to resend a specific order.

EndpointPurpose
POST {URI}/orders/{referenceOrderID}/resendsResend a specific Order.

Here is the path parameter when you use thePOST {URI}/orders/{referenceOrderID}/resends to resend a specific order:

Path parameterData typeDescription
referenceOrderIDstring(Required) Reference Order ID is returned in the Order response payload. (path parameter)

The following body parameters are used when you use POST {URI}/orders/{referenceOrderID}/resends to resend a specific order:

Body parameterData typeDescription
newEmailstringA new email to resend this Order to. (body parameter)
newEtidstringA new etid for resending an order. Etid is the unique identifier for the email template you would like to use. The default Email Template ID is E000000.

The Resend method allows you to resend reward emails to the original recipient on demand. This may be useful if a recipient reports that they never received the reward email or cannot find it.

The following example shows a past order is resent using POST {URI}/orders/{referenceOrderID}/resends.

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

The response message for this endpoint is:

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

To send the target order (resent), you must set the sendEmail property value to true (default) which means Tango has sent the original email. If the property value is set to false, it indicates that we have never sent the original email, therefore, we cannot resend it.

πŸ“˜

Note:

  • Orders can be resent once every 30 seconds. The error message timestamp notifies you if a second attempt is made less than 30 seconds following the last send.
  • Resends of orders placed via the Tango API v1 are handled in the same fashion as resends of Orders placed via the Tango API v2. Only orders where Tango sent the original email can be resent by Tango . If you delivered reward credentials directly to your recipients, you need to retrieve them again via the GET {URI}/orders/{referenceOrderId} call.

You need the original order number to perform the resend. The Tango order History call allows searching past orders. The order number is included in the order result.

πŸ“˜

Note:

  • Orders can be resent to a new email address, but to the same recipient. A reward links is tied to the same email address.
  • If an administrator needs to verify reward information for a given order, consider using the Get order Information call instead of the Resend a Reward Email call.

Resending an email does not guarantee 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.


Rewards as a Service™ and the RaaS® API are provided by Tango Card, Inc. © 2024 Tango Card, Inc.