Marketplace Return Management feature overview

Edit on GitHub

Marketplace Return Management feature lets you create and manage returns for a merchant order in a Spryker Marketplace Demo Shop.

Once an order has been shipped, the registered buyer or a Back Office user can initiate a return of the whole marketplace order or its individual items. For information about what items can be returned, see Returnable items and a return policy. For information about how a Back Office user can create returns, see Managing marketplace orders.


You can also create and manage returns via Glue API. For details, see Managing the returns.

Marketplace return items states

The return items can have the following states in the Marketplace Order Management System (Marketplace OMS):

  • Waiting for return: a buyer created a return, but a merchant user has not confirmed it in the Merchant Portal yet.
  • Returned: the return has been received and confirmed by the merchant user.
  • Refunded: A merchant user has made a refund for the returned items.
  • Return Canceled: the return has been canceled by a merchant user because of the return policy or for any other reason.
  • Shipped to customer: the canceled return has been shipped back to the buyer.
  • Delivered: the buyer has received the shipped return.

The relation of the sales order items statuses and the return states is as follows:


Marketplace return slip

Buyers and Back Office users (Marketplace administrator and main merchant) can have a paper version of the return by printing the automatically generated return slip. The return slip contains:

  • The return and marketplace sales order references.
  • Details about the returnable marketplace sales order items.
  • A barcode generated based on the return reference.


Marketplace Return Management on the Storefront

The registered buyers can return entire orders or individual merchant order items as soon as they have been delivered to them. When returning, the buyers can select or enter a return reason.

The guest users can not initiate returns of their orders, as the return management is done via the Customer Account on the Storefront. Returns of the guest orders can be initiated only via the Back Office by the Back Office user.


One return can include products only from one merchant.

Once a return request has been submitted, it acquires the Waiting for return state. The return states change as the merchant processes the return. For details about the return states, see Return items states.

All the returns created by the buyer or by the Back Office user for the buyer are listed on the Returns page in the Customer Account. From here, the buyer can view the return details and print the return slip.

The following figure shows how to create a return, view its details, and print a slip:


Marketplace Return Management in the Back Office

A Back Office user can create returns for the returnable items from the order details page of the Back Office. For details, see Back Office user guide: Managing orders. Also, a Back Office user can view returns, close fulfilled returns, print a return slip, and cancel returns.

Marketplace Return Management in the Merchant Portal

Merchants process their returns in the Merchant Portal. For details about how to manage the merchant returns, see Merchant Portal guide: Managing merchant orders .

Managing merchant returns Managing marketplace returns
Managing main merchant returns
Install the Marketplace Return Management feature Managing the returns
Install the Marketplace Return Management Glue API