TouchNet

Overview

Looking for TouchNet? You've come to the right place! We officially support TouchNet for our Events checkout only. Let's take a look at what you'll need to configure the TouchNet Payment Gateway, prepare a Salesforce org, and configure and enable the gateway.

Requirements

A dedicated TouchNet UPay site connected to Blackthorn is required to configure Blackthorn Events to use TouchNet for payments. With a properly configured UPay site, the following information is required to configure a TouchNet Payment Gateway.

• T-Link Service URL
• UPay Site ID
• UPay Site URL

Prepare TouchNet for Blackthorn

TouchNet uPay Site Setup

1. In the top navigation bar, go to Applications > Marketplace.
2. Click Touchnet Ready > uPay Sites > Payment Settings.
3. Set Site Uses T-Link = "Yes".
4. Set Partner Name = "Blackthorn Events".
   

Prepare your Salesforce Org for TouchNet

Add a TouchNet Payment Provider

The value "TouchNet" must be added to the existing Provider picklist field (bt_stripe__Provider__c) on the packaged Payment Gateway object (bt_stripe__Payment_Gateway__c).

1. Navigate to: Object Manager > Payment Gateway > Fields and Relationships > Provider
2. In the Values section, click New.
3. Enter “TouchNet” and click Save.

Add Custom Fields to the Payment Gateway

The following fields must be added to the Payment Gateway object (bt_stripe__Payment_Gateway__c):

• Field Name: TouchNet T-Link URL
  API Name: TouchNet_T_Link_URL__c
  Data Type: Text(255)
  Description: Service endpoint for the TouchNet T-Link web service

• Field Name: TouchNet uPay Site ID
  API Name: TouchNet_uPay_Site_ID__c
  Data Type: Text(15)
  Description: A numeric non-negative integer value that identifies the UPay site responsible for processing the transaction

• Field Name: TouchNet uPay Site URL
  API Name: TouchNet_uPay_Site_URL__c
  Data Type: Text(255)
  Description: Corresponding UPay Site URL for the given UPay Site ID

• Field Name: TouchNet uPay Form Parameters
  API Name: TouchNet_uPay_Form_Parameters__c
  Data Type: Long Text(32768)
  Description: Key/value pairs to submit to UPay as additional form parameters. Each key/value must be separated by a new line with each line formatted as "MY_PARAMETER_KEY=Some value"

Assign Field Level Security permissions for the new fields to the Salesforce User account used by the Blackthorn external service.

Enable TouchNet Payment Gateway Support

Create the Form Parameter in TouchNet

If you need to create the new parameter, go to Marketplace Home > TouchNet Ready > UPay Sites > Blackthorn > Form Parameters.

1. Open your UPay site.

2. Click Form Parameters in the left-hand column.
   

3. Add the EVENT_ID parameter to track the individual Event.
   NOTE: The TRANSACTION_ID is also supported.

4. To view the posted IDs navigate to TouchNet > Marketplace > Marketplace Reports > Posted Parameters.
   

Once an Attendee pays for the Event, the EVENT_ID value is then passed through to TouchNet.

Using TouchNet in an Experience Cloud

If a user tries to use TouchNet in an Experience Cloud, they will see the following error because the TouchNet domain was blocked from loading. "This content is blocked error".

To avoid this issue, complete the steps below.

1. Go to Setup.
2. In the Quick Find box, search for and click “Trusted URLs.”
3. Click New Trusted URL.
4. Enter an API Name.
5. Set URL = “https://test.secure.touchnet.net:8443/”
6. Set connect-src (scripts) = “True” (checked)
7. Set frame-src (iframe content) = “True” (checked)
   
8. Review the other settings as needed.
9. Click Save.

TouchNet checkout will now load correctly on the Experience Cloud Event registration page.

Other Helpful Information

How to Test

For testing purposes, create a TouchNet Payment Gateway and use the following values:

Use the TouchNet Payment Gateway with any Event and perform a normal (paid) checkout. You should be able to successfully complete a checkout as well as perform failing checkouts that should be handled appropriately.

Use the following test card numbers:

Update Payment Details

To update any Payments settings (required fields, supported cards, ...), go to Applications > MarketPlace Home > TouchNet Ready > UPay Sites > Blackthorn > Payment Settings.

Now you can see all available options on the Blackthorn: Payment Settings form.