General Info

This Package Solution is created for ONE OFF PAYMENTS with Background Validation 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) validation folder:
a) validation.php - required file for Background Validation. Content of this file MUST NOT be altered and only 2 characters should be included: OK

5) 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 and CSS 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

2) Move 'validation' folder (or the file only) to your server
* ensure that you provide correct URL to the file's location in worldnet_account.inc

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
* update validation URL - this depends on your website structure. If this URL is incorrect your payments will fail!

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

6) Ensure that your terminal comes with enabled Background Validation. If you are not sure how to enable, please contact our Customer Support Team.

Account Details

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

2) Dedicated Test Account:
you will need a Dedicated Test Account for this integration. You can obtain credentials from our Customer Support Team: support@worldnettps.com

1) 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
6) Log in to SelfCare System to check transaction status

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