Request and Response

Request (S2S HTTP POST)

Payment status query is possible as soon as the payment has been successfully received and saved by Svea Payments.

Web store delivers the query parameters in a <form> using POST method as hidden input fields (<input type=hidden>) to address https://www.maksuturva.fi/PaymentStatusQuery.pmt (or https://test1.maksuturva.fi/PaymentStatusQuery.pmt in testing environment).

 

Input name

Value

Format

C/O

Description

Input name

Value

Format

C/O

Description

pmtq_action

PAYMENT_STATUS_QUERY

AN50

C

Action name. Always PAYMENT_STATUS_QUERY.

pmtq_version

0006

AN4

C

Version of the interface content or message

pmtq_sellerid

 

AN15

C

Technical seller id given to the webstore by Svea Payments.

pmtq_id

 

AN20

C

Unique Payment Identifier given to the payment transaction by the webstore.

pmtq_resptype

XML

AN4

C

Response content type. Currently only XML is supported.

pmtq_keygeneration

nnn
e.g. 001

N3

C

Secret key generation or version related to the technical seller id.
Default or initial value is 001.

Response (XML)

The character encoding of response message (XML) is UTF-8.

Please note:

  • We will be adding new parameters to the API response version 0006 without increasing the version number. A new version shall be introduced only if we remove or change enumerated values of existing parameters.

 

Input name

Value

Format

C/O

Description

Input name

Value

Format

C/O

Description

pmtq_action

PAYMENT_STATUS_QUERY

AN50

C

Action name. Always PAYMENT_STATUS_QUERY.

pmtq_version

0006

AN4

C

Version of the interface content or message

pmtq_sellerid

 

AN15

C

Technical seller id given to the webstore by Svea Payments.

pmtq_id

 

AN20

C

Unique Payment Identifier given to the payment transaction by the webstore.

pmtq_orderid

 

AN50

C

The order id the payment was created with.

pmtq_amount

nnnnn,nn
e.g. 50,00 or 12500,90

AN17

C

The total sum of products and services of the order.
If the order does not contain any postal or handling costs, then this is the total amount of the order.
The amount must be presented with two decimals. The decimal delimiter is a comma, e.g. 94,80

pmtq_returncode

 

N2

C

Response code that indicates success or failure. Values and explanations of all the codes can be found at section Payment and Delivery status code values.

pmtq_returntext

 

AN100

O

Brief description of the response code.

pmtq_trackingcodes

 

AN400

C

Tracking codes or information of untraceable deliveries submitted to Svea Payments system regarding this payment. Format [XX|XY|YY] 0-n times depending on the count of submitted tracking codes or information of untraceable deliveries.
XX = Delivery type code
XY = Tracking code, or the submitted text in case of untraceable delivery
YY = Delivery status,
See sections Delivery Information Management | Delivery Method codes and Payment and Delivery status code values

pmtq_sellercosts

nnnnn,nn
e.g. 10,00 or 1024,90

AN17

O

The total sum of delivery and handling costs of the order.
The amount must be presented with two decimals. The decimal delimiter is a comma, e.g. 7,40

pmtq_invoicingfee

 

AN17

O

Only available when the payer chose a payment method that has invoicing fee associated to it. The amount is presented with two decimals. The decimal delimiter is a comma, e.g. 7,40

pmtq_paymentmethod

 

AN4

O

Indicates what payment method the buyer chose. For available codes, see section Payment Method Codes.

Important! Please do not use the values of the table above in production. Instead, retrieve official payment method codes and names using GetPaymentMethods.pmt API (see chapter Retrieve Available Payment Methods).

pmtq_escrow

Y or N

AN1

O

Tells whether escrow option is used with this payment.

pmtq_certification

Y or N

A1

O

Verification info
Y = The payment has been verified. That is, the payer’s identity has been confirmed somehow. In case of Invoice and Part Payment payment methods, Svea Payments has information about the payer’s identity which is not the case with other payment methods.
N = The payment has not been verified, or there is no verification information available.

pmtq_externalcode1

 

AN50

O

Payment service response code 1

Informal/additional payment service response information received from the external payment service provider in error situations.

In case of Nets (formerly known as Luottokunta), the LKPRC code.

In OK cases this could contain for example external payment service provider’s archive code of the payment.

pmtq_externalcode2

 

AN50

O

Payment service response code 2

Informal/additional payment service response information received from the external payment service provider in error situations.

In case of Nets (formerly known as Luottokunta), the LKSRC code.

In OK cases this could contain for example external payment service provider’s archive code of the payment.

pmtq_externaltext

 

AN200

O

Payment service response text

Informal/additional payment service response information received from the external payment service provider.

Contains either information about successful payment or an error.

If the external payment service provider does not provide this response information, this is either empty or it could contain for example external payment service provider’s archive code or some other unique id of the payment.

pmtq_paymentstarttimestamp

dd.MM.yyyy hh:mm:ss

AN19

O

Time when the buyer began the payment process

pmtq_paymentdate

dd.MM.yyyy

AN10

O

The date when payer paid. Or if it’s not available, the date when the money was found from Svea Payments Customer Assets bank account statement.

pmtq_amountrefunded

nnnnn,nn

e.g. 20,00

AN17

C

The amount refunded or confirmed to be refunded to the payer.

The amount remaining that could still be refunded by new refund calls is normally: pmtq_amount + pmtq_sellercosts - pmtq_amountrefunded

pmtq_payeriban

IBAN bank account number

AN34

O

The IBAN bank account number of the payer, if available.

Currently IBAN will be added to the response only for Open Banking payments, when the customer using our payment service is also an authorised payment institution.

Svea Payments Oy
info.payments@svea.fi
+358 9 4241 7050 (weekdays 8:00 - 16:00)
Saavutettavuusseloste