Dojo
Connect your Dojo card terminal to Till using an API key. Get transaction-level sales data and payment insights.
Overview
Dojo is one of the UK's largest card terminal providers. Till integrates with Dojo using an API key that you generate in the Dojo Developer Portal. This gives Till access to your transaction data for sales analytics.
Dojo
Terminal-level payment reporting with transaction data, refunds, tips and card type breakdowns.
Unlike Square and SumUp which use one-click OAuth, Dojo requires you to generate an API key from your Dojo Developer Portal. This guide walks you through the process step by step.
What Till can access
With a Dojo API key, Till can access:
- Transactions: all card transactions including amounts, tips, cashback and card types
- Payment details: card type (Visa, Mastercard, etc.), funding type (credit, debit) and terminal ID
- Refunds: refunded transactions are tracked separately
What Dojo cannot provide
Dojo is a card terminal provider, not a full POS system. This means:
- No item-level data: Dojo does not know what individual products were sold
- No categories: there is no product catalogue in Dojo
- No modifiers or discounts: only the total transaction amount
This is normal for terminal-only providers. Till will show your revenue, transaction counts, payment breakdowns and trends but item and category analytics require a POS integration like Square.
How to connect
Log in to the Dojo Developer Portal
Go to developer.dojo.tech and sign in with your Dojo account.
If you do not have developer access, you may need to request it:
- Contact Dojo support or your account manager
- Ask to be added to the Developer Portal for your merchant account
- If you are a business owner, you can invite a developer by email from the portal
Navigate to API keys
Once logged in to the Developer Portal:
- Find the API Keys section in the navigation
- Click Create New Key (or Generate API Key)
- Select the live environment for your merchant account
Copy your API key
Your API key will look like this:
sk_prod_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxImportant: Copy and save your API key securely. Dojo may only show it once.
- Live account keys start with
sk_prod_
Connect in Till
- In the Till app, navigate to Settings then Connections
- Find the Dojo section
- Paste your API key into the input field
- Click Connect
Till will validate your API key by making a test request to the Dojo API. If successful, your connection status will show as Connected.
Start viewing data
Till will begin pulling your transaction history. Navigate to the Sales dashboard and select Dojo as your provider to see your data.
What you will see in Till
Once connected, your sales dashboard will show:
- Total revenue and transaction count for any date range
- Average transaction value and trends over time
- Sales by hour so you can see when your busiest card payment periods are
- Payment method breakdown covering Visa, Mastercard, Amex, debit vs credit
- Tips if tipping is enabled on your terminals
- Refunds tracked as separate refund transactions
API key security
- Your API key is stored securely in Till's database
- It is only used server-side to fetch your transaction data
- Till never exposes your API key in the browser
- You can revoke your API key at any time from the Dojo Developer Portal
Troubleshooting
Invalid API key
If you see an error when connecting:
- Check that you copied the full key including the
sk_prod_prefix - Make sure there are no extra spaces before or after the key
- Confirm the key has not been revoked in the Developer Portal
- Check that you are using your live account key
No data showing
- Dojo's Transaction API has a 7-day maximum query window. Till handles this automatically by chunking longer date ranges, but very large date ranges may take a moment to load
- Only completed transactions are returned
- Make sure your Dojo account has recent transaction activity
Key permissions
Your API key needs access to the Transaction API. If you are getting authorisation errors, check with your Dojo account manager that your key has the correct permissions.
Disconnecting
To disconnect Dojo, go to Settings then Connections and click Disconnect next to Dojo. This removes your stored API key from Till. You can reconnect at any time with the same or a new key.
Data capabilities
| Feature | Available |
|---|---|
| Transaction-level data | |
| Item-level data | |
| Categories | |
| Refunds | |
| Tips | |
| Cashback | |
| Card type breakdown | |
| Terminal ID | |
| Custom date ranges | |
| Staff attribution |
Live account access
Use a sk_prod_ key to access your live transaction data. Unlike OAuth integrations, API keys do not expire. However, you can regenerate or revoke them at any time from the Dojo Developer Portal.
Last updated 25 April 2026
Was this page helpful?
We use this to improve the docs.