41 lines
1.5 KiB
Markdown
41 lines
1.5 KiB
Markdown
# WalletMan 对接文档
|
||
|
||
Android 宿主 App 通过 **HTTP + WebSocket + FCM** 连接 walletman 服务端，完成钱包绑定、TCP 代理出网、token 过期静默重绑。
|
||
|
||
## 文档索引
|
||
|
||
| 文档 | 读者 | 内容 |
|
||
|------|------|------|
|
||
| [后端对接](./walletman后端对接.md) | 服务端 / 联调 | HTTP / WS / FCM 协议、接口、触发条件 |
|
||
| [前端对接](./walletman前端对接.md) | Android / RN 开发 | rnwalletman 集成、Manifest、JS API、绑钱包 |
|
||
|
||
## 快速概念
|
||
|
||
- **clientId**：设备唯一 ID，与 App 侧 `DeviceInfo.getUniqueIdSync()` 一致，用于 WS 注册和 FCM 投递。
|
||
- **walletId**：`{walletType}_{phone}`，如 `paytm_9876543210`。
|
||
- **Token 绑钱包**：魔改 ipay 包 AIDL 读 token → `POST /register`。
|
||
- **OTP 绑钱包**：`POST /request-otp` → `POST /verify-otp`。
|
||
- **FCM 重绑**：服务端检测 inactive → 下发 `rebind_wallet` → 客户端静默 AIDL → `POST /register`；失败再弹本地通知。
|
||
|
||
## 本地联调
|
||
|
||
```bash
|
||
# 服务端（默认 :16000）
|
||
cd servers/walletman/cmd/server
|
||
go run . -tls android
|
||
|
||
# 测试页
|
||
open http://localhost:16000/test/index.html
|
||
```
|
||
|
||
生产环境通常由 Nginx 反代 HTTP/WS（如 `https://domain/ws`），端口不必暴露 16000。
|
||
|
||
## 仓库参考
|
||
|
||
| 路径 | 说明 |
|
||
|------|------|
|
||
| `servers/walletman/` | Go 服务端 |
|
||
| `libs/rnwalletman/` | RN 库（Proxy + Bind 组件） |
|
||
| `android/app/.../RnpayProxyService.java` | rnpay 宿主 registerWallet 示例 |
|
||
| `screens/HomeScreen.tsx` | rnpay Proxy / 绑钱包 / 通知点击示例 |
|