Skip to content
AxleAxle Docs
Troubleshooting

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

  1. Go to the Axle dashboard
  2. Click SettingsStripe Connection
  3. You should see your Stripe account name and email
  4. If you see "Not Connected", follow the connection steps below

Connect your Stripe account

If Stripe is not connected:

  1. Go to SettingsStripe Connection
  2. Click Connect Stripe Account
  3. You'll be redirected to Stripe to authorize the connection
  4. Sign in with your Stripe account (create one if you don't have it)
  5. Review the permissions Axle is requesting
  6. Click Allow to authorize
  7. 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:

  1. Go to SettingsStripe Connection
  2. Click Reconnect
  3. Follow the authorization steps above
  4. Test a payment to verify it works

Stripe dashboard access

After connecting, you can view detailed payment information in your Stripe dashboard:

  1. Go to Stripe Dashboard
  2. Sign in with your Stripe account
  3. 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:

  1. Go to SettingsStripe Connection
  2. Click Disconnect
  3. 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 SettingsAccount 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:

  1. Try disconnecting and reconnecting
  2. Clear your browser cookies
  3. Try a different browser or incognito window
  4. 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:

  1. Log in to Stripe Dashboard
  2. Check your account notifications and warnings
  3. Add your banking information if missing
  4. Contact Stripe support for account issues

Payout setup

To receive payments from Axle, you need to set up payouts in your Stripe account:

  1. Log in to Stripe Dashboard
  2. Go to SettingsBank Accounts
  3. Add your bank account information
  4. 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:

  1. In Stripe Dashboard, toggle View Test Data to switch modes
  2. Use test keys for development, live keys for production
  3. Axle automatically uses the correct keys based on your API key prefix (axle_test_ vs axle_live_)