Skip to main content

​
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
H2H SDKs handle terminal connectivity; your payment orchestration remains on Terminal API (H2H).

​
Choose your platform

Get started with Terminal H2H by selecting your development platform:
If you are choosing an integration path for the first time, start in Quick Start before diving into platform-specific setup.

Android (Kotlin)

Native Android development with Kotlin SDK for Android applications

iOS (Swift)

Native iOS development with Swift SDK for iOS applications

​
Key capabilities

Multi-terminal management

Centralized management of multiple terminal devices with automatic failover and load balancing

Automated polling

Continuous command polling from backend services with configurable intervals and retry logic

Real-time monitoring

Live device status monitoring, connection state tracking, and error reporting

Provider abstraction

Unified API across different terminal providers with seamless switching and fallback capabilities

​
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
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.

​
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
Ready to get started? Choose your platform above to begin the integration process.