Skip to content

Run an EMV device transaction

posthttps://secure5.tranzila.com/cgi-bin/tranzila71mdl.cgi

Runs a transaction on a cloud-connected EMV device. The transaction type is determined by the combination of tranmode and cred_type:

  • Regular charge: tranmode=A, cred_type=1
  • Installments: tranmode=A, cred_type=8 (also send npay, fpay, spay)
  • Credit installments: tranmode=A, cred_type=6 (also send npay, fpay, spay; minimum 3 installments, customer must hold credit authorization from their card issuer)
  • Refund: tranmode=C, cred_type=1

Refunds are usually performed through the My Tranzila site. A refund through the device is used to credit a customer when the credit is not based on a parent transaction.

Request

Body

application/json
supplierstringrequired

Terminal name.

Example:terminal_name
pos_idstringrequired

Device cloud ID, mapped to each device in 5Admin.

Example:014
sumstringrequired

Amount to charge (refund amount when `tranmode=C`), in ILS.

Example:2
currencystringrequired

ISO 4217 numeric currency code. ILS only.

Allowed value:376
Example:376
tranmodestringrequired

Transaction type. - `A` - Charge - `C` - Refund (Credit)

Allowed values:AC
Example:A
cred_typestringrequired

Credit type. - `1` - Regular (one payment) - `6` - Credit installments - `8` - Installments

Allowed values:168
Example:1
npaystring

Number of installments minus one (for 3 installments send `2`). Required when `cred_type=8` or `cred_type=6`.

Example:2
fpaystring

First payment amount. Required when `cred_type=8` or `cred_type=6`.

Example:100
spaystring

Amount of each payment after the first. Required when `cred_type=8` or `cred_type=6`.

Example:100
uniqueidstring

Your application identifier (for example a Navision payment ID or a Priority ID).

Example:3467654
companystring

Company name.

Example:bigmama
contactstring

Contact name.

Emailstring

Email address.

Responses

The request was received. Inspect transaction_result.statusCode to determine the transaction outcome (0 = approved, negative = declined/rejected).

Response body

response.json
JSON
1{
2  "index": "599",
3  "original_request": {
4    "cred_type": "1",
5    "currency": "376",
6    "supplier": "terminal_name",
7    "uniqueid": "567567567",
8    "tranmode": "A",
9    "sum": "2",
10    "pos_id": "014"
11  },
12  "status": 0,
13  "transaction_result": {
14    "cardNumber": "card_number",
15    "payments": 0,
16    "solek": 6,
17    "sysTraceNumber": "01014003",
18    "creditPayments": 0,
19    "customerReceipt": [
20      {
21        "fieldName": "תאריך",
22        "fieldValue": "03/06/20 07:42"
23      },
24      {
25        "fieldName": "מספר מסוף",
26        "fieldValue": "1111111"
27      },
28      {
29        "fieldName": "גרסת תוכנה",
30        "fieldValue": "01.08.72"
31      },
32      {
33        "fieldName": "מספר עסק",
34        "fieldValue": "0300012"
35      },
36      {
37        "fieldName": "כרטיס",
38        "fieldValue": "MAX "
39      },
40      {
41        "fieldName": "מספר",
42        "fieldValue": "1111"
43      },
44      {
45        "fieldName": "מספר שובר",
46        "fieldValue": "01014003"
47      },
48      {
49        "fieldName": "UID",
50        "fieldValue": "20060307421508895650092"
51      },
52      {
53        "fieldName": "RRN",
54        "fieldValue": "015500020844"
55      },
56      {
57        "fieldName": "סוג עסקה",
58        "fieldValue": "חובה"
59      },
60      {
61        "fieldName": "מספר אישור",
62        "fieldValue": " 044500"
63      },
64      {
65        "fieldName": "גורם מאשר",
66        "fieldValue": "חברה"
67      },
68      {
69        "fieldName": "אופן ביצוע",
70        "fieldValue": "חכם"
71      },
72      {
73        "fieldName": "זיהוי יישום בשבב",
74        "fieldValue": "A0000000031010"
75      },
76      {
77        "fieldName": "סוג אשראי",
78        "fieldValue": "רגיל"
79      },
80      {
81        "fieldName": "סכום עסקה",
82        "fieldValue": "2.00 שח"
83      },
84      {
85        "fieldName": "",
86        "fieldValue": "Verified by PIN"
87      }
88    ],
89    "cardName": "MAX ",
90    "rrn": "015500020844",
91    "ipayAmount": 0,
92    "statusCode": 0,
93    "currency": "376",
94    "creditTerms": 1,
95    "firstPaymentAmount": 0,
96    "manpik": 6,
97    "expDate": "2303",
98    "moadonNumber": "",
99    "authCodeSolek": 0,
100    "uid": "20060307421508895650092",
101    "acquirerMerchantID": "300012",
102    "authCodeManpik": 1,
103    "tranType": 1,
104    "issuerAuthNum": " 044500",
105    "amount": 200,
106    "gatewayToken": "",
107    "statusMessage": "עסקה אושרה",
108    "mutag": 2,
109    "paymentIndex": 0,
110    "posEntryMode": 40,
111    "tranCode": 1,
112    "otherPaymentAmount": 0
113  },
114  "error": null,
115  "token": "kcdf58ed655c9431892"
116}
117
Was this page helpful?