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
Preparing TouchNet for Blackthorn
TouchNet uPay Site Setup
- In the top navigation bar, go to Applications > Marketplace.
- Click Touchnet Ready > uPay Sites > Payment Settings.
- For "Site Uses T-Link", select "Yes".
- Add "Blackthorn Events" for the Partner Name.


Contact TouchNet
Important: Before the integration with Blackthorn can be officially supported, you must contact TouchNet to open a partner connection project.
Preparing your Salesforce Org for TouchNet
Adding 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
).
Adding Custom Fields to the Payment Gateway
The following fields must be added to the packaged 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.
Enabling TouchNet Payment Gateway Support
-
Create a new Payment Gateway and set its
Provider
to "TouchNet". -
Take the T-Link Service URL and uPay Site Details and fill out the corresponding fields in the Payment Gateway.
-
Assign the Payment Gateway to an Event.
-
Add license metadata for
CUSTOM_SCHEMA
with the value of "touchnet". -
Re-provision the org's schema by visiting an Event and performing a "Hard Refresh".
Creating the Form Parameter in TouchNet
If you need to create the new parameter, go to Marketplace Home > TouchNet Ready > Upay Sites > Blackthorn > Form Parameters.
-
Open your UPay site.
-
Click Form Parameters in the left-hand column.


- Add in the
EVENT_ID
parameter to track the individual Event.
NOTE: TRANSACTION_ID
is also supported.
- 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:
Field | Value |
---|---|
TouchNet uPay Site ID | 242 |
TouchNet uPay Site URL | https://test.secure.touchnet.net:8443/C30002test_upay/web/index.jsp |
TouchNet uPay Form Parameters | DEPARTMENT=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:
Brand | Number | CVC/CVV | Expiration Date |
---|---|---|---|
Visa | 4111111111111111 | 125 | Any future date |
American Express | 343434343434343 | 1250 | Any future date |
Discover | 6011111111111117 | 125 | Any future date |
Mastercard | 5121212121212124 | 125 | Any future date |
Updating 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.


Updated 2 months ago