Page Comparison

...

Expand

title	Description errors

Payment method	Paycomet Code	Public Message (Logs/Amplitude)	Error Code	Lokalise key description error modal: `error.payment.X.XXX` title error modal: `error.payment.X.XXX.title` label button modal: `error.payment.X.XXX.cta`	Severity	Class Error	Parent class	Documentation
Card	100	Expired credit card	`PAYMENT.2.100.103`	`error.payment.2.100.103` `error.payment.2.100.103.tilte` `error.payment.2.100.103.cta`	2	ExpiredCardError	CardError2	Represents an error when the card has expired
Card	105	Insufficient funds	`PAYMENT.2.100.104`	`error.payment.2.100.104` `error.payment.2.100.104.title` `error.payment.2.100.104.cta`	2	NoFundsCardError	CardError2	Represents an error when the card does not have enough funds in order to perform the payment
Card	127	Invalid parameter	`PAYMENT.2.001.001`	`error.payment.2.001.001` `error.payment.2.001.001.title` `error.payment.2.001.001.cta`	2	InvalidParameterError	ExternalValidationError2	Represents an error when there is an invalid parameter
Card	137	Credit card not valid	`PAYMENT.2.100.106`	`error.payment.2.100.106` `error.payment.2.100.106.title` `error.payment.2.100.106.cta`	2	CardNotValidError	CardError2	Represents an error when the card declined for various reasons
Card	141	Amount zero or not valid	`PAYMENT.2.100.107`	`error.payment.2.100.107` `error.payment.2.100.107.title` `error.payment.2.100.107.cta`	2	AmountNotValidError	NoFundsCardError	Represents an error when the amount is zero or not valid
Card	143	Authentification error	`PAYMENT.4.001.001`	`error.payment.4.001.001` `error.payment.4.001.001.title` `error.payment.4.001.001.cta`	4	AuthenticationError	AuthSecurityError2	Represents errors related to security and authentication within the payment system. Invalid access tokens, and other related security and authentication problems.
Card	195	Requires SCA authentication	`PAYMENT.4.001.002`	`error.payment.4.001.002` `error.payment.4.001.002.title` `error.payment.4.001.002.cta`	4	ScaAuthenticationError	AuthSecurityError2	Represents an error a Strong Customer Authentication error. SCA (Strong Customer Authentication) is a requirement of the European directive PSD2 (Revised Payment Services Directive) aimed at enhancing the security of online financial transactions
Card	500	General PSP error	`PAYMENT.4.000`	`error.payment.4.000` `error.payment.4.000.title` `error.payment.4.000.cta`	4	PspError2	RbiError2	General, unspecified payment error.
Card	506	Confirmation data not valid	`PAYMENT.4.006.001`	`error.payment.4.006.001` `error.payment.4.006.001.title` `error.payment.4.006.00.cta`	4	ConfirmationDataNotValidError	ExternalError2	Represents an error when confirmation data is not valid
Card	510	Refund is not possible	`PAYMENT.4.010.001`	`error.payment.4.010.001` `error.payment.4.010.001.title` `error.payment.4.010.001.cta`	4	RefundNotPossibleError	OperationDeniedError	Represents an error when the refund is not possible
Card	535	General PSP error	`PAYMENT.4.000`	`error.payment.4.000` `error.payment.4.000.title` `error.payment.4.000.cta`	4	PspError2	RbiError2	General, unspecified payment error.
Card	549	General PSP error	`PAYMENT.4.000`	`error.payment.4.000` `error.payment.4.000.title` `error.payment.4.000.cta`	4	PspError2	RbiError2	General, unspecified payment error.
Card	555	Could not find the previous operation	`PAYMENT.4.009.001`	`error.payment.4.009.001` `error.payment.4.009.001.title` `error.payment.4.009.001.cta`	4	CouldNotFindPreviousOperationError	DataExternalValidationError	Represents an error when could not find the previous operation
Card	569	Denied operation	`PAYMENT.4.010`	`error.payment.4.010` `error.payment.4.010.title` `error.payment.4.010.cta`	4	OperationDeniedError	ExternalValidationError2	Represents an error when the operation cannot be performed
Card	1019	Operation timeout exceeded	`PAYMENT.4.011`	`error.payment.4.011` `error.payment.4.011.title` `error.payment.4.011.cta`	4	TimeOutConnectionError	ConnectionError2	Represents an error when there is a timeout
Card	1026	Duplicated external reference	`PAYMENT.4.006.002`	`error.payment.4.006.002` `error.payment.4.006.002.title` `error.payment.4.006.002.cta`	4	DuplicatedExternalReferenceError	ExternalError2	Represents an error when there is a duplicated external reference
Card	1038	Field DS_MERCHANT_AMOUNT incorrect	`PAYMENT.4.009.002`	`error.payment.4.009.002` `error.payment.4.009.002.title` `error.payment.4.009.002.cta`	4	FieldDsMerchantAmountIncorrectErrorDataExternalValidationErrorDataExternalValidationError	ExternalValidationError2	Represents an error when the field DS_MERCHANT_AMOUNT is incorrect
Card	1099	General PSP error	`PAYMENT.4.000`	`error.payment.4.000` `error.payment.4.000.title` `error.payment.4.000.cta`	4	PspError2	RbiError2	General, unspecified payment error.
Card	1186	Maximum limit not allowed	`PAYMENT.2.102.004`	`error.payment.2.102.004` `error.payment.2.102.004.title` `error.payment.2.102.004.cta`	2	CardLimitExceededError	PaymentRestrictionError2	Represents an error when the card amount/number of transaction limit has been exceeded
Card	1191	Day / IP address limit (all cards) not allowed	`PAYMENT.2.102.004`	`error.payment.2.102.004` `error.payment.2.102.004.title` `error.payment.2.102.004.cta`	2	CardLimitExceededError	PaymentRestrictionError2	Represents an error when the card amount/number of transaction limit has been exceeded
Card	1194	Card brands not allowed	`PAYMENT.2.100.006`	`error.payment.2.100.006` `error.payment.2.100.006.title` `error.payment.2.100.006.cta`	2	CardTypeNotAllowedError	CardError2	Represents an error when the card type (type/brand/etc.) is not allowed for this transaction
Card	1197	Denied. Filter: Card country issuer not allowed	`PAYMENT.2.102.005`	`error.payment.2.102.005` `error.payment.2.102.005.title` `error.payment.2.102.005.cta`	2	CardCountryNotAllowed	PaymentRestrictionError2	Represents an error when the card / issuing bank country is not allowed for the transaction
Card	1254	Commerce with secure cardholder and cardholder without secure purchase key	`PAYMENT.4.001.004`	`error.payment.4.001.004` `error.payment.4.001.004.title` `error.payment.4.001.004.cta`	4	CardholderSecurePurchaseKeyError	AuthSecurityError2	Represents an error when there is a commerce with secure cardholder and cardholder without secure purchase key
Card	1326	Denial by security controls on the processor	`PAYMENT.2.002`	`error.payment.2.002` `error.payment.2.002.title` `error.payment.2.002.cta`	2	FraudError	ExternalError2	Represents errors generated when a transaction is suspected of being fraudulent. This class extends `ExternalError` to encapsulate fraud-related issues, including abnormal user behavior, suspicious transaction patterns, and other indicators of potential fraud. It is designed to aid in the identification and management of transactions that may pose a risk to the payment system
Card	1327	3DS authentication process error	`PAYMENT.2.101.003`	`error.payment.2.101.003` `error.payment.2.101.003.title` `error.payment.2.101.003.cta`	2	ThreeDsChallengeFailedError	PaymentProcessingError2	Represents an error when the 3DS Challenge failed
Payment Link	1417	PayPal - The instrument presented has been declined. Please select another one.	`PAYMENT.2.100.105`	`error.payment.2.100.105` `error.payment.2.100.105.title` `error.payment.2.100.105.cta`	2	DeclinedCardError	CardError2	Represents an error when the card declined for various reasons

