Merchant Subscription

Please notice, that this service is intended to be used by webstore software providers that provide their hosting services for multiple webstores. This service enables webstore software providers to offer webstores seamless and easy integration to Svea Payments as their Payment Service Provider. In other words, a single webstore does not gain anything from integrating this service. Furthermore, this service requires use of a webstore software provider ID which is different kind of credentials than webstore ID used for example in Payments API.

Webstore software provider can send information about the webstore using this interface for faster and simpler webstore subscription and deployment procedure at Svea Payments. Webstore fills in the missing information and makes his choices regarding Svea Payments services and finally signs the subscription using Internet banking credentials (TUPAS) or orders paper contracts by mail for signing.

The response message indicates following result scenarios:

Created a new customer and a new payment service
Added a new payment service for existing customer
Payment service creation failed. Detailed error reason and description are included in the response.

Field	Input name	Value	Format	Min length	C/O
Interface version	srv_version	0002	AN4	4	C
Webstore software provider’s account for subscribing for new Svea Payments services	srv_webstoreserviceid		AN15	1	C
Finnish business identification code of the company running the webstore	srv_businessid		AN15	9	O
Name of the company	srv_businessname		AN80	1	O
Marketing name of the company	srv_marketingname		AN80	1	O
WWW address of the company (not the webstore!)	srv_businesswww		AN200	4	O
E-mail of the company	srv_businessemail		AN80	4	O
Phone number of the company	srv_businessphone		AN40	1	O
Fax number of the company	srv_businessfax		AN40	1	O
Default bank account of the webstore (IBAN)	srv_webstoreiban		AN30	18	O
Name of the webstore	srv_webstorename		AN80	1	C
WWW address of the webstore	srv_webstorewww		AN200	4	O
Webstore customer service contact information	srv_webstorecustomerservice		AN100	1	O
Street address of the company	srv_businessaddress		AN100	5	O
P.O.box of the company	srv_businesspobox		AN10	4	O
Postal code of the company	srv_businesspostalcode		AN5	5	O
City of the company	srv_businesscity		AN40	1	O
Country (code) of the company	srv_businesscountrycode		AN2	2	O
Billing address of the company	srv_billingaddress		AN100	5	O
Billing P.O.box of the company	srv_billingpobox		AN10	4	O
Billing postal code of the company	srv_billingpostalcode		AN5	5	O
Billing city of the company	srv_billingcity		AN40	1	O
Billing country (code) of the company	srv_billingcountrycode		AN2	2	O
Street address of the webstore	srv_webstoreaddress		AN100	1	O
P.O.box of the webstore	srv_webstorepobox		AN10	4	O
Postal code of the webstore	srv_webstorepostalcode		AN5	1	O
City of the webstore	srv_webstorecity		AN40	1	O
Country (code) of the webstore	srv_webstorecountrycode		AN2	1	O
Name of the company’s contact person	srv_contactpersonname		AN80	1	O
E-mail of the company’s contact person	srv_contactpersonemail		AN80	4	O
Phone number of the company’s contact person	srv_contactpersonphone		AN40	1	O
Mobile phone number of the company’s contact person	srv_contactpersonmobile		AN40	1	O
Fax number of the company’s contact person	srv_contactpersonfax		AN40	1	O
Name of the company’s billing contact person	srv_billingpersonname		AN80	1	O
E-mail of the company’s billing contact person	srv_billingpersonemail		AN80	4	O
Phone number of the company’s billing contact person	srv_billingpersonphone		AN40	1	O
Mobile phone number of the company’s billing contact person	srv_billingpersonmobile		AN40	1	O
Fax number of the company’s billing contact person	srv_billingpersonfax		AN40	1	O
Name of the company’s technical contact person	srv_webstorepersonname		AN80	1	O
E-mail of the company’s technical contact person	srv_webstorepersonemail		AN80	4	O
Phone number of the company’s technical contact person	srv_webstorepersonphone		AN40	1	O
Mobile phone number of the company’s technical contact person	srv_webstorepersonmobile		AN40	1	O
Fax number of the company’s technical contact person	srv_webstorepersonfax		AN40	1	O
Payment methods for the webstore	srv_paymentmethodinfo		AN200	1	O
Delivery methods for the webstore	srv_deliverymethodinfo		AN200	1	O
Service begin date for the webstore’s Svea Payments service	srv_servicebegindate	dd.mm.yyyy	AN10	10	O
Campaign code	srv_campaigncode		AN10	5	O
Additional information about the subscription	srv_additionalinformation		AN2000	1	O
Desired response type	srv_resptype	POST	AN4	3	O
Ok return url	srv_okreturn		AN200	11	C
Error return url	srv_errorreturn		AN200	11	O
Cancel return url	srv_cancelreturn		AN200	11	O
Charset for calculating the hash	srv_charset	ISO-8859-1, ISO-8859-15 or UTF-8	AN15	5	O
Hash algorithm	srv_hashversion		AN10	1	C
Hash	srv_hash		AN128	32	C
Secret key generation	srv_keygeneration	Default: 001	N3	1	C

The note ANxx means that the field contains a maximum of xx alphanumeric characters. N means numeric. C means that the field is compulsory and O means it is optional.

This documentation is deprecated and only available for supporting old/legacy integrations using for example hashes.">This documentation is deprecated and only available for supporting old/legacy integrations using for example hashes.

New documentation can be found here: [DOCS:Home]">New documentation can be found here: [DOCS:Home]

Subscription Request

This documentation is deprecated and only available for supporting old/legacy integrations using for example hashes.">This documentation is deprecated and only available for supporting old/legacy integrations using for example hashes.

New documentation can be found here: [DOCS:Home]">New documentation can be found here: [DOCS:Home]