/
Feature - More detailed error messages

Feature - More detailed error messages

Overview

Currently, issues on our platform are presented through error modal events in Amplitude. While this approach is functional, it has significant limitations, focusing only on the appearance of the modal and failing to provide a clear view of the actual source of the problems. Error modals can represent both front-end and back-end failures, arising from various factors such as configuration errors, improper implementation, partner integrations, and user-induced errors. Currently, there is no clear path to understand fluctuations in error modals, which hinders the team's ability to identify friction points that users experience on our platform.

We will implement a protocol to send errors with an initial layer of granularity to mParticle, allowing for more effective use in Amplitude, providing immediate insights into the causes of variations and enabling deeper analysis.

To address these issues, a list of error codes has been proposed for documentation:

  

This feature has a flag called enable-rbi-error-2 which should be enabled to be used.

To enable, this flag please contact your CSM.

 

Analytics

event

Name

Value

Name

Value

name

ERROR

type

Other = 8

attributes

Name

e.g. Value

Name

e.g. Value

'Error Code'

PAYMENT.2.001

Name

CVC2 block incorrect

Path

/cart/payment

'Response Title' (modal title)

title: Uh oh!

'Response Description' (modal description - User-friendly Messages)

description: The CVC number is incorrect. Please look carefully at your card details. This number is 3 figures and is usually on the back of your card. If the charge has been pre-authorized on your card, we will reimburse you within a maximum period of seven days.

Error Messages

Paycomet Error

Description

Message Lokalise Key

Title Lokalise Key

CTA Lokalise Key

Paycomet Error

Description

Message Lokalise Key

Title Lokalise Key

CTA Lokalise Key

100

Expired Card -
Represents an error when the card has expired

error.payment.2.100.003

error.payment.2.100.003.title

error.payment.2.100.003.cta

102

Operation not allowed for the credit card type

error.payment.2.001

error.payment.2.001.title

error.payment.2.001.cta

105

Insufficient Credit to make charge - Represents an error when the card does not have enough funds in order to perform the payment

error.payment.2.100.004

error.payment.2.100.004.title

error.payment.2.100.004.cta

111

The payment transaction was rejected because the user informed an invalid card CVV.

error.payment.2.100.001

error.payment.2.100.001.title

error.payment.2.100.001.cta

115

The payment transaction was rejected because card issuer could not validate card owner's identity.

error.payment.2.101.001

error.payment.2.101.001.title

error.payment.2.101.001.cta

127, and 1038

  • Invalid Parameter -
Represents an error when there is an invalid parameter

  • Incorrect DS_MERCHANT_AMOUNT field - Represents an error when the field DS_MERCHANT_AMOUNT is incorrect

error.payment.4.009

error.payment.4.009.title

error.payment.4.009.cta

130

Represents an error related to credit/debit card transactions.

error.payment.2.100

error.payment.2.100.title

error.payment.2.100.cta

137

Invalid Card - Represents an error when the card declined for various reasons

 

error.payment.2.100.006

error.payment.2.100.006.title

error.payment.2.100.006.cta

141

Zero or Invalid Quantity - Represents an error when the amount is zero or not valid

error.payment.2.100.007

error.payment.2.100.007.title

error.payment.2.100.007.cta

142, 1425, 1342

Represents an error when the operation was cancelled.

  • An example of occurrence is when the user cancel the payment.

 

142: Operation cancelled

 

1425: Paypal transaction cancelled

 

1342: Bizum transaction cancelled

error.payment.2.005

error.payment.2.005.title

error.payment.2.005.cta

143

Authentication error - Represents errors related to security and authentication within the payment system.
Invalid access tokens, and other related security and authentication problems.

error.payment.4.001.001

error.payment.4.001.001.title

error.payment.4.001.001.cta

195

Requires SCA Authentication -

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

error.payment.4.001.002

error.payment.4.001.002.title

error.payment.4.001.002.cta

500, 513, 514, 515, 516, 517, 518, 519, 520, 521, 522, 523, 524, 525, 526, 535, 549 and 1099

 

