Additional Configuration

Add Mobile Pay Action to Transaction Page Layout

The Mobile Pay action can be added to the Transaction Page Layout to link from the Field Service Lightning mobile app to the Blackthorn Mobile Pay app. This is useful for Field Service Lightning mobile app users that want to take a mobile payment. Follow these setup steps to enable:

  1. In Salesforce go to Setup - Customize - Custom Objects and click on the Transaction object.

  2. On the Transaction object, create a custom formula field, give it any name you'd like, such as "Mobile Pay" and use this formula:

HYPERLINK("btmobilepmt://mobilepayments.blackthorn.io/transaction?id=" & Id & "&orgid=" & $Organization.Id & "&app=fieldService","Mobile Pay")
  1. Add this field to Charge Transaction Layout and save. That will create the below hyperlinked field in your mobile app. You can use this approach and/or the below App Extension to launch Blackthorn Mobile Payments from FSL Mobile.

Create an App Extension

Create an App Extension for each mobile app device type (iOS and/or Android) that you support. This creates (on iOS) the blue lightning bolt button action for a single button click from the Work Order. It's a two step configuration once our FSL extension package is installed.

  1. Navigate to Field Service Mobile Settings in Setup.
  2. In the section titled App Extension click the Add button.
  3. Add required fields similar to what is displayed in the screenshot below.
  1. Copy/paste the below text into the Launch Value field shown above.
btmobilepmt://mobilepayments.blackthorn.io/transaction?id={!btfslmobileext__Open_Charge_Record_Id__c}&orgid=$Organization.Id&app=fieldService
  1. Click Save to add the App Extension.

Once completed, the App Extension will show up in the FSL mobile app. Be sure to clear your cached data for the button to appear. You may have to log out and then log back in.


Did this page help you?