post https://test1.maksuturva.fi/updateDeliveryInfo.pmt
Delivery information can updated 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/updateDeliveryInfo.pmt (or https://test1.maksuturva.fi/updateDeliveryInfo.pmt in testing environment).
| Field | input name | value | Format | C/O | Description |
|---|---|---|---|---|---|
| Message version | pkg_version | 0002 | AN4 | C | Version of the API request and response contents. |
| Seller ID | pkg_sellerid | AN15 | C | Seller ID given to the webstore by Svea Payments. Technical interface user id. | |
| Payment ID | pkg_id | AN20 | C | ||
| Delivery method code | pkg_deliverymethodid | AN5 | C | Delivery method code. For available id values, see section Delivery Method code values | |
| Delivery info to be added | pkg_adddeliveryinfo | AN50 | C | Delivery info or tracking code(s) to be added to this order. | |
| Delivery info to be removed | pkg_remdeliveryinfo | AN50 | C | Delivery info or tracking code(s), that was earlier submitted and now needs to be removed using update or delete API. | |
| Flag telling if all delivery info has been given | pkg_allsent | Y/N | AN1 | C | When 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 update | pkg_forceupdate | Y/N | AN1 | O | Normally 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 type | pkg_resptype | XML/HTML | AN4 | O | Determines whether the response is a) a XML document returned as HTTP response b) a HTML page |
| Return address (URL) | pkg_return | AN200 | O | In 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 algorithm | pkg_hashversion | AN10 | C | Name of the algorithm used to calculate the hash. For more details, see section Hash Calculation. | |
| Hash | pkg_hash | AN128 | C | Hash 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 generation | pkg_keygeneration | N3 | C | Generation 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.