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 payment could not be created, for example due to an invalid account.

​
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 outbound payments.
​
type
string
required
The type of event. Value: payment.creation-failed
​
data
object
required
The event data containing the details below

​
Data Fields

​
data.paymentId
string (UUID)
Unique identifier of the payment. May be absent if the payment could not be created.
​
data.scheme
string
required
Payment scheme. Available values: SCT, SCT_INST
​
data.direction
string
required
Payment direction. Available values: INBOUND, OUTBOUND
​
data.errorCode
string
required
Error code indicating the reason for the failure. See Error Codes below.
​
data.errorMessage
string
required
Human-readable description of the error

​
Error Codes

New error codes may be added in future versions. Consumers should handle unknown codes gracefully.
CodeISODescription
INCORRECT_ACCOUNT_NUMBERAC01Incorrect account number
INVALID_REQUEST—Invalid payment request
SYSTEM_ERROR—Internal system error
OTHER—Unknown error

​
Request Example

{
  "id": "a3b1c4d2-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
  "time": "2025-01-15T10:30:00Z",
  "correlationId": "req-12345",
  "type": "payment.creation-failed",
  "data": {
    "paymentId": "019cde3b-a71f-7c4d-b832-4e9f1a2d5c8b",
    "scheme": "SCT",
    "direction": "OUTBOUND",
    "errorCode": "INCORRECT_ACCOUNT_NUMBER",
    "errorMessage": "Incorrect account number (AC01)"
  }
}
Last modified on April 24, 2026