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

To fetch a bank logo, follow these steps:

1. Find the bank in the table below (make sure it's for the correct country).

2. Copy the country code (ISO 3166-1 alpha-2 standard) and bank code and insert it into the Assets URL under [country_code/bank_code], choosing the regular or round bank logo.

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

For example, to get the round bank logo for Nordea in Finland , take the country code and bank code (fi/ndea) and insert it into the URL for round logos. The result is:
<https://assets.trustly.com/checkout/logos/banks/fi/ndea/round.png>

Below is a list of all available banks, and the country code / bank code to use in the URL: