Home

Integrations

Table of Contents

Integrate Octopus with the Eats365 POS

Learn how to integrate Octopus services to the Eats365 POS.

Octopus is a versatile payment service that offers customers the option to pay with their physical Octopus card or through the Octopus app. When configured with Eats365, Octopus can process payments with an Octopus card or the Octopus app QR code feature, and facilitate Octopus card top-ups.

For card payments, you can connect an Octopus machine (Octopus Reader 2.0 and Octopus Reader 3.0) or integrate Octopus with compatible payment readers, such as Global Payments or EFT Pay. Alternatively, customers can also use the Octopus app to scan merchant-provided QR Codes directly within the Octopus app to process their payment.

In this article, you’ll learn how to set up Octopus for card payments, online payments using QR code and Octopus card cash-ins and detail inquiries.

Before you start

Depending on whether the restaurant is using online or offline Octopus payment processing, you’ll need the appropriate license to integrate Octopus services with the Eats365 POS.

To purchase a license, contact Eats365.

Octopus setup

Required POS license

Use standalone Octopus payment service for online payments

Important: To set up Octopus Online, you’ll need a mobile device with the “Octopus for Business” app installed. During integration, you’ll be asked to log in your Octopus for Business credentials to complete the integration process.

Octopus Online restaurant license

Configure Octopus with compatible payment readers such as Global Payments or EFT Pay

No additional license needed

Note: The compatible payment reader may require its own license to be set up.

Octopus integration process

1. Enable Octopus on the Merchant Portal

To set up Octopus on the Merchant Portal, follow the steps below:

Log in to Merchant Portal.
On the left panel, click on Restaurant Settings.
Click on Payment Settings. Then, select Integrated Payment Settings.
From the list of payment services, find Octopus Online or Octopus (Integrated).
Configure the settings required for Octopus integration. Depending on the intended Octopus setup, refer to the "Octopus Online" and "Octopus (Integrated)" sections below:

Octopus Online

Delete

Important: To set up Octopus Online, you’ll need a mobile device with the “Octopus for Business” app installed. During integration, you’ll be asked to log in using your Octopus for Business credentials to complete the integration process.

Using your mobile device, scan the QR code. You’ll be directed to the Octopus for Business app.
Follow the on-screen steps to link your Octopus account to Eats365.
Once you’ve completed the linking process, return to the Merchant Portal to confirm that the linking was successfully recognized by the system.

If your Octopus account was successfully linked, your Octopus account information will be displayed under "Octopus Online."

Delete

Octopus (Integrated)

Turn on Enable .
To enable cash-ins for Octopus cards for the whole restaurant, turn on Enable Top-up .
To use an Octopus Reader 3.0 with the Eats365 POS, enter the Pair Token provided by Octopus. If this does not apply to the restaurant setup, you can skip this field. If you input the Pair Token, you won't need to enter it again during the Octopus Reader pairing setup in the POS.
Important: This Pair Token is provided by Octopus and is necessary to connect an Octopus Reader machine.
At the bottom right, tap Save.

Delete

2. Connect an Octopus card reader to the POS

To pair an Octopus machine with the POS, follow the steps below:

Log in to the Eats365 POS.
Tap Settings .
Under "Integrated Payment," select Octopus Reader Setup.
Choose the card reader type you'll be pairing, then tap Confirm.
The pairing steps vary depending on the chosen device. Refer to the "Octopus Reader 2.0" and "Octopus Reader 3.0" sections below for the instructions:

Octopus Reader 2.0

Tap Scan Card Reader. All newly detected card readers appear on the left panel along with the “New” indicator below the card reader name.
Select the card reader you'd like to connect. Then, follow the in-app steps.

Delete

Octopus Reader 3.0

Once you've selected Octopus Reader 3.0 as the chosen device, a prompt explaining the procedure appears on the screen.
- Activate the Octopus Reader 3.0 hardware: Use a thin object, such as a long needle, to press the hidden button located on the back of the device.
- Take note of necessary pairing details for the next steps: Once the reader initializes, it will display a screen with the necessary device pairing information you'll need to complete the setup. Specifically, you must take note of the IP Address, API Request, and API Token ID to connect the reader and the POS. The "Device Pairing" screen is only displayed for two minutes.
After performing the indicated steps, tap Confirm.
Enter the following Octopus reader information:
Note: You can find these details on the Octopus Reader 3.0 device.
- IP Address
- HWID
- API Request
- Pair Token
  Note:
  - The Pair Token is an Octopus-provided credential. If you don't have this with you, contact Octopus support.
  - If the Pair Token was entered in the Merchant Portal Integrated Payment settings for Octopus (Integrated), you can leave this blank.
Once you've entered the IP Address, HWID, API Request, and Pair Token (if applicable), tap Next. If the device is detected, the Octopus Reader 3.0 will beep, indicating that the device has been found and is ready to be paired.
Enter the API Token ID indicated on the Octopus Reader 3.0. This code only appears on the same setup screen if the connection between the POS and the reader is successfully established.
Tap Pair to continue. Then, once the connection is successful, tap Confirm.