VPCart Tazapay Hosted Payment Page gateway Readme

Created : 21 Dec 2023
Last Modified : 14 March 2024

***********************************************************************************
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
==========

Integrate Tazapay Hosted Payment V3 effortlessly into your checkout process, enabling your customers to make credit card payments just like any conventional payment gateway.

Sign Up: To use this module, you need to register an account with Tazapay. Sign up for an account at https://dashboard.tazapay.com/signup.
Seamless Checkout: Once registered, seamlessly incorporate Tazapay Hosted Payment into your checkout flow, allowing customers to complete transactions using credit cards with ease.

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

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

Files included in the zip are:
- $readme_tazapay900.HTML
- tazapay_execute.asp
- tazapay_process.asp
- tazapayconfig.asp
- tazapaygateway.asp
- tazapay_base64.asp
- taza_shopthanks.asp
- tazapaycallback.asp
- tazapayshopxmlhttp.asp
- admin/tazapay_setup.asp
- admin/tazapay_setup_config.asp
- admin/tazapay_setup_process.asp
- admin/sqlscripts/tazapay/*

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

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

1. Upload the below files to your VPCart 9.00 root folder.
- tazapay_execute.asp
- tazapay_process.asp
- tazapayconfig.asp
- tazapaygateway.asp
- tazapay_base64.asp
- taza_shopthanks.asp
- tazapaycallback.asp
- tazapayshopxmlhttp.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/tazapay_setup.asp
- admin/tazapay_setup_config.asp
- admin/tazapay_setup_process.asp
- admin/sqlscripts/tazapay/*

3. Log into super admin and execute page below:
http://www.yourdomain.com/<your admin folder>/tazapay_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 Tazapay Payment solution 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 Tazapay Payment gateway.

- Secret Key : Enter your Tazapay V3 Secret Key .

- Enable write log? : Set to Yes to enable write logs for response returned from Tazapay for a payment.
The log will use folder tazapay_logs

- API Key : Enter your Tazapay V3 API Key .

- Enter 3 digit of currency format eg. USD : Enter the 3 letters of currency code. Default is USD.

6. Click Save button.

7. Create a new folder named "tazapay_logs" in your VPCart site's root directory and set it to have WRITE folder permissions. You can either ask your hosting provider to create this folder for you or create it yourself using FTP.

8. If your domain is protected under CloudFlare service, please make sure to turn OFF Bot Fight Mode. If you not set this feature to OFF, it will cause Tazapay not able to send back notification to your site.
Please ignore this step if you are not under CloudFlare service.

9. You are done.

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

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

After you have installed Tazapay Hosted payment gateway module, when customers do a checkout, they will see a button "Pay Now With Credit Card" on the checkout page.

When it is clicked, customers will be redirected to a Tazapay hosted payment page to enter their card.

Once payment is made on Tazapay hosted page, customers will be returned back to the merchant site.

On a success payment, Tazapay will return response with Tazapay txnNo and Status succeeded to your VPCart site.

VPCart will update the following Orders table fields as below eg :
ocardtype : Tazapay
oauthorisation :
txnNo=chk_xxxxxxxxxxxxxxxxx
Status=succeeded

NOTE: Tazapay Hosted payment is supporting Sandbox mode. You can use your Sandbox account to test.

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

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

New configs:
- xtazapay_enable
- xtazapay_secretkey
- xtazapay_apikey
- xtazapay_currency
- xtazapay_writelog

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

NONE

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

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