TouchNet

Overview

Looking for TouchNet? You've come to the right place! We officially support TouchNet for our Eventss 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 Eventss 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. For "Site Uses T-Link", select "Yes".
4. Add "Blackthorn Events" for the Partner Name.
   

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

1. Create a new Payment Gateway and set its Provider to "TouchNet".
2. Take the T-Link Service URL and UPay Site Details and fill out the corresponding fields in the Payment Gateway.
3. Assign the Payment Gateway to an Event.
4. Add license metadata for CUSTOM_SCHEMA with the value of "TouchNet".
5. Re-provision the org's schema by visiting an Event and performing a "Hard Refresh".

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 in the EVENT_ID parameter to track the individual Event.
   NOTE: 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.

Other Helpful Information

What is supported?

• Events checkout only
• Support the ability to pass the "department" to the T-Link endpoint (a unique thing to t-link, like metadata)

What is not supported?

• Webhooks
• Virtual Terminal
• Salesforce refunds or charges
• PayLink / DocumentLink

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.