跳到正文

接入指南

从商户注册到链上确认,构建并运营完整支付路径。

当你需要接入真实产品,而不是单独查看某个函数时,从这里开始。

推荐路径

  1. 按照完整支付流程完成商户注册、PaymentRef 创建、钱包连接、x402 结算和终局验证。
  2. 使用生产运营指南设置密钥、重放保护、恢复、对账和履约策略。
  3. 需要精确函数签名与参数时查看 API Reference

只安装一次

Shell
npm install x402-paysdk
入口运行时职责
x402-paysdk/pay浏览器、应用或钱包宿主Offer 验证、typed data 签名、付款提交、收据与交易检查
x402-paysdk/receive收款应用或受信工具PaymentRef 创建、列表和撤销
x402-paysdk/merchant仅限后端商户凭据、refs、订单、退款、通知验证和对账

不要把 x402-paysdk/merchant 导入不可信浏览器,它被设计为持有商户 API 和 notify 凭据。