Using TouchNet Payment Provider with Aeon

Follow

Support for the TouchNet payment provider has been added in Aeon 4.0. This document will explain the settings and page customizations necessary to configure Aeon to use this feature.

TouchNet Settings

TouchNet should provide the following values to the customer, which will be referred to in the rest of this document.

  • T-Link URL - You should receive a T-Link URL for both testing and production.
  • uPay URL - You should receive a uPay URL for both testing and production.
  • Site ID
  • Authentication details
    • T-Link Username
    • T-Link Password

Customization Keys

The following customization keys should be set with the given values.

  • PaymentProvider - "TouchNet"
  • PaymentProviderMerchantId - **T-Link Username**
  • PaymentProviderToken - **T-Link Password**

The following customization keys are not used in TouchNet integration.

  • PaymentProviderResponseToken
  • PaymentProviderTestModeEnabled
    • When testing integration, you should use the test URLs for the T-Link and uPay endpoints on the web pages. When ready to go live, these should be replaced with their production versions. 

Web Pages Customizations

There are two feature-specific web pages for TouchNet integration: CreditCardPayment.html and CreditCardPaymentConfirmation.html. TouchNet differs slightly from other payment providers in that it does not complete payments on the TouchNet web page. Instead, it simply gathers payment details and returns the user to your CreditCardPaymentConfirmation page, where the user can confirm the transaction amount and complete the payment. 

CreditCardPayment.html

In the ajax call to generate a ticket to submit to uPay, there are some parameters that are configurable. You can find the section to modify by searching for the string "GenerateTouchNetTicket" and then looking for the "data" section a couple of lines below.

  • tlinkUrl - This is the URL of the T-Link web service and should be set to your **T-Link URL**. The default page has a placeholder value of "https://your.tlink.url".
  • transactionNumbers - This value passes the list of applicable requests back to Aeon and should not be modified from its default value of "<#PARAM name='TransactionNumbers'>".
  • ticketName - The name of the ticket for reporting purposes, in order to distinguish Aeon payments from those submitted by other systems. This value must exactly match the ticket name in the form section of this page (see below). The value in the default page is "Aeon Reproductions".
  • successLink - The Aeon URL that the user will be returned to after successfully filling out their payment details. The default value is "<#CUSTOMIZATION name='WebURL'>aeon.dll?action=30&type=112". This generally shouldn't need to be changed unless a site needs to ensure users are returned to a particular web directory that may differ from where the request was initiated.
  • errorLink - The Aeon URL that the user will be returned to in the event an error occurs on the TouchNet payment page. The default value is "<#CUSTOMIZATION name='WebURL'>aeon.dll?action=30&type=112". This generally shouldn't need to be changed unless a site needs to ensure users are returned to a particular web directory that may differ from where the request was initiated.
  • cancelLink - The Aeon URL that the user will be returned to if they choose to cancel the process on the TouchNet payment page. The default value is "<#CUSTOMIZATION name='WebURL'>aeon.dll?action=30&type=112". This generally shouldn't need to be changed unless a site needs to ensure users are returned to a particular web directory that may differ from where the request was initiated.

There are some configurations that need to be made to the form. You can find the form by looking for the <form> element that has an ID of "paymentform".

  • action - The action attribute in the <form> element needs to be set your **uPay URL**. The default page has a placeholder value of "https://your.upay.url".
  • TICKET - This input value should be left blank. It will be populated with the ticket that is retrieved by the ajax call to the T-Link URL that occurs when the user clicks the "Pay Now" button.
  • TICKET_NAME - This input specifies the name of the ticket for reporting purposes. This value must exactly match the ticket name in the ajax section of this page (see above). The value in the default page is "Aeon Reproductions".
  • UPAY_SITE_ID - This input should contain your **Site ID**. The default page has a placeholder value of "YourSiteID"

CreditCardPaymentConfirmation.html

The only form input that should be modified on this page is for TLinkURL, which should be set to your **T-Link URL** as on the previous page. The default page has a placeholder value of "https://your.tlink.url". The remaining inputs must be left with their default values.

  • AeonForm - CreditCardPaymentConfirmation
  • SessionID - <#PARAM name="SessionID">
  • PaymentSessionID - <#PARAM name="PaymentSessionID">
  • PaymentInvoiceID - <#PARAM name="PaymentInvoiceID">

 

Questions?

If this article didn’t resolve your issue, please take a moment and answer a few questions to help improve our documentation:

Feedback