Search Overlay

Error Codes and Transaction Status

Transaction Status (PayPal Payments)

Paypal Status Paypal Status description Paysafe Status Paysafe Status Code

Completed 

The funds for this captured payment were credited to the payee's PayPal account.

COMPLETED

201

Declined

The funds could not be captured.

FAILED

200

Pending

The funds for this captured payment was not yet credited to the payee's PayPal account. The reason why the captured payment status is PENDING or DENIED

Status details_reason_Enum Description

BUYER_COMPLAINT

The payer initiated a dispute for this captured payment with PayPal.

CHARGEBACK

The captured funds were reversed in response to the payer disputing this captured payment with the issuer of the financial instrument used to pay for this captured payment.

ECHECK

 

INTERNATIONAL_WITHDRAWAL

 

PENDING_REVIEW

The captured payment is pending manual review

OTHER

No additional specific reason can be provided. For more information about this captured payment, visit your account online or contact PayPal.

RECEIVING_PREFERENCE_MANDATES_MANUAL_ACTION

The payee has not yet set up appropriate receiving preferences for their account. For more information about how to accept or deny this payment, visit your account online. This reason is typically offered in scenarios such as when the currency of the captured payment is different from the primary holding currency of the payee.

REFUNDED

The captured funds were refunded.

TRANSACTION_APPROVED_AWAITING_FUNDING

The payer must send the funds for this captured payment. This code generally appears for manual EFTs.

UNILATERAL

The payee does not have a PayPal account.

VERIFICATION_REQUIRED

The payee's PayPal account is not verified.

PROCESSING

200

Failed

There was an error while capturing payment.

FAILED

200

Transaction Status (PayPal Withdrawals)

Paypal Status Paypal Status description Paysafe Status Paysafe Status code
PENDING Your payout requests were received and will be processed soon. PROCESSING 201
PROCESSING Your payout requests were received and are now being processed. PROCESSING 201
SUCCESS Your payout batch was processed and completed. Check the status of each item for any holds or unclaimed transactions. COMPLETED 201
DENIED Your payout requests were denied, so they were not processed. Check the error messages to see any steps necessary to fix these issues. Failed 200

Errors

PayPal does not return any error codes, they only return error messages. Here is a comprehensive list of error messages returned from PayPal as found on their developer site: https://developer.paypal.com/docs/api/orders/v2/#errors

PayPal error message PayPal error description Paysafe HTTP Status Code Paysafe Error Code Paysafe Error Message Paysafe Error Detail(s) Paysafe Status

ACTION_DOES_NOT_MATCH_INTENT

Order was created with an intent to CAPTURE.

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

Merchant configuration is incorrect.  Verify setup in Netbanx

FAILED

AUTH_CAPTURE_NOT_ENABLED

The requested action could not be performed, semantically incorrect, or failed business validation.
The authorization and capture feature is not enabled for the merchant. Make sure that the recipient of the funds is a verified business account.

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

The requested action could not be performed, semantically incorrect, or failed business validation.
The authorization and capture feature is not enabled for the merchant. Make sure that the recipient of the funds is a verified business account.

Ensure recipient of account is correct

FAILED

AGREEMENT_ALREADY_CANCELLED

The requested agreement is already cancelled.
The specified agreement ID cannot be used for this transaction.

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

The requested agreement is already cancelled.
The specified agreement ID cannot be used for this transaction.

Transaction already cancelled.

FAILED

AMOUNT_CANNOT_BE_SPECIFIED

The requested action could not be performed, semantically incorrect, or failed business validation.
An authorization amount can only be specified if an order was saved by calling /v2/checkout/orders/{order_id}/save. Save the order and try again.

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

The requested action could not be performed, semantically incorrect, or failed business validation.
An authorization amount can only be specified if an order was saved by calling /v2/checkout/orders/{order_id}/save. 

FAILED

AMOUNT_MISMATCH

