DEdepop
Orders

Refund an order

This endpoint allows you to refund an order and send a message to the buyer. Required OAuth Scope: orders_write

A refund can be a full refund or a partial refund by specifying the amount to refund on items and/or shipping within the order.

Important note about shipping refunds with Depop shipping:

  • For orders using Depop shipping (where a Depop shipping label was used), shipping can only be refunded as part of a full refund. You cannot do a partial refund that includes shipping costs for these orders.
  • For orders with manual shipping, shipping can be refunded with either full or partial refunds.
  • To determine if an order uses Depop shipping, check if the depop_shipping field is present in the order response.

The order will be marked as refunded and the buyer will be notified. If a message is provided, it will be sent to the buyer directly in Depop chat.

The order will still be visible in your orders but marked as REFUNDED.

All fees will automatically be calculated and refunded to the buyer and the seller (partner).

post/api/v1/orders/{purchase_id}/refund/

Request

Path parameters

purchase_idstring required

The purchase ID of the order.

Request body

send_buyer_messagestring

The message to send to the buyer when processing the refund. This is optional but recommended.

items_refund_amountstring

The amount to refund on the items in the order. Must be less than or equal to the total amount paid by the buyer.

shipping_refund_amountstring

The amount to refund on the shipping in the order. Must be less than or equal to the shipping price (buyer or seller paid).

Important: For orders with Depop shipping (where depop_shipping is present), shipping can only be refunded as part of a full refund. Partial refunds cannot include shipping for these orders.

For orders with manual shipping, shipping can be refunded with either full or partial refunds.

Example request

{
  "send_buyer_message": "Sorry for the inconvenience, we have processed your refund.",
  "items_refund_amount": "50.99",
  "shipping_refund_amount": "4.99"
}

Response

Successful operation, no content returned

Changes

No recorded changes to this operation across all 1 revision of this API.