Skip to main content

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.

This webhook is sent when a transaction execution request has failed.

​
Webhook Structure

​
id
string (UUID)
required
Unique identifier for this event
​
time
string (ISO 8601)
required
Timestamp of when the event occurred
​
correlationId
string
Identifier to correlate the request with the response. Present only for client-initiated transactions.
​
type
string
required
The type of event. Value: transaction.execution-failed
​
data
object
required
The event data containing the details below

​
Data Fields

​
data.errors
array
required
List of errors that caused the failure

​
Error Codes

New error codes may be added in future versions. Consumers should handle unknown codes gracefully.
CodeDescription
ACCOUNT_NOT_FOUNDAccount not found
ACCOUNT_CLOSEDAccount closed
INSUFFICIENT_FUNDSInsufficient funds
TRANSACTION_FAILEDTransaction failed
TRANSACTION_POSTING_BALANCE_CALCULATION_FAILEDTransaction posting balance calculation failed
SYSTEM_ERRORInternal system error

​
Request Example

{
  "id": "a3f8e2b1-5c7d-4e9f-b8a2-1d4c6e9f0a3b",
  "time": "2025-01-15T10:30:00Z",
  "correlationId": "550e8400-e29b-41d4-a716-446655440000",
  "type": "transaction.execution-failed",
  "data": {
    "errors": [
      {
        "code": "INSUFFICIENT_FUNDS",
        "message": "Insufficient funds in source account"
      }
    ]
  }
}
Last modified on May 5, 2026