Connecting Stripe

Maven uses Stripe Connect to process payments on your Stripe account. The setup uses OAuth — you authorize Maven to create charges on your behalf.

Prerequisites

A Stripe account (test or live)
A Maven app

Setup Steps

Go to Payments

In the Maven Dashboard, navigate to your app and click the Payments tab.

Click Connect Stripe

Click the Connect Stripe button. You’ll be redirected to Stripe’s OAuth authorization page.

Authorize Maven

On the Stripe page, review the permissions and click Connect. Maven requests the ability to create charges and customers on your account.

Return to Dashboard

After authorization, you’ll be redirected back to the Maven Dashboard. Your Stripe account will show as connected.

Test vs Live

Maven stores separate credentials for test and live modes:

Test mode (mvn_test_ keys): Uses your Stripe test mode. No real charges.
Live mode (mvn_live_ keys): Uses your Stripe live mode. Real charges.

Connect both test and live Stripe accounts for full functionality.

Processor Response Fields

When a payment succeeds via Stripe, the processor object in the GET session response includes:

Charge Mode

Field	Description
`stripe_payment_intent_id`	PaymentIntent ID (e.g., `pi_xxx`)
`stripe_charge_id`	Charge ID (e.g., `ch_xxx`)
`receipt_url`	Stripe-hosted receipt URL
`payment_method_id`	PaymentMethod ID (e.g., `pm_xxx`)
`card_brand`	Card brand (visa, mastercard, etc.)
`card_last4`	Last 4 digits

Tokenize Mode

Field	Description
`stripe_customer_id`	Customer on your connected account (e.g., `cus_xxx`)
`payment_method_id`	PaymentMethod on your connected account, already attached to that customer (e.g., `pm_xxx`)
`card_brand`	Card brand
`card_last4`	Last 4 digits

Both stripe_customer_id and payment_method_id live on your own connected Stripe account — not on Maven’s platform account. Query and charge them with your own Stripe secret key (no stripe_account header needed, because they’re already on your account). Each tokenize creates a dedicated customer with exactly one saved card, so the customer + payment_method pair uniquely identifies the card — you never have to guess among multiple payment methods.

Using Tokenized Cards

After tokenizing, use the returned stripe_customer_id and payment_method_id to create charges via the Stripe API. Run this with your own Stripe secret key — the customer and payment method are on your account:

import stripe

stripe.api_key = "sk_live_...your_account_key..."

stripe.PaymentIntent.create(
    amount=4999,
    currency="usd",
    customer="cus_xxx",      # from processor.stripe_customer_id
    payment_method="pm_xxx", # from processor.payment_method_id (on your account)
    confirm=True,
    off_session=True,
)

Pass both customer and payment_method. Stripe treats the customer as optional in general, but because the card is saved to that customer, passing it is the reliable way to charge the intended card. As an extra safeguard you can verify card_last4 before charging.

Disconnecting

To disconnect Stripe, go to the Payments tab in your app and click Disconnect. Existing sessions won’t be affected, but new sessions using the stripe gateway will fail.

​Connecting Stripe

​Prerequisites

​Setup Steps

​Test vs Live

​Processor Response Fields

​Charge Mode

​Tokenize Mode

​Using Tokenized Cards

​Disconnecting

Connecting Stripe

Prerequisites

Setup Steps

Test vs Live

Processor Response Fields

Charge Mode

Tokenize Mode

Using Tokenized Cards

Disconnecting