About Trustly

General information about Trustly

Founded in 2008, Trustly is a technology enterprise from Sweden, which enables secure and convenient payments via online banking for the customers. Trustly offers Collecting as well as an automated credit (refund) via API and reconciliation files for all supported acquirers (all 21 main banks in Sweden, Denmark and Finland). Trustly is FSA regulated.

Logo

Info

The Trustly online bank transfer is convenient for the customer and secure for the merchant. This payment method enables customers to be addressed who have an account at one of 30 banks in Sweden, Finland, Denmark and Spain.

Type

Payments by Online Bank Transfer

Process flow chart

Trustly process flow

interface

Trustly Online transfer

In order to make a payment with Trustly in Scandinavia, please use the following URL:

trustly.aspx

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217. Only BAM, BGN, CZK, EEK, EUR, GBP, HRK, HUF, LTL, LVL, PLN, RON and USD permissible; the currency must match CountryCode. Please find an overview here: A1 Currency table EN	Währung, drei Zeichen DIN / ISO 4217. Nur BAM, BGN, CZK, EEK, EUR, GBP, HRK, HUF, LTL, LVL, PLN, RON und USD zulässig; die Währung muss zu CountryCode passen. Hier eine Übersicht: A1 Währungstabelle

Key	Format	CND	Description	Beschreibung
OrderDesc	ans..768	M	Description of goods and prices. Intended purpose on the statement of account.	Beschreibung der Waren und Einzelpreise. Verwendungszweck auf dem Kontoauszug.

Key	Format	CND	Description	Beschreibung
IPAddr	ans..15	O	Customer´s IP address in IPv4 or IPv6 format	IP-Adresse des Kunden im Format IPv4 oder IPv6
FirstName	ans..100	M	First name of the custumer	Vorname des Kunden
LastName	ans..100	M	Last name of the customer	Nachname des Kunden
MobileNo	n..20	O	Customer’s mobile telephone number	Mobiltelefonnummer des Kunden
CountryCode	a2	O	Two characters country code according to ISO 3166	Ländercode zweistellig gemäß ISO 3166
Language	ans..5	O	Language, e.g. de_DE, en_US, sv_SE	Sprache, z.B. de_DE, en_US, sv_SE
SocialSecurityNumber	ans..20	O	Social security number, identity card number etc.	Sozialversicherungsnummer, Personalausweisnummer usw.
CustomerId	ans..30	O	Customer number	Kundennummer
URLTemplate	ans..256	O	URL of your individual layout for the payment form. This template page can be self-designed but must be compliant to the security guidelins of Trustly. - all pictures need an absolute URL - all links must start with https - tags like script, iframe, frame, frameset, object, applet, etc are not allowed. The page must contain the following tag at any place. <!—TRUSTLY-PAYMENT-PAGE-GOES-HERE > At this place the Trustly transaction page (600x600px) will be displayed.	URL zu Ihrem individuellen Layout für das Bezahlformular. Diese Template-Seite kann selbst entworfen werden, muss aber den Sicherheitsrichtlinien von Trustly entsprechen. - Alle Bilder benötigen eine absolute URL - Alle Links müssen mit https beginnen - Tags wie script, iframe, frame, frame-set, object, applet, etc. sind nicht erlaubt. Die Seite muss an einer beliebigen Stelle folgenden Tag enthalten: <!—TRUSTLY-PAYMENT-PAGE-GOES-HERE > An dieser Stelle wird die Trustly Transaction Seite (600x600px) angezeigt.

Parameters for online transfers with Trustly

