Skip to content
AxleAxle Docs
Dashboard

Domains

Register and manage domains for your payment pages.

Why register domains?

Before customers can make payments on your published site, you need to register your domain with Axle. This:

  • Authorizes the domain to use your API key
  • Ensures payment buttons work correctly on your site
  • Prevents unauthorized use of your credentials from other domains

You only need to register domains you actually own and publish on. You don't need to register test or preview URLs.

Accessing domains

  1. Log into your Axle dashboard
  2. Click Domains in the sidebar
  3. You'll see any registered domains

Adding a domain

  1. Click Add Domain
  2. Enter your domain:
    • Framer site: yoursite.framer.website or your custom domain
    • Custom domain: yourcompany.com or shop.yourcompany.com
    • Subdomain: You can register specific subdomains (e.g., payments.yoursite.com)
  3. Click Register

Axle will verify the domain immediately. If it's accessible and valid, it will show as Verified.

Domain status

Domains can have these statuses:

  • Verified ✅ - Active and ready for payments
  • Pending ⏳ - Verification in progress (usually instant)
  • Invalid ❌ - Domain couldn't be verified; check the address and try again

Payment buttons on verified domains

Once a domain is registered and verified:

  • Your AxleButton components will work on that domain
  • Stripe checkout will open normally
  • Payments will be accepted and processed
  • Your API key is authorized for that domain

If a domain is not registered:

  • Payment buttons will show a validation error
  • Customers won't be able to complete payments
  • You'll see a warning in the dashboard

Managing domains

View domain details

Click on any registered domain to see:

  • Full domain name
  • Registration date
  • Current status
  • Last verified date

Remove a domain

To remove a domain:

  1. Click on the domain
  2. Look for the Remove button
  3. Confirm the removal

Removing a domain will immediately stop payments on that domain. Customers will see a validation error on your payment buttons. Only remove domains you're no longer using.

Domain examples

Framer sites

  • mysite.framer.website - Default Framer subdomain
  • myshop.com - Custom domain connected to Framer
  • shop.mycompany.com - Subdomain of your main site

Multiple domains

You can register multiple domains, such as:

  • mycompany.com - Main site
  • shop.mycompany.com - Separate shop subdomain
  • eu.mycompany.com - Regional site

Each domain must be registered separately.

Troubleshooting

Domain won't verify

Check that:

  1. The domain is spelled correctly
  2. The domain is publicly accessible (not behind password protection)
  3. The domain actually exists and resolves to an IP address
  4. You own or have access to the domain

Try again after a few minutes — verification is usually instant.

Payment buttons show error on live domain

Verify that:

  1. Your domain is registered in the Domains section
  2. The domain status shows Verified (green checkmark)
  3. Your Framer site is published
  4. You've added the head snippet to your site

Subdomain isn't working

If you're using a subdomain like shop.example.com:

  1. Make sure it's registered as the full subdomain (not just example.com)
  2. Verify the subdomain exists and is publicly accessible
  3. Wait a few minutes for verification

Next steps

Once your domains are registered, your payment buttons are ready for customers. Learn about managing your subscription or viewing transactions.