Stripe Basics: Step-by-Step Setup & Sales Flow Guide
Follow this guide to install the Stripe Integration in your ValStorm sandbox, synchronize pricing catalog data, and execute a test transaction from lead creation to paid subscription.
Phase 1: Installation & Onboarding
Step 1: Switch to Your Sandbox Environment
- Log into your ValStorm account.
- In the workspace navigation, switch over to your Sandbox Workspace. This ensures your live data is not affected during testing.
Step 2: Verify Prerequisites
- Open the global search or navigate to the marketplace.
- Confirm that the following apps are already installed:
Step 3: Install the Stripe App
- Go to the marketplace and search for the Stripe Integration app.
- Click Install to kick off the installation in the background.
Step 4: Authenticate with Stripe
- From the Stripe installation panel, click Stripe Onboarding.
- Click the authenticate button. This redirects you to the Stripe Application installation page.
- Log into your Stripe Sandbox account (make sure Stripe is in Test Mode).
- Scroll to the bottom and click Install App in Sandbox.
- Once complete, you will be redirected back to ValStorm with a "Successfully Connected" confirmation banner.
Step 5: Sync Historical Data
- On the onboarding page in ValStorm, click Next to proceed to Step 2.
- Click Sync Historical Data. This pulls any existing Stripe customers, products, and prices into ValStorm in the background. (If you are using a brand new Stripe account, this will finish instantly).
Phase 2: Product & Catalog Setup
Step 6: Create a Product in Stripe
- Open your Stripe Dashboard (Test Mode).
- Go to Product Catalog and click Add Product.
- Name your product (e.g., User License).
- Under Pricing, enter an amount (e.g., $25) and leave it set as Recurring with a Monthly billing period.
- Click Add Product to save it.
Step 7: Verify Sync in ValStorm
- Switch to the Billing Workspace in ValStorm.
- Click on the Products tab.
- Verify that your new product (User License) is present.
- Click into the product and verify that the associated monthly recurring price has synchronized under the related list.
Phase 3: The End-to-End Sales Motion
Step 8: Create and Qualify a Lead
- Switch your ValStorm workspace to B2B Sales.
- Go to Leads and click Create.
- Enter a lead name (e.g., Jane Doe) and a test email address that you have access to (for receiving Stripe invoice receipts).
- Fill out any other relevant details and click Save.
Step 9: Convert the Lead
- On the Lead record, click the Convert button.
- This generates a new ValStorm Opportunity.
- Click through to open the newly created Opportunity.
Step 10: Map a Company & Win the Opportunity
- On the Opportunity page, click Create Company.
- Enter the company name (e.g., Acme Corp) and click Save.
- Move the Opportunity stage to Closed-Won.
- ValStorm will automatically generate a new customer Account for Acme Corp.
Step 11: Verify Stripe Customer ID Creation
- Navigate to your newly generated Account record in ValStorm.
- Notice that the record has automatically generated and populated a unique Stripe Customer ID.
- To confirm, go to your Stripe Dashboard, click on Customers, and verify that Acme Corp is listed there.
- Tip: Edit the customer in Stripe to add their email address to ensure invoice notifications go out correctly.
Phase 4: Subscription Billing & Revenue Verification
Step 12: Subscribe the Customer in Stripe
- In your Stripe Dashboard, navigate to the Acme Corp customer profile.
- Click Create Subscription.
- Under Pricing, add the User License product.
- Update the quantity (e.g., enter
5 licenses for a total of $125/month).
- Scroll down to payment methods. Since this is a test environment, select Add Test Payment Method and fill in test card details.
- Choose Automatically charge payment method on file and click Create Subscription.
Step 13: Verify Active Subscription in ValStorm
- Return to ValStorm and navigate to the Subscriptions tab.
- Verify that a subscription record has appeared for Acme Corp.
- Open the subscription and verify that the status is marked as Active.
Step 14: Verify Paid Invoice Sync
- In ValStorm, navigate back to the Acme Corp Account page.
- Click on the Invoices related list.
- Verify that the synced Stripe invoice is listed showing a total of $125.00 with the status marked as Paid.
Step 15: View Invoiced Revenue on Dashboard
- Use the ValStorm global search to search for and open the Dashboard workspace.
- Click on the Invoicing dashboard.
- Verify that the $125 in revenue is captured on your chart for the month of July and attributed to Acme Corp under your top customers ledger.