> ## Documentation Index
> Fetch the complete documentation index at: https://docs.florists.digital/llms.txt
> Use this file to discover all available pages before exploring further.

# Dojo

> Connect Dojo to take card payments on a terminal at your counter, by payment link or over the phone, with refunds from the order screen.

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

<Info>
  **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](/settings/team).
</Info>

This page is the full setup tutorial. For the other card processors you can connect, see [Payment integrations](/settings/integrations/payments).

## 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.** Generates a link for one order that you copy and send to the customer by text or email. Generating again while that link is still outstanding hands you the same link rather than a second one.
* **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.

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](https://digitalflorists.com/card-payments) 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

<Steps>
  <Step title="Open the Dojo integration">
    In **Settings** > **Advanced** > **Integrations**, find **Dojo Payments** under **Available** and click **Install**.
  </Step>

  <Step title="Fill in the fields">
    | Field                                 | What goes in it                                                                                                             |
    | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
    | **Environment**                       | **Live** for real payments, or **Sandbox** to trial it first.                                                               |
    | **API Key**                           | The key from your Dojo account. It has to match the environment you picked: `sk_prod_` for Live, `sk_sandbox_` for Sandbox. |
    | **Webhook Signing Secret (optional)** | Leave this blank unless Dojo has given you a signing secret to use. If you paste one in, keep it private.                   |

    The key and the environment have to agree: a sandbox key saved against **Live** is refused.
  </Step>

  <Step title="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.
  </Step>
</Steps>

<Tip>
  **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.
</Tip>

## Adding a card terminal

Card terminals live in **Settings** > **Advanced** > **Payment Terminals**. Click **Sync from Dojo** to pull in the terminals on your Dojo account, or **Register Terminal** to add one by hand. Registering, pairing a terminal to a till, syncing and removing terminals are all covered in [Payment Terminals](/settings/payment-terminals).

## Taking a card payment at the till

<Steps>
  <Step title="Choose the Dojo card terminal">
    On the till, or on the order's payment screen, pick **Dojo Card Terminal** and check the amount.
  </Step>

  <Step title="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**.

    Terminals Dojo reports as busy or offline stay in the list greyed out. When none of them is free, the list shows **No terminal currently available**.
  </Step>

  <Step title="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.
  </Step>
</Steps>

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](/daily-operations/refunds).

## Common questions

<AccordionGroup>
  <Accordion title="The till says no active Dojo terminal is registered.">
    The message reads:

    > No active Dojo terminal is registered. Register one under Settings → Payment Terminals and set its status to Active.

    Open **Settings** > **Advanced** > **Payment Terminals**, click **Sync from Dojo**, and check the terminal you want shows **Active**. If it isn't listed at all, register it with **Register Terminal**.
  </Accordion>

  <Accordion title="The terminal list says no terminal is currently available.">
    Your terminals are registered, but Dojo reports none of them free at that moment. Usually one is part-way through another sale, or a terminal is switched off or off the network. Unavailable terminals stay in the list greyed out so you can see which one to check, and **Sync from Dojo** refreshes what your dashboard shows.
  </Accordion>

  <Accordion title="Nothing came back from the terminal. Can I just try 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**.
  </Accordion>

  <Accordion title="Can I move a terminal to another shop location?">
    Until it has taken its first payment, yes: open it with **Edit** and change the **Location**. After that the location is fixed. Deprovision the terminal and register the device against the other location instead.
  </Accordion>

  <Accordion title="What happens if I refund in the Dojo dashboard instead of the order?">
    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.
  </Accordion>

  <Accordion title="Can I take phone payments with Dojo?">
    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.
  </Accordion>
</AccordionGroup>

## What's next?

<Columns cols={2}>
  <Card title="Payment integrations" icon="credit-card" href="/settings/integrations/payments">
    The other card processors you can connect, and what each one needs.
  </Card>

  <Card title="Point of sale" icon="cash-register" href="/daily-operations/pos">
    Ringing a sale through the till and taking the payment.
  </Card>

  <Card title="Refunds" icon="rotate-left" href="/daily-operations/refunds">
    Issuing refunds from the order screen, and how they route back to the card.
  </Card>

  <Card title="Payment methods" icon="money-bill" href="/daily-operations/payment-methods">
    How the Dojo payment methods appear to staff on the order screen.
  </Card>
</Columns>

<p className="mt-8 text-xs text-gray-500 dark:text-gray-400">Dojo is a trading name of Paymentsense Limited, authorised and regulated by the Financial Conduct Authority (FRN 738728).</p>