Skip to main content

Documentation

Payment Method Errors

Error Code

Description

ERROR_GET_PAYMENT_METHOD_TYPE

The request attempted an operation that requires a payment method, but the payment method type was not recognized or is not available for this merchant. Corrective action: For the 'type' field in the 'payment_method' object or in the 'data' object, use a payment method type that this merchant is authorized to use.

ERROR_PAYMENT_METHOD_EXPIRED

The request attempted an operation that requires a payment method, but the payment method has expired. The request was rejected. Corrective action: Use a different payment method or use 'Add Payment Method to Customer' to refresh the payment method. Advise the customer to complete the authentication process.

ERROR_UPDATE_CARD_CVV_NOT_UPDATABLE

The request tried to update a card, but it tried to set a new value for the 'cvv' field. The 'cvv' field cannot be updated. The request was rejected. Corrective action: Do not change the 'cvv' field.

ERROR_UPDATE_PAYMENT_METHOD

The request tried to update a payment method, but one or more fields were missing or contained incorrect values. The request was rejected. Corrective action: Check all input fields. For details, see the API Reference.

INVALID_CARD_EXPIRATION_DATE

The request attempted an operation that requires a card payment method, but the card expiration date was not valid. The request was rejected. Corrective action: In the 'fields' object, set 'expiration_month' to a 2-digit number between 01 and 12, and set 'expiration_year' to a 2-digit number greater than or equal to the last two digits of the current year.

INVALID_PAYMENT_METHOD

The request tried to perform an operation that requires a payment method, but the payment method was not found. The request was rejected. Corrective action: Use the correct payment method ID or payment method object.

INVALID_PAYMENT_METHOD_TYPE

The request tried to perform an operation that requires a payment method type, but the type was not recognized. The request was rejected. Corrective action: To find payment method types for a country, use 'List Payment Methods by Country'.

INVALID_REQUIRED_PAYMENT_METHOD_FIELDS

The request attempted an operation that requires a payment method, but the required fields were missing. The request was rejected. Corrective action: Run 'Get Payment Method Required Fields'. Inside the 'payment_method' object, populate the 'fields' object with all required fields.

MISSING_PAYMENT_METHOD_REQUIRED_FIELD

The request attempted an operation that requires fields for a payment method, but a field parameter was missing or did not have a valid value. The request was rejected. Corrective action: The end of the response_code shows the name of the field. Provide this field with a proper value.

PAYMENT_METHOD_FIELD_NOT_UPDATABLE

The request tried to update a payment method of a customer, but it tried to set a new value for a field that does not exist or is not modifiable. The request was rejected. Corrective action: Do not change the value of the field named at the end of the error code.

UNKNOWN_PAYMENT_METHOD_FIELD

The request attempted an operation that requires an object describing a payment method, but there was an extra field in the 'fields' object. The name of the extra field appears at the end of the response code. The request was rejected. Corrective action: Populate the 'fields' object with only the fields that are required.