Branded QR & Payment Code API

Generate branded, scannable QR codes in one call — payment codes (Brazil PIX BR Code, generic EMVCo Merchant-Presented codes, and alias/CVU/CBU bank-transfer blocks), vCard contacts, WiFi join codes, and bulk batches. Full branding: logo, colors, gradients, dot & finder-eye styles, and a call-to-action frame. Returns PNG or SVG. Deterministic and stateless.

原始信息汇总

数据集概述：Branded QR & Payment Code API

这是一个用于生成品牌化、可扫描二维码的API，支持多种支付码、联系卡、WiFi连接码及批量生成，并允许高度自定义样式。

核心功能

• 生成品牌化二维码：支持在二维码中心添加Logo、自定义模块和背景颜色（纯色或渐变）、三种圆点样式、三种定位眼样式，以及可选的“SCAN ME”或“SCAN TO PAY”框架。
• 支付码生成：
  • PIX (巴西)：生成符合EMVCo标准的BR Code，支持PIX key（邮箱/电话/CPF/CNPJ/EVP）、商户名称、城市、金额和交易ID，货币为BRL。
  • EMVCo：生成通用的商户展示码（Merchant-Presented Codes），适用于阿根廷Transferencias 3.0等互操作轨道。
  • Transfer：生成可读的别名/CVU/CBU银行转账信息块。
• 联系人卡片生成：生成vCard 3.0格式的联系人名片。
• WiFi连接码生成：生成WiFi连接二维码，支持WPA/WPA2/WPA3、WEP、开放网络及隐藏网络。
• 批量生成：单次请求可生成最多50个混合类型的二维码。
• 输出格式：返回PNG或SVG格式的图片。

技术特性

• 确定性 & 无状态：相同输入生成完全相同的输出字节，无需SDK或额外基础设施。
• 自动纠错：添加Logo时，纠错级别自动提升至H级，确保可扫描性。
• 所有样式均经过解码测试：确保自定义样式不影响扫描成功率。

使用方式

• 认证：每个请求需包含 X-RapidAPI-Key 和 X-RapidAPI-Host 两个HTTP头。
• 基础端点：POST /v1/qr 用于任何文本或URL。
• 专用端点：
  • POST /v1/qr/payment：支付码
  • POST /v1/qr/vcard：联系人卡片
  • POST /v1/qr/wifi：WiFi连接码
  • POST /v1/qr/batch：批量生成

价格方案

• BASIC：$0.00/月
• PRO：$10.00/月
• ULTRA：$35.00/月
• MEGA：$99.00/月

适用场景

• 在发票、收据、店铺和海报上生成品牌化支付二维码（PIX/EMVCo）。
• 为电子名片、邮件签名和会议胸牌生成“添加联系人”二维码。
• 制作访客WiFi连接海报。
• 批量生成菜单、门票、资产标签和邮件上的二维码。

错误处理

• 所有错误采用统一结构：{ "error": "...", "message": "...", "statusCode": ... }。
• 状态码：
  • 400：输入错误（无效颜色、Logo数据URI格式错误等）。
  • 403：在RapidAPI平台外调用。
  • 413：Logo或请求体过大。
  • 422：不可处理的请求（缺少支付key、内容过大无法编码）。
  • 429：超出速率限制。