Created : 20 April 2016
Last Updated: 01 April 2020

***********************************************************************************
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 CyberSource Secure Acceptance - Silent Order Post (SA SOP) Payment Gateway
You must have SSL installed to use this payment gateway.

This newer version of cybersource SA SOP is not using any XML post method, so no need to worry about TLS thing.
It is using HTTP POST method to send and received payment data.

For more information on this gateway, please visit http://www.cybersource.com
***********************************************************************************

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

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

IMPORTANT NOTE :

To get your Cybersource Access key and Secret key, folow these steps:
---------------------------------------------------------------------
- Login to your cybersource Business Center e.g. https://ebc.cybersource.com/

- In the left panel, go to : Payment Configuration > Secure Acceptance Settings



- Click your existing active profile.

Note: If you do not have any active profile, please click NEW PROFILE button or contact your Cybersource representative.

- Then click the pencil edit icon on the top right.



- Click Confirm.

- Then click menu Security.



- Tick the checkbox and click the eye icon.


NOTE: If you have no key yet, please click the + button to create new key.

- After clicking the eye icon, you should be presented with Access Key and Secret Key.



- Copy the value in the "Access Key" and paste into your modules manager of the cybersourcesasop for the relevant field.
- Copy the value in the "Secret Key" and paste into your modules manager of the cybersourcesasop for the relevant field.

To get your Cybersource Profile ID, folow these steps:
------------------------------------------------------
- Login to your cybersource Business Center e.g. https://ebc.cybersource.com/

- In the left panel, go to : Payment Configuration > Secure Acceptance Settings



- Click your existing active profile.

Note: If you do not have any active profile, please click NEW PROFILE button or contact your Cybersource representative.


- You will see your profile id there e.g. Profile ID: xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx



How to Set Response URL
--------------------------------
You must login the Cybersource Business Center and set the Customer Response URL to use as response URL.

Please follow these steps :
- Login to your cybersource Business Center e.g. https://ebc.cybersource.com/

- In the left panel, go to : Payment Configuration > Secure Acceptance Settings



- Click your existing active profile.

Note: If you do not have any active profile, please click NEW PROFILE button or contact your Cybersource representative.

- Then click the pencil edit icon on the top right.



- Click Confirm.

- Click menu CUSTOMER RESPONSE.



- In the field "Transaction Response Page" please choose "Hosted By You" and enter page url eg:
https://www.example.com/cybersourcesasopresult.asp

NOTE: Please replace www.example.com with your vpcart site url.

- Click SAVE button.

Testing Card
------------
For testing purpose, you can use the test details below:

Visa#: 4111111111111111
Expiry Date: 12-2022
CVV: 123

Payment Notification
--------------------
1. For successful payment, vpcart orders table will have information stored as below eg:
ocardtype : CyberSource Secure Acceptance

oauthorisation : ACCEPT, Auth code=xxxxxxx, Auth trans no=xxxxxxxxxxxxxx

2. For unsuccessful transaction, vpcart orders table will have information stored as below eg:
ocardtype : CyberSource Secure Acceptance- Failed

oauthorisation : Reject Code:102
ERROR
card_number
Request parameters are invalid or missing

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

D. CHANGES
=================
2016.04.20 - has been upgraded to very latest integration "CyberSource Secure Acceptance - Silent Order Post" using base64 SHA-256 encryption.
2020.01.30 - fix for parameter transaction_uuid to pass an unique value using timestamp rather than passing order id. Better payment error information in orders data. Also data validation handling on expiry date format.
2020.04.01 - auto fill "-" in expiry date

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

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

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