The amount specified does not match the breakdown.
The amount must equal item_total + tax_total + shipping + handling + insurance - shipping_discount - discount.

502

1001

External Gateway Error

An external gateway error occurred.

The amount specified does not match the breakdown.
The amount must equal item_total + tax_total + shipping + handling + insurance - shipping_discount - discount.

ERROR

AUTHENTICATION_FAILURE

Authentication failed due to missing authorization header, or invalid authentication credentials.
The account validations failed for the user.

502

1001

External Gateway Error

An external gateway error occurred.

Authentication failed due to missing authorization header, or invalid authentication credentials.
The account validations failed for the user.

ERROR

AUTHORIZATION_AMOUNT_EXCEEDED

The requested action could not be performed, semantically incorrect, or failed business validation.
The specified authorization amount exceeded the allowable limit. Specify a different amount and try the request again. Alternately, contact Customer Support to increase your limits.

502

1001

External Gateway Error

An external gateway error occurred.

The requested action could not be performed, semantically incorrect, or failed business validation.
The specified authorization amount exceeded the allowable limit. Specify a different amount and try the request again. 

FAILED

AUTHORIZATION_CURRENCY_MISMATCH

The requested action could not be performed, semantically incorrect, or failed business validation.
The currency of the authorization must match the currency of the order that the payer created and approved. Check the currency_code and try the request again.

502

1001

External Gateway Error

An external gateway error occurred.

The requested action could not be performed, semantically incorrect, or failed business validation.
The currency of the authorization must match the currency of the order that the payer created and approved. Check the currency_code and try the request again.

FAILED

BILLING_AGREEMENT_NOT_FOUND

The requested Billing Agreement token was not found.
Verify the token and try the request again.

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

The requested Billing Agreement token was not found.
Verify the token and try the request again.

FAILED

CANNOT_BE_NEGATIVE

Must be greater than or equal to zero.
Try the request again with a different value.

502

1001

External Gateway Error

An external gateway error occurred.

Must be greater than or equal to zero.
Try the request again with a different value.

ERROR

CANNOT_BE_ZERO_OR_NEGATIVE

Must be greater than zero.
Try the request again with a different value.

502

1001

External Gateway Error

An external gateway error occurred.

Must be greater than zero.
Try the request again with a different value.

ERROR

CARD_TYPE_NOT_SUPPORTED

The requested action could not be performed, semantically incorrect, or failed business validation.
Processing of this card type is not supported. Use another card type.

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

The requested action could not be performed, semantically incorrect, or failed business validation.
Processing of this card type is not supported. Use another card type.

FAILED

INVALID_SECURITY_CODE_LENGTH

The requested action could not be performed, semantically incorrect, or failed business validation.
The security_code length is invalid for the specified card type.

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

The requested action could not be performed, semantically incorrect, or failed business validation.
The security_code length is invalid for the specified card type.

FAILED

CITY_REQUIRED

The specified country requires a city (address.admin_area_2).
Specify a city and try the request again.

502

1001

External Gateway Error

An external gateway error occurred.

The specified country requires a city (address.admin_area_2).
Specify a city and try the request again.

ERROR

COMPLIANCE_VIOLATION

Transaction cannot be processed due to a possible compliance violation.
To get more information about the transaction, call Customer Support.

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

Transaction cannot be processed due to a possible compliance violation.
 

FAILED

CONSENT_NEEDED

Authorization failed due to insufficient permissions.
To continue with this transaction, the payer must provide consent.

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

Authorization failed due to insufficient permissions.
To continue with this transaction, the payer must provide consent.

FAILED

CURRENCY_NOT_SUPPORTED_FOR_CARD_TYPE

The requested action could not be performed, semantically incorrect, or failed business validation.
The currency code is not supported for direct card payments for this card type. See Currency Codes for list of supported currency codes.

502

1001

External Gateway Error

An external gateway error occurred.

The requested action could not be performed, semantically incorrect, or failed business validation.
The currency code is not supported for direct card payments for this card type. 

