> ## Documentation Index
> Fetch the complete documentation index at: https://docs.finventi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Payment Cancellation Status Change

> Webhook notification sent when payment cancellation status changes

<Note>
  This webhook sends notifications when payment cancellation status changes to one of the following statuses: CANCELLATION\_IN\_PROGRESS, CANCELLATION\_ACCEPTED, CANCELLATION\_REJECTED, CANCELLATION\_COMPLETED.
</Note>

## Webhook Details

<ParamField body="cancellationId" type="integer" required>
  Cancellation request ID
</ParamField>

<ParamField body="trxId" type="integer">
  Transaction ID
</ParamField>

<ParamField body="direction" type="string" required>
  Transaction direction. Available values: "INBOUND", "OUTBOUND"
</ParamField>

<ParamField body="reason" type="string" required>
  Cancellation reason code. Available values: "DUPL", "CUST", "FRAD", "TECH", "AC03", "AM09", "AGNT", "COVR", "CURR", "CUTA", "DS24", "FRNA", "FRTR", "INDM", "SYAD", "UPAY", "AC01", "AC04", "AC06", "AC13", "AG01", "AG02", "AM01", "AM04", "AM05", "CNOR", "DNOR", "MD01", "MD02", "MD07", "MS02", "MS03", "RC01", "RR01", "RR02", "RR04", "SL01", "BE05", "FF01", "DT01", "ED05", "PY01"
</ParamField>

<ParamField body="status" type="string" required>
  Cancellation status. Available values: "CANCELLATION\_CREATED", "CANCELLATION\_IN\_PROGRESS", "RETURNING", "REFUSING", "PAYMENT\_RETURNED", "CANCELLATION\_REFUSED", "PROCESSING\_FAILED", "CANCELLATION\_COMPLETED", "CANCELLATION\_REJECTED", "CANCELLATION\_ACCEPTED"
</ParamField>

## Request Example

```json theme={null}
{
  "cancellationId": 102,
  "trxId": 2018845,
  "direction": "OUTBOUND",
  "reason": "CUST",
  "status": "CANCELLATION_IN_PROGRESS"
}
```

## Cancellation Request Processing Statuses

The table below standardises how you track SEPA cancellation requests from start to finish. Each status maps to specific inbound/outbound ISO-20022 messages, giving you clear, machine-readable checkpoints for monitoring and automating your cancellation workflow.

| Status name                | ISO-20022 Message    | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| -------------------------- | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| CANCELLATION\_CREATED      | -                    | Cancellation request successfully created and validated by the Inventi Payment Platform.                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| CANCELLATION\_IN\_PROGRESS | camt.056             | The payment cancellation request is received from the clearing system and waiting for the User activities. Can be accepted and payment will be returned or rejected.                                                                                                                                                                                                                                                                                                                                                                    |
| RETURNING                  | pacs.004             | User decides to return the funds. The payment return message is sent to the initiator of the payment cancellation request. The intermediary cancellation request status, which doesn't allow to execute any actions until the final status of the payment return will be set.                                                                                                                                                                                                                                                           |
| REFUSING                   | camt.029             | User rejects to return the funds. The resolution of investigation message is sent to the initiator of the payment cancellation request. The intermediary cancellation request status, which doesn't allow to execute any actions until the final status of the resolution of investigation will be set.                                                                                                                                                                                                                                 |
| PAYMENT\_RETURNED          | pacs.004 or pacs.002 | **Incoming cancellation:** The payment return message successfully delivered to the beneficiary bank. This is the final processing status.<br />**Outgoing cancellation:** The payment return message following the sent cancellation request is received from the clearing system, or the original payment is cancelled by the clearing system before settlement. When cancellation is completed before settlement, no separate payment return transaction is created.                                                                 |
| CANCELLATION\_REFUSED      | camt.029             | **Incoming cancellation:** The resolution of investigation message successfully delivered to the beneficiary bank. This is the final processing status.<br />**Outgoing cancellation:** The resolution of investigation message following the sent cancellation request is received from the clearing system. The payment return refusal data are indicated for the related cancellation request.                                                                                                                                       |
| PROCESSING\_FAILED         | -                    | The state which indicates that there was an error during processing of the response for the cancellation request message. This state allows to reprocess the cancellation request after the errors will be eliminated.                                                                                                                                                                                                                                                                                                                  |
| CANCELLATION\_COMPLETED    | pacs.004 or pacs.002 | **Incoming cancellation:** The payment return transaction completed successfully. If failed, the status will be changed to the CANCELLATION\_IN\_PROGRESS and it is possible to reprocess the cancellation request.<br />**Outgoing cancellation:** The payment return message following cancellation request is received from the clearing system, or the original payment is cancelled by the clearing system before settlement. When cancellation is completed before settlement, no separate payment return transaction is created. |
| CANCELLATION\_REJECTED     | camt.056             | The payment cancellation request message was rejected by the clearing system due to errors. The state allows to initiate additional cancellation request after the errors will be eliminated.                                                                                                                                                                                                                                                                                                                                           |
| CANCELLATION\_ACCEPTED     | camt.056             | The payment cancellation request message successfully delivered to the beneficiary bank.                                                                                                                                                                                                                                                                                                                                                                                                                                                |

## Retry Mechanism

There is a retry mechanism - if an endpoint fails, the notification will be repeatedly sent until it is successfully delivered. During this retry process, all other notifications will be held back and will only be delivered once the initially blocked notification is successfully sent.
