This documentation is deprecated and only available for supporting old/legacy integrations using for example hashes.">This documentation is deprecated and only available for supporting old/legacy integrations using for example hashes.

New documentation can be found here: [DOCS:Home]">New documentation can be found here: [DOCS:Home]



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 2 Next »

Field

Input name

Value

Format

C/O

Description

Action code

pmt_action

NEW_PAYMENT_EXTENDED

AN50

C

NEW_PAYMENT_EXTENDED

Message version

pmt_version

0004

AN4

C

Version of interface content. Same as in the input message.

Payment ID

pmt_id

AN20

C

Unique Identifying number given to the transaction by the webstore. Same as in the input message.

Reference number

pmt_reference

N20

C

Reference number given by the webstore and used when the order is settled to the seller. The reference number is in its technical format, i.e. with leading zeros, without spaces and with total length of 20 digits. The response hash is calculated with the reference number in this format. Same as in the input message.

Sum of products and services of the order

pmt_amount

AN17

C

The total gross sum of row types 1, 4, 5 and 6.
If the order does not contain any postal or handling cost rows (types 2 and 3), then this is the total amount of the order.
The amount is presented with two decimals. The decimal delimiter is a comma, e.g. 94,80

Payment currency

pmt_currency

EUR

AN3

C

Currency of the payment. Always EUR.

Sum of handling and delivery costs of the order

pmt_sellercosts

N17

C

The total gross sum of row types 2 and 3.
The amount must be presented with two decimals. The decimal delimiter is a comma, e.g. 7,40

Payment method

pmt_paymentmethod

AN4

C

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).

Escrow is being used

pmt_escrow

Y/N

AN1

C

Tells whether escrow option is used with this payment. Values: Y/N
The value is always Y for Satisfaction Guarantee payment services (e.g. Maksuturva Gold). Correspondingly, the value is always N for Direct payment services (e.g. eMaksut).

Hash

pmt_hash

AN128

C

Hash calculated from predefined message fields and the webstore's secret key. The following fields are used to calculate the hash:

  • pmt_action

  • pmt_version

  • pmt_id

  • pmt_reference

  • pmt_amount

  • pmt_currency

  • pmt_sellercosts

  • pmt_paymentmethod

  • pmt_escrow

For more details, see section Hash Calculation.

Hash must be calculated from the data in response and that hash must be compared with the pmt_hash field of the response. Calculated value may not differ from the one in response. The hash algorithm used for the response hash is THE SAME as was used for the corresponding payment request.

If the checks above are successful, the response can be handled as a valid one.

Payment Method Codes

Code

Description (in Finnish)

FI01

Nordea E-maksu

FI02

Danske Bank Verkkomaksu

FI03

Aktia verkkomaksu

FI04

POP Pankin verkkomaksu

FI05

Tapiola Pankki Verkkomaksu

FI06

Osuuspankki Verkkomaksu

FI07

Ålandsbanken E-maksu

FI08

Säästöpankin verkkomaksu

FI09

Handelsbanken Verkkomaksu

FI10

S-pankki Verkkomaksu

FI11

Oma Säästöpankin verkkomaksu

FI50

Korttimaksu (Visa, Visa Electron, MasterCard)

FI51

Korttimaksu

FI52

American Express

FI53

Diners Club

FI54

MobilePay

FI55

Masterpass

FI60

Maksuturva Lasku

FI61

Maksuturva Erämaksu

FI70

SveaWebPay Lasku

FI71

SveaWebPay Osamaksu

FI72

Yrityslasku

USPP

PayPal

RBIP

Resurs Bank Lasku/Erämaksu

RBIN

Resurs Bank Lasku

RBPP

Resurs Bank Osamaksu

RBCD

Resurs Bank Kortti / Tili

RBRC

Resurs Bank Uusi kortti / tili

PLDP

Dotpay

EEMK

Maksekeskus

PIVO

Pivo

PVCD

Pivo (korttimaksu) - Important! Do not use when creating a new payment!

PVCT

Pivo (tilisiirto) - Important! Do not use when creating a new payment!

SIIR

Siirto

  • No labels