ERROR

CURRENCY_NOT_SUPPORTED_FOR_COUNTRY

The requested action could not be performed, semantically incorrect, or failed business validation.
Currency code not supported for direct card payments in this country. Please refer https://developer.paypal.com/docs/integration/direct/rest/currency-codes/ for list of supported currency codes.

502

1001

External Gateway Error

An external gateway error occurred.

The requested action could not be performed, semantically incorrect, or failed business validation.
Currency code not supported for direct card payments in this country. 

ERROR

DECIMAL_PRECISION

The value of the field should not be more than two decimal places.
Verify the number of decimal places and try the request again.

502

1001

External Gateway Error

An external gateway error occurred.

The value of the field should not be more than two decimal places.
Verify the number of decimal places and try the request again.

ERROR

DOMESTIC_TRANSACTION_REQUIRED

This transaction requires the payee and payer to be resident in the same country.
To create this payment, a domestic transaction is required.

502

1001

External Gateway Error

An external gateway error occurred.

This transaction requires the payee and payer to be resident in the same country.
To create this payment, a domestic transaction is required.

ERROR

DUPLICATE_INVOICE_ID

Duplicate Invoice ID detected.
To avoid a duplicate transaction, verify that the invoice ID is unique for each transaction.

502

1001

External Gateway Error

An external gateway error occurred.

Duplicate Invoice ID detected.
To avoid a duplicate transaction, verify that the invoice ID is unique for each transaction.

ERROR

DUPLICATE_REQUEST_ID

The value of PayPal-Request-Id header has already been used.
Specify a different value and try the request again.

502

1001

External Gateway Error

An external gateway error occurred.

The value of PayPal-Request-Id header has already been used.
Specify a different value and try the request again.

ERROR

INSTRUMENT_DECLINED

The funding instrument presented was either declined by the processor or bank.
The specified funding instrument cannot be used for this payment.

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

The funding instrument presented was either declined by the processor or bank.
The specified funding instrument cannot be used for this payment.

FAILED

INTERNAL_SERVER_ERROR

An internal server error has occurred.
Retry the request later.

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

The funding instrument presented was either declined by the processor or bank.
The specified funding instrument cannot be used for this payment.

FAILED

INTERNAL_SERVICE_ERROR

An internal service error has occurred.
 

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

The funding instrument presented was either declined by the processor or bank.
The specified funding instrument cannot be used for this payment.

FAILED

INVALID_ACCOUNT_STATUS

Account validations failed for the user.
To continue with this transaction, the payer must provide consent.

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

Account validations failed for the user.
To continue with this transaction, the payer must provide consent.

FAILED

INVALID_ARRAY_MAX_ITEMS

The number of items in an array parameter is too large.
 

502

1001

External Gateway Error

An external gateway error occurred.

The number of items in an array parameter is too large.

ERROR

INVALID_ARRAY_MIN_ITEMS

The number of items in an array parameter is too small.
 

502

1001

External Gateway Error

An external gateway error occurred.

The number of items in an array parameter is too small.

ERROR

INVALID_COUNTRY_CODE

Country code is invalid.
For list of supported country codes, see Country and Region Codes.

502

1001

External Gateway Error

An external gateway error occurred.

Country code is invalid.

ERROR

INVALID_CURRENCY_CODE

Currency code is invalid or is not currently supported.
For a list of supported currency codes, see Currency Codes.

502

1001

External Gateway Error

An external gateway error occurred.

Currency code is invalid or is not currently supported.

ERROR

INVALID_JSON_POINTER_FORMAT

Path should be a valid JavaScript Object Notation (JSON) Pointer that references a location within the request where the operation is performed.
The path is not valid.

502

1001

External Gateway Error

An external gateway error occurred.

Path should be a valid JavaScript Object Notation (JSON) Pointer that references a location within the request where the operation is performed. The path is not valid.

ERROR

