Ativando conector PagSeguro V3

Neste tutorial vamos te ajudar a integrar o conector PagSeguro V3 na sua loja na plataforma Vtex.

Serviços integrados:

· Transações via Cartão de Crédito à vista e parcelado;
· Bandeiras aceitas: Mastercard, Visa, Elo, Hipercard, Hiper, American Express, Diners e Aura;
. Pagamento com pré-autorização;
· Pagamentos com 2 cartões (feature nativa da plataforma Vtex);
· One click buy (feature nativa da plataforma Vtex;
· Transações via PIX;
· Gestão de Risco (Antifraude);
· Estorno e Cancelamento total;
· Estorno e Cancelamento parcial (cartão de crédito, boleto e pix);
· Notificação/Consulta;
. Flag de Recorrência.

Para integrar o conector PagSeguroV3 na plataforma Vtex basta seguir o passo a passo abaixo:

1- Acesse sua conta na Vtex.
2- Acesse o módulo de pagamentos
3- Clique em Configurações:

4- Clique na opção ‘’Afiliações de Gateways’’ e depois em "+":

5- Localize a afiliação PagSeguroV3 e selecione:

6- Valide o nome da Afiliação e, caso necessário, altere para fácil identificação. Clique em Salvar:

Na opção de Captura automática de pagamento, selecione a forma que deseja que seu pagamento seja processado:

7- O campo Captura de pagamento é composto pelas seguintes opções:

Comportamento de uso recomendado pelo processador de pagamento: A captura será realizada automaticamente.
Captura Automática Imediatamente Após Autorização de Pagamento: A captura é realizada automaticamente logo após a autorização de pagamento, mesmo que a transação inclua análise antifraude.
Captura Automática Imediatamente Após Análise Antifraude: A captura é realizada automaticamente logo após a autorização de pagamento e análise antifraude. Caso selecione este comportamento e não possua análise antifraude, o sistema realizará a captura do pagamento como na Captura Automática Imediatamente Após a Autorização do Pagamento.
Agendado: Horários A Captura Automática: Ao selecionar esta opção, será exibido o campo Horário agendado em horas para captura automática, devendo ser preenchido com o período em que ocorrerá a captura automática. Este período deve estar de acordo com os limites permitidos pelo provedor de pagamento. Opção para quem deseja utilizar a captura posterior em um determinado período de tempo.
Desativado: Não Capturado Automaticamente: A captura ocorre somente quando o pedido é faturado. Caso opte por este comportamento, é importante estar atento ao tempo de faturação, pois a faturação pode ultrapassar o tempo de captura acordado com o prestador de pagamentos e levar ao cancelamento da transação.

8- Para configurar o pagamento com Captura Posterior (Pré-autorização):

Selecione a opção 'Agendada: Defina quando a captura automática será realizada';
No campo, 'Prazo agendado em horas para captura automática', preencha com o valor em horas que deseja que a captura do pagamento pré-autorizado seja capturado. No exemplo, o pagamento será capturado 2 horas após a criação da transação.
No campo 'Prazo para captura do pagamento', selecione o mesmo tempo descrito no campo anterior.
O status da transação na VTEX ficará como 'EM AUTORIZAÇÃO'.
Funcionalidade permitida apenas para pagamento com Cartão de Crédito.

OBS: Ao autorizar uma cobrança, a mesma ficará disponível para captura por até 5 dias corridos no PagSeguro. Após esse período a transação será cancelada. Sendo assim, não coloque um tempo maior que o aceito para captura.

OBS: Esse modelo é indicado para operações mais complexas ou que requerem confirmação/ validação de alguma outra parte/ sistema antes de efetivar a cobrança no cartão de crédito. Veja alguns exemplos em que esse modelo melhor se aplica:

O lojista possui uma análise de risco externa;
O lojista precisa confirmar estoque ou disponibilidade do item adquirido;
O lojista precisa confirmar se algum prestador de serviço poderá realizar a atividade;
Venda de itens a granel, onde os valores podem sofrer alterações.

OBS: Cancelamento:

Caso ocorra um cancelamento total, antes da captura do pagamento, o saldo sensibilizado na pré-autorização será disponibilizados novamente ao comprador.
Caso ocorra um cancelamento parcial, antes da captura do pagamento, será feita uma captura parcial do pagamento do comprador.
Cenário de estorno após a captura, acontece o fluxo normal de cancelamento da transação.

9- Para configurar o pagamento com Captura Automática:

Selecione a opção Comportamento de uso recomendado pelo processador de pagamento;
Em 'Prazo para captura do pagamento', selecione a opção Imediato.

10- Clique em Autorizar:

11- Acesse com sua conta PagSeguro com e-mail e senha:

12- Autorize a aplicação:

13- Após autorizar a aplicação a página será retornada para a Vtex e os campos estarão preenchidos. Clique em salvar:

14- Pronto, agora a afiliação está ativa em sua loja. Como próximos passos será necessário configurar os meios de pagamento

Configurando meios de pagamento:

🚧
Lembrando que os meios de pagamentos são: Cartão de crédito (bandeiras: Mastercard, Visa, Elo, Hipercard, Hiper, American Express, Diners e Aura), Pix.

15- Clique em condições de pagamentos na aba superior e em seguida em "+", para adicionar o conector aos meios de pagamento:

16- Selecione o meio de pagamento desejado:

17- Configure os cartões à vista com o conector PagseguroV3:

• Altere o status para ‘’Ativa’’
• Caso utilize um Antifraude de terceiro é necessário selecionar o campo ‘’Usar Antifraude’’ e escolher a opção.
• Crie um Nome da regra para cada bandeira (Exemplo: American Express PagSeguroV3)
• Clique em salvar.
O mesmo processo deve ser feito para as demais bandeiras.

18- O cartão deve aparecer com o conector PagSeguroV3 na listagem e com a marcação ‘’Ativa’’:

19- Configure os cartões com parcelamento e juros com o conector PagseguroV3:

• Selecione o cartão que desejar permitir o parcelamento, conforme exibido nos passos 13 e 14;
• Em processar afiliação localize o PagSeguroV3;
• Mude o status para ativo;
• À direita, selecione 'Parcelado' para configurar as parcelas;
• Em total de parcelas preencha de '1 - (até a parcela máxima que deseja permitir compras em sua loja';
Exemplo: 1-6; 1-10; 1-12.
Obs: Por definição, as bandeiras aceitam parcelamento em até 12x.
• Caso tenha um valor mínimo para a parcela, preencher em 'Parcela Mínima';

20- Configurando juros nas parcelas:

• Como em 1x o pagamento é à vista, não é necessário preenchimento de juros.
• Nas demais parcelas, preencha com o valor percentual da cobrança de juros (2.99). Caso não cobre juros do comprador em alguma parcela, basta preencher os campos com o número 'zero'.
Obs: Caso não seja cobrado juros do comprador no parcelamento este juros será cobrado do lojista.
• Em juros externos deixar sempre como INATIVO;
• Clique em salvar.
O mesmo processo deve ser feito para as demais bandeiras.

21- O cartão deve aparecer com o conector PagSeguroV3 e a configuração da parcela na listagem e com a marcação ‘’Ativa’’:

22 – Conforme os passos 13 e 14, selecione o meio de pagamento Boleto Bancário para adicionar o conector:

23 – Configure o Boleto Bancário com o conector PagSeguroV3:

• Altere o status para ‘’Ativa’’;
• Crie um nome da regra para o Boleto Bancário (Exemplo: Boleto PagSeguroV3);
• Clique em salvar ;

24- O Boleto deve aparecer com o conector PagSeguroV3 e com a marcação ‘’Ativa’’:

25 – Conforme os passos 13 e 14, agora selecione o meio de pagamento instantâneo PIX adicionar o conector:

26 - Configure o PIX com o conector PagSeguroV3:

• Altere o status para ‘’Ativa’’;
• Crie um nome da regra para o PIX (Exemplo: PIX PagSeguroV3);
• Clique em salvar;

27- O PIX deve aparecer com o conector PagSeguroV3 e com a marcação ‘’Ativa’’:

🚧
IMPORTANTE: Para o funcionamento do PIX corretamente é necessário que você tenha uma chave habilitada na conta PagSeguro em questão.
Para ativar a chave na conta PagSeguro, basta se logar na conta PagSeguro e clicar em "PIX" e ativar a chave.

28- No Checkout a visualização ficará conforme a configuração realizada:

• Cartão de Crédito – Juros a partir da parcela configurada e o valor percentual cobrado;
• PIX;
• Boleto Bancário;

Agora é só aguardar cerca de 10 minutos para as transações processarem pelo conector PagSeguro. :)

