帮助中心

接入 Qist 遇到问题?

不管你一行代码都没写过,还是在拉自定义 webhook 处理函数 —— 我们都罩得住。

卡住了? 在 Telegram 找我们 —— 中位回复时间 < 10 分钟。

Quick vocabulary (HMAC, webhook, wallet, rail)
HMAC.
Hash-based Message Authentication Code. The cryptographic signature we attach to every webhook so your site can prove the event really came from Qist and not an attacker. You verify it = you accept it; otherwise, drop the request.
Webhook.
An HTTP call we send to your site when an event happens (payment received, failed, refunded). You give us a URL, we POST to it.
USDC wallet (Polygon).
Blockchain address starting with 0x where your payments land. We stay non-custodial — we never touch the money.
Payment rail.
The on-ramp processor your customer picks at checkout (Revolut, Banxa, MoonPay, crypto-direct…). Each rail has its own fees and per-country/BIN approval rate.
选你的路径

你的起点在哪?

非技术

我不写代码

用支付链接或 WooCommerce 插件。无 SDK、无 webhook、无终端。

看简单路径
开发者

我是开发者

完整 API 参考、SDK 类型、webhook 签名、沙箱密钥 —— 都在 /docs。

打开文档
WooCommerce

我经营 WooCommerce 店

一键插件。粘贴你的 USDC 钱包,点保存。5 分钟搞定。

下载插件
非技术路径

如果你从没碰过代码,看这里。

你有两个选项,两个都完全不碰终端:

  1. 1支付链接。到首页 pay.qistdigital.com,粘贴你的钱包,设金额,点生成。把 URL 发到 Telegram / Instagram / 邮件。客户点击 → 付款 → 你收 USDC。无需注册。
  2. 2WooCommerce 插件。如果你已经在用 WooCommerce 店,下载 插件 .zip,在 WP 后台上传,粘贴钱包,搞定。
  3. 3还是觉得难? 跳到下面的 雇佣开发者 — 或联系我们,我们看你的情况。
接入清单

四条路径。挑你的。

每份清单都是完整安装指南。照着勾就行。

WooCommerce

最简单的路径。点击安装、粘贴钱包、搞定。

5 分钟
  • 从 /download/woocommerce 下载插件 .zip
  • WP 后台 → 插件 → 添加新插件 → 上传 → 安装 → 启用
  • WooCommerce → 设置 → 付款 → 启用 Qist
  • 粘贴你的 Polygon USDC 钱包(或高级模式的 API key)
  • 保存 → 用 $5 购买测试 → webhook 自动触发

Next.js / Node

用我们的 TypeScript SDK 完全掌控。

15 分钟
  • npm install github:kinerette/Qist-sdk
  • 创建 API 路由 /api/checkout 调用 Qist SDK
  • 创建 webhook 处理函数 /api/peptidepay-webhook,带 HMAC 校验
  • 设置环境变量 PEPTIDEPAY_API_KEY + PEPTIDEPAY_WEBHOOK_SECRET
  • 每次 /checkout/init 调用传 webhook_url(按会话布线 —— 不需要在后台注册)

自定义 PHP 站点

纯 PHP,任意框架。curl + hash_hmac 就够了。

20 分钟
  • 用你的 API key 给 /api/v1/checkout/init 加一个 curl 调用
  • 创建 /peptidepay-webhook.php,用 hash_hmac('sha256', $body, $secret) 校验
  • 在 checkout.session.paid 时更新订单状态
  • 用一笔你之后退给自己的 $1 真实付款测试,或用 sk_test_ 密钥触发一个签名的测试 webhook

没有网站(Telegram / DM)

零代码。分享链接。收款。

0 分钟
  • 在 pay.qistdigital.com 首页表单生成支付链接
  • 把 URL 手动发给客户(Telegram、WhatsApp、邮件、bio 链接)
  • 客户在我们的托管结账页付款 —— USDC 到你钱包
  • 可选:到 /signup 注册拿邮件 + Telegram 付款通知
常见问题

最常问的 10 个。

你的问题不在这里, 在 Telegram 找我们。

你的接口必须能从公网 HTTPS 访问(在 LAN 外 curl 测试)。我们自动重试 6 次,约 42 小时内(5 分钟、15 分钟、1 小时、4 小时、12 小时、24 小时)。没有 IP 白名单 —— 用 HMAC 签名作为认证闸门。仅钱包模式的 webhook 是<b>未签名</b>的 —— 到 /signup 注册拿 whsec_ 以获得签名 webhook。后台 /app 显示投递统计。
雇开发者

不想动手?

如果上面的清单对你来说还是太多,这是两条最快的路。

直接支持
选项 1 —— 我们的团队

在自行安装前先和我们聊聊。

发送你的店铺 URL 和使用的 stack。我们一事一议地看,找最快的路径 — 有时是动手帮你,有时是指向正确的文档,有时是帮你给自由职业者写需求。不提前报价;我们告诉你能做什么、需要什么。

发消息给 @vidaspi
选项 2 —— 自由职业者($20–50)

Fiverr 或 Upwork。

搜索 install WooCommerce plugin —— 平均 $20–50 一单,几小时交付。把 .zip 和上面的清单发他们,剩下的他们搞定。

Fiverr 上找Upwork 上找
还是卡住?

跟真人说。

每条消息我们都回。Telegram 最快 —— 长对话或 NDA 相关走邮件。

@vidaspisupport@qistdigital.com

中位回复 < 10 分钟 · 24/7 · 无分级门槛