Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.alterauth.com/llms.txt

Use this file to discover all available pages before exploring further.

Overview

Connect your users to Square for payment processing, inventory management, order tracking, and customer data.
PropertyValue
Provider IDsquare
CategoryPayments
PKCESupported
Token refreshAutomatic
Redirect URIShown in Developer Portal

Step 1: Create a Square OAuth App

1

Go to the Square Developer Portal

Navigate to developer.squareup.com/apps and sign in.
2

Create a new application

Click Create your first application (or + to add another), enter the app name, and click Save.
3

Configure the redirect URI

Under OAuth, add the Alter callback URL from the Developer Portal to the Redirect URL field.
4

Get your credentials

Copy the Application ID (Client ID) and Application Secret (Client Secret) from the Credentials tab.
Never share your Application Secret publicly. Store it securely and only enter it in the Alter Vault Developer Portal.

Step 2: Add to Alter Vault

1

Open the Developer Portal

Go to portal.alterauth.com and navigate to your app.
2

Add Square provider

Go to OAuth Providers > Add Provider > Square.
3

Enter credentials

  • Client ID: Paste your Square Application ID
  • Client Secret: Paste your Square Application Secret
4

Select scopes

Choose the scopes your app needs.
5

Save

Click Save. The provider is now active.

Available Scopes

ScopeDescription
MERCHANT_PROFILE_READRead merchant profile and business info
PAYMENTS_READRead payment records
PAYMENTS_WRITECreate and process payments
ORDERS_READRead order data
ORDERS_WRITECreate and manage orders
ITEMS_READRead catalog items and inventory
ITEMS_WRITECreate and manage catalog items
CUSTOMERS_READRead customer profiles
CUSTOMERS_WRITECreate and manage customers

Notes

  • Square has separate sandbox and production environments. Use sandbox credentials during development.
  • See the Square OAuth API documentation for more details.