Advanced search and download

In the advanced search and download, you can search for a single transaction or you can search for a range of transactions.

Clicking on the Advanced Search and Download option from the main menu will display the following screen:

For each criteria available for Advanced Search and Download above, the length and format of the field is as follows (please note that “” means a space):

Length and Format of fields in Advanced Search and Download screen

Field Format Length

Order ID

a-z A-Z 0-9 _ - 1-50

Card Num 0-9 12-19

Cardholder Name

a-z A-Z 0-9 “” ‘ _ 1-100

Var Ref

a-z A-Z 0-9 – “” _ . , + @ 0-50 Cust Num

a-z A-Z 0-9 – “” _ . , + @ 0-50 Quick Search –

Search for a single transaction

Search for a range of transactions

Field Format Length Product ID

a-z A-Z 0-9 – “” _ . , + @ 0-50

Advanced search and download is broken into two sections Quick Search – Search for a single transaction

Search for a range or transactions

7.1 Quick search – Search for a single transaction

The quick search can be found at the top of the advanced search and download screen, in the top left hand corner of the screen and also on the homepage.

You can search for a transaction using the following search criteria:

Credit Card Number

For each criteria available for Advanced Search and Download above, the length and format of the field is as follows (please note that “” means a space):

Field Format Length

For example, if you want to search for a transaction using the cardholders name you need to

• enter the name into the “enter search text”

• and then in the dropdown list “pick what to search” choose Cardholder name

• click on “Quick Search” link to complete the search

• This will display all transactions with that name.

7.2 Search for a range of transactions

You can download a range of transactions between two dates, at the bottom of the advanced search and download section. The screen is as follows:

• Enter the “from” and “to” dates; you can use a calendar by clicking on “choose”. The “to” date will default to a day after the “from” date, however you can extend your search if you wish. The maximum search is one calendar month.

• Your default sub account will be automatically chosen, so if you want to use a different account you will need to select it.

• You can then click on “Search and Display” to display them to the screen or “Search and Download” to download them to an excel spreadsheet.

7.3 Search Archives

The Search archive section is very similar to advanced search and download; however it is used to search for transactions that have been archived by Realex Payments. This can be used to find transactions that are 6 months or older.

7.4 Administration

This section has 2 options

Change password – to change your login password

Configuration – to configure your realauth Redirect template.

7.5 Change Password

In administration, you have the option to change your password.

To change your password successfully, you must use the following criteria:

Password must:

Be at least 7 characters in length;

Contain a mix of at least 3 of the following four groups o upper-case letter(s)

o lower-case letter(s) o number(s)

o symbol(s)

You cannot use a password previously used

The number of days that are left before your password will expire is displayed at the top of the screen.

Once your password expires you will be forced to change it.

7.6 Configuration

If you are using the realauth Redirect method of integration, we will store a template branded to look like your website to be displayed on the payment page.

In this section you can add information which will be displayed on your template page.

When you click on the configuration option, you see the following screen:

On this screen you have the following options:

Information text Success Text Failure Text

Below is the list of html tags allowed in the “Template Text for account” page in the “Account Administration” section of RealControl:

"table"

"tr"

"td"

"font"

7.7 Information text

In the Top text box you can enter text that will show up above the Payment form on your template.

There are 4 variables you can use in this text, to display the amount, comments and the Order ID.

They are as follows:

<#TOTAL#> - this is the amount formatted like EUR 10.00

<#COMMENT_1#> - the contents of comment 1

<#COMMENT_2#> - the contents of comment 2

<#ORDER_ID#> - the order id.

For example, you can enter the following text:

Your order id is <#ORDER_ID#>. You will be charged <#AMOUNT#>. <#COMMENT_1#>

This may be displayed on the template page as:

Your order id is ORD122-122. You will be charged EUR 99.91. Thank you for your business.

Where the ORDERID was ORD122-122, AMOUNT was 9991 and COMMENT_1 was “Thank you for your business".

7.8 Success Text

The second box will display the entered message to the cardholder who has had a successful transaction, however Realex Payments have encountered difficulty when trying to connect to your response page. Enter the message that you wish the cardholder to see.

7.9 Failure Text

The third box will display the entered message to the cardholder who has had an unsuccessful transaction, however Realex Payments have encountered difficulty when trying to connect to your response page. Enter the message that you wish the cardholder to see.

Once you have made your changes remember to click on save at the bottom of the page.

8 Appendix

This appendix lists the following:

▪ The current set of result codes returned by the Realex Payments system.

Transaction Response Codes

Note: These messages are subject to change without notice.

Code Description 00 Successful 101 Declined by Bank

102 Referral by Bank (treat as decline in automated system such as internet) 103 Card reported lost or stolen

2xx Error with bank systems

3xx Error with Realex Payments systems 5xx Incorrect XML message formation or content 666 Client deactivated.