ToolsSquare Webhook Tester
Smart Parsing for Square

Square Webhook Tester

Square sends different object shapes per event type. HookRay extracts event_id, type, merchant id, and the nested payment id so you can dispatch without crawling the structure.

What HookRay Highlights from a Square Webhook

HookRay: highlighted fields
Event IDcritical
event_id"v1-payment-3b6e8d6f"

Use for idempotency.

Event Typecritical
type"payment.updated"

payment.created, refund.created, dispute.created, etc.

Merchant IDhigh
merchant_id"ML4F4M3A6H4G2"
Payment IDhigh
data.object.payment.id"R2B3Z4Y5X6"

Path varies by event: data.object.payment.id, data.object.refund.id, etc.

Created Atmedium
created_at"2026-03-20T10:05:00Z"
webhook.site / raw: full JSON
{
  "merchant_id": "ML4F4M3A6H4G2",
  "type": "payment.updated",
  "event_id": "v1-payment-3b6e8d6f",
  "created_at": "2026-03-20T10:05:00Z",
  "data": {
    "object": {
      "payment": {
        "id": "R2B3Z4Y5X6",
        "amount_money": {
          "amount": 4200,
          "currency": "USD"
        },
        "status": "COMPLETED"
      }
    }
  }
}

Same payload, no parsing — you scroll, you scan, you guess.

Square gotcha: Square's signing string is notification_url + raw_body — the URL Square called concatenated with the body. Proxies that rewrite the host break verification.

Test a Square Webhook in 30 Seconds

  1. 1

    Get a free webhook URL

    Click Start Testing — HookRay generates an instant URL like https://hookray.com/api/hook/abc123. No signup.

  2. 2

    Paste it into Square

    Open the Square webhook settings (docs), paste the HookRay URL as your endpoint, and pick the events you want to receive.

  3. 3

    Trigger an event, inspect the payload

    Trigger a test event in Square. HookRay captures the payload for raw inspection and one-click replay. The field guide above shows the 5 Square paths the upcoming parser will surface — use it as a cheat sheet while you wire up your handler.

HookRay vs Generic Webhook Testers

Capabilitywebhook.siteHookRay
Free tier✓ 100 req✓ 100 req/mo
No signup required
Square-specific field parsing
One-click replay✓ (Pro)✓ Free
30-day history$9/mo$9/mo
Persistent URLs$9/mo$9/mo

See the broader comparison in The 7 Best Webhook Testing Tools (2026).

Start Testing Square Webhooks Now

Free, no signup. Raw capture and replay included; Square smart parsing previewed above.

Get a Free Webhook URL

Deeper Square Webhook Resources

Testers for Other Services