测试指南 - 间接 Pix
测试指南描述了集成合作伙伴在进入生产环境之前，需要在 QI Tech 沙盒环境（测试环境）中测试的所有资源和功能。
本指南描述了该产品所涉及的所有资源和功能。
BaaS API 注册与认证
| 代码 | 步骤 | 描述 | 文档链接 | 前置条件 |
|---|---|---|---|---|
| CAB0001 | 在沙盒环境注册 | 在 QI Tech 平台的沙盒环境（sandbox.qitech.app）中完成注册 | Link documentação | |
| CAB0002 | 在沙盒验证 token | 在沙盒环境中完成 QI Token 验证 | Link documentação | CAB0001 |
| CAB0003 | 交换公钥 | 在 QI Tech 平台沙盒环境（sandbox.qitech.app）中完成公钥交换 | Link documentação | CAB0001 和 CAB0002 |
| CAB0004 | 完成 API 调用认证测试 | 完成 API 调用认证测试 | Teste de Autenticação Link documentação | CAB0003 |
| CAB0005 | 配置 webhook | 通过 QI Tech 平台沙盒环境（sandbox.qitech.app）完成 QI 发送 webhook 的 URL 配置 | Link documentação | CAB0001 和 CAB0002 |
QI Conta
账户
| 代码 | 步骤 | 描述 | 文档链接 | 前置条件 |
|---|---|---|---|---|
| QCI0012 | 开设间接参与者名下账户 | 完成 4 个间接参与者名下账户的开户 | Link documentação | CAB0004 和 CAB0005 |
| QIC0005 | 查询账户数据 | 获取参与者此前开设的账户数据 | Link documentação | QCI0012 |
| QIC0006 | 注销账户 | 注销间接参与者名下的账户 | Link documentação | QCI0012 |
Alias
| 代码 | 步骤 | 描述 | 文档链接 | 前置条件 |
|---|---|---|---|---|
| QCA0014 | 为间接参与者名下账户创建法人 alias | 为间接参与者名下账户创建 2 个法人 alias | Link documentação | QCI0012 |
| QCA0015 | 为间接参与者名下账户创建自然人 alias | 为间接参与者名下账户创建 2 个自然人 alias | Link documentação | QCI0012 |
| QCA0016 | 查询 alias 数据 | 查询绑定到间接参与者名下账户的 alias 数据 | Link documentação | QCA0014 或 QCA0015 |
| QCA0017 | 删除 alias | 删除绑定到间接参与者名下账户的 alias | Link documentação | QCA0014 或 QCA0015 |
| QCA0018 | 列出绑定到 QI 账户的 alias | 删除绑定到间接参与者名下账户的 alias | Link documentação | QCA0014 或 QCA0015 |
交易
| 代码 | 步骤 | 描述 | 文档链接 | 前置条件 |
|---|---|---|---|---|
| QIC0008 | 查询对账单 | 查询账户对账单 | Link documentação | QCI0012 |
| QIC0009 | 申请转账凭证 | 申请转账凭证 | Link documentação | PXI0002、或 PXI0003、或 PXI0009、或 PXI0010、或 PXI0004、或 PXI0005 |
| QIC0010 | 读取交易 webhook | 成功接收所有交易 webhook | Link documentação | PXI0002、或 PXI0003、或 PXI0009、或 PXI0010、或 PXI0004、或 PXI0005 |
| QIC0011 | 查询金融机构列表 | 查询可接收 TED 和 Pix 的金融机构列表 | Link documentação |
间接 Pix
Pix 转出
| 代码 | 步骤 | 描述 | 文档链接 | 前置条件 |
|---|---|---|---|---|
| PXI0002 | 通过 Pix 密钥进行 Pix 转出 - 同步 | 使用 Pix 密钥从 QI 账户进行 Pix 转账，API 以同步方式响应 | Link documentação | QCA0014 或 QCA0015 |
| PXI0003 | 手动 Pix 转出 - 同步 | 使用手动 Pix（银行数据）从 QI 账户进行 Pix 转账，API 以同步方式响应 | Link documentação | QCA0014 或 QCA0015 |
| PXI0009 | 通过 Pix 密 钥进行 Pix 转出 - 异步 | 使用 Pix 密钥从 QI 账户进行 Pix 转账，API 以异步方式响应 | Link documentação | QCA0014 或 QCA0015 |
| PXI0010 | 手动 Pix 转出 - 异步 | 使用手动 Pix（银行数据）从 QI 账户进行 Pix 转账，API 以异步方式响应 | Link documentação | QCA0014 或 QCA0015 |
| PXI0004 | 模拟 Pix 转出退款 | 模拟 Pix 转出退款 | Link documentação | PXI0002、或 PXI0003、或 PXI0009、或 PXI0010 |
| PXI0005 | 模拟 Pix 转入 | 模拟 Pix 转入到 QI 账户 | Link documentação | QCA0014 或 QCA0015 |
| PXI0006 | Pix 转入退款 | 从 QI 账户退还 Pix 转入 | Link documentação | PXI0005 |
| PXI0007 | 模拟被拒绝的 Pix 转出 | 使用 QI Tech 文档中提供的模拟密钥进行 Pix 转出，以模拟 Pix 被拒绝的场景 | Link documentação | |
| PXI0008 | 模拟待处理 Pix 转出 | 使用 QI Tech 文档中提供的模拟密钥进行 Pix 转出，以模拟 Pix 待处理的场景 | Link documentação | PXI0003、或 PXI0010 |
内部 Pix 转账
| 代码 | 步骤 | 描述 | 文档链接 | 前置条件 |
|---|---|---|---|---|
| PXI0012 | 通过 Pix 密钥在两个 alias 间进行内部 Pix 转账 - 同步 | 使用 Pix 密钥从 QI 账户进行 Pix 转账，API 以同步方式响应 | Link documentação | QCA0014 或 QCA0015 |
| PXI0013 | 手动在两个 alias 间进行内部 Pix 转账 - 同步 | 使用手动 Pix（银行数据）从 QI 账户进行 Pix 转账，API 以同步方式响应 | Link documentação | QCA0014 或 QCA0015 |
| PXI0015 | 通过 Pix 密钥在两个 alias 间进行内部 Pix 转账 - 异步 | 使用 Pix 密钥从 QI 账户进行 Pix 转账，API 以异步方式响应 | Link documentação | QCA0014 或 QCA0015 |
| PXI0016 | 手动在两个 alias 间进行内部 Pix 转账 - 异步 | 使用手动 Pix（银行数据）从 QI 账户进行 Pix 转账，API 以异步方式响应 | Link documentação | QCA0014 或 QCA0015 |
| PXI0014 | 内部 Pix 退款 | 从 QI 账户退还内部 Pix | Link documentação | PXI0012、或 PXI0013、或 PXI0015、或 PXI0016 |
查询 Pix 转账
| 代码 | 步骤 | 描述 | 文档链接 | 前置条件 |
|---|---|---|---|---|
| PXI0017 | 查询 Pix 转账 | 获取一笔 Pix 转账的数据 | Link documentação | PXI0002、或 PXI0003、或 PXI0009、或 PXI0010、或 PXI0005、或 PXI0012、或 PXI0013、或 PXI0015、或 PXI0016 |
Pix 交易
| 代码 | 步骤 | 描述 | 文档链接 | 前置条件 |
|---|---|---|---|---|
| PXI0018 | 读取 Pix 转入 webhook | 成功读取 Pix 转入 webhook，该 webhook 由模拟 Pix 转入生成 | Link documentação | PXI0005 |
| PXI0019 | 读取内部 Pix webhook | 成功读取内部 Pix webhook，该 webhook 在完成内部 Pix 后生成 | Link documentação | PXI0012、或 PXI0013、或 PXI0015、或 PXI0016 |
| PXI0020 | 读取待处理 Pix 交易 webhook | 成功读取待处理 Pix 交易 webhook，该 webhook 由模拟待处理 Pix 交易生成 | Link documentação | PXI0008 |
| PXI0021 | 读取 Pix 转出退款 webhook | 成功读取 Pix 转出退款 webhook，该 webhook 由模拟 Pix 转出退款生成 | Link documentação | PXI0004 |
Pix 密钥管理
Pix 密钥的创建与删除
| 代码 | 步骤 | 描述 | 文档链接 | 前置条件 |
|---|---|---|---|---|
| PXI0022 | 创建自然人随机 Pix 密钥 | 在自然人 alias 中创建 5 个随机密钥 | Link documentação | QCA0014 或 QCA0015 |
| PXI0023 | 创建法人随机 Pix 密钥 | 在法人 alias 中创建 20 个随机密钥 | Link documentação | QCA0014 或 QCA0015 |
| PXI0024 | 删除自然人 Pix 密钥 | 删除自然人的 Pix 密钥 | Link documentação | PXI0022 |
| PXI0025 | 删除法人 Pix 密钥 | 删除法人的 Pix 密钥 | Link documentação | PXI0025 |
| PXI0026 | 列出 alias 的 Pix 密钥 | 列出绑定到 alias 的 Pix 密钥 | Link documentação | PXI0022、或 PXI0023 |
Pix QR 码管理
| 代码 | 步骤 | 描述 | 文档链接 | 前置条件 |
|---|---|---|---|---|
| PXI0027 | Pix QR 码简介 | Pix QR 码简介 | Link documentação | PXI0022、或 PXI0023 |
| PXI0027 | 创建静态 Pix QR 码 | 生成静态 QR 码 | Link documentação | PXI0022、或 PXI0023 |
| PXI0028 | 创建带到期日的动态 Pix QR 码 | 生成带到期日的动态 QR 码 | Link documentação | PXI0022、或 PXI0023 |
| PXI0029 | 创建即时支付动态 Pix QR 码 | 创建即时支付动态 Pix QR 码 | Link documentação | PXI0028 |
| PXI0029 | 停用动态 Pix QR 码 | 停用动态 Pix QR 码 | Link documentação | PXI0028 |
| PXI0030 | 列出 alias 的 QR 码 | 列出 alias 的 QR 码 | Link documentação | PXI0029 |
| PXI0030 | 查询 Pix QR 码 | 查询 Pix QR 码 | Link documentação | |
| PXI0031 | QR 码支付 Pix 转入 webhook | QR 码支付 Pix 转入 webhook | Link documentação | PXI0028 |
| PXI0032 | 解码 Pix QR 码 | 解码静态 Pix QR 码、带到期日动态 QR 码和即时动态 QR 码 | Link documentação |
Pix QR 码支付
| 代码 | 步骤 | 描述 | 文档链接 | 前置条件 |
|---|---|---|---|---|
| PXI0033 | 支付静态 Pix QR 码 - 同步 | 支付静态 Pix QR 码，API 以同步方式响应 | Link documentação | PXI0032 |
| PXI0028 | 支付动态 Pix QR 码 - 同步 | 支付动态 Pix QR 码，API 以同步方式响应 | Link documentação | PXI0032 |
| PXI0035 | 支付静态 Pix QR 码 - 异步 | 支付静态 Pix QR 码，API 以异步方式响应 | Link documentação | PXI0032 |
| PXI0036 | 支付动态 Pix QR 码 - 异步 | 支付动态 Pix QR 码，API 以异步方式响应 | Link documentação | PXI0032 |
违规报告
| 代码 | 步骤 | 描述 | 文档链接 | 前置条件 |
|---|---|---|---|---|
| PXI0037 | Pix 转出违规报告（发出） | 为 Pix 转出开立违规报告 | Link documentação | PXI0002、或 PXI0003、或 PXI0009、或 PXI0010 |
| PXI0038 | Pix 转入违规报告（发出） | 为 Pix 转入开立违规报告 | Link documentação | PXI0005 |
| PXI0039 | 读取违规报告状态更新 webhook（收入和发出） | 成功接收参与者此前开立的违规报告状态更新 webhook | Link documentação | PXI0037、或 PXI0038 |
| PXI0040 | 查询违规报告（收入和发出） | 获取参与者开立的 Pix 转出/转入违规报告数据 | Link documentação | PXI0037、或 PXI0038 |
| PXI0041 | 取消违规报告（发出） | 取消参与者此前开立的违规报告 | Link documentação | PXI0037、或 PXI0038 |
| PXI0042 | 模拟违规报告接受响应（发出） | 模拟交易对手接受参与者创建的违规报告（analysis_result=agreed） | 请联系 QI 技术团队进行此场景的模拟 | PXI0037、或 PXI0038 |
| PXI0043 | 模拟违规报告拒绝响应（发出） | 模拟交易对手拒绝参与者创建的违规报告（analysis_result=disagreed） | Link documentação | PXI0037、或 PXI0038 |
| PXI0044 | 模拟接收违规报告（收入） | 模拟接收另一 PSP 为参与者已收 Pix 转入创建的违规报告 | 请联系 QI 技术团队进行此场景的模拟 | PXI0005 |
| PXI0045 | 接受违规报告（收入） | 关闭收入违规报告，表示接受已收到的报告 | Link documentação | PXI0044 |
| PXI0046 | 拒绝违规报告（收入） | 关闭收入违规报告，表示拒绝已收到的违规报告 | Link documentação | PXI0044 |
| PXI0047 | 列出违规报告（收入和发出） | 列出参与者收到或创建的违规报告（收入和发出） | Link documentação | PXI0037、或 PXI0038、或 PXI0044 |
退款申请
| 代码 | 步骤 | 描述 | 文档链接 | 前置条件 |
|---|---|---|---|---|
| PXI0048 | 因违规报告申请退款 | 为交易对手（收款方 PSP）接受的发出违规报告开立退款申请 | Link documentação | PXI0042 |
| PXI0049 | 因操作错误申请退款 | 为交易对手（收款方 PSP）接受的发出违规报告开立退款申请 | Link documentação | PXI0002、或 PXI0003、或 PXI0009、或 PXI0010 |
| PXI0050 | 查询退款申请（收入和发出） | 获取参与者开立的退款申请数据 | Link documentação | PXI0048、或 PXI0049 |
| PXI0051 | 取消退款申请 | 取消参与者此前开立的退款申请 | Link documentação | PXI0048、或 PXI0049 |
| PXI0052 | 模拟因违规报告接受退款申请 | 模拟接受参与者开立的因违规报告退款申请 | 请联系 QI 技术团队进行此场景的模拟 | PXI0048 |
| PXI0053 | 模拟因操作错误接受退款申请 | 模拟接受参与者开立的因操作错误退款申请 | 请联系 QI 技术团队进行此场景的模拟 | PXI0049 |
| PXI0054 | 模拟因违规报告拒绝退款申请 | 模拟拒绝参与者开立的因违规报告退款申请 | 请联系 QI 技术团队进行此场景的模拟 | PXI0048 |
| PXI0055 | 模拟因操作错误拒绝退款申请 | 模拟拒绝参与者开立的因操作错误退款申请 | 请联系 QI 技术团队进行此场景的模拟 | PXI0049 |
| PXI0056 | 读取退款申请状态更新 webhook | 成功接收退款申请状态更新 webhook | Link documentação | PXI0048、或 PXI0049 |
| PXI0057 | 列出退款申请 | 列出参与者收到或创建的退款申请 | Link documentação | PXI0048、或 PXI0049、或 PXI0058 |
| PXI0058 | 模拟接收因违规报告的退款申请 | 模拟接收因违规报告的退款申请 | 请联系 QI 技术团队进行此场景的模拟 | PXI0038、或 PXI0044 |
| PXI0059 | 模拟接收因操作错误的退款申请 | 模拟接收因操作错误的退款申请 | 请联系 QI 技术团队进行此场景的模拟 | PXI0005 |
| PXI0060 | 对已接收退款申请进行 Pix 转入退款 | 对参与者收到的退款申请中所述 Pix 转入进行退款 | Link documentação | PXI0058、或 PXI0059 |
| PXI0061 | 关闭退款申请 | 关闭退款申请，填写为响应此退款申请而进行的 Pix 退款的 pix_transfer_key | Link documentação | PXI0060 |
费率管理
| 代码 | 步骤 | 描述 | 文档链接 | 前置条件 |
|---|---|---|---|---|
| GDT0001 | 修改 QI 账户费率配置 | 修改 QI 账户费率配置 | Link documentação | QCI0012 |