Unified QR Payment

Generate banking-compliant QR payment codes for Czechia (SPAYD), Slovakia (PayBySquare), and the Eurozone (EPC-QR) with one unified API. Handles complex binary compression, local account conversion, and BIC lookup automatically(for EPC-QR currently only Germany and Austria). Also inludes banking tools like IBAN to local, local to IBAN and IBAN validation

原始信息汇总

Unified QR Payment API 数据集概述

基本描述

• 名称: Unified QR Payment API
• 功能: 通过单一API调用，为中欧地区生成符合银行规范的QR支付码。该API抽象了生成银行合规QR码的复杂性，自动选择正确标准、处理二进制压缩，并确保QR码可被当地银行应用读取。
• 支持地区与标准:
  • 捷克: SPAYD标准，支持CZK/EUR货币，完全支持VS、KS、SS符号。
  • 斯洛伐克: PAY by square标准，支持EUR货币，使用官方的二进制LZMA压缩。
  • 德国: EPC-QR (GiroCode)标准，支持EUR货币，自动检测主要银行的BIC。
  • 奥地利: EPC-QR标准，支持EUR货币，自动检测主要银行的BIC。
  • 欧元区: EPC-QR标准，支持EUR货币，标准SEPA支持，仅通过IBAN。

核心特性

• 捷克SPAYD支持: 生成具有正确字符转义和符号处理的有效的短支付描述符代码。
• 斯洛伐克BySquare (PayBySquare)支持: 完全实现斯洛伐克银行所需的复杂LZMA二进制压缩和自定义Base32编码。
• 欧元区EPC-QR (SEPA): 为德国、奥地利及欧元区其他地区生成标准SEPA QR码。
• 银行工具集:
  • 自动BIC: 自动检测捷克、斯洛伐克、奥地利和德国银行的SWIFT/BIC代码。注册表每日从官方中央银行来源更新，以确保最高准确性。
  • 本地格式转换: 自动将遗留的本地账号转换为有效的IBAN。
  • 验证: 在生成前预先验证金额、可变符号和IBAN校验和，以防止支付失败。

工作原理

发送包含支付详情和扫描者国家的简单JSON有效负载，API将执行以下操作：

1. 验证输入（IBAN、金额、符号）。
2. 根据扫描者（付款人）的货币和地区使用正确的标准（SPAYD、BySquare或EPC）。
3. 编码数据（处理斯洛伐克的二进制压缩等所有复杂情况）。
4. 返回高质量的PNG图像，可直接显示在发票或结账页面上。

端点与工具

• POST /v1/generate: 根据账户详情和目标扫描者国家生成符合银行规范的QR码（PNG）。自动选择SPAYD、BySquare或EPC-QR标准。
• POST /v1/tools/validate-iban: 验证IBAN结构，如果注册表中可用，则返回相应的BIC代码。注册表每日更新。
• POST /v1/tools/local-to-iban: 将遗留的本地账号转换为有效的IBAN并查找BIC。
• POST /v1/tools/iban-to-local: 将IBAN分解回其本地账号和银行代码组件。

认证与限制

• 认证: API通过RapidAPI保护。必须在每个请求的头部包含RapidAPI密钥。
  • X-RapidAPI-Key: YOUR_API_KEY
  • X-RapidAPI-Host: qr-pay-central.p.rapidapi.com
• 错误与速率限制:
  • 400 Bad Request: 输入参数无效。
  • 401 Unauthorized: API密钥缺失或无效。
  • 429 Too Many Requests: 超出计划速率限制。
  • 500 Internal Server Error: 服务器内部错误。

隐私与安全

• 无状态: 不存储任何银行数据。输入在内存中处理，并在图像生成后立即丢弃。

计划功能

• 品牌与定制: 在QR码中心添加公司徽标，自定义前景/背景颜色，添加“Scan Me”边框。
• 扩展国家支持: 原生支持瑞士、匈牙利及其他标准。
• 全球银行注册表: 将每日自动更新程序扩展到更多欧盟国家，以实现无缝的IBAN/BIC验证和转换。