Payments
Square Webhooks
Commerce platform for payments, online stores, and business management. Receive events for payments, orders, and inventory.
Connecting Square to Hookbase
Create a source in Hookbase first — it gives you an ingest URL to paste into Square. Then:
- 1Open the Square Developer Console and select your application
- 2Go to Webhooks → Subscriptions and click "Add subscription"
- 3Paste your Hookbase ingest URL as the Notification URL exactly as shown in Hookbase (Square signs the URL, so any difference breaks verification)
- 4Select the event types and save the subscription
- 5Open the subscription, copy its Signature key, and paste it into Hookbase's Signature key field
Signature verification
Set the source's provider to square and paste the signing secret. Every request is checked before the event is stored, and anything that fails is rejected rather than quietly recorded.
- Algorithm
- HMAC-SHA256
- Header
- x-square-hmacsha256-signature
- Where to find the secret
- Square Developer Console → your application → Webhooks → Subscriptions → select subscription → Signature key
Square event types
6 of the events people route most often. Hookbase accepts every event Square sends, whether or not it is listed here.
payment.completed
A payment was completed
payment.updated
A payment was updated
order.created
A new order was created
order.updated
An order was updated
invoice.published
An invoice was published
inventory.count.updated
Inventory count was updated
What a Square webhook looks like
A payment.completed payload. Hookbase stores the raw body exactly as it arrived, so this is also what you get back on a replay.
{
"merchant_id": "MERCHANT_ID_123",
"type": "payment.completed",
"event_id": "evt_123456",
"created_at": "2024-01-15T10:30:00Z",
"data": {
"type": "payment",
"id": "pay_123456",
"object": {
"payment": {
"id": "pay_123456",
"amount_money": {
"amount": 1000,
"currency": "USD"
},
"status": "COMPLETED"
}
}
}
}Start receiving Square webhooks
Create a source, paste the URL into Square, and watch the first event arrive. The free tier includes 1,000 events a month.
Get Started Free