TROUBLESHOOTING

Common issues and fixes.

WIDGET NOT SHOWING?

Check Widget Key

Verify your widget key is correct:


          <script src="https://onedollar.dev/widgets/YOUR-ACTUAL-KEY.js"></script>

Check Credits

Widget pauses when credits run out. Check dashboard → buy credits if needed.

Check Console

Open browser console (F12) and look for errors:

• CORS errors → Wrong domain configured
• 404 errors → Invalid widget key
• 403 errors → Widget paused or deleted

API ERRORS

401 Unauthorized

Invalid or missing widget key

401

403 Forbidden

Widget paused (no credits) or wrong domain

403

429 Too Many Requests

Rate limited. Wait 60 seconds.

429

CORS Error

Add your domain in widget settings

CORS

DATA ISSUES

Not Receiving Submissions?

• Check widget is active (has credits)
• Verify form submission succeeds (200 response)
• Check spam folder in dashboard
• Confirm webhook URL if using webhooks

Missing Data Fields?

• Check field names match documentation
• Verify data is sent in request (network tab)
• Maximum field size: 10KB per field

FRAMEWORK ISSUES

React/Next.js

// Add to useEffect or component mount


          useEffect(() => {

            const script = document.createElement('script');

            script.src = 'https://onedollar.dev/widgets/KEY.js';

            document.body.appendChild(script);

          }, []);

Vue.js

// Add to mounted() hook


          mounted() {

            const script = document.createElement('script');

            script.src = 'https://onedollar.dev/widgets/KEY.js';

            document.body.appendChild(script);

          }

QUICK FIXES

Clear Cache

Hard refresh: Cmd+Shift+R (Mac) / Ctrl+Shift+R (PC)

Check Status

Dashboard → Widgets → Check if active

Test Mode

Add ?debug=true to your URL to see logs

Reset Widget

Dashboard → Widget Settings → Generate New Key

STILL STUCK?

Include widget key and browser console errors when emailing.

support@onedollar.dev →

Community support. Best effort. No SLA.