This documentation is deprecated and only available for supporting old/legacy integrations using for example hashes.
New documentation can be found here: Home
New Payment
- Aleksi Ahonen
- Viivi Ahlqvist
Owned by Aleksi Ahonen
Â
Skip to contents in this page
Request examples
Â
Example 1:
Escrow payment service
Billing and Delivery address mismatch
Webstore return addresses do not contain querystring
Buyer will choose payment method in Svea Payments payment method selection page
<form method="post" action="https://test1.maksuturva.fi/NewPaymentExtended.pmt">
<input type="submit" value="Pay">
<input type="hidden" name="pmt_action" value="NEW_PAYMENT_EXTENDED" />
<input type="hidden" name="pmt_version" value="0004" />
<input type="hidden" name="pmt_sellerid" value="ABC123DE" />
<input type="hidden" name="pmt_id" value="1998524_1" />
<input type="hidden" name="pmt_orderid" value="1998524" />
<input type="hidden" name="pmt_reference" value="19985242" />
<input type="hidden" name="pmt_duedate" value="15.10.2014" />
<input type="hidden" name="pmt_userlocale" value="fi_FI" />
<input type="hidden" name="pmt_amount" value="568,10" />
<input type="hidden" name="pmt_currency" value="EUR" />
<input type="hidden" name="pmt_okreturn" value="http://www.mytestshop.fi/pay/return/Success.do" />
<input type="hidden" name="pmt_errorreturn" value="http://www.mytestshop.fi/pay/return/Error.do" />
<input type="hidden" name="pmt_cancelreturn" value="http://www.mytestshop.fi/pay/return/Cancel.do" />
<input type="hidden" name="pmt_delayedpayreturn" value="http://www.mytestshop.fi/pay/return/Cancel.do" />
<input type="hidden" name="pmt_escrow" value="Y" /> <!-- Tyytyväisyystakuu-palvelu, escrow=Y -->
<input type="hidden" name="pmt_escrowchangeallowed" value="N" />
<input type="hidden" name="pmt_buyername" value="Teemu Testaaja" />
<input type="hidden" name="pmt_buyeraddress" value="Ruoholahdenkatu 23" />
<input type="hidden" name="pmt_buyerpostalcode" value="00180" />
<input type="hidden" name="pmt_buyercity" value="Helsinki" />
<input type="hidden" name="pmt_buyercountry" value="FI" />
<input type="hidden" name="pmt_buyerphone" value="0401234567" />
<input type="hidden" name="pmt_buyeremail" value="teemu.testaaja@maksuturva.fi" />
<input type="hidden" name="pmt_deliveryname" value="Teemu Testaaja" />
<input type="hidden" name="pmt_deliveryaddress" value="Kotikatu 1" />
<input type="hidden" name="pmt_deliverypostalcode" value="00330" />
<input type="hidden" name="pmt_deliverycity" value="Helsinki" />
<input type="hidden" name="pmt_deliverycountry" value="FI" />
<input type="hidden" name="pmt_sellercosts" value="5,00" />
<input type="hidden" name="pmt_rows" value="4" />
<input type="hidden" name="pmt_row_name1" value="Tuote A" />
<input type="hidden" name="pmt_row_desc1" value="Tuotteen A kuvaus" />
<input type="hidden" name="pmt_row_quantity1" value="2" />
<input type="hidden" name="pmt_row_deliverydate1" value="15.10.2014" />
<input type="hidden" name="pmt_row_price_gross1" value="123,00" />
<!--<input type="hidden" name="pmt_row_price_net1" value="100,00" />--> <!-- netto vaihtoehtoinen brutolle -->
<input type="hidden" name="pmt_row_vat1" value="23,00" />
<input type="hidden" name="pmt_row_discountpercentage1" value="0,00" />
<input type="hidden" name="pmt_row_type1" value="1" />
<input type="hidden" name="pmt_row_name2" value="Räätälöity alennustuote B" />
<input type="hidden" name="pmt_row_desc2" value="Räätälöidyn alennustuotteen kuvaus" />
<input type="hidden" name="pmt_row_quantity2" value="1" />
<input type="hidden" name="pmt_row_deliverydate2" value="15.10.2014" />
<input type="hidden" name="pmt_row_price_gross2" value="369,00" />
<!--<input type="hidden" name="pmt_row_price_net2" value="300,00" /> netto vaihtoehtoinen brutolle -->
<input type="hidden" name="pmt_row_vat2" value="23,00" />
<input type="hidden" name="pmt_row_discountpercentage2" value="10,00" />
<input type="hidden" name="pmt_row_type2" value="4" />
<input type="hidden" name="pmt_row_name3" value="Toimituskulut" />
<input type="hidden" name="pmt_row_desc3" value="Toimitustapa yms." />
<input type="hidden" name="pmt_row_quantity3" value="1" />
<input type="hidden" name="pmt_row_deliverydate3" value="15.10.2014" />
<input type="hidden" name="pmt_row_price_gross3" value="5,00" />
<!--<input type="hidden" name="pmt_row_price_net3" value="5,00" />--> <!-- netto vaihtoehtoinen brutolle -->
<input type="hidden" name="pmt_row_vat3" value="0,00" />
<input type="hidden" name="pmt_row_discountpercentage3" value="0,00" />
<input type="hidden" name="pmt_row_type3" value="2" />
<input type="hidden" name="pmt_row_name4" value="Alennus" />
<input type="hidden" name="pmt_row_desc4" value="Alennuskupongin koodi tms." />
<input type="hidden" name="pmt_row_quantity4" value="1" />
<input type="hidden" name="pmt_row_deliverydate4" value="15.10.2014" />
<input type="hidden" name="pmt_row_price_gross4" value="-10,00" />
<!--<input type="hidden" name="pmt_row_price_net4" value="-10,00" />--> <!-- netto vaihtoehtoinen brutolle -->
<input type="hidden" name="pmt_row_vat4" value="0,00" />
<input type="hidden" name="pmt_row_discountpercentage4" value="0,00" />
<input type="hidden" name="pmt_row_type4" value="6" />
<input type="hidden" name="pmt_charset" value="ISO-8859-15" />
<input type="hidden" name="pmt_charsethttp" value="ISO-8859-15" />
<input type="hidden" name="pmt_hashversion" value="SHA-1" />
<input type="hidden" name="pmt_hash" value="D26B59EAD06ED6E44E0B279B61C4894DEEE85A8B" />
<input type="hidden" name="pmt_keygeneration" value="1" />
</form>Â
Example 2:
Direct payment service
Billing and Delivery address identical
Webstore return addresses contain querystring
Buyer has chosen payment method Svea Payments Invoice (FI60) in the webstore
<form method="post" action="https://test1.maksuturva.fi/NewPaymentExtended.pmt">
<input type="submit" value="Pay">
<input type="hidden" name="pmt_action" value="NEW_PAYMENT_EXTENDED" />
<input type="hidden" name="pmt_version" value="0004" />
<input type="hidden" name="pmt_sellerid" value="ABC123DE" />
<input type="hidden" name="pmt_id" value="1998524_1" />
<input type="hidden" name="pmt_orderid" value="1998524" />
<input type="hidden" name="pmt_reference" value="19985242" />
<input type="hidden" name="pmt_duedate" value="15.10.2014" />
<input type="hidden" name="pmt_userlocale" value="fi_FI" />
<input type="hidden" name="pmt_amount" value="568,10" />
<input type="hidden" name="pmt_currency" value="EUR" />
<input type="hidden" name="pmt_okreturn" value="http://www.mytestshop.fi/pay/return/Success.do?paid=1" />
<input type="hidden" name="pmt_errorreturn" value="http://www.mytestshop.fi/pay/return/Error.do?paid=0" />
<input type="hidden" name="pmt_cancelreturn" value="http://www.mytestshop.fi/pay/return/Cancel.do?paid=0" />
<input type="hidden" name="pmt_delayedpayreturn" value="http://www.mytestshop.fi/pay/return/Cancel.do?paid=0" />
<input type="hidden" name="pmt_escrow" value="N" /> <!-- Suoramaksupalvelu, escrow=N -->
<input type="hidden" name="pmt_escrowchangeallowed" value="N" />
<input type="hidden" name="pmt_paymentmethod" value="FI60" /> <--- Verkkokaupassa valittu maksutapa -->
<input type="hidden" name="pmt_buyername" value="Teemu Testaaja" />
<input type="hidden" name="pmt_buyeraddress" value="Ruoholahdenkatu 23" />
<input type="hidden" name="pmt_buyerpostalcode" value="00180" />
<input type="hidden" name="pmt_buyercity" value="Helsinki" />
<input type="hidden" name="pmt_buyercountry" value="FI" />
<input type="hidden" name="pmt_buyerphone" value="0401234567" />
<input type="hidden" name="pmt_buyeremail" value="teemu.testaaja@maksuturva.fi" />
<input type="hidden" name="pmt_deliveryname" value="Teemu Testaaja" />
<input type="hidden" name="pmt_deliveryaddress" value="Ruoholahdenkatu 23" />
<input type="hidden" name="pmt_deliverypostalcode" value="00180" />
<input type="hidden" name="pmt_deliverycity" value="Helsinki" />
<input type="hidden" name="pmt_deliverycountry" value="FI" />
<input type="hidden" name="pmt_sellercosts" value="5,00" />
<input type="hidden" name="pmt_rows" value="4" />
<input type="hidden" name="pmt_row_name1" value="Tuote A" />
<input type="hidden" name="pmt_row_desc1" value="Tuotteen A kuvaus" />
<input type="hidden" name="pmt_row_quantity1" value="2" />
<input type="hidden" name="pmt_row_deliverydate1" value="15.10.2014" />
<input type="hidden" name="pmt_row_price_gross1" value="123,00" />
<!--<input type="hidden" name="pmt_row_price_net1" value="100,00" />--> <!-- netto vaihtoehtoinen brutolle-->
<input type="hidden" name="pmt_row_vat1" value="23,00" />
<input type="hidden" name="pmt_row_discountpercentage1" value="0,00" />
<input type="hidden" name="pmt_row_type1" value="1" />
<input type="hidden" name="pmt_row_name2" value="Räätälöity alennustuote B" />
<input type="hidden" name="pmt_row_desc2" value="Räätälöidyn alennustuotteen kuvaus" />
<input type="hidden" name="pmt_row_quantity2" value="1" />
<input type="hidden" name="pmt_row_deliverydate2" value="15.10.2014" />
<input type="hidden" name="pmt_row_price_gross2" value="369,00" />
<!--<input type="hidden" name="pmt_row_price_net2" value="300,00" />--> <!-- netto vaihtoehtoinen brutolle -->
<input type="hidden" name="pmt_row_vat2" value="23,00" />
<input type="hidden" name="pmt_row_discountpercentage2" value="10,00" />
<input type="hidden" name="pmt_row_type2" value="4" />
<input type="hidden" name="pmt_row_name3" value="Toimituskulut" />
<input type="hidden" name="pmt_row_desc3" value="Toimitustapa yms." />
<input type="hidden" name="pmt_row_quantity3" value="1" />
<input type="hidden" name="pmt_row_deliverydate3" value="15.10.2014" />
<input type="hidden" name="pmt_row_price_gross3" value="5,00" />
<!--<input type="hidden" name="pmt_row_price_net3" value="5,00" />--> <!-- netto vaihtoehtoinen brutolle -->
<input type="hidden" name="pmt_row_vat3" value="0,00" />
<input type="hidden" name="pmt_row_discountpercentage3" value="0,00" />
<input type="hidden" name="pmt_row_type3" value="2" />
<input type="hidden" name="pmt_row_name4" value="Alennus" />
<input type="hidden" name="pmt_row_desc4" value="Alennuskupongin koodi tms." />
<input type="hidden" name="pmt_row_quantity4" value="1" />
<input type="hidden" name="pmt_row_deliverydate4" value="15.10.2014" />
<input type="hidden" name="pmt_row_price_gross4" value="-10,00" />
<!--<input type="hidden" name="pmt_row_price_net4" value="-10,00" />--> <!-- netto vaihtoehtoinen brutolle -->
<input type="hidden" name="pmt_row_vat4" value="0,00" />
<input type="hidden" name="pmt_row_discountpercentage4" value="0,00" />
<input type="hidden" name="pmt_row_type4" value="6" />
<input type="hidden" name="pmt_charset" value="ISO-8859-15" />
<input type="hidden" name="pmt_charsethttp" value="ISO-8859-15" />
<input type="hidden" name="pmt_hashversion" value="SHA-1" />
<input type="hidden" name="pmt_hash" value="D26B59EAD06ED6E44E0B279B61C4894DEEE85A8B" />
<input type="hidden" name="pmt_keygeneration" value="1" />
</form>Â
OK Response examples (HTTP 302)
Please notice that these are both single URLs that have been split into multiple lines per querystring parameter.
http://www.mytestshop.fi/pay/return/Success.do
?pmt_action=NEW_PAYMENT_EXTENDED
&pmt_version=0004
&pmt_id=1998524_1
&pmt_reference=00000000000019985242
&pmt_amount=568,10
&pmt_currency=EUR
&pmt_sellercosts=5,00
&pmt_escrow=Y
&pmt_hash=F7C0E8A3F5F5FEDDC2B945F0246DE5FD27B9206B
&pmt_paymentmethod=FI01Â
Â
CANCEL Response examples (HTTP 302)
ERROR Response examples (HTTP 302)
Â
If Svea Payments payment method selection page has been skipped, in some cases the names of erroneous input parameters are appended to the return URLs: