Skip to main content
PrimerClientError is the type of errors returned by the SDK. Each error is described by an error code and description it may include contextual information.

Properties

Error Codes, Descriptions and Recovery Suggestions

Error CodeDescriptionRecovery Suggestion
NO_PAYMENT_METHODS
PRIMER_TEARDOWNN/A
PRIMER_SERVER_ERRORCheck the description for HTTP error information.
THREE_DS_AUTH_FAILEDHappens when ThreeDS authentication failed.Check the error description for details.
TOKENIZATION_ERRORCheck the error message returned during tokenization.
DUPLICATE_PAYMENT_METHOD_ERRORIndicates that the payment method is already vaulted.
CARD_NUMBER_ERRORIndicates the provided card number is invalid.Display a validation error to the user.
RESUME_ERRORIndicates that the merchant cancelled the payment.N/A - merchant initiated.
VALIDATION_ERRORDisplay a validation error to the user.
PAYMENT_FAILEDPayment failed after tokenization.Check the error for details on what went wrong.
PAYMENT_CREATION_ABORTEDPayment creation was aborted prior to completion.N/A - merchant initiated.
PAYMENT_CREATION_DISABLED
CLIENT_SESSION_UPDATE_ERRORFailed to update the client session details.
INVALID_ARGUMENTInvalid information was passed when initialising SDK.Check the error for which argument(s) need updating.
VAULT_FETCHIndicates a failure to fetch vaulted payment methods.Check network connection and client session.
VAULT_DELETEIndicates failure to delete a vaulted payment method.Check that the method hasn’t already been deleted.
HEADLESS_VAULT_MANAGER_VALIDATIONCheck that the method exists in the vault.
CARD_FORM_VALIDATION_UNEXPECTED_FIELDThe field was not defined for the payment method.Removed the field and re-submit the payment.
MISSING_FIRST_NAME_OR_LAST_NAMEFor Apple Pay, indicates a missing name field.The user must provide both names in their Apple wallet.
IDEMPOTENCY_KEY_ALREADY_EXISTSA payment with the provided idempotency key already exists.Use a unique idempotency key for each payment request.