Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Next »

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

pmtq_action

PAYMENT_STATUS_QUERY

AN50

C

Action name. Always PAYMENT_STATUS_QUERY.

pmtq_version

0005

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.

Input name

Value

Format

C/O

Description

pmtq_action

PAYMENT_STATUS_QUERY

AN50

C

Action name. Always PAYMENT_STATUS_QUERY.

pmtq_version

0005

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 https://sveapayments.atlassian.net/wiki/spaces/DOCS2022/pages/1657012843/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.

  • No labels