UseLoyaltyPOS Integration
Square
Reward in-store and online Square payments with UseLoyalty points.
About this integration
Square + UseLoyalty
Square is a leading POS and payments platform for retail, restaurants, and service businesses. UseLoyalty integrates via Square webhooks to capture payment events from Square POS terminals, Square Online, and Square Invoices and convert them into loyalty moments.
Webhook endpoint
Configured in UseLoyalty dashboard
https://app.useloyalty.app/api/webhooks/square/{program-id}
This URL is generated for your account in the UseLoyalty dashboard. Each integration has its own signed endpoint.
Setup guide
Connect Square in minutes.
Follow the steps below to wire Square webhooks into your UseLoyalty program. No code required.
Copy your webhook endpoint URL
Go to UseLoyalty Dashboard → Settings → Integrations → Square. Copy your unique webhook endpoint URL.
Open Square Developer Dashboard
Go to developer.squareup.com → Applications → select your app → Webhooks → Subscriptions. Click + Add Subscription.
Configure the subscription
Paste the UseLoyalty endpoint URL, add a friendly name (e.g. UseLoyalty), and select the API version. Choose the events from the list below.
Copy the signature key
Square displays a Signature Key for the webhook subscription. Copy it and paste it into UseLoyalty Dashboard → Settings → Integrations → Square → Signature Key.
Test with Square Sandbox
Switch to the Square Sandbox environment and process a test payment to confirm the event arrives in UseLoyalty activity. Use your sandbox credentials for testing.
Enable loyalty rules
Create campaign rules in UseLoyalty that fire on Square payment events. Set points per dollar, location filters, and any category-level multipliers.
Webhook events
Events to subscribe to.
Subscribe to these events in your Square dashboard when creating the webhook. UseLoyalty maps each event to your campaign rules automatically.
payment.completedFires when a Square payment is fully completed. Primary trigger for POS points.
order.fulfillment.updatedFires when an order fulfillment state changes — useful for pickup/delivery rewards.
invoice.payment_madeFires when an invoice payment is received through Square Invoices.
customer.createdFires when a new customer is added to your Square customer directory.
refund.createdFires when a Square refund is initiated — optionally reverse loyalty points.
Get a tailored walkthrough
Ready to build
loyal customers?
Tell us a bit about your square loyalty program and we'll show you exactly how UseLoyalty can work for you.
- Live demo tailored to your square loyalty program
- Setup walkthrough, live in under 10 minutes
- Pricing advice based on your location count
FAQ