INVALID_PARAMETER_SYNTAX

The value of a field does not conform to the expected format.
Verify that the pattern is supported and try the request again.

502

1001

External Gateway Error

An external gateway error occurred.

The value of a field does not conform to the expected format.
Verify that the pattern is supported and try the request again.

ERROR

INVALID_PARAMETER_VALUE

The value of a field is invalid.
Verify the parameter value and try the request again.

502

1001

External Gateway Error

An external gateway error occurred.

The value of a field is invalid.
Verify the parameter value and try the request again.

ERROR

INVALID_PARAMETER

Cannot be specified as part of the request.
Check that the API supports this parameter and try the request again.

502

1001

External Gateway Error

An external gateway error occurred.

Cannot be specified as part of the request.
Check that the API supports this parameter and try the request again.

ERROR

INVALID_PAYER_ID

The payer ID is not valid.
Verify the payer ID and try the request again.

502

1001

External Gateway Error

An external gateway error occurred.

The payer ID is not valid.
Verify the payer ID and try the request again.

ERROR

INVALID_RESOURCE_ID

Specified resource ID does not exist.
Verify the resource ID and try the request again.

502

1001

External Gateway Error

An external gateway error occurred.

Specified resource ID does not exist.
Verify the resource ID and try the request again.

ERROR

INVALID_STRING_LENGTH

The value of a field is either too short or too long.
Verify the minimum and maximum values and try the request again.

502

1001

External Gateway Error

An external gateway error occurred.

The value of a field is either too short or too long.
Verify the minimum and maximum values and try the request again.

ERROR

ITEM_TOTAL_MISMATCH

Verify the corresponding values and try the request again.
The item total should equal the sum of (unit_amount * quantity) across all items for a purchase_unit.

502

1001

External Gateway Error

An external gateway error occurred.

Verify the corresponding values and try the request again.
The item total should equal the sum of (unit_amount * quantity) across all items for a purchase_unit.

ERROR

ITEM_TOTAL_REQUIRED

If item details are specified (items.unit_amount and items.quantity) corresponding amount.breakdown.item_total is required.
The amount.breakdown.item_total value was not found.

502

1001

External Gateway Error

An external gateway error occurred.

If item details are specified (items.unit_amount and items.quantity) corresponding amount.breakdown.item_total is required.
The amount.breakdown.item_total value was not found.

ERROR

MAX_AUTHORIZATION_COUNT_EXCEEDED

The requested action could not be performed, semantically incorrect, or failed business validation.
The maximum number of authorizations that are allowed for the order was reached. To increase your limit, contact Customer Support.

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

The requested action could not be performed, semantically incorrect, or failed business validation.
 

FAILED

MAX_NUMBER_OF_PAYMENT_ATTEMPTS_EXCEEDED

You have exceeded the maximum number of payment attempts.
To review the maximum number of payment attempts allowed and retry this transaction, call Customer Support.

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

You have exceeded the maximum number of payment attempts.
 

FAILED

MAX_VALUE_EXCEEDED

Should be less than or equal to 9999999.99.
Try the request again with a different value.

502

1001

External Gateway Error

An external gateway error occurred.

Should be less than or equal to 9999999.99.
Try the request again with a different value.

ERROR

MISSING_REQUIRED_PARAMETER

A required field or parameter is missing.
Verify that you have specified all required parameters and try the request again.

502

1001

External Gateway Error

An external gateway error occurred.

A required field or parameter is missing.
Verify that you have specified all required parameters and try the request again.

ERROR

MISSING_SHIPPING_ADDRESS

The shipping address is required when shipping_preference=SET_PROVIDED_ADDRESS.
Verify that you have provided the shipping address and try the request again.

502

1001

External Gateway Error

An external gateway error occurred.

The shipping address is required when shipping_preference=SET_PROVIDED_ADDRESS.
Verify that you have provided the shipping address and try the request again.

ERROR

