Error messages

Introduction

According to the JSON RPC 1.1 specification, the Procedure Return object MUST contain the error member when a remote procedure call fails.

Example of a JSON object returned by Trustly when an error occurs:

{
    "version": "1.1",
    "error": {
        "name": "JSONRPCError",
        "code": 616,
        "message": "ERROR_INVALID_CREDENTIALS",
        "error": {
            "signature": "R9+hjuMqbsH0Ku ... S16VbzRsw==",
            "uuid": "258a2184-2842-b485-25ca-293525152425",
            "method": "Deposit",
            "data": {
                "code" : 616,
                "message" : "ERROR_INVALID_CREDENTIALS"
            }
        }
}

The message returned is not in a suitable format to present for the end-user.
If the error was JSON-RPC specific (for example invalid JSON-format), uuid and method will be "null".

Deposit Error Messages

Error Num	Error Code	Description
602	ERROR_FUNCTION_ACCESS_DENIED	The merchant does not have access to this function.
607	ERROR_HOST_ACCESS_DENIED	The IP address of the merchant has not been added to Trustly's IP-whitelist.
615	ERROR_INVALID_AMOUNT	The Amount s invalid. The amount must be > 0 with 2 decimals.
616	ERROR_INVALID_CREDENTIALS	The username and/or password used in the API call is incorrect.
620	ERROR_UNKNOWN	There could be several reasons for this error, please reach out to your Trustly contact for details.
622	ERROR_INVALID_CURRENCY_CODE	The currency code is invalid. See this page for valid currencies.
623	ERROR_INVALID_PARAMETERS	Some value or parameter in the deposit call does not match the expected format.
636	ERROR_UNABLE_TO_VERIFY_RSA_SIGNATURE	The signature could not be verified using the merchant's public key. Either the wrong private key was used to generate the signature, or the the data object used to create the signature was serialized incorrectly.
637	ERROR_DUPLICATE_MESSAGE_ID	The MessageID has been used before.
638	ERROR_ENDUSER_IS_BLOCKED	The enduser that initiated the payment is blocked.
639	ERROR_NO_PUBLIC_KEY	No public key has been configured for the merchant on Trustly's side.
642	ERROR_INVALID_EMAIL	The email attribute is missing or invalid (this is a requirement when using Trustly Direct Debit).
645	ERROR_INVALID_LOCALE	The Locale-attribute is sent with an incorrect value.
688	ERROR_DUPLICATE_UUID	This UUID has been used before.
696	ERROR_ENDUSERID_IS_NULL	The EndUserID sent in the request is null
697	ERROR_MESSAGEID_IS_NULL	The MessageID sent in the request is null
698	ERROR_INVALID_IP	The IP attribute sent is invalid. Only one IP address can be sent.
700	ERROR_MALFORMED_SUCCESSURL	The SuccessURL sent in the request is malformed. It must be a valid http(s) address.
701	ERROR_MALFORMED_FAILURL	The FailURL sent in the request is malformed. It must be a valid http(s) address.
702	ERROR_MALFORMED_TEMPLATEURL	The TemplateURL sent in the request is malformed. It must be a valid http(s) address.
703	ERROR_MALFORMED_URLTARGET	The URLTarget sent in the request is malformed.
704	ERROR_MALFORMED_MESSAGEID	The MessageID sent in the request is malformed.
705	ERROR_MALFORMED_NOTIFICATIONURL	The NotificationURL sent in the request is malformed. It must be a valid https address.
706	ERROR_MALFORMED_ENDUSERID	The EndUserID sent in the request is malformed.
712	ERROR_DIRECT_DEBIT_NOT_ALLOWED	Trustly Direct Debit (TDD) is not enabled on the merchant's user in Trusty's system. If you want to use TDD, please reach out to your Trustly contact. If you don't want to use TDD and still get this error message, you may need to remove the following attributes from the Deposit data: RequestDirectDebitMandate, QuickDeposit, ChargeAccountID.
717	ERROR_INVALID_ORDER_ATTRIBUTE	One or more attributes are sent with the incorrect value. Please reach out to your Trustly contact for more information.
718	ERROR_DISABLED_USER	The merchant's user is disabled in Trustly's system.
732	ERROR_PAY_AND_PLAY_NOT_ALLOWED	Trustly's Pay N Play product is not enabled on the merchant's user in Trustly's system. If you want to use Pay N Play, please reach out to your Trustly contact.
734	ERROR_NOT_SECURE_NOTIFICATIONURL	The NotificationURL must be using HTTPS, not plain HTTP.
737	ERROR_INVALID_COUNTRY	The Country code sent in the Deposit data is invalid. The expected format is explained on the Deposit documentation page.

Refund Error Messages

Error Num	Error Code	Description
602	ERROR_FUNCTION_ACCESS_DENIED	The merchant does not have access to this API method
603	ERROR_INSUFFICIENT_FUNDS	The merchant does not have enough balance on their Trustly account to execute the refund.
604	ERROR_DUPLICATE_BANK_WITHDRAWAL	The refund has already been processed.
607	ERROR_HOST_ACCESS_DENIED	The IP address of the merchant has not been added to Trustly's IP-whitelist.
615	ERROR_INVALID_AMOUNT	The amount is incorrect. The amount must be > 0 with 2 decimals, and must not be bigger than the amount in the original order.
616	ERROR_INVALID_CREDENTIALS	The username and/or password used in the API call is incorrect.
620	ERROR_UNKNOWN	There could be several reasons for this error, for example technical problems with the Trustly service.
622	ERROR_INVALID_CURRENCY_CODE	The currency code is invalid. See this page for valid currencies.
623	ERROR_INVALID_PARAMETERS	Some value or parameter in the refund call does not match the expected format.
636	ERROR_UNABLE_TO_VERIFY_RSA_SIGNATURE	The signature could not be verified using the merchant's public key. Either the wrong private key was used to generate the signature, or the the data object used to create the signature was serialized incorrectly.
639	ERROR_NO_PUBLIC_KEY	No public key has been configured for the merchant on Trustly's side.
655	ERROR_INVALID_ORDER_ID	The OrderID sent in the refund call does not exist.
670	ERROR_REFUND_EXCEED_DEPOSIT_VOLUME	The refund amount is larger than the deposit amount. Or in case of multiple partial refunds: the refund amount is larger than the amount that is left to refund for the given deposit.
671	ERROR_DEPOSIT_NOT_CAPTURED_OR_SETTLED	The refund could not be executed because the deposit failed and did not settle.
672	ERROR_MULTIPLE_REFUND_ATTEMPT	This error code will only be returned for deposits done with "Finnish Bank Buttons", where only one refund per deposit can be made.
688	ERROR_DUPLICATE_UUID	This UUID has been used before. It needs to be unique for every new API call.
716	ERROR_REFUND_PENDING	A refund is already queued in Trustly's system for this OrderID.
718	ERROR_DISABLED_USER	The merchant's user is disabled in Trustly's system.

Withdraw Error Messages

Error Num	Error Code	Description
602	ERROR_FUNCTION_ACCESS_DENIED	The merchant does not have access to this API method.
607	ERROR_HOST_ACCESS_DENIED	The IP address of the merchant has not been added to Trustly's IP-whitelist.
616	ERROR_INVALID_CREDENTIALS	The username and/or password used in the API call is incorrect.
620	ERROR_UNKNOWN	There could be several reasons for this error, please reach out to your Trustly contact for details.
636	ERROR_UNABLE_TO_VERIFY_RSA_SIGNATURE	The signature could not be verified using the merchant's public key. Either the wrong private key was used to generate the signature, or the the data object used to create the signature was serialized incorrectly.
637	ERROR_DUPLICATE_MESSAGE_ID	The MessageID has been used before.
638	ERROR_ENDUSER_IS_BLOCKED	The enduser that requested the withdrawal is blocked.
639	ERROR_NO_PUBLIC_KEY	No public key has been configured for the merchant on Trustly's side.
645	ERROR_INVALID_LOCALE	The Locale attribute is sent with an incorrect value.
696	ERROR_ENDUSERID_IS_NULL	The EndUserID sent in the request is null
697	ERROR_MESSAGEID_IS_NULL	The MessageID sent in the request is null
698	ERROR_INVALID_IP	The IP attribute sent is invalid. Only one IP address can be sent.
700	ERROR_MALFORMED_SUCCESSURL	The SuccessURL sent in the request is malformed. It must be a valid http(s) address.
701	ERROR_MALFORMED_FAILURL	The FailURL sent in the request is malformed. It must be a valid http(s) address.
702	ERROR_MALFORMED_TEMPLATEURL	The TemplateURL sent in the request is malformed. It must be a valid http(s) address.
703	ERROR_MALFORMED_URLTARGET	The URLTarget sent in the request is malformed.
704	ERROR_MALFORMED_MESSAGEID	The MessageID sent in the request is malformed.
705	ERROR_MALFORMED_NOTIFICATIONURL	The NotificationURL sent in the request is malformed. It must be a valid http(s) address.
706	ERROR_MALFORMED_ENDUSERID	The EndUserID sent in the request is malformed.
717	ERROR_INVALID_ORDER_ATTRIBUTE	One or more attributes are sent with the incorrect value.
734	ERROR_NOT_SECURE_NOTIFICATIONURL	The NotificationURL must be using HTTPS, not plain HTTP.

SelectAccount Error Messages

Error Num	Error Code	Description
602	ERROR_FUNCTION_ACCESS_DENIED	The merchant does not have access to this function.
607	ERROR_HOST_ACCESS_DENIED	The IP address of the merchant has not been added to Trustly's IP-whitelist.
616	ERROR_INVALID_CREDENTIALS	The username and/or password used in the API call is incorrect.
620	ERROR_UNKNOWN	There could be several reasons for this error, please reach out to your Trustly contact for details.
623	ERROR_INVALID_PARAMETERS	Some value or parameter in the API call does not match the expected format.
636	ERROR_UNABLE_TO_VERIFY_RSA_SIGNATURE	The signature could not be verified using the merchant's public key. Either the wrong private key was used to generate the signature, or the the data object used to create the signature was serialized incorrectly.
637	ERROR_DUPLICATE_MESSAGE_ID	The MessageID sent in the API call has been used before.
639	ERROR_NO_PUBLIC_KEY	No public key has been configured for the merchant on Trustly's side.
642	ERROR_INVALID_EMAIL	The email attribute is missing or invalid (this is a requirement when using Trustly Direct Debit).
645	ERROR_INVALID_LOCALE	The Locale attribute is sent with an incorrect value.
688	ERROR_DUPLICATE_UUID	This UUID has been used before.
696	ERROR_ENDUSERID_IS_NULL	The EndUserID sent in the request is null
697	ERROR_MESSAGEID_IS_NULL	The MessageID sent in the request is null
700	ERROR_MALFORMED_SUCCESSURL	The SuccessURL sent in the request is malformed. It must be a valid http(s) address.
701	ERROR_MALFORMED_FAILURL	The FailURL sent in the request is malformed. It must be a valid http(s) address.
702	ERROR_MALFORMED_TEMPLATEURL	The TemplateURL sent in the request is malformed. It must be a valid http(s) address.
703	ERROR_MALFORMED_URLTARGET	The URLTarget sent in the request is malformed.
704	ERROR_MALFORMED_MESSAGEID	The MessageID sent in the request is malformed.
705	ERROR_MALFORMED_NOTIFICATIONURL	The NotificationURL sent in the request is malformed. It must be a valid https address.
706	ERROR_MALFORMED_ENDUSERID	The EndUserID sent in the request is malformed.
712	ERROR_DIRECT_DEBIT_NOT_ALLOWED	Trustly Direct Debit (TDD) is not enabled on the merchant's user in Trusty's system. If you want to use TDD, please reach out to your Trustly contact. If you don't want to use TDD and still get this error message, you need to remove the RequestDirectDebitMandate attribute from the SelectAccount data.
717	ERROR_INVALID_ORDER_ATTRIBUTE	One or more attributes are sent with the incorrect value. Please reach out to your Trustly contact for more information.
718	ERROR_DISABLED_USER	The merchant's user is disabled in Trustly's system.
734	ERROR_NOT_SECURE_NOTIFICATIONURL	The NotificationURL must be using HTTPS, not plain HTTP.
737	ERROR_INVALID_COUNTRY	The Country code is invalid. The expected format is explained on the SelectAccount documentation page.

Charge Error Messages

Error Num	Error Code	Description
602	ERROR_FUNCTION_ACCESS_DENIED	The merchant does not have access to this function.
607	ERROR_HOST_ACCESS_DENIED	The IP address of the merchant has not been added to Trustly's IP-whitelist.
615	ERROR_INVALID_AMOUNT	The Amount is invalid. The amount must be > 0 with 2 decimals.
616	ERROR_INVALID_CREDENTIALS	The username and/or password used in the API call is incorrect.
620	ERROR_UNKNOWN	There could be several reasons for this error, please reach out to your Trustly contact for details.
623	ERROR_INVALID_PARAMETERS	Some value or parameter in the API call does not match the expected format.
636	ERROR_UNABLE_TO_VERIFY_RSA_SIGNATURE	The signature could not be verified using the merchant's public key. Either the wrong private key was used to generate the signature, or the the data object used to create the signature was serialized incorrectly.
637	ERROR_DUPLICATE_MESSAGE_ID	The MessageID has been used before.
638	ERROR_ENDUSER_IS_BLOCKED	The end-user that initiated the payment is blocked.
639	ERROR_NO_PUBLIC_KEY	No public key has been configured for the merchant on Trustly's side.
642	ERROR_INVALID_EMAIL	The email attribute is missing or invalid (this is a requirement when using Trustly Direct Debit).
688	ERROR_DUPLICATE_UUID	This UUID has been used before.
696	ERROR_ENDUSERID_IS_NULL	The EndUserID sent in the request is null
697	ERROR_MESSAGEID_IS_NULL	The MessageID sent in the request is null
704	ERROR_MALFORMED_MESSAGEID	The MessageID sent in the request is malformed.
705	ERROR_MALFORMED_NOTIFICATIONURL	The NotificationURL sent in the request is malformed. It must be a valid https address.
706	ERROR_MALFORMED_ENDUSERID	The EndUserID sent in the request is malformed.
712	ERROR_DIRECT_DEBIT_NOT_ALLOWED	Trustly Direct Debit (TDD) is not enabled on the merchant's user in Trusty's system. If you want to use TDD, please reach out to your Trustly contact.
717	ERROR_INVALID_ORDER_ATTRIBUTE	One or more attributes are sent with the incorrect value. Please reach out to your Trustly contact for more information.
718	ERROR_DISABLED_USER	The merchant's user is disabled in Trustly's system.
734	ERROR_NOT_SECURE_NOTIFICATIONURL	The NotificationURL must be using HTTPS, not plain HTTP.

📘
Charge
In addition to the JSONRPCError messages described here, the Charge method can also return a number of "rejected" messages. See more details on the Charge documentation page.

AccountPayout Error Messages

Error Num	Error Code	Description
602	ERROR_FUNCTION_ACCESS_DENIED	The merchant does not have access to this function.
607	ERROR_HOST_ACCESS_DENIED	The IP address of the merchant has not been added to Trustly's IP-whitelist.
615	ERROR_INVALID_AMOUNT	The Amount is invalid. The amount must be > 0 with 2 decimals.
616	ERROR_INVALID_CREDENTIALS	The username and/or password used in the API call is incorrect.
620	ERROR_UNKNOWN	There could be several reasons for this error, please reach out to your Trustly contact for details.
623	ERROR_INVALID_PARAMETERS	Some value or parameter in the API call does not match the expected format.
624	ERROR_INVALID_BANK_ACCOUNT_NUMBER	The specified AccountID does not exist.
636	ERROR_UNABLE_TO_VERIFY_RSA_SIGNATURE	The signature could not be verified using the merchant's public key. Either the wrong private key was used to generate the signature, or the the data object used to create the signature was serialized incorrectly.
637	ERROR_DUPLICATE_MESSAGE_ID	The MessageID has been used before.
638	ERROR_ENDUSER_IS_BLOCKED	The enduser that initiated the payment is blocked.
639	ERROR_NO_PUBLIC_KEY	No public key has been configured for the merchant on Trustly's side.
688	ERROR_DUPLICATE_UUID	This uuid has been used before.
696	ERROR_ENDUSERID_IS_NULL	The EndUserID sent in the request is null
697	ERROR_MESSAGEID_IS_NULL	The MessageID sent in the request is null
704	ERROR_MALFORMED_MESSAGEID	The MessageID sent in the request is malformed.
705	ERROR_MALFORMED_NOTIFICATIONURL	The NotificationURL sent in the request is malformed. It must be a valid https address.
706	ERROR_MALFORMED_ENDUSERID	The EndUserID sent in the request is malformed.
717	ERROR_INVALID_ORDER_ATTRIBUTE	One or more attributes are sent with the incorrect value. Please reach out to your Trustly contact for more information.
718	ERROR_DISABLED_USER	The merchant's user is disabled in Trustly's system.
734	ERROR_NOT_SECURE_NOTIFICATIONURL	The NotificationURL must be using HTTPS, not plain HTTP.

Swish Error codes

Error Num	Error Code	Description
602	ERROR_FUNCTION_ACCESS_DENIED	The merchant does not have access to this function.
607	ERROR_HOST_ACCESS_DENIED	The IP address of the merchant has not been added to Trustly's IP-whitelist.
615	ERROR_INVALID_AMOUNT	The Amount s invalid. The amount must be > 0 with 2 decimals.
616	ERROR_INVALID_CREDENTIALS	The username and/or password used in the API call is incorrect.
620	ERROR_UNKNOWN	There could be several reasons for this error, please reach out to your Trustly contact for details.
622	ERROR_INVALID_CURRENCY_CODE	The currency code is invalid. See this page for valid currencies.
623	ERROR_INVALID_PARAMETERS	Some value or parameter in the deposit call does not match the expected format.
636	ERROR_UNABLE_TO_VERIFY_RSA_SIGNATURE	The signature could not be verified using the merchant's public key. Either the wrong private key was used to generate the signature, or the the data object used to create the signature was serialized incorrectly.
637	ERROR_DUPLICATE_MESSAGE_ID	The MessageID has been used before.
639	ERROR_NO_PUBLIC_KEY	No public key has been configured for the merchant on Trustly's side.
688	ERROR_DUPLICATE_UUID	This uuid has been used before.
696	ERROR_ENDUSERID_IS_NULL	The EndUserID sent in the request is null
697	ERROR_MESSAGEID_IS_NULL	The MessageID sent in the request is null
698	ERROR_INVALID_IP	The IP attribute sent is invalid. Only one IP address can be sent.
700	ERROR_MALFORMED_SUCCESSURL	The SuccessURL sent in the request is malformed. It must be a valid http(s) address.
701	ERROR_MALFORMED_FAILURL	The FailURL sent in the request is malformed. It must be a valid http(s) address.
702	ERROR_MALFORMED_TEMPLATEURL	The TemplateURL sent in the request is malformed. It must be a valid http(s) address.
703	ERROR_MALFORMED_URLTARGET	The URLTarget sent in the request is malformed.
704	ERROR_MALFORMED_MESSAGEID	The MessageID sent in the request is malformed.
705	ERROR_MALFORMED_NOTIFICATIONURL	The NotificationURL sent in the request is malformed. It must be a valid http(s) address.
706	ERROR_MALFORMED_ENDUSERID	The EndUserID sent in the request is malformed.
717	ERROR_INVALID_ORDER_ATTRIBUTE	One or more attributes are sent with the incorrect value.
734	ERROR_NOT_SECURE_NOTIFICATIONURL	The NotificationURL must be using HTTPS, not plain HTTP.
739	ERROR_INVALID_MERCHANT_SWISH_NUMBER	Invalid Merchant Swish number.
740	ERROR_INVALID_SWISH_PAYER	Swish payer not enrolled
741	ERROR_INVALID_SWISH_MESSAGE	Wrong formatted Swish message.
742	ERROR_AGE_LIMITED_SWISH_PAYER	Payer does not meet the age limit.
743	ERROR_SSN_UNMATCHED_SWISH_PAYER	The payer alias in the request is not enrolled in swish with the supplied ssn
744	ERROR_ONGOING_PAYMENT_FOR_SWISH_PAYER	A payment request already exists for that payer.
745	ERROR_SWISH_COUNTERPART_NOT_ACTIVATED	Counterpart is not activated.
746	ERROR_SWISH_PAYER_NOT_ENROLLED	Payer is not enrolled.
747	ERROR_MERCHANT_SWISH_NUMBER_NOT_ENROLLED	Merchant swish number is not enrolled.

🚧
New errorcodes can be added and existing errorcodes can be removed without notice.