---
title: "Decline an order"
method: POST
path: "/provider/orders/{id}/decline"
tags: ["Provider"]
---

# Decline an order

`POST /provider/orders/{id}/decline`

## Request

- Base URL: `https://api.paycrest.io/v2`
- URL: `https://api.paycrest.io/v2/provider/orders/{id}/decline`
- Auth: API key in header `API-Key`

Provider declines an assigned order. The aggregator will reassign it to another provider.
A duplicate `reason` declines the order without reassignment; see `reason` below.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `timestamp` integer: Unix timestamp in seconds
  - `reason` string: Optional. Omit it (or send no body) for a normal decline, which reassigns the order. `duplicate_gateway_order:<holdingOrderId>` (another Paycrest order already holds the same on-chain order) or `duplicate_reference:<holdingOrderId>`, where `<holdingOrderId>` is the UUID of that other order, tells the aggregator you will not pay out because the order is a duplicate. The order is then cancelled and not reassigned, but only if the aggregator can confirm the claim: the holding order must be a different order with the same on-chain order and token, or the on-chain order must already be fulfilled or refunded. A reason without a valid holding order id is never confirmed. An unconfirmed claim is handled as an ordinary decline. The Paycrest provider node sends these reasons automatically.

## Response `200`

Order declined

- StandardResponse
  - `status` string
  - `message` string
  - `data` object: The actual response data (e.g., ReceiveAddressResponse, etc.)

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `404`: Order not found

## Changes

- **2026-11-03** `b2558cacb755`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/paycrest/apis/paycrest-aggregator-api/changes/provider/orders/:id/decline/post.md)

---

[API](https://skmtc.dev/paycrest/apis/paycrest-aggregator-api.md) - [All operations](https://skmtc.dev/paycrest/apis/paycrest-aggregator-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paycrest/apis/paycrest-aggregator-api/revisions/b2558cacb755?raw)