Procure SmartPOS

 

Provide stand-alone point of sale devices with WePay's Smart POS Terminal solution. Smart POS eliminates the need for two separate pieces of hardware to complete a single transaction. In WePay's standard card present transaction flow:

  1. the merchant will ring up a customer on a given device
  2. that device sends the authorization initialization to either a mobile card reader or a terminal
  3. the customer presents their card to the mobile card reader or terminal
  4. the mobile card reader or terminal uses the Card Present SDK to return an encoded payment method

With Smart POS, the transaction flow is simplified to:

  1. the user constructs a transaction in your own client application using our SDK and then deploys to the Smart POS device
  2. your client application initializes the authorization on the Smart POS device
  3. the customer presents their card to the Smart POS device
  4. the Smart POS device communicated with the Card Present SDK to return an encoded payment method

With this streamlined Smart POS solution, you can fulfill a number of use cases including, but not limited to:

  • Setting the device at restaurant tables so that customers can order and pay at their leisure
  • Traveling with the device without having to pair two devices together
  • Managing multiple employee logins to the device

XAC AT170R

BETA

This device is currently in BETA

Product image of the XAC device.
Product image of the XAC device.

Features:

  • WiFi and 4G connectivity
  • Contactless card reader (NFC)
  • Mag stripe card reader
  • Chip card reader
  • Encrypted PIN
  • Audio jack and microphone
  • Receipt printer
  • Android OS; install your own app on the same device
  • Device management system (DMS):
    • Device location and status
    • Ability to remotely lock device
    • Custom software bundles

A few items differentiate the Smart POS Terminals from the standard Terminal models offered. The following functions are not currently supported for Smart POS in the Android SDK:

  • Cancel - The cancel operation on Smart POS Terminals is controlled by the user in the Smart POS app which then calls the WePay Android SDK itself. Thus, the cancel SDK function should not be implemented by your own app.
  • Stop - Once the native card reader on the Smart POS device has completed an operation, it is not bonded to its current state and thus does not need to be stopped. That said, the stop function can be useful to stop the foreground service and any other pending tasks on the device.
  • Calibrate - Calibration is a function for connecting a Terminal or Mobile Card Reader to the device which houses your app. Since both of these devices are in one with Smart POS, the calibration function should not be used.
  • Update - Updates will be performed automatically at the time they become available; there is no default maintenance window for Smart POS. Updates to the XAC device may take up to 10 minutes to reflect changes.

Another difference for Smart POS devices is that manual on-device connection will use 127.0.0.1 as the IP address.


Smart POS UI

Write a client application to interface with the Smart POS device and the Card Present SDK to initialize an authorization. Once an authorization has been initialized, the Smart POS device will take the user through the pre-installed payment application as seen in the images below.

Note

Once a transaction moves to the Smart POS payment application, users should not leave the app until the transaction is complete. If this happens, the transaction must be resumed from the notification tray before any other actions can be taken.

Here's what the Smart POS payment application look like:

Initiate Authorization

The pre-built 'start auth' UI on the XAC device.
The pre-built 'start auth' UI on the XAC device.

Authorization Complete

The pre-built 'auth complete' UI on the XAC device.
The pre-built 'auth complete' UI on the XAC device.

Prompt for PIN

The pre-built 'pin prompt' UI on the XAC device.
The pre-built 'pin prompt' UI on the XAC device.

Credit / Debit Selection

The pre-built 'credit debit selection' UI on the XAC device.
The pre-built 'credit debit selection' UI on the XAC device.

Procure Smart POS

Work with your integration team to gain access to the device management system (DMS). DMS allows you to onboard and manage Smart POS devices, as well as view device performance and analytics. Note that any applications you plan on loading onto the device must go through a formal review and signing process, after which WePay will make the APK(s) available in DMS for you to load onto devices.

Once your DMS is configured, merchants will be able to order devices from you, and WePay's third-party vendor will handle fulfillment of merchant orders.

Similarly, you'll work with your integration team to gain access to User Acceptance Testing (UAT) devices.

Before providing the User Manual document to your merchants, remove any sections which are not relevant to them.




Onboard Smart POS

Onboard UAT Devices

To onboard UAT Smart POS devices, you'll need these items:

  • A WePay stage merchant -- Legal Entity and Account with the terminals capability enabled (find out more here)
  • UAT instance of DMS (work with your integration team to get this set up)
  • UAT Smart POS device

Once the above is complete, follow these steps to onboard the UAT Smart POS:

  1. Turn on the UAT device
  2. Send a POST /terminals server API request to automatically onboard the device
  3. Validate that the device is onboarded:
  • Create an authorization on the device
  • Capture the authorization (either with the server API or SDK request)
  • Make a getInfo call and examine at the terminal ID in the response. If the value is null, then the Smart POS device has not been onboarded
  1. Begin testing and integrating

Onboard Production Devices

To onboard production Smart POS devices, you'll need these items:

  • Successfully onboarded users and devices in UAT
  • Production instance of DMS (work with your integration team to get this set up once UAT testing is complete)
  • A merchant should have ordered the device, which has been fulfilled and shipped to them

Note that WePay will not pre-load production devices with your client application. You'll provide any APKs to WePay for a formal review and signing process, after which you can manage loading applications to devices manage from DMS. Work with your integration team for this step.

Once the above is complete, follow these steps to onboard the production Smart POS:

  1. Merchant must turn on the device
  2. Send a POST /terminals server API request to automatically onboard the device
  3. Validate that the device is onboarded:
  • Create an authorization on the device
  • Capture the authorization (either with the server API or SDK request)

Ensure Merchant Readiness

The requirements that merchants must meet before onboarding a Smart POS device are the same as the general Terminal requirements.