API: Refund Order

POST /api/marketplace/v2/orders/{kogan_order_ref}/refund/

Specification

Marks the specified shipped items of the specified order as cancelled.

📘

NOTE

When refunding an order, the customer will receive a refund for the item(s) amount + shipping (if any) and a notification containing the reason.

URL Parameters

ParameterRequiredDescription
kogan_order_refYesThe Id of the order to refund

Request Format

See below a list of the fields and description for the order’s cancellation

ParameterRequiredDescription
IDYesOrder Id
QuantityYesThe number of units to refund.
The quantity needs to match the order’s line quantity as we do not accept partial refund.
ReasonYesThe reason the item is being refunded.
See the values allowed below
SellerSkuYesThe SKU of the ordered line item.

Reasons

This is a list with all the refund reason allowed (refer to the field Reason)

  • Change of Mind
  • Dead Arrival
  • Failed Cancel
  • Listing Error
  • Part Problem
  • Return Sender
  • Wrong Goods
  • Faulty Item
  • Damage In Transit
  • Faulty Part

Request Body Example

{
  "OrderID": "123456",
  "Items": [
    {
      "ID": "0",
      "SellerSku": "XX-Valyrian-steel-SWORD-1",
      "Quantity": 1,
      "Reason":"Dead Arrival"
    },
    {
      "ID": "1",
      "SellerSku": "XX-DRAGON-STONE",
      "Quantity": 4,
      "Reason": "Return Sender"
    }
  ]
}