API Reference
Start typing to search…

Make new Payment request

post https://test1.maksuturva.fi/NewPaymentExtended.pmt
Log in to see full request history
Query Params
string
required
length between 4 and 50

Action code

string
required
length between 4 and 4

Message version

string
required
length ≤ 15

Seller ID

string
required
length ≤ 20

Unique Payment ID

string
required
length ≤ 50

Order id

string
required
length between 4 and 20

Payment reference number

date
required
length between 10 and 10

Payment due date

string
length between 5 and 5

Buyer's (user's) locale

number
required

Sum of products and services of the order

string
required
length between 3 and 3

Payment currency

string
required
length ≤ 200

Ok return address (URL)

string
required
length ≤ 200

Error return address (URL)

string
required
length ≤ 200

Cancel return address (URL)

string
required
length ≤ 200

Delayed payment return address (URL)

string
required
length between 1 and 1

Escrow in use. Satisfaction Guarantee payment service = Y Direct payment service = N

string
required
length between 1 and 1

Escrow option changeable by buyer

string
length between 1 and 1

Will webstore sends an invoice to the payer

string
length between 4 and 4

Payment method pre-chosen in webstore

string
length between 9 and 11

Buyer’s social security number or company’s business identification code

string
required
length ≤ 100

Buyer's name

string
required
length ≤ 100

Buyer's billing address

string
required
length ≤ 20

Buyer's postal code

string
required
length ≤ 100

Buyer's city

string
required
length ≤ 2

Buyer's country code

number

Buyer's phone number

string
length ≤ 100

Buyer's email address

string
required
length ≤ 100

Delivery recipient's name

string
required
length ≤ 100

Delivery recipient's address

number
required

Delivery recipient's postal code

string
required
length between 4 and 100

Delivery recipient's city

string
required
length ≤ 2

Delivery recipient's country code

number
required

Sum of handling and delivery costs of the order

number

Marketplace commission amount (not in use in most cases)

string
length between 4 and 20

Marketplace commission reference number (not in use in most cases)

number
required

Order row count (number of order rows)

string
required
length between 1 and 40

Order row name

string
required
length between 1 and 1000

Order row description

number
required

Order row quantity. 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
length between 1 and 100

Order row article or product number

string
length between 1 and 3

Order row unit of quantity

date
required
length between 10 and 10

Order row delivery date of package or service

number

Order row gross unit price (VAT included)

number

Order row net unit price (VAT excluded)

number
required

Order row VAT percentage

number
required

Order row Discount percentage

number
required

Order row type 1 = product 2 = postal cost 3 = handling cost 4 = customized product (not eligible for returns) 5 = service 6 = discount

string
required
length ≤ 15

Hash calculation character encoding. ISO-8859-1, ISO-8859-15, UTF-8

string
required
length ≤ 15

Character encoding of input data (and of webstore) ISO-8859-1, ISO-8859-15, UTF-8

string
required
length ≤ 10

Hash algorithm

string
required
length between 32 and 128

Hash

string
required
length ≤ 3

Secret key generation

Responses

400

bad input parameter

Updated over 5 years ago

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

Updated over 5 years ago