OceanDrive
Docs/Stripe & Funnel Checkout
Payments · 6 min read

Stripe & Funnel Checkout Setup

This guide walks you through connecting your Stripe account to OceanDrive, creating a product with a price, adding a checkout button to your funnel, testing the flow, and going live so real customers can pay you.

1

How it works

OceanDrive uses Stripe Connect — this means your customers pay you directly. Money goes to your Stripe account, not through OceanDrive. OceanDrive connects as a platform to create checkout sessions on your behalf.

Payment flow
1
Customer lands on your funnel
They find your published funnel URL and click the checkout button you added.
2
Stripe Checkout opens
A secure Stripe-hosted payment page opens with your product details and price.
3
Customer pays
They enter their card details. Stripe handles PCI compliance, fraud detection, and 3DS.
4
Webhook fires
Stripe sends a checkout.session.completed event to OceanDrive's webhook endpoint.
5
OceanDrive processes
An Order is created, the buyer becomes a Lead, they're enrolled in your delivery email sequence, and affiliate commission is recorded if applicable.
6
Customer lands on thank-you page
They're redirected to your funnel's success path — usually a thank-you page.
For subscription products, every renewal fires invoice.paid which resets the subscriber's access and sends them a credits-reset email automatically. Cancellations trigger a downgrade to Trial without any manual intervention.
2

Connect Stripe

Stripe Connect is a one-time setup per workspace. You only do this once, and it covers all funnels in your workspace.

  1. 1
    Open Settings
    In OceanDrive, go to Settings → Integrations.
  2. 2
    Find Stripe Connect
    Scroll to the Stripe Connect section. You'll see a "Connect Stripe" button.
  3. 3
    Click Connect Stripe
    You'll be redirected to Stripe's onboarding flow. Log in to your existing Stripe account or create a new one.
  4. 4
    Complete Stripe onboarding
    Stripe will ask you to confirm your integration choices (funds flow, account creation, account management, and liability). See below for the correct selections for OceanDrive.
  5. 5
    Return to OceanDrive
    After completing Stripe's flow you'll be redirected back. The Integrations page will show Stripe as Connected with charges enabled.
Correct Stripe Connect settings
Funds flowSellers will collect payments directly

Customers pay you directly into your Stripe account. For marketplace setups, choose "Platform will collect payments then pay out sellers".

Account creationOnboarding hosted by Stripe

Stripe handles all compliance and ID verification for connected accounts — no extra work needed from you.

Account managementStripe Dashboard

Sellers and affiliates manage their own Stripe account directly via stripe.com.

Liability (negative balances)Stripe (recommended)

Stripe manages risk and covers fraud losses. Strongly recommended for new platforms.

Common error: "Please review the responsibilities of managing losses." This means Stripe needs you to complete your platform profile before connecting. Go to dashboard.stripe.com/settings/connect/platform/profile and confirm your integration choices, then return to OceanDrive and try Connect Stripe again.
3

Create a Product & Price in Stripe

Before adding a checkout button to your funnel, you need a product and price set up in your Stripe dashboard. OceanDrive reads your prices directly from Stripe — you don't create them inside OceanDrive.

  1. 1
    Go to Stripe Product Catalog
    In your Stripe dashboard, go to Products → + Add product (or visit dashboard.stripe.com/products).
  2. 2
    Name your product
    Give it a clear name — this appears in Stripe and in your order records in OceanDrive. e.g. "Monthly Coaching Program" or "OceanDrive Pro Plan".
  3. 3
    Set the pricing
    Choose Recurring (for subscriptions) or One time (for one-off purchases). Set the amount and currency.
  4. 4
    Save and copy the Price ID
    After saving, click on the price row to reveal the Price ID — it looks like price_1ABC123... Copy this. You'll paste it into your funnel checkout element.
What a Price ID looks like
price_1ABC123xyzDEF456ghi789
For subscription products the Price ID is on the price, not the product. Make sure you're copying from the price row, not the product row — the product ID starts with prod_ and won't work in the checkout element.
4

Add a Checkout Button to Your Funnel

Once you have a Price ID from Stripe, you can add a Checkout element to any funnel page. The Checkout element renders a branded button that opens a Stripe Checkout session when clicked.

  1. 1
    Open the funnel builder
    Go to Playbooks → Funnels → open your funnel. If you don't have one yet, click New Funnel and use the wizard.
  2. 2
    Add a Checkout element
    In the left panel under Elements, find Checkout and click it. It will be added to the last section on the current page, or to a new body section if the page is empty.
  3. 3
    Click the element to open Inspector
    The Inspector panel opens on the right. You'll see the Checkout configuration options.
  4. 4
    Paste your Price ID
    In the Price field, select from the dropdown (which auto-loads your active Stripe prices) or paste your price_xxx ID directly into the text field next to it.
  5. 5
    Set the mode
    Choose Subscription (recurring billing) or One-time (single payment). This must match the pricing type you set in Stripe.
  6. 6
    Set success and cancel paths
    Success path: where the customer lands after payment (e.g. your Thank You page). Cancel path: where they go if they abandon the checkout (e.g. back to the landing page). Both are dropdowns showing your funnel pages.
  7. 7
    Optional: attach a delivery sequence
    If you want the buyer to be automatically enrolled in an email sequence after purchase, select it from the Delivery sequence dropdown. The sequence must exist in your Email HQ first.
