EMV iFrame Integration
The EMV iFrame is an extension of the standard iFrame Integration (new DirectNG) payment page. It adds the ability to charge a card through a physical EMV device (card present), alongside — or instead of — the standard online credit card fields, all within the same hosted Tranzila iframe.
When EMV mode is enabled, the iframe displays an additional selection field that lets the payer choose whether to pay with an online credit card or to capture the card on a connected EMV device.
This guide describes only the parameters and behavior that are specific to the EMV iFrame. The base setup, data transfer methods (POST/GET), code examples for embedding the iframe, and response handling are identical to the standard iframe and are documented in the iFrame Integration (new DirectNG) guide.
Base URL
https://directng.tranzila.com/terminalname/iframenew.php
Replace terminalname with your actual terminal name.
iFrame dimensions
The div that hosts the EMV iframe should be sized:
width: 370px
height: 455px
These dimensions differ from the standard iframe because the EMV payment-method selection field requires additional vertical space.
Enabling EMV mode
EMV mode is activated by sending modularity_on=1. This adds the EMV device selection field to the payment page.
| Parameter | Required | Values | Description |
|---|---|---|---|
modularity_on | Yes | 1 | Adds the EMV device selection field to the iframe. Required for EMV charges |
To present EMV device payment only (hiding the online credit card fields), combine modularity_on=1 with hide_cc=1.
| Parameter | Required | Values | Description |
|---|---|---|---|
hide_cc | No | 1 | Hides the online credit card payment fields (EMV-only) |
Required parameters
| Parameter | Required | Values | Description |
|---|---|---|---|
sum | Yes | Positive decimal number | Transaction amount |
currency | Yes | See Currency values | Transaction currency |
cred_type | Yes | 1 - One payment, 6 - Credit, 8 - Installments | Payment type |
modularity_on | Yes | 1 | Enables the EMV device selection field |
Additional parameters
These parameters behave exactly as in the standard iFrame Integration guide. They are listed here for convenience.
| Parameter | Values | Description |
|---|---|---|
opensum | 1 | Allows the payer to enter the amount to be charged |
lang | See Language values | Display language of the payment page |
maxpay | Positive integer | Maximum number of installments the payer may select |
IMaam | See VAT values | VAT percentage applied to the invoice |
company | String | Paying company name (*sent to the invoice) |
contact | String | Paying contact name (*sent to the invoice) |
email | String | Payer email address (*sent to the invoice) |
phone | String | Payer phone (*sent to the invoice) |
address | String | Payer address (*sent to the invoice) |
city | String | Payer city (*sent to the invoice) |
pdesc | String | Product description (*sent to the invoice) |
Parameters marked with
*are passed to the generated invoice.
Display settings
| Parameter | Values | Description |
|---|---|---|
trBgColor | hexadecimal | Background color |
trTextColor | hexadecimal | Text color |
trButtonColor | hexadecimal | Payment button color |
buttonLabel | string | Payment button text |
hidesum | 1 | Hide the payment amount |
nologo | 1 | Remove the Tranzila logo |
Digital wallet options
| Parameter | Values | Description |
|---|---|---|
ppnewwin | 2 | Add a PayPal payment button to the iframe page |
Parameter names are case sensitive.
Possible values
Currency values
| Value | Currency |
|---|---|
1 | NIS (₪) |
2 | US Dollar |
978 | Euro |
826 | Pound Sterling |
124 | Canadian Dollar |
036 | Australian Dollar |
578 | Norwegian Krone |
752 | Swedish Krona |
208 | Danish Krone |
392 | Japanese Yen |
756 | Swiss Franc |
Language values
| Value | Language |
|---|---|
il | Hebrew |
us | English |
ar | Arabic |
ru | Russian |
es | Spanish |
de | German |
fr | French |
jp | Japanese |
VAT values
IMaam accepts the VAT rate as a fraction (for example 0.18 for 18%) or a whole number (for example 18). If no value is sent, VAT is treated as 0.
To use the
IMaamparameter, the VAT field must first be configured under Additional Fields for Transaction in the Tranzila system.
cred_type values
| Value | Description |
|---|---|
1 | One payment |
6 | Credit installments |
8 | Installments |
Success, failure, and Notify URLs
You can configure the success, failure, and Notify pages in the payment page settings (Merchant), or — if they are dynamic — send them per transaction as parameters.
| Parameter | Description |
|---|---|
success_url_address | Success page URL |
fail_url_address | Failure page URL |
notify_url_address | Notify page URL |
Implementation notes
-
The success / failure / Notify URL must begin with
https. -
If you pass parameters inside the URL, the URL must be URL-encoded (for example signs such as
&,%, or$). -
Sending any of these parameters overrides the success / failure / Notify settings configured on the payment page.
-
If the URL sent is invalid, an email is sent to the terminal owner's email address in the following format:
TextUrl address of success URL : XXXXX that you have send as parameter was invalid. Transaction time: 27-11-2017 11:11:10
Examples
The examples below use the GET form for readability. As with the standard iframe, POST is the recommended method. See Code Examples for Creating Iframe with POST in the main guide.
Standard charge with open sum:
https://directng.tranzila.com/terminalname/iframenew.php?currency=1&modularity_on=1&opensum=1&lang=us&cred_type=1
Installments charge with open sum:
https://directng.tranzila.com/terminalname/iframenew.php?currency=1&modularity_on=1&opensum=1&lang=us&cred_type=8
EMV device only (online card fields hidden):
https://directng.tranzila.com/terminalname/iframenew.php?currency=1&modularity_on=1&opensum=1&lang=us&cred_type=8&hide_cc=1
Receiving the response
The response structure and response-handling code examples are identical to the standard iframe. See Receiving the Response in the main guide.