# Connect Dojo to NeroPOS

Source: https://docs.neropay.app/neropos/connect-dojo-to-neropos
Last updated: 2026-10-06T01:25:01+00:00

# 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.

**Confirm live activation before accepting payments.** Dojo live payments are not enabled by the supplied integration. Contact NeroPay support before proceeding; the steps below describe connection setup and do not grant live access. Do not accept customer payments until live support has been confirmed and your connection has been enabled. Entering a production API key alone does not activate live payments.

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_updated` 
- `terminal_session.status_updated` 
- `terminal_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](https://eu.neropay.app/merchant/pos/settings?lang=en#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.

**Do not take the same payment twice.** “Sent”, “Pending” or “Unknown” does not confirm whether the customer has paid. If the result is uncertain, use **Check status** and check your provider’s transaction history before attempting another payment.

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.

## Provider help

- [Dojo: account and API-key access](https://docs.dojo.tech/payments/getting-started) 
- [Dojo: portal and device information](https://docs.dojo.tech/development-resources/portal) 
- [Dojo: notification settings](https://docs.dojo.tech/development-resources/webhooks)