参数名	类型	必填	说明	示例
key	string	否	接口调用密钥
action	string	是	操作类固定：generatepay	generatepay
amount	string	是	金额单位分	123
memo	string	是	标题或备注	花店订单111101
pskey	string	是	操作者令牌
qq	string	是	操作者账号

QQ免输收款码

接口说明

该接口用于在线生成自定义金额的QQ收款二维码，支持通过GET请求直接进行在线测试。适用于需要快速创建免输入收款码的开发者及运营人员。

调用地址

https://api.vsaa.cn/api/qq/pay.qr/

请求方式

GET 或 POST

鉴权说明

接口采用 Query 参数鉴权方式。在请求 URL 的查询字符串中添加 key 参数，并填入有效的接口调用密钥。

请求参数

参数名	类型	必填	说明
key	string	是	接口调用密钥，通过 Query 参数传递
action	string	是	操作类型，固定值为 `generatepay`
amount	string	是	收款金额，单位为分
memo	string	是	收款标题或备注信息
pskey	string	是	操作者令牌
qq	string	是	操作者账号

注意：

该接口支持 GET 和 POST 请求。
当使用 GET 方式测试时，所有参数需拼接在 URL 查询字符串中。
频率限制约为每分钟 120 次。

成功响应示例

当请求参数完整且校验通过时，接口将返回 HTTP 200 状态码，响应体为 JSON 格式。以下是生成收款码成功的标准响应结构：

{
  "code": 200,
  "msg": "生成QQ收款码成功",
  "qr_url": "https://i.qianbao.qq.com/wallet/sqrcode.htm?m=tenpay&f=wallet&a=1&u=603212202&ac=CAEQqpPRnwIYisGS1gYgjGAqEmV4cGxhaW49MTExMTExMTExMUIgYjcyZDBlYWI5ZTRhMjFhNzIxNjIzNDVjNTJiMDQ4NjRKDjIxMS4xNjEuMjM2LjQ1_xxx_sign&n=Vsaa.cn"
}

响应字段说明

响应体包含三个核心字段，用于确认执行结果及获取生成资源，各字段定义如下：

字段名	类型	说明
`code`	Integer	状态码。当值为 `200` 时表示请求成功，收款码生成完毕。
`msg`	String	结果描述。返回人类可读的处理状态信息，成功时通常为“生成QQ收款码成功”。
`qr_url`	String	收款码图片直链。生成的二维码图像 URL，可直接作为 `` 标签的 src 属性使用，用于展示自定义金额的收款页面。该链接支持在线测试场景下的直接 GET 访问。

补充说明：

返回的 qr_url 包含签名参数，具有时效性，建议在获取后尽快使用。
该接口支持高频调用，每分钟约 120 次，满足批量生成需求。
无论通过 GET 还是 POST 方式请求，成功响应结构保持一致，开发者可根据实际集成环境选择请求方法，无需强制指定 action 参数进行在线测试（但在正式业务逻辑中建议保留完整参数结构）。

错误响应示例

当接口调用失败或参数校验不通过时，返回统一结构的错误对象。该结构包含状态码 code、提示信息 msg 以及具体的业务错误码 errcode。

以下为一个典型的错误响应示例，模拟“未提供调用密钥”的场景：

{
    "code": 0,
    "msg": "未提供调用密钥",
    "errcode": 11001
}

请注意，code 在出错时通常固定为 0 或非 200 的异常值（视具体网关实现而定，但本接口规范中错误标识主要依赖 errcode），msg 为人类可读的错误描述，errcode 为机器可读的业务错误码，用于程序化判断错误类型。

业务错误码说明

所有业务错误均通过响应体中的 errcode 字段返回。开发者应根据该代码值捕获并处理对应的异常逻辑。以下为完整的业务错误码对照表：

错误码 (errcode)	含义
11001	未提供调用密钥
11002	密钥错误
11003	密钥已禁用
11004	积分余额不足
11005	请求过于频繁（QPM 限制）
11006	接口维护中
11007	接口已禁用
11008	接口不可用
11009	密钥校验暂不可用
11010	积分系统暂不可用
11011	收费接口须提供有效密钥
11012	鉴权方式错误
11013	接口不存在
11014	***地址无效
11015	***地址不允许
11016	***请求失败
11017	服务暂不可用
11018	请求方式不允许
11019	当前IP不在白名单内
11020	启用出口代理须提供有效密钥
11021	未配置可用出口代理
11022	出口代理不可用
11023	密钥已过期
11024	令牌分配积分不足

补充说明：

11001 - 11004：涉及基础鉴权与账户状态，需检查 key 参数是否正确以及账户积分是否充足。
11005：触发频率限制，请确保每分钟请求次数不超过 120 次，并加入适当的重试间隔。
11013 - 11017：涉及接口可用性与服务端状态，若遇到此类错误，请确认调用地址是否正确，并稍后重试或联系技术支持。
11018 - 11019：涉及安全策略，需检查请求方法（GET/POST）是否匹配，以及当前出口 IP 是否已加入白名单。
11020 - 11022：涉及代理配置相关错误，若未使用代理功能，通常不会触发；若触发请检查密钥有效性及代理配置。
11023 - 11024：涉及密钥有效期及令牌权限，请确认密钥是否过期，以及分配给该令牌的积分是否足够。

