Skip to main content
Dojo connects the card terminals on your Dojo account to your till, so a card sale at the counter lands on the order without anyone keying the amount into the machine.
This page covers features gated by Admin-tier permissions — typically Settings access. Admins have these by default; your administrator can adjust who has them in Settings > Team.
This page is the full setup tutorial. For the other card processors you can connect, see Payment integrations.

What it does

Connecting Dojo adds three payment methods for staff to pick from on an order or at the till.
  • Dojo Card Terminal. Sends the amount to a card terminal in your shop. This is the one that appears at the till.
  • Dojo Payment Link. Sends the customer a link for an order by email or text from the Payment Link panel, or copies it for you to share yourself. An order has one live link at a time, so making a new one, or choosing Replace Link when the amount owed changes, takes the old one down first. See Payment links.
  • Dojo Virtual Terminal. Opens a Dojo-hosted card form in your dashboard for a card the customer reads out over the phone, so the terminal on the counter stays free for the queue.
Switch each method on or off, and choose where staff can take it, in Payment Methods. Whichever way the payment was taken, refund it from the order screen and the money goes back to the customer’s card through Dojo.

Before you start

  • A Dojo account. If you don’t have one, send the card payments enquiry form and Dojo will come back to you with a quote for your shop.
  • An API key generated in that Dojo account. Live keys start sk_prod_; sandbox keys start sk_sandbox_.
  • Any card terminals you want to use at the counter already on the same Dojo account. Digital Florists reads your terminals from Dojo rather than supplying them.

Connecting Dojo

1

Open the Dojo integration

In Settings > Advanced > Integrations, find Dojo Payments under Available and click Install.
2

Fill in the fields

The key and the environment have to agree: a sandbox key saved against Live is refused.
3

Save, then take a test payment

Save the integration. Digital Florists checks the key with Dojo, adds the three Dojo payment methods for staff, and registers the card terminals already on your Dojo account.Take a small real payment end to end (a pound or two on your own card) and check it lands on the order. Then refund it from the order screen to confirm the whole loop works.
Want to trial it without real money first? Pick Sandbox and paste a sk_sandbox_ key. When you’re happy, switch Environment to Live, paste the sk_prod_ key and save again.

Adding a card reader

Your Dojo terminals appear in Digital Florists as card readers, under Settings > Advanced > Payment Methods > Card Readers. The ones already on your Dojo account are added there when you connect Dojo, unpaired and in your first shop. Give each one a name staff will recognise and pair it with the till it sits beside, because a till only offers Dojo Card Terminal when a reader is paired with it. A reader you add to your Dojo account later comes in the same way when you click Check with Dojo on the Card Readers tab. To register one yourself instead:
1

Open Card Readers

Go to Settings > Advanced > Payment Methods > Card Readers and click Register Card Reader.
2

Enter the reader's details

Give the reader a Name staff will recognise, such as Front counter. Enter the Serial number from the back of the reader and the Dojo terminal ID shown for it in your Dojo account.
3

Pair it and register it

If you run more than one shop, choose the reader’s Shop, because Paired till only lists that shop’s tills. Choose the till it sits beside under Paired till, or leave it Not paired yet to pair it later from the reader’s row, then click Register Card Reader.
Pairing, checking, renaming, moving, switching off and removing readers are covered in Card Readers.

Taking a card payment at the till

1

Choose the Dojo card terminal

On the till, or on the order’s payment screen, pick Dojo Card Terminal and check the amount.
2

Send it to a terminal

If the till is paired with a terminal, or only one terminal is free, the amount goes straight over. Otherwise pick one under Card terminal and click Send to Terminal.A reader that was offline when Digital Florists last checked with Dojo stays in the list greyed out. When none of them can be picked, the list shows No terminal currently available.
3

Follow the terminal

The payment screen follows the machine while the customer presents their card and enters their PIN. Cancel stops the payment while it’s still waiting for a card; once the card has been presented, the sale runs on to a result.
A card payment on a till sale goes into that till’s session, so open the till first, unless Take payments with no point of sale session open is on in Point of Sale settings. If the terminal asks for the signature on the receipt to be checked, the payment screen waits for Approve Signature or Reject Signature before it finishes. A declined or cancelled payment says so on the payment screen and offers Retry, and the order stays unpaid. If no result comes back at all, check the card machine’s own screen before you retry, so a payment that did go through isn’t taken twice.

Refunds

Refund from the order screen and the money goes back to the customer’s card through Dojo, and the order’s payment record updates to match. Issue the refund in the Dojo dashboard instead and the order picks it up on its own, so the two agree either way. See Refunds.

Common questions

The message reads:
No active Dojo card reader is registered. Register one under Settings > Payment Methods > Card Readers and switch on “Take card payments”.
Open Settings > Advanced > Payment Methods > Card Readers. If the reader is listed, open its Options, switch on Take card payments and click Save Changes. If it isn’t listed, add it with Register Card Reader.
Your readers are registered, but each one was offline, or missing from your Dojo account, the last time Digital Florists checked with Dojo. They stay in the list greyed out so you can see which one to check. Switch the reader on and make sure it’s connected, then click Check with Dojo on the Card Readers tab so staff can pick it again.
Check the card machine’s own screen first. If the payment went through there, record it against the order rather than sending it again, so the customer isn’t charged twice. If the machine shows nothing, click Retry.
Until it has taken its first payment, yes: open its Options on the Card Readers tab and change the Shop. After that, its shop can’t be changed.
The order’s payment record updates to match, so the two agree either way. Refunding from the order screen is still the tidier habit, because it records who issued the refund and why.
Yes, two ways. Dojo Virtual Terminal opens a Dojo-hosted card form in your dashboard for a card the customer reads out, and Dojo Payment Link sends them a link to pay themselves. Both record the payment against the order, and neither needs the terminal at the counter.

What’s next?

Payment integrations

The other card processors you can connect, and what each one needs.

Point of Sale

Ringing a sale through the till and taking the payment.

Refunds

Issuing refunds from the order screen, and how they route back to the card.

Payment Methods

Where staff can take the Dojo payment methods, on orders and at each till.

Dojo is a trading name of Paymentsense Limited, authorised and regulated by the Financial Conduct Authority (FRN 738728).

Last modified on October 14, 2026