Events
The Returns portal events can be used as triggers to automatically send certain notifications when a specific event happens, such as when a request is approved or a shipment is received.Returns Events
Supported return events include:| Pending Approval - The return request is pending approval on the Returns portal. Request Approved - The return request has been approved. Request Rejected - The return request has been rejected. Request Canceled - The return request has been canceled. Request Reopened - The return request was canceled and has been reopened. | Order Canceled - The order has been canceled. Shipment Received - The return shipment has been received. Shipment In-Transit - The return shipment is on its way. Manual Credit - Store credit has been issued to the customer. Manual Gift Card - A gift card has been issued to the customer. |
|---|
Tracking Events
Supported tracking events include:| Order In transit - Order is in transit. Order waiting for pickup - Order is waiting for pickup. Order out for delivery - Order is out for delivery. | Order ready for collection - Order is ready for collection. Order delivered - Order was delivered. Order failure to deliver - Order failed to deliver. |
|---|
Variables
Adding variables to your notifications personalizes the information provided, such as adding the RMA ID or reject reason directly into the message.Returns Variables
rma_id | The ID number of the customer’s return request. |
|---|---|
payment_authorization_expiration_date | Date of charge of authorized amount. |
rma_created_at | RMA created date. |
rma_status | The status of the return request. |
order_name | The ID number of the customer’s order. |
first_name | The customer’s first name. |
last_name | The customer’s last name. |
full_name | The customer’s full name. |
store_name | The name of your online store. |
store_url | The link to your online store. |
reject_reason | The reason the return request was rejected. |
cancel_reason | The reason the return request was canceled. |
expire | The remaining time before a gift card or store credit expires. |
credits | The amount of store credit the customer has in their balance. |
payment_currency_code | The currency used to pay for the order. |
customer_support_url | The link for contacting your customer support. |
carrier_location_name | The name of the drop-off location. |
refund_provider | The entity that issues the refund. |
tracking_number | The number used to track the return shipment. |
tracking_link | Shipment tracking URL. |
expected_delivery_date | The date the delivery is expected to arrive. |
shipping_date | The date the shipping label was created. |
return_label_url | Shipping label URL. |
packing_slip_url | Packing slip URL. |
qr_code_link | QR code URL. |
return_method | Return method name (internal). |
return_type | Return type (Return / Exchange / Mixed). |
gift_card_code | Generated gift card code, when applicable. |
portal_name | The name of the relevant portal, as it appears in the portal selector. |
Tracking Variables
order_name | The ID number of the customer’s order. |
|---|---|
first_name | The customer’s first name. |
last_name | The customer’s last name. |
full_name | The customer’s full name. |
store_name | The name of your online store. |
store_url | The link to your online store. |
customer_support_url | The link for contacting your customer support. |
order_tracking_number | Order tracking number. |
portal_tracking_url | Portal tracking URL. |
unsubscribe_link | Tracking unsubscribe link. |
status_description | Description of the main tracking status sub-status. |
estimated_delivery_date | Order estimated delivery date. |
carrier_name | Carrier for this delivery. |

