Versions Compared

Old Version 9

changes.mady.by.user Aleksi Ahonen

Saved on

compared with

New Version 10

changes.mady.by.user Aleksi Ahonen

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Request examples

Example 1:

  • Satisfaction Guarantee payment service (e.g. Maksuturva Gold)

  • Billing and Delivery address mismatch

  • Webstore return addresses do not contain querystring

  • Buyer will choose payment method in Svea Payments payment method choosing page

Code Block
languagejava
<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 (e.g. eMaksut)

  • Billing and Delivery address identical

  • Webstore return addresses contain querystring

  • Buyer has chosen payment method Svea Payments Invoice (FI60) in the webstore

Code Block
languagejava
<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 splitted in multiple lines per querystring parameter.

Code Block
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

Code Block
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)

Code Block
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 choosing page has been skipped, in some cases the names of erroneous input parameters are appended to the return URLs:

Code Block
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

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

Invalid buyer email

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

Invalid delivery address postal code

Code Block
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

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