Trustly uses conventional HTTP response codes to indicate success or failure of an API request.

HTTP Status CodeDescription
400 Bad RequestOften due to a missing, required parameter.
401 UnauthorizedInvalid accessId or accessKey.
404 Not FoundThis endpoint is not supported or defined by Trustly
500 Server errorInternal Trustly error.
503 Service UnavailableThe server is currently unable to handle the request due to temporary overloading or server maintenance.

Sample Error response

Most error responses from the Trustly API will also include a response object containing an array of any errors recorded and any available metadata.

   "errors": [
      "domain" : "com.trustly.merchantgateway.v1.exception.InvalidParameterException",
      "code" : 200,
     "message" : "Could not find a transaction using Id 10000021"
Error CodeDescription
100Internal error. An internal error (an internal database exception for example) occurred when trying to process the request.
150Remote error. A remote error (the consumer's bank interface is down) occurred when trying to process the request. This is an internal error.
200Invalid parameter error. One of the request parameters is invalid (sending an invalid amount format string for example).
210This is a duplicate request. It has been ignored.
300Security error. These are generic security errors that can happen when trying to process the request.
326Expired split token.
330Invalid account.
331Not enough balance.
375Access control error. This occurs when some security parameter (accessId, accessKey or requestSignature) is invalid and the request cannot be processed.
380Invalid Split Token.
390Fraud analysis. Suspicious transaction or negative data.
397splitToken is not valid.