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.

Create an app, connect a gateway, and collect your first payment.

​
1. Set Up Your Dashboard

1

Sign up

Create an account at app.trymaven.com.
2

Create an app

Go to Apps and click Create App. Give it a name — Maven generates a slug (e.g., my-store) that you’ll use in API calls.
3

Connect a gateway

In your app, go to the Payments tab and connect Stripe, Authorize.net, or Braintree. See the setup guides for Stripe, Authorize.net, or Braintree.
4

Create an API key

Go to Settings > API Keys and create a test key. It starts with mvn_test_. Copy it immediately — you won’t see it again.

​
2. Try the Playground

Open the Playground from the sidebar. Select your app, gateway, and mode, enter a phone number and amount, and create a test session. You’ll see the session status update in real time as the caller progresses through the payment flow. Payment modes: Use Charge to process payment immediately, or Tokenize to save the card for later without charging.

​
3. Get the Result

Configure a webhook to get notified when sessions complete. Maven sends a POST to your app’s webhook URL with the payment status, card brand, last 4 digits, and gateway-specific details. Set your webhook URL in the app’s Settings tab. See the Webhooks guide for the full payload format. See the API Reference for creating sessions programmatically.

​
Session Lifecycle

Sessions progress through these statuses: 
created → collecting-card → collecting-expiry → collecting-cvv → processing → payment-success
StatusTerminalDescription
createdNoAwaiting caller transfer
collecting-cardNoCollecting card number
collecting-expiryNoCollecting expiry date
collecting-cvvNoCollecting CVV
collecting-postal-codeNoCollecting ZIP code
processingNoProcessing payment
payment-successYesPayment completed
payment-failedYesPayment declined
expiredYesSession timed out (5-minute TTL)
cancelledYesCancelled via API
Sessions expire after 5 minutes (PCI compliance requirement). Most voice sessions complete in 60-90 seconds.

​
Test Cards

Use these with test mode keys (mvn_test_):
CardNumberCVVExpiry
Visa4242 4242 4242 4242Any 3 digitsAny future date
Mastercard5555 5555 5555 4444Any 3 digitsAny future date
Amex3782 822463 10005Any 4 digitsAny future date

​
Next

Webhooks

Get notified when sessions complete.

API Reference

Explore the full API.