This endpoint is used when the customer refunds an order in Linnworks.net.

Request

POST

`OrderRefundRequest`

Field Name	Type	Description
AuthorizationToken	`String`	Authorization Token from the customers integration.
Refund	`OrderRefund`	Information about the order/items to refund. See OrderRefund

`OrderRefund`

Field Name	Type	Description
Items	`OrderRefundItem[]`	A collection of order items to refund on the marketplace. See OrderRefundItem
ReferenceNumber	`String`	The order reference number within Linnworks.
ExternalReference	`String`	The external reference number within Linnworks. This is usually the marketplace reference.
RefundShippingAmount	`Decimal`	The amount to refund for shipping.

`OrderRefundItem`

Field Name	Type	Description
SKU	`String`	The unique Linnworks SKU of the item.
OrderLineNumber	`String`	The order item number for this item. This is usually the marketplace ID for the order item.
RefundAmount	`Decimal`	The amount to submit as a refund for this item.
Reason	`String`	If the marketplace supports tag-based refund reasons, this field will contain the selected tag. Otherwise, it will include the freetext reason submitted by the customer.
SecondaryReason	`String`	If the marketplace supports tag-based refund reasons, this field will contain the selected sub-tag.

Sample

{
  "AuthorizationToken": "0dfdbaf3e4d5434f825e774e31bcc148",
  "Refund": {
    "ReferenceNumber": "XYZ-1",
    "ExternalReference": "EXT-XYZ-1",
    "RefundShippingAmount": 0,
    "Items": [
      {
        "OrderLineNumber": "010045",
        "SKU": "ITEM-001",
        "RefundAmount": 49.99,
        "Reason": "Broken",
        "SecondaryReason": ""
      }
    ]
  }
}

Response

`OrderRefundResponse`

Field Name	Type	Description
RefundReference Required	`String`	Returns the created refund reference from the marketplace.
Error	`String`	Defines if there was an error with the request and returns it.

Sample

{
  "RefundReference": "REF-001"
}

{
  "Error": "Could not process refund.",
  "RefundReference": "REF-001"
}