Redirect customers to Trustly checkout page

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

Parameter nameDescriptionRequiredTypeExample
EndUserIDID, username, hash or anything uniquely identifying the end-user requesting the deposit. Should be the same as in previous Deposit API calls.YesText123123

Attributes

Attribute nameDescriptionRequiredTypeExample
AccountIDBank account identifier obtained from a previously completed deposits Account Notification.YesText1234567890
NationalIdentificationNumberThe end-user's social security number / personal number / birth number / etc. If this is not included the user will have to manually enter their National ID each time. This adds unnecessary steps to the experience.Recommended for Sweden only. Must not be included for other markets.Text790131-1234
UnchangeableNationalIdentificationNumberThis attribute disables the possibility to change/type in a national identification number when logging in to a Swedish bank. If this attribute is sent, the attribute NationalIdentificationNumber needs to be correctly included in the request. Note: This is only available for Swedish banks.Recommended for Sweden only. Must not be included for other markets.Numeric1

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:

BankCountryCountry Code / Bank Code in URL
Bank AustriaAustriaat/bkau
bank99 (ex-ING)Austriaat/ingd
BAWAG P.S.K.Austriaat/bawa
EasybankAustriaat/easy
Erste Sparkasse GeorgeAustriaat/giba
N26Austriaat/ntsb
RaiffeisenAustriaat/rlnw
VolksbankAustriaat/vboe
Česká spořitelnaCzech Republiccz/giba
Alm. BrandDenmarkdk/almb
Arbejdernes LandsbankDenmarkdk/alba
Danske BankDenmarkdk/daba
Djurslands BankDenmarkdk/djur
HandelsbankenDenmarkdk/hand
Jyske BankDenmarkdk/jyba
KreditbankenDenmarkdk/aakr
NordeaDenmarkdk/ndea
Nordfyns BankDenmarkdk/nsbk
Nordjyske BankDenmarkdk/eban
Nykredit BankDenmarkdk/nykb
Ringkjøbing LandbobankDenmarkdk/ring
SEBDenmarkdk/esse
Skjern BankDenmarkdk/skjb
Spar Nord BankDenmarkdk/spno
Sparekassen DanmarkDenmarkdk/vraa
Sparekassen Sjælland-FynDenmarkdk/swes
SwedbankDenmarkdk/swed
SydbankDenmarkdk/sybk
Vestjysk BankDenmarkdk/veho
CitadeleEstoniaee/parx
Coop PankEstoniaee/ekrd
Danske BankEstoniaee/fore
LHV PankEstoniaee/lhvb
LuminorEstoniaee/riko
NordeaEstoniaee/ndea
RevolutEstoniaee/revo
SEBEstoniaee/eeuh
SwedbankEstoniaee/haba
AktiaFinlandfi/hels
Danske BankFinlandfi/daba
HandelsbankenFinlandfi/hand
NordeaFinlandfi/ndea
OPFinlandfi/okoy
OmaSpFinlandfi/omsp
POP PankkiFinlandfi/popf
S-PankkFinlandfi/sban
SaastopankkiFinlandfi/itel
ÅlandsbankenFinlandfi/aaba
ComdirectGermanyde/comd
CommerzbankGermanyde/coba
DAB BankGermanyde/dabb
DKB - Deutsche KreditbankGermanyde/byla
Deutsche BankGermanyde/deut
Fidor BankGermanyde/fddo
HypoVereinsbankGermanyde/hyve
ING-DiBaGermanyde/ingd
N26Germanyde/ntsb
NorisbankGermanyde/nors
PostbankGermanyde/pbnk
RevolutGermanyde/revo
SantanderGermanyde/bsch
Sparda-BankGermanyde/geno
SparkasseGermanyde/sskn
TargobankGermanyde/cmci
Volksbank-RaiffeisenbankGermanyde/volk
CitadeleLatvialv/parx
LuminorLatvialv/riko
RevolutLatvialv/revo
SEBLatvialv/unla
SwedbankLatvialv/haba
CitadeleLithuanialt/indu
LuminorLithuanialt/agbl
RevolutLithuanialt/revo
SEBLithuanialt/cbvi
SwedbankLithuanialt/haba
Šiaulių bankasLithuanialt/cbsb
ABN AMRONetherlandsnl/abna
ASN BankNetherlandsnl/asnb
INGNetherlandsnl/ingb
KnabNetherlandsnl/knab
RabobankNetherlandsnl/rabo
Regio BankNetherlandsnl/rbrb
SNS BankNetherlandsnl/snsb
TriodosNetherlandsnl/trio
BN Bank ASANorwayno/kbno
DNBNorwayno/dnba
Danske BankNorwayno/daba
Etne SparebankNorwayno/etne
Fana SparebankNorwayno/fana
Flekkefjord SparebankNorwayno/flek
HandelsbankenNorwayno/hand
Haugesund SparebankNorwayno/haug
KLP BankenNorwayno/klpk
Landkreditt Bank ASNorwayno/land
Lillesands SparebankNorwayno/lill
Luster SparebankNorwayno/lusk
NordeaNorwayno/ndea
Nordea DirectNorwayno/gjas
OBOS-banken ASNorwayno/obos
Pareto Bank ASANorwayno/ptaa
SbankenNorwayno/sbak
SkandiabankenNorwayno/skia
Skudenes & Aakra SparebankNorwayno/skaa
SpareBank 1Norwayno/snow
SpareBank 1 GudbrandsdalNorwayno/sgfs
SpareBank 1 Hallingdal ValdresNorwayno/haal
SpareBank 1 Lom og SkjåkNorwayno/losk
SpareBank 1 ModumNorwayno/modu
SpareBank 1 NordmøreNorwayno/norv
SpareBank 1 Ringerike HadelandNorwayno/riri
SpareBank 1 SMNNorwayno/sptr
SpareBank 1 SR-BankNorwayno/spro
SpareBank 1 Søre SunnmøreNorwayno/vold
SpareBank 1 Sørøst-Norge (BV)Norwayno/vefo
SpareBank 1 Sørøst-Norge (Telemark)Norwayno/sptl
SpareBank 1 Østfold AkershusNorwayno/rygs
SpareBank 1 ØstlandetNorwayno/shed
Sparebanken MøreNorwayno/spar
Sparebanken Sogn og FjordaneNorwayno/sofj
Sparebanken SørNorwayno/spso
Sparebanken VestNorwayno/spav
Sparebanken ØstNorwayno/spoe
SpareskillingsbankenNorwayno/spsk
SwedbankNorwayno/swed
Søgne og Greipstad SparebankNorwayno/sogs
Voss SparebankNorwayno/vosk
Alior BankPolandpl/albp
BNP ParibasPolandpl/ppab
Bank PekaoPolandpl/pkop
Bank PocztowyPolandpl/pocz
Citi HandlowyPolandpl/citi
Credit AgricolePolandpl/agri
Deutsche Bank PolskaPolandpl/deut
Getin BankPolandpl/gbgc
ING Bank ŚląskiPolandpl/ingb
InteligoPolandpl/ingo
Millennium BankPolandpl/bigb
Orange FinansePolandpl/brex
PKO Bank PolskiPolandpl/bpko
SantanderPolandpl/wbkp
ABANCASpaines/cagl
BBVASpaines/bbva
Banco PopularSpaines/popu
Banco SabadellSpaines/bsab
Banco SantanderSpaines/bsch
BankiaSpaines/cahm
BankinterSpaines/bkbk
CaixaBankSpaines/caix
EVO BancoSpaines/evob
INGSpaines/ingd
IbercajaSpaines/cazr
KutxabankSpaines/bask
Danske BankSwedense/daba
FOREXSwedense/forx
HandelsbankenSwedense/hand
ICA BankenSwedense/ibca
LänsförsäkringarSwedense/ellf
NordeaSwedense/ndea
SEBSwedense/esse
SkandiabankenSwedense/skia
Sparbanken SydSwedense/ssyd
Swedbank (& Sparbankerna)Swedense/swed
ÅlandsbankenSwedense/aaba
AIBUnited Kingdomgb/aibk
Alpha FXUnited Kingdomgb/apah
Arbuthnot LathamUnited Kingdomgb/arbu
Bank of Ireland UKUnited Kingdomgb/bofi
Bank of ScotlandUnited Kingdomgb/bofs
BarclaysUnited Kingdomgb/barc
C. Hoare & Co.United Kingdomgb/hoab
Cash PlusUnited Kingdomgb/apsf
Cater AllenUnited Kingdomgb/cate
Chase UKUnited Kingdomgb/chas
Chelsea Building SocietyUnited Kingdomgb/chel
CitibankUnited Kingdomgb/citi
Clydesdale BankUnited Kingdomgb/clyd
CouttsUnited Kingdomgb/cout
Danske BankUnited Kingdomgb/daba
First DirectUnited Kingdomgb/hbuk
HSBC UKUnited Kingdomgb/midl
HalifaxUnited Kingdomgb/hlfx
ICICI Bank UKUnited Kingdomgb/icic
InvestecUnited Kingdomgb/ives
Kleinwort HambrosUnited Kingdomgb/hamb
Lloyds BankUnited Kingdomgb/loyd
MBNAUnited Kingdomgb/mbna
Metro BankUnited Kingdomgb/mymb
MonzoUnited Kingdomgb/monz
NatWestUnited Kingdomgb/nwbk
NationwideUnited Kingdomgb/naia
RevolutUnited Kingdomgb/revo
Royal Bank of ScotlandUnited Kingdomgb/rbos
Santander UKUnited Kingdomgb/abby
Silicon Valley Bank UKUnited Kingdomgb/svbk
Starling BankUnited Kingdomgb/srlg
TSB BankUnited Kingdomgb/tsbs
Tesco BankUnited Kingdomgb/tpfg
The Co-operative BankUnited Kingdomgb/cpbk
The CumberlandUnited Kingdomgb/cmbs
TideUnited Kingdomgb/clrb
Ulster BankUnited Kingdomgb/ulsb
Vanquis BankUnited Kingdomgb/vqis
Virgin Money UKUnited Kingdomgb/nrnb
WiseUnited Kingdomgb/trwi
Yorkshire BankUnited Kingdomgb/york
Yorkshire Building SocietyUnited Kingdomgb/yorb