---
title: Terminal | Ezypay Tap to Pay
description: ezypay
---

[Skip to content](https://support.hapana.com/kb/article/872#main-content)

English

Show submenu for translations

[![email-logo.png](https://support.hapana.com/hs-fs/hubfs/hapana_2022/email_2022/footer%20logo.png?width=300&height=78&name=footer%20logo.png)](https://info.hapana.com/en?hsLang=en)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- [Submit Ticket](https://21gxv.share.hsforms.com/2-8HozJXMSTW8kaFHC32eaw)

[Submit Ticket](https://21gxv.share.hsforms.com/2-8HozJXMSTW8kaFHC32eaw)

 Hapana Help | Find answers here

- There are no suggestions because the search field is empty.

1. [Hapana Knowledge Base](https://support.hapana.com/?hsLang=en)
2. [Member Management](https://support.hapana.com/member-management?hsLang=en)
3. [Retail Configurations](https://support.hapana.com/member-management?hsLang=en#retail-configurations)

# Terminal | Ezypay Tap to Pay

##### **Overview**

You can now take **in-person payments** using Ezypay’s Terminal API integration. This allows your staff to process card-present transactions directly from supported terminals - no more manual EFTPOS entries or reconciliation.

Payments are initiated through the Hapana platform, linked to client records, and tracked in real time. This means faster checkouts, fewer errors, and a smoother client experience.

 Prerequisites

- An **Ezypay account** with terminal support enabled.
- A **configured payment terminal** (added under **Retail Configuration**).
- **Device Name** and **Device ID** must be entered when adding a new terminal.

---

#### **Set Up Ezypay Terminal Reader**

Ezypay’s Tap to Pay solution lets NFC-enabled mobile devices accept credit and debit card payments. It currently supports Mastercard and Visa in Australia.

Merchants install the Ezypay mobile app on a [compatible device](https://developer.ezypay.com/docs/terminal-integration#terminal-device-requirements) to enable payments. Before use, the device must be registered and activated via the integrator’s (Hapana) platform.

#### **Terminal Device Requirements**

| Android | iPhone |
| --- | --- |
| Minimum Android 12, with March 5th 2022 security patch | Minimum iOS 17.0 |
| Must not be a payment terminal | Must not be a payment terminal |
| Must not have an integrated card reader | Must not have an integrated card reader. |
| Must have an integrated NFC reader | Must have a screen lock passcode configured on the device |
| Must have an integrated touch screen | The iPhone model must be iPhone XS or later |
| Must support [hardware key attestation](https://developer.android.com/privacy-and-security/security-key-attestation) and be [Google-certified](https://storage.googleapis.com/play_public/supported_devices.html) . |   |

 

---

### **Connect Terminal Reader in Hapana**

#### 1. Add a New Terminal 

1. Go to **Payments \> Retail Configurations** in your Core account
2. Select **Terminal Readers** from the list 
3. Click **Add New Reader**

![Article image](https://support.hapana.com/hs-fs/hubfs/Knowledge%20Base%20Import/image-20250911092931-1.png?width=670&height=294&name=image-20250911092931-1.png)

4\. Enter a **Device Name.** This is how you will locate your reader.

5\. Enter the Registration Device ID as shown on the Ezypay’s Tap to Pay app in the “**Enter your Device ID**” section 

6\. Click **Finish** to Save the terminal

7\. The Activation Code will display in **Payments \> Retail Configurations \> Terminal Readers \> Code**. Enter this Activation Code into the **Ezypay Tap to Pay** mobile app.

8\. A success message will display and you will see your new terminal listed 

![Article image](https://support.hapana.com/hs-fs/hubfs/Knowledge%20Base%20Import/image-20250922100849-1.png?width=670&height=236&name=image-20250922100849-1.png)

---

#### 2. Collecting Payment

1. During checkout, select **Card/Bank **payment option
2. **Terminal (EzyPay) **as the payment method
3. Choose the **active terminal** from the dropdown list at the bottom left 
4. Select **Process via Terminal** 

![Article image](https://support.hapana.com/hs-fs/hubfs/Knowledge%20Base%20Import/image-20250930184625-1.png?width=670&height=319&name=image-20250930184625-1.png)

5\. The payment request is sent to the selected terminal and the terminal displays the amount for the customer to tap their card

6\. Use your terminal to process the transaction

![Article image](https://support.hapana.com/hs-fs/hubfs/Knowledge%20Base%20Import/image-20250930184852-2.png?width=670&height=430&name=image-20250930184852-2.png)

---

#### 3. Confirm and Track Results

- Once completed, the payment result appears instantly in your system.
- An **invoice** is auto-linked to the client’s profile.
- Payment method shows as Card (Terminal)

---

#### 4. Delete a Terminal Reader

You can delete your terminal reader using the steps outlined below:

1. Go to **Payments \> Retail Configurations** in your Core account
2. Select **Terminal Readers** from the list 
3. Click the red 'Trash' icon

![Article image](https://support.hapana.com/hs-fs/hubfs/Knowledge%20Base%20Import/image-20250911100817-2.png?width=670&height=233&name=image-20250911100817-2.png)

---

**Expected Outcome**

By following these steps, your team can:

- Accept card-present payments seamlessly through Ezypay terminals.
- Track real-time payment results without manual reconciliation.
- Ensure receipts and logs are automatically linked to client accounts.

---

**FAQ**

**Q: Can I cancel a payment once it’s started?**  
A: Yes. Select **Cancel Payment** before the terminal confirms the transaction.

**Q: Why isn’t my terminal showing up at checkout?**  
A: Check that the device has been added correctly with **Device Name** and **Device ID**, and that its status is **Active**.

---

Need more help? Reach out to our support team via [support@hapana.com](mailto:support@hapana.com).

- [Member Management](https://support.hapana.com/member-management?hsLang=en#main-content)

    - [Account Settings](https://support.hapana.com/member-management?hsLang=en#account-settings)
    - [Client Accounts](https://support.hapana.com/member-management?hsLang=en#client-accounts)
    - [Edit Profile](https://support.hapana.com/member-management?hsLang=en#edit-profile)
    - [Retail Configurations](https://support.hapana.com/member-management?hsLang=en#retail-configurations)
    - [Other](https://support.hapana.com/member-management?hsLang=en#other)
    - [Schedule](https://support.hapana.com/member-management?hsLang=en#schedule)
    - [Client Page](https://support.hapana.com/member-management?hsLang=en#client-page)
    - [General](https://support.hapana.com/member-management?hsLang=en#general)
    - [Reporting](https://support.hapana.com/member-management?hsLang=en#reporting)
    - [Retail Dashboard](https://support.hapana.com/member-management?hsLang=en#retail-dashboard)
    - [Team Settings](https://support.hapana.com/member-management?hsLang=en#team-settings)
    - [Hapana Member Access Control (MAC) Doors](https://support.hapana.com/member-management?hsLang=en#hapana-member-access-control-mac-doors)
    - [Cash Drawer](https://support.hapana.com/member-management?hsLang=en#cash-drawer)
- [Marketing Solutions](https://support.hapana.com/marketing-solutions?hsLang=en#main-content)

    - [App](https://support.hapana.com/marketing-solutions?hsLang=en#app)
    - [Contacts](https://support.hapana.com/marketing-solutions?hsLang=en#contacts)
    - [Marketing](https://support.hapana.com/marketing-solutions?hsLang=en#marketing)
    - [Conversations](https://support.hapana.com/marketing-solutions?hsLang=en#conversations)
    - [Settings](https://support.hapana.com/marketing-solutions?hsLang=en#settings)
    - [Automations](https://support.hapana.com/marketing-solutions?hsLang=en#automations)
- [Branded Solutions](https://support.hapana.com/branded-solutions?hsLang=en#main-content)

    - [Branded App](https://support.hapana.com/branded-solutions?hsLang=en#branded-app)
    - [Branded Kiosk](https://support.hapana.com/branded-solutions?hsLang=en#branded-kiosk)
- [Hapana Hub](https://support.hapana.com/hapana-hub?hsLang=en)
- [Website Embed Widgets](https://support.hapana.com/website-embed-widgets?hsLang=en)

- [About us](https://hapana.com/about-us/)
- [Careers](https://hapana.com/careers/)
- [Contact us](https://hapana.com/contact-us/)
- [Privacy policy](https://hapana.com/privacy-policy/)
- [Terms & conditions](https://hapana.com/terms-and-conditions/)

[![email-logo.png](https://support.hapana.com/hs-fs/hubfs/hapana_2022/email_2022/footer%20logo.png?width=300&height=78&name=footer%20logo.png "email-logo.png")](http://hapana.com?hsLang=en)

Copyright © 2025, Hapana