Guide for external software platforms

You build software for businesses (an e-commerce platform, a booking system, a delivery app) and want your customers' TechTur POS businesses connected.

1. Understand the product — Integration overview.
2. Create a developer account — register at /register. No POS business is needed to build.
3. Register your application — Developer console, Sandbox first.
4. Read the connector documentation — Connector specification, write your manifest.
5. Request permissions — choose the minimum scopes. You cannot request platform:* scopes; those are for TechTur platforms.
6. Configure authentication — authorization code + PKCE; register your exact redirect URIs. Each of your customers connects their own POS business from your settings page; store one token pair per business.
7. Map business data — your account ↔ the business_id returned at token exchange; your records ↔ externalIds.
8. Connect the API — use the SDK or any HTTP client (OpenAPI is language-neutral).
9. Configure webhooks — one application endpoint receives events for every connected business (filtered by granted scopes).
10. Import / synchronise — initial sync, then incremental.
11. Test — run the sandbox checklist.
12. Security and compatibility checks — meet the security requirements; upload your manifest.
13. Production access — register a Live application with the same configuration. TechTur reviews it (scopes, manifest, sandbox evidence) and approves the scopes.
14. Monitor — console API requests and Deliveries; handle integration.disconnected.