/
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

Owned by Aleksi Ahonen
Last updated: Nov 17, 2021 by Viivi Ahlqvist
4 min read

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

 

http://www.mytestshop.fi/pay/return/Success.do?paid=1 &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=FFDFB9E0287706794232C4E34AF1FA11F7560288 &pmt_paymentmethod=FI60

 

CANCEL Response examples (HTTP 302)

http://www.mytestshop.fi/pay/return/Cancel.do?pmt_id=1998524_1 http://www.mytestshop.fi/pay/return/Cancel.do?paid=0&pmt_id=1998524_1

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:

http://www.mytestshop.fi/pay/return/Error.do?pmt_id=1998524_1 http://www.mytestshop.fi/pay/return/Error.do?paid=0&pmt_id=1998524_1

Invalid hash

http://www.mytestshop.fi/pay/return/Error.do?pmt_id=1998524_1&error_fields=[generic][pmt_hash]

Invalid buyer email

http://www.mytestshop.fi/pay/return/Error.do?pmt_id=1998524_1&error_fields=[model.pmt_buyeremail]

Invalid delivery address postal code

http://www.mytestshop.fi/pay/return/Error.do?pmt_id=1998524_1&error_fields=[model.pmt_deliverypostalcode]

Invalid buyer email, billing address postal code and delivery address postal code

http://www.mytestshop.fi/pay/return/Error.do?pmt_id=1998524_1\&error_fields=[model.pmt_buyeremail][model.pmt_buyerpostalcode][model.pmt_d

Related content

This documentation is deprecated and only available for supporting old/legacy integrations using for example hashes.

New documentation can be found here: Home