Trustly Express API

Trustly Express API

If you’re not able to use the Trustly Widget, Trustly Express can be implemented using our API and allows for customized integration.

Include the accountID attribute in the Deposit API call for a user that has made a previous Trustly Deposit. The accountID is a unique identifier for the customer's bank account that is generated by Trustly and shared in the Account notification after a completed Deposit.

When including the accountID in a Deposit API call, the EndUserID parameter should be the same as in previous Deposit API calls for the same end-user.

Request Parameters

Attributes

Code Example

Request

{
  "method": "Deposit",
  "params": {
    "Signature": "f4ThjuMqbsdG6u ... S16VbzD4h==",
    "UUID": "258a2184-2842-b485-25ca-293525152425",
    "Data": {
      "Username": "merchant_username",
      "Password": "merchant_password",
      "NotificationURL": "https://URL_to_your_notification_service",
      "EndUserID": "12345", //Same EndUserID as previous Deposit
      "MessageID": "your_unique_deposit_id",
      "Attributes": {
        "Country": "SE",
        "Locale": "sv_SE",
        "Currency": "SEK",
        "Amount": "100.00",
        "AccountID" : "1234567890", //AccountID from account notification
        "Firstname": "John",
        "Lastname": "Doe",
        "NationalIdentificationNumber": "19790131-1234", //Person ID for Swedish users
        "UnchangeableNationalIdentificationNumber": "1",
        "SuccessURL": "https://yourpage.com/success",
        "FailURL": "https://yourpage.com/fail"
      }
    }
  },
  "version": "1.1"
}

📘

Unsupported banks

If the AccountID parameter is set for a bank that doesn’t yet support Trustly Express, the bank will be pre-selected in the Trustly Checkout but the customer will have to log in to the bank before approving the payment.
For more information about which markets and banks support Trustly Express, please reach out to your Trustly Account Manager.

🚧

AccountID in combination with RequestKYC

The AccountID attribute will be ignored for Deposit orders with RequestKYC. If you want to enable Trustly Express, exclude the RequestKYC attribute.

Trustly Express API presentation guidelines

To ensure the best user experience, display the Trustly payment option for the returning user together with the bank's logo and masked account number. The necessary details are shared in the Account notification.

Mandatory information to present:

• Bank logo
• Masked account number (descriptor)
• Trustly logo

Some examples of how to present this information can be found below.

Trustly hosted bank logos

Use the clearinghouse and bank code to obtain the bank logo as an asset, see table below.

Assets URL for the bank logos:
https://assets.trustly.com/checkout/logos/banks/default/[bank_code]/regular.png
https://assets.trustly.com/checkout/logos/banks/default/[bank_code]/round.png

For example, to get the round bank logo for Nordea in Finland the URL is:
https://assets.trustly.com/checkout/logos/banks/default/ndea/round.png

Below is a list of all available banks, and the name to use in the URL:

These 4 banks have country-specific bank logos

Their URL has an additional path, eg /at/ followed by the bank code, for example, to get the regular logo for ING Austria the URL is:
https://assets.trustly.com/checkout/logos/banks/country/at/ingb/regular.png