VTEX

A VTEX é uma plataforma de comércio digital que permite criar rapidamente uma loja online com recursos prontos para uso. Para obter mais informações, consulte o site oficial da VTEX.

Pré-requisitos

• Você precisa de uma conta PayU Latam ativa.
• Você precisa de uma conta ativa do PaymentsOS. Se você não tiver uma conta, clique aqui para criar uma.
  Todos os comerciantes que precisam integrar o PayU com a VTEX devem ter uma conta PaymentsOS no modo produtivo/live.
• Você precisa de uma conta VTEX com direitos e permissões suficientes para acessar o painel administrativo da VTEX. Esta conta deve ter a autenticação de dois fatores habilitada.

Procedimento de configuração

O procedimento para habilitar os meios de pagamento que processamos em nossa plataforma na VTEX é dividido em duas etapas. Antes de continuar, certifique-se de atender aos pré-requisitos acima.

1. Configure sua conta do PaymentsOS

A integração da PayU Latam com a VTEX é feita utilizando PaymentsOS como middleware. Como primeiro passo, você precisa configurar os seguintes objetos em sua conta do PaymentsOS.

• Uma configuração de provedor.
• Uma Unidade de Negócios.
• Um WebHook.

Você pode configurar esses objetos usando uma das seguintes opções:

• Configurar conta usando o Postman.
• Configure a conta manualmente usando o Painel de controle do PaymentsOS.

Configurar conta usando o Postman

Siga estas etapas para configurar sua conta usando o Postman.

1. Clique no botão abaixo para importar nossa coleção para o Postman (pode ser necessário atualizar a página se o botão não funcionar).

2. Depois de executar a coleção, você precisa definir os globais. Baixe o arquivo global aqui.

3. Na coleção Postman, clique em Import ao lado do nome da área de trabalho e localize o arquivo json baixado anteriormente.

4. Ao terminar, clique em Import.

5. É obrigatório executar os métodos de coleta na ordem apresentada. Primeiro, clique no método POST chamado 1. Login e abra a guia Body.

6. Digite o e-mail (email) e a senha (password) da sua conta do PaymentsOS. Em seguida, clique em Send.

7. Se o login for bem-sucedido, os dados de autenticação são atribuídos no segundo método.
   Clique no método GET chamado 2. Retrieve PayU Latam ID.

8. No canto superior direito, clique no ícone de olho e localize o parâmetro env. Em seguida, clique no ícone de lápis e digite test se estiver processando no ambiente de teste, ou live caso contrário.

9. Uma vez configurado, clique em Send.

10. Clique no método POST chamado 3. Create Provider Configuration, este método cria o Configuração de Provedor no PaymentsOS. Em seguida, vá para a guia Body.

Insira as seguintes informações:

11. Clique no método POST chamado 4. Create Business Unit, este método cria a Unidade de Negócios no PaymentsOS. Em seguida, vá para a guia Body.

Insira as seguintes informações:

12. Clique no método POST chamado 5. Create Webhook, este método cria o WebHook no PaymentsOS. Este WebHook é a URL de confirmação que receberá as notificações enviadas pela VTEX quando uma transação mudar de estado.
    A seguir, vá para a guia Body.

Defina o parâmetro endpoint com os seguintes valores de acordo com seu ambiente.

• Teste: https://sandbox.api.payulatam.com/vtex-payments-integration/paymentsos/webhook
• Produção: https://api.payulatam.com/vtex-payments-integration/paymentsos/webhook

Deixe os outros valores com seu valor padrão.

Neste ponto, você configurou sua conta do PaymentsOS como middleware, o próximo passo é a configuração do provedor VTEX.

Configure a conta manualmente usando o Painel de controle do PaymentsOS

Siga estas etapas para configurar sua conta usando o painel de controle do PaymentsOS.

1. Crie a Configuração de Provedor.
   No painel de controle do PaymentsOS, expanda o menu Configuração e selecione Provedores de Pagamento.

Use o campo Buscar na seção Criar uma nova configuração de Provedor e digite PayU para encontrar o provedor PayU Latam.

Insira as seguintes informações para a Configuração de Provedor:

Quando terminar, clique em Salvar.

2. Crie a Unidade de Negócios.
   No painel do PaymentsOS, expanda o menu Configuração e selecione Unidades de Negócios.

Clique no botão Criar uma Unidade de Negócios e insira as seguintes informações:

Na seção Escolha um Provedor padrão para esta Unidade de Negócios, escolha a Configuração do Provedor criada na etapa anterior.
Ao terminar, clique em Salvar.

3. Crie o webhook. Este WebHook é a URL de confirmação que receberá as notificações enviadas pela VTEX quando uma transação mudar de status.
   

De volta ao painel do PaymentsOS, expanda o menu Configuração e selecione Webhooks.

Clique no botão Criar Endpoint para Webhook e insira a URL de acordo com seu ambiente:

• Teste: https://sandbox.api.payulatam.com/vtex-payments-integration/paymentsos/webhook
• Produção: https://api.payulatam.com/vtex-payments-integration/paymentsos/webhook

