Skip to main content

Error Codes

The following is a list of Purse Headless Checkout SDK error codes, their descriptions, additional payload and occasionally information about how to resolve them. Every PurseHeadlessCheckoutError object links to this list in its documentationLink attribute

ELEMENT_NOT_FULFILLED​

Description​

This error indicates happens when you try to set a primary method as the primary source of payment and indicates that this source is not fulfilled.

Additional Payload​

type additionalPayload = never;

EXPIRED_SESSION​

Description​

This error indicates that the provided client session has expired. See Create a Client Session to generate a new session and Client Session Reference to learn more about Client Session.

Additional Payload​

type additionalPayload = never;

FAILED_TO_ADD_TOKEN​

Description​

This error indicates that the attempt to add a new token has failed.

Additional Payload​

type additionalPayload = {
  partner: string;
  method: string;
};

FAILED_TO_DELETE_ALL_TOKENS​

Description​

This error indicates that the attempt to delete all tokens has failed.

Additional Payload​

type additionalPayload = {
  error: {
    message: string;
    stack: string;
  }
};

FAILED_TO_INIT_SECONDARY_TOKEN​

Description​

This error indicates that the initialization of a secondary method token has failed.

Additional Payload​

type additionalPayload = never;

INVALID_INIT_PARAMS​

Description​

This error indicates that the initialization parameters provided to the createHeadlessCheckout method are invalid. Ensure that all required parameters are provided and correctly formatted.

Additional Payload​

Missing parameters will be listed in the additional payload.

type additionalPayload = string;

INVALID_LOAN_SIMULATION​

Description​

This error indicates that the loan simulation is either not available or failed.

Additional Payload​

An error might be forwarded in the additional payload if the simulation was possible but failed.

type additionalPayload = {
  error: {
    message: string;
    stack: string;
  }
};

INVALID_TAKE_AMOUNT​

Description​

This error indicates that you are trying to perform a take operation on a secondary token with an invalid amount.

Additional Payload​

Additional payload contains more information about why the amount is invalid.

type additionalPayload = string;

INVALID_TOKEN_NAME​

Description​

This error indicates that the token name you are trying to use is invalid. Ensure that the token name meets the required format and length (/^[a-zA-Z0-9\s]{1,25}$/).

Additional Payload​

type additionalPayload = never;

METHOD_NOT_IMPLEMENTED​

Description​

This error indicates that you are trying to invoke a method that is not implemented on the object.

Additional Payload​

type additionalPayload = string;

MISSING_SESSION​

Description​

This error indicates that the payment session is missing. Ensure that your PurseHeadlessCheckout instance is initialized correctly with a Client Session.

Additional Payload​

type additionalPayload = string | undefined;

MISSING_TOKEN​

Description​

This error indicates that you are trying to use a token that does not exist. Ensure that the token ID you are using is correct and that the token has been successfully registered before attempting to use it.

Additional Payload​

type additionalPayload = never;

MISSING_WALLET_SESSION​

Description​

This error indicates that the wallet session is missing. Ensure that the wallet system is correctly configured on your Entity.

Additional Payload​

type additionalPayload = never;

PAYMENT_METHOD_NOT_FOUND​

Description​

This error indicates that you are trying to perform an action with an unknown payment method.

Additional Payload​

type additionalPayload = {
  partner: string;
  method: string;
};

PAYMENT_NOT_FULFILLED_ON_SUBMIT​

Description​

This error indicates that you are trying to submit a payment but the payment form is not fulfilled yet.

Additional Payload​

type additionalPayload = never;

POST_VALIDATE_FAILED​

Description​

This error indicates that the postValidate step of the payment process has failed.

Additional Payload​

type additionalPayload = never;

SECONDARY_METHOD_REQUIRED_CVV​

Description​

This error indicates that the CVV is missing for the selected secondary payment method.

Additional Payload​

type additionalPayload = never;

SECONDARY_METHOD_WRONG_CVV_FORMAT​

Description​

This error indicates that the CVV format is incorrect for the selected secondary payment method.

Additional Payload​

type additionalPayload = never;

SECONDARY_METHOD_WRONG_PAN_FORMAT​

Description​

This error indicates that the PAN format is incorrect for the selected secondary payment method.

Additional Payload​

type additionalPayload = never;

SET_WALLET_SESSION_FAILED​

Description​

This error indicates that setting the wallet session has failed. Ensure that the wallet system is correctly configured on your Entity.

Additional Payload​

The message and stack trace from the original error are forwarded in the additional payload.

type additionalPayload = {
  error: {
    message: string;
    stack: string;
  }
};

TOKEN_NAME_EXISTS​

Description​

This error indicates that the token name you are trying to use already exists. Ensure that you are using a unique name when registering a new token or editing an existing one.

Additional Payload​

type additionalPayload = never;

TOKEN_NOT_REGISTERABLE​

Description​

This error indicates that the token is not registerable. Ensure that the payment method supports tokenization and that the wallet system is correctly configured on your Entity.

Additional Payload​

type additionalPayload = never;

TOKEN_NOT_REGISTERED​

Description​

This error indicates that the token is not registered and thus making the action you are trying to perform not possible. Ensure that the token has been successfully registered before attempting to use it.

Additional Payload​

type additionalPayload = never;

UI_VALIDATION_FAILED_ERROR​

Description​

This error indicates that the preValidate step of the payment process has failed.

Additional Payload​

type additionalPayload = never;

UNKNOWN_ERROR​

Description​

This error indicates that an unknown error has occurred.

Additional Payload​

type additionalPayload = {
  error: {
    message: string;
    stack: string;
  }
};

USAGE_LIMIT_ERROR​

Description​

This error indicates that a usage limit has been reached for a secondary payment method.

Additional Payload​

type additionalPayload = {
  partner: string;
  method: string;
};

VALIDATE_FAILED​

Description​

This error indicates that the validate step of the payment process has failed.

Additional Payload​

type additionalPayload = never;