Installation
Install the payments application
Error installing? See our troubleshooting doc here.
Our applications does not work with trial organizations.
1. Complete the Blackthorn Payments Setup Wizard
We provide a setup wizard to help you get set up with our app quickly.
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
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.
This is a highly suggested, but optional step especially if you are wanting to use:
- ACH Payment Methods
- Disputes
- Payouts
- Credit Card Updater
3. Whitelist your domain for the virtual terminal
Go to Setup > Session setting. Under the section Whitelisted Domains for Visualforce Inline Frames - Click Add Domain.
Enter https://<domain-instance-name>.lightning.force.com
.
Domain Instance Name
For example, if your
domain-instance-name
is "blackthornio", the new domain will behttps://blackthornio.lightning.force.com
. Click Save.
4. Test data
- To test creating payment methods and capturing test transactions, see our testing documentation for the test card and ACH information.
5. Deploying 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, click "remove" next to the object. Then navigate to the transaction object and delete the lookup field to that object.
6. Set Auto-charge transaction batch job size to 1
Navigate to Setup >Custom settings > Blackthorn | Payments Triggers > Manage->Edit > Set the Auto-Charge Batch Size = 1 and Save.
- Optional Settings
We highly suggest turning on the field history tracking for select Transaction and Payment Method fields. This helps with troubleshooting.
Object Name | Field Name |
---|---|
Transaction | Transaction Status |
Payment Method | Card Number |
Updated 2 months ago