Stripe Connection
Troubleshoot and configure your Stripe account connection.
Axle connects to your Stripe account to process payments. If your Stripe connection is broken or misconfigured, payments will fail.
Check connection status
- Go to the Axle dashboard
- Click Settings → Stripe Connection
- You should see your Stripe account name and email
- If you see "Not Connected", follow the connection steps below
Connect your Stripe account
If Stripe is not connected:
- Go to Settings → Stripe Connection
- Click Connect Stripe Account
- You'll be redirected to Stripe to authorize the connection
- Sign in with your Stripe account (create one if you don't have it)
- Review the permissions Axle is requesting
- Click Allow to authorize
- You'll be returned to Axle with your account connected
The first time you connect, Stripe will ask for basic information like your business name and banking details. This is required to receive payouts.
Reconnect if connection breaks
If your Stripe connection becomes inactive or disconnected:
- Go to Settings → Stripe Connection
- Click Reconnect
- Follow the authorization steps above
- Test a payment to verify it works
Stripe dashboard access
After connecting, you can view detailed payment information in your Stripe dashboard:
- Go to Stripe Dashboard
- Sign in with your Stripe account
- All payments processed through Axle will appear under Payments
You can refund payments, view customer details, and export transaction history from Stripe.
Disconnecting Stripe
To disconnect your Stripe account from Axle:
- Go to Settings → Stripe Connection
- Click Disconnect
- Confirm you want to disconnect
Disconnecting Stripe will disable all checkout buttons immediately. Users will see an error. You can reconnect at any time.
Stripe requirements
Your Stripe account must meet these requirements for Axle to work:
- Account type: Individual or Business account
- Currency: Account must be set to a supported currency (USD, EUR, GBP, etc.)
- Verification: Your account may need identity verification before you can receive payouts
- Terms: You must accept Stripe's standard terms and conditions
Check your Stripe account settings under Account Settings → Account Details to confirm everything is set up correctly.
Common Stripe errors
"Stripe account not found"
Cause: The Stripe account you're trying to connect no longer exists or was deleted.
Fix: Create a new Stripe account and connect it to Axle.
"Unable to authorize connection"
Cause: Stripe encountered an error during authorization.
Fix:
- Try disconnecting and reconnecting
- Clear your browser cookies
- Try a different browser or incognito window
- Contact Stripe support if the problem persists
"Payment failed — Stripe error"
Cause: Your Stripe account has an issue preventing charges (e.g., no banking details, account suspended).
Fix:
- Log in to Stripe Dashboard
- Check your account notifications and warnings
- Add your banking information if missing
- Contact Stripe support for account issues
Payout setup
To receive payments from Axle, you need to set up payouts in your Stripe account:
- Log in to Stripe Dashboard
- Go to Settings → Bank Accounts
- Add your bank account information
- Once verified (can take 1-2 business days), payouts will start automatically
By default, Stripe pays out weekly to your linked bank account. You can change the payout schedule in Stripe settings.
Axle itself does not hold funds. All payments go directly to Stripe, and Stripe handles payouts to your bank account. Axle charges a service fee that's deducted from each transaction.
Test vs Live mode
Stripe has two modes:
- Test mode: Use for testing without real charges. Test cards are provided by Stripe.
- Live mode: Real payments and payouts. Requires full account setup and verification.
Make sure you're using the correct mode:
- In Stripe Dashboard, toggle View Test Data to switch modes
- Use test keys for development, live keys for production
- Axle automatically uses the correct keys based on your API key prefix (
axle_test_vsaxle_live_)