Skip to main content
This webhook is sent when a payment could not be created, for example due to an invalid account.

​
Webhook Structure

​
eventType
string
required
The type of event. Value: PAYMENT_CREATION_FAILED
​
payload
object
required
The event payload containing the details below

​
Payload Fields

​
payload.eventId
string
required
Unique identifier for this event
​
payload.correlationId
string
Correlation identifier from the original payment request. Present only for outbound payments.
​
payload.scheme
string
required
Payment scheme. Available values: SCT, SCT_INST
​
payload.direction
string
required
Payment direction. Available values: INBOUND, OUTBOUND
​
payload.errorCode
string
required
Error code indicating the reason for the failure
​
payload.errorMessage
string
required
Human-readable description of the error

​
Request Example

{
  "eventType": "PAYMENT_CREATION_FAILED",
  "payload": {
    "eventId": "a3b1c4d2-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
    "correlationId": "req-12345",
    "scheme": "SCT",
    "direction": "OUTBOUND",
    "errorCode": "INCORRECT_ACCOUNT_NUMBER",
    "errorMessage": "Incorrect account number (AC01)"
  }
}