MULTI_CURRENCY_ORDER

Multiple differing values of currency_code are not supported.
The entire order request must have the same currency code.

502

1001

External Gateway Error

An external gateway error occurred.

Multiple differing values of currency_code are not supported.
The entire order request must have the same currency code.

ERROR

MULTIPLE_SHIPPING_ADDRESS_NOT_SUPPORTED

Multiple shipping addresses are not supported.
Try the request again with the same shipping_address.

502

1001

External Gateway Error

An external gateway error occurred.

Multiple shipping addresses are not supported.
Try the request again with the same shipping_address.

ERROR

MULTIPLE_SHIPPING_OPTION_SELECTED

The requested action could not be performed, semantically incorrect, or failed business validation.
Only one shipping.option can be set to selected = true.

502

1001

External Gateway Error

An external gateway error occurred.

The requested action could not be performed, semantically incorrect, or failed business validation.
Only one shipping.option can be set to selected = true.

ERROR

INVALID_PICKUP_ADDRESS

Invalid shipping address.
If the 'shipping_option.type' is set as 'PICKUP' then the 'shipping_detail.name.full_name' should start with 'S2S' meaning Ship To Store. Example: 'S2S My Store'.

502

1001

External Gateway Error

An external gateway error occurred.

Invalid shipping address.
If the 'shipping_option.type' is set as 'PICKUP' then the 'shipping_detail.name.full_name' should start with 'S2S' meaning Ship To Store. Example: 'S2S My Store'.

ERROR

NOT_AUTHORIZED

Authorization failed due to insufficient permissions.
To check that your application has sufficient permissions, log in to the PayPal Developer Portal.

502

1001

External Gateway Error

An external gateway error occurred.

Authorization failed due to insufficient permissions.
To check that your application has sufficient permissions, log in to the PayPal Developer Portal.

ERROR

NOT_ENABLED_FOR_CARD_PROCESSING

The request fails. The API Caller account is not setup to be able to process card payments. Please contact PayPal customer support.
 

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

The request fails. The API Caller account is not setup to be able to process card payments.

FAILED

NOT_SUPPORTED

This field is not currently supported.
Specify only supported parameters and try the request again.

502

1001

External Gateway Error

An external gateway error occurred.

This field is not currently supported.
Specify only supported parameters and try the request again.

ERROR

ORDER_ALREADY_AUTHORIZED

Order already authorized. If intent=AUTHORIZE only one authorization per order is allowed.
The order was already authorized and you can create only one authorization for an order.

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

The order was already authorized and you can create only one authorization for an order.

FAILED

ORDER_ALREADY_CAPTURED

Order already captured. If intent=CAPTURE only one capture per order is allowed.
The order was already captured and you can capture only one payment for an order.

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

The order was already captured and you can capture only one payment for an order.

FAILED

ORDER_CANNOT_BE_SAVED

The requested action could not be performed, semantically incorrect, or failed business validation.
The option to save an order is only available if the intent is AUTHORIZE and the processing_instruction is ORDER_SAVED_EXPLICITLY. Change the intent to AUTHORIZE and the processing_instruction to ORDER_SAVED_EXPLICITLY and try the request again.

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

The requested action could not be performed, semantically incorrect, or failed business validation.
The option to save an order is only available if the intent is AUTHORIZE and the processing_instruction is ORDER_SAVED_EXPLICITLY.

FAILED

ORDER_COMPLETED_OR_VOIDED

The requested action could not be performed, semantically incorrect, or failed business validation.
Order is voided or completed and hence cannot be authorized.

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

The requested action could not be performed, semantically incorrect, or failed business validation.
Order is voided or completed and hence cannot be authorized.

FAILED

ORDER_EXPIRED

The requested action could not be performed, semantically incorrect, or failed business validation.
Order is expired and hence cannot be authorized. Please contact Customer Support if you need to increase your order validity period.

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

