VPCart 9.0 Authorize Net Accept Hosted Gateway Readme

Created : 23 January 2019
Last Modified : 05 January 2023
***********************************************************************************
Contents:

A. SUMMARY
B. FILE STRUCTURE
C. INSTALLATION INSTRUCTION
D. CHANGES
E. CONFIGURATION SETTINGS
F. DATABASE TABLES MODIFIED
G. LANGUAGE SETTINGS CHANGED
H. CHANGE LOGS
I. TROUBLESHOOTING
J. FAQ
K. COPYRIGHT NOTICE
L. TERMS AND CONDITIONS

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

A. SUMMARY
==========

This interface is for use with Authorize Net Accept Hosted Gateway.

IMPORTANT NOTE:
Authorize.Net requires your shopping cart site to have SSL certificate installed. Authorize.Net would reject any connections from merchant site if it is not in HTTPS mode.

If you need to have SSL certificate for your site, you can purchase at:
https://www.vpcart.com/virtprog/instantssl1yr.htm

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

B. FILE STRUCTURE
===================

Files included in the zip are:
Refer to package

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

C. INSTALLATION INSTRUCTION
============================

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/anaccepthosted_setup.asp

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

Please set the following fields:

Enable : Yes to enable the Auth Net Accept Hosted payment.

Prefix: The prefix to show on order transaction field "Payment Status" in Orders administration. Default is AuthAcceptHosted.

Test mode: Set to No for live/production. Set to Yes if you are using test account.

API login ID: Please enter your API Login ID provided by Authorize Net.

Transaction key: Please enter your Transaction Key provided by Authorize Net.

Charge transaction name : Transaction type of credit card. Available option:
authCaptureTransaction: To authorize and capture transaction.
authOnlyTransaction: To authorize the transaction only so that you can capture later.

Refund transaction name: Default value is refundTransaction. This is used to initiate refund process.

Void transaction name: Default value is voidTransaction. This is used to void an unsettled transaction.

Prior capture name: Default value is priorAuthCaptureTransaction. This is used to capture a previous AuthOnly transaction request.

4. Click Save button.

5. Login to your site FTP, go to httpdocs folder. Check if you have web.config file.

6. If you don't have web.config file, then please create a new file called web.config using notepad and enter this code below:

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
<system.webServer>
<rewrite>
<outboundRules>
<clear />
<rule name="Add SameSite" preCondition="No SameSite">
<match serverVariable="RESPONSE_Set_Cookie" pattern=".*" negate="false" />
<action type="Rewrite" value="{R:0}; SameSite=None; Secure" />
</rule>
<preConditions>
<preCondition name="No SameSite">
<add input="{RESPONSE_Set_Cookie}" pattern="." />
<add input="{RESPONSE_Set_Cookie}" pattern="; SameSite=None; Secure" negate="true" />
</preCondition>
</preConditions>
</outboundRules>
</rewrite>
</system.webServer>
</configuration>

7. Upload the web.config file into your httpdocs folder.

8. If you already have web.config file, then please open the file with notepad or any other text editor and insert this new code before the </rewrite> :

<outboundRules>
<clear />
<rule name="Add SameSite" preCondition="No SameSite">
<match serverVariable="RESPONSE_Set_Cookie" pattern=".*" negate="false" />
<action type="Rewrite" value="{R:0}; SameSite=None; Secure" />
</rule>
<preConditions>
<preCondition name="No SameSite">
<add input="{RESPONSE_Set_Cookie}" pattern="." />
<add input="{RESPONSE_Set_Cookie}" pattern="; SameSite=None; Secure" negate="true" />
</preCondition>
</preConditions>
</outboundRules>

9. Upload the web.config into your httpdocs folder to replace your existing.

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

D. CHANGES
===============

2019.05.15 - AcceptHosted: Include Solution partner ID
2020.09.15 - AcceptHosted: Include installation step for web.config for latest Chrome browser issue.
2021.03.17- Bug Fix: Better hanlding on opaymethod field comparison if opaymethod does not set default value correctly

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

E. CONFIGURATION SETTINGS
=================

New configurations for Accept Hosted Gateway.

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

F. DATABASE TABLES MODIFIED
===========================

1. New field: addoninfo.refundvoidpage

2. New field: orders.otransid

3. New field: orders.occlastdigits

4. New field: orders.oauthcode

5. New field: orders.orefundtype

6. New field: orders.addonmodulename

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

G. LANGUAGE SETTINGS CHANGED
============================

1. langfailedretrycctransaction: Your credit card transaction failed<br>Please try again later.

2. langcctransfailpossiblefraud: Your credit card transaction failed<br>Possible fraud detection.

H. CHANGE LOGS
============================

'2020.03.09 - Better process on updating addonmodulename
'2020.09.15 - AcceptHosted: Include installation step for web.config for latest Chrome browser issue.
'2021.03.17- Bug Fix: Better hanlding on opaymethod field comparison if opaymethod does not set default value correctly
'2023.01.05: AnAcceptHosted: To include shipping address
'2023.01.05: AnAcceptHosted: Bug Fix: Popup payment page too big for mobile devices

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

I. TROUBLESHOOTING
============================

Please submit a ticket to our helpdesk at https://helpdesk.vpcart.com and our support team will assist you.

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

J. FAQ
============================

NONE

***********************************************************************************
K. COPYRIGHT NOTICE
============================

Copyright (c) 1999-2023 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.

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

L. 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.