General, unspecified payment error.

error.payment.4.006

error.payment.4.006.title

error.payment.4.006.cta

506

 

Invalid Confirmation Data - Represents an error when confirmation data is not valid

error.payment.4.006.001

error.payment.4.006.001.title

error.payment.4.006.001.cta

510

Return is not possible - Represents an error when the refund is not possible

error.payment.4.010.001

error.payment.4.010.001.title

error.payment.4.010.001.cta

555

Represents an error when could not find the previous operation

error.payment.4.009.001

error.payment.4.009.001.title

error.payment.4.009.001.cta

569

Operation Rejected
(Denied by the issuer) - Represents an error when the operation cannot be performed

error.payment.4.010

error.payment.4.010.title

error.payment.4.010.cta

1019

Request Timed Out - Represents an error when there is a timeout

error.payment.4.011

error.payment.4.011.title

error.payment.4.011.cta

1026

Duplicate external reference - Represents an error when there is a duplicated external reference

error.payment.4.006.002

error.payment.4.006.002.title

error.payment.4.006.002.cta

1185, 1186, 1187, 1188, 1189, 1190, 1191

  • Minimun limit not allowed

  • Maximum limit per transaction not allowed
(Default 1000 Euros)

  • Daily limit not allowed

  • Monthly limit not allowed

  • Max amount (same card / last 24 h.) not allowed

  • Max amount (same card / last 24 h. / same IP address) not allowed

  • Day / IP address limit (all cards) not allowed

error.payment.2.102.004

error.payment.2.102.004.title

error.payment.2.102.004.cta

1192

Represents an error when the user's IP address is not from an allowed country.

Ex.: Iberia payments only allowed from Spain and Portugal.

error.payment.2.102.002

error.payment.2.102.002.title

error.payment.2.102.002.cta

1194

Card Brand not allowed - Represents an error when the card type (type/brand/etc.) is not allowed for this transaction

error.payment.2.100.002

error.payment.2.100.002.title

error.payment.2.100.002.cta

1196, 1197

Authorization from different country than card issuer, not allowed

error.payment.2.102.005

error.payment.2.102.005.title

error.payment.2.102.005.cta

1202

Represents an error when the number of failed attempts from the same user has been exceeded.

error.payment.2.102.003

error.payment.2.102.003.title

error.payment.2.102.003.cta

1254

Attempt to process a secure payment, and the card does not allow it. - Represents an error when there is a commerce with secure cardholder and cardholder without secure purchase key

error.payment.4.001.003

error.payment.4.001.003.title

error.payment.4.001.003.cta

1326

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

error.payment.2.002

error.payment.2.002.title

error.payment.2.002.cta

1327

Denied by security reasons - Represents an error when the 3DS Challenge failed

error.payment.2.101.003

error.payment.2.101.003.title

error.payment.2.101.003.cta

1367

Represents an error when In-Flight offline payments are rejected.

An example of occurrence is when the same card has several payments in "flight" at the time and one is finalized, the rest might be denied.

error.payment.2.101.002

error.payment.2.101.002.title

error.payment.2.101.002.cta

1417

  • PayPal - The instrument presented has been declined. Please select another one. - Represents an error when the card declined for various reasons

 

error.payment.2.100.005

error.payment.2.100.005.title

error.payment.2.100.005.cta

Related content

[Solution] Detailed other's error message
[Solution] Detailed other's error message
More like this
Lokalise keys
Read with this
[Solution] Detailed payment error messages
[Solution] Detailed payment error messages
More like this
[Solution] Support Tool Integration with Homeria API for Email Data Synchronization
[Solution] Support Tool Integration with Homeria API for Email Data Synchronization
Read with this
[Solution] new mandatory parameters VISA/Master/Sibs - new mandatory fields
[Solution] new mandatory parameters VISA/Master/Sibs - new mandatory fields
Read with this
Feature - Fees Configurations
Feature - Fees Configurations
Read with this