/
New Payment
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: