Instalação dos Apps

Esta etapa é executada pelo seu time, quem tem acesso ao VTEX CLI e ao repositório da loja. O time de Integrações CrediPay fornece o que for necessário e acompanha, mas a execução acontece do seu lado.

Pré-requisito: VTEX CLI instalado e autenticado na conta da loja.

1. Apps da CrediPay

A partir da pasta VTEX do repositório da sua loja:

vtex install credixpartnerbr.credipay
vtex install credixpartnerbr.credipay-connector

• credixpartnerbr.credipay — renderiza a tela de confirmação do pagamento dentro do checkout: resumo do pedido, parcelas e confirmação da compra.
• credixpartnerbr.credipay-connector — conecta a loja ao Payment Provider Protocol da VTEX. É quem cria, cancela, liquida e reembolsa pagamentos.

2. Checkout UI Custom

A CrediPay depende do app de interface personalizada de checkout da VTEX. Se ele ainda não estiver instalado:

vtex install [email protected]

3. Interface personalizada de checkout

Por padrão, a VTEX exibe o parcelamento como "Pagamento à vista" ou "3x de R$ X", sem as datas de vencimento. Como na CrediPay o comprador está escolhendo prazos de pagamento e não parcelas de cartão, a data importa mais que o número.

O ajuste é feito no app Interface personalizada de checkout (Checkout UI Custom), na aba JS, e reescreve os rótulos das opções para incluir o vencimento de cada parcela. Partindo do intervalo padrão de 30 dias, ele transforma:

• Pagamento à vista — R$ 500,00 em 1x de R$ 500,00 — vence 30/07
• 3x de R$ 166,67 em 3x de R$ 166,67 — 30/07, 29/08, 28/09

O código é fornecido pelo time da CrediPay. Cole na aba JS e ative a personalização.

4. Verificar o que foi instalado

vtex list

Confirme que credixpartnerbr.credipay está na versão mais recente. Se estiver desatualizado:

vtex update

Próximo passo: VTEX IO — análise antecipada, opcional mas recomendado para lojas de alto volume.