Skip to main content
PATCH
/
v1
/
transactions
/
{id}
:decline
Decline a transaction
curl --request PATCH \
  --url https://api.pgw-sandbox.finventi.com/v1/transactions/{id}:decline
{
  "code": "<string>",
  "data": {
    "errors": [
      {
        "code": "<string>",
        "field_name": "<string>",
        "message": "<string>",
        "value": "<string>"
      }
    ],
    "message": "<string>"
  },
  "message": "<string>"
}

​
Overview

This endpoint declines a transaction waiting for approval. Use this when you need to reject a transaction that exceeds your configured threshold instead of approving it.

​
Prerequisites

Transaction signing/approval must be enabled for your account. Contact Inventi team if you want to enable this

​
How It Works

  1. A payment is created that exceeds your signing threshold
  2. The system places the payment on hold with TO_SIGN status
  3. You receive a webhook notification about the status change
  4. Decline the transaction using this endpoint
  5. The transaction status changes to DECLINED and will not be processed

​
Important Notes

​
Supported Transaction Types

Only these transaction types support declining:
  • SEPA Credit Transfers (SCT)
  • SEPA Instant Payments (INST)
  • SWIFT Payments
SEPA Direct Debit (SDD) transactions do not support signing/declining and will never have TO_SIGN status.

​
API vs UI Declining

When your tenant has API approval enabled:
  • API-created transactions must be declined through the API by a different API client than the one that created them
  • UI-created transactions must be declined through the UI interface

​
Requirements

  • Transaction must have TO_SIGN status
  • Must use a different API client from the one that created the transaction
  • User must have approval/decline permissions configured at the tenant level

​
Response

This endpoint returns a 204 No Content response on successful decline, unlike the approve endpoint which returns the signature details.

Path Parameters

​
id
integer<int64>
required

Response

Transaction declined successfully

Last modified on January 27, 2026