SelectAccount

Overview

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:

1. The merchant makes an API-call to SelectAccount and redirects the end-user to the url.
2. The end-user selects his/her bank and completes the identification process.
3. The end-user is redirected back to the merchant at the SuccessURL, note that the account might not be verified yet at this point.
4. 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": "[email protected]",
        "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"
}

Request parameters

Attributes

🚧

PSPMerchant, PSPMerchantURL and MerchantCategoryCode

PSPMerchant, PSPMerchantURL and MerchantCategoryCode are mandatory attributes for Trustly Partners that are using Express Merchant Onboarding (EMO) and aggregate traffic under a master processing account.

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"
}

Response attributes

The result returned is a hash with the following attributes.

Direct Debit Mandates

If the RequestDirectDebitMandate attribute is set, the behavior of the order changes with respect to how account notifications are emitted:

1. Once the normal order flow is done and the end-user has chosen an account, an Account notification without the directdebitmandate attribute can be sent to the NotificationURL if the account is not immediately ready to be charged.
2. If the end-user's bank has approved the mandate on the selected account and the account can be charged, an account notification with the directdebitmandate attribute set to "1" is sent.
3. If creating the mandate is rejected by the end-user's bank or an active mandate is cancelled, an account notification with the directdebitmandate attribute set to "0" is sent.
4. If the mandate at some point is revoked additional notificications will be sent to all selectaccount orders concerned. It will have the directdebitmandate attribute set to indicate the new status of the mandate.

Error codes

These error codes can be returned for SelectAccount calls. To handle errors, see Error handling.