Card Developer

UC Card 开放平台

向数百万 UC Card 用户收取 USDT

为你的网站或 App 接入 UC Card 快捷登录和 App 内 USDT 收银台。服务端创建收款单，用户在 UC Card 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 UC Card App
// → you receive a signed "payment.paid" callback

可以实现什么

UC Card 快捷登录

让拥有 UC Card 账号的用户一键登录你的 UC Card Partner 网站或 App。标准 OpenID Connect + PKCE，可单独使用，也可配合收付款。

在线收款

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

退款

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

付款（Payout）

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

收款流程

UC Card PartnerUC Card用户 · UC Card App下单在你的网站下单创建收款单POST /open/v1/payments打开收银台引导用户打开 checkout_url输入 PIN 确认在 UC Card App 内发送回调payment.paid · 已签名已支付 · 2xx验签并标记订单已支付签名请求checkout_url在 App 中打开已支付POST 回调

五步上线

  1. 1

    注册开发者

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

  2. 2

    申请开通支付

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

  3. 3

    获取沙箱 Key

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

  4. 4

    接入与联调

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

  5. 5

    正式上线

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

开发者工具

登录按钮

为登录页生成「使用 UC Card 继续」按钮，复制 HTML 和 CSS。

签名生成器

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

回调验签

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

OpenAPI 规范

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

准备好接入了吗？

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

登录控制台