Na tabela Payment Events Alert, acione o evento Update para Authorization e Charge. Além disso, selecione no combo Unidades de Negócios Associadas a Unidade de Negócios criada na etapa anterior.
Ao terminar, clique em Criar.

Neste ponto, você configurou sua conta do PaymentsOS como middleware, o próximo passo é a Configuração do provedor VTEX.

2. Configuração do provedor VTEX

Depois de configurar sua conta PaymentsOS, o próximo passo é a configuração do provedor VTEX para cada forma de pagamento. Para esta etapa, é obrigatório que você tenha um usuário válido para acessar o VTEX admin.

Configurar la afiliación de Gateway

Antes de configurar a Afiliação de Gateway, certifique-se de ter configurado o FingerPrint para PayU. Para isso, veja este artigo.

1. No VTEX admin, expanda o menu Pagamentos dentro do grupo Transações. Em seguida, selecione Configurações.

2. Antes de configurar as Condições de pagamento, você deve criar um novo provedor. No painel esquerdo, selecione Configurações da Loja > Provedores > Novo provedor:

3. Localize PayU e selecione PayUv2:

4. Nas configurações do conector, você precisa instalá-lo clicando no botão Instalar app. Em seguida, insira as seguintes informações.

Quando terminar, clique em Salvar.

Configurar métodos de pagamento

Defina os métodos de pagamento a serem exibidos no site para pagamento. Veja nossos métodos de pagamento disponíveis.

Configurar cartões de débito ou crédito

De acordo com seu país de processamento, você pode configurar a afiliação que criou para usar cartões de crédito ou débito^* . Siga estas instruções para adicionar esta forma de pagamento à sua loja VTEX.

^* O uso de cartões de débito depende do seu país de processamento.

1. Na opção Configuração (Transações > Pagamentos > Configurações), selecione a guia Condições de pagamento e clique no ícone de adição.

2. Selecione o método de pagamento que deseja incluir. Os métodos de pagamento são agrupados por tipo.
   Para nosso exemplo, selecionamos American Express na seção Cartão de crédito.

3. Insira as seguintes informações.

• Nome da Regra (para fácil identificação): insira um nome significativo para a condição de pagamento ao lado do método de pagamento selecionada.
• Status: selecione o status da condição de pagamento. Você só pode ter uma condição de pagamento ativa por método de pagamento.
• Processar com a afiliação: selecione a afiliação do gateway configurada anteriormente.
• À vista ou parcelado?: selecione À vista^*.

4. Clique em Salvar. Quando você cria a condição de pagamento, ela é listada na guia Condições de pagamento.

Configurar cartões co-branded ou bandeira própria

Os cartões co-branded ou bandeira própria são cartões emitidos por uma loja ou marca em associação com uma rede como AMEX, VISA, MasterCard, etc. Siga estas instruções para adicionar esta forma de pagamento à sua loja VTEX.

1. Na opção Configuração (Transações > Pagamentos > Configurações), selecione a guia Pagamentos customizados.

2. Nesta guia, você tem cinco (5) slots disponíveis para configurar cartões co-branded e bandeira própria. Neste exemplo, vamos configurar o cartão Colombian Codensa que é um cartão bandeira própria.
   Clique em qualquer uma das caixas disponíveis na seção CCartões da Loja (Bandeira Própria).

3. Insira as seguintes informações usando as letras maiúsculas e minúsculas mostradas.

• Nome: Codensa.
• Descrição: Codensa
• Faixas de Bin: 590712-590712
• Código de pagamento do adquirente: codensa

Os valores restantes podem ser deixados como padrão. Use os seguintes valores para configurar cartões de marca compartilhada e de marca privada.

País	Nome	Descrição	Faixas de Bin	Código de pagamento do adquirente
	Argencard	Argencard	501105-532362	argencard
	Cabal	Cabal	60423,60400,589657	cabal
	Cencosud	Cencosud	603493-603493	cencosud
	Naranja	Naranja	589562	naranja
	Shopping	Shopping	603488	shopping
	Codensa	Codensa	590712-590712	codensa

Para mais informações sobre como configurar co-branded e bandeira própria, consulte a central de ajuda da VTEX.

4. Clique em Salvar. Assim que o pagamento customizado for criado, você será redirecionado para a opção de criar um novo Condições de pagamento. Esta condição de pagamento é criada conforme explicado na seção Configurar cartões de crédito ou débito.

Configurar métodos de pagamento em dinheiro

Como as formas de pagamento à vista exigem que o cliente pague em escritórios físicos, você pode configurar essa forma de pagamento na VTEX como Notas Promissórias.

Ao configurar uma forma de pagamento em dinheiro, seus clientes são redirecionados para o checkout PayU para baixar o comprovante de pagamento e pagar no respectivo escritório físico. Siga as instruções abaixo para adicionar esta forma de pagamento à sua loja VTEX.

1. Na opção Configuração (Transações > Pagamentos > Configurações), selecione a guia Pagamentos customizados.

2. Nesta guia, você tem cinco (5) slots disponíveis para configurar pagamentos em dinheiro. Neste exemplo, vamos configurar o OXXO, um método mexicano de pagamento em dinheiro.
   Clique em qualquer uma das caixas disponíveis na seção Promissórias.

