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

New documentation can be found here: [DOCS:Home]">New documentation can be found here: [DOCS:Home]



Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 13 Next »

Skip to contents in this page

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

<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

<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.

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 choosing 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
  • No labels

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

New documentation can be found here: [DOCS:Home]">New documentation can be found here: [DOCS:Home]