Install & Setup
  • 27 Sep 2023
  • 2 Minutes to read
  • Dark

Install & Setup

  • Dark

Article Summary

Package Install

  1. Install the latest version of Blackthorn Payments and complete the setup wizard.
  2. Install the Blackthorn Mobile Payments package in a sandbox or production and assign licenses to all users that need access.
  3. Install our iOS app.

Add Mobile Pay Action to Transaction Page Layout

The Mobile Pay action can be added to the Transaction page layout to link the Salesforce mobile app to the Blackthorn Mobile Payments app. This allows Salesforce mobile app users to take a mobile payment.

Follow the steps below to add the Mobile Pay action to the Transaction page layout.

  1. In Salesforce, click the Gear icon to go to Setup.
  2. Click the Object Manager tab.
  3. In the Quick Find box, search for and click the Transaction object.
  4. Click the Page Layouts tab.
  5. Click the Charge Transaction Layout.
  6. Click the Mobile & Lightning Actions tab.
  7. Drag and drop the Mobile Pay action in the Salesforce Mobile and Lightning Experience Actions section.
  8. Click Save.

Enable Send Receipt Email in Salesforce

After a mobile transaction is complete, Salesforce can send a receipt via email to the customer if the Receipt Email field is populated AND the Transaction Status = “Completed”.

Follow the steps below to enable this feature.

  1. In Salesforce, go to Setup > Workflow Rules.
  2. Click Activate next to "Send Blackthorn | Payments Receipt (Text)".

Card Reader Firmware Updates


Stripe users need to add locations to their Stripe dashboard before upgrading their iOS mobile devices to the latest version. If the locations are not added first, users will be unable to connect to a Stripe card reader.

We've added the ability to update your card reader firmware inside the Mobile Payments app.

  1. Navigate to the Reader screen.
  2. Connect your reader.
  3. Notice that while connecting the reader, we are checking for firmware updates.
  4. If your reader has a firmware update available, a link to install the update will appear.
  5. Follow the on-screen prompts to install the update.
Connecting a Stripe Card Reader

When connecting a Stripe card reader, a modal screen will appear on the Mobile Payments app to ask for Bluetooth permissions for the following new permissions in Android 12 or higher.

  • BLUETOOTH_CONNECT: required to connect to paired Bluetooth devices.
  • BLUETOOTH_SCAN: required to scan and pair nearby Bluetooth devices.
  • BLUETOOTH_ADVERTISE: required to advertise to nearby Bluetooth devices.

Save Card Details with the Stripe Terminal

There are two options for collecting reusable card details with Stripe Terminal. Please click one of the options below for specific instructions from Stripe.


If you need to determine which software version was used for a Transaction, add the Mobile App Version field to your Transaction object. The Mobile App Version will automatically populate with the application platform name (iOS or Android) and the version number.

If you have any questions about the setup process, please contact Blackthorn Support. We're happy to help!