Transaction Execution Failed

Webhook Structure

string (UUID)

required

Unique identifier for this event

string (ISO 8601)

required

Timestamp of when the event occurred

string

Identifier to correlate the request with the response. Present only for client-initiated transactions.

string

required

The type of event. Value: transaction.execution-failed

object

required

The event data containing the details below

Data Fields

array

required

List of errors that caused the failure

Show Error object properties

string

required

Error code indicating the reason for the failure

string

Description of the error

Error Codes

New error codes may be added in future versions. Consumers should handle unknown codes gracefully.

Code	Description
`ACCOUNT_NOT_FOUND`	Account not found
`ACCOUNT_CLOSED`	Account closed
`INSUFFICIENT_FUNDS`	Insufficient funds
`TRANSACTION_FAILED`	Transaction failed
`TRANSACTION_POSTING_BALANCE_CALCULATION_FAILED`	Transaction posting balance calculation failed
`SYSTEM_ERROR`	Internal 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"
      }
    ]
  }
}

Getting Started

Parties

Accounts

Account Statements

Payments

Transactions

Transaction Postings

Oversight

Webhooks

Webhook Structure

Data Fields

Error Codes

Request Example

​Webhook Structure

​Data Fields

​Error Codes

​Request Example

Webhook Structure

Data Fields

Error Codes

Request Example