Delivery information can added by sending the delivery method and tracking code(s) in a <form> using POST method as hidden input fields (<input type=hidden>) to address https://www.maksuturva.fi/addDeliveryInfo.pmt (or https://test1.maksuturva.fi/addDeliveryInfo.pmt in testing environment).

Fieldinput namevalueFormatC/ODescription
Message versionpkg_version0002AN4CVersion of the API request and response contents.
Seller IDpkg_selleridAN15CSeller ID given to the webstore by Svea Payments. Technical interface user id.
Payment IDpkg_idAN20C
Delivery method codepkg_deliverymethodidAN5CDelivery method code. For available id values, see section Delivery Method code values
Delivery info to be addedpkg_adddeliveryinfoAN50CDelivery info or tracking code(s) to be added to this order.
Flag telling if all delivery info has been givenpkg_allsentY/NAN1CWhen submitting the last delivery info regarding an order, set this to “Y”. Otherwise the order might never be settled to webstore because Svea Payments waits for more delivery info.
Force updatepkg_forceupdateY/NAN1ONormally add, update or remove do nothing to an order, that has already received data with ”All delivery info has been given” flag set as ”Y”. Setting force to “Y” overrides this.
Reponse typepkg_resptypeXML/HTMLAN4ODetermines whether the response is
a) a XML document returned as HTTP response
b) a HTML page
Return address (URL)pkg_returnAN200OIn case of HTML response and if webstore has given a return address, the response is automatically (if Javascript enabled) sent as HTML FORM using GET method response with the response parameters appended as querystring to the return URL.
Hash algorithmpkg_hashversionAN10CName of the algorithm used to calculate the hash. For more details, see section Hash Calculation.
Hashpkg_hashAN128CHash calculated from predefined message fields and the webstore's secret key. The following fields are used to calculate the hash:
pkg_id
pkg_deliverymethodid
* pkg_allsent
Secret key generationpkg_keygenerationN3CGeneration number of the secret key given to the seller by Svea Payments.
Default is 001

📘

info

The note ANxx means that the field contains a maximum of xx alphanumeric characters. N means numeric. C means that the field is compulsory and O means it is optional.

Language
Click Try It! to start a request and see the response here!