Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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.

Table of Contents

Subscription Request

Webstore software delivers information about the webstore, the company running the webstore and service parameters in a <form> using POST method as hidden input fields (<input type=hidden>) to address https://www.maksuturva.fi/MerchantSubscription.pmt (or https://test1.maksuturva.fi/MerchantSubscription.pmt in test environment).

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.