---
title: "Create an order adjustment"
method: POST
path: "/v4/orders/{orderId}/adjustments"
tags: ["Orders"]
---

# Create an order adjustment

`POST /v4/orders/{orderId}/adjustments`

Create an adjustment (eg. refund) for an order.

## Path parameters

- `orderId` string, required

## Request body

- CreateOrderAdjustmentV4RequestDto
  - `type` 'refund', required — The type of adjustment
  - `externalId` string — The partner assigned Order Adjustment external ID
  - `refund` CreateOrderAdjustmentRefundV4RequestDto
    - `amount` number, required — The amount to refund in cents
    - `payoutAccountId` string — The payout account ID to reverse the payout from, if the payout has been sent. If not provided, the payout account set when finalizing the order will be used.

## Response `201`

The created adjustment

- OrderAdjustmentV4ResponseDto
  - `id` string, required — The adjustment ID
  - `createdAt` string, date-time, required — When the adjustment was created
  - `type` 'refund' | 'dispute', required — The type of adjustment
  - `orderId` string, required — The Slope assigned order ID this adjustment is for
  - `externalOrderId` string — The partner external order ID this adjustment is for
  - `externalId` string — The partner external order adjustment ID
  - `status` 'pending' | 'succeeded' | 'failed', required — The status of the adjustment
  - `refund` OrderAdjustmentRefundV4ResponseDto
    - `amount` number, required — The refunded amount, in cents
    - `merchantFee` number, required — The reversed merchant fee, in cents
    - `payoutAccountId` string — The payout account ID the adjustment was sent to if one was set

## Other responses

- `400` — Bad Request - Invalid request format or validation errors
- `404` — Not Found - The requested resource was not found
- `422` — Unprocessable Entity - Request validation failed
- `500` — Internal Server Error - An unexpected error occurred

---

[API](https://skmtc.net/slopepay/apis/slope-v4-api.md) · [All operations](https://skmtc.net/slopepay/apis/slope-v4-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/slopepay/slope-v4-api/revisions/cbdbc861073b/schema)