Common Issues

Invalid API key

Symptom: Error message "Invalid API key" when trying to checkout.

Causes:

• API key in the head snippet is incorrect or has a typo
• API key has been revoked or regenerated
• Using a test key in production (or vice versa)

Fix:

1. Go to the Axle dashboard
2. Navigate to API Keys in the sidebar
3. Copy your live key (starts with axle_live_)
4. Update the API key in your Framer site's head snippet (Site Settings → Custom Code → Head)
5. Clear your browser cache and reload

Domain not allowed

Symptom: Error "Domain not authorized" when clicking checkout.

Causes:

• Your website's domain is not in the allowed list
• Typo in the allowed domain
• Using a different domain than the one you added

Fix:

1. Go to the Axle dashboard
2. Navigate to API Keys
3. Click on your key to view settings
4. Add your domain to the Allowed Domains list (e.g., example.com)
5. Include both www and non-www versions if you use both:
   • example.com
   • www.example.com
6. Reload the page

Button not showing in Framer

Symptom: AxleButton component doesn't appear on the page.

Causes:

• Script tag not added to Framer site settings
• Script tag added to wrong location
• Component not published

Fix:

1. Open your Framer project
2. Go to Site Settings → General → Custom Code
3. Verify the Axle head snippet is in the Head section (not Body)
4. Click Publish to deploy changes
5. Visit your live site (not the Framer preview) and refresh

Checkout not opening

Symptom: Button is visible but clicking it doesn't open the checkout modal.

Causes:

• Head snippet missing or failed to load
• API key not set or invalid

Fix:

1. Check that your Framer site's head snippet in Custom Code contains the correct API key from your dashboard
2. Verify the snippet is in the Head section (not Body)
3. Clear your browser cache and reload
4. If the problem persists, check Error Messages

Payment not showing in dashboard

Symptom: Payment succeeded but doesn't appear in the Axle dashboard.

Causes:

• Payment actually failed on the Stripe side
• Stripe account not connected
• Delay in syncing

Fix:

1. Go to the Axle dashboard under Transactions
2. Find the transaction by timestamp or customer email
3. If it's there, the payment was successful and just needs a moment to appear
4. If it's not there, verify Stripe is connected:
   • Go to Settings → Stripe Connection
   • Confirm your Stripe account is linked
5. Reload the dashboard and wait a moment (payments can take a few seconds to appear)

Transaction limit exceeded

Symptom: Error "Transaction limit exceeded" when trying to checkout.

Causes:

• You've reached the transaction limit for your plan
• Monthly limit has reset and needs to be paid

Fix:

1. Go to the Axle dashboard → Settings → Billing
2. Check your current plan and remaining transactions
3. Either:
   • Upgrade to a higher-tier plan
   • Wait for your billing cycle to reset (if on monthly plan)
   • Contact support if you believe this is an error

See FAQ for more on billing.

Form not appearing

Symptom: Axle Form component is not visible on the page.

Causes:

• Axle Form feature is not enabled for your account
• Component not added to page
• Head snippet missing

Fix:

1. Check if Axle Form is enabled in your dashboard → Settings → Features
2. Toggle it on if disabled
3. Ensure the Axle head snippet is in your Framer Site Settings → Custom Code → Head
4. Add the Axle Form component from the Framer components panel
5. Publish and reload