Square
Commerce User OAuth

Square

Accept payments and manage commerce operations with Square via OAuth authentication.

Auth Model

User OAuth

Standard OAuth 2.0 authorization. A user grants consent and receives an access token. Authpipe handles refresh, rotation, and health monitoring automatically.

Connection Flow

1
Your App
2
Authpipe
3
Square
@authpipe/node
// Get a valid credential — always fresh, zero latency
const { credential } = await authpipe.getCredential({
  provider: 'square',
  tenantId: 'org_acme',
  userId: 'user_123',
});
// Use the credential with the provider API
const response = await fetch('https://api.example.com/data', {
  headers: { Authorization: `Bearer ${credential}` },
});
@authpipe/react
// Drop-in React component
<ConnectButton
  provider="square"
  onSuccess={(conn) => console.log('Connected!', conn)}
/>

Available Scopes

Permissions you can request when connecting to Square.

PAYMENTS_READ

Read access to payments and refunds

PAYMENTS_WRITE

Create and manage payments and refunds

ORDERS_READ

Read access to orders

ORDERS_WRITE

Create and manage orders

CUSTOMERS_READ

Read access to customer profiles

CUSTOMERS_WRITE

Create and manage customer profiles

ITEMS_READ

Read access to catalog items

ITEMS_WRITE

Create and manage catalog items

INVENTORY_READ

Read access to inventory counts and adjustments

What Authpipe handles for Square

OAuth Orchestration

PKCE, state validation, callback handling, and provider-specific quirks — all automatic.

Encrypted Vault

AES-256-GCM encryption with per-tenant key isolation. OAuth tokens, API keys, and webhook secrets — never exposed to the frontend.

Silent Refresh

Proactive token refresh before expiry. SDK returns from local cache with zero latency.

Health Monitoring

Scheduled checks detect revoked tokens and expired credentials before users notice.

More Commerce providers

Ready to connect Square?

Get your first 100 connections free. Set up in minutes with our SDK.