Created : 01 January 2015
Last Updated: 29 March 2016

***********************************************************************************
Contents:

A. SUMMARY
B. FILES STRUCTURE
C. INSTALLATION INSTRUCTIONS
D. CHANGES
E. COPYRIGHT NOTICE
F. TERMS AND CONDITIONS

***********************************************************************************

A. SUMMARY
==========
This interface is for use with First Data Payeezy Gateway Hosted Payment Gateway

***********************************************************************************

B. FILES STRUCTURE
===================

Files included in the zip are:
Refer to the package

***********************************************************************************

C. INSTALLATION INSTRUCTIONS
============================
1. Upload all the files into your shopping cart folder.

2. Log into super admin and execute setup file, eg: http://www.yourdomain.com/yourshoppingcartfolder/youradminfolder/fdge4hosted_setup.asp

3. After setup the module, would be redirected Module configuration page for configure the module

* How to get your x_login and Transaction Key :
- Login to your First Data merchant at : https://globalgatewaye4.firstdata.com/
- Click Payment Pages
- Click the link in "Payment Page ID" column.
- Click "10. Hash Calculator" link in the left side.
You should then see the "Login (x_login)" and "Transaction Key" fields there.

* How to get your Response Key :
- Login to your First Data merchant at : https://globalgatewaye4.firstdata.com/
- Click Payment Pages
- Click the link in "Payment Page ID" column.
- Click "9. Security" link in the left side.
You should then see the "Response Key" field there.

* Setup Return URL and Receipt Page at your First Data Merchant.
- Login to your First Data merchant at : https://globalgatewaye4.firstdata.com/
- Click Payment Pages
- Click the link in "Payment Page ID" column.
- In the "General Settings", enter URL for the following field :
* "Return to Your Site" URL : http://www.yourvpaspsite.com/fdge4hostedshopcheckout.asp
- Click Save
- Click left menu "4. Receipt Page"
- In the " Receipt Page Settings ", please select "Automatic linking to the receipt page including result parameters using HTTP POST method (AUTO-POST)".
* Receipt Link Text : e.g enter with text : Click Here to Go Back To Merchant Store
* Receipt Link URL : http://www.yourvpaspsite.com/fdge4hostedresult.asp
- In the " Authorize.Net Protocol - Relay Response Settings "
* tick "Allow Relay Response"
* Relay Response URL : http://www.yourvpaspsite.com/fdge4hostedresultpass.asp
- Click Save

For testing this gateway, you need to sign up first a test account at :
https://provisioning.demo.globalgatewaye4.firstdata.com/signup

Then set config below :
xfdge4hosted_login ="xxx-xxxx-xxx"
xfdge4hosted_transactionkey="xxxxxxxxxxxxxxxxx"
const Test_request="True"

Test card numbers:
Visa 4111111111111111 Expiry Date: Any future date.
Mastercard 5500000000000004 Expiry Date: Any future date.

Test unsuccessfull response :
You can use the penny amounts to trigger a variety of eCommerce Responses, where the desired response code is added to 5000.00
For example, to simulate a transaction that encountered the "Unable to Send Trans" error (code 42) during processing, use 5000.42 as the transaction amount.
Note: If both the dollar and penny amounts would trigger a simulated code (for example, 5200.42), the penny amount trigger will take precedence.

***********************************************************************************

D. CHANGES
=================
2016.11.01 - Truncate and only pass max fields to gateway

***********************************************************************************

E. COPYRIGHT NOTICE
============================

Copyright (c) 1999-2019 Rocksalt International Pty. Ltd. .
All rights reserved.

This software and documentation constitute a published work and
contains valuable trade secrets and proprietary information
belonging to Rocksalt International Pty. Ltd. .
None of the foregoing material may be copied,
duplicated or disclosed without the express written permission
of Rocksalt International Pty. Ltd. .

LICENSEE ACCEPTS VP-ASP Shopping Cart "AS IS" "WITH ALL FAULTS",
Rocksalt International Pty. Ltd. accepts no responsibility for the
operation or performance of the VP-ASP Shopping Cart.
The entire risk of use and consequences of use of the
VP-ASP Shopping Cart falls completely on the Licensee
and Rocksalt International Pty. Ltd. shall not be liable in any respect
for any claims, loss or injury alleged to have resulted
from use of or in reliance on VP-ASP Shopping Cart.

Licensee acknowledges that it has read the foregoing
disclaimers of warranty and limitation of liability
and understands that Licensee assumes
the entire risk of using VP-ASP Shopping Cart.

***********************************************************************************

F. TERMS AND CONDITIONS
============================
ROCKSALT INTERNATIONAL GRANTS TO THE LICENSEE A NON-EXCLUSIVE,
NON-SUB LICENSABLE, NONTRANSFERABLE LICENSE
TO INSTALL AND USE THIS APPLICATION ON A SINGLE DOMAIN FOR
A SINGLE SHOP.

THE CODE IN THE APPLICATION MAY BE MODIFIED FOR USE IN
SETTING UP A SINGLE SHOPPING SITE ON THE WORLD WIDE WEB.

LICENSEE MAY MAKE A COPY OF THE APPLICATION FOR
BACK-UP AND ARCHIVAL PURPOSES, PROVIDED THAT ANY COPY
MUST CONTAIN ALL PROPRIETARY NOTICES INCLUDED
WITH THE APPLICATION.

LICENSEE IS PROHIBITED FROM SELLING OR DISTRIBUTING
THE APPLICATION IN ANY MANNER.

LIMITATION OF LIABILITY.

ROCKSALT INTERNATIONAL AND ITS LICENSORS SHALL
NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE OR ANY
THIRD PARTY AS A RESULT OF USING OR DISTRIBUTING THIS
APPLICATION.

IN NO EVENT WILL ROCKSALT INTERNATIONAL OR ITS LICENSORS
BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA,
OR FOR DIRECT, INDIRECT, SPECIAL,
CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES,
HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LI
ARISING OUT OF THE USE OF OR INABILITY TO USE THE SOFTWARE,
EVEN IF ROCKSALT INTERNATIONAL HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.