Style options

Click the Style tab in the Inspector to customize the button background color, text color, and border radius. The button label is editable in both the Config and Style tabs.

If the checkout element shows "⚠ Connect Stripe in Settings → Integrations", your Stripe account isn't connected yet or charges aren't enabled. Complete Step 2 first.
5

Test Checkout

Always test your checkout before publishing. OceanDrive has a built-in test button in the Checkout Inspector that fires a real Stripe Checkout session in test mode.

  1. 1
    Save your funnel first
    Click Save in the top bar or the floating Save button. The funnel needs a slug to generate a test session.
  2. 2
    Click Test Checkout in the Inspector
    With the Checkout element selected, scroll to the bottom of the Inspector and click Test Checkout. A new tab opens with a Stripe Checkout page.
  3. 3
    Use a Stripe test card
    Enter the test card number below. Any future expiry and any 3-digit CVC work.
Stripe test card numbers
4242 4242 4242 4242Succeeds immediately
4000 0025 0000 3155Requires 3D Secure authentication
4000 0000 0000 9995Declined — use to test failure flow
After a successful test payment, check your Stripe dashboard under Payments — you'll see a test payment appear. In OceanDrive, check your Leads section — a test lead should appear with the email you used. This confirms your webhook is working end-to-end.
6

Publish & Go Live

When you're ready to take real payments, publish your funnel. OceanDrive runs a preflight check before publishing to catch common issues.

Preflight checks (automatically run on Publish)
  • Checkout button has a valid price_xxx Price ID
  • Privacy Policy URL is set
  • Terms of Service URL is set
  • No duplicate page slugs
  • No broken page or popup references
  1. 1
    Click Publish
    In the funnel builder top bar or floating bar. If any preflight checks fail, you'll see a list of issues to fix first.
  2. 2
    Set your funnel slug
    If you haven't already, set a slug in Settings (left panel) e.g. my-coaching-offer. This becomes your live URL: getoceandrive.com/f/my-coaching-offer.
  3. 3
    Copy the live link
    After publishing, the live URL is automatically copied to your clipboard and opened in a new tab.
  4. 4
    Share the URL
    Your funnel is now live. Share the URL anywhere — social bio, email, ads, direct messages.
Make sure you're in live mode in your Stripe dashboard (not test mode) before you start sharing the link with real customers. You can check by looking at the top of your Stripe dashboard — it will say "Test" or "Live" next to your account name.
7

What happens after a purchase

When a customer completes payment, OceanDrive's webhook handler processes the event automatically. Here's everything that happens without any extra setup on your part:

  • An Order record is created with the payment amount, currency, and Stripe session ID
  • The buyer's email is upserted as a Lead — existing leads are updated, new ones are created
  • If you set a Delivery sequence on the checkout element, the buyer is enrolled immediately and the first email queued
  • If you set a Lead Magnet, the download URL is attached to the lead record and injected into the delivery email
  • If the buyer arrived via an affiliate link, commission is calculated and recorded automatically
  • A Customer Brain event (PURCHASE) is fired, contributing to your Brand Brain confidence score
  • For subscription products, every renewal resets access and sends a credits-reset email — no manual intervention needed
You can view all orders and their associated leads in the Leads section of OceanDrive. Filter by source "stripe_checkout" to see only funnel purchases.
8

Troubleshooting

Connect Stripe button shows an error about platform profile

Go to dashboard.stripe.com/settings/connect/platform/profile and confirm your integration choices. Then return to OceanDrive and click Connect Stripe again.

Checkout element shows ⚠ Connect Stripe in Settings → Integrations

Your Stripe account isn't connected or charges aren't enabled. Complete the Stripe Connect setup in Settings → Integrations.

Checkout element shows ⚠ Set Price ID

The Price ID field is empty or invalid. Paste a valid price_xxx ID from your Stripe dashboard. Make sure you're copying the Price ID, not the Product ID (which starts with prod_).

Test Checkout button is greyed out

Save the funnel first (the funnel needs a slug and to be saved before a test session can be created). Also check that the Price ID is valid.

Payment succeeded in Stripe but no Lead appeared in OceanDrive

This usually means the webhook isn't configured or STRIPE_WEBHOOK_SECRET doesn't match. Check that your webhook endpoint is registered in Stripe → Developers → Webhooks pointing to yourdomain.com/api/stripe/webhook, and that your STRIPE_WEBHOOK_SECRET environment variable matches the signing secret shown in Stripe.

Delivery email sequence wasn't triggered after purchase

Check that the sequence is set in the Checkout element Inspector under Delivery sequence. Also confirm the sequence exists and is active in Email HQ.