SuperAPI AI 工具集

qr-checkout

智能体与模型

查看项目

更新于 10-15 22:13

技能介绍

用途:根据用户自然语言请求,生成一个本地 HTML 二维码支付页面,展示带品牌的二维码供收款。适用于用户说“创建二维码结账页”“二维码支付页”“显示 PayNow 二维码”等场景。若只需收集二维码支付而无页面,应改用 payment-methods 技能;若需后端集成代码,应改用 payment-integration 技能。

主要能力:将用户请求映射为 create_embedded_qr 参数,支持 PayNow、QRPH/InstaPay、GCash、PromptPay、TrueMoney、QRIS、UPI、ShopeePay、GrabPay、Touch 'n Go 等支付方式,并含默认货币与跨境(borderless)检测。调用 MCP 工具后,用 Python 的 qrcode 库将二维码载荷预渲染为 base64 data URI,再注入 HTML 模板,生成不依赖 CDN、可离线打开的本地文件。

使用方式:先解析金额、支付方式与货币;跨境时使用商户货币和 borderless 方法码;对每种支付方式分别调用 create_embedded_qr(一次仅支持一种方式)。若 qr_code 以 iVBOR 开头,直接加 data:image/png;base64, 前缀;否则用 pip3 install qrcode[pil] 安装后渲染。最后读取 references/html-template.md 替换占位符,保存并用 open /tmp/hitpay-qr-checkout-{method}-{amount}.html 打开。

限制:缺少金额或支付方式时需询问用户;pip 安装失败可回退使用 checkout_url;qr_code_data 为空时仅生成含结账链接的页面;提供商未启用需在 HitPay 仪表板开启。品牌色与错误处理表已提供,具体模板细节以资料为准。