Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.trymaven.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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

1

Go to Payments

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

Click Connect Stripe

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

Authorize Maven

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

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

FieldDescription
stripe_payment_intent_idPaymentIntent ID (e.g., pi_xxx)
stripe_charge_idCharge ID (e.g., ch_xxx)
receipt_urlStripe-hosted receipt URL
payment_method_idPaymentMethod ID (e.g., pm_xxx)
card_brandCard brand (visa, mastercard, etc.)
card_last4Last 4 digits

​
Tokenize Mode

FieldDescription
stripe_customer_idCustomer created on your Stripe account (e.g., cus_xxx)
payment_method_idPaymentMethod ID (e.g., pm_xxx)
card_brandCard brand
card_last4Last 4 digits

​
Using Tokenized Cards

After tokenizing, use the returned stripe_customer_id and payment_method_id to create charges via the Stripe API: 
import stripe

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

​
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.