RefundReason

Schema
Example

reason

OptionalString

Free-text human-readable reason why Beneficiary VASP is initiating the refund. Combined with `reasonType` for both machine routing and human review. Required on API 1 / callback 21.

Min Length0

Max Length1024

Example

Originator KYC verification could not be completed within the SLA window

reasonType

RequiredString

Machine-readable reason category for the refund. One of RefundReasonTypeEnum: UNIDENTIFIED_ORIGINATOR, ORIGINATOR_TRAVEL_RULE_INCOMPLETE, SCREENING_CHECK_TRIGGERED, OTHER. Required on API 1 / callback 21.

Min Length0

Max Length64

Example

ORIGINATOR_TRAVEL_RULE_INCOMPLETE

{
  "reason": "Originator KYC verification could not be completed within the SLA window",
  "reasonType": "ORIGINATOR_TRAVEL_RULE_INCOMPLETE"
}