Setup PoyntOS Emulator

Poynt Smart Terminal Emulator

PoyntOS emulator running on AVD To help speed up your development and testing, we provide a developer-edition version of PoyntOS that can be run on an Android emulator or directly on an Android Tablet (Tegra Note 7 is recommended, but any 7” tablet would work as long as you code for multi-screen resolution including tvdpi). Note that certain functionality will not be available in the emulator (i.e. collecting consumer input from second screen, handling card payments, only manual credit entry supported, etc.); however, the emulator will give you enough functionality to start building and testing your apps. You’ll have access to the terminal application (key in transactions), the register (catalog-driven point of sale app), transaction data, customer data, and more.

Activating a PoyntOS virtual device on a device emulator is just like activating a physical Poynt Smart Terminal. Lets get started!

Prerequisites

Download and install emulator

Poynt Smart Terminal v1

Download and unzip the PoyntOS emulator installer here: PoyntOS_Emulator_v1.zip. Run the installation script setup_poynt_os.py

Poynt Smart Terminal v2 (for US & EU Region)

Download and unzip the PoyntOS emulator installer here: PoyntOS_Emulator_v2.zip. Run the installation script setup_poynt_os.py. Set the API level of emulator to 23.

Activating your virtual Poynt terminal

  1. The first time you boot up your device you’ll be asked to choose a launcher. Select Setup Wizard to start Poynt’s OOBE (“out of box experience”) application. NOTE: If you’re using Genymotion, enable Use virtual keyboard for text input option in device configuration.
  2. WiFi setup - select your SSID and WiFi credentials to connect.
  3. Once connected, you’ll be shown the device activation screen – keep the device running, we’ll get back to this shortly.
  4. From your laptop/desktop, point your browser to the Poynt HQ Developer Portal: https://poynt.net/auth/signup/developer – register to be a Poynt developer, or sign in if you already have.
  5. After signing in, click Create a Test Merchant from the dashboard – this will create a mock/test business for your development activity.
  6. After creating a test merchant, click Active a Poynt Terminal from the dashboard.
  7. A test terminal with the status Needs activation was created for you (in step 5 above) – click the lightning bolt icon to activate the terminal. You’ll see your activation credentials that you’ll use to activate your virtual Poynt terminal.
  8. Go back to your Poynt emulator terminal. If the camera is active and it’s looking for a QR code, click Don't have a QR code link. Select the acquirer, and enter the MID and TID values from your browser (in step 7 above).
  9. Once you activate the device, Poynt’s OOBE app disables itself.
  10. Click on the Home icon in your device or emulator then select Poynt Launcher as the launcher (select Always option).
Note: If after selecting Language you get a crash in logcat (java.lang.SecurityException: Not allowed to bind to service Intent { act=co.poynt.os.services.v1.IPoyntCapabilityManager }), just rerun the python installer script.

At this point, your device is setup with required services and applications so it can act as a Poynt Smart Terminal. Try launching the Poynt Terminal app and process a cash transaction to make sure everything is working as expected. If you encounter any errors, please refer to adb logcat. This is very useful to pinpoint what’s failing. If you do need any assistance, head over to the Poynt developer discussion forums, or reach out to our support team.

Poynt 5 Emulator

1) Open AVD Manager in Android Studio

Create Cloud Application

2) Click on Create Virtual Device… button

Create Cloud Application

3) Click on New Hardware Profile button

Create Cloud Application

4) Set the device name, resolution 720x1280, RAM, Orientation and Camera options

Create Cloud Application

5) Select Marshmallow system image (without Google Play Services)

Create Cloud Application

6) Click on Finish button

Create Cloud Application

7) After that you should see a new virtual device “Poynt 5”. Launch the virtual device you just created.

Create Cloud Application

8) Download the Poynt 5 emulator installer and unzip the archive. Run the python installer script. After the installer finished running you should see the following screen:

Poynt 5 (US)

Poynt_5_OS_Emulator.zip

Poynt 5 (EU)

Poynt_5_OS_Emulator.zip

Create Cloud Application

9) Select and run Setup Wizard

Create Cloud Application

10) You may get “Poynt Services has stopped” warning but it can be ignored if in the logcat you see “No permission to write APN settings”

Create Cloud Application

Create Cloud Application

11) Click Continue

Create Cloud Application

12) Click on Don’t have a QR Code?

Create Cloud Application

13) Select the a acquirer that matches your test merchant account configuration

Create Cloud Application

14) Enter MID and TID

Create Cloud Application

15) Create a new user if applicable or click “Log in” if you have existing users

16) Tap the Home button, select “Poynt Launcher” and tap on ALWAYS

Create Cloud Application

Your Emulator is set up!