Create

posthttps://api.tranzila.com/v1/transaction/credit_card/create

3DS Process

3ds process

Step 1: Create Transaction

Initiate the transaction with the following API call. If the card is 3DS V2 supported the following scenarios are possible:

The transaction would be authorized automatically. The response would contain the transaction details including 3DS statuses and the flow is finished.
The card is not authorized. The flow is finished (in case the force_txn_on_3ds_fail = N. Otherwise a regular transaction will be issued and the result would be returned at this stage). force_challenge, In the case of a transaction being sent for 3D security verification, the credit card company may pass or fail the transaction frictionlessly; or, it may send the user a challenge form (generally an OTP sent via SMS) to verify his identity .By setting this parameter to 1, the user is more likely to be presented with a challenge form.
Initiate step 2 step 2 (issue a challenge).

Step 2: Client Browser

Open a browser. The URL would be challengeUrl value from step1. The response from the client challenge page would be redirected to the address was sent in step 1 request, uth_3ds_redirect object, url attribute.

Request

Body

application/json

terminal_nameterminalName

txn_curreny_codetypestring

Allowed values:debitcreditverifyforcecancelreversalsto

Example:debit

verfiy_modeinteger

Verify mode for txn_type “verify”

Allowed values:256

pan_entry_modestring

Allowed values:505152

Example:50

expire_monthinteger

Allowed values:123456789101112

Example:12

expire_yearinteger

Example:2025

cvvstring

Card Verification Value. Between 3 and 4 digits, can be null.

Example:111

card_holder_idstring

Example:25641832

card_numberstring

Example:4580458045804580

payment_planinteger

1 - regular, 6- credit, 8- instalments

Allowed values:168

Example:1

installments_numberinteger

Example:1

first_installment_amountnumber

Example:500

other_installments_amountnumber

Example:100

reference_txn_idinteger

Source transaction ID. The source transaction ID that the new transaction would be based on. Relevant for force, cancel, sto and some credit transactions.

Example:6769

authorization_numberstring

Authorization number from card issuer. Relevant for force transactions.

Example:125501

clientobject

itemsarray[object]

user_defined_fieldsarray[object]

remarksstring

Example:any transaction level remark

response_languagestring

Allowed values:englishhebrew

Example:english

created_by_userstring

Example:Draco Malfoy

created_by_systemstring

Example:mycrm

activate_3dsenum

Allowed values:YN

Example:N

3ds_settingsobject

Responses

The response can be 200 with an Application error code:

Error Code	Description
900	Transaction failed during 3D Secure validation
20111	Provided token check failure
20112	Original transaction not found
21100	Transaction index is not equal to original transaction index
21101	Provided index was empty
22101	Empty authorization number
22100	Authorization number is not equal to the transaction value
22103	Invalid DCdisable

Body

1{
2  "terminal_name": "myterminal",
3  "txn_curreny_codetype": "debit",
4  "verfiy_mode": 2,
5  "pan_entry_mode": 50,
6  "expire_month": 12,
7  "expire_year": 2025,
8  "cvv": 111,
9  "card_holder_id": 25641832,
10  "card_number": 4580458045804580,
11  "payment_plan": 1,
12  "installments_number": 1,
13  "first_installment_amount": 500,
14  "other_installments_amount": 100,
15  "reference_txn_id": 6769,
16  "authorization_number": 125501,
17  "client": {
18    "external_id": "C4589-5940-IL",
19    "name": "הוגוורטס",
20    "contact_person": "הארי פוטר",
21    "id": 5501291,
22    "email": "user@domain.com",
23    "phone_country_code": "972",
24    "phone_area_code": "050",
25    "phone_number": "2770335",
26    "address_line_1": "ברודצקי 33",
27    "address_line_2": "כניסה ב",
28    "city": "נתניה",
29    "country_code": "IL",
30    "zip": "4030160"
31  },
32  "items": [
33    {
34      "code": "A1234567",
35      "name": "שרביט קסמים",
36      "type": "I",
37      "unit_price": 10.53,
38      "unit_type": 1,
39      "price_type": "G",
40      "units_number": 4,
41      "currency_code": "ILS",
42      "to_txn_currency_exchange_rate": 2.5463,
43      "discount_type": "percent",
44      "discount": 15.5,
45      "vat_percent": 17,
46      "attributes": {
47        "language": "hebrew",
48        "name": "אורך",
49        "value": "17 ס\"מ"
50      }
51    }
52  ],
53  "user_defined_fields": [
54    {
55      "name": "origin_system",
56      "value": "mycrm"
57    }
58  ],
59  "remarks": "any transaction level remark",
60  "response_language": "english",
61  "created_by_user": "Draco Malfoy",
62  "created_by_system": "mycrm",
63  "activate_3ds": "Y",
64  "3ds_settings": {
65    "browser": {
66      "java_enabled": 0,
67      "language": "string",
68      "color_depth": 1,
69      "screen_height": 0,
70      "screen_width": 0,
71      "time_zone": 0,
72      "ip": "string",
73      "user_agent": "string",
74      "accept_header": "string",
75      "window_size": "04"
76    },
77    "force_txn_on_3ds_fail": "Y",
78    "force_challenge": 0,
79    "auth_3ds_redirect": [
80      {
81        "key": "string",
82        "value": "string"
83      }
84    ]
85  }
86}
87

Request Sample

curl --request POST \
  --url https://api.tranzila.com/v1/transaction/credit_card/create \
  --header 'Content-Type: application/json' \
  --data '{  "terminal_name": "myterminal",  "txn_curreny_codetype": "debit",  "verfiy_mode": 2,  "pan_entry_mode": 50,  "expire_month": 12,  "expire_year": 2025,  "cvv": 111,  "card_holder_id": 25641832,  "card_number": 4580458045804580,  "payment_plan": 1,  "installments_number": 1,  "first_installment_amount": 500,  "other_installments_amount": 100,  "reference_txn_id": 6769,  "authorization_number": 125501,  "client": {    "external_id": "C4589-5940-IL",    "name": "הוגוורטס",    "contact_person": "הארי פוטר",    "id": 5501291,    "email": "user@domain.com",    "phone_country_code": "972",    "phone_area_code": "050",    "phone_number": "2770335",    "address_line_1": "ברודצקי 33",    "address_line_2": "כניסה ב",    "city": "נתניה",    "country_code": "IL",    "zip": "4030160"  },  "items": [    {      "code": "A1234567",      "name": "שרביט קסמים",      "type": "I",      "unit_price": 10.53,      "unit_type": 1,      "price_type": "G",      "units_number": 4,      "currency_code": "ILS",      "to_txn_currency_exchange_rate": 2.5463,      "discount_type": "percent",      "discount": 15.5,      "vat_percent": 17,      "attributes": {        "language": "hebrew",        "name": "אורך",        "value": "17 ס\"מ"      }    }  ],  "user_defined_fields": [    {      "name": "origin_system",      "value": "mycrm"    }  ],  "remarks": "any transaction level remark",  "response_language": "english",  "created_by_user": "Draco Malfoy",  "created_by_system": "mycrm",  "activate_3ds": "Y",  "3ds_settings": {    "browser": {      "java_enabled": 0,      "language": "string",      "color_depth": 1,      "screen_height": 0,      "screen_width": 0,      "time_zone": 0,      "ip": "string",      "user_agent": "string",      "accept_header": "string",      "window_size": "04"    },    "force_txn_on_3ds_fail": "Y",    "force_challenge": 0,    "auth_3ds_redirect": [      {        "key": "string",        "value": "string"      }    ]  }}'