Reason Code

August 21, 2026 ยท View on GitHub

The reason code for the payment failure.

Enumeration

ReasonCode

Fields

NameDescription
PAYMENT_DENIEDPayPal declined the payment due to one or more customer issues.
INTERNAL_SERVER_ERRORAn internal server error has occurred.
PAYEE_ACCOUNT_RESTRICTEDThe payee account is not in good standing and cannot receive payments.
PAYER_ACCOUNT_RESTRICTEDThe payer account is not in good standing and cannot make payments.
PAYER_CANNOT_PAYPayer cannot pay for this transaction.
SENDING_LIMIT_EXCEEDEDThe transaction exceeds the payer's sending limit.
TRANSACTION_RECEIVING_LIMIT_EXCEEDEDThe transaction exceeds the receiver's receiving limit.
CURRENCY_MISMATCHThe transaction is declined due to a currency mismatch.

Example

import com.paypal.sdk.models.ReasonCode;

ReasonCode reasonCode = ReasonCode.TRANSACTION_RECEIVING_LIMIT_EXCEEDED;