# PayExplorer Connect SDK Integration Overview (/global/en/docs/Terminal/Integration-Overview)

PayExplorer Connect SDK provides APIs for integrating payment terminal capabilities into your application, including financial transactions, device interaction, and transaction support.

[Documentation Reading Route](#reading-route) · [Platforms](#platforms) · [Capabilities and Relationships](#features) · [Terminal Access Methods](#terminal) · [Integration Guides](#guides)

## Documentation Reading Route

Use this index to choose documentation for the current question or integration activity. It is a reading route, not a required implementation sequence. For an existing project, go directly to the topic you need. Read only the relevant platform tab or section; a navigation group does not require reading every linked page.

| Documentation topic                    | Read when needed                                                                                                                                                                                                                                                                   |
| -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Platform and architecture              | Check [Platforms](#platforms). Read [Solution Overview][solution] when you need to understand the SDK architecture and the roles of the application and payment terminal.                                                                                                          |
| Capabilities and terminal strategy     | Check [Capabilities and Relationships](#features) and [Terminal Access Methods](#terminal). Consult [Terminal Configuration](#terminal-configuration-guides) or the relevant business guide when choosing a strategy.                                                              |
| Terminal and project preparation       | Read [Terminal Preparation][terminal-preparation] for the payment terminal and [Add SDK Dependency][dependency] for the application's SDK source, version, build configuration, and required iOS startup.                                                                          |
| Terminal configuration and iOS startup | For iOS, complete [iOS SDK Initialization][initialization] in the dependency guide. See [Terminal Configuration and Selection][terminal-selection] for terminal setup, and [Service Routing][service-routing] when multiple providers or per-request targets are involved.         |
| Capability implementation              | Use [Accepting a Payment][payment-guide] as an example of the common Exchange flow, then follow the relevant business guides and consult [API Reference](#api-reference-guides) for request and response details. Check exact declarations against the SDK version in the project. |
| Validation and troubleshooting         | Use [Go-Live Checklist][validation], then [Error Codes][errors], [FAQ][faq], or related capability pages for the issue encountered.                                                                                                                                                |

Use [AI-Assisted Development](#ai-assisted-development-guides) for Skill installation or usage questions. Troubleshooting resources are available throughout integration.

## Platform Overview

| Platform | SDK Guide                                       |
| -------- | ----------------------------------------------- |
| Android  | Android tab in [Add SDK Dependency][dependency] |
| Windows  | Windows tab in [Add SDK Dependency][dependency] |
| iOS      | iOS tab in [Add SDK Dependency][dependency]     |

“Supported” means the SDK provides the capability. See the feature documentation for terminal requirements and applicable conditions.

## Capability Support Matrix

### Financial Transaction Capabilities

Overview: [Financial Services][financial-overview].

| Feature and Documentation              | Purpose                                        | Android   | Windows   | iOS       |
| -------------------------------------- | ---------------------------------------------- | --------- | --------- | --------- |
| [Payment][payment]                     | Initiate a payment                             | Supported | Supported | Supported |
| [Refund][refund]                       | Return funds from an original transaction      | Supported | Supported | Supported |
| [Reversal][reversal]                   | Reverse a completed transaction                | Supported | Supported | Supported |
| [Pre-Authorization][preauth]           | Reserve an authorized amount                   | Supported | Supported | Supported |
| [Pre-Auth Completion][completion]      | Complete an existing pre-authorization         | Supported | Supported | Supported |
| [Authorization Adjustment][adjustment] | Adjust a pre-authorized amount                 | Supported | Supported | Supported |
| [Reconciliation][reconciliation]       | Reconcile transactions and settle the terminal | Supported | Supported | Supported |
| [Balance Inquiry][balance]             | Query an account or card balance               | Supported | Supported | Supported |

### Device Interaction Capabilities

| Feature and Documentation | Purpose                                 | Android   | Windows   | iOS       |
| ------------------------- | --------------------------------------- | --------- | --------- | --------- |
| [Display][display]        | Display text, images, and other content | Supported | Supported | Supported |
| [Print][print]            | Print text or images                    | Supported | Supported | Supported |
| [NFC Tag][nfc]            | Process tag data                        | Supported | Supported | Supported |
| [Transmit][transmit]      | Forward ECR messages                    | Supported | Supported | Supported |

### Transaction Support Capabilities

| Feature and Documentation        | Purpose                                         | Android   | Windows          | iOS       |
| -------------------------------- | ----------------------------------------------- | --------- | ---------------- | --------- |
| [Abort][abort-api]               | Abort an ongoing transaction                    | Supported | Supported        | Supported |
| [Message Status][status-api]     | Query a transaction result or processing status | Supported | Supported        | Supported |
| [Event Notification][events-api] | Receive transaction progress events             | Supported | Supported        | Supported |
| [Reprint][reprint]               | Reprint a transaction receipt                   | Supported | No dedicated API | Supported |

### Transaction Relationships

| Transaction or Capability                     | Related Capabilities or Records                                                                 | Relationship                                |
| --------------------------------------------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------- |
| Financial Transaction Capabilities            | [Event Notification][events-guide], [Abort][abort-guide], [Message Status][status-guide]        | Transaction progress and exception handling |
| Pre-Authorization                             | [Pre-Auth Completion][completion], [Authorization Adjustment][adjustment], [Reversal][reversal] | Follow-up operations                        |
| Pre-Auth Completion, Authorization Adjustment | Original pre-authorization transaction                                                          | Original transaction reference              |
| Refund, Reversal, Reprint                     | Original transaction                                                                            | Original transaction reference              |

## Terminal Access Methods

### Access Mode

| Mode             | Android   | Windows       | iOS           |
| ---------------- | --------- | ------------- | ------------- |
| Same device      | Supported | Not supported | Not supported |
| Separate devices | Supported | Supported     | Supported     |

Choose one access mode. Same device means the business application runs directly on the payment terminal; separate devices means it runs on another device.

### Communication Methods

| Method    | Android   | Windows       | iOS           |
| --------- | --------- | ------------- | ------------- |
| LAN       | Supported | Supported     | Supported     |
| USB       | Supported | Supported     | Not supported |
| UART      | Supported | Supported     | Not supported |
| Bluetooth | Supported | Not supported | Not supported |

For separate-device access, one or more supported communication methods can be enabled.

See [Terminal Configuration and Selection][terminal-selection] for terminal selection and management, and [Service Routing][service-routing] for selecting among multiple terminals and services.

## Integration Guides

### Capability Overview

- [Platform Overview](#platforms)
- [Capabilities and Relationships](#features)
- [Terminal Access Methods](#terminal)

### Concepts and Architecture

- [Solution Overview][solution]
- [Semi-Integration Overview][semi-overview]
- [Introduction][introduction]

### Environment and SDK Setup

- [Terminal Preparation][terminal-preparation]
- [Add SDK Dependency][dependency]
- [iOS SDK Initialization][initialization]

### Terminal Configuration

- [Terminal Configuration and Selection][terminal-selection]
- [Service Routing][service-routing]

### Integration Workflows

- [Accepting a Payment][payment-guide]
- [Device Display Interaction][display-guide]
- [Event Notification Services][events-guide]
- [Abort Transaction][abort-guide]
- [Query Transaction States][status-guide]

### API Reference

- [Financial Transaction Capabilities](#financial-capabilities)
- [Device Interaction Capabilities](#device-capabilities)
- [Transaction Support Capabilities](#transaction-support)

### Testing and Troubleshooting

- [Go-Live Checklist][validation]
- [Error Codes][errors]
- [FAQ][faq]
- [Developer Resources][resources]

### AI-Assisted Development

- [Building with AI][building-with-ai]

[introduction]: doc-id:53d855b2

[semi-overview]: doc-id:8d54626a

[solution]: doc-id:609b68d5

[terminal-preparation]: doc-id:a5593d35

[dependency]: doc-id:bc7a173f

[initialization]: doc-id:bc7a173f#ios-sdk-initialization

[terminal-selection]: doc-id:358d4159

[service-routing]: doc-id:b6647a94

[payment-guide]: doc-id:d047ba5c

[display-guide]: doc-id:afad6b34

[events-guide]: doc-id:818d1b32

[abort-guide]: doc-id:5011e2c5

[status-guide]: doc-id:c0b63f10

[financial-overview]: doc-id:2b18ebc9

[payment]: doc-id:789ff18e

[refund]: doc-id:07b40203

[reversal]: doc-id:660431ac

[preauth]: doc-id:96cf58b6

[completion]: doc-id:e9ac29b1

[adjustment]: doc-id:6652497a

[reconciliation]: doc-id:5173f468

[balance]: doc-id:9b591236

[display]: doc-id:8d04a5ed

[print]: doc-id:70b0cb0a

[nfc]: doc-id:613f3351

[transmit]: doc-id:7e1aac94

[abort-api]: doc-id:0963eff1

[status-api]: doc-id:677a5c7f

[events-api]: doc-id:12338768

[reprint]: doc-id:e5665e06

[validation]: doc-id:442040f5

[errors]: doc-id:27dda32e

[faq]: doc-id:350ba5c5

[resources]: doc-id:d38c2ed5

[building-with-ai]: doc-id:1f5a7655