...

Expand

title	ExpiredCardError details

Code Block

language	typescript

import { HttpStatus } from '@nestjs/common';
import { CardError2, RbiPaymentErrorCodes, TPspError2 } from '../psp-error-2';

export class ExpiredCardError extends CardError2 {
  /**
   * Represents an error when the card has expired.
   *
   * @param params - The error parameters.
   * @param [params.httpStatus] - The HTTP status code to be returned in the response.
   * @param [params.message] - A human-readable message that provides details about the payment processing issue.
   * @param [params.metadata] - Optional metadata that may include additional context or details about the error.
   * @param [params.originalError] - The original error that caused this error.
   */
  constructor(params?: TPspError2) {
    const {
      httpStatus = HttpStatus.UNPROCESSABLE_ENTITY,
      metadata,
      rbiErrorCode = RbiPaymentErrorCodes.EXPIRED_CARD_ERROR,
    } = params ?? {};
    super({ ...params, httpStatus, metadata, rbiErrorCode });
  }
}

Expand

title	FieldDsMerchantAmountIncorrectError InvalidParameterError details

Code Block

language	typescript

import { HttpStatus } from '@nestjs/common';
import { ExternalValidationError2, RbiPaymentErrorCodes, TPspError2 } from '../psp-error-2';
import { DataExternalValidationError } from './data-external-validation-error';

