开发指引
更新时间：2025.04.161、开发前配置
开发前，开发者需要完成如下两个步骤：配置开发参数和配置产品功能。
1.1、设置安全联系人
微信支付日常安全监测发现技术异常时，会向安全联系人和超级管理员发送风险提醒。请商户超级管理员尽快设置技术同事为安全联系人，确保能及时接收异常信息评估业务风险，详见安全联系人设置指引。
1.2、熟悉微信支付接口规则
1.3、准备开发参数
在发起接口请求时，开发者需传入必要参数，如商户号、appid、密钥及证书序列号等，获取方式详见：普通商户模式开发必要参数说明。
1.4、配置产品功能
在使用商家转账到QQ钱包时，必须设置请求来源IP 。仅设定IP可调用商家转账到QQ钱包相关API，具体可详见：设置接口安全IP
2、 详细开发指引
2.1、整体业务开发流程概览
当QQ用户通过商户提供的入口申请使用服务后，商户的系统同步调用发起转账到QQ钱包接口申请转账，若QQ用户账户满足入账条件，将直接完成入账，实现转账到QQ钱包。
当QQ用户如果不满足入账条件，转账会处于未完成的状态，如需取消转账，商户可调用撤销转账到QQ钱包接口撤销转账。
对应的转账结果可以通过商家转账到QQ钱包回调或者查询转账到QQ钱包结果来获取。
发起转账的appid参数是QQ互联开放平台为开发者的应用程序提供的唯一标识。请确保该appid与商户号有绑定关系。详见：开发必要参数说明
2.2、详细开发步骤说明
2.2.1、商户发起申请转账到QQ钱包
当QQ用户参与商户提供的活动并且商户需要转账到QQ钱包时，商户需调用发起转账到QQ钱包接口发起申请转账。同时，支持商户指定回调的URL接收对应的通知信息。
需要注意以下几点：
接口返回的HTTP状态码及错误码，仅代表本次请求的结果，不能代表订单状态。
当返回商户订单状态为ACCEPTED时，需要检查商户资金是否足够，并一定要使用原商户单号及原参数重试，否则可能造成重复转账等资金风险。
当返回错误码为“SYSTEM_ERROR”时，请不要更换商户单号，一定要使用原商户单号及原参数重试，否则可能造成重复转账等资金风险。
接口返回的HTTP状态码不为200时，请商户务必不要立即更换商户订单号重试。可根据错误码列表中的描述和接口返回的信息进行处理，并在查询原订单结果为失败或者联系客服确认情况后，再更换商户订单号进行重试。否则会有重复转账的资金风险。
接口限频： 单个商户的频率限制为100次/s
2.2.2、查询转账到QQ钱包的结果
商户调用发起转账到QQ钱包接口后，即可通过查询转账到QQ钱包的结果接口查询订单的信息。
注意：
API只支持查询最近30天内的转账单，超过30天可以通过资金账单对账确认。
转账单中涉及金额的字段单位为“分”。
如果遇到新的错误码，请务必不要换单重试，请联系客服确认转账情况**。如果有新的错误码，会更新到此API文档中。
错误码描述字段message只供人工定位问题时做参考，系统实现时请不要依赖这个字段来做自动化处理。
接口限频：单个商户的频率限制为200次/s
2.2.3、撤销转账到QQ钱包
商户通过转账接口发起付款后，在转账成功之前可以通过该接口撤销付款。
注意：
该接口返回成功仅表示撤销请求已受理，系统会异步处理退款等操作，最终以查询商家转账到QQ钱包的结果返回的状态为准。
接口限频： 单个商户的频率限制为20次/s
2.3、订单状态流转图
1、从转账单据创建成功后开始计算，如果24h内用户未完成入账，系统会自动关单并退款至商户资金。系统关单时间可能超过24小时，商户需通过查询转账到QQ钱包的结果接口核实转账单是否已成功关闭，若该笔转账单还未关闭，请勿换单发起转账，商户也可通过撤销转账到QQ钱包接口主动撤销该订单。
2、以下三个状态为终态
SUCCESS: 转账成功
FAIL: 转账失败
CANCELLED: 转账撤销完成
