快速开始
概览
UC Card 开放平台提供哪些能力，以及它们如何协同工作。
UC Card 开放平台让你的网站或 App 使用 UC Card 账号和 UC Card 钱包：
| 产品 | 作用 | 调用 |
|---|---|---|
| UC Card 快捷登录 | 用户用 UC Card 账号登录（OpenID Connect + PKCE），你获得稳定的用户标识 sub。 |
https://auth.htp.example |
| 收款 | 你创建收款单，用户在 UC Card App 内输入支付 PIN 确认，USDT 从用户钱包转入你的钱包。 | POST /open/v1/payments |
| 退款 | 即时全额或部分退款。 | POST /open/v1/payments/{id}/refunds |
| 付款（Payout） | 从你的钱包向 UC Card 用户付款（需审核开通）。 | POST /open/v1/payouts |
UC Card 快捷登录可以单独使用：任何 UC Card Partner 都可以让 UC Card 用户使用已有的 UC Card 账号登录，无需创建新密码。详见 UC Card 快捷登录。
所有资金均为 USDT。金额是字符串，最多两位小数，如 "12.50"。
整体流程
- 你的服务端用签名请求创建收款单，拿到
checkout_url。 - 用户在 UC Card App 内打开
checkout_url（UC Card 收银台），核对金额后输入支付 PIN 确认。 - UC Card 向你的服务端发送签名回调（
payment.paid）。你校验签名、把订单标记为已支付并返回2xx。
用户只以你的 App 通过 UC Card 快捷登录获得的 OIDC sub 标识。除非用户授权 phone scope，你看不到手机号或钱包 ID。
环境
| 沙箱 | 生产 | |
|---|---|---|
| API Key 前缀 | ok_test_… |
ok_live_… |
| 可收付款对象 | App 的测试用户（最多 20 个） | 登录过你 App 的任意 UC Card 用户 |
| App 须已发布 | 否 | 是 |
| 手续费 | 照常计算，随后返还到你的钱包 | 收取 |
| 限额 | 审核通过的限额，且不超过 100 / 500 / 2000 USDT（单笔 / 日 / 月） | 审核通过的限额 |
两个环境共用一个地址：https://htp-open-api.vai247.pro。签名所用的 API Key 决定环境，每个环境只能看到自己的订单。
准备工作
- 已实名（KYC）的 UC Card 账号，钱包正常且已设置支付 PIN。
- 能保存密钥的服务端 —— API Secret 绝不能出现在浏览器或移动 App 中。
- 用于接收回调的 HTTPS 地址。