Square

Connect Square to read payments, orders, and customer data for commerce analytics.

Overview

How to connect

1. Navigate to Settings → Integrations → Connectors
2. Click Connect on the Square integration
3. Authorize the Cendriix app in your Square account
4. Once authorized, payment and order data becomes available

Admin setup (self-hosted)

If you’re running Cendriix on your own infrastructure, an admin needs to:

1. Create a Square application at Square Developer Dashboard 
2. Set the redirect URL to: https://api.<your-domain>/v1/connectors/square/oauth/callback
3. Store the credentials in AWS Secrets Manager at cendriix/prod/connectors/square:

   { "client_id": "...", "client_secret": "..." }

Capabilities

Once connected, Cendriix agents can:

• Read payment transactions and order history
• Access customer profiles and item catalogs
• Reference merchant data for commerce analytics

Security notes

• Square tokens expire after 30 days and are automatically refreshed
• Revocation uses the Square OAuth revocation endpoint
• Disconnect at any time from Settings → Integrations → Connectors

Further reading

• Square OAuth API Overview 
• Square API Reference