端到端流程
从 "加入购物车" 到 USDC 到你钱包。
你不需要去查 Polygonscan。每次付款都会触发 webhook + 邮件 + 可选 Telegram DM。
完整流程
10 步。毫无意外。
客户在你站点加入购物车
购物车里 BPC-157 + Retatrutide。
WooCommerce 创建订单 #1234
状态:待付款。库存已预留。
跳转到安全结账页
我们把结账页托管在 peptide-pay.com/session/xyz。你的 order_id 作为 metadata 传递。
客户选一种支付方式
Apple Pay / Google Pay / 银行卡 / 加密货币直接。根据金额智能推荐。
支付通道接手
卡法币通道处理银行卡。或者我们接加密货币直接。资金从不进 Peptide-Pay 余额。
USDC 到你钱包
Polygon。约 30 秒。PolygonScan 可验证(你不用去查)。
结算层 ping 我们(IPN)
后端确认:付款终态。
我们 ping 你的站点(HMAC webhook)
签名 POST 到 /wc-api/peptidepay_webhook_authed。你的插件校验签名、找到订单 #1234、调用 payment_complete()。
你的站点 + WooCommerce 更新订单
状态变为 '处理中'。邮件发出:一封给你('新已付订单'),一封给客户('订单已确认')。
你发货
检查 WC 后台。匹配订单 #1234。发货。完事。
三种配置
选你的技术栈。
同一个流程,三种接法。
B
自定义网站
(Next.js、静态,任何都行)
- 调 /api/v1/checkout/init → 跳转客户 → 监听 /your-webhook。
- 我们用 HMAC-SHA256 签名。你验证。你更新自己的数据库 + 发邮件。
通知
"但我怎么知道收到钱了?"
- WooCommerce 邮件 到管理员(插件模式)
- 我们的邮件 到你的通知邮箱("新付款:$150")
- Telegram DM 通过我们的机器人(opt-in)
- 实时后台 在 peptide-pay.com/app(头部数字每 10 秒更新)
- webhook 到你站点 服务器宕机时约 42 小时内重试 6 次
- PolygonScan 给偏执狂 —— 每笔交易都可链上验证
付款清算的几秒钟内你就知道了。
常见问题
边界情况。
我们发 webhook 时我站点宕了怎么办?
我们会约 42 小时内重试 6 次(5 分钟 → 15 分钟 → 1 小时 → 4 小时 → 12 小时 → 24 小时)。之后进入死信队列。你随时可以通过轮询
GET /api/v1/sessions/{id} 重新同步。我能不花真钱先测试吗?
能,前 3 笔交易是沙箱(我们退手续费)。看你的
/app 后台。我能传自己的 order_id 吗?
可以,在
/api/v1/checkout/init 传 metadata: {order_id: "1234"}。我们在 webhook 负载中原样回显。你们存什么数据?
session_id、钱包、金额、状态、客户邮箱(日志里 hash)。全部在 /privacy。
拒付?
不可能。USDC 链上就是终态。这就是我们的意义。