Square Errors and Issues

Handling problems with Square WebPay

Here are some common Square issues and the steps required to fix them.

The provided OAuth access token has expired. You must renew the access token via the Renew Access Token endpoint.

Customer is attempting to complete a purchase and paying via Square. They login, provide payment details, and click the Continue button, and they are shown this message.

Or you get an email that says

[ACCESS_TOKEN_EXPIRED]: The provided OAuth access token has expired. 

Action to Resolve:

  1. Open Square in your Zen Cart Admin by going to Admin > Modules > Payment > Square WebPay and clicking Edit. Be sure to click Edit before going further.

  2. Go to https://connect.squareup.com/apps, click “Sign In” and open the app you are using for payment.

  3. Click the OAuth link on the left, then click the “Replace secret” button.

  4. Click “Show” on the Production Application secret, and paste it into your Zen Cart Admin in the Application Secret (OAuth) field.

I get a white screen in Admin where Square Configuration should be!

If you forgot to click Edit in the first step, you may get a blank screen on the right hand side of the page when you finally do click Edit.

Here’s what to do if that happens:

  • Edit the URL in the address bar, which will end with

Change this to


and press Enter. Press the “Remove Module” button and remove Square WebPay. Then re-add it using the reinstall instructions.

Two Factor Authentication

Square uses two factor authentication (either via SMS or an authenticator app). If you have multiple people accessing your Square dashboard (either multiple store admins or a store admin and a web developer), be sure that both of them can authenticate independently. (Without this, the one who can’t authenticate will be locked out until the other one is available.)

As a short term solution, you can disable two factor authentication in the Square Dashboard by clicking on Personal Information under Account, then clicking Disable 2-step verification.

Still have questions? Use the Search box in the upper right, or try the full list of FAQs. If you can't find it there, head over to the Zen Cart support forum and ask there in the appropriate subforum. In your post, please include your Zen Cart and PHP versions, and a link to your site.

Is there an error or omission on this page? Please post to General Questions on the support forum. Or, if you'd like to open a pull request, just review the guidelines and get started. You can even PR right here.
Last modified August 15, 2022 by Scott C Wilson (52ffb736).