When a POS order on Shopify is refunded fully or partially, a Refund object on Shopify is created and if configured, a webhook endpoint will be triggered in Skubana and we will automatically create a RMA for the refunded items sent by Shopify.

⚠️ NOTE: At this time, this webhook is specifically for Shopify POS (retail stores) - not for ecommerce orders.

Shopify Webhook Configuration

⚠️ WARNING: You must first set up both of the Order Payment and Order Creation webhooks. The instructions are listed below as well as in this article link. This is to prevent orders from being brought into Skubana slowly due to having this webhook only.

  • To set up this webhook in Shopify, you first need to go to the Shopify store page and go to Settings. From the settings page, select Notifications
  • Scroll all the way down to the last section which is Webhooks and click on the Create webhook button

Add the Order Payment webhook

Add the Order Creation webhook

Add the Refund Create webhook

  • Click Save webhook when complete and you will see the new entry for Webhooks as well as the signature value that is needed to enter in Skubana. Copy the signature value

Skubana Webhooks Configuration

  1. In Skubana, navigate to the Settings Module, click Sales Channels, select the Shopify sales channel and click the Edit button. From here go to the Connection tab and click Edit Integration.
  2. Select the Enable Webhooks button and paste the signature value into Skubana

Here you can also choose the new option “Restock items from Refund based on Shopify’s restock value”, which will allow Shopify and Skubana to communicate if inventory will be restocked into Skubana.

  • If this setting is enabled AND the return in Shopify has a restock value of true, Skubana will set the action on the RMA as Reinsert.
  • If this setting is enabled AND the return in Shopify has a restock value of false, Skubana will set the action on the RMA as Write Off
  • If this setting is disabled, Skubana ignores the restock value from Shopify and the RMA action will have to be manually selected

To save click “Launch Shopify Authorization” button

Skubana RMA Creation Details

The RMA in Skubana will be automatically created with the below default information from Shopify

  • RMA Number = RMA-REFUND-[order-number]
  • RMA Notes = Created from Shopify Refund Webhook: [refund-reason-from-shopify]
  • Tracking Number = “In Store Return”
  • RMA Type = Refund
  • RMA Reason = Other
  • Loss to Seller = $0.00
  • RMA Item Action = “Reinsert” or “Write Off”
Did this answer your question?