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

# Payment terminal with Spirii POS

> Register, configure, and go live with a Spirii POS terminal at your charging location.

This guide covers setting up a Payter Apollo terminal with Spirii POS — from receiving the hardware to completing the first live transaction.

<Note>
  While many steps are similar to setting up a terminal for other POS solutions, please consult with your provider for any specific instructions.
</Note>

## Before you start

Decide which mode applies to your setup:

| Mode        | Who handles acquiring                  | Who is the Merchant of Record |
| ----------- | -------------------------------------- | ----------------------------- |
| **Turnkey** | Spirii requests the Merchant ID (MID)  | Spirii                        |
| **PAAS**    | You bring your own acquiring agreement | You                           |

If you are not sure which mode you are using, check with your Spirii account manager. The mode affects the setup steps for acquiring and the PCI-DSS obligations on your side.

## Steps

<Steps>
  <Step title="Receive and inspect the hardware">
    Confirm you have received:

    * Payter Apollo terminal unit(s)
    * Mounting hardware (bracket, pole mount, or charger-integrated housing as applicable)
    * Power and data cables (where applicable — some charger-integrated setups use the charger's connectivity)

    Do not mount the terminal before completing the registration step — terminal registration requires the serial number printed on the device.
  </Step>

  <Step title="Obtain a Merchant ID (MID)">
    The terminal needs a Merchant ID from a Payment Service Provider (PSP) to process payments.

    **Turnkey:** Inform Spirii of the location details (address, country, expected transaction volume). Spirii requests the MID from the appropriate PSP for that country.

    **PAAS:** Obtain a MID from your PSP (Worldline, Elavon, or another PSP compatible with Payter). Provide the MID to Spirii so it can be linked to the terminal in the platform.
  </Step>

  <Step title="Register the terminal with Payter">
    Each terminal must be registered with Payter before it can process payments.

    **Via the Payter portal:**

    1. Log in at [payter.com/registration](https://www.payter.com/registration)
    2. Enter the terminal serial number and the MID provided by the PSP.
  </Step>

  <Step title="Configure the terminal in Connect">
    **Via Spirii Connect:**

    1. Go to **Payment Terminals** and select **Add terminal**
    2. Enter the terminal's serial number
    3. Select the location and charge box(es) the terminal will serve
    4. Set the **Merchant** — the party whose name appears on driver receipts (Spirii, or a CPO business name for PAAS)
  </Step>

  <Step title="Verify connectivity">
    Ensure the terminal has a working internet connection:

    * **SIM (Spirii-managed or built-in):** confirm the SIM is active and the terminal shows a signal indicator
    * **LAN (via charger):** confirm the charger's network connection is active and the terminal is connected via Ethernet

    The terminal must be online to authenticate card payments. A terminal without connectivity cannot process transactions.
  </Step>

  <Step title="Complete a test transaction">
    Before going live, complete a test transaction on the terminal:

    1. Tap a Visa or Mastercard test card (or use your own card if no test card is available)
    2. Confirm the pre-authorisation appears on the card's statement
    3. Start and stop a session — verify the session appears in Spirii Connect and that the final charge is captured (not just pre-authorised)

    If the pre-authorisation appears but the capture does not, check the OCPP link between the terminal and the charger.
  </Step>

  <Step title="Go live">
    Once the test transaction succeeds:

    * Confirm the terminal's mounting is secure and the screen is accessible to drivers
    * Monitor the first real transactions in Spirii Connect or MyPayter to confirm sessions and payments are recording correctly
  </Step>
</Steps>

## Replacing a terminal

To replace a terminal (for example, if it is damaged or stolen):

1. In Spirii Connect, deactivate the old terminal
2. Receive the replacement unit
3. Follow the register, configure, verify, and test steps above for the new terminal

The replacement terminal uses the same location, charge box, and MID — you do not need to request a new MID.

## Related

<CardGroup cols={3}>
  <Card title="In-person payments" icon="credit-card" href="/capabilities/payments/in-person-payments">
    Overview of Spirii POS hardware, software, and modes.
  </Card>

  <Card title="Billing and payout flows" icon="building-2" href="/capabilities/billing-payouts/billing-and-payout-flows">
    How billing and payouts work for terminals, including turnkey vs PAAS.
  </Card>

  <Card title="Sessions and CDRs" icon="receipt" href="/components/charging/sessions-and-cdrs">
    How terminal sessions appear in billing and reporting.
  </Card>
</CardGroup>