Datacash Payment Gateway

Last Updated: 01 Feb 2018

payment_gateway_datacash|asset|5.5.0.0

The Datacash Payment Gateway asset allows you to create a DataCash payment gateway, providing users with a secure way to pay for their items. In order to use the Datacash Payment Gateway, you will need an account at the DataCash website.

Datacash online payment gateway and eCommerce solutions cater to a number of banks worldwide, however, may not be available in all regions. Please check the DataCash website for more information on the availability of this payment gateway.

The DataCash payment gateway accepts the following card types:

  • Debit MasterCard
  • MasterCard
  • VISA
  • VISA Delta/Debit
  • VISA Electron
  • VISA Purchasing
  • Solo
  • American Express
  • Diners Club
  • Duet
  • JCB
  • Laser
  • Maestro

A successful transaction originating from a Datacash Payment Gateway will generate the E-Commerce Payment Completed Trigger Event. For more information, refer to the Trigger Events chapter in the Triggers manual.

Once you have added a Datacash Payment Gateway, you configure its settings on its associated asset screens. The majority of these screens are the same or similar to those for a Standard Page and are described in the Asset Screens manual. In this chapter, we will describe the Details and Display Formatting screens, which are different for a Datacash Payment Gateway.

Additional Dependant Assets

The additional dependant assets of the Datacash Payment Gateway
The additional dependant assets

When you create a Datacash Payment Gateway, the Display Format and Card Holder Verification Bodycopyassets are automatically created beneath it, as shown in the figure to the right. You can use these Bodycopies to define the contents and layout of the payment and cardholder verification forms. The Display Format Bodycopy can be accessed via the Display Formatting screen.

Details Screen

The Details screen allows you to configure the settings of the Datacash Payment Gateway. For more information about the Status, Future Status, Thumbnail and Details sections, refer to the Details Screen chapter in the Assets Screens manual.

Datacash Account Details

This section allows you to enter your account details, allowing you to accept payments from the payment gateway.

The Datacash Account Details section of the Details screen
The Datacash Account Details section of the Details screen

In the Client and Password fields, enter your account details, supplied to you by DataCash. In order to accept credit card payments from the Datacash Payment Gateway, you will need to obtain an Internet Merchant Account Facility from your bank and complete the DataCash Application Form at the DataCash website.

Configuration

This section allows you to configure the general settings of the Datacash Payment Gateway and select the DataCash API and CardInfo files for the DataCash transactions.

The Configuration section of the Details screen
The Configuration section of the Details screen

The fields available in this section are as follows:

  • Datacash API Path: enter the path to the DataCash PHP API's DataCash.php field, supplied by DataCash. This file must be installed on the system and selected in this field to establish the payment gateway setup. If an invalid path is selected, the message The path to Datacash PHP API is not valid will appear on the screen. By default, this field will read /usr/bin/DataCash.php.
  • CardInfo Directory Path: enter the path to the CardInfo directory. This will be the directory holding the CardInfo files supplied by DataCash. These files must be installed on the system and selected in this field to establish the payment gateway setup. If an invalid path is selected, the message The path to the directory that keeps the CardInfo Files will appear on the screen. By default, this field will read /usr/bin/CardInfoBins.
  • Timeout: select the amount of time in seconds that the payment gateway will wait for the user's response before returning an error. By default, this field is set 60 seconds.
  • Currency: select the currency that will be used in all e-commerce transactions processed by the Datacash Payment Gateway. The following currencies are available:
    • Great British Pound (GBP)
    • Australian Dollar (AUD)
    • United States Dollar (USD)
    • Euro (EUR)
    • Japanese Yen (JPY)
    By default, this field is set to GBP.
3-D Secure

This section allows you to configure 3-D secure protocol as added security for credit and debit card transactions made on the Datacash Payment Gateway. Please note that not all credit and debit cards are able to provide 3-D secure protection. When 3-D secure protection is enabled, users will be taken to the Card Holder Verification screen that will display the 3-D secure service configured to your DataCash account. For more information, visit the DataCash website at www.datacash.com. The 3-D Secure section of the Details screen is shown in the figure below.

The 3D Secure section of the Details screen
The 3-D Secure section of the Details screen

