Connect Square

Take cards, Apple Pay, Google Pay and Cash App Pay through your own Square account - access token, location, webhook subscription, sandbox and going live.

Square lets customers pay by card, Apple Pay, Google Pay and Cash App Pay. It works in the US, Canada, UK, Ireland, Spain, France, Australia and Japan, for invoices in USD, CAD, GBP, EUR, AUD and JPY.

Before you start

• A Square seller account in one of those countries.
• A free developer account at developer.squareup.com, using the same login.
• You must be an admin of the business in Ellibo.

Step 1: Get your access token

1. Sign in at developer.squareup.com and open the Developer Console.
2. Click + to create an application (name it, for example, Ellibo), or open an existing one.
3. In the left pane, open Credentials.
4. Choose Sandbox (to test) or Production at the top.
5. Click Show next to Access token and copy it.
6. Optional: to take payments for one location, open Locations in the left pane and copy its Location ID. Blank means your main location.

Step 2: Connect in Ellibo

1. Open Settings › Integrations › Payments.
2. On the Square tile, click Connect.

Step 3: Add the webhook

1. In Ellibo, under Your gateways › Square, click Copy next to Webhook URL.
2. In the Developer Console, open your application › Webhooks › Subscriptions › Add subscription (same Sandbox / Production mode).
3. Give it a name, paste the address, and tick payment.updated.
4. Save.

Step 4: Try a sandbox payment

1. With a sandbox token connected, open a small invoice's Pay now link and choose Square.
2. Pay with the test card 4111 1111 1111 1111, CVV 111, any future date, and a valid postcode.
3. Check the invoice shows Paid, then cancel the test receipt.

Square's sandbox checkout is simpler than the real one, so some screens may look different.

Step 5: Go live

1. Copy the Production access token.
2. In Ellibo, click Keys, paste it, set Account type to Live, and Save.
3. Add the webhook subscription again in Production.

Fees, payouts and refunds

• Square pays out to your bank, usually the next working day. Record payouts in Accounting › Online Payments.
• Refund with the Refund button in Ellibo.

If something goes wrong

See also Fix payment problems.