Custom Settings
  • 13 Jul 2022
  • 2 Minutes to read
  • Dark

Custom Settings

  • Dark

We've included the ability to modify how you use the Virtual Terminal in Custom Settings. The following settings will give your organization more flexibility when it comes to adding payment details to a record and charging Transactions.

J_02_01_Custom Settings pic 1


  • Default New Payment Method - This setting will set the "New Payment Method" option as the default option on the Action menu.
  • Disable Amount - This setting will prevent users from populating the Amount field in the Virtual Terminal.
  • Disable New Charge - This setting will remove the "New Single Charge" option from the Action menu.
  • Disable New Payment Method - This setting will remove the "New Payment Method" option from the Action menu.
  • Disable Payment Gateway - This setting, when enabled, renders the Payment Gateway field as Read-Only.Note: The Payment Gateway field is only visible in orgs with multiple Payment Gateways.
  • Disable Related To - This setting will make the Related To field read-only.
  • Hide Parent - This setting will remove the Parent Object field from the Virtual Terminal.
  • Hide Process Type - This setting sets the Process Type selection to "Capture Now" and removes the picklist from the Virtual Terminal.
  • Hide Related To - This setting removes the field Related To from the Virtual Terminal.
  • Payment Method Success Message When a value is added to this setting it is used as the text in the success message box that appears when a Payment Method is created in the Virtual Terminal.
  • Transaction Success Message - When a value is added to this setting it is used as the text in the success message box that appears when a Transaction is captured in the Virtual Terminal.
  • Related To Default Object - The object added to this field (Account, Contact, or Lead) will be the object that displays first in the Related To field on the Virtual Terminal.
  • Disable Payment Method Filter - When this is checked all the Payment Methods will be loaded regardless of the Contact/Account set in Virtual Terminal. This setting will take into consideration sharing rules. If a user does not have access to a Payment Method they will not see it as an option in Virtual Terminal.

If your org has Custom Metadata Types for Virtual Terminal Mapping set you'll need to manage those records because they could conflict with the Related To Default Object setting.

Examples might include the following Virtual Terminal Mappings:SD.BillTo (Con) -> Trans.ContactOppty.Account -> Trans.Account

If values are set in the Target Field for the 2 mappings mentioned above those values will take priority over the values you attempt to save in the Related To Default Object Custom Setting.

Steps to Enable

  1. Navigate to "Setup".
  2. Type "Custom Settings" in the Quick Find menu and click "Custom Settings".
  3. Click "Blackthorn Payments - Virtual Terminal".
  4. Click the Manage button.
  5. Click the Edit button.
  6. Use the checkboxes to enable one or multiple settings.
  7. Click Save.
Deprecated Settings

Be aware that the following settings are deprecated: Terminal Disable New ChargeTerminal Default New Payment Method, and Terminal Disable New Payment Method. If you were utilizing these settings be sure to use Disable New ChargeDefault New Payment Method, and Disable New Payment Method instead.

Remove Deprecated Custom Settings

Once we have removed a Custom Setting from our package you will no longer be able to use it. If this is a setting you used in the past you can delete it from your org as a matter of cleanup purposes.

Steps for Removing a Custom Setting:

  1. Navigate to the Custom Settings in Setup
  2. Click the subset of settings you would like to cleanup (i.e. Blackthorn Payments | Virtual Terminal)
  3. If the setting has a link labeled Del to the left this means it has been removed from the package. Click Del to remove.
  4. A dialog box with additional details will be presented. Use the checkbox to confirm you would like to delete the setting and click Delete.

J_02_01_Custom Settings pic 2

J_02_01_Custom Settings pic 3

What's Next