Skip to main content
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.scheme
string
required
Payment scheme. Available values: SCT, SCT_INST, INTERNAL
​
data.direction
string
required
Payment direction. Available values: INBOUND, OUTBOUND
​
data.errors
array
required
List of errors indicating the reason(s) for the failure. Each error contains the fields below.
​
data.errors[].code
string
required
Error code indicating the reason for the failure. See Error Codes below.
​
data.errors[].message
string
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
CLOSED_ACCOUNTAC04Closed account
BLOCKED_ACCOUNTAC06Blocked account
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": {
    "scheme": "SCT",
    "direction": "OUTBOUND",
    "errors": [
      {
        "code": "INCORRECT_ACCOUNT_NUMBER",
        "message": "Incorrect account number (AC01)"
      }
    ]
  }
}
Last modified on May 5, 2026