OCTOPUS TMS
POS SDK

Section 1

Overview

Multi-device support, key capabilities, and how the SDK abstracts hardware communication.

→ Section 2

Requirements & Setup

Gradle dependencies, ViewBinding, ConstraintLayout, and AndroidManifest permissions.

→ Section 3

Initialisation

Obtaining the singleton instance with getInstance() and calling initialize().

→ Section 4

Key Exchange

Downloading and injecting terminal master keys via downloadAndInjectKeys().

→ Section 5

Payment Flow

Launching the transaction UI via startPayment(), handling all result callbacks.

→ Section 6

Printing

Thermal receipt printing using print() and the BitmapBuilder utility.

→ Section 7

Status & Utility Methods

Helper methods for checking service state, OEM detection, and transaction cancellation.

→ Section 8

SDK Lifecycle

Properly tearing down the SDK singleton with destroy() in onDestroy().

→ Section 9

Error Reference

All known error types with their likely cause and step-by-step resolution.

→ Section 10

Complete Integration Example

Full end-to-end MainActivity in Kotlin and Java showing the entire SDK flow.

→ Section 11

Webhook Configuration

Configure webhooks to send real-time transaction notifications to aggregators.

→