- 06 Aug 2024
- 3 Minutes to read
- Print
- DarkLight
Default Payment Method
- Updated on 06 Aug 2024
- 3 Minutes to read
- Print
- DarkLight
Feature Overview
- Have the ability to define your Default Payment Method for any given Contact and/or Account Record.
- Automatically set the latest default payment method on all related "Open" Transactions.
For example: If a customer has updated their payment method, all un-processed transactions will automatically update with the newest Payment Method. - Update default Payment Methods in Stripe and they will sync back to Salesforce with the setup of Webhooks.
Scope
- Default payment method is supported for both Card and ACH payment methods types.
- Ability to automatically default the Payment Method lookup field on a Transaction record is coming soon.
Prerequisite
- Install our latest Blackthorn | Payments App.
- Update your Contact, Transaction, and Payment Method Layouts to include below-highlighted fields and related lists.
Object: Contact*
Fields | Related Lists |
---|---|
Default Payment Method | Payment Method |
Default Payment Gateway | Payment Gateway Customers |
Transactions |
*Including the related lists for Contact/Account will provide insights into your Contact/Account’s related Stripe Customers, Transactions, and Payment Methods records.
Object: Account*
Fields | Related Lists |
---|---|
Default Payment Method | Payment Method |
Payment Gateway Customers | |
Transactions |
*Including the related lists for Contact/Account will provide insights into your Contact/Account’s related Stripe Customers, Transactions, and Payment Methods records.
Object: Payment Method
Fields | Related Lists |
---|---|
Default Payment Method | none |
Object: Transaction
Fields | Related Lists |
---|---|
Don’t Auto-Update Payment Method | none |
When adding the Payment Method related list on your Contact and/or Account record, edit the related list settings to include the Default Payment Method
Checkbox field.
Setup
Create a Default Payment Method
- Navigate to an existing Contact or Account record.
- Create New Payment Method.
- Select Card/ACH and enter the Payment Method details.
- Click Save.
If this is the first Payment Method for your Contact and/or Account, the Default Payment Method checkbox will be selected automatically.
If your Contact/Account has multiple Payment Method records, you will need to manually check the Default Payment Method field to define your default Payment Method.
Auto-Update "Open" Transaction's Payment Method
Our default Payment Method logic automatically updates related "Open" Transactions to the latest default Payment Method.
- Navigate to an existing Contact or Account record.
- Click on the newest Payment Method.
- Check
Default Payment Method
. - Navigate to all "Related To" Transactions.
You will see all "Open" Transactions have updated to the newest default Payment Method.
You are all set!
Don't wish to update all related Transactions to the latest default Payment Method?
Example scenario -If you have a customer paying for only one transaction where the Payment Method should not update to the default Payment Method.
You can do one of the below two things -
- When creating a new Transaction or updating an existing Transaction, check the
Don't Auto-Update Payment Method
.
OR
- Navigate to Custom Settings, select
Manage
next to Blackthorn | Payments triggers and selectDisable Update PM Related Transactions
checkbox.
This will disable updating the Payment Method on related transaction/s.
Update Existing Payment Method Records to set the Default Payment Method
If you have been using Blackthorn | Payments now is the time to update your records in Salesforce for this feature!
You can update records via Salesforce Data Loader.
- Verify your Payment Method Records are related to an existing Contact and/or Account.
- When you set the related Contact and/or Account, the Payment Gateway Customer record will also update with that related Contact and/or Account automatically.
- Run a report of all Payment Gateway Customer records that have a related Payment Method record. From that list determine which Payment Method's should be marked as the "Default Payment Method".
- Set those Payment Method records
Default Payment Method
checkbox field=True.
If you don't want the related Transaction's Payment Method to update, disable this feature in Custom Settings while doing the initial update of historical records.
Next Steps
- Understand how Transactions are processed.
- Use Payment Schedules to create future looking Transactions in minutes.
- Learn about our supported Payment Methods.
Troubleshooting
If you have received an error with your Default Payment Method Feature or have a question, please view our Troubleshooting or FAQ page. If you still have Default Payment Method questions, please contact Blackthorn Support. We're happy to help!