About Swish

General information about Swish

Logo

Info

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.swish.nu/).

Configuration for Swish

Certificate Management

Each merchant needs a certificate for each MID. For the Certificate Management, please follow the instructions at https://developer.swish.nu/documentation/integration.

You need to order a new Certificate. The Certificate Signing Request (CSR) will be provided by .

Overview of the Certificate Management process:

Once you have access to Swish Certificate Management Tool, contact at with request for Swish CSR
creates CSR and sends it to you
You will need to upload the CSR received from 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 the Certificate as response to email with CSR received from

interface

Call of interface for Swish

In order to process a Swish payment via the form, please use the following URL:

swish.aspx

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.

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 :;.,?!()”.

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

Parameters for payments with Swish

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

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 .	Fehlercode von Swish. Hinweis: Wird nur bei Status=FAILED zurückgegeben. Nutzung nur in Abstimmung mit dem möglich.
ErrorText	ans..256	C	Detailed Swish error message. Notice: Is returned only if Status=FAILED. Use is possible only in agreement with .	Detaillierte Swish-Fehlermeldung. Hinweis: Wird nur bei Status=FAILED zurückgegeben. Nutzung nur in Abstimmung mit dem 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

Result parameters for Swish payments

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

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

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 .	Fehlercode von Swish. Hinweis: Wird nur bei Status=FAILED zurückgegeben. Nutzung nur in Abstimmung mit dem möglich.
ErrorText	ans..256	C	Detailed Swish error message. Notice: Is returned only if Status=FAILED. Use is possible only in agreement with .	Detaillierte Swish-Fehlermeldung. Hinweis: Wird nur bei Status=FAILED zurückgegeben. Nutzung nur in Abstimmung mit dem 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

Result parameters for URLNotify

Credit with reference

credit.aspx

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.

Parameters for credits of Swish payments

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

Result parameters for credits of Swish payments

Batch processing via the interface

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:

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:

HEAD,<MerchantID>,<Date>,<Version>
Swish,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, 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.

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

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

About Swish

General information about Swish

On this page

Process flow charts

Configuration for Swish

Certificate Management

interface

Call of interface for Swish

Credit with reference

Batch processing via the interface