Additional Configuration
  • 04 Apr 2023
  • 1 Minute to read
  • Dark
    Light

Additional Configuration

  • Dark
    Light

Article Summary

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 (FSL) Mobile app to the Blackthorn Mobile Payments app. This is useful for FSL Mobile app users that want to accept a mobile payment.

Complete the following setup steps to enable the feature.

  1. In Salesforce go to Setup > Customize > Custom Objects.
  2. Click on the Transaction object.
  3. On the Transaction object, create a custom formula field.
  4. 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 the new field to the Charge Transaction layout.
  2. Click Save.
    This will create a hyperlinked field in your mobile app. You can use this approach and/or the App Extension below to launch Blackthorn Mobile Payments app from the FSL Mobile app.
    P_04 add config 1

Create an App Extension

Create an App Extension for each mobile app device type (iOS and/or Android) that you support. On iOS, this creates 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.
P_04 add config 2

  1. Navigate to Field Service Mobile Settings in Setup.

  2. In the section titled "App Extension," click the Add button.

  3. Add the required fields. They will be similar to what is displayed in the screenshot below.
    P_04 add config 3

  4. Copy/paste the text below 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 also have to log out and log in.

Disable the Creation of Transactions from a Work Order

To prevent the automatic creation of Transaction from a Work Order, the "Disable Transaction Create From WO" custom setting was added to the Blackthorn Payments | FSL Settings. 

Follow the steps below to disable the automatic creation of Transaction from a Work Order.

  1. Go to Custom Settings.
  2. Click on Blackthorn Payments | FSL Settings.
  3. Click New.
  4. Set Disable Transaction Create From WO = “True”.
  5. Click Save.