Quick Start
  • 06 Dec 2022
  • 2 Minutes to read
  • Dark

Quick Start

  • Dark

Article Summary


Install the Payments application at the Candy Shop.

Error installing? See our troubleshooting doc here.

Our application does not work with trial organizations.

Complete the Blackthorn Payments Setup Wizard

Salesforce My Domain

In order to go through the Payments Setup Wizard users will need to have My Domain enabled in their org. Read more about My Domain here.

Navigate to the Setup Wizard to start the setup process.

Lightning: Navigate to the app launcher, select "Payments (Admin)" app, and click the "Blackthorn | Payments Setup Wizard" tab.

Classic: Navigate to the application drop-down button (blue button in the upper right-hand corner), select "Payments (Admin)" app, click on the "Blackthorn | Payments Setup Wizard" tab.

Connect to your Payment Gateway account in test mode (which creates a connected Payment Gateway record).

Haven't set up a Payment Gateway account yet? No problem!

When you select the test mode option, a window pops up to create or login to a Payment Gateway account. In Stripe, right above the form, there is a link where you can bypass creating a real account for testing purposes. Authorize.net requires you to create a developer account before hand.

After Payments is installed, the necessary permissions are assigned, and you have completed the setup wizard, the Payments app will be available for the users to access.

Configure Webhooks

Configuring webhooks is a highly suggested, but optional step especially if you want to use:

  • ACH Payment Methods
  • Disputes
  • Payouts
  • Credit Card Updater

Allowlist your Domain for the Virtual Terminal

  1. Go to Setup.
  2. Search for and click "Session Setting".
  3. Under the section Trusted Domains for Inline Frames, click Add Domain.
  4. Enter "https://.lightning.force.com".
Domain Instance Name

For example, if your domain-instance-name is "blackthornio", the new domain will be "https://blackthornio.lightning.force.com". Click Save.

Test Data

To test creating Payment Methods and capturing test Transactions, see our testing documentation for the test card and ACH information.

Deploy to Production

  • Once you have completed testing, create a new Payment Gateway record in live mode. You cannot update the existing test Payment Gateway to live. This will result in an error.
  • If you have refreshed a partial or full sandbox from Production, please create a template that does not include the Payment Gateway object. Otherwise scheduled transactions in production will get recaptured in the sandbox.
Defined the wrong object during the Relationship step?

Navigate to Custom Settings from Setup. Click "Manage" next to the transaction parent custom setting and click "remove" next to the object. Then navigate to the Transaction object and delete the lookup field to that object.

Set Auto-charge Transaction Batch Job Size to "1"

  1. Navigate to Setup
  2. Search for and click "Custom Settings"
  3. Click "Blackthorn Pay - Trigger Settings.
  4. Click Manage.
  5. Click Edit.
  6. Set the Auto-Charge Batch Size = "1".
  7. Click Save.

Optional Settings

We highly suggest turning on the field history tracking for select Transaction and Payment Method fields. This helps with troubleshooting.

Object NameField Name
TransactionTransaction Status
Payment Status
Payment MethodCard Number
Payment Method Status