HTP Developer

HTP 开放平台

向数百万 HTP 用户收取 USDT

为你的网站或 App 接入 HTP 快捷登录和 App 内 USDT 收银台。服务端创建收款单，用户在 HTP App 中确认付款，你收到签名回调。

开始接入 API 参考

一个签名请求即可收款

const payment = await htp('POST', '/open/v1/payments', {
  out_order_no: 'A20261107-0001',
  amount: '40.00',
  currency: 'USDT',
  description: 'Premium membership',
  payer_sub: user.htpSub,
}, idempotencyKey);

// Show payment.checkout_url to the user
// → they confirm in the HTP App
// → you receive a signed "payment.paid" callback

可以实现什么

HTP 快捷登录

标准 OpenID Connect + PKCE，获得稳定的用户标识 sub，用于收款和付款。

在线收款

创建收款单，引导用户到 HTP 收银台，用户输入支付 PIN 后收到 payment.paid 回调。

退款

从开发者钱包即时全额或部分退款。

付款（Payout）

一次调用即可向 HTP 用户发放奖励、奖金或结算款。

收款流程

用户 / HTP App你的服务端HTP 开放 API1. 用户在你的 App 下单2. POST /open/v1/payments3. checkout_url4. 在 HTP App 中打开 checkout_url5. 输入支付 PIN 确认6. 回调 payment.paid（已签名）7. 验签、标记已支付、返回 2xx8. 展示支付成功

五步上线

  1. 1

    注册开发者

    用已实名的 HTP 账号登录控制台并创建 App。

  2. 2

    申请开通支付

    填写业务信息，平台审核并设置限额与费率。

  3. 3

    获取沙箱 Key

    创建 ok_test_ API Key 并配置回调地址。

  4. 4

    接入与联调

    签名请求、创建收款单，用测试用户校验回调。

  5. 5

    正式上线

    发布 App，切换 ok_live_ Key，每日对账。

开发者工具

签名生成器

为任意请求生成 string_to_sign 和 X-Signature，并复制可直接运行的 curl 命令。

回调验签

粘贴收到的回调，检查签名和时间戳。

OpenAPI 规范

下载 OpenAPI 3.1 文件，可导入 Postman、Insomnia 或代码生成器。

准备好接入了吗？

打开开发者控制台，创建 App 和沙箱 API Key。

登录控制台