Document Status	CLOSED
Document Owner(s)	@de Sousa Santos, Rodrigo (Deactivated)
Reviewers	@Ferreira Gomes, Raphael (Deactivated) @Szekely, Szabolcs (Deactivated) @Augusto Romao, Vinicius (Deactivated) @Garozzo de Sobral, Wellington @Capovilla, Evandro (Deactivated) @Felipe Rooke

1 Context
2 Proposed Solution
- 2.1 Backend
  - - 2.1.1.1 Description errors
    - 2.1.1.2 Created classes:
    - 2.1.1.3 Classes will be created:
  - 2.1.2 intl-packages
  - 2.1.3 intl-psp-paycomet-service
3 Error Messages
4 Potential Challenges
5 Cost
6 Configuration
7 Metrics
8 Delivery Plan
9 QA Plan
10 Call-outs

Context

Iberia proposes the inclusion of new error messages in the error detailing flow, following the established processes in stories:

Story: IBFEC-2647
- Solution: [Solution] Detailed payment error messages
Story: IBFEC-2856
- Solution: [Solution] Detailed Error Message when the user cancel the payment transaction using payment link

The objective is to enhance error communication between the backend and frontend.

Proposed Solution

To address these issues, we propose the creation of new error classes in the backend that will be sent to the frontend. This implementation will include specific error codes for different scenarios, such as payment cancellations, instead of using generic codes. This change will allow the frontend to display more informative and contextualized error messages, improving clarity and the overall user experience.

Backend

After the solution approval, will need to update the below documents with new classes, code errors, and any important things.

Paycomet errors: https://docs.paycomet.com/en/recursos/codigos-de-error
Iberia errors list: Sheet
Payment code errors: https://rbictg.atlassian.net/wiki/spaces/RWLAPPwiki/pages/4858741214
Payment mappers: https://rbictg.atlassian.net/wiki/spaces/RWLAPPwiki/pages/5001150489

Description errors

QTD	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
1	Card	100	Expired credit card	`PAYMENT.2.100.003`	`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
2	Card	105	Insufficient funds	`PAYMENT.2.100.004`	`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
3	Card	127	Invalid parameter	`PAYMENT.4.009`	`error.payment.4.009` `error.payment.4.009.title` `error.payment.4.009.cta`	4	DataExternalValidationError	ExternalValidationError2	Represents an error when there is an invalid parameter
4	Card	137	Credit card not valid	`PAYMENT.2.100.006`	`error.payment.2.100.106` `error.payment.2.100.106.title` `error.payment.2.100.106.cta`	2	DeclinedCardError	CardError2	Represents an error when the card declined for various reasons
5	Card	141	Invalid amount	`PAYMENT.2.100.007`	`error.payment.2.100.107` `error.payment.2.100.107.title` `error.payment.2.100.107.cta`	2	InvalidAmountError	NoFundsCardError	Represents an error when the amount is zero or not valid
6	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.
7	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
8	Card	500	General external error	`PAYMENT.4.006`	`error.payment.4.006` `error.payment.4.006.title` `error.payment.4.006.cta`	4	ExternalError2	PspError2	General, unspecified payment error.
9	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
10	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
11	Card	513	General external error	`PAYMENT.4.006`	`error.payment.4.006` `error.payment.4.006.title` `error.payment.4.006.cta`	4	ExternalError2	PspError2	General, unspecified payment error.
12	Card	514	General external error	`PAYMENT.4.006`	`error.payment.4.006` `error.payment.4.006.title` `error.payment.4.006.cta`	4	ExternalError2	PspError2	General, unspecified payment error.
13	Card	515	General external error	`PAYMENT.4.006`	`error.payment.4.006` `error.payment.4.006.title` `error.payment.4.006.cta`	4	ExternalError2	PspError2	General, unspecified payment error.
14	Card	516	General external error	`PAYMENT.4.006`	`error.payment.4.006` `error.payment.4.006.title` `error.payment.4.006.cta`	4	ExternalError2	PspError2	General, unspecified payment error.
15	Card	517	General external error	`PAYMENT.4.006`	`error.payment.4.006` `error.payment.4.006.title` `error.payment.4.006.cta`	4	ExternalError2	PspError2	General, unspecified payment error.
16	Card	518	General external error	`PAYMENT.4.006`	`error.payment.4.006` `error.payment.4.006.title` `error.payment.4.006.cta`	4	ExternalError2	PspError2	General, unspecified payment error.
17	Card	519	General external error	`PAYMENT.4.006`	`error.payment.4.006` `error.payment.4.006.title` `error.payment.4.006.cta`	4	ExternalError2	PspError2	General, unspecified payment error.
18	Card	520	General external error	`PAYMENT.4.006`	`error.payment.4.006` `error.payment.4.006.title` `error.payment.4.006.cta`	4	ExternalError2	PspError2	General, unspecified payment error.
19	Card	521	General external error	`PAYMENT.4.006`	`error.payment.4.006` `error.payment.4.006.title` `error.payment.4.006.cta`	4	ExternalError2	PspError2	General, unspecified payment error.
20	Card	522	General external error	`PAYMENT.4.006`	`error.payment.4.006` `error.payment.4.006.title` `error.payment.4.006.cta`	4	ExternalError2	PspError2	General, unspecified payment error.
21	Card	523	General external error	`PAYMENT.4.006`	`error.payment.4.006` `error.payment.4.006.title` `error.payment.4.006.cta`	4	ExternalError2	PspError2	General, unspecified payment error.
22	Card	535	General external error	`PAYMENT.4.006`	`error.payment.4.006` `error.payment.4.006.title` `error.payment.4.006.cta`	4	ExternalError2	PspError2	General, unspecified payment error.
23	Card	524	General external error	`PAYMENT.4.006`	`error.payment.4.006` `error.payment.4.006.title` `error.payment.4.006.cta`	4	ExternalError2	PspError2	General, unspecified payment error.
24	Card	525	General external error	`PAYMENT.4.006`	`error.payment.4.006` `error.payment.4.006.title` `error.payment.4.006.cta`	4	ExternalError2	PspError2	General, unspecified payment error.
25	Card	526	General external error	`PAYMENT.4.006`	`error.payment.4.006` `error.payment.4.006.title` `error.payment.4.006.cta`	4	ExternalError2	PspError2	General, unspecified payment error.
26	Card	549	General external error	`PAYMENT.4.006`	`error.payment.4.006` `error.payment.4.006.title` `error.payment.4.006.cta`	4	ExternalError2	PspError2	General, unspecified payment error.
27	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
28	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
29	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
30	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
31	Card	1038	Field DS_MERCHANT_AMOUNT incorrect	`PAYMENT.4.009`	`error.payment.4.009` `error.payment.4.009.title` `error.payment.4.009.cta`	4	DataExternalValidationError	ExternalValidationError2	Represents an error when the field DS_MERCHANT_AMOUNT is incorrect
32	Card	1099	General external error	`PAYMENT.4.006`	`error.payment.4.006` `error.payment.4.006.title` `error.payment.4.006.cta`	4	ExternalError2	PspError2	General, unspecified payment error.
33	Card	1185	Minimun 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 Minimun limit not allowed
34	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
35	Card	1187	Daily 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 Daily limit not allowed
36	Card	1188	Monthly 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 Monthly limit not allowed
37	Card	1189	Max amount (same card / last 24 h.) 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 Max amount (same card / last 24 h.) not allowed
38	Card	1190	Max amount (same card / last 24 h. / same IP address) 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 Max amount (same card / last 24 h. / same IP address) not allowed
39	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
40

[Solution] Detailed other's error message

Context

Proposed Solution

Backend

Description errors