The requested action could not be performed, semantically incorrect, or failed business validation.
Order is expired and hence cannot be authorized. 

FAILED

ORDER_NOT_APPROVED

Payer has not yet approved the Order for payment.
The payer has not yet approved payment for the order. Redirect the payer to the rel:approve URL that was returned in the HATEOAS links in the create order response or provide a valid payment_source in the request.

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

Payer has not yet approved the Order for payment.

FAILED

ORDER_NOT_SAVED

The requested action could not be performed, semantically incorrect, or failed business validation.
Please save the order by calling v2/orders/{order_id}/save or alternately, If you do not intend to save the order, PATCH the order to update the value of processing_instruction to NO_INSTRUCTION.

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

The requested action could not be performed, semantically incorrect, or failed business validation.
Please save the order by calling v2/orders/{order_id}/save or alternately, If you do not intend to save the order, PATCH the order to update the value of processing_instruction to NO_INSTRUCTION.

FAILED

ORDER_PREVIOUSLY_VOIDED

The requested action could not be performed, semantically incorrect, or failed business validation.
This order has been previously voided and cannot be voided again. Verify the order id and try again.

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

The requested action could not be performed, semantically incorrect, or failed business validation.
This order has been previously voided and cannot be voided again. Verify the order id and try again.

FAILED

PARAMETER_VALUE_NOT_SUPPORTED

The value specified for this field is not currently supported.
The specified parameter value is not supported.

502

1001

External Gateway Error

An external gateway error occurred.

The value specified for this field is not currently supported.
The specified parameter value is not supported.

ERROR

PAYEE_ACCOUNT_INVALID

Payee account specified is invalid. Please check the payee.email_address or payee.merchant_id specified and try again. Ensure that either payee.merchant_id or payee.email_address is specified.
Specify either payee.merchant_id or payee.email_address.

502

1001

External Gateway Error

An external gateway error occurred.

Payee account specified is invalid

ERROR

PAYEE_ACCOUNT_LOCKED_OR_CLOSED

Payee account is locked or closed.
To get more information about the status of the account, call Customer Support.

502

1001

External Gateway Error

An external gateway error occurred.

Payee account is locked or closed.

ERROR

PAYEE_ACCOUNT_RESTRICTED

The merchant account is restricted.
To get more information about the status of the account, call Customer Support.

502

1001

External Gateway Error

An external gateway error occurred.

The merchant account is restricted.

ERROR

PAYEE_BLOCKED_TRANSACTION

The fraud settings for this seller are such that this payment cannot be executed.
Verify the fraud settings. Then, retry the transaction.

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

The fraud settings for this seller are such that this payment cannot be executed.
Verify the fraud settings. Then, retry the transaction.

FAILED

PAYER_ACCOUNT_LOCKED_OR_CLOSED

Payer account is locked or closed.
To get more information about the status of the account, call Customer Support.

502

1001

External Gateway Error

An external gateway error occurred.

Payer account is locked or closed.

ERROR

PAYER_ACCOUNT_RESTRICTED

Payer account is restricted.
To get more information about the status of the account, call Customer Support.

502

1001

External Gateway Error

An external gateway error occurred.

Payer account is restricted.

ERROR

PAYER_CANNOT_PAY

Payer cannot pay for this transaction.
Please contact the payer to find other ways to pay for this transaction.

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

Payer cannot pay for this transaction.

FAILED

PAYER_CONSENT_REQUIRED

The payer has not provided appropriate consent to proceed with this transaction.
To proceed with the transaction, you must get payer consent.

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

The payer has not provided appropriate consent to proceed with this transaction.

FAILED

PAYER_COUNTRY_NOT_SUPPORTED

Payer Country is not supported.
The Payer country is not supported. Redirect the payer to select another funding source.

502

1001

External Gateway Error

An external gateway error occurred.

Payer Country is not supported.

ERROR

PAYEE_NOT_ENABLED_FOR_CARD_PROCESSING

