token_english_DOC_V2

User manual

Tranzila Token

system

Solution by TM

Tranzila

For additional details: 073-2224444

InterSpace Ltd Yad Haruzim 19 P.O.B 8723 new industrial zone, Netanya, Israel Tel: 073-2224444 Fax: 073-2224440
www.Tranzila.com www.interspace.net www.internic.co.il
www.datacenter.co.il
All rights reserved InterSpace LTD

1

Dear client,

According to credit companies directives, it is prohibited to save credit card numbers
by suppliers who have not received an explicit authorization to do so by the credit
companies.

For this purpose, we have developed a solution named Tranzila Token that allows
saving a credit card number for later use.

General information about how the system works:
The Tranzlia Token works according to the following process:

1. Your client enters the credit card number in the clearing page that has a PCI
security standard authorization, such as the redirect page of Tranzila's Iframe.

2. The clearing page transfers the data to Tranzila's servers where the credit card
number is converted to a random 19 character string that cannot be
deciphered back to the original credit card number (excluding the last 4 digits
that are saved).

3. Tranzila's servers return the string to the success page or any other
destination URL defined.

 An existing precondition is defining a transaction password, this action is
done while setting up the terminal or defining the password by a detailed
request via email.
The request must be sent to the address [email protected]

Receiving a Tranzila token:
There are 2 ways to make this action:

1. Client reference to the Tranzila direct or Iframe page for entering the credit
card number with one of the following variable arrays:
 tranmode=K for receiving a Token without a sum or active debit.
 tranmode=VK for receiving a Token that passed a verification
transaction (J5) with the sent sum.
 tranmode=AK for a regular debit transaction and token creation
For the values AK and VK, a Token will be received only if the
transaction was passed successfully.
It is possible to use the hidesum=1 parameter to hide the sum only
when using tranmode=K or tranmode=VK.

InterSpace Ltd Yad Haruzim 19 P.O.B 8723 new industrial zone, Netanya, Israel Tel: 073-2224444 Fax: 073-2224440
www.Tranzila.com www.interspace.net www.internic.co.il
www.datacenter.co.il
All rights reserved InterSpace LTD

2

An example of using our Iframe to receive a token without a transaction:

https://direct.tranzila.com/Terminal_Name/iframe.php?hidesum=1&
currency=1&tranmode=K

An example of using our Iframe to receive a token with verification only
transaction(J5):

https://direct.tranzila.com/Terminal_Name/iframe.php?hidesum=1&currenc
y=1&tranmode=VK

2. If the credit details are entered on a different form the following variables
(next table) must be transferred to the URL:
https://secure5.tranzila.com/cgi-bin/tranzila31pan.cgi
In addition, a special parameter named TranzilaPW must be transferred. This
parameter is designed to prevent system abuse.

(Custom Payment Gateway should meet PCI DSS standards)

 Attention- the TranzilaPW parameter mustn’t be transferred while
issuing a token through redirect/Iframe clearing page

Names of required parameter to transfer (case sensitive)

Terminal name supplier

Transactions password TranzilaPW

Credit card number ccno

An example of sending a request to generate token in API:

https://secure5.tranzila.com/cgi-
bin/tranzila31pan.cgi?supplier=Terminal_Name&ccno=12345678&
TranzilaPW=Your_TranzilaPW

 Attention- This action will only return a token and won't produce a
transaction

InterSpace Ltd Yad Haruzim 19 P.O.B 8723 new industrial zone, Netanya, Israel Tel: 073-2224444 Fax: 073-2224440
www.Tranzila.com www.interspace.net www.internic.co.il
www.datacenter.co.il
All rights reserved InterSpace LTD

3

Using the Tranzila token:

1. In order to charge clients using the token (the parameter name is
TranzilaTK) that represents the client's credit card, it is necessary to
send the transaction string via POST to the address:
https://secure5.tranzila.com/cgi-bin/tranzila31tk.cgi
 An example for charging with a token:
https://secure5.tranzila.com/cgi-
bin/tranzila31tk.cgi?supplier=TERMINAL_Name&sum=10&
currency=1&expdate=0114&TranzilaPW=Your_tranzilaPW&
TranzilaTK=Token&tranmode=A

2. In addition, a special parameter named TranzilaPW must be transferred. This
parameter is designed to prevent system abuse.

3. The Tranzila system will return the credit company response whether
the transaction passed or failed.

Names of required parameter to transfer (case sensitive)

Terminal name supplier

Sum to charge sum

Card expiration date (represented using 4 digits) expdate

Currency type (a list of values is available in the currency
terminal in setting 2 part 2)

Transactions password (defined at terminal setup) TranzilaPW

A random string that represents the client's credit TranzilaTK
card number

Names of parameter to transfer by demand cred_type
Charge type (regular/payments a list of values is

InterSpace Ltd Yad Haruzim 19 P.O.B 8723 new industrial zone, Netanya, Israel Tel: 073-2224444 Fax: 073-2224440
www.Tranzila.com www.interspace.net www.internic.co.il
www.datacenter.co.il
All rights reserved InterSpace LTD

4

available in the terminal in setting 2 part 2

The 3 digits at the back of the credit card mycvv

I.D number myid

Sum of 1st payment fpay

Sum of following payment spay

Number of payment minus 1 npay

Transaction type (V=verification/F=forced/C=credit) tranmode

For a credit transaction a credit transaction index C1234
number must be noted

For a credit transaction it is necessary to also send authnr
the authorization number (the value will be returned
to you in Tranzila's ConfirmationCode parameter)

An example for credit with a token:

https://secure5.tranzila.com/cgi-bin/tranzila31tk.cgi?supplier=
TERMINAL_Name

&sum=1&currency=1&TranzilaTK=xf5d6835a0529cb2312&expdat
e=0114&TranzilaPW= Your_tranzilaPW
&tranmode=C12&authnr=0000000

In addition, it is possible to send, at your choosing, additional variable that will
be recorded in the terminal according to setting 2 part 3.

InterSpace Ltd Yad Haruzim 19 P.O.B 8723 new industrial zone, Netanya, Israel Tel: 073-2224444 Fax: 073-2224440
www.Tranzila.com www.interspace.net www.internic.co.il
www.datacenter.co.il
All rights reserved InterSpace LTD

5