Before enabling Square Terminal
- Create or open your application in the Square Developer Console.
- Choose Sandbox for testing or Production for real card payments, then copy the matching access token below.
- Enter your Square Location ID. In Production, save these settings and use “Generate pairing code”, then enter that code on the Terminal within five minutes.
- After pairing, enter the Terminal device ID or serial number shown by Square.
- In Square Developer Console → Webhooks, add the exact webhook URL shown below and subscribe it to
terminal.checkout.updated.
- Copy the webhook subscription’s signature key below. Production webhook URLs must be public HTTPS URLs; localhost cannot receive Square webhooks.
- Save the configuration, then enable the module. Selecting “Card payment” will send the amount to the Square Terminal and keep it pending until Square confirms completion.
Square Terminal pairing guide · Webhook setup guide
In Square Developer Console, subscribe this HTTPS URL to terminal.checkout.updated. Production requests require a production access token and a paired Terminal device ID.