The API Caller account is not setup to be able to process card payments. Please contact PayPal customer support.
 

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

The API Caller account is not setup to be able to process card payments.

FAILED

PAYMENT_INSTRUCTION_REQUIRED

You must provide the payment instruction when you capture an authorized payment for intent=AUTHORIZE.
For details, see Capture authorization. For intent=CAPTURE, send the payment instruction when you create the order.

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

You must provide the payment instruction when you capture an authorized payment for intent=AUTHORIZE.

FAILED

PERMISSION_DENIED

You do not have permission to access or perform operations on this resource.
If you make API calls on behalf of a merchant or payee, ensure that you have been granted appropriate permissions to continue with this request.

502

1001

External Gateway Error

An external gateway error occurred.

You do not have permission to access or perform operations on this resource.

ERROR

POSTAL_CODE_REQUIRED

The specified country requires a postal code.
Specify a postal code and try the request again.

502

1001

External Gateway Error

An external gateway error occurred.

The specified country requires a postal code.
Specify a postal code and try the request again.

ERROR

PREFERRED_SHIPPING_OPTION_AMOUNT_MISMATCH

The requested action could not be performed, semantically incorrect, or failed business validation.
The amount provided in the preferred shipping option should match the amount provided in amount breakdown.

502

1001

External Gateway Error

An external gateway error occurred.

The requested action could not be performed, semantically incorrect, or failed business validation.
The amount provided in the preferred shipping option should match the amount provided in amount breakdown.

ERROR

REDIRECT_PAYER_FOR_ALTERNATE_FUNDING

Transaction failed. Redirect the payer to select another funding source.
 

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

The transaction failed. Redirect the payer to select another funding source.

FAILED

REFERENCE_ID_NOT_FOUND

Filter expression value is incorrect.
Check the value of the reference_id and try the request again.

502

1001

External Gateway Error

An external gateway error occurred.

Filter expression value is incorrect.
Check the value of the reference_id and try the request again.

ERROR

REFERENCE_ID_REQUIRED

'reference_id' is required for each 'purchase_unit' if multiple 'purchase_unit' are provided.
Provide a unique value for reference_id for each purchase_unit and try the request again.

502

1001

External Gateway Error

An external gateway error occurred.

'reference_id' is required for each 'purchase_unit' if multiple 'purchase_unit' are provided.
Provide a unique value for reference_id for each purchase_unit and try the request again.

ERROR

DUPLICATE_REFERENCE_ID

reference_id must be unique if multiple purchase_unit are provided.
Provide a unique value for reference_id for each purchase_unit and try the request again.

502

1001

External Gateway Error

An external gateway error occurred.

reference_id must be unique if multiple purchase_unit are provided.
Provide a unique value for reference_id for each purchase_unit and try the request again.

ERROR

SHIPPING_ADDRESS_INVALID

Provided shipping address is invalid.
 

502

1001

External Gateway Error

An external gateway error occurred.

Provided shipping address is invalid.

ERROR

SHIPPING_OPTION_NOT_SELECTED

The requested action could not be performed, semantically incorrect, or failed business validation.
At least one of the shipping.option values must be selected = true.

502

1001

External Gateway Error

An external gateway error occurred.

The requested action could not be performed, semantically incorrect, or failed business validation.
At least one of the shipping.option values must be selected = true.

ERROR

SHIPPING_OPTIONS_NOT_SUPPORTED

Shipping options are not supported when application_context.shipping_preference is set as NO_SHIPPING or SET_PROVIDED_ADDRESS.

502

1001

External Gateway Error

An external gateway error occurred.

Shipping options are not supported when application_context.shipping_preference is set as NO_SHIPPING or SET_PROVIDED_ADDRESS.

ERROR

TAX_TOTAL_MISMATCH

Should equal sum of (tax * quantity) across all items for a given purchase_unit.
The tax total must equal the sum of (tax * quantity) across all items for a purchase_unit.

502

1001

