Step-by-Step Instructions
  • 13 Jul 2022
  • 2 Minutes to read
  • Dark

Step-by-Step Instructions

  • Dark

Initial Setup

  1. Install Blackthorn Payments from the Candy Shop.
  2. Complete the Payments Setup Wizard and connect to your Stripe account in test mode.
    Webhooks are required for Stripe Billing.
  3. Send Blackthorn Support your org ID to enable Stripe Billing.
  4. Once enabled, navigate to the Payments Admin tab, under Stripe Billing, click the "Deploy Stripe Billing Fields" button.
  5. Follow these instructions and install the Stripe Billing Screen Flow unmanaged package.
    This unmanaged package allows you to launch a screen flow from the Opportunity record when a subscription needs to be generated.

When you set up webhooks, changes that are made in Stripe will push to Salesforce, so please have your relationship settings defined on the Payment Gateway before enabling webhooks.

If you only have Products and Prices (Plans) in Stripe

This information needs to be in Salesforce so that you can generate subscriptions in Salesforce.

  1. Navigate to your test Payment Gateway record.
  2. Click the "Sync With Stripe" button.
  3. Underneath "Billing," click Product. Let all products sync before clicking the "Prices" button.
  4. Then click the "Prices" button. Let all Prices sync before clicking the "Coupon" button.
  5. Then click the "Coupons" button.

If you have Products in Salesforce, but nothing in Stripe

Please follow the instructions for syncing a Product to Stripe.

Then you can create a Price for the Product that syncs to Stripe.

Time to test it out!

You should be able to create a subscription from an Opportunity record that syncs over to Stripe. After 1 hour (not sure why it takes so long on the Stripe side), an invoice will sync back to Salesforce related to the Subscription, Customer, and Account record.

Testing other scenarios

Give your billing scenarios a test. IE., upgrading or downgrading an existing subscription. This update will only work for future invoices. If you change a subscription when there is an open invoice, the open invoice will not be updated.

Please reach out Blackthorn Support if you have questions regarding use cases. Our team uses the feature for our app subscriptions!

Migrating Records from Stripe to Salesforce

  • Go to the Payment Gateway tab, click on your Payment Gateway. Click Sync with Stripe.
  • Make sure you have Account and Contact records in your Salesforce org that align with your Stripe records. We attempt to match Stripe Customer Emails against Contact Emails using the relationship setting feature.
  • Click each button from left to right, one at a time, waiting for the process to finish as viewed in Setup | Apex Jobs. Start with Customers.
No Matching

If you need to match Payment Gateway Customers (Stripe Customers) to Contacts and Accounts with custom matching IE., Billing ID, relate the Relationship Setting to the Payment Gateway record, and then for the matching logic, set it to "No Matching or Record Creation.

What's Next