Skip to main content

Setting up a POS Webhook

POS integrations are connected from the Orders page in your Harlyy dashboard. Connecting an integration generates a webhook URL and secret that your POS uses to push orders into Harlyy, and lets you attach feedback survey links so customers are automatically invited to leave feedback after an order.

Harlyy supports several POS systems out of the box — Blink, Indolj, Technosys, and Bluelink — as well as a Custom integration for sending orders from any other system. See Custom POS Webhook for the custom payload format.

1. Open the integrations panel​

Navigate to the Orders page in your dashboard and click Integrations in the top-right of the page header. This opens the POS Integrations dialog, listing every supported POS.

2. Connect your POS​

Each POS is shown as a card. Click a card that isn't yet connected to set it up. Harlyy provisions the integration and, once connected, the card is marked with a check.

3. Copy your webhook URL and secret​

As soon as an integration is connected, Harlyy displays its setup details:

Webhook URL
https://api.harlyy.com/webhooks/{pos}/{business}

where {pos} is the integration's identifier (for example custom) and {business} is your business ID.

Copy both the webhook URL and the secret, then configure them in your POS system. The secret is sent as a bearer token on every webhook request:

Authorization: Bearer <your-webhook-secret>
warning

The secret is shown once, immediately after the integration is connected. Copy it and store it securely — it can't be retrieved again later. To rotate the secret, reconnect the integration.

To automatically invite customers for feedback after an order, enable Send feedback for <POS> on the connected card and add one or more feedback survey links.

If you operate multiple brands under the same POS, use + Add Brand Link to add a separate link per brand and set the Brand ID on each one. Harlyy matches incoming orders to the right feedback link using the brand identifier sent on the order.

Click Save to persist your feedback configuration.

5. Send a test order​

With the webhook configured in your POS, place a test order. It should appear in the Orders table within a few seconds. If it doesn't:

  • Confirm the webhook URL includes the correct {pos} and {business} values.
  • Confirm the Authorization: Bearer header carries the exact secret shown at connect time.
  • Check your POS's webhook delivery logs for the response status — a 401 indicates an authentication problem, and a 400 indicates a malformed payload.

For the Custom integration, the expected request format and field reference are documented in Custom POS Webhook.