Key	Format	CND	Description	Beschreibung
Status	a..50	M	OK – is reported by via URLSuccess redirect and also as a separate notify FAILED – is reported by via URLFailure redirect and also as a separate notify AUTHORIZE_REQUEST – is reported in the first step via redirect to the URLSuccess, based on this response the payment must be defined as open. Only the separate Notify reports the final status of the payment. If you want to receive the first open status (URLSuccess Redirect) additionally via URLNotify, please inform our . If this function is active, you will receive two notifies, the initial AUTHORIZE_REQUEST and later with the final status.	OK – wird vom via URLSuccess Redirect und auch im separaten Notify gemeldet FAILED – wird vom via URLFailure Redirect und auch im separaten Notify gemeldet AUTHORIZE_REQUEST – wird im ersten Schritt via Redirect auf die URLSuccess gemeldet, aufgrund dieser Rückmeldung muss die Zahlung als offen definiert werden. Erst das separate Notify meldet den abschließenden Status der Zahlung. Wenn Sie den ersten offenen Status (URLSuccess Redirect) zusätzlich via URLNotify erhalten wollen, informieren Sie bitte unseren . Wenn diese Funktion aktiv ist, erhalten Sie zwei Notifies, initial AUTHORIZE_REQUEST und später mit dem finalen Status.

Key	Format	CND	Description	Beschreibung
			Customer parameters (optional)	Kundenparameter (optional)
AccountId	ans..30	O	Unique name/number to identify the specific customer account	Eindeutige(r) Name/Nummer zur Identifizierung des betreffenden Kundenkontos
Match	n1	O	0=not verified; 1=verified	0=not verified; 1=verified
AccClearingHouse	ans..50	O	Clearing house for that account	Verrechnungsstelle für dieses Konto
AccOwner	ans..55	O	Name of account holder	Name des Kontoinhabers
AccBank	ans..27	O	Name of the bank	Name der Bank
AccDescriptor	ans..100	O	Additional text for identifying the customer	Zusätzlicher Text zur Identifizierung des Kunden
IBAN	n8	O	Last digits of IBAN/ account number	Letzte Stellen der IBAN/Kontonummer
UserId	ans..30	O	Unique name/number for identifying the respective customers	Eindeutige(r) Name/Nummer zur Identifizierung des betreffenden Kunden
AddrStreet	ans..100	O	Customer’s street name and house number	Straßenname und Hausnummer des Kunden
AddrZip	ans..10	O	Postcode of the customer	Postleitzahl des Kunden
AddrCity	ans..30	O	Town/city of the customer	Stadt des Kunden

Response parameters for URLSuccess, URLFailure and URLNotify with Trustly

If “PendingNotify” is configured, only the standard parameters without the optional customer parameters are returned additionally to URLNotify.

Credit with reference

credit.aspx

Parameters for credits of payments with Trustly

Response parameters for credits of payments with Trustly

Batch processing via the interface

This section describes the parameters which must be transferred within the data set (Record) for executing credits with Trustly, which can be found within the response file about the payment status.

Following table gives an overview of all batch versions that are possible for a specific action and their specialities:

Action	Version	Description	Beschreibung
Credit	1.0 / 2.0	Standard version without return of parameter Code	Standardversion ohne Rückgabe von Parameter Code
	1.x / 2.x	with RefNr (valid for all versions other than 1.0)	mit RefNr (gilt für alle Versionen außer 1.0)

Description of the possible batch versions

The structure for a Trustly payment within a Batch file to be submitted is as follows:

HEAD,<MerchantID>,<Date>,<Version>
Trustly,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>
FOOT,<CountRecords>,<SumAmount>

Example for Master MID function:

HEAD,[Master]MerchantID,Date,2.x
Type,Action,[Slave]MID,Amount,Currency,TransID,Data (depends on Action)
FOOT,CountRecords,SumAmount

Key	Format	CND	Description	Beschreibung
Type	a..11	M	HEAD for Header, FOOT for Footer, Trustly for Trustly	HEAD für Header, FOOT für Footer, Trustly für Trustly
Action	a..20	M	The parameter Action defines the type of transaction: Credit	Der Action-Parameter definiert die Art der Transaktion: Credit (Gutschrift)

Description of fields within the record for Batch files

The record area within the response file for Batch transactions looks as follows:

HEAD,<MerchantID>,<Date>,<Version>
Trustly,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code>
FOOT,<CountRecords>,<SumAmount>

Key	Format	CND	Description	Beschreibung
Action	a..20	M	The parameter Action defines the type of transaction: Credit	Der Action-Parameter definiert die Art der Transaktion: Credit (Gutschrift)

Description of result parameters within the record for Batch files