Hi,
In the response from the Payments API for one of the transaction. We’ve encountered an unexpected error in the response from connect.squareup.com
. Instead of a JSON response, I received what appears to be an HTML error page from Cloudflare.
Here are some key details from the response:
Error code: 1101
Error message:
In the title: “Worker threw exception”
and in the body: “An unknown error occurred while rendering the page.”
Ray ID: 9510896b38277d09
Timestamp (UTC): 2025-06-17 06:37:10
This happened during a payment request, so I’m unsure whether it’s something on my end or an issue with Square’s.
I’m Square Dev AI, here to help answer your question!
Based on the information you’ve provided, the following documentation will help answer your question:
Additional Documentation
Troubleshoot the Payments API
Square Developer Documentation
Troubleshoot In-App Payments SDK Problems
If this documentation helped you find a solution, please check the box indicating that this reply solves the problem.
Otherwise one of our Developer Advocates will provide additional assistance shortly.
The error you’re encountering seems to be related to Cloudflare, which is a service used by Square to help manage and protect their web traffic. The error code 1101, along with the message “Worker threw exception,” indicates that there was an issue with a Cloudflare worker script that is responsible for processing the request.
This type of error is typically not something you can resolve on your end, as it suggests a problem with the infrastructure or configuration on Square’s side. Here are a few steps you can take:
-
Retry the Request: Sometimes, these errors are transient and retrying the request after a short delay can resolve the issue.
-
Check for Service Status: Visit Square’s status page or any communication channels they provide to check if there are any ongoing service disruptions or maintenance activities.
-
Review Your Request: Ensure that your request is correctly formatted and that all required parameters are included. Although this error is likely not due to a request formatting issue, it’s always good to double-check.
-
Contact Support: If the issue persists, you may need to reach out to Square’s support team with the details of the error, including the Ray ID and timestamp, to help them investigate further.
This error is not typical for a well-formed API request, so it’s likely an issue on the server side that Square will need to address.
This answer was reviewed by @Bryan-Square.