General Info

This Package Solution is created for ONE OFF PAYMENTS only for Worldnet Hosted Payment Page.

Table of Content:
* Package
* Installation
* Account Details
* Processing Payments
* Troubleshooting

Package

Package contains following catalogues or files:

1) assets folder:
a) css - optional CSS for example form
b) js - optional js for fields validation

2) functions folder:
a) worldnet_account.inc - file with account details
b) worldnet_hpp_functions.php - helper file
c) worldnet_payment.php - main file for integrating with Worldnet HPP

3) receipt folder:
a) receipt_page.php - a file to redirect a cardholder after a payment to a relevant receipt page based on the transaction response code
b) receipt_page_approval.php - final receipt page for approved transactions
c) receipt_page_decline.php - final receipt page for declined transactions

4) index.php file: file that contains a basic HTML form that can be used on any website to send payments to Worldnet HPP

Installation

1) Include the PAYMENT FORM into your page
* optional CSS - optional CSS for the form can be included. Please ensure that there is no conflict between our CSS and CSS on your website
* optional JS - optional JS for the form can be included. This is required if you want to use included Validator.
* optional Validator - include optional validator script in the head of your page if you would like to use it with the form
* ensure that there is no conflict between our CSS/JS and CSS/JS on your website

2) Move 'functions' folder to your server
* if your website's structure differs from our example please remeber to amend all URLs

3) Update functions/worldnet_account.inc with
* your Terminal ID
* relevant for that terminal Currency
* correct SharedSecret for the terminal (only you have access to your Secret and Worldnet staff is unable to provide it for you for security reasons)
* update receipt page URL - this depends on your website structure

4) Update receipt/receipt_page.php for (this depends on your website strucutre)
* receipt_page_approval.php - this is a DEMO page only, and it is recommended that you create your own receipt page based on this example
* receipt_page_decline.php - this is a DEMO page only, and it is recommended that you create your own receipt page based on this example

5) Set the payments to TEST or LIVE
* for TEST ACCOUNT set '$testAccount = true;' in functions/worldnet_account.inc
* for LIVE ACCOUNT set '$testAccount = false;' in functions/worldnet_account.inc

Account Details

1) SandBox Details:
if you do not have a dedicated test account you can use our SandBox Test Details

2) Test Cards:
test cards can be found on our Testing Guide

3) Dedicated Test Account:
for more details please contact our Customer Support Team on support@worldnettps.com

4) Live Account Details:
Live Details can be obtained from Worldnet Customer Support on successful completion of your integration

Processing Payments

1) fill in the form
2) click 'PAY' button
3) you should be redirected to Worldnet HPP
4) process a payment
5) after the payment you should be redirected to a receipt page

Troubleshooting

1) INVALID TEMRINALID - your terminal ID is incorrect
2) INVALID AMOUNT - your amount has incorrect format
3) INVALID CURRENCY - currency not supported by the terminal
4) INVALID HASH - please check your SharedSecret
5) ORDER ALREADY PROCESSED - you can use the same order ID only once per day
6) Not redirected to Worldnet HPP - check your links to all the files
7) Not redirected to Receipt Page - check your URLs