Skip to content

Guides · Setup · 2 min

Connect Clover to Pickup Signal

Do this once, on a computer. After that, orders rung up on your Clover appear on your pickup board by themselves. If someone else manages your Clover account, send them this page.

Before you start

In Clover: make an API token

  1. Open your Clover web dashboard at clover.com.
  2. Click the gear icon at the top right. It has no label.
  3. Click View all settings.
  4. Under Business Operations, click API tokens.
    Use API tokens under Business Operations. Clover also has Ecommerce API Tokens. Those are for online card payments and can't read your orders.
  5. The first time, Clover shows a welcome window. Click Get Started, then Allow when it asks for your location.
  6. Click Create new token and name it Pickup Signal.
  7. Tick Read on these four:
    • Orders (required)
    • Customers (puts names on tickets)
    • Inventory (imports your menu)
    • Merchant (your shop's name)

    Leave every Write box empty, and leave Employees and Payments unticked.

    Clover's Create new token window: a table of permissions with a Read and a Write checkbox for Customers, Employees, Inventory, Merchant, Orders and Payments.
    Clover's Create new token window. This picture leaves Merchant unticked; tick it too. The list above is the one to follow.
  8. Click Create Token, then copy the token.
  9. Copy the whole address from your browser's address bar. Your Merchant ID is in it: the 13 characters after /m/, as in clover.com/setupapp/m/1SBW…/api-tokens. You don't need to pick it out; Pickup Signal does.

In Pickup Signal: paste and test

  1. On your Pickup Signal dashboard, click Order sources on your shop. You can also click Connect register in the Getting live checklist.
  2. Click Clover.
  3. Paste the token into API token.
  4. Paste the Clover address into Clover address or merchant ID.
  5. Click Connect Clover.
  6. Ring up a test order on your Clover. It appears within about a minute, because Pickup Signal checks Clover every minute. When it shows up, everything works.

What reaches the board

If you see an error

These are the messages Pickup Signal can show during setup, and what to do about each.

Clover didn’t accept this key. One of these is the cause:
  • Read isn't ticked on Orders. Make a new token with it ticked (steps 6 to 8) and paste that one.
  • The key was made in a different Clover account. Sign in to the Clover merchant this shop uses, make the token there, and copy that address.
  • Part of the key was left out when copying. Copy the token again, all of it.
That token can’t read orders. Edit it in Clover and tick Read Orders.

Tick Read on Orders for the Pickup Signal token, or make a new token with it ticked, then click Try again.

That token belongs to a different Clover merchant. Check the Merchant ID: it’s the code after /m/ in your Clover dashboard’s web address.

Copy the address again from the Clover tab where you made the token, paste it, and click Try again.

No merchant ID in that yet. Paste the whole address from the Clover tab, or the 13 characters after /m/.

Copy the address while you're on a Clover settings page, such as API tokens. The ID only appears once you're signed in.

That Clover merchant is already connected to another shop. Disconnect it there first.

One Clover merchant feeds one Pickup Signal shop. Disconnect Clover on the other shop (see below), then try again here. If that shop isn't in your account, email hello@pickupsignal.com.

This shop is on Square. Disconnect Square from the dashboard first, then connect Clover.

On your dashboard, open the ··· menu on the shop, click Disconnect Square… and confirm. Then come back to Order sources.

Square is still linked to this shop and stopped working.

Click Disconnect Square in that message, or use the ··· menu on your dashboard. Then connect Clover.

Clover isn’t answering right now. Try again in a minute.

Nothing you pasted is wrong. Wait a minute and click Try again. The same goes for Couldn’t connect Clover just now. Try again in a minute.

Too many tries. Wait a few minutes, then try again.

Wait a few minutes before the next try.

This shop belongs to a different account. Sign in with the account that owns it.

Sign out of Pickup Signal and sign in with the account that added this shop.

Nothing yet. Check that the order went through on your Clover device, and that Read is ticked on Orders in your Clover key.

This shows when the test order hasn't arrived after a while. Check that the order was saved on the Clover device. If it was, make a new token with Read ticked on Orders and paste it.

If your key stops working

If your dashboard says Clover stopped sending orders, the token was deleted or changed in Clover.

  1. Make a new token in Clover (steps 2 to 8).
  2. On your dashboard, click Paste a new key.
  3. Paste the token and the Clover address, then click Connect Clover.

Orders from the last 30 minutes catch up within a minute.

To disconnect

Stuck on a step?

Email hello@pickupsignal.com with the message you see and the step number. We answer the support email.

Start 30 days freeAsk us firstNo card · $19.99/mo per location after