- Created by Aleksi Ahonen , last modified on Oct 07, 2021
You are viewing an old version of this page. View the current version.
Compare with Current View Page History
« Previous Version 14 Current »
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