Skip to main content
POST
/
v1
/
transactions
/
signatures
Sign multiple transactions
curl --request POST \
  --url https://api.pgw-sandbox.finventi.com/v1/transactions/signatures \
  --header 'Content-Type: application/json' \
  --data '
{
  "transactionIds": [
    123
  ]
}
'
{
  "count": 123,
  "failedToSignTransactionIds": [
    123
  ]
}

Overview

This endpoint signs multiple transactions at once. Use it to approve several payments waiting for signatures.

Prerequisites

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

How It Works

  1. Submit all IDs that need signature in a single request
  2. The system signs each transaction
  3. Response shows successful signatures and any failures
  4. Payments processing resume automatically after signing

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.

Bulk Signing Behavior

When using this bulk signing endpoint:
  • Successfully signed transactions appear in the response
  • Failed transactions are included in failedToSignTransactionIds
  • Transactions fail silently without stopping the entire batch
Common reasons for signing failures:
  • Transaction not in TO_SIGN status
  • User has already signed this transaction
  • Transaction type doesn’t support signing
  • Insufficient permissions for the user

API vs UI Signing

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

Requirements

  • Transactions must have TO_SIGN status
  • Must use a different API client from the one that created the transactions
  • User must have signing permissions configured at the tenant level

Body

application/json
transactionIds
integer<int64>[]
required

Response

Bulk signing completed - check response for individual results

count
integer<int32>
required
failedToSignTransactionIds
integer<int64>[]
required