调用示例

终端 curl（bash）

curl -G "https://api.vsaa.cn/api/qq/pay.qr/" --data-urlencode "key=YOUR_API_KEY" --data-urlencode "action=generatepay" --data-urlencode "amount=123" --data-urlencode "memo=花店订单111101" --data-urlencode "pskey=YOUR_PSKEY" --data-urlencode "qq=YOUR_QQ"

PHP

// PHP
$url = 'https://api.vsaa.cn/api/qq/pay.qr/';
$params = [
'key' => 'YOUR_API_KEY',
'action' => 'generatepay',
'amount' => '123',
'memo' => '花店订单111101',
'pskey' => 'YOUR_PSKEY',
'qq' => 'YOUR_QQ',
];
$query = http_build_query($params);
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => $url . '?' . $query,
CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

注意事项

金额单位精度：amount 参数严格以“分”为单位，传入 123 代表 1.23 元。请勿直接传入“元”或包含小数点的字符串，否则会导致生成收款码金额错误。
密钥安全保管：调用密钥 key 必须通过 Query 参数传递，请务必在服务器端代码中调用接口，严禁将 key 硬编码在前端 JavaScript、移动端 App 客户端或公开仓库中，防止密钥泄露导致账户被盗用。
频率限制规范：接口限制每分钟约 120 次调用。业务代码中建议加入令牌桶或滑动窗口限流逻辑，避免高频并发请求触发风控拦截；若业务场景需批量生成收款码，请做好请求队列缓冲。
HTTPS 强制要求：调用地址必须使用 https://api.vsaa.cn，禁止使用 HTTP 明文传输。由于参数包含支付相关的 amount 及操作者身份凭证（qq, pskey），明文传输存在被中间人劫持篡改的安全风险。
操作凭证一致性：pskey（操作者令牌）与 qq（操作者账号）必须匹配。若令牌失效或账号未授权，接口将返回错误码。请在业务逻辑中定期检查操作者凭证的有效性，避免生成无法使用的收款链接。
链接有效期与复用：返回的 qr_url 为动态生成的临时收款链接，具有时效性。请勿将旧链接缓存过久作为永久收款码使用，建议每次发起支付流程时实时调用接口获取最新 URL，以确保支付链路畅通。

免责声明

欢迎使用 万象数据API（以下简称“本平台”，域名为 api.vsaa.cn）。在使用本平台提供的任何接口、数据及相关服务之前，请您务必仔细阅读并充分理解本免责声明的全部内容。您对本平台任何服务的使用，均视为您已阅读、理解并同意本声明的全部条款。

1. 本平台仅提供**技术接口与数据聚合服务**，不存储、不生产、不拥有任何原始数据内容。 2. 本平台所返回的数据均来源于公开网络或第三方接口，仅作**技术学习、研究与交流**之用。 3. 本平台不保证任何接口的**持续可用性、准确性、完整性或及时性**，接口可能因第三方原因随时变更、中断或停止。 1. 使用者应遵守中华人民共和国相关法律法规，以及其所在地的所有适用法律。 2. **禁止**将本平台接口用于任何违法违规用途，包括但不限于： - 侵犯他人知识产权、隐私权或其他合法权益； - 从事网络攻击、数据爬取滥用、恶意刷量等行为； - 传播违法、有害、虚假或不良信息； - 用于任何商业转售、二次分发而未获授权的情形。 3. 使用者应自行承担因使用本平台服务而产生的一切后果与法律责任。 1. 本平台**不收集、不存储**使用者的个人敏感信息。 2. 使用者通过接口提交的查询参数，仅用于当次请求处理，不做持久化留存。 3. 若接口涉及第三方数据，其版权与解释权归原数据方所有，本平台不承担相关争议责任。 1. 本平台以**“现状”**和**“现有”**为基础提供服务，不对服务作出任何明示或暗示的担保。 2. 因使用或无法使用本平台服务而导致的任何**直接、间接、偶然或必然损失**，本平台及其运营者均不承担任何责任。 3. 因不可抗力、网络故障、第三方服务中断、政策调整等原因导致的服务异常，本平台不承担责任。 1. 本平台的接口设计、文档、代码及相关标识，其知识产权归本平台所有。 2. 未经书面许可，任何单位或个人不得复制、修改、传播或用于商业用途。 1. 本平台有权随时修改本免责声明，修改后的内容将在本页面公布，不再另行通知。 2. 使用者应定期查阅本声明，继续使用即视为接受变更后的条款。 1. 本声明的最终解释权归 **万象数据API** 所有。 2. 如您不同意本声明的任何内容，请立即停止使用本平台服务。 3. 如因本声明产生争议，双方应友好协商解决；协商不成的，可提交本平台运营者所在地有管辖权的人民法院裁决。

最后更新日期：2026年10月6日

QQ免输收款码

接口信息

请求参数

返回示例

详细文档

QQ免输收款码

接口说明

调用地址

请求方式

鉴权说明

请求参数

成功响应示例

响应字段说明

错误响应示例

业务错误码说明

调用示例

终端 curl（bash）

PHP

注意事项

快速上手

在线测试

接口反馈

免责声明

免责声明

推荐接口

秋秋Music_v2