Skip to main content
PATCH
/
v1
/
transactions
/
{id}
:approve
Approve a transaction
curl --request PATCH \
  --url https://api.pgw-sandbox.finventi.com/v1/transactions/{id}:approve
{
  "signatureId": 123,
  "signatureWeight": 123,
  "signedAt": "2023-11-07T05:31:56Z",
  "signer": "<string>",
  "transactionId": 123
}

​
Overview

This endpoint approves a transaction waiting for approval. If enabled, transactions exceeding your configured threshold require signatures before sending them to the clearing system.

​
Prerequisites

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

​
How It Works

  1. Create a payment 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. Approve the transaction using a different API client
  5. After collecting required approvals, the payment processes automatically

​
Important Notes

​
Supported Transaction Types

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

​
API vs UI Approval

When your tenant has API approval enabled:
  • API-created transactions must be approved through the API by a different API client than the one that created them
  • UI-created transactions must be approved 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 permissions configured at the tenant level

Path Parameters

​
id
integer<int64>
required

Response

Transaction approved successfully

​
signatureId
integer<int64>
required
​
signatureWeight
number
required
​
signedAt
string<date-time>
required
​
signer
string
required
​
transactionId
integer<int64>
required