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 return request has been rejected.

​
Webhook Structure

​
id
string (UUID)
required
Unique identifier for this event
​
time
string (ISO 8601)
required
Timestamp of when the event occurred
​
type
string
required
The type of event. Value: payment.return-rejected
​
data
object
required
The event data containing the details below

​
Data Fields

​
data.paymentId
string (UUID)
required
Unique identifier of the payment whose return was rejected
​
data.scheme
string
required
Payment scheme. Available values: SCT, SCT_INST, INTERNAL
​
data.direction
string
required
Payment direction. Available values: INBOUND, OUTBOUND
​
data.reasonCode
string
Reason the return was rejected. Either an ISO 20022 reason code surfaced by the payment gateway (for example, AC06 for a blocked account) or the internal value ORIGINAL_PAYMENT_NOT_FOUND when an inbound return arrives for an outbound payment that cannot be matched. Optional — omitted when no reason is available.

​
Request Example

{
  "id": "f2a7b5c4-9d3e-4f8a-c2ba-5e7d1f4a3c6b",
  "time": "2025-01-15T10:30:00Z",
  "type": "payment.return-rejected",
  "data": {
    "paymentId": "019cde3e-da40-7f7c-eb65-7b2c4d5f8a1e",
    "scheme": "SCT",
    "direction": "OUTBOUND",
    "reasonCode": "ORIGINAL_PAYMENT_NOT_FOUND"
  }
}
Last modified on May 5, 2026