Introduction
This article outlines how to identify and resolve common Billing Portal issues, including error codes (400 and 500) and problems submitting payments. Use the guidance below to determine the root cause and take appropriate action.
Understanding Error Codes
400-Level Errors (Access or Request Issues)
400-level errors indicate that the request could not be processed due to a client-side issue.
Common causes:
- Missing or insufficient billing permissions
- Invalid request or incorrect URL
- Accessing the Billing Portal from the wrong level (site instead of organization)
Resolution:
- Confirm you are logged into the correct account
- Verify your role includes billing permissions
- Access the Billing Portal from the organization (global) level
- Contact an organization admin/owner if access is required
500-Level Errors (Server Issues)
500-level errors indicate a server-side failure and are not related to user permissions or actions.
Action:
Proceed with the troubleshooting steps below to rule out temporary or environment-related issues.
Troubleshooting 500 Errors
Initial Checks
- Refresh the page or retry after a few minutes
- Open the portal in an incognito/private window
- Clear browser cache and cookies, then sign in again
- Try a different supported browser (Chrome, Edge, Firefox, Safari)
- Ensure the browser is up to date
- Disable browser extensions (especially ad/script blockers)
- Test from a different network or disconnect from VPN/proxy
- Confirm you are accessing the portal from the organization level
- Verify the Billing Portal URL is correct
Escalation
If the issue persists, collect the following before contacting support:
- User email address
- Full page URL
- Full-page screenshot (including address bar)
- Date/time of occurrence (with time zone)
- Steps to reproduce
- Browser, version, and operating system
- Cross-browser/device test results
- Scope of impact (single vs. multiple users)
- Network details (VPN, proxy, firewall, extensions)
Unable to Submit Payment
If payment details can be entered but not submitted:
Verify Access
- Ensure you are in the Billing Portal at the organization level
- Confirm your role includes billing permissions
Validate Form Completion
- Complete all required fields (card details, billing address)
- Resolve any validation errors
- Accept any required terms or authorization prompts
Check Browser and Page Behaviour
- Scroll to confirm the Submit/Pay button is visible
- Disable browser extensions and allow pop-ups
- Refresh the page or use an incognito window
- Try a different browser or device
If the Issue Persists
Collect the following and contact support:
- Screenshot of the payment page
- Page URL
- User email address
- Date/time (with time zone)
- Steps to reproduce
- Results from alternate browser/device testing
Summary
- 400 errors indicate access or request issues
- 500 errors indicate server-side problems
- Payment submission issues are typically related to permissions, form validation, or browser behaviour
Following these steps will help isolate the issue and ensure efficient resolution or escalation.
Assumptions
- Billing is managed at the organization (global) level
Billing access is controlled via user roles and permissions