RRReviewsRelay Start free

Square direct integration

Send Google review follow-up after a completed Square payment.

Queue a fair Google review request only after Square reports that the customer payment is complete. This is a signed provider webhook with explicit setup and testing, not a one-click marketplace install.

Square sellers that collect customer email addresses and want a review request handoff after a completed payment, without another front-desk entry step.

Start freeSee it work

Exact accepted Square trigger

Square must show that the visit is complete

A payment event is not enough on its own. ReviewsRelay opens only payment.updated payloads and accepts the customer handoff when the payment object itself says COMPLETED.

Square direct uses a private signed webhook. It is not a one-click Square App Marketplace install: someone with access to the Square Developer Dashboard must create the subscription and provide the minimum credentials shown in ReviewsRelay.

Required customer handoff

  • A stable Square payment event ID
  • A customer name
  • A customer email address, resolved from Square when needed
  • The completed payment timestamp

Automatically ignored

  • Payments that are not COMPLETED
  • Duplicate event IDs
  • Customers without a usable email address
  • Provider-level email opt-outs
  • Customers contacted within the previous 90 days

Provider-specific setup

Connect Square, prove one event, then enable live intake

  1. Create the Square direct connection

    Choose production or sandbox, then save the Square signature key. Add an access token when customer IDs need to be resolved to names, email addresses, or provider-level email preferences.

  2. Subscribe in Square

    Add the private ReviewsRelay notification URL in the Square Developer Dashboard and subscribe to payment.updated.

  3. Run one controlled completed payment

    Use a sandbox payment or contact details you control. A pending, approved, failed, or canceled payment should be ignored.

  4. Confirm the event before live intake

    ReviewsRelay shows whether the signature was verified, the event was accepted, or customer data was missing. Enable the connection only after the accepted test appears.

Go-live checks

Confirm the provider evidence, customer data, and duplicate behavior

  • The delivery type is payment.updated
  • The payment status is COMPLETED
  • The signature matches the exact notification URL and body
  • The customer has a usable name and email
  • Repeating the same payment does not create a second queue item

Operational controls

  • Signed webhook verification is required
  • An access token enables customer lookup and provider-level opt-out checks
  • Sandbox events use Square sandbox APIs
  • The connection can be tested, paused, rotated, or disconnected in ReviewsRelay

Square Webhooks documentation is the official provider source for the webhook contract.

Practical outcomes

  • Trigger from a completed payment
  • Resolve the Square customer safely
  • Keep non-completed payments out
  • Test in sandbox before production

Workflow

  • Create the Square direct connection
  • Subscribe in Square
  • Run one controlled completed payment
  • Confirm the event before live intake

Safety guardrails

  • Signed webhook verification before payload processing
  • Payments that are not COMPLETED
  • Duplicate event IDs
  • Customers without a usable email address
  • Provider-level email opt-outs

Frequently asked questions

What exactly triggers the Square integration?

Square payment.updated with payment status COMPLETED.

What customer data does ReviewsRelay need from Square?

A stable Square payment event ID. A customer name. A customer email address, resolved from Square when needed. The completed payment timestamp.

Which Square events are ignored?

Payments that are not COMPLETED. Duplicate event IDs. Customers without a usable email address. Provider-level email opt-outs. Customers contacted within the previous 90 days.

Is the Square connection a one-click install?

Square direct uses a private signed webhook. It is not a one-click Square App Marketplace install: someone with access to the Square Developer Dashboard must create the subscription and provide the minimum credentials shown in ReviewsRelay.

Can I test the Square connection before enabling it?

Yes. Use contact details you control and verify these checks: The delivery type is payment.updated; The payment status is COMPLETED; The signature matches the exact notification URL and body; The customer has a usable name and email; Repeating the same payment does not create a second queue item.

Does ReviewsRelay need my Square password?

No. ReviewsRelay never asks for your Square sign-in password. The direct connection uses a private signed webhook and the minimum configured credentials needed for customer lookup.

Related review automation pages