FailureReason
Stable GraphQL API enum for payment failure reasons.
These values are decoupled from the domain FailureReason enum to maintain API stability. Note: KRAKEN_ERROR is intentionally excluded as it's internal-only.
Values
-
PAYMENT_INSTRUCTION_NOT_USABLEThe payment method used for this payment has been invalidated.
-
PAYER_DECEASEDThe payer is deceased.
-
INSUFFICIENT_FUNDSThe payer did not have enough funds available to make the payment.
-
ACTION_REQUIREDThe payment provider required additional validation or approval that could not be provided.
-
CUSTOMER_OBJECTIONThe customer rejected or cancelled the payment.
-
INSTITUTIONAL_OBJECTIONThe payer's bank or financial institution rejected the payment.
-
INVALID_AMOUNTThe payment amount was too large or too small to be processed.
-
SUSPICIOUSThe payment was flagged as suspicious or potentially fraudulent.
-
INSUFFICIENT_NOTICEThe payment was submitted too close to the payment date to be processed on time.
-
PAST_DATEThe payment date has already passed.
-
BAD_TIMINGThe payment could not be processed due to timing constraints, such as being too close to another payment.
-
VENDOR_SYSTEM_MALFUNCTIONThe payment failed due to a technical issue with the payment provider's systems.
-
UNKNOWNThe reason for the failure is not known.
Example
"PAYMENT_INSTRUCTION_NOT_USABLE"