测试指南 - Pix 综合账户
测试指南描述了集成合作伙伴在进入生产环境之前，需要在 QI Tech 沙盒环境（测试环境）中测试的所有资源和功能。
本指南描述了该产品所涉及的所有资源和功能。
*：进入生产环境的必须步骤
BaaS API 注册与认证
| 代码 | 步骤 | 描述 | 文档链接 | 前置条件 |
|---|---|---|---|---|
| CAB0001* | 在沙盒环境注册 | 在 QI Tech 平台的沙盒环境（sandbox.qitech.app）中完成注册 | Link documentação | |
| CAB0002* | 在沙盒验证 token | 在沙盒环境中完成 QI Token 验证 | Manual de Inclusão do Token | CAB0001 |
| CAB0003* | 交换公钥 | 在 QI Tech 平台沙盒环境（sandbox.qitech.app）中完成公钥交换 | Troca de chaves | CAB0001 和 CAB0002 |
| CAB0004* | 完成 API 调用认证测试 | 完成 API 调用认证测试 | Teste de Autenticação Endpoints de teste da autenticação | CAB0003 |
| CAB0005* | 配置 webhook | 通过 QI Tech 平台沙盒环境（sandbox.qitech.app）完成 QI 发送 webhook 的 URL 配置 | Configuração de webhooks | CAB0001 和 CAB0002 |
QI Conta
| 代码 | 步骤 | 描述 | 文档链接 | 前置条件 |
|---|---|---|---|---|
| QIC0005* | 查询账户数据 | 成功获取 QI 账户数据 | Consultar Conta | - |
| QIC0006* | 列出账户 | 列出已开设的账户 | Link Documentação | - |
Pix QR 码管理
| 代码 | 步骤 | 描述 | 链接 | 前置条件 |
|---|---|---|---|---|
| PIX0023 | 创建动态 Pix QR 码 | 生成带到期日的动态 QR 码及即时动态 QR 码（带过期秒数） | Link Documentação | PIX0008 |
| PIX0024 | 删除动态 Pix QR 码 | 删除 Pix QR 码 | Link Documentação | PIX0023 |
| PIX0025 | 列出动态 Pix QR 码 | 列出动态 Pix QR 码 | Link Documentação | PIX0023 |
| PIX0026 | 读取即时动态 Pix QR 码过期 webhook | 成功接收即时动态 Pix QR 码过期 webhook | Link Documentação | PIX0023 |
| PIX0038 | 读取 Pix 转入 webhook | 成功接收 Pix 转入 webhook | Link Documentação | - |
Pix 密钥查询
| 代码 | 步骤 | 描述 | 文档链接 | 前置条件 |
|---|---|---|---|---|
| PIX0036* | 查询 Pix 密钥数据 | 成功查询 Bacen 中的 Pix 密钥 | Consulta de chave Pix |
Pix 转账
| 代码 | 步骤 | 描述 | 文档链接 | 前置条件 |
|---|---|---|---|---|
| PIX0002* | Pix 转出 | 从 QI 账户使用银行数据（手动 Pix）或 Pix 密钥进行 Pix 转账 | Realização de Transação Pix | |
| PIX0035 | 列出 Pix 转账 | 列出账户的所有 Pix 转账 | Listagem de transferências Pix | PIX0002 |
| PIX0036 | 查询 Pix 转账 | 获取一笔转账的数据 | Consulta de transferência Pix | PIX0002 |
| PIX0003* | 模拟 Pix 转出退款 | 模拟 Pix 转出退款 | Simulação reembolso Pix Out -> Item 3 | PIX0002 |
| PIX0004* | 模拟 Pix 转入 | 模拟 Pix 转入到 QI 账户 | Simulação Pix In -> Item 1 | |
| PIX0005* | Pix 转入退款 | 从 QI 账户退还 Pix 转入 | Reembolso Pix In | PIX0004 |
| PIX0040* | 模拟待处理 Pix 转账状态 | 模拟 Pix 转账状态 | Simulação Pix In -> Item 5 | |
| PIX0037* | 读取待处理交易 webhook | 成功接收待处理交易 webhook | Webhook de transação pendente | PIX0040 |
| PIX0038* | 读取 Pix 转入 webhook | 成功接收 Pix 转入 webhook | Webhook Pix In | PIX0004 |
| PIX0039 | 读取 Pix 退款 webhook | 成功接收 Pix 退款 webhook | Webhook Devolução Pix | PIX0003 |
交易
| 代码 | 步骤 | 描述 | 文档链接 | 前置条件 |
|---|---|---|---|---|
| QIC0008* | 查询交易记录 | 查询账户交易记录 | Consulta de Transações | |
| QIC0009 | 申请转账凭证 | 申请转账凭证 | Solicitar comprovante de transferência | PIX0002 |
| QIC0010* | 读取交易 webhook | 成功接收所有交易 webhook | Webhook account_transaction | CAB0005 和 PIX0002 |
| QIC0011 | 查询金融机构列表 | 查询可接收 TED 和 Pix 的金融机构列表 | Consulta de Instituições Financeiras |
Pix 密钥管理
Pix 密钥的创建与删除
| 代码 | 步骤 | 描述 | 链接 | 前置条件 |
|---|---|---|---|---|
| PIX0008* | 创建 Pix 密钥 | 创建 CPF、CNPJ、随机、邮件和电话类型的 Pix 密钥 | Link Documentação | - |
| PIX0009 | 删除 Pix 密钥 | 删除一个 Pix 密钥 | Link Documentação | PIX0008 |
| PIX0010* | 列出 QI 账户的 Pix 密钥 | 列出绑定到 QI 账户的 Pix 密钥 | Link Documentação | PIX0008 |
解码 Pix QR 码
| 代码 | 步骤 | 描述 | 文档链接 | 前置条件 |
|---|---|---|---|---|
| PIX0027* | 解码 Pix QR 码 | 使用 Pix 复制粘贴 URL 查询（解码）Pix QR 码数据 | Decodificação de QR Code Pix |
Pix 密钥管理
Pix 密钥的创建与删除
| 代码 | 步骤 | 描述 | 链接 | 前置条件 |
|---|---|---|---|---|
| PIX0008* | 创建 Pix 密钥 | 创建 CPF、CNPJ、随机、邮件和电话类型的 Pix 密钥 | Link Documentação | - |
| PIX0009 | 删除 Pix 密钥 | 删除一个 Pix 密钥 | Link Documentação | PIX0008 |
| PIX0010* | 列出 QI 账户的 Pix 密钥 | 列出绑定到 QI 账户的 Pix 密钥 | Link Documentação | PIX0008 |
解码 Pix QR 码
| 代码 | 步骤 | 描述 | 文档链接 | 前置条件 |
|---|---|---|---|---|
| PIX0027* | 解码 Pix QR 码 | 使用 Pix 复制粘贴 URL 查询（解码）Pix QR 码数据 | Decodificação de QR Code Pix |