特亚
- 作者仓库星标 39
- 作者仓库 awesome-omni-skill
- 领域
- 工程开发
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @diegosouzapw · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- Windows
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 网络行为
- 允许外网请求
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# Teya Payment Integration Skill
Complete reference for integrating with Teya's payment ecosystem, covering terminal integrations, e-commerce APIs, and SDK implementations.
## Quick Decision Tree: Which Integration Do You Need?
```
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
```
## Integration Overview
### 1. POSLink (Cloud Terminal Integration)
**Use when:** Your ePOS runs on a separate device (tablet, PC) from the payment terminal.
**Platforms:** Android, Windows (iOS planned)
**Key features:**
- Cloud-based communication between ePOS and terminal
- SDK handles OAuth authentication and token refresh
- Pre-built payment UI screens
- Minimal setup required
**Getting started:**
1. Register at [partner.teya.xyz](https://partner.teya.xyz) (staging) or [partner.teya.com](https://partner.teya.com) (production)
2. Create OAuth application (Device Code Flow)
3. Get Client ID and Client Secret (per partner, not per merchant)
4. Request mock payment app APK from Partnership Manager
5. Integrate SDK into your application
**References:**
- [ePOS SDK Overview](references/epos-sdk/overview.md)
- [POSLink Getting Started](references/epos-sdk/poslink-getting-started.md)
- [POSLink Overview](references/poslink/overview.md)
- [POSLink Design](references/poslink/design.md)
- [POSLink Testing](references/poslink/test.md)
- [POSLink FAQ](references/poslink/faq.md)
- [POSLink Certification](references/poslink/get-certified.md)
### 2. All-In-One Integration
**Use when:** Your ePOS app runs on the same Android device as the payment terminal.
**Platforms:** Android only (Sunmi, PAX terminals)
**Key features:**
- Single-device workflow
- Apps communicate via deeplinks
- Receipt printing via Sunmi/PAX SDKs
- No cloud dependency for device communication
**Getting started:**
1. Request debug terminal from Partnership Manager
2. Specify terminal model (Sunmi or PAX)
3. Get test merchant account assigned to terminal
4. Integrate SDK using provided guides
**References:**
- [ePOS SDK Overview](references/epos-sdk/overview.md)
- [All-In-One Introduction](references/epos-sdk/all-in-one-introduction.md)
### 3. E-Commerce API (Online Payments)
**Use when:** You need to accept online payments (card not present).
**Options:**
- **Hosted Checkout** - Redirect customers to Teya's secure payment page (best for most merchants)
- **Payment Links** - Send payment links via email/SMS for remote collection
- **Direct Processing** - Full control for PCI-compliant systems
**Getting started:**
1. Get Teya merchant account from your representative
2. Access Business Portal: [business.teya.xyz](https://business.teya.xyz) (staging) or [business.teya.com](https://business.teya.com) (production)
3. Create API credentials under store settings → Integrations
4. Configure webhooks for payment notifications
5. Implement OAuth token exchange
**References:**
- [E-Commerce Introduction](references/apis/e-commerce-introduction.md)
### 4. Payments Gateway API
**Use when:** You're building card-present processing with direct API integration (advanced).
**Supports:**
- Card-present transactions (EMV, contactless)
- Pre-authorization and capture flows
- Refunds and reversals
- MOTO transactions
- SoftPOS transactions
**References:**
- [Payments Overview](references/apis/payments-overview.md)
- [Test Cards](references/apis/test-cards.md)
### 5. POSLink REST API
**Use when:** You need programmatic access to stores, terminals, and receipt printing.
**Features:**
- Payment request management
- Store configuration
- Terminal monitoring
- Receipt printing (JSON and image formats)
**References:**
- [POSLink API](references/apis/poslink-api.md)
## Authentication
All Teya APIs use OAuth 2.0:
**Environments:**
- **Staging:** https://id.teya.xyz/oauth/v2/oauth-token
- **Production:** https://id.teya.com/oauth/v2/oauth-token
**Token lifetimes:**
- Production: 15 minutes
- Staging: 24 hours
**Example token request:**
```bash
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'
```
## Test Cards
| Brand | Number | Use Case |
|-------|--------|----------|
| Visa | 4242424242424242 | General testing |
| Mastercard | 5555555555554444 | Mastercard testing |
| Amex | 378282246310005 | Amex testing |
| Mastercard | 2223600089700011 | DCC testing (EUR) |
- Use any 3-digit CVV (4-digit for Amex)
- Use any future expiry date
- Test cards only work in staging environments
See [Test Cards Reference](references/apis/test-cards.md) for complete list.
## Important Notes
### Amount Format
All amounts are in **minor units** (cents/pence):
- €1.00 = 100
- €50.00 = 5000
- $25.99 = 2599
### Currency Format
ISO-4217 3-letter codes: EUR, USD, GBP, etc.
### Environment URLs
- Staging domains: `*.teya.xyz`
- Production domains: `*.teya.com`
### Idempotency
Always use `Idempotency-Key` headers to prevent duplicate transactions.
## Certification Process (POSLink)
1. **Design** - Plan integration architecture
2. **Develop** - Implement authentication and payment flows
3. **Test** - Validate integration thoroughly
4. **Get Certified** - Schedule certification and go live
See [Integration Checklist](references/poslink/integration-checklist.md) and [Get Certified](references/poslink/get-certified.md).
## Support
- **Partnership Manager** - For terminal requests, test accounts, APKs
- **Teya Representative** - For merchant account setup
- **Developer Portal** - [partner.teya.xyz](https://partner.teya.xyz) / [partner.teya.com](https://partner.teya.com)
- **Documentation** - [docs.teya.com](https://docs.teya.com)
## File Index
### APIs
- [references/apis/payments-overview.md](references/apis/payments-overview.md) - Payments Gateway API
- [references/apis/poslink-api.md](references/apis/poslink-api.md) - POSLink REST API
- [references/apis/e-commerce-introduction.md](references/apis/e-commerce-introduction.md) - E-Commerce APIs
- [references/apis/test-cards.md](references/apis/test-cards.md) - Test card numbers
### ePOS SDK
- [references/epos-sdk/overview.md](references/epos-sdk/overview.md) - SDK overview and integration options
- [references/epos-sdk/glossary.md](references/epos-sdk/glossary.md) - Terminology
- [references/epos-sdk/poslink-getting-started.md](references/epos-sdk/poslink-getting-started.md) - POSLink quick start
- [references/epos-sdk/all-in-one-introduction.md](references/epos-sdk/all-in-one-introduction.md) - All-In-One integration
### POSLink Guides
- [references/poslink/overview.md](references/poslink/overview.md) - POSLink overview
- [references/poslink/design.md](references/poslink/design.md) - Integration design
- [references/poslink/test.md](references/poslink/test.md) - Testing guide
- [references/poslink/faq.md](references/poslink/faq.md) - Frequently asked questions
- [references/poslink/get-certified.md](references/poslink/get-certified.md) - Certification process
- [references/poslink/integration-checklist.md](references/poslink/integration-checklist.md) - Pre-launch checklist
- [references/poslink/cancel-payment-request.md](references/poslink/cancel-payment-request.md) - Cancel payments
章节与文件索引
按说明文件中的顺序排列。
1. POSLink(云终端集成)
2. 多合一集成
3. 电子商务API(在线支付)
4. 支付网关API
5.POSLink REST API
文件/命令 -> *.teya.xyz · *.teya.com · Idempotency-Key · Android/Windows · references/epos-sdk/overview.md · references/poslink/overview.md · references/epos-sdk/all-in-one-introduction.md · references/apis/e-commerce-introduction.md
内容校验值 -> dca38a3102cb
当前原文的自动摘译,尚未人工审校。
1. POSLink(云终端集成)
使用时间:您的 ePOS 在与支付终端不同的设备(平板电脑、PC)上运行。平台:Android、Windows(计划使用 iOS) 主要功能:ePOS 和终端 SDK 之间基于云的通信处理 OAuth 身份验证和令牌刷新
2. 多合一集成
使用时间:您的 ePOS 应用程序与支付终端在同一台 Android 设备上运行。平台:仅限 Android(商米、PAX 终端) 主要功能:单设备工作流程 应用程序通过深度链接进行通信
3. 电子商务API(在线支付)
使用时间:您需要接受在线支付(未出示银行卡)。选项: 托管结帐 - 将客户重定向到 Teya 的安全支付页面(最适合大多数商家) 支付链接 - 通过电子邮件/短信发送支付链接以进行远程收款 直接处理 - 对 PCI 兼容系统的完全控制
4. 支付网关API
使用时机:您正在通过直接 API 集成(高级)构建刷卡处理。支持: 持卡交易(EMV、非接触式) 预授权和捕获流程 退款和撤销
5.POSLink REST API
使用时机:您需要以编程方式访问商店、终端和收据打印。功能: 支付请求管理 店铺配置 终端监控