Download the PHP package futureecom/omnipay-tranzila without Composer

Omnipay Tranzila

Tranzila gateway for Omnipay payment processing library.

Note: This package uses the modern Tranzila API. Redirect functionality has been removed in favor of the handshake-based iframe integration for better PCI compliance. For advanced integration details, see the official Tranzila documentation.

Documentation

• Official Tranzila API docs: https://docs.tranzila.com/
• Omnipay general usage: https://github.com/thephpleague/omnipay

Installation

Omnipay is installed via Composer. To install, simply add it to your composer.json file:

And run composer to update your dependencies:

Basic Usage

The following gateways are provided by this package:

• Tranzila

For general usage instructions, please see the main Omnipay repository.

Authorization

Authorization operations support two methods:

Method 1: Credit Card Details

Method 2: Token + Expiry

Capture

Capture operations require all 4 pieces of information:

Method 1: Transaction Reference + Authorization Number + Token + Expiry

Method 2: Transaction Reference + Authorization Number + Credit Card Details

Void

Void operations require both transaction reference and authorization number:

Note: Void operations may not work on Tranzila test accounts. This is a limitation of the Tranzila sandbox environment. For more details, see the Tranzila API documentation.

Note: Void responses have a simpler format than other transactions. A successful void returns {"error_code":0,"message":"Success"} without a transaction_result object.

Reversal

Reversal operations require transaction reference, authorization number, and either token+expiry or card details:

Alternative: Using Card Details

Note: Reversal operations require the original transaction reference, authorization number, and either the token with expiry or complete card details from the original transaction.

Verification

Verification operations support two methods:

Method 1: Credit Card Details

Method 2: Token + Expiry

Purchase

Purchase operations support two methods:

Method 1: Credit Card Details

Method 2: Token + Expiry

Refund

Refund operations require authorization number + transaction reference + either token+expiry OR card details:

Method 1: Authorization Number + Transaction Reference + Token + Expiry

Method 2: Authorization Number + Transaction Reference + Credit Card Details

Setting the Terminal Password

Some Tranzila API operations (such as the handshake/iframe token request) require both the terminal name and the terminal password. You can set the terminal password using:

• For most payment operations (authorize, purchase, capture, refund, void, verify), only the terminal name is required.
• For the handshake (iframe token) operation, both terminal name and terminal password are required.

Example: Handshake with Terminal Password

Handshake (Iframe Token)

Supported Methods

This gateway supports the following payment methods:

• authorize() - Authorize a payment (supports token+expiry or card details)
• capture() - Capture a previously authorized payment (requires transaction reference, authorization number, and either token+expiry or card details)
• purchase() - Authorize and capture a payment in one step (supports token+expiry or card details)
• refund() - Refund a payment (requires authorization number+transaction reference+token+expiry OR authorization number+transaction reference+card details)
• void() - Void a payment (requires transaction reference and authorization number)
• reversal() - Reverse a payment (requires transaction reference, authorization number, and either token+expiry or card details)
• verify() - Verify a card without charging (supports token+expiry or card details)
• handshake() - Get iframe token for secure payment form

Supported Currencies

The gateway supports the following currencies:

• ILS (Israeli Shekel)
• USD (US Dollar)
• EUR (Euro)
• GBP (British Pound)

Support

If you are having general issues with Omnipay, we suggest posting on Stack Overflow. Be sure to add the omnipay tag so it can be easily found.

If you want to keep up to date with release announcements and discuss the project in general, please join the mailing list and follow us on Twitter.

Security

If you discover any security related issues, please email [email protected] instead of using the issue tracker.

License

The MIT License (MIT). Please see License File for more information.