export class FieldDsMerchantAmountIncorrectErrorInvalidParameterError extends DataExternalValidationErrorExternalValidationError2 {
  /**
   * Represents an error when thethere field DS_MERCHANT_AMOUNT is incorrectis an invalid parameter.
   *
   * @param params - The error parameters.
   * @param [params.httpStatus] - The HTTP status code to be returned in the response.
   * @param [params.message] - A human-readable message that provides details about the payment processing issue.
   * @param [params.metadata] - Optional metadata that may include additional context or details about the error.
   * @param [params.originalError] - The original error that caused this error.
   */
  constructor(params?: TPspError2) {
    const {
      httpStatus = HttpStatus.UNPROCESSABLE_ENTITY,
      metadata,
      rbiErrorCode = RbiPaymentErrorCodes.FIELD_DS_MERCHANT_AMOUNT_INCORRECT_INVALID_PARAMETER_ERROR,
    } = params ?? {};
    super({ ...params, httpStatus, metadata, rbiErrorCode });
  }
}

Expand

title	InvalidParameterError NoFundsCardError details

Code Block

language	typescript

import { HttpStatus } from '@nestjs/common';
import { ExternalValidationError2CardError2, RbiPaymentErrorCodes, TPspError2 } from '../psp-error-2';

export class InvalidParameterErrorNoFundsCardError extends ExternalValidationError2CardError2 {
  /**
   * Represents an error when there is an invalid parameter the card does not have enough funds in order to perform the payment.
   *
   * @param params - The error parameters.
   * @param [params.httpStatus] - The HTTP status code to be returned in the response.
   * @param [params.message] - A human-readable message that provides details about the payment processing issue.
   * @param [params.metadata] - Optional metadata that may include additional context or details about the error.
   * @param [params.originalError] - The original error that caused this error.
   */
  constructor(params?: TPspError2) {
    const {
      httpStatus = HttpStatus.UNPROCESSABLE_ENTITY,
      metadata,
      rbiErrorCode = RbiPaymentErrorCodes.INVALIDNO_FUNDS_PARAMETERCARD_ERROR,
    } = params ?? {};
    super({ ...params, httpStatus, metadata, rbiErrorCode });
  }
}

Expand

title	NoFundsCardError OperationDeniedError details

Code Block

language	typescript

import { HttpStatus } from '@nestjs/common';
import { CardError2ExternalValidationError2, RbiPaymentErrorCodes, TPspError2 } from '../psp-error-2';

export class NoFundsCardError extends CardError2 {
  /**
   * Represents an error when the card does not have enough funds in order to perform the payment.
   *
   * @param params - The error parameters.
   * @param [params.httpStatus] - The HTTP status code to be returned in the response.
   * @param [params.message] - A human-readable message that provides details about the payment processing issue.
   * @param [params.metadata] - Optional metadata that may include additional context or details about the error.
   * @param [params.originalError] - The original error that caused this error.
   */
  constructor(params?: TPspError2) {
    const {
      httpStatus = HttpStatus.UNPROCESSABLE_ENTITY,
      metadata,
      rbiErrorCode = RbiPaymentErrorCodes.NO_FUNDS_CARD_ERROR,
    } = params ?? {};
    super({ ...params, httpStatus, metadata, rbiErrorCode });
  }
}

Expand

title	OperationDeniedError details

Code Block

language	typescript

import { HttpStatus } from '@nestjs/common';
import { ExternalValidationError2, RbiPaymentErrorCodes, TPspError2 } from '../psp-error-2';

