Skip to main content

​
Terminal H2H

Xendit’s Terminal H2H (Host-to-Host) Gateway enables you to connect your applications to physical payment terminals through a centralized gateway service. This solution provides a bridge between your backend systems and terminal devices, handling command polling, device management, and transaction processing seamlessly across multiple terminal 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
Terminal H2H works alongside the Terminal API to provide a complete in-person payment solution. You’ll use the Terminal API to create payment sessions and the Terminal H2H SDKs to interact with physical payment devices.

​
Choose your platform

Get started with Terminal H2H by selecting your development platform:

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 development environment for your chosen platform
  2. Obtain your client key and register your terminal devices
  3. Configure terminal providers based on your hardware setup
  4. Follow the platform-specific guide to integrate the gateway SDK
  5. Test device connections and monitor gateway service status
  6. Implement error handling for robust terminal management
Ready to get started? Choose your platform above to begin the integration process.