• France
lyra.com
Search
Categories
Tags
Europe (English)
France
Spain
Europe (English)
India
Home
Implementation
Embedded form (cards)
REST payment API
REST PCI-DSS payment API
REST SEPA API
Hosted payment
Data collection form
File exchange
Mobile payment
Snippets
Plugins
Marketplace
Back Office
Merchant Back Office
Expert Back Office
Guides
Help
FAQ
Video tutorials
Support

Error codes

An error code looks like [PREFIX]_[CODE], where:

[PREFIX] Defines the application layer where the error occurred.
[CODE] Numeric error code.

There are different prefixes:

PREFIX DESCRIPTION EXAMPLE OF AN ERROR
ACQ Error on the acquirer side ACQ_001
AUTH Authentication error AUTH_149
CLIENT JavaScript application error (in the buyer's browser) CLIENT_003
INT Integration error (on the merchant side) INT_007
PSP Error on the PSP side PSP_001

Errors are returned via 4 parameters:

{
  "errorCode": "INT_015",
  "errorMessage": "invalid customer email",
  "detailedErrorCode": null,
  "detailedErrorMessage": "Invalid input value [name=customer.email, value=fake-email]"
}
PARAMETER TYPE DESCRIPTION FORMAT Max LENGTH
errorCode Error code string (in [PREFIX]_[CODE] format) string 7
errorMessage Error message string string 127
detailedErrorCode Detailed error code string (or null) string 127
detailedErrorMessage Detailed message string (or null) string 127

Error codes are described here :

  • ACQ
  • AUTH
  • CUSTOMER
  • INT
  • PSP

New error codes can be added in the future. Your implementation must imperatively take this fact into account.

Recruitment

Head Office :

LYRA NETWORK
109, rue de l’innovation
31670 Labège
FRANCE

2.9.0-doc-1.8