Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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 payment's status might need to be manually re-tested and payment completed if payment was successful. This is done via the new 'CustPaymentStatusRecheck.aspx' page. 

Info
Warning

Min Minimum version required - 3.67.13

 

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 customizationscustomisations.The steps to setup this functionality are

To set up Payment Retry Functionality:

  1. Login as an

...

  1. Administrator.
  2. Navigate to 'Content' --> 'Menu Editor' (/zMenus.aspx).
  3. Select the

...

  1. required Role via radio button. 

    Warning

...

  1. This page should only

...

  1. be made accessible to Administrator role(s)

  2. Click 'Parent Items'.

  3. Select a top level menu item

...

  1. under which to add the page (or create a new menu item

...

  1. where the new page will be

...

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

Warning

You should make sure you select "Requires Authentication"

...

  1. set up).
  2. Click 'New'.
  3. Enter 'CustPaymentStatusRecheck.aspx' for the 'Page Name' and populate the remaining fields as required. See Adding a new menu item for further information.

    Warning

    Ensure the 'Requires Authentication' flag is ticked.

  4. Click 'OK' to save.

Using the CustPaymentStatusRecheck.aspx Page

To get to Use the Customer Payment Status Recheck page you need tofunction:

  1. Login with an account that has access to the role you created the menu item for.

...

  1. Navigate to the new page

...

  1. via the menu

...

  1. (/CustPaymentStatusRecheck.aspx

...

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

  1. ).
  2. The page will

...

  1. load, listing any outstanding eWay customer payment records.

...

  1. Click 'Retry Payment Finalization

...

  1. ' to re-

...

  1. determine whether the payment

...

  1. was

...

  1. 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).
    Image Modified 
  2. The success/fail/indeterminate status of the payments will be shown underneath the payment record table

...

  1. after processing is complete. Any indeterminate payments will remain in the table and can be re-tried at a later time.
    Image Modified 

...

 

Customisation

After a customer has entered their credit card information and clicked submit CSS , Customer Self Service 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 redirect 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 several configuration options relating to this system:

To Update the Form Post

...

Timeout Setting:

  1. Login as an

...

  1. Administrator.

...

  1. Navigate to 'Settings' --> 'Settings' (/zSettings.aspx)
  2. Set a value for

...

  1. 'EWay Client Side Form Post Timeout'.

    Note

...

  1. This value is

...

  1. in milliseconds. So as an example

...

  1. , 90000 would be 90 seconds.

     

...

Error Message Resource
  1. Click the 'Update' button to save changes.

 

The error message can be configured using the resource manager. The resource name is "rcEWayReponseNotRetrievable"To configure the resourcesvia Resource Manager. 

To Configure the Error Message Resource:

  1. Login as an

...

  1. Administrator.
  2. Navigate to 'Settings' --> 'Resource Manager' (/zResourceMaintenance.aspx).
  3. Enter 'rcEWayReponseNotRetrievable' into the 'Search For' text box and search.
  4. Select the

...

  1. record via radio button. 
  2. Click 'Modify'.
  3. Update the value as required.
  4. Click 'OK' to save.

 

Content by Label
showLabelsfalse
max5
spacesKB
sortmodified
showSpacefalse
reversetrue
typepage
labelskb-how-to-article

...