3. Insira as seguintes informações para o método de pagamento em dinheiro.

• Nome: neste parâmetro, você precisa usar o valor mostrado aqui na coluna Parâmetro paymentMethod. Para este exemplo, definimos OXXO.
• Descrição: Insira a descrição que deseja exibir quando o cliente selecionar esta forma de pagamento. Este parâmetro é opcional.
• Validade da promissória: Informe o número de dias antes do vencimento do pagamento em dinheiro. Por padrão, esse valor é atribuído a 7 dias. Tenha em mente que, para evitar problemas de processamento, este valor deve corresponder ao valor selecionado no campo Expiración pago (días) que você configurou na afiliação VTEX.

Deixe os outros parâmetros com seus valores padrão.

4. Clique em Salvar. Assim que o pagamento customizado for criado, você será redirecionado para a opção de criar um novo Condições de pagamento. Esta condição de pagamento é criada conforme explicado na seção Configurar cartões de crédito ou débito.

Configure o PSE

Pré-requisitos:

• Este método de pagamento se aplica apenas a comerciantes que processam transações na Colômbia.
• Para oferecer o PSE como método de pagamento, primeiro certifique-se de instalar o aplicativo PSE desenvolvido pela VTEX. Se ainda não o fez, vá para Definições de conta > Aplicações > App Store e procure por Banks for PSE.
  Caso não encontre o aplicativo na loja, você pode solicitar sua instalação à equipe da VTEX por meio de um chamado no Suporte VTEX.
• No caso de você ter uma integração legada da VTEX, observe que a VTEX deve realizar uma configuração adicional para que você possa configurar o método de pagamento. Entre em contato com seu agente VTEX ou solicite ajuda por meio do Suporte VTEX.

1. Para configurar o PSE, acesse o painel de administração da sua plataforma VTEX e vá para Configurações da Loja > Pagamentos > Configurações > Condições de pagamento. Em seguida, siga estas etapas:

• Clique no botão +.
• Na categoria Outros, localize o PSE.
• Preencha os campos exibidos na tela:
  • Insira um nome descritivo para a regra para identificar este método de pagamento.
  • Escolha a afiliação configurada para processar pagamentos com PayUV2 no menu suspenso Process with affiliation.
  • Ative a condição de pagamento no campo Status.
  • Clique em Salvar para aplicar as configurações.

2. Configure o aplicativo Banks for PSE com suas credenciais PayU. Para isso, siga estas etapas:

• Inicie sessão no painel de administração da sua plataforma VTEX e acesse Aplicações > Aplicações instaladas > Banks for PSE.
• Preencha o formulário e clique em Salvar.

• Depois de concluir a configuração, você pode realizar transações em um ambiente produtivo com o PSE.

Teste a integração

Depois de configurar as Condições de pagamento para seus métodos de pagamento, é recomendável testar a integração antes de começar a receber transações reais.

Pré-requisitos para testes bem-sucedidos:

• Verifique se sua conta PaymentsOS está no modo TEST.
• Verifique se o Seletor de Ambiente em sua Afiliação do Gateway VTEX está no modo TEST.
• Certifique-se de usar as credenciais apropriadas para o ambiente de teste ao configurar a Afiliação do Gateway VTEX. Lembre-se de que você pode encontrar as credenciais de teste aqui.
• Lembre-se de que, uma vez concluídos os seus testes, você deve modificar os pontos acima com as informações de produção (conta PaymentsOS, seletor de ambiente na afiliação VTEX e credenciais configuradas na afiliação VTEX).

1. No VTEX admin, clique em VISIT A LOJA no painel superior.

2. A loja configurada para sua conta VTEX é aberta. Selecione qualquer produto e clique em comprar.

3. No carrinho de compras, clique no botão fechar pedido.

4. Na seção de pagamento, aparecem os meios de pagamento agrupados por tipo. Selecione aquele que você deseja testar e insira os dados do teste. Encontre aqui alguns números de cartões de teste e informações para testar os status.
   Finalmente, clique em Finalizar .

Assim que a compra for aprovada, você poderá verificá-la em:

• VTEX admin: Pagamentos > Transações.

• Painel de controle de PaymentsOS: Pagamentos > Buscar.
  
  
  O parâmetro ID de Transação Externa dentro de Atividade de Transação é o OrderID da PayU.

• Módulo PayU: no Relatório de Vendas.

• Query API usando o parâmetro ID de Transação Externa como OrderID.

Probar flujos de dos pasos

Quando você configura sua Afiliação do Gatewa para processar transações em fluxos de duas etapas, os fundos autorizados do cartão de crédito não são capturados até que você solicite explicitamente a captura. Para solicitar a captura, você precisa faturar o pedido.

Para faturar um pedido, localize a transação no VTEX Admin (Pagamentos > Transações) e clique sobre ela. Em seguida, clique no botão Pedido no canto superior direito.

Role para baixo até a seção Pacote e clique em Faturar pacote.

Forneça as informações da sua fatura e clique em Enviar Nota na parte inferior do painel. Após o envio da fatura ao cliente, o valor autorizado é debitado no cartão do cliente.