29 - Para finalizar, realize uma compra de teste e verifique se a integração está correta.

Configurando giftCard na VTEX:

Por padrão VTEX, o vale-compras é considerado como uma forma de pagamento. Esse produto conta com um valor nominal que pode ser utilizado no ato da compra para abater parte do valor de um pedido.

Para criar um novo vale-compra, confira o passo a passo:

1- Acesse o Admin;
2- Clique no módulo Pagamentos;
3- Em seguida, clique em Vale-compra;
4- Do lado direito da tela, clique no botão azul Novo Vale;

5- Agora, preencha os campos apresentados na interface conforme as orientações abaixo:

• Vale: esse é o ID do vale. É o nome que será exibido no SmartCheckout para vales que não são associados a um CPF ou CNPJ exclusivo;
• Valor: valor nominal que será concedido para o uso do vale;
• Data de Validade: trata-se da data de vigência da utilização do vale;
• CPF/CNPJ Cliente: dado que identifica e define o vale para um específico cliente;
• Coleção: determina a coleção de produtos que define os itens em que o vale poderá ser aplicado.

🚧
Atenção: o preenchimento dos campos “Valor” e “Data de Validade” é obrigatório. Caso o contrário, o vale-compra não será salvo.

6- Depois de preencher os campos corretamente, o usuário poderá assinalar até três opções de configuração:

• Restrito: somente o cliente referente ao CPF ou CNPJ informado acima poderá utilizar este vale;
• Recarregável: enquanto esse vale estiver disponível, seu saldo poderá ser alterado;
• Reutilizável: será possível realizar novas compras com este vale até que seu valor seja totalmente utilizado.

Por fim, clique no botão Salvar.

Não há limite para a criação de vales, porém apenas 8000 vales podem ser exportados por vez.

Como configurar o Vale-compra como meio de pagamento:

Perfeito! Agora que o seu vale-compra foi criado, é preciso configurá-lo como meio de pagamento. Isso fará com que o Gift Card seja exibido no Checkout e, assim, seus clientes poderão finalizar pedidos usando o crédito do vale.

Acompanhe as instruções:

1- Acesse o Admin
2- Clique no módulo Pagamentos
3- Clique em Configurações

4- Em seguida, certifique-se que você está na aba Condições de pagamento:

5- Clique no botão verde “+”;

6- Na seção “Outro”, clique no botão “Vale”;

7- No topo da página, crie um nome da regra para essa condição de pagamento:

8- Clique no botão Status para ativar o vale-compra;
9- Em seguida, selecione uma afiliação para associar ao vale-compra;
10- Caso utilize um Antifraude de terceiro é necessário selecionar o campo ‘’Usar Antifraude’’ e escolher a opção.
11- Clique no botão Salvar.