How to use the eWay Retry functionality

In the event of an eWay payment failing or hanging CSS might not receive notification that the payment has completed processing. In this case the payments status might need to be manually re-tested and payment completed if payment was successful. This is done via the new CustPaymentStatusRecheck.aspx page.

Step-by-step guide

In this section we will focus only on the payment retry functionality, any other changes that can be made are just customizations.

The steps to setup this functionality are:

1. Login as an administrator
2. In the Content sub-menu select Resource Manager

3. Select the Role you want to configure the new menu item for and click Parent Items

   You should only add this page to administrator role(s)

4. Select a top level menu item in which to add the page or create a new menu item in which the new page will be setup
5. Once you have created and selected the parent menu item, click "New" to create a new menu item

6. Enter "CustPaymentStatusRecheck.aspx" for the Page Name and fill out the rest of the fields as needed

   You should make sure you select "Requires Authentication"

7. Click the "OK" button to create you menu item

Using the CustPaymentStatusRecheck.aspx Page

To get to the Customer Payment Status Recheck page you need to

1. Login with an account that has access to the role you created the menu item for
2. Choose the new page from the menu or go to this page: CustPaymentStatusRecheck.aspx

To set up a new menu item see Adding a new menu item

The page will list any outstanding eWay customer payment records. You can click the "Retry Payment Finalization" button to re-try determination as to whether the payment was or was not successfully processed by eWay, or whether the status has not been able to be determined (i.e. if the eWay payment service is still down)

The success/fail/indeterminate status of the payments will be shown underneath the table of payment records after processing is complete. Any indeterminate payments will remain in the table and can be re-tried at a later time.

Customization

After a customer has entered their credit card information and clicked submit CSS will post the form to eWay servers directly. A time-out of 90000 milliseconds (90 seconds) is configured so that if eWay doesn't return a response within that time-out we will redirected to the payment fail page and show a message which by default is: "Error: Unable to retrieve a valid response from the payment provider. Support has been notified of this issue."

There are a couple of configuration options relating to this system:

Form Post Time-out

1. Login as an administrator
2. Go to the Settings Page (zSettings.aspx)

3. Set a value for the EWay Client Side Form Post Timeout
   

   The value is is milliseconds. So as an example: 90000 would be 90 seconds.

    

Error Message Resource

The error message can be configured using the resource manager. The resource name is "rcEWayReponseNotRetrievable"

To configure the resources:

1. Login as an administrator
2. In the Content sub-menu select Resource Manager
3. Enter "rcEWayReponseNotRetrievable" into the "Search For" text box and search
4. Select the resource and click the "Modify" button
5. Edit the Resource Value field to whatever if appropriate for your needs.

Related articles

• Page:
  Change Placeholder Images