logo
Trustly Docs
BETA
DocsAPI

Trustly Express API

Redirect customers to Trustly checkout page
Updated 1 month ago

Trustly Express API

If you’re not able to use the Trustly Widget, Trustly Express can be implemented using our API and allows for customised 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

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.


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

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

An example of how to present this information can be found below.

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:

BankCountryBank Code in URL
N26Austriantsb
VolksbankAustriavboe
bank99 (ex-ING)Austriaingd
EasybankAustriaeasy
RaiffeisenAustriarlnw
Bank AustriaAustriabkau
RaiffeisenAustriarlbb
BAWAG P.S.K.Austriabawa
SEBDenmarkesse
NordeaDenmarkndea
SydbankDenmarksybk
SwedbankDenmarkswed
Jyske BankDenmarkjyba
Danske BankDenmarkdaba
Skjern BankDenmarkskjb
HandelsbankenDenmarkhand
Vestjysk BankDenmarkveho
Nordjyske BankDenmarkeban
Djurslands BankDenmarkdjur
KreditbankenDenmarkaakr
Nordfyns BankDenmarknsbk
Nykredit BankDenmarknykb
Spar Nord BankDenmarkspno
Alm. BrandDenmarkalmb
Arbejdernes LandsbankDenmarkalba
Sparekassen Sjælland-FynDenmarkswes
Sparekassen DanmarkDenmarkvraa
Ringkjøbing LandbobankDenmarkring
SEBEstoniaeeuh
SwedbankEstoniahaba
LHV PankEstonialhvb
RevolutEstoniarevo
CitadeleEstoniaparx
Coop PankEstoniaekrd
LuminorEstoniariko
Danske BankEstoniafore
AktiaFinlandhels
OmaSpFinlandomsp
NordeaFinlandndea
S-PankkFinlandsban
OPFinlandokoy
POP PankkiFinlandpopf
Danske BankFinlanddaba
HandelsbankenFinlandhand
ÅlandsbankenFinlandaaba
SaastopankkiFinlanditel
PostbankGermanypbnk
SparkasseGermanysskn
DAB BankGermanydabb
N26Germanyntsb
Sparda-BankGermanygeno
ING-DIBaGermanyingb
NorisbankGermanynors
Volksbank-RaiffeisenbankGermanyvolk
ComdirectGermanycomd
ING-DiBaGermanyingd
RevolutGermanyrevo
Deutsche BankGermanydeut
Fidor BankGermanyfddo
CommerzbankGermanycoba
SantanderGermanybsch
SparkasseGermanyspar
HypoVereinsbankGermanyhyve
DKB - Deutsche KreditbankGermanybyla
TargobankGermanycmci
SwedbankLatviahaba
SEBLatviaunla
RevolutLatviarevo
CitadeleLatviaparx
LuminorLatviariko
LuminorLithuaniaagbl
SwedbankLithuaniahaba
RevolutLithuaniarevo
SEBLithuaniacbvi
CitadeleLithuaniaindu
Šiaulių bankasLithuaniacbsb
KnabNetherlandsknab
ASN BankNetherlandsasnb
RabobankNetherlandsrabo
INGNetherlandsingb
Regio BankNetherlandsrbrb
ABN AMRONetherlandsabna
SNS BankNetherlandssnsb
TriodosNetherlandstrio
BN Bank ASANorwaykbno
SpareBank 1 Sørøst-Norge (BV)Norwayvefo
KLP BankenNorwayklpk
OBOS-banken ASNorwayobos
Sparebanken SørNorwayspso
NordeaNorwayndea
DNBNorwaydnba
SwedbankNorwayswed
Danske BankNorwaydaba
SbankenNorwaysbak
HandelsbankenNorwayhand
SkandiabankenNorwayskia
Etne SparebankNorwayetne
Fana SparebankNorwayfana
Pareto Bank ASANorwayptaa
Voss SparebankNorwayvosk
SpareBank 1 ModumNorwaymodu
SpareBank 1 SMNNorwaysptr
Luster SparebankNorwaylusk
Sparebanken VestNorwayspav
Sparebanken ØstNorwayspoe
Sparebanken MøreNorwayspar
Nordea DirectNorwaygjas
Haugesund SparebankNorwayhaug
Landkreditt Bank ASNorwayland
SpareBank 1 SR-BankNorwayspro
SpareBank 1 ØstlandetNorwayshed
Lillesands SparebankNorwaylill
SpareBank 1 Ringerike HadelandNorwayriri
SpareBank 1 NordmøreNorwaynorv
SpareBank 1 Sørøst-Norge (Telemark)Norwaysptl
SpareskillingsbankenNorwayspsk
Flekkefjord SparebankNorwayflek
SpareBank 1 Østfold AkershusNorwayrygs
SpareBank 1Norwaysnow
SpareBank 1 Hallingdal ValdresNorwayhaal
SpareBank 1 Lom og SkjåkNorwaylosk
SpareBank 1 GudbrandsdalNorwaysgfs
SpareBank 1 Søre SunnmøreNorwayvold
Skudenes & Aakra SparebankNorwayskaa
Sparebanken Sogn og FjordaneNorwaysofj
Søgne og Greipstad SparebankNorwaysogs
Citi HandlowyPolandciti
InteligoPolandingo
ING Bank ŚląskiPolandingb
Alior BankPolandalbp
Getin BankPolandgbgc
Bank PekaoPolandpkop
Bank PocztowyPolandpocz
Deutsche Bank PolskaPolanddeut
PKO Bank PolskiPolandbpko
BNP ParibasPolandppab
Millennium BankPolandbigb
SantanderPolandwbkp
Credit AgricolePolandagri
Orange FinansePolandbrex
IbercajaSpaincazr
BBVASpainbbva
BankiaSpaincahm
CaixaBankSpaincaix
BankinterSpainbkbk
EVO BancoSpainevob
INGSpainingd
Banco PopularSpainpopu
Banco SabadellSpainbsab
Banco SantanderSpainbsch
KutxabankSpainbask
ABANCASpaincagl
SEBSwedenesse
NordeaSwedenndea
Swedbank (& Sparbankerna)Swedenswed
FOREXSwedenforx
ICA BankenSwedenibca
Danske BankSwedendaba
HandelsbankenSwedenhand
SkandiabankenSwedenskia
ÅlandsbankenSwedenaaba
Sparbanken SydSwedenssyd
LänsförsäkringarSwedenellf
NationwideUnited Kingdomnaia
HalifaxUnited Kingdomhlfx
AIBUnited Kingdomaibk
Yorkshire BankUnited Kingdomyork
TSB BankUnited Kingdomtsbs
Ulster BankUnited Kingdomulsb
Bank of Ireland UKUnited Kingdombofi
ICICI Bank UKUnited Kingdomicic
Metro BankUnited Kingdommymb
Starling BankUnited Kingdomsrlg
CouttsUnited Kingdomcout
Yorkshire Building SocietyUnited Kingdomyorb
Virgin Money UKUnited Kingdomnrnb
Tesco BankUnited Kingdomtpfg
First DirectUnited Kingdomhbuk
MonzoUnited Kingdommonz
Kleinwort HambrosUnited Kingdomhamb
C. Hoare & Co.United Kingdomhoab
TideUnited Kingdomclrb
Silicon Valley Bank UKUnited Kingdomsvbk
InvestecUnited Kingdomives
Arbuthnot LathamUnited Kingdomarbu
Vanquis BankUnited Kingdomvqis
Alpha FXUnited Kingdomapah
MBNAUnited Kingdommbna
The CumberlandUnited Kingdomcmbs
Santander UKUnited Kingdomabby
CitibankUnited Kingdomciti
Danske BankUnited Kingdomdaba
RevolutUnited Kingdomrevo
WiseUnited Kingdomtrwi
BarclaysUnited Kingdombarc
HSBC UKUnited Kingdommidl
Chase UKUnited Kingdomchas
Clydesdale BankUnited Kingdomclyd
Lloyds BankUnited Kingdomloyd
Bank of ScotlandUnited Kingdombofs
The Co-operative BankUnited Kingdomcpbk
Royal Bank of ScotlandUnited Kingdomrbos
Cater AllenUnited Kingdomcate
Chelsea Building SocietyUnited Kingdomchel
NatWestUnited Kingdomnwbk
Cash PlusUnited Kingdomapsf


These 4 banks have country-specific bank logos:

BankCountryBank Code in URL
Erste Sparkasse GeorgeAustria/at/giba
NordeaEstonia/ee/ndea
Česká spořitelnaCzech Republic/cz/giba
SbankenNorway/no/skia


Their URL has an additional path, eg /at/ followed by the bank code, for example, to get the regular logo for Nordea Estonia the URL is:
<https://assets.trustly.com/checkout/logos/banks/ee/ndea/regular.png>

Previous article

Overview: Trustly Express

Next article

Azura Core Deposit