VPCart 9.0 Google payment gateway Readme

Created : 12 April 2021
Last Modified : 15 April 2021

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

A. SUMMARY
B. FILE STRUCTURE
C. INSTALLATION INSTRUCTION
D. HOW IT WORKS
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 Google Pay gateway.

Features:

Your customers card information is passed as token for extra security
Easy to use & setup with minimal settings in Modules Manager.
Well tested on modern browsers and mobile devices.

Both normal checkout and one-page checkout method are supported by this module.

To use this module, you must register an account first with Google Mechant Center.
You can register at Google Merchant sign up page.

IMPORTANT NOTE:
It is strongly recommended to have SSL certificate installed on shopping cart site for security and PCI compliance.

If you do not have any SSL Certificate in your current site, you can purchase SSL from us at:
https://www.vpcart.com/virtprog/instantssl1yr.htm

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

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

Files included in the zip are:
- $READ_ME_FIRST_googlepay900.HTML
- gpay_execute.asp.asp
- gpay_gateway.asp
- gpay_process.asp
- gpayconfig.asp

- admin/gpay_setup.asp
- admin/gpay_setup_config.asp
- admin/gpay_setup_process.asp
- admin/sqlscripts/gpay/*

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

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

1. Upload the below files and folder to your VPCart 9.00 root folder.
- gpay_execute.asp
- gpay_process.asp
- gpay_gateway.asp
- gpay_process.asp
- gpay_onepagecheckout.asp
- gpayconfig.asp

2. Upload the below files to your ADMIN folder. If you have renamed your ADMIN folder, then this must be placed in the renamed folder.
- admin/gpay_setup.asp
- admin/gpay_setup_config.asp
- admin/gpay_setup_process.asp
- admin/sqlscripts/gpay/*

3. Log into super admin and execute page below:
http://www.yourdomain.com/<your admin folder>/gpay_setup.asp

Note: Replace the below with your VPCart site
{ www.yourdomain.com } : your site domain
{ your admin folder } : your admin folder

Click Install Now button.

4. After installation completed, you should see message below:
_______________________________________________________
The Google Pay initial setup has now been completed.

Please go to modules configuration page for further setup.
_______________________________________________________

5. Please click the "modules configuration page" link to setup.

- Enable? : Set to Yes to enable Google Pay Payment gateway.

- Google Merchant Account Name: Please enter your Google Merchant registered name.
- Google Merchant ID: Please enter your Google Merchant ID.

Note: you can get your Merchant Name and Merchant Id by accessing https://pay.google.com/business/console/

- Google-Pay Environment: set this field to TEST for test Environment and PRODUCTION for live.
- Google-Pay Gateway: you can pick the gateway you want to accept the payment with google pay through to this Link
- Google-Pay Gateway Merchant ID / Public ID: Kindly refer to the gateway you selected.
- Google-Pay Gateway version. : fill this config if your gateway requires you to declare the gateway version like Stripe otherwise leave it blank.

https://developers.google.com/pay/api/web/guides/tutorial#tokenization

6. You are done.

One page checkout setup:

1. Open your shoponepagecheckout.asp

2. in validatepaymentmethod routine ( sub validatepaymentmethod ), look for case "paypal" and add these code below:

'900 : Google-Pay'
case "gpay"

The code should look like this:

3. in the same file look for responseredirect "paypal_process.asp" code and add these code below:

'900 : google pay'
case "gpay"
%>
<script>

</script>
<%

The code should look like this:

4. Save and upload.

5. Open shoponepagecheckout_payment_subs.asp

6. look for code: if lcase(GetConfig("xpaypal")) = "yes"

7. insert these code after the "end if" condition of that script:

'900 : Google-Pay option'
if lcase(GetConfig("xpaypal")) = "yes" then
create_onepage_radio getlang("langgooglepay"), "payment_method", "payment_method_gpay", "gpay", paypalstr
create_onepage_paypal_wrapper "gpay_desc_wrapper", getlang("langgooglepay_desc"), paypalstr
end if

The code should look like this:

8. Save and upload.
9. Done.
***********************************************************************************

D. HOW IT WORKS
===============

When customers do a checkout, they will see the Google Pay Section option in the Payment Form Section.

On a success payment, Google-Pay will return response with Payment Token ID and Status to your VPCart site.

VPCart will update the following Orders table fields as below eg :
ocardtype : GooglePay
oauthorization : Googlepay Token ID=tok_xxxxxxxxxxxxxxxxxxx Status=succeeded

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

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

New configs:
- xgpay_enable
- xgpay_environment
- xgpay_gateway
- xgpay_gatewaymerchantid
- xgpay_gatewayversion
- xgpay_merchantid
- xgpay_merchantname

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

NONE

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

New language keywords added:

NONE

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

NONE

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

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.