Customer Errors
The following error codes and messages appear in REST responses when an error prevents completion of the request.
Error Code | Description |
|---|---|
CREDIT_CARD_EXISTS | The request tried to add a credit card to a customer, but the customer already has this card as a payment method. The request was rejected. Corrective action: None. Determine why an attempt was made to add the same card twice. |
CUSTOMER_ALREADY_ASSIGNED_TO_EWALLET | The request tried to add a wallet to a customer, but the customer already has a wallet. The request was rejected. Corrective action: Create a new customer and add the wallet to the new customer. |
DELETE_CUSTOMER_DEFAULT_PAYMENT_METHOD_NOT_ALLOWED | The request tried to delete the default payment method from a customer, but this operation is not allowed. The request was rejected. Corrective action: Assign another payment method to be the default payment method, then repeat the delete request. |
ERROR_CREATE_CUSTOMER | The request tried to create or update a customer, but the wallet ID provided is already in use by another customer. The request was rejected. Corrective action: Create a new wallet. |
ERROR_CUSTOMER_DATA_MISSING | The request attempted an operation that requires a customer, but required data in the customer is missing. The request was rejected. Corrective action: Use 'Update Customer' to correct the values of all of the fields listed at the end of the error code. For more information, see the API Reference. |
ERROR_CREATE_CUSTOMER_EWALLET_ALREADY_IN_USE | The request tried to add a wallet to a customer, but the proposed wallet belongs to a different customer. The request was rejected. Corrective action: For 'ewallet', use the ID of a wallet that does not already belong to a customer. |
ERROR_DEFAULT_PAYMENT_METHOD_BELONGS_TO_DIFFERENT_CUSTOMER | The request tried to update a customer, but the proposed default payment method belongs to a different customer. The request was rejected. Corrective action: For 'default_payment_method', use a payment method that belongs to the customer you want to update. |
ERROR_DELETE_CUSTOMER | The request tried to delete a customer, but the operation failed. Corrective action: Determine whether the customer was already deleted, and why there were multiple requests to delete it. |
ERROR_DELETE_CUSTOMER_DISCOUNT | The request tried to delete a discount from a customer, but the operation failed. Corrective action: Determine whether the discount was already deleted, and why there were multiple requests to delete it. |
ERROR_GET_CUSTOMER | The request attempted an operation that requires the ID of a customer, but the customer was not found. The request was rejected. Corrective action: Use the correct ID of the customer, a string starting with 'cus_'. |
ERROR_GET_PAYMENT_METHOD | The request attempted an operation that requires the ID of a payment method, but the payment method was not found for the customer. The request was rejected. Corrective action: Add a valid payment method to the customer. |
ERROR_QUERY_DATE_RANGE_EXCEEDS_90_DAYS | The request included temporal query parameters for defining a date range, but the date range defined via the IDs of the objects exceeds 90 days. Corrective action: Create a query where the date range does not exceed 90 days. |
INVALID_CUSTOMER | The request attempted an operation that requires a valid customer ID, but the customer was not found. The request was rejected. Corrective action: Use the correct customer, or create a new customer. |
INVALID_CUSTOMER_EMAIL | The request attempted an operation that requires a valid email address, but the information was not in proper email address format. The request was rejected. Corrective action: Use the correct format for an email address. |
INVALID_CUSTOMER_FIRST_OR_LAST_NAME | The request attempted an operation that requires a customer, but the customer did not have a valid first name or last name. The request was rejected. Corrective action: Create a customer that has all fields required for this operation. Run 'Get Payment Method Required Fields'. |
INVALID_CUSTOMER_ID | The request attempted an operation that requires a valid customer ID, but the customer was not found. The request was rejected. Corrective action: Use the correct customer, or create a new customer. |
INVALID_CUSTOMER_NAME | The request tried to create a customer, but the name was missing. The request was rejected. Corrective action: In the 'name' field, provide the customer's full name. |
INVALID_CUSTOMER_PHONE_NUMBER | The request tried to create a customer, but the phone number was not recognized. The request was rejected. Corrective action: Provide the customer's phone number in proper E.164 format. |
INVALID_REQUIRED_PAYMENT_METHOD_FIELDS | The request tried to create or update a customer, or add or update a payment method for a customer, but a required field in the payment method was not found. The request was rejected. Corrective action: Use all fields required for the payment method. |
INVALID_TOKENS_LIMIT | The request tried to retrieve a list of customers, but the value for the 'limit' query parameter was more than 30. The request was rejected. Corrective action: Set 'limit' from 1-30. |