Introdução

A CrediPay é uma solução completa para facilitar operações de crédito no ambiente B2B, integrada diretamente à plataforma VTEX. Este documento descreve as funcionalidades disponíveis, bem como aquelas que serão lançadas em breve, explicando como cada etapa da jornada, desde a análise de crédito até o faturamento, reembolsos e relatórios, foi pensada para tornar o processo de compra a prazo mais ágil, seguro e eficiente.

Nosso objetivo é permitir que vendedores ofereçam crédito de forma automatizada e com segurança, reduzindo riscos e aumentando a conversão de vendas. Para isso, integramos a análise de crédito em tempo real, garantimos a comunicação segura entre sistemas e disponibilizamos relatórios completos de acompanhamento e reconciliação.

Funcionalidades

Análise de crédito em tempo real

A CrediPay pode rodar uma análise de crédito em tempo real em 2 momentos da jornada do cliente:

Quando o cliente loga, caso não tenha sido analisado ainda, ele será analisado
Quando um comprador chega ao checkout e deseja transacionar utilizando crédito. Aqui 3 cenários podem ocorrer:
- O comprador possui limite suficiente para completar a transação
- O comprador possui limite, mas não o suficiente para completar a transação
- O comprador não possui limite

Dentro do checkout, a integração da CrediPay automaticamente identifica compradores nos cenários 2 e 3, e realiza uma análise de crédito em tempo real usando apenas o CNPJ. Assim, conseguimos atribuir um novo limite em minutos (dependendo da análise de crédito) e permitir que este cliente finalize a compra.

Medidas de segurança nesta etapa

Analisamos centenas de dados do CNPJ a fim de avaliar não só o risco de crédito, mas também de fraude. Alguns exemplos são se o CNPJ foi criado ou adquirido recentemente, se possui processos, entre outros.
Analisamos também o histórico dos sócios, para garantir que não estejam envolvidos em outras atividades potencialmente fraudulentas.
Além de nosso próprio modelo, o CNPJ é analisado também por nossos parceiros, que possuem suas próprias regras de prevenção à fraude, envolvendo bases de dados interbancárias de fraude, blacklists, entre outros.

Reavaliação da análise de crédito via Open Banking ou Documentos

Caso, na etapa anterior, a análise de crédito resulte em uma recusa, ou em uma aprovação parcial, ainda oferecemos mais uma oportunidade para o comprador conseguir obter o crédito necessário para fechar a sua compra. Neste cenário, oferecemos a ele a opção de solicitar uma re-avaliação da decisão inicial, nos enviando alguns dados adicionais, que podem ser:

Conexão Open Finance: O comprador compartilha conosco dados de sua conta bancária, como extrato, uso de cartão de crédito, etc.
Documentos: O comprador nos envia seu DRE, Balanço/Balancete, e NFs de venda

Estes dados são analisados por agentes de IA, e caso seja aprovado, o comprador receberá uma comunicação de que agora está habilitado a transacionar.

Criação de pedidos

Tendo limite de crédito, o comprador conseguirá abrir a tela de confirmação de pedido, onde verá um resumo de sua compra, e com um clique consegue finalizar a compra sem sair do ambiente VTEX. Ao fazer isso, o pedido é enviado à CrediPay, e o valor da compra é subtraído limite de crédito disponível do cliente.

No nosso checkout, o comprador começa o processo escolhendo o número de parcelas com que deseja pagar. Depois, abre o modal, que exibirá as datas de vencimento dos boletos do pedido.

Nota: Como a VTEX permite configurar o número de parcelas mas não as datas, assumimos 30 dias entre cada parcela. Portanto, um pedido de 3 parcelas por exemplo será 30-60-90

Medidas de segurança nesta etapa

O servidor da CrediPay recebe dados diretamente do servidor da VTEX, impossibilitando ataques via manipulação do cliente
Serão aceitos pedidos com endereço de entrega apenas para o endereço do cartão CNPJ

Faturamento

Com o meio de pagamento instalado no ambiente VTEX, a CrediPay consegue monitorar quando os pedidos criados recebem uma NF. Com isso, assim que a VTEX recebe um arquivo de XML de NF, ele automaticamente é transmitido à CrediPay.

Tendo recebido a NF, a CrediPay irá realizar o provisionamento do montante a ser pago, que será desembolsado em até 24h úteis na conta do vendedor. Para mais detalhes sobre reconciliação, veja Relatórios.

Medidas de segurança nesta etapa

Checamos novamente o endereço de entrega, para garantir que é o mesmo do cartão CNPJ
Ao receber uma NF, realizamos automaticamente os trâmites legais de aquisição do recebível (duplicata) junto à CERC, uma registradora de ativos de crédito, que por sua vez realizada validações diretamente com a Secretaria da Fazenda e com outras registradoras

Reembolsos e Cancelamentos

Similarmente ao tópico anterior, a CrediPay receberá de forma automática os reembolsos e cancelamentos da VTEX, que por sua vez deve receber do ERP. Quando isto acontecer, os boletos serão ajustados automaticamente, para garantir uma cobrança coerente ao comprador. Além disso, o valor reembolsado será somado ao limite de crédito disponível do cliente, permitindo-o usar esse saldo para novas compras.

