TouchNet
  • 29 Jan 2024
  • 3 Minutes to read
  • Dark
    Light

TouchNet

  • Dark
    Light

Article Summary

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. For "Site Uses T-Link", select "Yes".
  4. Add "Blackthorn Events" for the Partner Name.
    Prepare Touchnet for Blackthorn
IMPORTANT: Contact TouchNet

Before the integration with Blackthorn can be officially supported, you must contact TouchNet to open a partner connection project.

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 a Store 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.
    Create Form Parameter 1

  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.
    Create Form Parameter 2

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

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:

FieldValue
TouchNet UPay Site ID242
TouchNet UPay Site URLhttps://test.secure.touchnet.net:8443/C30002test_upay/web/index.jsp
TouchNet uPay Form ParametersDEPARTMENT=any

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:

BrandNumberCVC/CVVExpiration Date
Visa4111111111111111125Any future date
American Express3434343434343431250Any future date
Discover6011111111111117125Any future date
Mastercard5121212121212124125Any future date

Update Payment Details

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

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