​
Amazon Orders

The returnOrder mutation can be used to initiate a return for an Amazon order.

After calling the endpoint developers can listen to webhook events to get updates on the return status and shipping label data. The shipping label url can be found on the RETURN_APPROVED webhook event. Give this url to the shopper to allow them to return the item. You can also query the returns field in orderByID query to see the status of all the returns for an order. More on Return Webhooks.

​
Shopify Orders

  • Sync API Customer’s email is used for Shopify orders, they should receive the Shopify order number and can work directly with the Shopify store for returns. Once the return is processed by the Shopify store, one of the following will happen depending on your account type:
    • Free Accounts
      • Rye will refund the customer and close out the order request.
    • Custom Accounts
      • Rye will refund the customer and close out the order request.
      • The order will appear on your next invoice as a credit.

Rye will fire webhooks during the lifecycle of a return. You can read more what the payloads look like for each stage of returns on Webhooks updates section.

  • Sell Anything API

If you are using a mix of Sell Anything and Sync API products it is recommended to use a single email for all orders otherwise you will not know when a shopper requests a return which means Rye would not be able to intiate a refund to the shopper. Make sure the email is a persons email ie john.doe@rye.com and not a group email ie orders@rye.com. Using a group email could trigger a fraud detector in Shopify and cause your order to fail. If you signed up with Rye using a group email you can contact us via Slack or email support@rye.com and we can setup an email that would be forwarded to your group email.

Assuming you have created a mechanism for customers to request a return from your storefront or website, you will need to take the following steps before Rye can refund the shopper:

  1. Developer will send the return request to the merchant.
  2. Once the request for return has been accepted or denied the developer will need to forward the information to the end shopper.
    • This includes any shipping information or labels that the shopper will need to return the item.
  3. Once the return has been completed, the developer should forward the information to Rye to process the refund.

After the steps above are completed, one of the following will happen depending on your account type:

  • Free Accounts
    • Rye will refund the customer and close out the order request.
  • Custom Accounts
    • Rye will refund the customer and close out the order request.
    • The order will appear on your next invoice as a credit.

Was this page helpful?

RefundsMarkups