Update delivery information

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.

Response 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 query string 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

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.