External Gateway Error

An external gateway error occurred.

Should equal sum of (tax * quantity) across all items for a given purchase_unit.
The tax total must equal the sum of (tax * quantity) across all items for a purchase_unit.

ERROR

TAX_TOTAL_REQUIRED

If item details are specified (items.tax_total and items.quantity), the corresponding amount.breakdown.tax_total is required.
The amount.breakdown.tax_total is a required field.

502

1001

External Gateway Error

An external gateway error occurred.

If item details are specified (items.tax_total and items.quantity), the corresponding amount.breakdown.tax_total is required.
The amount.breakdown.tax_total is a required field.

ERROR

TRANSACTION_AMOUNT_EXCEEDS_MONTHLY_MAX_LIMIT

The transaction amount exceeds monthly maximum limit.
To review the monthly transaction limits and retry this transaction, call Customer Support.

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

The transaction amount exceeds monthly maximum limit.

FAILED

TRANSACTION_BLOCKED_BY_PAYEE

The requested action could not be performed, semantically incorrect, or failed business validation.
The transaction was blocked by the payee’s Fraud Protection settings.

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

The requested action could not be performed, semantically incorrect, or failed business validation.
The transaction was blocked by the payee’s Fraud Protection settings.

FAILED

TRANSACTION_LIMIT_EXCEEDED

Total payment amount exceeded transaction limit.
To review the transaction limit and retry this transaction, call Customer Support.

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

Total payment amount exceeded transaction limit.

FAILED

TRANSACTION_RECEIVING_LIMIT_EXCEEDED

The transaction exceeds the payee's receiving limit.
To review the transaction limit and retry this transaction, call Customer Support.

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

The transaction exceeds the payee's receiving limit.

FAILED

TRANSACTION_REFUSED

The transaction was refused.
Verify the transaction and try the request again.

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

The transaction was refused.

Verify the transaction and try the request again.

FAILED

UNSUPPORTED_INTENT

intent=AUTHORIZE is not supported for multiple purchase units. Only intent=CAPTURE is supported.
 

502

1001

External Gateway Error

An external gateway error occurred.

intent=AUTHORIZE is not supported for multiple purchase units. Only intent=CAPTURE is supported.

ERROR

UNSUPPORTED_PAYMENT_INSTRUCTION

Only supported when the intent=CAPTURE.
If intent is AUTHORIZE, you must provide a payment_instruction when you capture payment for the authorization. For details, see capture authorized payment.

502

1001

External Gateway Error

An external gateway error occurred.

If intent is AUTHORIZE, you must provide a payment_instruction when you capture payment for the authorization.

ERROR

PAYEE_ACCOUNT_NOT_SUPPORTED

Payee does not have an account with PayPal. Your current setup requires the 'payee' to have a verified account with PayPal before you can process transactions on their behalf.

502

1001

External Gateway Error

An external gateway error occurred.

Payee does not have an account with PayPal. Your current setup requires the 'payee' to have a verified account with PayPal before you can process transactions on their behalf.

ERROR

PAYEE_ACCOUNT_NOT_VERIFIED

Payee has not verified their account with PayPal. Your current setup requires the 'payee' to have an account with PayPal before you can process transactions on their behalf.

502

1001

External Gateway Error

An external gateway error occurred.

Payee has not verified their account with PayPal. Your current setup requires the 'payee' to have an account with PayPal before you can process transactions on their behalf.

ERROR

PAYEE_NOT_CONSENTED

Payee does not have appropriate consent to allow the API caller to process this type of transaction on their behalf. Your current setup requires the 'payee' to provide a consent before this transaction can be processed successfully.

402

ALTERNATE-PAYMENTS-GATEWAY-4 

Transaction declined

The transaction was declined by the processing gateway.

Payee does not have appropriate consent to allow the API caller to process this type of transaction on their behalf. Your current setup requires the 'payee' to provide a consent before this transaction can be processed successfully.

FAILED