测试指南 - BaaS 数字账户
测试指南描述了集成合作伙伴在进入生产环境之前，需要在 QI Tech 沙盒环境（测试环境）中测试的所有资源和功能。
本指南描述了该产品所涉及的所有资源和功能。
注意
标有 * 的步骤是进入生产环境的必须步骤
BaaS API 注册与认证
| 代码 | 步骤 | 描述 | 文档链接 | 前置条件 |
|---|---|---|---|---|
| CAB0001* | 在沙盒环境注册 | 在 QI Tech 平台的沙盒环境（sandbox.qitech.app）中完成注册 | cs@qitech.com.br | |
| CAB0002* | 在沙盒验证 token | 在沙盒环境中完成 QI Token 验证 | Download Manual de Inclusão do Token | CAB0001 |
| CAB0003* | 交换公钥 | 在 QI Tech 平台沙盒环境（sandbox.qitech.app）中完成公钥交换 | Link Documentação | CAB0001 和 CAB0002 |
| CAB0004* | 完成 API 调用认证测试 | 完成 API 调用认证测试 | Passo a Passo Link Documentação | CAB0003 |
| CAB0005* | 配置 webhook | 通过 QI Tech 平台沙盒环境（sandbox.qitech.app）完成 QI 发送 webhook 的 URL 配置 | Link Documentação | CAB0001 和 CAB0002 |
反欺诈
注册与认证
| 代码 | 步骤 | 描述 | 文档链接 | 前置条件 |
|---|---|---|---|---|
| ATF0002* | 获取入驻 API 密钥 | 向 QI Tech 集成团队获取用于 /onboarding API 的 API 密钥 | suporte.caas@qitech.com.br | |
| ATF0003* | 获取 OCR 移动令牌 | 向 QI Tech 集成团队获取用于 OCR SDK 的移动令牌 | suporte.caas@qitech.com.br | |
| ATF0004* | 获取人脸识别移动令牌 | 向 QI Tech 集成团队获取用于人脸识别 SDK 的移动令牌 | suporte.caas@qitech.com.br | |
| ATF0005* | 获取设备扫描移动令牌 | 向 QI Tech 集成团队获取用于设备扫描 SDK 的移动令牌 | suporte.caas@qitech.com.br |
SDK OCR
| 代码 | 步骤 | 描述 | 文档链接 | 前置条件 |
|---|---|---|---|---|
| ATF0007* | 构建 SDK | 定义文档采集的模板和自定义配置，并在您的应用（QI Tech 客户端应用）中成功构建 SDK | Android: Link Documentação iOS: Link Documentação | |
| ATF0008* | 提交文档 | 在您的应用（QI Tech 客户端应用）中使用 SDK 完成文档采集 | ATF0003 和 ATF0007 | |
| ATF0009* | 存储 ocr_key | 存储 SDK 返回的密钥，并识别所采集文档的类型（例如：cnh_front、cnh_back 等） | Android: Link Documentação iOS: Link Documentação | ATF0008 |
SDK 人脸识别
| 代码 | 步骤 | 描述 | 文档链接 | 前置条件 |
|---|---|---|---|---|
| ATF0011* | 构建 SDK | 定义自定义配置并在您的应用（QI Tech 客户端应用）中成功构建 SDK | Android: Link Documentação iOS: Link Documentação | |
| ATF0012* | 活体检测流程 | 在您的应用（QI Tech 客户端应用）中使用 SDK 完成活体检测流程 | ATF0004 和 ATF0011* | |
| ATF0013* | 存储图像密钥 | 在完成活体检测流程后存储 SDK 返回的 image_key | Android: Link Documentação iOS: Link Documentação | ATF0012 |
SDK 设备扫描
| 代码 | 步骤 | 描述 | 文档链接 | 前置条件 |
|---|---|---|---|---|
| ATF0015* | 构建 SDK | 定义您的应用（QI Tech 客户端应用）向用户请求的权限，并在您的应用（QI Tech 客户端应用）中成功构建 SDK | Android: Link Documentação iOS: Link Documentação | |
| ATF0016* | 存储用户会话 | 存储将要被扫描设备的用户会话（sessionId） | Android: Link Documentação iOS: Link Documentação | ATF0015 和 ATF0017 |
| ATF0017* | 采集信息 | 使用存储的 sessionId 实例化 SDK，并在您的应用（QI Tech 客户端应用）中调用信息采集方法 | Android: Link Documentação iOS: Link Documentação | ATF0005 和 ATF0015 |
反欺诈
| 代码 | 步骤 | 描述 | 文档链接 | 前置条件 |
|---|---|---|---|---|
| ATF0019* | 自然人反欺诈 | 成功完成自然人客户的反欺诈 | Link Documentação | ATF0002 |
| ATF0020* | 法人反欺诈 | 成功完成法人客户的反欺诈 | Link Documentação | ATF0002 |
| ATF0021* | 读取异步流程派生分析 webhook | 成功接收异步响应流程的派生分析 webhook | Link Documentação | ATF0019 或 ATF0020 |
平台注册
| 代码 | 步骤 | 描述 | 文档链接 | 前置条件 |
|---|---|---|---|---|
| ATF0022* | 注册主用户 | 在 CaaS 平台注册主用户，用于处理派生至"人工审核"的请求 | suporte.caas@qitech.com.br | ATF0019 或 ATF0020 |
QI Conta
开户
| 代码 | 步骤 | 描述 | 文档链接 | 前置条件 |
|---|---|---|---|---|
| QIC0002* | 开设自然人账户 | 开设一个持有人为自然人的账户 | Link Documentação | |
| QIC0002* | 开设法人账户 | 开设一个持有人为法人的账户 | Link Documentação | CAB0005 和 CAB0006 |
| QIC0004* | 读取开户 webhook | 正确读取开户 webhook | Item 1.2. 或 1.3: Link Documentação | QIC0002 或 QIC0002 |
| QIC0005* | 查询账户数据 | 查询余额、持有人数据、 开户日期等账户数据 | Link Documentação | QIC0002 或 QIC0002 |
交易
| 代码 | 步骤 | 描述 | 链接 | 前置条件 |
|---|---|---|---|---|
| QIC0008* | 查询对账单 | 查询账户对账单 | Link Documentação | QIC0002 或 QIC0002 |
| QIC0009* | 申请转账凭证 | 申请一张转账凭证 | Link Documentação | |
| QIC0010* | 读取交易 webhook | 成功接收所有交易 webhook | Link Documentação | QIC0002 或 QIC0002 |
| QIC0011* | 查询金融机构列表 | 查询可接收 TED 和 Pix 的金融机构列表 | Link Documentação | QIC0002 或 QIC0002 |
文件上传
| 代码 | 步骤 | 描述 | 链接 | 前置条件 |
|---|---|---|---|---|
| UDD0001* | 上传文件 | 通过文档 API 上传文件 | Link Documentação |
TED
| 代码 | 步骤 | 描述 | 链接 | 前置条件 |
|---|---|---|---|---|
| TED0001* | TED 转出 | 向其他 金融机构进行 TED 转账 | Link Documentação | QIC0002 或 QIC0002 |
| TED0002* | 模拟 TED 转出退回 | 模拟从 QI 账户发出的 TED 转出退回 | Item 3: Link Documentação | TED0001 |
| TED0003* | 模拟 TED 转入 | 模拟 TED 转入到 QI 账户 | Item 2: Link Documentação | QIC0002 或 QIC0002 |
| TED0004* | 查询 TED 交易 | 列出 TED 交易 | Link Documentação | QIC0002 或 QIC0002 |
| TED0004* | 查询 TED 交易 | 查询一笔 TED 交易 | Link Documentação | QIC0002 或 QIC0002 |
| TED0006* | 读取 TED webhook | 成功接收 TED webhook | Link Documentação | QIC0002 或 QIC0002 |
内部转账
| 编号 | 步骤 | 描述 | 链接 | 前置条件 |
|---|---|---|---|---|
| TFI0001 | 账户借记内部转账 | 从一个 QI 账户发起转账，目标账户为另一个 QI 账户 | Link Documentação | QIC0002 或 QIC0002 |
| TFI0002 | 模拟账户贷记内部转账 | 模拟目标 QI 账户接收来自另一个 QI 账户的资金 | Item 1: Link Documentação | QIC0002 或 QIC0002 |
票据
票据管理
| 编号 | 步骤 | 描述 | 链接 | 前置条件 |
|---|---|---|---|---|
| BOL0002* | 登记收款票据 | 通过发送登记事件完成收款票据登记 | Link Documentação | QIC0002 或 QIC0002 , |
| BOL0003 | 查询票据收款钱包 | 查询可供票据登记的收款钱包 | Link Documentação | QIC0002 或 QIC0002 |
| BOL0004* | 发送收款票据指令 | 向已登记票据发送指令 | Link Documentação | BOL0002 |
| BOL0005 | 模拟票据清算 | 模拟票据清算 | Link Documentação | BOL0002 |
| BOL0006* | 读取票据 webhook | 成功接收所有与票据状态变更相关的 webhook | Link Documentação | BOL0004 |
| BOL0007 | 登记 bolepix | 完成 bolepix 登记 | Link Documentação |
票据支付
| 代码 | 步骤 | 描述 | 链接 | 前置条件 |
|---|---|---|---|---|
| BOL0009* | 查询可打印条形码 | 查询银行票据或协议票据的可打印条形码 | Link Documentação | |
| BOL0010* | 支付票据 | 支付银行票据或协议票据 | Link Documentação | QIC0002 或 QIC0002 |
| BOL0011* | 查询可打印条形码 | 查询协议票据的可打印条形码 | Link Documentação | |
| BOL0013* | 支付票据 | 支付协议票据 | Link Documentação | QIC0002 或 QIC0002 |
Pix
Pix 转账
| 代码 | 步骤 | 描述 | 文档链接 | 前置条件 |
|---|---|---|---|---|
| PIX0002* | Pix 转出 | 从 QI 账户使用银行数据（手动 Pix）或 Pix 密钥进行 Pix 转账 | Link Documentação | CAB0001 |
| PIX0035 | 查询 Pix 转账 | 获取一笔转账的数据 | Link Documentação | PIX0002 |
| PIX0003* | 模拟 Pix 转出退款 | 模拟 Pix 转出退款 | Link Documentação - Item 2 | PIX0002 |
| PIX0004* | 模拟 Pix 转入 | 模拟 Pix 转入到 QI 账户 | Link Documentação -> Item 1 | |
| PIX0037* | 读取待处理交易 webhook | 成功接收待处理交易 webhook | [Link Documentação][(/documentation/baas/pix/webhooks) | PIX0002 |
| PIX0038* | 读取 Pix 转入 webhook | 成功接收 Pix 转入 webhook | Link Documentação | PIX0004 |
| PIX0039 | 读取 Pix 退款 webhook | 成功接收 Pix 退款 webhook | Link Documentação | PIX0003 |
Pix 密钥管理
Pix 密钥的创建与删除
| 代码 | 步骤 | 描述 | 链接 | 前置条件 |
|---|---|---|---|---|
| PIX0008* | 创建 Pix 密钥 | 创建 CPF、CNPJ、随机、邮件和电话类型的 Pix 密钥 | Item 5.1. e 5.2: Link Documentação | QIC0002 或 QIC0002 |
| PIX0009 | 删除 Pix 密钥 | 删除一个 Pix 密钥 | Link Documentação | PIX0008 |
| PIX0010* | 列出 QI 账户的 Pix 密钥 | 列出绑定到 QI 账户的 Pix 密钥 | Link Documentação | PIX0008 |
| PIX0011* | 读取随机 Pix 密钥激活 webhook | 成功接收随机密钥创建 webhook | Item 5.1: Link Documentação | PIX0008 |
Pix 密钥可携性
| 代码 | 步骤 | 描述 | 链接 | 前置条件 |
|---|---|---|---|---|
| PIX0013* | 创建 Pix 密钥转入可携性申请 | 创建 CPF、CNPJ、电子邮件、电话和随机类型的 Pix 密钥转入可携性申请 | Link Documentação | QIC0002 或 QIC0002 |
| PIX0014* | 重发电话或邮件类型 Pix 密钥转入可携性申请的双重验证 | 申请重发待处理（pending_claimer_validation）的 Pix 密钥转入可携性申请的 SMS（电话类型密钥）或电子邮件（邮件类型密钥） | Link Documentação | PIX0013 |
| PIX0015* | 删除 Pix 密钥转入可携性申请 | 删除待处理的 Pix 密钥转入可携性申请 | Link Documentação | PIX0013 |
| PIX0016* | 读取 Pix 密钥转入可携性申请完成的 webhook | 正确读取 Pix 密钥转入可携性申请完成的 webhook，测试所有可能的完成状态（concluded、cancelled 和 failed） | Webhook: Link Documentação | PIX0013 |
| PIX0017* | 模拟 Pix 密钥转出可携性申请 | 模拟收到 Pix 密钥转出可携性申请 | Item 5: Link Documentação | PIX0013 |
| PIX0018* | 批准和拒绝 Pix 密钥转出可携性申请 | 批准 Pix 密钥转出可携性申请 | Link Documentação | PIX0017 |
| PIX0019* | 重发 Pix 密钥转出可携性申请的双重验证 | 申请重发 Pix 密钥转出可携性申请的双重验证 | Enum "pending_donator_validation" Link Documentação | PIX0018 |
| PIX0020* | 读取 Pix 密钥转出可携性申请完成的 webhook | 正确读取 Pix 密钥转出可携性申请完成的 webhook，测试所有可能的完成状态（concluded、cancelled 和 failed） | Link Documentação | PIX0018 |
Pix QR 码管理
| 代码 | 步骤 | 描述 | 链接 | 前置条件 |
|---|---|---|---|---|
| PIX0022* | 创建静态 Pix QR 码 | 生成静态 QR 码 | Link Documentação | PIX0008 |
| 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 |
| PIX0027* | 解码 Pix QR 码 | 解码静态 Pix QR 码、带到期日动态 QR 码和即时动态 QR 码 | Link Documentação | PIX0022 和 PIX0023 |
Pix QR 码支付
| 代码 | 步骤 | 描述 | 链接 | 前置条件 |
|---|---|---|---|---|
| PIX0029* | 支付静态 Pix QR 码 | 支付静态 Pix QR 码 | Item 4.1: Link Documentação | PIX0022 |
| PIX0030* | 支付动态 Pix QR 码 | 支付动态 Pix QR 码 | Item 4.2: Link Documentação | PIX0022 |
Pix 限额管理
| 代码 | 步骤 | 描述 | 链接 | 前置条件 |
|---|---|---|---|---|
| PIX0032* | 申请修改 Pix 限额 | 申请修改 QI 账户的 Pix 限额 | Link Documentação | QIC0002 或 QIC0002 |
| PIX0033 | 列出 Pix 限额修改申请 | 列出 QI 账户的 Pix 限额修改申请 | Link Documentação | PIX0032 |
| PIX0034* | 查询 Pix 已用限额 | 查询 QI 账户的 Pix 已用限额 | Link Documentação | QIC0002 或 QIC0002 |
费率管理
| 代码 | 步骤 | 描述 | 链接 | 前置条件 |
|---|---|---|---|---|
| GTF0001* | 申请修改费率 | 修改账户费率 | Link Documentação | QIC0002 或 QIC0002 |
| GTF0002* | 查询费率 | 查询账户已注册的费率 | Link Documentação | QIC0002 或 QIC0002 |
卡片管理
创建卡片
| 代码 | 步骤 | 描述 | 链接 | 前置条件 |
|---|---|---|---|---|
| GDC0001* | 创建虚拟卡 | 创建一张虚拟卡 | Link Documentação | QIC0002 或 QIC0002 |
| GDC0002* | 创建实体卡 | 创建一张实体卡 | Link Documentação | QIC0002 或 QIC0002 |
查询卡片
| 代码 | 步骤 | 描述 | 链接 | 前置条件 |
|---|---|---|---|---|
| GDC0003* | 通过密钥查询卡片 | 查询一张卡片 | Link Documentação | GDC0001 或 GDC0002 |
| GDC0004* | 列出卡片 | 列出卡片 | Link Documentação | GDC0001 或 GDC0002 |
| GDC0005* | 获取卡片数据 | 获取卡片数据 | Link Documentação | GDC0001 或 GDC0002 |
| GDC0006* | 获取 PCI 密码 | 获取 PCI 密码 | Link Documentação | GDC0001 或 GDC0002 |
| GDC0007* | 查询配送数据 | 查询配送数据 | Link Documentação | GDC0001 或 GDC0002 |
更新卡片数据
| 代码 | 步骤 | 描述 | 链接 | 前置条件 |
|---|---|---|---|---|
| GDC0008* | 更新卡片状态 | 更新卡片状态 | Link Documentação | GDC0001 或 GDC0002 |
| GDC0009* | 激活实体卡 | 激活一张实体卡 | Link Documentação | GDC0001 或 GDC0002 |
| GDC0010* | 修改密码 | 修改卡片密码 | Link Documentação | GDC0001 或 GDC0002 |
| GDC0011* | 配置卡片的非接触式支付 | 配置卡片的非接触式支付 | Link Documentação | GDC0002 |