用途:帮助开发者把 uniweb 支付安全地接入已有应用,支持银行卡、微信支付、支付宝与 PayNow,并生成本地服务端可用的代码。
主要能力:提供三种集成路径。固定金额且无后端时使用永久支付链接 /p/plink_xxx;固定商品或订阅价使用永久 /buy/price_xxx 链接;购物车、动态金额、订单或按请求元数据场景使用 TypeScript SDK 在服务端创建一次性 Checkout Session。SDK 仅在服务端(Node.js、Cloudflare Workers、Deno、Bun)运行,金额为整数最小单位,默认货币 SGD。
使用方式:安装 CLI 为 npm install -g @uniwebpay/cli,命令为 uniweb;服务端 SDK 为 npm install @uniwebpay/sdk 或按锁文件使用 pnpm/yarn/bun。支付链接示例:uniweb link create 1000 -c SGD -n "My Product" --methods card,wechat,alipay,paynow。SDK 用法先创建 product 与 price,再 uniweb.checkout.create 并重定向 session.url;Checkout URL 24 小时过期且为一次性。履行订单只在验证 Webhook 后执行,先验签再处理,验签失败返回 4xx,自身处理失败返回 5xx 以便重试;事件按 event.id 做幂等。Webhook URL 必须为 HTTPS。
限制:绝不能把 sk_live_ 放入部署代码或浏览器代码;服务端应使用最小范围的 sk_server_ 密钥。支付链接仅支持一次性支付,订阅仅支持银行卡。PayNow 仅限 SGD,微信支付与支付宝仅限 SGD/CNY,卡片有 10 最小单位下限。uniweb create 为交互式命令,不适用于非交互或自动化脚本。
其余未在资料中提供的细节暂未提供。