1. Ordering

Using order returns for product returns, refunds, and credits

OrderCloud's order returns feature enables digital return experiences for both customers and administrators. This guide demonstrates various return and refund scenarios using OrderReturns. Review the detailed OrderReturn documentation for complete information.

Example order

Consider this sample order:

  • LineItem 1: 1 qty - Athletic Shoes, size 8.5
  • LineItem 2: 4 qty - Socks
  • LineItem 3: 1 qty - Customized sports jersey (Customer's name printed)
  • LineItem 4: 2 qty - Joggers, size 10

Order breakdown:

LineProductQtyPriceTotalTax
1Athletic Shoes, Size 8.51$75$75$5.54
2Socks4$10$40$3.01
3Customized Sports Jersey1$100$100$7.53
4Joggers, Size 102$50$100$7.53
Shipping$10$10$0.68
Subtotal$315.00
Shipping$10.00
Tax$24.29
Total$349.29

Return scenarios

Standard item return

Customer received items 1, 2, and 3, and requests returns for:

  • Shoes (too small)
  • One pair of socks (excess quantity)

Notes:

  • Item 4 unavailable for return (not shipped)
  • Item 3 unavailable for return (Product.Returnable = False)

Return calculation:

LineProductQty OrderedQty DeliveredReturn QtyPriceRefund (Product + Tax)
1Athletic Shoes111$75$80.54
2Socks441$10$10.75
3Jersey11N/A$100-
4Joggers20N/A$50-
Shipping-$10-
Subtotal$85.00
Tax$6.29
Total$91.29

Example return request:

json
{
  "ID": "order3-return4",
  "OrderID": "order3",
  "RefundAmount": 91.29,
  "ItemsToReturn": [
    {
      "LineItemID": "lineitem1",
      "Quantity": 1,
      "RefundAmount": 80.54,
      "Comments": "Shoes are too small"
    },
    {
      "LineItemID": "lineitem2",
      "Quantity": 1,
      "RefundAmount": 10.75,
      "Comments": "Bought too many"
    }
  ]
}

Shipping refund

For late deliveries, process shipping refunds:

LineProductQty OrderedQty DeliveredReturn QtyPriceRefund
4Joggers22Late delivery$50-
ShippingFull refund$10$10.68
Subtotal$10.00
Tax$0.68
Total$10.68

Example shipping refund request:

json
{
  "ID": "order3-return2",
  "OrderID": "order3",
  "RefundAmount": 10.68,
  "ItemsToReturn": [
    {
      "LineItemID": "lineitem4",
      "Quantity": 2,
      "Comments": "Item arrived late"
    }
  ]
}

Price match refund

For price matching within 2 weeks of purchase:

LineProductQtyPriceCompetitor PriceRefund
4Joggers2$50$45.99$8.02 (2 @ $4.01)

Customer service refund

For general customer satisfaction:

json
{
  "ID": "order3-return3",
  "OrderID": "order3",
  "RefundAmount": 5,
  "Comments": "50% shipping discount due to unsatisfied customer.",
  "ItemsToReturn": []
}

Implementation flexibility

OrderCloud provides flexibility in:

  • Return policies
  • Refund calculations
  • Process workflows
  • Resource customization

Learn more:


If you have suggestions for improving this article, let us know!