Table of Contents

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.

Page properties

Logo

Info

Excerpt
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

Multiexcerpt

MultiExcerptName	ProcessFlow

draw.io Diagram

border	true
diagramName	Trustly_CT
simpleViewer	false
links	auto
tbstyle	top
lbox	true
diagramWidth	1390

Trustly process flow

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
interface

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Definition
PageWithExcerpt	Definition EN

Trustly Online transfer

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

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

trustly.aspx

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1644855293543_-869991316
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	trustly_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1644855293546_-1042630345
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	RefNr
page	refnr
type	page

Table Excerpt Include

static	true
name	Amount
page	Amount
type	page

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

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

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.

Table Excerpt Include

static	true
name	URLSuccess
page	URLSuccess
type	page

Table Excerpt Include

static	true
name	URLFailure
page	URLFailure
type	page

Table Excerpt Include

static	true
name	Response
page	Response
type	page

Table Excerpt Include

static	true
name	URLNotify
page	URLNotify
type	page

Table Excerpt Include

static	true
name	UserData
page	UserData
type	page

Table Excerpt Include

static	true
name	ReqId-ans..32
page	ReqId
type	page

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.

Table Excerpt Include

static	true
name	Plain
page	Plain
type	page

Table Excerpt Include

static	true
name	Custom
page	Custom
type	page

Parameters for online transfers with Trustly

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_IntroURL
PageWithExcerpt	Reuse API

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1644856263600_130882503
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	trustly_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1644856263603_-28263535
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MID
page	mid
type	page

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Table Excerpt Include

static	true
name	XID
page	XID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Key

Format

CND

Description

Beschreibung

Status

a..50

M

OK – is reported by

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

via URLSuccess redirect and also as a separate notify
FAILED – is reported by

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

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

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

.

If this function is active, you will receive two notifies, the initial AUTHORIZE_REQUEST and later with the final status.

OK – wird vom

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Platform-Kurz
PageWithExcerpt	DE:Wording

via URLSuccess Redirect und auch im separaten Notify gemeldet
FAILED – wird vom

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Platform-Kurz
PageWithExcerpt	DE:Wording

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

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

.

Wenn diese Funktion aktiv ist, erhalten Sie zwei Notifies, initial AUTHORIZE_REQUEST und später mit dem finalen Status.

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Table Excerpt Include

static	true
name	UserData
page	UserData
type	page

Table Excerpt Include

static	true
name	Plain
page	Plain
type	page

Table Excerpt Include

static	true
name	Custom
page	Custom
type	page

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

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Credit_Intro
PageWithExcerpt	Reuse API

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

credit.aspx

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1644876917054_654190263
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	credit_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1644876917056_-1628722191
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

static	true
name	PayID_Credit
page	PayID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	Amount
page	Amount
type	page

Table Excerpt Include

static	true
name	Currency
page	Currency
type	page

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Table Excerpt Include

static	true
name	ReqId-ans..32
page	ReqId
type	page

Parameters for credits of payments with Trustly

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1644877005596_264021740
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	credit_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1644877005598_877450417
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MID
page	mid
type	page

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Table Excerpt Include

static	true
name	XID
page	XID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Response parameters for credits of payments with Trustly

Batch processing via the interface

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Batch_Intro
PageWithExcerpt	Reuse API

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:

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1644877425973_-1009447815
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	batch_versions

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1644877425974_-1990291712
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

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:

Multiexcerpt

MultiExcerptName	batch_structure
shouldDisplayInlineCommentsInIncludes	false

Code Block

language	xml

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

Example for Master MID function:

Multiexcerpt

MultiExcerptName	batch_mastermid
shouldDisplayInlineCommentsInIncludes	false

Code Block

language	xml

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

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Batch_Request_Intro
PageWithExcerpt	Reuse API

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1644877551190_-74965912
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	batch_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1644877551193_154867106
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

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)

Table Excerpt Include

name	Amount
page	Amount
type	page

Table Excerpt Include

static	true
name	Currency
page	Currency
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Key	Format	CND	Description	Beschreibung
RefNr	ns..30	O	Merchant's unique reference number	Eindeutige Referenznummer des Händlers

Table Excerpt Include

static	true
name	PayID_Batch
page	PayID
type	page

Description of fields within the record for Batch files

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

Multiexcerpt

MultiExcerptName	batch_structure_response
shouldDisplayInlineCommentsInIncludes	false

Code Block

language	xml

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

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Batch_Response_Intro
PageWithExcerpt	Reuse API

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1644877711186_854258574
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	batch_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1644877711187_-111430100
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

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)

Table Excerpt Include

static	true
name	PayID_Batch
page	PayID
type	page

Table Excerpt Include

static	true
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Description of result parameters within the record for Batch files

Test data

Table Filter

ddSeparators	true
inverse	false
default	Beschreibung&&
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1631034498114_536535656
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Testdata
PageWithExcerpt	Test Trustly

Space shortcuts

Page tree

Versions Compared

Old Version 216

New Version 217

Key

About Trustly

General information about Trustly

Process flow chart

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
interface

Trustly Online transfer

Credit with reference

Batch processing via the interface

Test data

Paygate

Computop

Help

Intranet Tools

Space shortcuts

Page tree

Page History

Versions Compared

Old Version 216

New Version 217

Key

About Trustly

General information about Trustly

Process flow chart

Multiexcerpt includeSpaceWithExcerptENMultiExcerptNamePlatform-KurzPageWithExcerptWording interface

Trustly Online transfer

Credit with reference

Batch processing via the interface

Test data

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
interface