Tudo o que você precisa em serviços de pagamentos

Aqui você encontra as documentações necessárias para integrar com as APIs, Bibliotecas e Módulos do PagSeguro.

Descubra tudo que a nossa plataforma pode te proporcionar!

Get Started    API Reference

Ativando conector PagSeguro V3 - VTEX

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;
· 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 (apenas cartão de crédito e boleto);
· Notificação/Consulta.

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:

7- Na listagem de afiliações, selecione a afiliação PagseguroV3 recém-criada:

8- Clique em Autorizar:

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

10- Autorize a aplicação:

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

12- 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.

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

14- Selecione o meio de pagamento desejado:

15- 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.

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

17- 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';

18- 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.

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

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

21 – 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 ;

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

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

24 - 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;

25- 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.

26- 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. :)

27- 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.

Updated 3 months ago


Ativando conector PagSeguro V3 - VTEX


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.