Payment Method Errors
The following error codes and messages appear in REST responses when an error prevents completion of the request.
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. |