• France
Search
Categories
Tags
English
French
English
Implementation
Embedded form (cards)
REST payment API
Hosted payment
Push mail
File exchange
Mobile payment
Logos
Plugins
Back office
Guides
Helpers
FAQ
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.

© 2023 | All rights reserved to Systempay | legal
2.16.0-doc-1.8