Charge with token

post https://test1.maksuturva.fi/NewChargeWithTokenActionExtended.pmt

time	status	user agent
Retrieving recent requests…

Loading…

Possible Error Codes

Code	Explanation
ALREADY_PAID	Order has already been paid
ERROR	Unknown error
ERROR_CARD_AUTHENTICATION_FAILED	3DS authentication of card payment failed
ERROR_CARD_AUTHORIZATION_FAILED	Authorization of card payment failed
ERROR_CARD_AUTHORIZATION_TIMEOUT	Authorization or charging of card payment timed out
ERROR_CARD_TOKENIZATION_FAILED	Card can not be used for recurring payments
ERROR_IN_PAYMENT	Error in processing of payment
ERROR_IN_REQUEST_PAYER_DATA	Error(s) in information that can be edited by buyer
ERROR_IN_REQUEST_TECHNICAL_DATA	Error(s) in the technical data of the payment
ERROR_PAYMENT_INSTRUMENT_EXPIRED	The payment instrument is not valid
ERROR_PAYMENT_INSTRUMENT_LIMIT_EXCEEDED	The limit for the given payment instrument is exceeded
ERROR_PAYMENT_INSTRUMENT_NOT_FOUND	The given payment instrument can not be found
ERROR_PAYMENT_METHOD_NOT_AVAILABLE	The payment method chosen in the web store was not allowed
EXTERNAL_SERVICE_DENIED	The chosen payment service denied the transaction
EXTERNAL_SERVICE_ERROR	The chosen payment service gave an error response
NOT_FOUND	Order can not be found
PAYER_CHOSE_METHOD_AND_VANISHED	Payer chose a payment method but has not paid
PAYER_INTERRUPTED	Payer cancelled the payment and returned to the web store
PAYER_VANISHED	Payer vanished without paying
WAITING	Waiting for information on possible payment

Form Data

pmt_action

string

required

NEW_PAYMENT_EXTENDED

pmt_version

string

required

Version of interface content

pmt_id

string

required

Identifier given to the payment transaction by the webstore. Must be unique

pmt_orderid

string

required

Identifier given to the order by the webstore. Order id should be known by the buyer.

pmt_reference

string

required

Reference number given by the webstore and used when compensating the seller. The reference number must comply with the guidelines for a formal reference number issued by the Federation of Finnish Financial Services (FK, http://www.fkl.fi). The reference number must be at least 4 digits, the last of which is a check digit.

pmt_duedate

string

required

A due date given to the payment by the webstore. Currently should be today.

pmt_amount

float

required

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 must be presented with two decimals. The decimal delimiter is a comma, e.g. 94,80

pmt_currency

string

required

Currency used for the payment. Always EUR.

pmt_okreturn

string

required

The url to which the buyer's browser will be directed to in case of confirmed payments (the order has been paid)

pmt_errorreturn

string

required

The error url to which the buyer's browser will be directed to if there is an error in the paying process. A querystring parameter Payment ID (pmt_id) is appended to this URL before redirection.

pmt_cancelreturn

string

required

The cancel url to which the buyer's browser will be directed to if the buyer interrupts the paying process. A querystring parameter Payment ID (pmt_id) is appended to this URL before redirection.

pmt_delayedpayreturn

string

required

The url to which the buyer's browser will be directed to if the user has confirmed using the credit transfer or giro payment method which means the payment has not yet been registered. A querystring parameter Payment ID (pmt_id) is appended to this URL before redirection. Credit transfer or giro is not supported nowadays in "of-the-shelf" payment services. This is why we suggest using same address for both cancel and delayed payment return address (pmt_delayedpayreturn ~= pmt_cancelreturn).

pmt_escrow

string

required

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

pmt_escrowchangeallowed

string

required

Currently always N.

pmt_paymentmethod

string

Payment method’s code, Please check the possible values from chapter TODOD

pmt_buyername

string

required

Name of buyer (billing)

pmt_buyeraddress

string

required

Address of buyer (billing). Street address or p.o. box

pmt_buyerpostalcode

string

required

Postal code of buyer (billing)

pmt_buyercity

string

required

City of buyer (billing)

pmt_buyercountry

string

required

Country code of buyer (billing)

pmt_deliveryname

string

required

Name of recipient

pmt_deliveryaddress

string

required

Address of recipient

pmt_deliverypostalcode

string

required

Postal code of recipient

pmt_deliverycity

string

required

City of recipient

pmt_deliverycountry

string

required

Country code of recipient

pmt_sellercosts

float

required

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

pmt_token

string

required

Webstores previously saved token

pmt_row_nameN

string

required

Name of this order row Max length: 40 characters

pmt_row_descN

string

required

Detailed description of this order row

pmt_row_quantityN

int32

required

The quantity of this order row. Preferably an integer value but also decimal number values with up to 2 decimal values are accepted. e.g. 1, 2 or 1,75

pmt_row_deliverydateN

string

required

Date in form dd.mm.yyyy – please set as current date, if there is no other logical value to use.

pmt_row_articlenrN

string

Article or product number of this order row. Optional information.

pmt_row_price_netN

float

Net unit price of product (VAT excluded). Either net or gross value must be supplied, but not both! For more details, see section Calculation Rules for Order Rows The amount must be presented with two decimals. The decimal delimiter is a comma, e.g. 94,80

pmt_row_price_grossN

float

Gross unit price of product (VAT included). Either net or gross value must be supplied, but not both! The total gross price of one order row is: row quantity * row gross unit price For more details, see section Calculation Rules for Order Rows The amount must be presented with two decimals. The decimal delimiter is a comma, e.g. 94,80

pmt_row_vatN

float

required

Decimal number with two decimal digits. The decimal delimiter is a comma. For example: 23,00 means ”23 %”

pmt_row_discountpercentageN

float

required

Decimal number with two decimal digits. The decimal delimiter is a comma. For example: 10,00 means ”10 %”

pmt_row_typeN

int32

required

1 = product 2 = postal cost 3 = handling cost 4 = customized product (not eligible for returns) 5 = service 6 = discount (always negative value)

pmt_rows

int32

required

The count or number of order rows as an integer.

pmt_keygeneration

string

required

webstoer secret key generation

pmt_hashversion

string

required

Name of the algorithm used to calculate the hash.

pmt_charset

string

required

This field tells the character set that has been used to calculate the hash value for input data. Legal values are for now: ISO-8859-1, ISO-8859-15 and UTF-8. Hash calculation is always done from binary data, which is not obvious in some programming languages. You must handle the transformation from character based data to binary data before hash calculation correctly. If it’s not possible to define the character set for hash calculation function, you must find out which character set is used internally by the hash algorithm.

pmt_charsethttp

string

required

This field tells the character encoding of the input data. The Maksuturva payment interface handles HTTP request parameters according to this character encoding. Practically this is the character set reported by the browser, when you’re browsing the checkout pages in the webstore.

pmt_sellerid

string

required

Technical user id given to the webstore by Maksuturva Group Oy.

pmt_selleriban

string

required

Sellers bank accounts iban

pmt_hash

string

required

Hash calculated from fields sent with request.

pmt_buyeremail

string

required

Email address of buyer

Response

Possible Error Codes

200200