payqr

@czagents/payqr

欧洲支付二维码 — 生成和读取 SPAYD（CZ/SK）与 EPC/GiroCode（欧元区）支付二维码，以及标准二维码（文本、WiFi、vCard）。使用任何银行应用扫描即可预填转账信息。在本地运行，数据不会离开你的设备。免费。

以确定的方式生成 SPAYD（捷克/斯洛伐克）和 EPC / GiroCode（SEPA）支付二维码， 以及纯文本、Wi-Fi 和 vCard 二维码；也可以从图像中解码二维码。

免费，采用 MIT 许可证，不使用 AI，也没有付费 API。所有处理都在本地完成；不会向任何地方发送数据。

💡 更喜欢使用浏览器？相同的引擎也以免费 Web 应用的形式运行，网址为 https://qr.cz-agents.dev — 输入详细信息，或拖入支付截图 / 二维码；所有处理均在客户端进行。

为什么要使用

手动将经纪商存款说明（Revolut、Trading 212、XTB、发票……）中的 IBAN、金额和可变符号复制到银行应用中，既慢又容易出错 — 一个数字输错就会把钱转到错误的账户。此服务可将这些信息转换为可扫描的支付二维码，供银行应用直接读取；也可以将现有支付二维码解码为结构化字段。

安装

将其添加到你的 MCP 客户端（例如 Claude Desktop 的 claude_desktop_config.json）：

{
  "mcpServers": {
    "payqr": {
      "command": "npx",
      "args": ["-y", "@czagents/payqr"]
    }
  }
}

或直接运行：

npx -y @czagents/payqr        # stdio transport

工具

每个示例都是 MCP 工具调用参数对象。

• qr_payment — 创建支付二维码：对于 CZ/SK IBAN 选择 SPAYD，对于其他 SEPA IBAN 选择 EPC/GiroCode。在用户检查回读字段之前，不要将其用于从图像中提取的支付信息；EPC 还要求提供 recipient_name。示例：{"iban":"CZ6508000000192000145399","amount":1500,"currency":"CZK","variable_symbol":"1234567890","message":"Invoice 2026-001"}。
• qr_text — 创建包含纯文本的二维码。适用专用工具时，不要将其用于结构化支付、Wi-Fi 配置或联系人。示例：{"text":"https://cz-agents.dev"}。
• qr_wifi — 创建适用于 WPA、WEP 或开放网络的 Wi-Fi 网络二维码。不要用它向不应获得网络访问权限的人分享凭据。示例：{"ssid":"Office WiFi","password":"correct-horse-battery-staple","security":"WPA","hidden":false}。
• qr_vcard — 创建 vCard 3.0 联系人二维码。若联系人尚未同意分享所含个人信息，请勿使用。示例：{"name":"Ada Lovelace","phone":"+420123456789","email":"[email protected]","org":"Analytical Engines"}。
• qr_read — 解码并分类现有的 base64 PNG/JPEG 二维码图像。不要用它来验证此服务生成的二维码，因为此服务已自行验证；解码失败不代表支付已验证。示例：{"image_data":"data:image/png;base64,iVBORw0KGgoAAAANSUhEUg..."}。
• qr_payment_batch （付费；配置 x402 后可用） — 在一次发票批处理调用中生成并验证最多 50 个支付二维码。不要将其用于单笔支付，也不要在获取 x402 付款条款之前使用。示例：{"payments":[{"ref":"INV-001","iban":"CZ6508000000192000145399","amount":1500,"currency":"CZK","variable_symbol":"2026001"}]}。

每个生成工具都会同时返回渲染后的二维码图像和包含编码载荷、所选标准及任何警告的文本块 — 因此客户端可以原生显示二维码，你也可以准确核验其中编码的内容。

可选 IBANforge 推荐链接

成功的 qr_payment 响应，以及至少生成一个二维码的付费批处理响应，都可以包含可选的 next_steps 推荐链接。该功能默认禁用。要启用它，请设置以下三个变量：

IBANFORGE_REFERRAL_ENABLED=true
IBANFORGE_REFERRAL_URL=https://ibanforge.com/?src=payqr
IBANFORGE_REFERRAL_RELATIONSHIP=unpaid_partner # or affiliate

URL 必须使用 HTTPS，且属于 ibanforge.com（或其子域名）。启用后的配置无效时，服务会在启动时停止。推荐 URL 绝不会包含 IBAN、金额、参考编号或其他支付数据。免费非支付工具、失败的支付以及未付费的 x402 响应都不会携带推荐链接。返回的文案会标明关联关系。

从图片发起付款的工作流

当你粘贴付款详情的截图或照片时，助手会从图片中读取 IBAN、金额、货币、收款方和参考信息，并调用 qr_payment。显示二维码前，它会将提取的字段回显给你，以便你对照来源核实——数字误读可能会把真实款项汇到错误的地方——之后才会显示二维码。

标准

• SPAYD（SPD*1.0*…）——捷克和斯洛伐克银行应用读取的「QR Platba」字符串格式。
• EPC / GiroCode（BCD…）——SEPA 信用转账二维码标准（EPC069-12），仅支持 EUR，在德国、奥地利和整个欧元区广泛使用。需要提供收款方名称。

隐私

不收集遥测数据，生成二维码时不进行网络调用，也不使用 AI。纯本地计算。

许可证

MIT © cz-agents