SelectAccount
Let customers select their bank accounts within the Trustly flow
Updated 1 month ago
Initiates a new order where customers can select and verify one of their bank accounts.
You can find more information about how to present the Trustly URL in Trustly URL presentation.
When the account has been verified an Account notification is immediately sent to the NotificationURL.
A typical flow is:
The merchant makes an API-call to SelectAccount and redirects the end-user to the url.
The end-user selects his/her bank and completes the identification process.
The end-user is redirected back to the merchant at the SuccessURL, note that the account might not be verified yet at this point.
When the account is verified, Trustly sends an Account notification to the merchant's system with information about the selected account
Request example
{
"method": "SelectAccount",
"params": {
"Data": {
"Attributes": {
"Country": "SE",
"Firstname": "Steve",
"IP": "83.140.44.184",
"Lastname": "Smith",
"Locale": "sv_SE",
"Email": "test@trustly.com",
"MobilePhone": "+46709876543",
"NationalIdentificationNumber": "197901311234",
"DateOfBirth": "1979-01-31",
"SuccessURL": "https://your_success_page.com"
},
"EndUserID": "12345",
"MessageID": "your_unique_id",
"NotificationURL": "https://URL_to_your_notification_service",
"Password": "merchant_password",
"Username": "merchant_username"
},
"Signature": "Hh+sfaUnbtMKW[...]9YngA9bTpiqxw==",
"UUID": "258a2184-2842-b485-25ca-293525152425"
},
"version": "1.1"
}The result returned is a hash with the following attributes.
Response example
{
"result": {
"signature": "R9+hjuMqbsH0Ku ... S16VbzRsw==",
"uuid": "258a2184-2842-b485-25ca-293525152425",
"method": "SelectAccount",
"data": {
"orderid": "2190971587",
"url": "https://trustly.com/_/bec96a48-d454-448e-a9ba-25fea8eeba3f"
}
},
"version": "1.1"
}These error codes can be returned for SelectAccount calls. To handle errors, see Error handling.
| Error Number | 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 serialised 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. |