The fields available in this section are as follows:

  • Merchant URL: enter the URL of the Site where the payment is being made. The HTTP protocol should be included in the URL. For example http://www.mysite.com.
  • Purchase Description: enter a description of the items purchased from the e-commerce store. This will be displayed by the Access Control Server (ACS) during the 3-D secure authentication process. For example, if your e-commerce store sells fruit and vegetable produce you could enter Farmer Ted's fresh fruit and veggies in this field. By default, this field will read The total amount.
  • Non-3D Secure Card Types: select the card types that will not be checked during the 3-D secure authentication process. Only the card types that support 3-D secure will be listed in this field for you to select. Unsupported cards are automatically appended to the list of cards that will not be checked. By default, Solo is selected in this field.
Address and Security Code Verification (AVS/CV2)

This section allows you to use the Address Verification Service (AVS) and Card Verification Value (CV2) systems as added security for credit and debit card transactions made on the Datacash Payment Gateway. Please note that the AVS system is not available in all countries.

The Address and Security Code Verification (AVS/CV2) section of the Details screen is shown in the figure below.

The Address and Security Code Verification section of the Details screen
The Address and Security Code Verification section of the Details screen

In the Standard Policy field, select the verification system(s) to use and the check requirements for a transaction to succeed. The following options are available:

  • No: no verification checks will be made.
  • AVS check: the AVS security check must be made for the transaction to succeed.
  • CV2 check: the CV2 security check must be made for the transaction to succeed.
  • both AVS and CV2 check: both the AVS and CV2 security checks must be performed for the transaction to succeed.
  • Either AVS check or NOT CHECKED: the AVS security check will be performed where applicable. Transactions that are unable to be checked will still succeed.
  • Either CV2 check or NOT CHECKED: the CV2 security check will be performed where applicable. Transactions that are unable to be checked will still succeed.
  • Either AVS and CV2 check or NOT CHECKED: both the AVS and CV2 security checks will be performed where applicable. Transactions that are unable to be checked will still succeed.

If AVS and CV2 are enabled, address and CV2 fields must be included on the payment gateway using keyword replacements. For more information, refer to the Display Formatting Screen section in this chapter. Alternatively, pass through variables can be configured to source the address from the user's e-commerce form responses. For more information,refer to the Pass through Variables section below.

Pass through Variables

This section allows you to source address information for the Address Verification Service (AVS) from the user's e-commerce form responses. For example, a user's response to a Postcode question on an e-commerce form could be passed through to the DataCash Payment Gateway to provide the postcode for the AVS. The Pass through Variables section of the Details screen is shown in the figure below.

The Pass through Variables section of the Details screen
The Pass through Variables section of the Details screen

In the available fields, enter the pass through variable keys for the corresponding questions. These keys must be configured on the Ecommerce Rules screen of the Ecommerce Form Page. For more information, refer to the Ecommerce Rules screen section of the Ecommerce Form Page chapter in this manual. The fields that are available in this section are as follows:

  • Address 1 Variable Name: enter the pass through variable key for the first line of the address.
  • Address 2 Variable Name: enter the pass through variable key for the second line of the address.
  • Address 3 Variable Name: enter the pass through variable key for the third line of the address.
  • Address 4 Variable Name: enter the pass through variable key for the fourth line of the address.
  • Postcode Variable Name: enter the pass through variable key for the address postcode.
Interface Options

This section allows you to change the wording of the buttons for the payment gateway. The Interface Options section of the Details screen is shown in the figure below.

The Interface Options section of the Details screen
The Interface Options section of the Details screen

The fields that are available in this section are as follows:

  • Submit Button Text: enter the text to display as the submit button. By default, this button will read Pay. This button is displayed when the keyword replacement Submit Button is used on the Display Format Bodycopy.
  • Reset Button Text: enter the text to display as the reset button. By default, this button will read Reset. This button is displayed when the keyword replacement Reset Button is used on the Display Format Bodycopy.
  • Cancel Button Text: enter the text to display as the cancel button. By default, this button will read Cancel. This button is displayed when the keyword replacement Cancel Button is used on the Display Format Bodycopy.
Testing Mode

This section allows you to modify the payment gateway to function in Test Mode. The Testing Mode section of the Details screen is shown in the figure below.