Buscando otimizar o processo, nós não requisitamos que o vendedor faça uma transferência para nos estornar os valores reembolsados, mas descontamos do adiantamento seguinte. Esse detalhamento pode ser encontrado na parte de Relatórios (abaixo).

Como isso se integra ao ERP?

Com a integração ERP-VTEX configurada, não é necessário nenhum ajuste adicional, e os reembolsos e cancelamentos fluirão automaticamente para a VTEX, e em seguida para a CrediPay.

Medidas de segurança nesta etapa

Nunca acataremos uma solicitação de reembolso ou cancelamento vinda diretamente do comprador. Nestes casos, o vendedor é quem nos deve informar o pedido e o valor a ser reembolsado.

Relatórios

Em conjunto com a integração VTEX-CrediPay, entregamos também um dashboard por onde é possível acompanhar as principais métricas e dados da operação. Veja abaixo um descritivo de cada uma das seções:

*certos dados foram ocultos para assegurar a privacidade de nossos usuários

Reconciliação

Nesta aba, é possível visualizar, na maior granularidade possível, tudo o que está sendo pago e cobrado na relação entre CrediPay e vendedor.

Limites de crédito

Nesta aba, é possível obter uma visão geral de todos os limites de crédito aprovados pela CrediPay, o quanto foram consumidos, e o quanto ainda está disponível

Acompanhamento de pedidos e XML’s

Aqui, é possível acompanhar quais pedidos ainda não receberam um XML de Nota Fiscal, portanto estão ocupando limite de crédito do cliente sem que o vendedor tenha sido pago.

Cobrança

Na seção de cobrança, damos visibilidade dos casos em que ainda não conseguimos receber pelo pedido, e um detalhamento dos valores em aberto por comprador.

Funcionalidades adicionais (API)

Caso seja necessário estender a integração com a CrediPay além dos tópicos mencionados acima, nós oferecemos também um conjunto de APIs, que está explicado nas demais páginas desta documentação.

Integração com ERP

Criação do pedido

Meio de pagamento

Para o ERP conseguir aceitar o pedido vindo da VTEX, é necessário que seja configurado um meio de pagamento específico para a CrediPay. Deve-se assegurar que este meio de pagamento não gere boletos para o comprador, já que a cobrança vai ser realizada pela CrediPay.

Parcelas

A VTEX enviará, no objeto do pedido, o número parcelas escolhido pelo comprador (por exemplo, no caso de 30-60-90, teremos “installments”:3 ). O ERP deve possuir a lógica de ler esse dado e calcular as datas de vencimento das cobranças do pedido, que serão 30,60 e 90 dias após sua criação. Isso será importante na parte do faturamento. Portanto:

Installments = 1 → Pedido será pago em uma parcela, vencendo em 30 dias

Installments = 2 → Pedido será pago em duas parcelas de igual valor, vencendo em 30 e 60 dias

Installments = 3 → Pedido será pago em três parcelas de igual valor, vencendo em 30, 60 e 90 dias

Faturamento

Se o pedido foi criando corretamente na etapa anterior, o faturamento deve ser relativamente simples. Cada parcela criada deve entrar na Nota Fiscal como uma duplicata - portanto, se temos 3 parcelas por exemplo (installments = 3), devemos ter 3 duplicatas, vencendo em 30, 60 e 90 dias.

Em termos técnicos, isso significa que o XML deve conter a tag dup, sendo uma para cada parcela do pedido (a primeira parcela terá número 1, a segunda 2, a terceira 3 - normalmente é gerado de forma automática pelo ERP). O vencimento e valor de cada duplicata na NF será usado para a emissão de boletos - por exemplo, se temos uma duplicata de R$1000 com vencimento em 25/10/2025, o boleto a ser gerado terá exatamente os mesmos parâmetros.

Envio da NF à VTEX

O envio da NF à VTEX deve ocorrer somente após a aprovação da Secretaria da Fazenda para a NF. Em termos técnicos, isso quer dizer que o XML da NF deve conter a tag nfeProc para ser aceito. Isso, juntamente com a presença das duplicatas (etapa anterior), é o que garante que aquela NF está pronta para ser utilizada em uma operação de crédito.

Ao faturar um pedido na VTEX, um dos parâmetros a serem passados é o invoiceUrl. Neste campo, é fundamental que seja enviado um URL público diretamente para o arquivo XML da NF em questão. Esse é um URL que necessariamente acabará com ‘.xml’

Conclusão

Com a CrediPay, compradores e vendedores contam com uma solução completa para transações B2B a prazo. Nossa proposta é simplificar o acesso ao crédito, automatizar processos e garantir uma experiência fluida em todas as etapas, da análise de crédito ao faturamento e acompanhamento financeiro.

Estamos comprometidos em evoluir continuamente nossa plataforma, oferecendo novas funcionalidades e mantendo um alto padrão de segurança e transparência. Conte com nosso time de integrações e suporte dedicado para garantir o sucesso da implementação e o máximo aproveitamento das soluções CrediPay em sua operação.