---
title: "Fail a transaction delivery."
method: POST
path: "/transactions/{transactionId}/deliveries/{deliveryId}/fail"
tags: ["Transaction"]
---

# Fail a transaction delivery.

`POST /transactions/{transactionId}/deliveries/{deliveryId}/fail`

## Request

- Base URL: `https://api.orderful.com`
- URL: `https://api.orderful.com/transactions/{transactionId}/deliveries/{deliveryId}/fail`
- Auth: API key in header `orderful-api-key`
- TypeScript: <https://skmtc.dev/orderful/apis/orderful-api/docs/transactions/:transactionId/deliveries/:deliveryId/fail/post.ts> (a function with typed inputs; its response is checked against the schema)

Fails the specified transaction delivery.

**Do not build this URL yourself.** POST to the `delivery.fail.href` included with every Transaction retrieved from a <a href="https://docs.orderful.com/reference/inboxcontroller_list" target="_blank">Inbox</a> or delivered via an <a href="https://docs.orderful.com/docs/inbound-http" target="_blank">Inbound HTTP Communication Channel</a>. The numeric transaction ID that appears in this path is deprecated and will be removed in an upcoming release; the `href` will keep working.

If this Delivery is the most recent one associated with a Transaction, this will update the Transaction's `deliveryStatus` to `FAILED`.

If this Delivery is associated with one or more Transactions in an inbox, this will also remove the Transactions from that inbox.

## Path parameters

- `transactionId` number, required
- `deliveryId` string, required

## Headers

- `orderful-api-version` string

## Request body

- FailTransactionDeliveryRequestV4Dto
  - `note` string, required: Additional information about the failure.

## Response `200`

Transaction marked as failed.

---

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