Versions Compared

Old Version 1

changes.mady.by.user Aleksi Ahonen

Saved on

compared with

New Version 2

changes.mady.by.user Aleksi Ahonen

Saved on

Key

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

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)

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

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:

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