API Reference
Start typing to search…

Charge with token

post https://test1.maksuturva.fi/NewChargeWithTokenActionExtended.pmt
Log in to see full request history

Possible Error Codes

CodeExplanation
ALREADY_PAIDOrder has already been paid
ERRORUnknown error
ERROR_CARD_AUTHENTICATION_FAILED3DS authentication of card payment failed
ERROR_CARD_AUTHORIZATION_FAILEDAuthorization of card payment failed
ERROR_CARD_AUTHORIZATION_TIMEOUTAuthorization or charging of card payment timed out
ERROR_CARD_TOKENIZATION_FAILEDCard can not be used for recurring payments
ERROR_IN_PAYMENTError in processing of payment
ERROR_IN_REQUEST_PAYER_DATAError(s) in information that can be edited by buyer
ERROR_IN_REQUEST_TECHNICAL_DATAError(s) in the technical data of the payment
ERROR_PAYMENT_INSTRUMENT_EXPIREDThe payment instrument is not valid
ERROR_PAYMENT_INSTRUMENT_LIMIT_EXCEEDEDThe limit for the given payment instrument is exceeded
ERROR_PAYMENT_INSTRUMENT_NOT_FOUNDThe given payment instrument can not be found
ERROR_PAYMENT_METHOD_NOT_AVAILABLEThe payment method chosen in the web store was not allowed
EXTERNAL_SERVICE_DENIEDThe chosen payment service denied the transaction
EXTERNAL_SERVICE_ERRORThe chosen payment service gave an error response
NOT_FOUNDOrder can not be found
PAYER_CHOSE_METHOD_AND_VANISHEDPayer chose a payment method but has not paid
PAYER_INTERRUPTEDPayer cancelled the payment and returned to the web store
PAYER_VANISHEDPayer vanished without paying
WAITINGWaiting for information on possible payment
Form Data
string
required

NEW_PAYMENT_EXTENDED

string
required

Version of interface content

string
required

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

string
required

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

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.

string
required

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

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

string
required

Currency used for the payment. Always EUR.

string
required

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

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.

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.

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

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

string
required

Currently always N.

string

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

string
required

Name of buyer (billing)

string
required

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

string
required

Postal code of buyer (billing)

string
required

City of buyer (billing)

string
required

Country code of buyer (billing)

string
required

Name of recipient

string
required

Address of recipient

string
required

Postal code of recipient

string
required

City of recipient

string
required

Country code of recipient

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

string
required

Webstores previously saved token

string
required

Name of this order row Max length: 40 characters

string
required

Detailed description of this order row

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

string
required

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

string

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

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

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

float
required

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

float
required

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

int32
required

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

int32
required

The count or number of order rows as an integer.

string
required

webstoer secret key generation

string
required

Name of the algorithm used to calculate the hash.

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.

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.

string
required

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

string
required

Sellers bank accounts iban

string
required

Hash calculated from fields sent with request.

string
required

Email address of buyer

Response

Updated about 7 years ago

Language
Request
Click Try It! to start a request and see the response here! Or choose an example:
application/xml

Updated about 7 years ago