Square setup

If you already use Square at a physical point-of-sale, connecting the same Square account to TitanCart keeps your online and offline reporting in one place.

1. Create a Square application

1. Sign in to the Square Developer Dashboard.
2. Click + Create new application. Give it any name (e.g. “TitanCart”).
3. Open the app. At the top of the page you’ll see a toggle between Sandbox and Production. Leave it on Sandbox for now.

2. Collect three credentials

Inside your Square application, collect:

• Application ID — visible on the app’s main page under Credentials.
• Access Token — on the same Credentials page. Click Show to reveal.
• Location ID — under Locations in the left nav. Pick the location you want to associate online orders with.

3. Configure TitanCart

1. Go to TitanCart → Payment Gateways → Square.
2. Toggle Enabled on.
3. Set Mode to Sandbox.
4. Paste the Application ID, Access Token and Location ID into the corresponding fields.
5. Save settings.

4. Test with a sandbox card

Square’s sandbox accepts these test cards:

• Visa success: 4111 1111 1111 1111
• Mastercard success: 5105 1051 0510 5100
• Card declined: 4000 0000 0000 0002
• Expiry: any future date   CVC: 111   ZIP: 94103

Run a test order end to end — successful charges should flip the order to Processing; declined test cards should show the error inline at checkout without advancing.

5. Register webhooks

1. In your Square application, open Webhooks → Subscriptions → Add Subscription.
2. Use the endpoint URL shown on TitanCart’s Square settings page.
3. Subscribe to these events:
   • payment.created
   • payment.updated
   • refund.created
   • refund.updated
4. Copy the Signature Key Square provides and paste it into TitanCart’s Webhook Signature Key field.

6. Switch to production

Flip the toggle in the Square Developer Dashboard to Production. Grab the production Application ID, Access Token and Location ID. Paste into TitanCart and switch Mode to Live. Register a production webhook with its own signature key.

Note: Square’s “Cash App Pay” and “Afterpay” options show up automatically at checkout once you enable them in your Square dashboard under Payments → Settings. TitanCart does not need separate configuration for these.