PayPal Integration

Tranzila with PayPal Integration

Tranzila's system incorporates the use of PayPal, offering its customers an additional payment method alongside various other existing options within the system.

Now, business owners who wish to provide the PayPal payment option can do so with ease, utilizing the full capabilities of the Tranzila system.

Tranzila enables the management of a merchant account (credit cards, bank transfers) and a PayPal account within a single, advanced interface in Hebrew.

In this control and monitoring interface, responses and displays are identical to the existing TranZila system state, bringing the system's use to maximum convenience.

The purchasing process through PayPal with Tranzila integration consists of the following steps:

1. The customer clicks the PayPal payment button on the merchant's site.

2. The customer logs into their PayPal account with their username and password.

3. The customer selects a payment method and shipping address saved in the system.

4. The customer clicks the confirmation button on the PayPal page and returns to the merchant's page.

The Tranzila system is transparent from the user's perspective and accelerates the interface process with PayPal.

Setting Up a Business Account on PayPal

To add PayPal as a payment channel to your site, you must create a business account on the PayPal Business Account system. The registration process for PayPal is simple and quick.

Visit the following Webpage: https://www.paypal.com/il/webapps/mpp/home

When setting up the account on PayPal, pay attention to the following details:

• Include the business logo, which will appear during the transaction (the logo must be hosted under https).
• Choose a primary currency.
• Set up Instant Payment Notifications (IPN - more on IPN later).

INSERT SCREENSHOT

On the PayPal form, fill in all the business and account details as per PayPal's requirements.

After registering for the service, you will receive a number of details, which will be entered into the TranZila system when setting up the account.

Connecting a PayPal account to Tranzila via the payment page

connect to PayPal using Redirect / Iframe

To set up PayPal in Tranzila, settings must be configured on both the Tranzila side an PayPal side.

To configure the interface with PayPal for a client using a Direct/Iframe page:

1. Enter the Merchant's payment page settings (see Payment Page Settings section) and activate the PayPal button.
2. In the IFRAME, pass the field and value ppnewwin=2 along with all other fields sent to the payment page, so the PAYPAL button appears on the payment page.

INSERT SCREENSHOT

3. In the payment terminal, configure the work setting. Menu > Settings > Terminal > Work Method INSERT SCREENSHOTS

4. In the redirect address fields, add your payment page address, including your terminal name (replace your_terminal_name), for example:

   • https://direct.tranzila.com/your_terminal_name/
   • https://pay.tranzila.com/your_terminal_name/
   • https://direct.tranzila.com/your_terminal_name/iframe.php
   • https://direct.tranzila.com/your_terminal_name/iframenew.php

5. In the "URL for approved transaction" field, add the address of your success page as defined in the Merchant payment page settings.

6. In the "URL for failed transaction" field, add the address of your failure page as defined in the Merchant payment page settings.

7. Save the settings after completion.

• Note that the links starting with direct belong to Tranzila's payment page services, which are essential if you are working through Tranzila's payment page (Redirect/Iframe).

8. Now, log in to your PayPal account. On the main screen, select Seller Preferences.

INSERT SCREENSHOT

9. In the menu, choose API Access.

INSERT SCREENSHOT

10. Select option 2 - View API Signature (do not choose API Permission).

INSERT SCREENSHOT

11. Display the Username, Password, and Signature and copy them for setting up in your Tranzila account.
    • API Username
    • API Password
    • API Signature

INSERT SCREENSHOT

12. After copying the above values, go to the payment terminal, enter Settings > PayPal, and configure the user details copied from PayPal.

INSERT SCREENSHOTS

13. Mark the account type as active.

14. Log in again to your PayPal account. On the main screen, select Seller Preferences. INSERT SCREENSHOT

15. Choose Instant Payment Notifications. INSERT SCREENSHOT

    • Activate the IPN service by clicking on "Receive IPN Messages" and specify the following URL: https://secure5.tranzila.com/cgi-bin/tranzila31n.cgi?supplier=terminal

• Replace the word TERMINAL with the name of your terminal. INSERT SCREENSHOT

Tranzila and PayPal Variables

In PayPal, there are pre-defined system variables that can be used within the Tranzila system.

PayPal variables are divided into two types:

1. Variables sent from the PayPal system and stored in the Tranzila system
2. Variables sent to the PayPal system from the Tranzila system

To set field names, go to the control panel and navigate to "Settings" ► "Setting 2". PayPal variables are set in the third section of this screen.

The parameter name of PayPal in the Tranzila system is composed of a prefix of pp_ followed by the parameter name.

INSERT SCREENSHOT

Data that can be received from the PayPal system

Important data that can be received from PayPal and can be set as part of 20 free variables:

Data that can be sent from the Tranzila system to PayPal

From the Tranzila system, parameters that describe the transaction can be sent. These data will be stored in the business account on PayPal alongside the transaction.

The parameters sent to PayPal should be defined in the payment form, and if you want to display them in the Tranzila interface, they should also be defined in the control panel as part of the additional 20 variables.