Connect Dojo to NeroPOS
Check Dojo availability, complete your account connection and understand payment results.
Live activation requires support confirmation
Before you start
This guide explains how your account owner or authorised installer prepares the Dojo account, terminal and payment notifications.
Your account owner or authorised installer completes the merchant account and terminal setup.
What you need
- Owner access to NeroPOS Settings.
- Access to the intended Dojo account/location and its private credentials for the environment authorised by support.
- An eligible terminal and the correct API terminal identifier.
- The reseller context confirmed for your connection by Dojo or your authorised installer.
If you cannot access Dojo’s Developer Portal, ask your Dojo account administrator or Dojo support. You can invite an authorised developer through Team members if someone is helping you with setup.
Connect your account & terminal
Use only the environment confirmed for your connection by NeroPay support. In the intended Dojo account/location, open Developer Portal → API keys → + Create new key to create the appropriate private key. Do not copy public demo keys or mix credentials from different environments.
| Field | What you enter |
|---|---|
| Secret API key | Your intended Dojo account/location’s private key for the authorised environment. |
| Reseller ID | The value confirmed by Dojo or your authorised installer for your connection. Do not guess it. |
| Terminal / device ID | The terminal’s API identifier from your Dojo device information. This may differ from its printed TID/serial number. |
| Webhook signature secret | The active signing value from the notification setup below; not your API key. |
Check the terminal/account details with Dojo or your installer if verification fails. This connection does not discover a nearby Bluetooth printer or reader.
Automatic payment updates
Complete notification setup before saving the Dojo connection. If you are not comfortable managing account integrations, ask your authorised installer or support to help.
- In the NeroPOS Dojo card, select Show / prepare webhook URL and copy the value displayed.
- In the same Dojo account and environment, open Developer Portal → Webhooks → + Add endpoint.
- Paste the exact URL provided by NeroPOS. Do not replace it with a documentation page address.
- Select the following events in the subscription:
payment_intent.status_updatedterminal_session.status_updatedterminal_session.signature_verification_required
- Copy the subscription’s active signing secret into NeroPOS’s Webhook signature secret field. Use the secret for that event subscription, not the merchant API key.
- Verify/save the connection and confirm notification delivery with your installer or support.
NeroPOS checks the notified result before applying a payment. You do not need a cron or scheduled task. If a payment requests signature verification, follow the on-screen Accept/Reject steps and wait for the final result.
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 |
|---|---|
| Connection is disabled | Check owner access and ask NeroPay support which connection options are available for your account. |
| Live approval warning | Do not accept customer payments. Ask NeroPay support to confirm live support and activate the connection; do not try to bypass the restriction. |
| Verification failed | Check the account/location, authorised key, reseller context, terminal ID and signing secret with your installer. |
| Expired or uncertain payment result | Check status and the provider record. An expired result does not prove that the customer was not charged. |
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.