---
title: "Refund an order"
method: POST
path: "/api/v1/orders/{purchase_id}/refund/"
tags: ["Orders"]
---

# Refund an order

`POST /api/v1/orders/{purchase_id}/refund/`

## Request

- Base URL: `https://partnerapi-staging.depop.com`
- URL: `https://partnerapi-staging.depop.com/api/v1/orders/{purchase_id}/refund/`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/depop/apis/seller-api/docs/api/v1/orders/:purchase_id/refund/post.ts> (a function with typed inputs; its response is checked against the schema)

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).

## Path parameters

- `purchase_id` string, required

## Request body

- RefundOrderRequest
  - `send_buyer_message` string: The message to send to the buyer when processing the refund. This is optional but recommended.
  - `items_refund_amount` string: 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_amount` string: 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.

## Response `200`

Successful operation, no content returned

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden - Insufficient scope
- `422`: Unprocessable Entity

---

[API](https://skmtc.dev/depop/apis/seller-api.md) - [All operations](https://skmtc.dev/depop/apis/seller-api/llms.txt) - [OpenAPI document](https://skmtc.dev/depop/apis/seller-api/revisions/56fef8e38e44?raw)