Introdução
Cartão Pós-Pago
As APIs para emissão de cartões pós-pago oferecem aos parceiros da QI Tech uma maneira simples e eficiente de permitir que seus clientes solicitem e emitam Cartões Pós-Pagos, tanto físicos quanto virtuais.
Na QI Tech, proporcionamos aos nossos parceiros a oportunidade de se tornarem subemissores. Por meio de nossas APIs, eles podem oferecer aos seus próprios clientes a possibilidade de emitir cartões pós-pagos, criando uma solução completa para serviços bancários e financeiros.
Para compreender melhor nosso sistema, apresentamos uma visão geral de como funciona o ecossistema de cartões pós-pagos. Contudo, é importante ressaltar que, assim como em todas as nossas APIs, a liberação do serviço deve ser realizada junto ao nosso time, e as chamadas são autenticadas.
O cartão pós-pago é um cartão vinculado a uma linha de crédito que permite ao portador realizar transações, com o pagamento sendo feito posteriormente. Diferente dos cartões pré-pagos, os cartões pós-pagos não exigem que o saldo da conta seja pré-carregado. O usuário pode realizar compras e pagar posteriormente, conforme o limite de crédito aprovado.
As transações realizadas por meio do cartão pós-pago serão cobradas na fatura do portador, com um prazo determinado para o pagamento. Caso o pagamento não seja realizado até a data de vencimento, o portador pode estar sujeito a encargos financeiros, como juros e taxas.
Programa
Para realizar a emissão de um cartão pós-pago, o parceiro precisa ter um programa configurado na integração com a QI Tech. O programa define as regras e parâmetros necessários para a emissão de cartões em conformidade com as bandeiras, como o VISA.
Aqui estão algumas informações importantes sobre o programa:
- Tipo do programa - Refere-se à modalidade de utilização do cartão. Neste caso, trata-se da modalidade Pós-Pago.
- Bandeira - Utilizamos a bandeira VISA para os cartões emitidos.
- Layout do cartão - Refere-se ao design do cartão, tanto para o modelo físico quanto virtual, que será exibido na interface gráfica.
Para configurar um novo programa de cartões pós-pago, é necessário envolver os times comerciais e de implantação da QI Tech.
Carteira (Wallet)
Para emitir cartões de crédito pós-pagos, é necessário primeiro criar uma carteira (wallet) que organiza a fatura do cliente. A carteira funciona como um "conta" onde ficam todos os cartões e configurações de faturamento.
A wallet é como a conta do cliente onde ficam todos os cartões e faturas:
- Uma wallet = fatura: Cada carteira corresponde à fatura de um cliente específico (identificado por CPF/CNPJ)
- Múltiplos meios de pagamento: A mesma wallet pode ter diferentes instrumentos de pagamento (cartões, PIX, etc.)
- Instrumentos separados: Após criar a wallet, será necessário criar separadamente os instrumentos de pagamento (cartões de crédito, limites, etc.)
- Gestão centralizada: A wallet centraliza todas as operações e configurações relacionadas àquele cliente
Para mais detalhes sobre a criação de carteiras, consulte a documentação completa de criação de carteira.
Fluxo de Emissão
Para emitir cartões de crédito pós-pagos, o processo segue uma sequência lógica que começa com a criação de uma carteira (wallet) para o cliente. Esta carteira funciona como um "conta" para organizar todos os cartões e configurações de faturamento.
Após a criação da carteira, é necessário criar um instrumento de pagamento do tipo postpaid_card. Este instrumento é responsável por gerenciar todas as transações e compras realizadas com o cartão. Ao criar o instrumento, um cartão físico ou virtual é criado automaticamente conforme solicitado.
O instrumento de pagamento do tipo postpaid_card:
- Centraliza as transações: Todas as compras realizadas com o cartão ficam atreladas a este instrumento para gerenciamento
- Cria o cartão automaticamente: Ao criar o instrumento, um cartão físico ou virtual é criado automaticamente conforme solicitado
- Gerencia o ciclo de vida: O acompanhamento do status e operações do cartão é feito através dos endpoints de gestão do cartão pós-pago
Para criar o instrumento de pagamento, consulte a documentação de criação de PaymentInstrument.
Configuração de Limites
A carteira possui um limite global de crédito que define o teto máximo disponível para uso. Limites individuais para os instrumentos de pagamento também podem ser configurados.
- Limite da carteira: Define o teto máximo de crédito disponível para uso
- Limite dos instrumentos: Cada instrumento pode ter seu próprio limite configurado, desde que seja menor que o da carteira
- Exemplo prático: Uma carteira com limite de R$ 100 pode ter dois instrumentos com limites de R$ 100 e R$ 80, mas quando o uso dos dois instrumentos chegar a R$ 100, não será possível fazer mais compras
Gestão e Acompanhamento do Cartão
Com a carteira e o instrumento de pagamento configurados, o cartão (físico ou virtual) é criado automaticamente e fica disponível para uso. A carteira centraliza todas as informações de faturamento, permitindo o acompanhamento de transações, pagamentos e configurações de juros e multas.
O acompanhamento do status e ciclo de vida do cartão pode ser realizado através dos endpoints de gestão do cartão pós-pago, que permitem monitorar todas as etapas do ciclo de vida do cartão, desde a criação até a baixa ou cancelamento.
Entradas da Carteira (Wallet Entry)
As entradas da carteira (wallet entries) são dívidas que ficam registradas na carteira do cliente. Essas dívidas podem ser de diferentes tipos:
- Crédito rotativo: Valores de crédito disponibilizados para o cliente
- Saque de folha: Valores de saque de salário/benefício
- Outras operações: Demais operações que geram dívidas
- Uma entrada = uma dívida: Cada entrada é uma dívida específica
- Vira item na fatura: Cada parcela vira automaticamente um item na fatura
- Organiza na fatura: Os itens são organizados em faturas
- Tudo centralizado: Todas as dívidas ficam organizadas na carteira
Para mais informações e consulta das entradas da carteira (Wallet Entry), consulte a documentação de Wallet Entries.
Para acompanhar em tempo real as mudanças de status das entradas da carteira, utilize os webhooks de Wallet Entry.
Entradas de Instrumento de Pagamento (Payment Instrument Entry)
As entradas de instrumento de pagamento (payment instrument entries) são as transações feitas com o cartão. Cada compra ou saque vira uma entrada:
- Transações do cartão: Compras realizadas com o cartão pós-pago
- Saques do cartão: Saques realizados com o cartão pós-pago
- Outras operações: Demais transações relacionadas ao instrumento
- Vinculação automática: Cada entrada é automaticamente atrelada a um invoice item
- Organização em faturas: Os invoice items são organizados em invoices
Para mais informações e consulta das entradas de instrumento de pagamento (Payment Instrument Entry), consulte a documentação de Payment Instrument Entries.
Para acompanhar em tempo real as mudanças de status das entradas de instrumento de pagamento, utilize os webhooks de Payment Instrument Entry.
Faturas (Invoice)
As faturas (invoices) são criadas automaticamente conforme a necessidade dos invoice items. Elas funcionam como contêineres que agrupam os itens relacionados:
- Criação automática: São criadas automaticamente quando necessário
- Status inicial: Todas começam com status
opened(aberta) - Recebe novos itens: Novas compras e transações vão para faturas abertas
opened: Fatura aberta, recebendo novos itensclosed: Fatura fechada, não recebe mais itens
Para mais informações e consulta dos itens da fatura (Invoice), consulte a documentação de Faturas.
Itens de Fatura (Invoice Item)
Os itens de fatura (invoice items) são criados automaticamente para cada parcela das entradas (wallet entry ou payment instrument entry). Eles representam os componentes individuais que compõem uma fatura:
- Parcelas de dívidas: Cada parcela de uma wallet entry gera um invoice item
- Transações individuais: Cada parcela de um payment instrument entry gera um invoice item
- Detalhamento da fatura: Permitem o controle granular de cada item
- Vinculação obrigatória: Todo invoice item deve estar vinculado a uma invoice
- Rastreabilidade: Mantêm referência à entrada original
- Status individual: Cada item pode ter seu próprio status (pending, paid, canceled)
- Valores detalhados: Contêm informações específicas como valor, limite utilizado e valor pago
Para mais informações e consulta dos itens da fatura (Invoice Item), consulte a documentação de Invoice Items.