---
title: "Cancel BACS inbound transaction [beta]"
method: POST
path: "/v1/payments/bacs/directcredit/cancel/{id}"
tags: ["BACS"]
---

# Cancel BACS inbound transaction \[beta\]

`POST /v1/payments/bacs/directcredit/cancel/{id}`

## Request

- Base URL: `https://sandbox.pismolabs.io/passport`
- URL: `https://sandbox.pismolabs.io/passport/v1/payments/bacs/directcredit/cancel/{id}`
- Auth: none declared. Required headers: `Authorization`, `x-tenant`

Cancel a suspended transaction, which was kept on hold based on client's anti-fraud (AF) provider analysis, and return the transaction.

**Suspense transaction flow**

You can use the suspense transaction flow to manage incoming BACS transactions that have been temporarily placed on hold due to suspected fraud pending a decision from the client's anti-fraud (AF) provider.

**Supported scenarios:**

  * An incoming (cash-in) BACS transaction is received.

  * Client' s anti-fraud provider returns "hold" instead of approve or reject.

  * Pismo places the transaction amount into additional fund (unavailable balance) so the beneficiary cannot use the funds until a final decision is made.

  * The client later calls Pismo's [release](https://developers.pismo.io/pismo-docs/reference/post-release-bacs-1) or cancel endpoints to finalize the transaction.

This endpoint generates a [BACS direct credit inbound payment processed](https://developers.pismo.io/events/docs/bacs-direct-credit-in-status-change-1) event with `status` = `CANCELLED`.

## Path parameters

- `id` string, required

## Headers

- `Authorization` string, required
- `x-tenant` string, required
- `x-cid` string

## Response `200`

Response Body

- BacsCancelBacsCancelResponse
  - `id` string: Client-generated transaction identifier. This is the idempotency key UUID passed in the [Send direct credit outbound payment](https://developers.pismo.io/pismo-docs/reference/post-create-bacs) endpoint.
  - `status` 'CANCELLED': - `CANCELLED` - Something went wrong and the transaction was cancelled. Refer to `reason` for details,

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `429`: Too Many Requests
- `500`: Internal Server Error
- `502`: Bad Gateway

---

[API](https://skmtc.dev/pismo/apis/platform-authentication.md) - [All operations](https://skmtc.dev/pismo/apis/platform-authentication/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/platform-authentication/revisions/935b62e16de4?raw)