About Swish

General information about Swish

Page properties

Logo

Info

Excerpt

The swedish payment method Swish is one of the most popular payment methods in Sweden. More than half of the population uses the app on their cell phones. Originally Swish was a joint venture project of the most popular swedish banks as a pure P2P-payment method. Since 2017 it is also available for E-Commerce and POS. If you want to pay, you can either do it via scan of a QR-code or the submission of your mobile or swish number.

Type

Payments by eWallet

Further information can be found on the webpage of Swish (https://www.getswishswish.senu/).

Configuration for Swish

Certificate Management

Each merchant needs a certificate for each MID. For the Certificate Management, you need to download the following document: please follow the instructions at https://wwwdeveloper.getswishswish.senu/content/uploads/2015/06/Guide-Certifikatsadministration_160118.pdfdocumentation/integration.

You need to order a new Certificate, as described in section 2. 6 of the downloaded document. The Certificate Signing Request (CSR) will be provided by by

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Partner-Name
PageWithExcerpt	Wording

.

Overview of the Certificate Management process:

Once you have access to Swish Certificate Management Tool, contact
Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Partner-Name
PageWithExcerpt Wording
at
Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Helpdesk-Name
PageWithExcerpt Wording
with request for Swish CSR
Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Partner-Name
PageWithExcerpt Wording
creates CSR and sends it to you
You will need to upload the CSR received from
Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Partner-Name
PageWithExcerpt Wording
in Swish Certificate Management Tool
You will generate and download the Certificate, as described in section 2.6 of the downloaded document. The format of Certificate can be either PEM or PKCS#7.
You will send back to
Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Partner-Name
PageWithExcerpt Wording
the Certificate as response to email with CSR received from
Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Partner-Name
PageWithExcerpt Wording

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
interface

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Definition
PageWithExcerpt	Definition EN

Call of interface for Swish

In order to process a Swish payment via the

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

form, please use the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

swish.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	1637099200476_119559542
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	swish_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1637099200478_-1104206454
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

Key

Format

CND

Description

Beschreibung

RefNr

ans..35

O

Unique reference number

Eindeutige Referenznummer

Amount

n..10

M

Amount in the smallest currency unit (e.g. SEK Öre)

Please contact the helpdesk, if you want to capture amounts < 100 (smallest currency unit).

Betrag in der kleinsten Währungseinheit (z.B. SEK Öre).

Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Currency, three digits DIN / ISO 4217. Only SEK permitted.

Währung, drei Zeichen DIN / ISO 4217. Nur SEK erlaubt.

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Key	Format	CND	Description	Beschreibung
OrderDesc	ans..128	M	Description of purchased goods, unit prices etc. Permitted characters a-ö, A-Ö, the digits 0-9 and the special characters :;.,?!()”.	Beschreibung der gekauften Waren, Einzelpreise etc. Erlaubte Zeichen a-ö, A-Ö, die Ziffern 0-9 und die Sonderzeichen :;.,?!()”.

Table Excerpt Include

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

Key

Format

CND

Description

Beschreibung

Channel

a3

M

Channel for processing the payment

Possible values: Web or App

Web = eCommerce

App = mCommerce

Kanal, über den die Zahlung abgewickelt werden soll.

Mögliche Werte: Web oder App

Web = eCommerce

App = mCommerce

MobileNr

n..20

C

Customer’s mobile telephone number. (mandatory if Channel = Web)

The submitted mobile telephone number of that person that makes the payment. Only digits are allowed and it must have at least 8 digits and maximal 15 digits. In order to get found by Swish, it also must comply with the following format: Country code + Mobile telephone number (without leading Zero). e.g.: 46712345678

Mobiltelefonnummer des Kunden. (Pflicht, wenn Channel = Web)

Die eingetragene Mobiltelefonnummer der Person, welche die Zahlung vornimmt. Sie darf nur Ziffern enthalten und muss mindestens 8 und maximal 15 Stellen haben. Sie muss auch folgendem Format entsprechen, um von Swish gefunden zu werden: Ländercode + Mobiltelefonnummer (ohne führende Null). z.B.: 46712345678

Table Excerpt Include

static	true
name	URLNotify
page	URLNotify
type	page

Table Excerpt Include

static	true
name	UserData
page	UserData
type	page

Parameters for payments with Swish

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	1637099698174_1381293741
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	swish_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1637099698175_-2102341904
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
RefNr	ans..35	O	Unique reference number	Eindeutige Referenznummer
Status	a..50	M	AUTHORIZE_REQUEST or FAILED	AUTHORIZE_REQUEST oder FAILED

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Key

Format

CND

Description

Beschreibung

CodeExt

ans..10

C

Error code from Swish.

Notice: Is returned only if Status=FAILED. Use is possible only in agreement with

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

.

Fehlercode von Swish.

Hinweis: Wird nur bei Status=FAILED zurückgegeben. Nutzung nur in Abstimmung mit dem

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

möglich.

ErrorText

ans..256

C

Detailed Swish error message.

Notice: Is returned only if Status=FAILED. Use is possible only in agreement with

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

.

Detaillierte Swish-Fehlermeldung.

Hinweis: Wird nur bei Status=FAILED zurückgegeben. Nutzung nur in Abstimmung mit dem

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

möglich.

TransactionID

ans..50

O

Transaction ID from Swish

Transaktions-ID von Swish

TokenExt

an..32

C

In order to open the Swish app TokenExt together with the Custom URL Scheme are necessary.

TokenExt ist returned only if Channel=App.

e.g..: swish://paymentrequest?token=f34DS34lfd0d03fdDselkfd3ffk21

Der TokenExt wird zum Öffnen der Swish-App zusammen mit dem Custom URL Scheme benötigt.

Der TokenExt wird nur zurückgegeben, wenn der Channel=App ist.

z.B..: swish://paymentrequest?token=f34DS34lfd0d03fdDselkfd3ffk21

URLConfirm

ans..256

O

Location URL returned by Swish.

e.g.: https://mss.swicpc.bankgirot.se/swish-cpcapi/api/v1/paymentrequests/A44C22F42E3C4D498C4D8B1D4A6CE743

Von Swish zurückgegebene Location URL.

z.B.: https://mss.swicpc.bankgirot.se/swish-cpcapi/api/v1/paymentrequests/A44C22F42E3C4D498C4D8B1D4A6CE743

Table Excerpt Include

static	true
name	UserData
page	UserData
type	page

Result parameters for Swish payments

The following table gives the results parameters which the

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

transfers to your URLNotify. If you have specified the Response=encrypt parameter, the following parameters are sent Blowfish encrypted to your system:

Table Filter

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

Multiexcerpt

MultiExcerptName	swish_notify

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1637100238354_-451677088
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
RefNr	ans..35	O	Unique reference number	Eindeutige Referenznummer

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

Key

Format

CND

Description

Beschreibung

CodeExt

ans..10

C

Error code from Swish.

Notice: Is returned only if Status=FAILED. Use is possible only in agreement with

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

.

Fehlercode von Swish.

Hinweis: Wird nur bei Status=FAILED zurückgegeben. Nutzung nur in Abstimmung mit dem

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

möglich.

ErrorText

ans..256

C

Detailed Swish error message.

Notice: Is returned only if Status=FAILED. Use is possible only in agreement with

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

.

Detaillierte Swish-Fehlermeldung.

Hinweis: Wird nur bei Status=FAILED zurückgegeben. Nutzung nur in Abstimmung mit dem

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

möglich.

TransactionID

ans..50

O

Transaction ID from Swish

Transaktions-ID von Swish

TokenExt

an..32

C

In order to open the Swish app TokenExt together with the Custom URL Scheme are necessary.

TokenExt ist returned only if Channel=App.

e.g..: swish://paymentrequest?token=f34DS34lfd0d03fdDselkfd3ffk21

Der TokenExt wird zum Öffnen der Swish-App zusammen mit dem Custom URL Scheme benötigt.

Der TokenExt wird nur zurückgegeben, wenn der Channel=App ist.

z.B..: swish://paymentrequest?token=f34DS34lfd0d03fdDselkfd3ffk21

URLConfirm

ans..256

O

Location URL returned by Swish.

e.g.: https://mss.swicpc.bankgirot.se/swish-cpcapi/api/v1/paymentrequests/A44C22F42E3C4D498C4D8B1D4A6CE743

Von Swish zurückgegebene Location URL.

z.B.: https://mss.swicpc.bankgirot.se/swish-cpcapi/api/v1/paymentrequests/A44C22F42E3C4D498C4D8B1D4A6CE743

Table Excerpt Include

static	true
name	UserData
page	UserData
type	page

Result parameters for 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	1637100683604_1705504988
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	1637100683606_-976239833
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

Key

Format

CND

Description

Beschreibung

RefNr

ans..35

O

Unique reference number

Eindeutige Referenznummer

Amount

n..10

M

Amount in the smallest currency unit (e.g. SEK Öre Cent)

Please contact the helpdesk, if you want to capture amounts < 100 (smallest currency unit).

Betrag in der kleinsten Währungseinheit (z.B. SEK Öre).

Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Currency code, three digits DIN / ISO 4217. Only SEK permissible.

Währung, drei Zeichen DIN / ISO 4217. Nur SEK erlaubt.

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 Swish payments

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	1637100924089_-351776588
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	1637100924090_1088941320
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
RefNr	ans..35	O	Unique reference number	Eindeutige Referenznummer

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

Result parameters for credits of Swish payments

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 Swish, 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	1637101149722_-1190591487
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	1637101149724_-2113755042
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 an Swish payment in a Batch file to be submitted is as follows:

Multiexcerpt

MultiExcerptName	batch_structure
shouldDisplayInlineCommentsInIncludes	false

Code Block

language	xml

HEAD,<MerchantID>,<Date>,<Version>
Swish,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	1637101513373_-462150057
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	1637101513375_597308878
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, Swish for Swish	HEAD für Header, FOOT für Footer, Swish für Swish
Action	a..20	M	The parameter Action defines the type of transaction: Credit	Der Action-Parameter definiert die Art der Transaktion: Credit (Gutschrift)
Amount	n..10	M	Amount in the smallest currency unit (e.g. SEK Öre) Please contact the helpdesk, if you want to capture amounts < 100 (smallest currency unit).	Betrag in der kleinsten Währungseinheit (z.B. SEK Öre). Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.
Currency	a3	M	Currency code, three digits DIN / ISO 4217. Only SEK permissible.	Währung, drei Zeichen DIN / ISO 4217. Nur SEK erlaubt.

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Key	Format	CND	Description	Beschreibung
RefNr	ans..35	O	Unique reference number	Eindeutige Referenznummer

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_Response
shouldDisplayInlineCommentsInIncludes	false

Code Block

language	xml

HEAD,<MerchantID>,<Date>,<Version>
Swish,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	1637101732693_2008448079
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	1637101732695_-1411442441
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

Space shortcuts

Page tree

Versions Compared

Old Version 7

New Version 8

Key

About Swish

General information about Swish

On this page

Process flow charts

Configuration for Swish

Certificate Management

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
interface

Call of interface for Swish

Credit with reference

Batch processing via the interface

Paygate

Computop

Help

Intranet Tools

Space shortcuts

Page tree

Page History

Versions Compared

Old Version 7

New Version 8

Key

About Swish

General information about Swish

On this page

Process flow charts

Configuration for Swish

Certificate Management

Multiexcerpt includeSpaceWithExcerptENMultiExcerptNamePlatform-KurzPageWithExcerptWording interface

Call of interface for Swish

Credit with reference

Batch processing via the interface

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
interface