Teya payment integration guide covering POSLink (cloud-based terminal integration), All-In-One (single-device Android), E-Commerce APIs (hosted checkout, payment links), and Payments Gateway. Includes decision trees, authentication patterns, test cards, and certification guidance.
Complete reference for integrating with Teya's payment ecosystem, covering terminal integrations, e-commerce APIs, and SDK implementations.
Need to accept payments?
├── In-person (card present)?
│ ├── ePOS on separate device from terminal?
│ │ └── → POSLink Integration (cloud-based, Android/Windows)
│ │ See: references/epos-sdk/overview.md
│ │ See: references/poslink/overview.md
│ │
│ └── ePOS and terminal on same device?
│ └── → All-In-One Integration (Android only)
│ See: references/epos-sdk/all-in-one-introduction.md
│
└── Online (card not present)?
├── Need hosted checkout page?
│ └── → E-Commerce API - Hosted Checkout
│ See: references/apis/e-commerce-introduction.md
│
├── Need to send payment links?
│ └── → E-Commerce API - Payment Links
│ See: references/apis/e-commerce-introduction.md
│
└── PCI compliant and want direct processing?
└── → E-Commerce API - Direct Transactions
See: references/apis/e-commerce-introduction.md
Use when: Your ePOS runs on a separate device (tablet, PC) from the payment terminal.
Platforms: Android, Windows (iOS planned)
Key features:
Getting started:
References:
Use when: Your ePOS app runs on the same Android device as the payment terminal.
Platforms: Android only (Sunmi, PAX terminals)
Key features:
Getting started:
References:
Use when: You need to accept online payments (card not present).
Options:
Getting started:
References:
Use when: You're building card-present processing with direct API integration (advanced).
Supports:
References:
Use when: You need programmatic access to stores, terminals, and receipt printing.
Features:
References:
All Teya APIs use OAuth 2.0:
Environments:
Token lifetimes:
Example token request:
curl -X POST 'https://id.teya.com/oauth/v2/oauth-token' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'grant_type=client_credentials' \
-d 'client_id=<CLIENT_ID>' \
-d 'client_secret=<CLIENT_SECRET>' \
-d 'scope=checkout/sessions/create refunds/create'
| Brand | Number | Use Case |
|---|---|---|
| Visa | 4242424242424242 | General testing |
| Mastercard | 5555555555554444 | Mastercard testing |
| Amex | 378282246310005 | Amex testing |
| Mastercard | 2223600089700011 | DCC testing (EUR) |
See Test Cards Reference for complete list.
All amounts are in minor units (cents/pence):
ISO-4217 3-letter codes: EUR, USD, GBP, etc.
*.teya.xyz*.teya.comAlways use Idempotency-Key headers to prevent duplicate transactions.
See Integration Checklist and Get Certified.