# PosPlugin

> PosPlugin is an integration layer for point-of-sale (POS) systems. It connects to a merchant's POS, uses AI to map the POS's fields to one clean data model, and serves the result as one REST API plus webhooks, so software teams connect new merchants in minutes instead of building one integration per POS.

Tagline: Any POS. One API. Live in 30 minutes.

## Status
Early access, not generally available. The website and the early-access list are live (the list runs on a Cratefield-harness Worker at api.posplug.in). The product (connectors, AI mapping engine, unified API, sandbox) is being built; access opens in waves. First vertical: restaurants. The API examples on the site (api.posplug.in/v1/...) show the planned shape of the API; the endpoint is not public yet.

## Who it is for
- SaaS vendors (loyalty, delivery, accounting, BI) that need data from many merchants' POS systems: one API instead of one integration per POS
- Multi-location operators running different POS systems per site: unified data without swapping hardware
- POS resellers and implementers: merchants on third-party apps the same day

## How it works: three layers plus monitoring
1. Connector layer: OAuth, API keys and partner credentials; polling or webhooks with retries and rate limits; templates for REST, GraphQL and file exports
2. AI mapping engine: reads API docs, specs or sample payloads; puts a confidence score on every field; every confirmed mapping improves the next one
3. Unified API + webhooks: one REST API and one event stream (order.created, order.updated, payment.captured, item.updated, location.synced); the original POS payload is kept on every record; two-way where the POS allows (inject orders)
- Health monitoring (always on): detects schema drift and failing syncs, suggests a mapping fix, alerts ops with what broke and why

AI proposes, humans confirm: low-confidence mappings never go live without a person approving them.

## The 30-minute connection (six steps; a design target on POS PosPlugin supports, not a measurement)
Some POS (Toast, Lightspeed, SpotOn, Oracle) only open their APIs to approved partners, which takes weeks to months; those are not 30-minute connections until PosPlugin is approved.
1. Pick POS (1 min): search the list or type its name; planned: if it is missing, upload its API docs and PosPlugin drafts a connector (only for POS with a documented API)
2. Connect (3 min): OAuth, or paste an API key
3. Discover (5 min): pull sample data read-only (locations, catalog, orders, payments); nothing is written to the POS
4. Review AI mapping (10 min): confirm the fields the AI flagged as low confidence
5. Test (5 min): one real test order end to end, including the webhook
6. Go live (3 min): pick locations and switch on

## Example request (planned API)
curl "https://api.posplug.in/v1/orders?location_id=loc_8f2k" -H "Authorization: Bearer $POSPLUG_KEY"
Returns orders in one shape whichever POS is behind them: id, location_id, channel, status, line_items (name, qty, unit_price in minor units), tax, tip, total, currency, pos (type, ref), created_at.

## Security
Designed in, not yet audited (early access):
- No card numbers: PosPlugin never receives full card numbers, only brand and last four as the POS returns them; designed to stay out of PCI card-data scope
- Encrypted in transit and at rest; POS credentials kept in a secrets vault
- Per-tenant isolation
- Full audit log of mapping changes and AI decisions
- Built for GDPR: data export, deletion, regional storage options, and a DPA listing every sub-processor

## Pricing
- Sandbox: free (test POS data, the full API and webhooks)
- Live: per connected location; prices are being set with early customers

## Compared with alternatives
- Building in-house: weeks to months per POS, only the POS systems you build
- Unified POS APIs (e.g. Unified.to, Chift): a fixed list, often 80–140+ POS; minutes to connect once a POS is on their list
- Delivery hubs (e.g. Deliverect, Otter, HubRise): orders and menus for the POS their partners support
- PosPlugin's difference: AI mapping with a confidence score on every field and human review, full data (orders, payments, catalog, locations) and write-back where the POS allows

## Owner
PosPlugin is a venture of Factory Zero Pte. Ltd. (https://factory0.ventures/ventures/posplugin/), run as a division of that company.

## Links
- Site: https://posplug.in/
- Early access: https://posplug.in/#access (or email contact@posplug.in)
- GitHub: https://github.com/POSplugin