Connect Square to Cell Payments
Follow these steps to connect your Square account. Cell Payments monitors your Square transactions and disputes across all locations.
Estimated setup time: 7 minutes
Required Credentials
| Credential | Type | Where to Find |
|---|---|---|
| Access Token | Required | Square Developer → App → Credentials |
| Application ID | Required | Square Developer → App → Credentials |
| Location ID | Required | Square Dashboard → Locations |
| Webhook Signature Key | Optional | Square Developer → App → Webhooks |
Open the Square Developer Dashboard
Go to developer.squareup.com and log in with your Square account credentials.
If this is your first time using the Developer Dashboard, you may need to accept the Square Developer Terms of Service.
Create an Application
Click Create your first application (or + if you already have apps). Name it Cell Payments and click Save.
This creates an application context that provides the credentials Cell Payments needs to access your Square data.
Copy Your Access Token
In your application settings, go to the Credentials tab.
Switch to the Production tab (not Sandbox) to get live credentials.
Click Show next to the Access token field and copy it. Production tokens start with EAAAl.
Keep your access token secure. It provides access to your Square account data. Never share it publicly or commit it to version control.
Copy the Application ID
On the same Credentials page, copy the Application ID. It starts with sq0idp- for production.
Get Your Location ID
Go to the Square Dashboard and navigate to Account & Settings → Locations.
Click on the location you want to connect. The Location ID is displayed in the location details. Copy it.
If you have multiple locations, you can connect each one individually in Cell Payments.
The Location ID determines which transactions Cell Payments monitors. Each location represents a distinct business location in your Square account.
Create a Webhook Subscription
Back in the Square Developer Dashboard, go to your application and navigate to the Webhooks tab.
Switch to the Production environment and click Add endpoint.
Enter the following URL:
https://app.cell-payments.com/api/webhooks/square
Select Webhook Events
Subscribe to the following event types:
payment.created— New paymentspayment.updated— Payment status changesrefund.created— New refundsrefund.updated— Refund status changesdispute.created— New disputesdispute.state.updated— Dispute status changes
Click Save to create the subscription.
Copy the Webhook Signature Key
After creating the webhook subscription, Square displays a Signature key. Copy this value.
The signature key allows Cell Payments to verify that webhook events are genuinely from Square.
The webhook signature key is optional but recommended. Without it, Cell Payments cannot verify webhook authenticity.
Paste in Cell Payments
Log in to your Cell Payments account at app.cell-payments.com.
Navigate to Settings → Connections and select Square from the processor list.
Paste your credentials:
- Enter your Access Token
- Enter your Application ID (
sq0idp-...) - Enter your Location ID
- Enter your Webhook Signature Key if you created one
Click Connect. Cell Payments will validate the credentials and begin syncing your Square data.