---
title: "Partial Refund"
method: POST
path: "/api/refund"
tags: ["Automation Endpoints"]
---

# Partial Refund

`POST /api/refund`

Mark a previously submitted order as refunded. This can be a full or partial refund.

This endpoint is used when an order is refunded after submission.

## Headers

- `x-riskified-shop-domain` string, required
- `x-riskified-hmac-sha256` string, required
- `content_type` 'application/json', required
- `accept` 'application/vnd.riskified.com; version=2', required

## Request body

- RefundOrderWrapper
  - `order` Refund, required
    - `id` string, required — The unique identifier of the order to refund.
    - `refunds` RefundDetails[], required — A list of partial refunds for the order.
      - `refund_id` string, required — Unique identifier for this refund.
      - `sku` string — A unique identifier of the item in the refund.
      - `refunded_at` string, date-time — When (ISO8601) the refund was issued to the customer.
      - `amount` number, float, required — Total amount of refund, specified as a positive number.
      - `currency` string, required — The 3-letter code (ISO 4217) for the currency used for the payment. Defaults to USD.
      - `reason` string — Text note detailing the reason this refund was issued.
      - `sku_quantity` integer — Integer representing number of items returned of a specific SKU.

## Response `200`

Successful operation

- RefundResponse — Refund Response
  - `order` object
    - `id` string, required — Unique ID of order being acted upon. Note: This value should be later reflected also as order.id on the subsequent calls
    - `status` 'approved', required — Textual status describing the result of Riskified analysis. Always 'approve' for approved orders. Order is approved and guaranteed by Riskified
    - `description` string, required — Additional context on Riskified decision.
    - `old_status` string, required — Old order status

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found
- `429` — Too many requests
- `500` — Contact Riskified support
- `504` — Temporary error, please retry

---

[API](https://skmtc.dev/riskified/apis/chargeback-guarantee.md) · [All operations](https://skmtc.dev/riskified/apis/chargeback-guarantee/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/riskified/chargeback-guarantee/revisions/2b7df5bce861/schema)