How to Set Up Square Webhook Notifications with Webhookify

Square is a comprehensive commerce platform that enables businesses to accept payments in person, online, and through invoices. From point-of-sale terminals to e-commerce checkout, Square powers millions of merchants worldwide. Square's webhook system (called "event notifications") lets you receive real-time HTTP callbacks when events occur in your Square account -- payments processed, orders created, inventory changes, customer updates, and more. With Webhookify, you can transform those Square webhook events into instant, AI-powered notifications delivered to Telegram, Discord, Slack, Email, or mobile push with a cash register sound for every sale. Whether you run a retail store, restaurant, or online shop, knowing about every transaction in real time keeps you connected to your business.

This guide walks you through the complete setup for connecting Square webhooks to Webhookify so you receive instant payment and order notifications wherever you are.

Why Monitor Square Webhooks with Webhookify?

• Instant Payment Notifications with Cash Sound: Get a push notification with a cash register sound on your phone every time a payment is completed through Square. Whether the sale happens at your physical register, online store, or through a Square invoice, you will hear it instantly.

• Order Tracking Across Channels: Monitor orders placed through Square Online, Square POS, or third-party integrations. Webhookify alerts you on Slack or Discord when new orders come in, so your fulfillment team can act immediately.

• Inventory Change Alerts: Track inventory count changes in real time. Get notified when stock levels drop below thresholds or when catalog items are updated, helping you prevent stockouts and manage your product catalog proactively.

• AI-Powered Transaction Summaries: Square webhook payloads contain complex nested objects with money amounts, item details, tender information, and customer references. Webhookify's AI translates these into clear summaries like "Payment completed: $47.50 (Visa ending 4242) for Order #1234."

• Multi-Location Monitoring: If you operate multiple Square locations, route webhooks from all locations to a single Webhookify endpoint. Each notification identifies the location, giving you a centralized view of business activity across all your stores.

Prerequisites

1. A Square account (merchant account). Sign up at squareup.com if you do not have one.
2. A Square Developer account and application. Create one at developer.squareup.com.
3. A Webhookify account. Sign up for free at webhookify.app.
4. A notification channel configured in Webhookify (Telegram bot, Discord webhook, Slack workspace, or Email address).
5. Access to the Square Developer Dashboard with permissions to manage webhook subscriptions.

Step-by-Step Setup Guide

https://hook.webhookify.app/w/your-unique-endpoint-id

Square Webhook Events You Can Monitor

Complete reference of Square webhook event types that Webhookify captures:

Payments:

• payment.completed -- Payment successfully processed
• payment.created -- New payment record created
• payment.updated -- Payment modified (refund, void, etc.)

Orders:

• order.created -- New order placed
• order.updated -- Order modified
• order.fulfilled -- Order marked as fulfilled

Invoices:

• invoice.created -- New invoice created
• invoice.published -- Invoice sent to customer
• invoice.payment_made -- Payment received on invoice
• invoice.updated -- Invoice modified
• invoice.canceled -- Invoice canceled
• invoice.scheduled_charge_failed -- Scheduled invoice charge failed

Customers:

• customer.created -- New customer profile created
• customer.updated -- Customer info modified
• customer.deleted -- Customer profile removed

Catalog:

• catalog.version.updated -- Catalog items added, removed, or modified

Inventory:

• inventory.count.updated -- Stock count changed

Refunds:

• refund.created -- Refund issued
• refund.updated -- Refund status changed

Disputes:

• dispute.created -- Payment dispute (chargeback) opened
• dispute.state.updated -- Dispute status changed

Each payload includes the merchant ID, location ID, event timestamp, and the full data object for the affected resource.

Real-World Use Cases

• Retail Store Owner Dashboard: Set up mobile push notifications with cash sound for every payment.completed event. Whether you are on the shop floor, at lunch, or at home, you will know the instant a sale is made. The notification includes the payment amount and method, giving you a running sense of daily revenue.

• Restaurant Order Management: Route order.created events to a Discord or Slack channel for your kitchen and front-of-house team. When a new order comes in through Square Online or a delivery platform, the team gets an immediate alert with the order details.

• Inventory Management: Monitor inventory.count.updated events to track stock levels in real time. Get a Telegram alert when inventory for a popular item drops below a threshold, so you can reorder before running out.

• Invoice Payment Tracking: Forward invoice.payment_made events to email for your accounting team. Every time a customer pays an invoice, a notification with the payment amount and invoice details is sent automatically, reducing manual follow-up.

Example Notification

When a payment is completed in Square, Webhookify delivers a notification like this:

{
  "merchant_id": "ML1A2B3C4D5E6F",
  "type": "payment.completed",
  "event_id": "evt_1a2b3c4d5e6f7g8h9i0j",
  "created_at": "2026-02-21T12:45:30.000Z",
  "data": {
    "type": "payment",
    "id": "pay_abc123def456",
    "object": {
      "payment": {
        "id": "pay_abc123def456",
        "amount_money": {
          "amount": 4750,
          "currency": "USD"
        },
        "total_money": {
          "amount": 4750,
          "currency": "USD"
        },
        "status": "COMPLETED",
        "source_type": "CARD",
        "card_details": {
          "card": {
            "card_brand": "VISA",
            "last_4": "4242"
          },
          "status": "CAPTURED"
        },
        "location_id": "LOC_XYZ789",
        "order_id": "ord_987654321",
        "created_at": "2026-02-21T12:45:28.000Z"
      }
    }
  }
}

Webhookify's AI summary would display:

Square Payment Completed: $47.50 USD via Visa ending 4242. Status: COMPLETED. Order: ord_987654321. Location: LOC_XYZ789.

If you have the cash sound enabled, you will hear a "cha-ching" along with this notification.

Troubleshooting

1. No events received after configuring the webhook: Verify your webhook subscription is active in the Square Developer Dashboard. Also check that you are using the correct environment -- Sandbox webhooks only fire for Sandbox transactions, and Production webhooks only fire for real transactions.

2. "Signature validation failed" errors in Square Dashboard: Square signs every webhook payload with a signature that can be validated using your webhook signature key. While Webhookify receives the payload regardless of signature validation, if you see delivery failures in Square, ensure the Notification URL is exactly correct.

3. Payment events received but order events missing: Payment and order events are separate subscriptions in Square. Make sure you subscribed to both payment.completed and order.created if you want both types of notifications. Go back to the Webhooks section and add the missing subscriptions.

4. Events are delayed by more than a minute: Square generally delivers webhook events within a few seconds, but during high-volume periods (like holidays), there may be slight delays. This is on Square's end and not related to Webhookify. If delays persist, check the Square Developer Status page.

5. Duplicate events received: Square may retry webhook delivery if it does not receive a 200 response quickly enough. Webhookify responds immediately, but network issues could occasionally cause retries. Each event has a unique event_id that you can use to identify duplicates.

Related Articles

• The Ultimate Webhook Debugging Guide
• How to Set Up Webhook Notifications in Slack
• E-Commerce Webhook Monitoring: Never Miss a Sale
• Revenue Monitoring for Indie Hackers & Solo Founders
• How to Set Up Stripe Webhook Notifications
• How to Set Up Razorpay Webhook Notifications