This documentation is deprecated and only available for supporting old/legacy integrations using for example hashes.
New documentation can be found here: Home
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.
The webstore can order the service themselves using our Subscription page: https://www.maksuturva.fi/MerchantSubscriptionBeginning.pmt
Skip to contents in this page
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 | Description |
|---|---|---|---|---|---|---|
Interface version | srv_version | 0002 | AN4 | 4 | C | Interface version of this subscription message |
Webstore software provider’s account for subscribing for new Svea Payments services | srv_webstoreserviceid |
| AN15 | 1 | C | The user account for webstore software provider. |
Finnish business identification code of the company running the webstore | srv_businessid |
| AN15 | 9 | O | Finnish business identification code of the company running the webstore |
Name of the company | srv_businessname |
| AN80 | 1 | O | The official name of the company running the webstore |
Marketing name of the company | srv_marketingname |
| AN80 | 1 | O | Marketing name of the company (for example used with postal packages) |
WWW address of the company (not the webstore!) | srv_businesswww |
| AN200 | 4 | O | WWW address of the company (not the webstore!) |
E-mail of the company | srv_businessemail |
| AN80 | 4 | O | E-mail of the company |
Phone number of the company | srv_businessphone |
| AN40 | 1 | O | Phone number of the company |
Fax number of the company | srv_businessfax |
| AN40 | 1 | O | Fax number of the company |
Default bank account of the webstore (IBAN) | srv_webstoreiban |
| AN30 | 18 | O | Default bank account of the webstore (IBAN). This is the account that will receive compensations from Svea Payments Oy. Account number must be a Finnish bank account in IBAN form. |
Name of the webstore | srv_webstorename |
| AN80 | 1 | C | Name of the webstore (will be shown to buyers in Svea Payments service) |
WWW address of the webstore | srv_webstorewww |
| AN200 | 4 | O | WWW address of the webstore (will be shown to buyers in Svea Payments service) |
Webstore customer service contact information | srv_webstorecustomerservice |
| AN100 | 1 | O | Webstore customer service contact information. This will be part of confirmation and other e-mails sent to buyers from Svea Payments service. This must be comprehensible by Finnish, Swedish and English speaking persons. Example: ”info@verkkokauppa.fi, (09) 123 4567”. |
Street address of the company | srv_businessaddress |
| AN100 | 5 | O | Street address of the company running the webstore |
P.O.box of the company | srv_businesspobox |
| AN10 | 4 | O | P.O.box of the company |
Postal code of the company | srv_businesspostalcode |
| AN5 | 5 | O | Postal code of the company |
City of the company | srv_businesscity |
| AN40 | 1 | O | City of the company |
Country (code) of the company | srv_businesscountrycode |
| AN2 | 2 | O | Country (code) of the company. Based on ISO 3166-1 standard. Default: FI |
Billing address of the company | srv_billingaddress |
| AN100 | 5 | O | Billing street address of the company running the webstore. Billing address information must be given, if it’s different from company’s generic address information described above. |
Billing P.O.box of the company | srv_billingpobox |
| AN10 | 4 | O | Billing P.O.box of the company |
Billing postal code of the company | srv_billingpostalcode |
| AN5 | 5 | O | Billing postal code of the company |
Billing city of the company | srv_billingcity |
| AN40 | 1 | O | Billing city of the company |
Billing country (code) of the company | srv_billingcountrycode |
| AN2 | 2 | O | Billing country of the company. Based on ISO 3166-1 standard. Default: FI |
Street address of the webstore | srv_webstoreaddress |
| AN100 | 1 | O | Street address of the webstore. Webstore’s address information must be given, if it’s different from company’s default address. |
P.O.box of the webstore | srv_webstorepobox |
| AN10 | 4 | O | P.O.box of the webstore |
Postal code of the webstore | srv_webstorepostalcode |
| AN5 | 1 | O | Postal code of the webstore |
City of the webstore | srv_webstorecity |
| AN40 | 1 | O | City of the webstore |
Country (code) of the webstore | srv_webstorecountrycode |
| AN2 | 1 | O | Country of the webstore. Based on ISO 3166-1 standard. Default: FI |
Name of the company’s contact person | srv_contactpersonname |
| AN80 | 1 | O | Name of the company’s contact person (used by Svea Payments Oy to contact the company). |
E-mail of the company’s contact person | srv_contactpersonemail |
| AN80 | 4 | O | E-mail of the company’s contact person |
Phone number of the company’s contact person | srv_contactpersonphone |
| AN40 | 1 | O | Phone number of the company’s contact person |
Mobile phone number of the company’s contact person | srv_contactpersonmobile |
| AN40 | 1 | O | Mobile phone number of the company’s contact person |
Fax number of the company’s contact person | srv_contactpersonfax |
| AN40 | 1 | O | Fax of the company’s contact person |
Name of the company’s billing contact person | srv_billingpersonname |
| AN80 | 1 | O | Name of the company’s billing contact person (used by Svea Payments Oy to contact the company in billing issues). |
E-mail of the company’s billing contact person | srv_billingpersonemail |
| AN80 | 4 | O | E-mail of the company’s billing contact person |
Phone number of the company’s billing contact person | srv_billingpersonphone |
| AN40 | 1 | O | Phone number of the company’s billing contact person |
Mobile phone number of the company’s billing contact person | srv_billingpersonmobile |
| AN40 | 1 | O | Mobile phone number of the company’s billing contact person |
Fax number of the company’s billing contact person | srv_billingpersonfax |
| AN40 | 1 | O | Fax of the company’s billing contact person |
Name of the company’s technical contact person | srv_webstorepersonname |
| AN80 | 1 | O | Name of the company’s technical contact person (used by Svea Payments Oy to contact the company in technical issues). |
E-mail of the company’s technical contact person | srv_webstorepersonemail |
| AN80 | 4 | O | E-mail of the company’s technical contact person |
Phone number of the company’s technical contact person | srv_webstorepersonphone |
| AN40 | 1 | O | Phone number of the company’s technical contact person |
Mobile phone number of the company’s technical contact person | srv_webstorepersonmobile |
| AN40 | 1 | O | Mobile phone number of the company’s technical contact person |
Fax number of the company’s technical contact person | srv_webstorepersonfax |
| AN40 | 1 | O | Fax of the company’s technical contact person |
Payment methods for the webstore | srv_paymentmethodinfo |
| AN200 | 1 | O |