Default Payment Method
  • 06 Aug 2024
  • 3 Minutes to read
  • Dark
    Light

Default Payment Method

  • Dark
    Light

Article summary

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

  1. Install our latest Blackthorn | Payments App.
  2. Update your Contact, Transaction, and Payment Method Layouts to include below-highlighted fields and related lists.

Object: Contact*

FieldsRelated Lists
Default Payment MethodPayment Method
Default Payment GatewayPayment 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*

FieldsRelated Lists
Default Payment MethodPayment 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

FieldsRelated Lists
Default Payment Methodnone

Object: Transaction

FieldsRelated Lists
Don’t Auto-Update Payment Methodnone

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

  1. Navigate to an existing Contact or Account record.
  2. Create New Payment Method.
  3. Select Card/ACH and enter the Payment Method details.
  4. 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.

  1. Navigate to an existing Contact or Account record.
  2. Click on the newest Payment Method.
  3. Check Default Payment Method.
  4. 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 -

  1. When creating a new Transaction or updating an existing Transaction, check the Don't Auto-Update Payment Method.

OR

  1. Navigate to Custom Settings, select Manage next to Blackthorn | Payments triggers and select Disable Update PM Related Transactions checkbox.

H_02_05_update payment method

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.

  1. Verify your Payment Method Records are related to an existing Contact and/or Account.
  2. 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.
  3. 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".
  4. 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

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!