Payment Card Tokenization

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

Payment Card Tokenization

There are few things to remember in tokenization.

The field "pmt_amount" has to be zero and there has to be order rows in your request.
The amount of order rows has to match with the value pmt_rows.
You should use either pmt_row_price_net1 field or pmt_row_price_gross1 field. NOT BOTH

Hash generation

Fields included in hash
pmt_action
pmt_version
pmt_id
pmt_orderid
pmt_reference
pmt_duedate
pmt_amount
pmt_currency
pmt_okreturn
pmt_errorreturn
pmt_cancelreturn
pmt_delayedpayreturn
pmt_escrow
pmt_escrowchangeallowed
pmt_paymentmethod
pmt_buyername
pmt_buyeraddress
pmt_buyerpostalcode
pmt_buyercity
pmt_buyercountry
pmt_deliveryname
pmt_deliveryaddress
pmt_deliverypostalcode
pmt_deliverycity
pmt_deliverycountry
pmt_sellercosts
pmt_row_name1
pmt_row_desc1
pmt_row_quantity1
pmt_row_deliverydate1
pmt_row_price_net1
pmt_row_vat1
pmt_row_discountpercentage1
pmt_row_type1

For more information about hash generation check this page Hash Generation .

Form Data

pmt_action

string

required

pmt_version

string

required

pmt_id

string

required

pmt_orderid

string

required

pmt_reference

string

required

pmt_duedate

string

required

pmt_amount

float

required

pmt_currency

string

required

pmt_okreturn

string

required

pmt_errorreturn

string

required

pmt_cancelreturn

string

required

pmt_delayedpayreturn

string

required

pmt_escrow

string

required

pmt_escrowchangeallowed

string

required

pmt_paymentmethod

string

required

pmt_buyername

string

required

pmt_buyeraddress

string

required

pmt_buyerpostalcode

string

required

pmt_buyercity

string

required

pmt_buyercountry

string

required

pmt_deliveryname

string

required

pmt_deliveryaddress

string

required

pmt_deliverypostalcode

string

required

pmt_deliverycity

string

required

pmt_deliverycountry

string

required

pmt_sellercosts

float

required

pmt_row_nameN

string

required

pmt_row_descN

string

required

pmt_row_quantityN

int32

required

pmt_row_deliverydateN

string

required

pmt_row_price_netN

float

required

pmt_row_vatN

float

required

pmt_row_discountpercentageN

float

required

pmt_row_typeN

int32

required

pmt_rows

int32

required

pmt_keygeneration

string

required

pmt_hashversion

string

required

pmt_charset

string

required

pmt_charsethttp

string

required

pmt_sellerid

string

required

pmt_selleriban

string

required

pmt_hash

string

required

pmt_buyeremail

string

Response

Language

Request


xxxxxxxxxx
79
1
// Hardcoded example against TokenizeExtended.pmt endpoint.
2
import sha256 from 'crypto-js/sha256';
3
import Hex from 'crypto-js/enc-hex';
4
5
const baseUrl = "https://test1.maksuturva.fi/"
6
const method = "TokenizeExtended.pmt"
7
const valuesDictionary = [];
8
valuesDictionary.push({"pmt_action":"TOKENIZE"}); // Used in hash
9
valuesDictionary.push({"pmt_version":"4504"}); // Used in hash
10
  
11
valuesDictionary.push({"pmt_id": "EXAMPLEID123"}); // Used in hash
12
valuesDictionary.push({"pmt_orderid": "AASDABC123"}); // Used in hash
13
valuesDictionary.push({"pmt_reference":"1234567890120"}); // Used in hash
14
valuesDictionary.push({"pmt_duedate":"1.1.2010"}); // Used in hash
15
  
16
valuesDictionary.push({"pmt_amount":"0,00"}); // Used in hash
17
valuesDictionary.push({"pmt_currency":"EUR"}); // Used in hash
18
valuesDictionary.push({"pmt_okreturn":"http://test.com/OK"}); // Used in hash
19
valuesDictionary.push({"pmt_errorreturn":"http://test.com/ERROR"}); // Used in hash
20
valuesDictionary.push({"pmt_cancelreturn":"http://test.com/CANCEL"}); // Used in hash
21
valuesDictionary.push({"pmt_delayedpayreturn":"http://test.com/DELAYED"}); // Used in hash
22
23
valuesDictionary.push({"pmt_escrow":"Y"}); // Used in hash
24
valuesDictionary.push({"pmt_escrowchangeallowed":"N"}); // Used in hash
25
valuesDictionary.push({"pmt_paymentmethod":"FI50"}); // Used in hash
26
27
valuesDictionary.push({"pmt_buyername":"Teemu Testaaja"}); // Used in hash
28
valuesDictionary.push({"pmt_buyeraddress":"Atomitie 2 C"}); // Used in hash
29
valuesDictionary.push({"pmt_buyerpostalcode":"00370"}); // Used in hash

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

application/json

Payment Card Tokenization

Hash generation

302302