export class OperationDeniedError extends ExternalValidationError2 {
  /OperationDeniedError extends ExternalValidationError2 {
  /**
   * Represents an error when the operation cannot be performed.
   *
   * @param params - The error parameters.
   * @param [params.httpStatus] - The HTTP status code to be returned in the response.
   * @param [params.message] - A human-readable message that provides details about the payment processing issue.
   * @param [params.metadata] - Optional metadata that may include additional context or details about the error.
   * @param [params.originalError] - The original error that caused this error.
   */
  constructor(params?: TPspError2) {
    const {
      httpStatus = HttpStatus.UNPROCESSABLE_ENTITY,
      metadata,
      rbiErrorCode = RbiPaymentErrorCodes.OPERATION_DENIED_ERROR,
    } = params ?? {};
    super({ ...params, httpStatus, metadata, rbiErrorCode });
  }
}

...

Expand

title	SpecificRbiPaymentErrorCodes details

Code Block

language	typescript

const SpecificRbiPaymentErrorCodes = {
  ...
  AMOUNT_NOT_VALID_ERROR: '2.100.107',
  AUTHENTICATION_ERROR: '4.001.001',
  EXPIRED_CARD_ERROR: '2.100.103',
  NO_FUNDS_CARD_ERROR: '2.100.104',
  DECLINED_CARD_ERROR: '2.100.105',
  CARD_NOT_VALID_ERROR: '2.100.106',
  CARD_LIMIT_EXCEEDED_ERROR: '2.102.004',
  CARD_TYPE_NOT_ALLOWED_ERROR: '2.100.006',
  CARD_COUNTRY_NOT_ALLOWED_ERROR: '2.102.005',
  SCA_AUTHENTICATION_ERROR: '4.001.002',
  THREE_DS_CHALLENGE_FAILED_ERROR: '2.101.003',
  INVALID_PARAMETER_ERROR: '2.001.001',
  CONFIRMATION_DATA_NOT_VALID_ERROR: '4.006.001',
  REFUND_NOT_POSSIBLE_ERROR: '4.010.001',
  COULD_NOT_FIND_PREVIOUS_OPERATION_ERROR: '4.009.001',
  DUPLICATED_EXTERNAL_REFERENCE_ERROR: '4.006.002',
  FIELD_DS_MERCHANT_AMOUNT_INCORRECT_ERROR: '4.009.002',
  CARDHOLDER_SECURE_PURCHASE_KEY_ERROR: '4.001.003',
} as const;

...

Expand

title	errorMap detailed

Code Block

language	typescript

export const errorMap: PspErrorMap = new Map([
  ...
  [
    100,
    {
      classNameRef: ExpiredCardError,
      info: 'Expired credit card',
    },
  ],
  [
    105,
    {
      classNameRef: NoFundsCardError,
      info: 'Insufficient funds',
    },
  ],
  [
    127,
    {
      classNameRef: InvalidParameterError,
      info: 'Invalid parameter',
    },
  ],
  [
    137,
    {
      classNameRef: CardNotValidError,
      info: 'Credit card not valid',
    },
  ],
  [
    141,
    {
      classNameRef: AmountNotValidError,
      info: 'Amount zero or not valid',
    },
  ],
  [
    143,
    {
      classNameRef: AuthenticationError,
      info: 'Authentification error',
    },
  ],
  [
    195,
    {
      classNameRef: ScaAuthenticationError,
      info: 'Requires SCA authentication',
    },
  ],
  [
    500,
    {
      classNameRef: PspError2,
      info: 'General PSP error',
    },
  ],
  [
    506,
    {
      classNameRef: ConfirmationDataNotValidError,
      info: 'Confirmation data not valid',
    },
  ],
  [
    510,
    {
      classNameRef: RefundNotPossibleError,
      info: 'Refund is not possible',
    },
  ],
  [
    535,
    {
      classNameRef: PspError2,
      info: 'General PSP error',
    },
  ],
  [
    549,
    {
      classNameRef: PspError2,
      info: 'General PSP error',
    },
  ],
  [
    555,
    {
      classNameRef: CouldNotFindPreviousOperationError,
      info: 'Could not find the previous operation',
    },
  ],
  [
    569,
    {
      classNameRef: OperationDeniedError,
      info: 'Denied operation',
    },
  ],
  [
    1019,
    {
      classNameRef: TimeOutConnectionError,
      info: 'Operation timeout exceeded',
    },
  ],
  [
    1026,
    {
      classNameRef: DuplicatedExternalReferenceError,
      info: 'Duplicated external reference',
    },
  ],
  [
    1038,
    {
      classNameRef: FieldDsMerchantAmountIncorrectErrorDataExternalValidationError,
      info: 'Field DS_MERCHANT_AMOUNT incorrect',
    },
  ],
  [
    1099,
    {
      classNameRef: PspError2,
      info: 'General PSP error',
    },
  ],
  [
    1186,
    {
      classNameRef: CardLimitExceededError,
      info: 'Maximum limit not allowed',
    },
  ],
  [
    1191,
    {
      classNameRef: CardLimitExceededError,
      info: 'Day / IP address limit (all cards) not allowed',
    },
  ],
  [
    1194,
    {
      classNameRef: CardTypeNotAllowedError,
      info: 'Card brands not allowed',
    },
  ],
  [
    1197,
    {
      classNameRef: CardCountryNotAllowed,
      info: 'Denied. Filter: Card country issuer not allowed',
    },
  ],
  [
    1254,
    {
      classNameRef: CardholderSecurePurchaseKeyError,
      info: 'Commerce with secure cardholder and cardholder without secure purchase key',
    },
  ],
  [
    1326,
    {
      classNameRef: FraudError2,
      info: 'Denial by security controls on the processor',
    },
  ],
  [
    1327,
    {
      classNameRef: ThreeDsChallengeFailedError,
      info: '3DS authentication process error',
    },
  ],
  [
    1417,
    {
      classNameRef: DeclinedCardError,
      info: 'PayPal - The instrument presented has been declined. Please select another one.',
    },
  ],
]);

...

Versions Compared

Old Version 45

New Version 46

Key