跳到主要内容

简介

后付费卡​

后付费卡发行 API 为 QI Tech 合作伙伴提供了一种简单高效的方式，让其客户能够申请和发行后付费卡，包括实体卡和虚拟卡。

在 QI Tech，我们为合作伙伴提供成为子发行商的机会。通过我们的 API，他们可以为自己的客户提供发行后付费卡的能力，打造完整的银行和金融服务解决方案。

为了更好地理解我们的系统，我们将简要介绍后付费卡生态系统的运作方式。请注意，与其他所有 API 一样，服务的开通需与我们的团队协调，且**调用需经过身份验证**。

后付费卡与一条信用额度绑定，允许持卡人进行交易并在之后付款。与预付卡不同，后付费卡不需要预先充值账户余额。用户可以先消费后还款，额度以批准的信用额度为准。

通过后付费卡进行的交易将计入持卡人的账单，需在规定期限内还款。若未在到期日前还款，持卡人可能需承担财务费用，如利息和手续费。

程序（Program）​

要发行后付费卡，合作伙伴需要在与 QI Tech 的集成中配置好相应的程序。程序定义了符合 VISA 等卡组织要求发行卡片所需的规则和参数。

以下是关于程序的一些重要信息：

  • 程序类型 — 指卡的使用模式。本文档所述为后付费模式。
  • 卡组织 — 我们使用 VISA 卡组织发行卡片。
  • 卡面设计 — 指卡的设计，包括实体卡和虚拟卡图形界面中显示的设计。
注意

如需配置新的后付费卡程序，需要联系 QI Tech 的商务团队和实施团队。

钱包（Wallet）​

要发行后付费信用卡，首先需要创建一个**钱包（wallet）**来管理客户的账单。钱包作为"账户"，存储所有卡片和账单配置。

什么是 Wallet

wallet 就像客户的账户，存储所有卡片和账单：

  • 一个 wallet = 一张账单：每个钱包对应一个特定客户（由 CPF/CNPJ 标识）的账单
  • 多种支付手段：同一个 wallet 可以有不同的支付工具（卡片、PIX 等）
  • 独立的工具：创建 wallet 后，需要分别创建支付工具（信用卡、额度等）
  • 集中管理：wallet 集中管理与该客户相关的所有操作和配置

有关创建钱包的更多详情，请参阅**钱包创建完整文档**。

发行流程​

发行后付费信用卡遵循从为客户创建钱包（wallet）开始的逻辑顺序。该钱包作为"账户"，用于组织所有卡片和账单配置。

创建钱包后，需要创建 postpaid_card 类型的支付工具（payment instrument）。该工具负责管理使用卡片进行的所有交易和消费。创建工具时，系统将根据请求自动创建实体卡或虚拟卡。

支付工具

postpaid_card 类型的支付工具：

  • 集中管理交易：所有使用该卡进行的消费均与此工具关联以便管理
  • 自动创建卡片：创建工具时，系统将根据请求自动创建实体卡或虚拟卡
  • 管理生命周期：通过**后付费卡管理端点**监控卡片状态和操作

要创建支付工具，请参阅**PaymentInstrument 创建文档**。

额度配置​

钱包拥有一个全局信用额度，定义了可用的最大上限。也可以为各个支付工具配置独立额度。

额度的工作方式
  • 钱包额度：定义可用信用额度的最大上限
  • 工具额度：每个工具可以配置独立额度，但不得超过钱包额度
  • 实际示例：额度为 R$ 100 的钱包可以有两个额度分别为 R$ 100 和 R$ 80 的工具，但当两个工具的使用总额达到 R$ 100 时，将无法进行更多消费
  • 实时验证：在允许新交易前，系统将同时验证工具额度和钱包额度
薪资卡 Wallet 的额度

payroll 类型的钱包有两种不同的额度：

  • postpaid_credit_limit：用于消费和卡片交易的后付费信用额度
  • payroll_withdraw_limit：工资提款的专用额度（工资/福利），每月自动从客户工资中扣除

两种额度均显示在钱包的 wallet_limits 列表中，独立运作，使客户可以分别拥有卡片消费额度和福利提款专用额度。

卡片管理与跟踪​

配置好钱包和支付工具后，卡片（实体卡或虚拟卡）将自动创建并可立即使用。钱包集中管理所有账单信息，支持跟踪交易、付款以及利息和罚款配置。

可通过**后付费卡管理端点**跟踪卡片的状态和生命周期，监控从创建到注销或取消的所有阶段。

钱包条目（Wallet Entry）​

**钱包条目（wallet entries）**是记录在客户钱包中的债务。这些债务可以是不同类型：

  • 循环信用（revolving_credit）：为客户提供的信用额度
  • 工资提款（payroll_withdraw）：因提取额度而产生的债务，每月从 INSS 中扣除
  • 工资逾期（payroll_overdue）：因未支付账单而产生的债务，每月也从 INSS 中扣除
Wallet Entries 的工作方式
  • 一个条目 = 一笔债务：每个条目是一笔特定的债务
  • 转化为账单项目：每期分期付款自动转化为账单中的一个项目
  • 在账单中整理：项目在账单中整理
  • 集中管理：所有债务均在钱包中统一管理

有关钱包条目（Wallet Entry）的更多信息和查询，请参阅**Wallet Entries 文档**。

Wallet Entry Webhook

要实时跟踪钱包条目的状态变化，请使用**Wallet Entry webhook**。

支付工具条目（Payment Instrument Entry）​

**支付工具条目（payment instrument entries）**是使用卡片进行的交易记录。每笔消费或提款都会生成一个条目：

  • 卡片交易：使用后付费卡进行的消费
  • 卡片提款：使用后付费卡进行的提款
  • 其他操作：与工具相关的其他交易
Payment Instrument Entries 的工作方式
  • 自动关联：每个条目自动与一个 invoice item 关联
  • 在账单中整理：invoice items 在 invoices 中整理
  • 自动创建账单：创建新交易时，系统根据钱包的结账配置自动创建所需账单，以容纳交易的所有分期付款
关于取消的重要说明
  • 未结账单：未结账单中的取消操作会立即释放额度并从账单中删除相应金额
  • 已结账单：已结账单中的取消操作会创建退款，显示在 invoice_payments_chargebacks 字段中，并在下一张账单中使用

有关支付工具条目（Payment Instrument Entry）的更多信息和查询，请参阅**Payment Instrument Entries 文档**。

Payment Instrument Entry Webhook

要实时跟踪支付工具条目的状态变化，请使用**Payment Instrument Entry webhook**。

账单（Invoice）​

**账单（invoices）**根据 invoice items 的需要自动创建。它们作为容器，将相关项目分组：

  • 自动创建：系统根据钱包的结账配置自动创建
  • 分期付款管理：每期分期付款均对应账单中的一个项目
  • 付款与跟踪：支持跟踪付款、余额和账单状态