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]



Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

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.

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 lenght

C/O

Interface version

Webstore software provider’s account for subscribing for new Maksuturva services

Finnish business identification code of the company running the webstore

Name of the company

Marketing name of the company

WWW address of the company (not the webstore!)

E-mail of the company

Phone number of the company

Fax number of the company

Default bank account of the webstore (IBAN)

Name of the webstore

WWW address of the webstore

Webstore customer service contact information

Street address of the company

P.O.box of the company

Postal code of the company

City of the company

Country (code) of the company

Billing address of the company

Billing P.O.box of the company

Billing postal code of the company

Billing city of the company

Billing country (code) of the company

Street address of the webstore

P.O.box of the webstore

Postal code of the webstore

City of the webstore

Country (code) of the webstore

Name of the company’s contact person

E-mail of the company’s contact person

Phone number of the company’s contact person

Mobile phone number of the company’s contact person

Fax number of the company’s contact person

Name of the company’s billing contact person

E-mail of the company’s billing contact person

Phone number of the company’s billing contact person

Mobile phone number of the company’s billing contact person

Fax number of the company’s billing contact person

Name of the company’s technical contact person

E-mail of the company’s technical contact person

Phone number of the company’s technical contact person

Mobile phone number of the company’s technical contact person

Fax number of the company’s technical contact person

Payment methods for the webstore

Delivery methods for the webstore

Service begin date for the webstore’s Svea Payments service

Campaign code

Additional information about the subscription

Desired response type

Ok return url

Error return url

Cancel return url

Charset for calculating the hash

Hash algorithm

Hash

Secret key generation

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.

  • No labels

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]