> ## Documentation Index
> Fetch the complete documentation index at: https://terminal-docs.xendit.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Integrate Xendit's Payment Terminal H2H for seamless in-person payment processing across multiple platforms

# Terminal H2H

Terminal H2H (Host-to-Host) connects your backend to physical terminals through a managed gateway layer. Use it when you want centralized orchestration with the Terminal API while keeping device connectivity reliable across multiple providers.

## What you can do with Terminal H2H

Terminal H2H Gateway provides everything you need to build comprehensive terminal management solutions:

* **Centralized device management** across multiple terminal types and providers
* **Automated command polling** from backend services to terminal devices
* **Real-time connection monitoring** and error handling for all registered terminals
* **Multi-provider support** including BRI, NTT, Cashup, SHC (Share Commerce Malaysia), and other terminal providers
* **Concurrent operations** supporting multiple simultaneous transactions across different terminals
* **Robust retry mechanisms** with configurable timeout and attempt settings

<Info>
  H2H SDKs handle terminal connectivity; your payment orchestration remains on [Terminal API (H2H)](/api-reference/terminal-api/introduction).
</Info>

## Choose your platform

Get started with Terminal H2H by selecting your development platform:

<Tip>
  If you are choosing an integration path for the first time, start in [Quick Start](/guides/getting-started/quickstart) before diving into platform-specific setup.
</Tip>

<CardGroup cols={2}>
  <Card title="Android (Kotlin)" icon="android" href="/sdk/h2h/android-sdk">
    Native Android development with Kotlin SDK for Android applications
  </Card>

  <Card title="iOS (Swift)" icon="apple" href="/sdk/h2h/ios-sdk">
    Native iOS development with Swift SDK for iOS applications
  </Card>
</CardGroup>

## Key capabilities

<CardGroup cols={2}>
  <Card title="Multi-terminal management" icon="layers">
    Centralized management of multiple terminal devices with automatic failover and load balancing
  </Card>

  <Card title="Automated polling" icon="refresh">
    Continuous command polling from backend services with configurable intervals and retry logic
  </Card>

  <Card title="Real-time monitoring" icon="clock">
    Live device status monitoring, connection state tracking, and error reporting
  </Card>

  <Card title="Provider abstraction" icon="code">
    Unified API across different terminal providers with seamless switching and fallback capabilities
  </Card>
</CardGroup>

## Prerequisites

Before you begin, ensure you have:

* A Xendit account with Terminal H2H Gateway access
* A valid client key for your environment
* Physical payment terminal devices from supported providers (BRI, NTT, Cashup, SHC)
* Terminal device information (Terminal ID and IP address) for each device
* Network connectivity between your application and terminal devices
* Development environment set up for your chosen platform

<Warning>
  Terminal H2H Gateway requires physical payment devices and proper network configuration. Contact the Xendit team to obtain compatible terminal devices, client keys, and configuration details.
</Warning>

## Next steps

1. **Set up your platform environment** and install the SDK
2. **Provision credentials** and register terminal devices
3. **Configure providers** for your hardware footprint
4. **Validate connectivity and error handling** before go-live

<Check>
  Ready to get started? Choose your platform above to begin the integration process.
</Check>