Instant Pay

Shift work marketplaces are platforms that connect workers with on-demand or flexible shifts across industries like healthcare, hospitality, retail, light industrial and logistics.

These marketplaces often prioritize speed, flexibility, and convenience for both workers and employers. Instant pay refers to the ability for workers to access their earnings immediately after completing a shift, rather than waiting for a traditional payroll cycle (e.g., monthly or bi-weekly).

With HyperTrack APIs, developers can implement instant pay validation by leveraging the Orders API and on-device geofencing. Here’s a step-by-step guide to achieving this.

Core Components

On-Shift Tracking with Orders API

Reference: https://hypertrack.com/docs/shift-tracking#on-shift-tracking

The Orders API feature is a key part of instant pay implementation, enabling seamless tracking of worker shifts from pre-shift to on-shift activities. With on-shift tracking portion of Orders API, the solution captures detailed insights into worker actions at the job site, including geofence entry and exit, and time spent within geofenced order destination locations. These capabilities provide real-time proof of work and accurate data for calculating earnings, reducing disputes, and ensuring transparency. By leveraging features like geofences, metadata, and timeline annotations, the Orders API streamlines shift management and integrates effortlessly with payroll systems, ensuring timely and accurate payouts for instant pay.

Geofenced clock in/out

Reference: https://hypertrack.com/docs/geofenced-clock-in-out#add-clock-inout-tags-to-a-shift-timeline

The Geofenced clock-in and clock-out serve as a key part of instant pay implementation by ensuring instant feedback to the worker based on real-time location data and expected order destination location. By requiring workers to clock in and out only when inside the order geofence, this feature guarantees that clock-in and clock-out locations are presented to the worker at the correct time and place, even if the worker’s device is offline, eliminating payment discrepancies and disputes. The geotags associated with these events provide verifiable proof of work, enabling payroll systems to calculate earnings, lateness, and overtime seamlessly. This automation not only enhances operational efficiency but also ensures timely and accurate payouts, making geofenced clock-in and clock-out a critical enabler of instant pay implementation.

Utilizing the Orders API and Geofenced clock in/out

Set up Orders API

To begin, integrate the Orders API into your application. Refer to this guide section and Orders API reference to get implementation details.

In summary

• Creating orders with associated tasks, locations, and expected timelines.
  For example, if a worker is expected to perform work for a shift during certain time with expected duration of work at the order destination, create an Orders API payload that contains at least the following order data for a given worker_handle (unique identifier for your worker):
  • scheduled_at
  • place_handle
  • scheduled_at
  • expected_service_time
• Subscribing to order status updates through webhooks.
  Once the order is dispatched, you will receive webhook payloads, indicating status of the order. The key order webhook payloads that play a factor in the instant pay validation are:
  • Order arrived webhook which is sent once the worker arrives at the destination
  • Order exited webhook which is sent once the worker exits the site
  • Order completed webhook which is sent once the order is deemed complete through your workflow.
  • Order geotag webhook which is sent once the worker executes either a clock in or clock out action in the mobile app as explained in the section below.
• Once the order is completed, you can retrieve order summary information via Get Orders API to find the following information that can at least some of the key inputs to your instant pay validation implementation:
  • actual_service_time - Time in seconds that the driver is actually spent at the location when fulfilling the order
  • tracking_rate - Indicates tracking health for the order. Tracking rate of 1.0 indicates that worker’s device sent location data at all times, to give full visibility about worker’s whereabouts during the order.

Implement Geofenced clock in and clock out with geotags

Geofencing ensures presence at order destination to make sure your workforce is exactly where they need to be when clocking in or out. With this feature, you provide instant feedback to the worker about worker’s attempts to clock in and clock out as HyperTrack SDK validates the worker’s location in real-time.

Using this feature sets a clear expectation right in the mobile app to the worker about validity of the worker’s actions that are a critical input to instant pay validation. This allows to more accurately capture worker lateness and overtime in case of disputes.

Once worker’s action to clock-in or clock-out is validated, a geotag with the corresponding order_handle and order status ( which can be either ClockIn or ClockOut ) can be generated and sent from the worker’s mobile app.

As a result, HyperTrack in this case sends you a geotag webhook payload as a proof that worker’s clock in for clock out action was validated and thus executed.

Please refer to this guide section for details.

Getting started

By leveraging HyperTrack's Orders API and Geofenced Clock-In/Out capabilities, developers can implement an efficient and transparent instant pay system that benefits both workers and employers. These tools provide real-time proof of work, reduce payment disputes, and ensure accurate earnings calculations, creating a seamless experience for all stakeholders in shift work marketplaces.

HyperTrack's team is here to support your integration journey. Whether you need guidance on setup, help with integration and customization, or insights into optimizing your instant pay workflows, we’re ready to assist!