The Testing Mode section of the Details screen
The Testing Mode section of the Details screen

In the Test Mode field, select whether or not to use the payment gateway for testing purposes only. If this field is set to On, the payment gateway will not process any payments and the Number field on the Datacash Payment Gateway form will be replaced with the test drop down menu, as shown in the figure below.

The Datacash Payment Gateway in Test Mode
The Datacash Payment Gateway running in Test Mode

Display Formatting Screen

The Display Formatting screen allows you to edit the Display Format Bodycopy. Please note that this Bodycopy can also be edited by right clicking on the Display Format Bodycopy in the Asset Map and selecting Edit Contents.

Display Format Bodycopy

The Display Format Bodycopy is used to define the layout of the Datacash Payment Gateway page. The default layout of the payment gateway is shown in the figure below.

The default layout of the Datacash Payment Gateway
The default layout of the Datacash Payment Gateway

To change the information that is being shown, click on the edit icon icon – the WYSIWYG Editor will appear where you can use the keyword replacements and formatting to set the layout of the information to show on the payment gateway page. By default, the information shown in the figure below will appear in the WYSIWYG Editor.

The WYSIWYG Editor on the Display Format Bodycopy
The WYSIWYG Editor on the Display Format Bodycopy

Tip: By default, the transaction amount on the DataCash Payment Gateway will be listed in British Pounds. This may need to be changed depending on the currency you have selected on the Details screen.

Keyword Replacements on the Display Format Bodycopy

A list of keyword replacements is provided in the WYSIWYG Editor toolbar on the Edit Contents screen of the Display Format Bodycopy. You can use these keyword replacements in conjunction with text, images and links etc to configure the layout of the payment gateway page. The standard keyword replacements that are available include the following:

  • Card Number: this will show the credit card number field.
  • Card Start Month: this will show the credit card start month field.
  • Card Start Year: this will show the credit card start year field.
  • Card Expiry Month: this will show the credit card expiry month field.
  • Card Expiry Year: this will show the credit card expiry year field.
  • Card Issue Number: this will show the card issue number field.
  • Card CV2: this will show the Card Verification Value (CV2) field. This is required for CV2 verification checks.
  • Street Address 1: this will show the first line of street address field.
  • Street Address 2: this will show the second line of street address field.
  • Street Address 3: this will show the third line of street address field.
  • Street Address 4: this will show the fourth line of street address field.
  • Postcode: this will show the postcode field.
  • Transaction Amount: this will show the amount of money that is to be paid in the transaction.
  • Transaction Currency: this will show the transaction currency. For example, AUD.
  • Processing Error (empty if no error): this will show any processing errors. For example, if the user forgets to fill out a field.
  • Submit Button: this will show the submit button.
  • Cancel Button: this will show the cancel button.
  • Reset Button: this will show the reset button.

Tip: A number of these fields are compulsory when creating a working payment gateway. If the required fields are not available to the user, the transaction will not be able to be completed.

Card Holder Verification Bodycopy

The Card Holder Verification Bodycopy is used to define the layout of the Datacash Payment Gateway's 3-D secure verification page. By default, the 3-D secure service configured to your DataCash account will be nested within this page. For more information, visit the DataCash website.

To change the information that is being shown, click on the edit icon icon – the WYSIWYG Editor will appear where you can use the keyword replacements and formatting to set the layout of the information to show on the verification page. By default, the information shown in the figure below will appear in the WYSIWYG Editor.

The WYSIWYG Editor on the Card Holder Verification Bodycopy
The WYSIWYG Editor on the Card Holder Verification Bodycopy

Keyword Replacements on the Card Holder Verification Bodycopy

A list of keyword replacements is provided in the WYSIWYG Editor toolbar on the Edit Contents screen of the Card Holder Verification Bodycopy. You can use these keyword replacements in conjunction with text, images and links etc to configure the layout of the verification page. The standard keyword replacements that are available include the following:

  • Card Holder Verification Form: this will show the 3-D secure service configured to your DataCash account.

Previous Chapter Next Chapter

The Latest

Let Us Know What You Think

Let us know if you spot any errors or if you have any ideas on how we can improve the Matrix Community Website.

Contact Squiz for Demo

Let us show you the true power of Squiz Matrix by giving you a personalised demonstration.