Card Payments Error Codes

There are 2 ways to view error codes with Lemonway.

The API response code, in the error > PSP response field.
Example: See response code output here

In the Dashboard: YOUR ENVIRONMENT > TRANSACTIONS > ALL

The following table displays Lemonway's current partners with direct links to their error codes.

📘
Note
The characters xx, yy, and zz in each table column are used to specify the order in which error codes should be read.

Payment Partner	xx	yy	zz
Mercanet	ResponseCode	ComplementaryCode	AcquirerResponseCode

The following examples are provided to help you understand how each PSP error message is displayed.

Mercanet

Mercanet uses a 3-code system to manage and describe error codes. Read the error in this order:

ResponseCode (denoted in the table as xx)
ComplementaryCode (denoted in the table as yy)
AcquirerResponseCode (denoted in the table as zz)

Video: Mercanet Error Codes Decoded

PayPlug

Execution codes

The execution codes are organized into ranges:

0XXX operation succeeded or still processing
4XXX operation rejected because of the bank or the supplier
5XXX operation rejected because of a system error
6XXX operation rejected because of anti-fraud engine

📘
Note
If you have messages that start with 1XXX, 2XXX, or 3XXX, please contact Lemonway Support for further help.

PayPlug Execution Codes

Expand a range to view all codes and messages.

0XXX Success / Processing ▾

0000

Successful operation

0001

3-D Secure authentication required

0002

Redirection required to finish a transaction

0003

Transaction in progress, pending notification

1XXX–3XXX Configuration / Validation / Account ▾

1001

Missing parameter

1002

Invalid parameter

1003

HASH error

1004

Unsupported protocol

1005

Bad request, please check the documentation to build the POST request

1006

GET parameters are forbidden

1007

CART total amount is different from the transaction amount

2001

ALIAS not found

2002

Reference transaction not found

2003

Reference transaction not succeeded

2004

Reference transaction not refundable

2005

Reference authorization not capturable

2006

Reference transaction not finished

2007

Invalid capture amount

2008

Invalid refund amount

2009

Expired authorization

2010

Installment schedule not found

2011

Installment schedule already interrupted

2012

Installment schedule already finished

2013

File not found

2014

Invalid file

2015

The reference transaction is not voidable

2016

Resource already exists

2017

The requested operation is not available yet, please try again later

2018

The requested HFTOKEN has not been found or is expired

2019

The void amount is invalid

2020

The alias has expired

3001

Disabled account

3002

Unauthorized server IP address

3003

Unauthorized transaction

3004

Transactions rate limit exceeded

3006

Invalid submerchant for this account

3008

Payment options not configured

4XXX Rejected by bank / provider ▾

4001

Transaction declined by the banking network

4002

Insufficient funds

4003

Card declined by the banking network

4005

Fraud suspicion

4008

3DSecure authentication failed

4009

3DSecure authentication abandoned or expired

4010

Invalid transaction

4011

Duplicated transaction

4012

Invalid card data

4013

Transaction not allowed by banking network for this holder

4014

Non 3-D Secure-enrolled card

4015

Expired transaction

4016

Transaction declined by the payment terminal

4017

Form expiration (as planned by the merchant)

4018

Recurring payment revoked for this card holder

4019

The bank will decline further transactions from this card

4020

Strong customer authentication required by issuer

4021

Operation not allowed / not supported

5XXX System errors ▾

5001

Exchange protocol failure

5002

Banking network error

5004

Time out, the response will be sent to the notification URL (only applicable for Visa / MasterCard direct connection)

5005

3-D Secure authentication error

5006

Unexpected bank response

6XXX Anti-fraud rejections ▾

6001

Transaction declined by the merchant

6002

Transaction declined

6003

The cardholder has already disputed a transaction

6004

Transaction declined by merchant and/or platform rules

6005

Card not enrolled or 3-D Secure unavailable

6006

Blocked payment method

6007

Operation prohibited by the bank networks

6008

Card holder has already declared transaction as fraudulent