Custom Settings

Introduction

Custom Settings are used in Blackthorn apps for multiple use cases, such as turning Apex-based features on and off, custom handling around scheduled processes, tracking the status of your onboarding in the setup wizard, and many more.

Blackthorn Pay - Reattempt Settings

Out-of-the-box, Blackthorn | Payments automatically creates and enables a Reattempt Schedule for your failed Transactions.

1. Navigate to Custom Settings.

Lightning/Classic: Setup > In Quick Find, Search and Click: "Custom Settings."

2. Click Manage on Blackthorn Pay - Reattempt Settings.

3. Check Allow on Non-Auto Process if you want to reattempt failed Transactions that don't have auto-process checked.
   If you don't want to reattempt Transactions unless they have the auto-process field checked, then skip this step.

4. Enter a number (of days) for each Attempt field.
   If you enter "1" in each field, each attempt will occur that number of days after the previous attempt. By default, we have entered a "1" from the first to fourth reattempt (reattempting each day for four days).

5. Click Save.

Blackthorn Pay - Trigger Settings

There are many Apex-based validation rules, enabled by default. These Custom Settings serve to disable them.

To Enable

1. Navigate to Custom Settings.

Lightning/Classic: Setup | In Quick Find, Search and Click: "Custom Settings."

2. Click "Manage" next to Blackthorn Pay - Trigger Settings.

Example: Disable Transaction Account/Contact Lookup Setting

When you don't wish to define a Contact/Account on a Transaction, you can disable the related lookups from the Payment Method being populated on the Transaction using a Custom Setting.

To disable this, navigate to setup >Custom Settings >Blackthorn Pay - Trigger Settings > “Disable Transaction Related Lookups“. set to TRUE. This will turn off transaction account/contact based lookup settings.

Blackthorn Pay - Transaction Parents

This Custom Setting correlates to the custom lookup field (Transaction parent) created on the Transaction object.

Add a New Transaction Parent

Adding additional Transaction parents happen in the Setup Wizard under the "Relationships" step.

We do not advise manipulating these records manually.

The most common Transaction parent is Opportunity, but it can be any object or multiple objects. When the object is selected, it creates a Custom Setting record here.
You can go back to the Setup Wizard at any time to add additional objects (Transaction parents).

Blackthorn Pay - Transaction Validations

This Custom Setting includes items that allow user to fine tune Transaction validation rules.

• TR Validate Status Transition - Blocks invalid manual updates of Transaction Status or Payment Status.
• TR Prevent Delete of Record with IDs - Blocks the deletion of Transactions if a Transaction ID is present.
• TR Currency Validation - Blocks Transactions from being saved if the Currency on Transaction and Currency on the associated Authorize.net Payment Gateway do not match.

Next Steps

• Learn more about our Auto-Process and Reattempt Logic.
• Create a Payment Schedule.

Troubleshooting

If you have received an error with your Custom Settings or have a question, please view our Troubleshooting page.. If you still have Custom Setting questions, please contact Blackthorn Support. We're happy to help!