Connect Square Terminal to NeroPOS
Connect your Square account and an API-paired Square Terminal.
Square Terminal required · Manual application connection
Before you start
This guide is for merchants connecting Square Terminal to NeroPOS. Square Reader and Square Register are not supported by this connection.
Use your own Square application access token to connect your account. Ask your account administrator or authorised installer to help if you do not manage application credentials or terminal pairing.
What you need
- Your own Square merchant account and application access.
- An active Square location with the same currency as your NeroPOS account.
- A Square Terminal paired for the supported connection and your intended live location.
- Owner access to NeroPOS settings.
Use a token, location and paired device belonging to your own business and the same environment. Confirm live activation before accepting customer payments.
Connect your account & terminal
Your account administrator can obtain the correct environment’s access token and location details from the Square Developer Console. Keep the token private.
Terminal pairing requires an API-generated device code. Ask your authorised installer/support to prepare that code for the intended account/location. Following Square’s supported pairing flow, use the short code to sign into the terminal before it expires. The installer then confirms pairing and provides the saved device identifiers.
| Field | What you enter |
|---|---|
| Merchant access token | Your own application’s appropriate account/environment token. |
| Location ID | The Square location used for these payments. |
| Terminal / device ID | The ID confirmed after API pairing. |
| API device-code ID · live only | The saved pairing record ID, not the short sign-in code. |
| Webhook signature key | The payment-notification subscription’s key from the next section. |
NeroPOS does not generate pairing codes from this settings card. An ordinary Square dashboard sign-in code does not replace the required pairing. For customer payments, ask your installer to confirm the physical terminal is paired to your intended live location.
Automatic payment updates
- In the NeroPOS Square card, select Show / prepare webhook URL and copy the displayed address.
- In your Square Developer Console, select the application used by this connection and the matching environment for your connection.
- Open Webhooks → Subscriptions and add a subscription with the exact URL from NeroPOS.
- Select
terminal.checkout.updated. Do not add a trailing slash or change the URL to a docs page. - Copy the subscription’s Signature key into NeroPOS’s Webhook signature key field. This is different from your access token.
- Complete and verify/save the connection. Ask your installer to confirm notification delivery as well as the account/device connection.
The result is checked automatically before NeroPOS completes the bill. No scheduled task is needed. If you do not manage Square app settings, ask your authorised installer/support to complete the notification setup.
Enable in NeroPOS
- Open NeroPOS → Settings → Payments.
- Find your provider under Third-party payment integration. Complete its connection details, turn the connection switch on and select Verify & save connection.
- After verification, enable the provider under Enabled payment methods.
- If you want to use it for most card payments, choose it under Default payment method.
- Save the main POS settings. Saving the connection alone does not save your enabled-method/default choices.
Only the account owner or authorised support staff can change connection credentials. If you are a cashier or another staff member, ask your account owner to complete setup.
Take a payment
- Open the bill in NeroPOS and select Pay.
- Select the connected provider and choose Send to terminal.
- Check the amount on the terminal and ask the customer to complete payment.
- Wait for NeroPOS to confirm the final result before completing the bill.
The terminal receives the bill’s remaining amount. Keep your POS account and provider account/terminal currency consistent. This connection does not convert GBP to EUR or EUR to GBP.
The connection supports one saved terminal per provider for your merchant account. It collects the full remaining balance, rather than a custom split-payment amount. An internet connection is required.
Troubleshooting
| What you see | What to do |
|---|---|
| Device/pairing verification fails | Check you used the API-paired device ID and pairing record ID, not the short code or serial number. |
| Location or currency mismatch | Use the correct Square location with the same currency as NeroPOS. Do not change details merely to bypass verification. |
| Connection saves but results are delayed | Ask your installer to check the matching application/environment’s notification URL, event and signing key. |
| Uncertain payment after a timeout | Use Check status and check the Square payment history. Do not send another charge until resolved. |
Payments & refunds
The provider settles these payments under your agreement with them. They do not increase your NeroPay wallet balance.
For a refund, use the provider’s supported refund process. A provider refund is not automatically reflected in the NeroPOS bill/report by this connection. Contact support if the related POS record needs to be reconciled.
Accept customer payments only through an activated live connection. Account verification and saving credentials alone do not confirm live availability.
Get help
Contact NeroPay support through your usual dashboard/support channel. Include your merchant account ID, the provider name, the approximate payment time, amount/currency and the non-sensitive error shown on screen. If a payment attempt ID is displayed, include it.
Never include passwords, secret API keys, access tokens, webhook signing keys or full card details in screenshots, email or WhatsApp. Enter secret connection values only into the relevant secure settings fields. Do not delete payment records or force a bill to paid to resolve an uncertain transaction.