Why use Hookfire with Square?

Instant push notifications

Get notified on your phone the moment a Square webhook fires. No more checking dashboards.

Subscribe to what matters

Choose exactly which Square events trigger notifications. Filter out the noise.

Team-wide delivery

Control who on your team gets notified and how: push notifications, record only, or both.

Setup in under 2 minutes

Copy a webhook URL, paste it in Square, and you're done. No code required.

Supported events

Event	Sample notification
Payment updated `payment.updated` 📝 Payment updated $25.00 payment is now COMPLETED	📝 Payment updated $25.00 payment is now COMPLETED
Refund created `refund.created` 🔄 Refund issued $10.00 refund PENDING	🔄 Refund issued $10.00 refund PENDING
Order created `order.created` 🛒 New order Order eA3vssLHKJrv9H0IdJCM3gNqfdcZY created (OPEN)	🛒 New order Order eA3vssLHKJrv9H0IdJCM3gNqfdcZY created (OPEN)
Invoice payment made `invoice.payment_made` ✅ Invoice paid Invoice inv-100 paid by Amelia Earhart	✅ Invoice paid Invoice inv-100 paid by Amelia Earhart
Customer created `customer.created` 👤 New customer Jenkins Smorly (jenkins.smorly@example.com)	👤 New customer Jenkins Smorly (jenkins.smorly@example.com)
Inventory updated `inventory.count.updated` 📦 Inventory changed 10 IN_STOCK for catalog object FGQ5JJWT2PYTHF35CKZ4DSKF	📦 Inventory changed 10 IN_STOCK for catalog object FGQ5JJWT2PYTHF35CKZ4DSKF
Payment created `payment.created` 💰 New payment $25.00 payment APPROVED	💰 New payment $25.00 payment APPROVED
Order updated `order.updated` 📝 Order updated Order eA3vssLHKJrv9H0IdJCM3gNqfdcZY is now COMPLETED	📝 Order updated Order eA3vssLHKJrv9H0IdJCM3gNqfdcZY is now COMPLETED

How to connect Square

Step 1: Create an Integration

Go to your organization’s Integrations page.
Click Add Integration and select Square.
You’ll receive a unique Webhook URL. Copy it.

Step 2: Add the Webhook in Square

In the Square Developer Console, choose Open on your application.
In the left pane, under Webhooks, choose Subscriptions.
Choose Add subscription and give the webhook a name.
Paste your Hookfire webhook URL as the notification URL, exactly as Hookfire shows it, with nothing added or removed. Square signs the URL along with the body, so a URL that differs by a character fails the check.
Choose an API version, select the events you want (e.g. payment.created, payment.updated, order.created) and choose Save.

Step 3: Copy the Signature Key

Under Subscriptions, choose the webhook’s name to open its Endpoint Details page.
In the Signature Key box, choose Show and copy the key.
Go back to your Hookfire integration page and paste it into the Signing Secret field.

Hookfire then refuses any request Square did not sign for this URL. See Square’s guide to validating notifications.

Step 4: Subscribe to Events

On your Hookfire integration page, toggle on the events you want to receive push notifications for.

Square has no “payment completed” event: a payment arrives as payment.created and moves on through payment.updated, whose status reads COMPLETED once the money is captured.

Step 5: Test

Make a test payment in your Square sandbox, or click Test next to an event on your Hookfire integration page.

Supported Events

Event	Description
`payment.created`	A payment was created
`payment.updated`	A payment changed status, for example to COMPLETED
`refund.created`	A refund was issued
`order.created`	A new order was created
`order.updated`	An order was updated
`invoice.payment_made`	An invoice was paid
`customer.created`	A new customer was created
`inventory.count.updated`	Inventory count changed

Square