Skip to main content
POST
/
sdd
/
cancelTransaction
Cancel transactions
curl --request POST \
  --url https://api.pgw-sandbox.finventi.com/sdd/cancelTransaction \
  --header 'Content-Type: application/json' \
  --data '
{
  "reason": "AC01",
  "transactionIds": [
    123
  ]
}
'
{
  "result": {
    "amount": 123,
    "collection": [
      123
    ]
  }
}

Overview

This API service cancels Sepa Direct Debit transactions with different handling based on transaction status:

Inbound Transactions (Not Yet Completed)

Initiates an outbound payment cancellation message to be delivered to the Creditor system.

Outbound Transactions (Completed)

Initiates an inbound SDD payment cancellation message to be delivered to the Creditor system. Note: Not applicable for settled outbound payments - use the Payment return service instead.

Reason Codes

Cancel Outbound Payment

Use one of the following reason codes:
  • AC01, AC04, AC06
  • AG01, AG02
  • AM04, AM05
  • BE05
  • CNOR, DNOR
  • ED05
  • FF01
  • MD01, MD02, MD07
  • MS02, MS03
  • RC01
  • RR01, RR02, RR04
  • SL01

Cancel Inbound Payment

Use one of the following reason codes:
  • CUST - Customer requested cancellation
  • DUPL - Duplicate payment
  • AGNT - Agent error
  • CURR - Currency issue
  • CUTA - Cut-off time exceeded
  • UPAY - Underpayment

Body

application/json
reason
enum<string>
required

Cancellation reason

Available options:
AC01,
AC04,
AC06,
AG01,
AG02,
AM01,
AM04,
AM05,
CNOR,
DNOR,
MD01,
MD02,
CUST,
MD07,
MS02,
MS03,
RC01,
RR01,
RR02,
RR04,
SL01,
BE05,
FF01,
ED05,
DUPL,
AGNT,
CURR,
CUTA,
UPAY
transactionIds
integer<int64>[]
required

Array of transaction IDs

Array of transaction IDs

Response

Payment scheduled for cancellation

result
object
required

Result of cancel transactions