配置 App

本页所有操作都在开发者控制台中完成。敏感操作（API Key、回调地址与密钥、Client Secret）需要输入 HTP 支付 PIN。

1. 注册开发者

用 HTP 账号登录并同意开发者协议。HTP 账号须已实名（否则 KYC_REQUIRED），且钱包状态正常 —— 收款会结算到该钱包。

2. 创建 App

选择 App 类型：

类型	适用场景	Client Secret
WEB	有服务端（接入支付推荐）	有，只展示一次
SPA	纯浏览器应用，PKCE	无
NATIVE	iOS / Android App，PKCE	无

你会获得用于 HTP 快捷登录的 client_id。新 App 处于沙箱：只有你本人和最多 20 个测试用户能登录，在测试用户中添加。

完善资料（隐私政策链接必填）后提交审核。审核通过后 App 发布，所有 HTP 用户都能登录。已发布 App 修改名称、Logo、回调地址，或申请 email / phone scope 需要再次审核，期间线上版本不受影响。

3. 申请开通支付

打开支付 → 申请开通。App 处于草稿、审核中或已发布状态都可以申请：

字段	示例
业务类型	电商零售
网站	https://shop.example.com
退款政策	七天无理由退款……
预计月交易额（USDT）	5000
业务说明	卖什么、面向谁
是否需要付款功能	需要向用户付款时勾选（单独审核）

状态从 PENDING 变为 ENABLED（或 REJECTED，附审核意见）。开通后可看到你的条款：

条款	含义
单笔 / 日 / 月限额	单笔上限及每个 UTC 日 / 月累计上限，按环境分别累计
费率 + 固定手续费	fee = round(amount × rate) + fixed，从入账金额中扣除
允许付款	POST /open/v1/payouts 是否可用

4. 创建 API Key

支付 → API Key → 创建，选择环境：

• 沙箱（ok_test_…）—— 支付开通后随时可创建。
• 生产（ok_live_…）—— App 发布后才能创建（APP_NOT_PUBLISHED）。

Secret 只展示一次。请存入密钥管理服务，绝不能放进浏览器或移动 App。

5. 设置回调地址

支付 → 回调：https:// 地址，不能带账号密码和 #，且必须解析到公网 IP。首次保存时展示一次回调签名密钥，请与 API Secret 一起保存。

之后修改地址不会更换密钥。轮换密钥会生成新密钥并让旧密钥立即失效，请先让服务端支持新密钥再轮换。

6. 查看订单与回调

• 订单 —— 所有收款、退款、付款，两个环境都可见，可按类型、状态和你的订单号筛选。
• 账单 —— 下载最多 31 天（UTC 日期）的 CSV，用于对账。
• 回调记录 —— 每次投递的尝试次数、最后 HTTP 状态和错误。重发可手动再次投递。