Skip to content
AxleAxle Docs
Getting Started

First Payment

Complete your first test payment to verify everything works.

Before you start

Make sure you've completed these setup steps:

  1. Created your Axle account
  2. Connected your Stripe account
  3. Added the head snippet to Framer
  4. Installed the AxleButton component

Verify your API key is set

  1. Go to your Axle dashboard
  2. Click API Keys in the sidebar
  3. Copy your Live API Key (starts with axle_live_)
  4. Confirm this same key appears in the head snippet you added to Framer (from the Add Head Snippet step)

Register your domain

Before customers can pay from your published site, you need to register the domain:

  1. In the Axle dashboard, click Domains
  2. Click Add Domain
  3. Enter your Framer site's domain (e.g., mysite.framer.website or your custom domain)
  4. Click Register
  5. Confirm the domain is marked as Verified

You only need to register domains once. If you're testing on a preview URL, you can skip this step and test locally first.

Test the payment button

  1. Open your Framer site in preview or publish mode
  2. Scroll to where you placed the AxleButton
  3. Click the button

You should see the Stripe checkout form open.

Using test payment details

To test without real charges:

  1. In the Stripe payment form, use these test card numbers:
    • Visa: 4242 4242 4242 4242
    • Mastercard: 5555 5555 5555 4444
  2. Use any future expiration date (e.g., 12/25)
  3. Use any 3-digit CVC (e.g., 123)
  4. Enter any email address

Click Pay to complete the test transaction.

Check your transaction

After the payment completes:

  1. Return to your Axle dashboard
  2. Click Transactions in the sidebar
  3. You should see your test payment listed with:
    • Amount
    • Currency
    • Status (Succeeded)
    • Timestamp

If the transaction appears here, everything is working correctly!

Troubleshooting

"Validation Error" on the button

This usually means the head snippet isn't properly added or published. Double-check:

  1. The script is in Framer Site Settings → Custom Code → Head
  2. Your API key is correct
  3. Your site is published (not just in preview)

Payment won't process

Check:

  1. Your Stripe account is connected and in live mode
  2. The domain is registered in the Domains section
  3. Your Framer site is published

Payment succeeded but doesn't appear in transactions

Transactions can take a few seconds to sync. Refresh your dashboard after 30 seconds.

Make sure to use test card details for testing. Real card numbers will result in actual charges to the cardholder.

Next steps

Now that payments are working, explore: