Na VTEX, é possível realizar a integração com o provedor de pagamento StripeV2. Por meio deste provedor, sua loja pode oferecer diversos meios de pagamento, como Visa, American Express, Diners, Elo, Hipercard, Mastercard, BankInvoice, Stripe, Google Pay, ApplePay, OXXO, Discover, Affirm, Klarna, ZIP, Blik, Ideal, SPEI, MultiBanco, Afterpay, Bancontact, EPS, FPX, giropay e P24.

Para mais informações sobre a integração da VTEX com a Stripe, você também pode acessar a documentação da Vinneren.

O provedor StripeV2 pode processar transações de pagamentos em lojas VTEX de duas maneiras diferentes:

• VTEX Native Checkout Experience: pode ser utilizado para cartões de crédito, débito e meios de pagamento desenvolvidos com o Payment Provider Framework (PPF). Essa opção é recomendado se você deseja configurar outros gateways de pagamento para diferentes bandeiras de cartão ou realizar transações utilizando o checkout nativo da VTEX.

• VTEX with Stripe Payment Element Experience: aplicativo de pagamento baseado no Stripe’s Optimized Checkout Suite (OCS). Essa opção é recomendada caso você pretenda usar exclusivamente o Stripe para processar todas as bandeiras de cartões ou se deseje ter acesso ao Stripe Link, uma solução que oferece acesso rápido a diversos meios de pagamento com apenas um clique.

O VTEX with Stripe Payment Element Experience utiliza o Stripe Payment Elements Checkout, proporcionando acesso aos meios de pagamento atuais e futuros suportados pela Stripe. Nessa opção, a configuração dos meios de pagamento deve ser realizada diretamente no Stripe Dashboard.

Para informações sobre a lista completa de meios de pagamento operados por cada um dos modos de operação da StripeV2, entre em contato com os times de suporte da Vinneren ou Stripe.

Após determinar com qual dos modos deseja operar em sua loja, siga as instruções de um dos procedimentos abaixo:

• Configurando o VTEX Native Checkout Experience
• Configurando o VTEX with Stripe Payment Element Experience

As configurações realizadas em um ambiente externo à VTEX podem ser descontinuadas ou modificadas sem aviso prévio. Consulte sua conta na Stripe para informações atualizadas.

A equipe da Stripe precisa habilitar pagamentos RawPan em sua conta. Entre em contato com seu Stripe advisor. Se esta opção não estiver habilitada em sua conta, você não poderá fazer transações com sucesso.

Pré-requisitos:

• Usuário VTEX com permissões de administrador
• Conta Stripe ativa

Para utilizar o VTEX Native Checkout Experience em sua loja, é necessário:

• Instalar os aplicativos da Stripe
• Configurar StripeV2 na VTEX
• Configurar condições de pagamento

Para instalar os apps da Stripe em sua loja, siga os passos abaixo:

Para configurar a integração da StripeV2 na VTEX, siga os passos abaixo:

1. No Admin VTEX, acesse Configurações da loja > Pagamentos > Provedores, ou digite Provedores na barra de busca no topo da página.
2. Na tela de provedores, clique no botão Novo provedor.
3. Digite o nome StripeV2 na barra de busca e clique sobre o nome do provedor.
4. Em Chave de aplicação, insira a chave publicável que você obteve nos passos anteriores.
5. Em Token de aplicação, insira a chave secreta que você obteve nos passos anteriores.
6. Em Informações básicas, na opção Nome, insira StripeV2NativeCheckout para identificar o tipo da integração.
7. Em Campos do provedor, na opção Mode, selecione Float.
8. Em Test Mode, selecione False se o modo for Live ou True se o modo for Test.
9. Clique em Salvar.

Para configurar o script de antifraude para a StripeV2 na VTEX, siga os passos abaixo:

1. Copie o script disponível na seção "Integrate script into your VTEX store".
2. No Admin VTEX, acesse Configurações da loja > Storefront > Checkout > Código.
3. Clique no botão Novo e insira um nome descritivo.
4. Cole o conteúdo do script que você copiou anteriormente.
5. Substitua as informações "pk_test" pela sua chave pública Stripe copiada nas etapas anteriores.
6. Clique em Salvar.

Para configurar uma condição de pagamento para o StripeV2 na VTEX, siga os passos abaixo:

1. No Admin VTEX, acesse Configurações da loja > Pagamentos > Configurações, ou digite Configurações na barra de busca no topo da página.
2. Na aba Condições de Pagamentos, clique no botão +.
3. Clique sobre o novo do meio de pagamento que deseje utilizar.
4. Na tela de configuração, ative a condição clicando em Status.
5. Em Processar com o provedor, selecione a opção StripeV2NativeCheckout.
6. Se desejar utilizar um sistema antifraude, selecione a opção Usar solução antifraude.
7. Caso necessário, você também pode configurar condições especiais de pagamento.
8. Clique em Salvar.

Caso deseje mais informações sobre os procedimentos de instalação do VTEX Native Checkout Experience, acesse a documentação pública da Stripe na Vinneren.

Pré-requisitos:

• Usuário VTEX com permissões de administrador
• Conta Stripe ativa

Para utilizar o VTEX with Stripe Payment Element Experience em sua loja, é necessário:

• Instalar os aplicativos da Stripe
• Configurar StripeV2 na VTEX
• Configurar condições de pagamento
• Configurar webhook na conta Stripe

Para instalar os apps da Stripe em sua loja, siga os passos abaixo:

Para configurar a integração da StripeV2 na VTEX, siga os passos abaixo:

1. No Admin VTEX, acesse Configurações da loja > Pagamentos > Provedores, ou digite Provedores na barra de busca no topo da página.
2. Na tela de provedores, clique no botão Novo provedor.
3. Digite o nome StripeV2 na barra de busca e clique sobre o nome do provedor.
4. Em Chave de aplicação, insira a chave publicável que você obteve no VTEX Elements Checkout (Stripe App).
5. Em Token de aplicação, insira a chave RAK que você obteve no VTEX Elements Checkout (Stripe App) (restricted API key).
6. Em Informações básicas, na opção Nome, insira StripeV2Elements para identificar rapidamente a integração.
7. Em Campos do provedor, na opção Mode, selecione Embedded.
8. Em Test Mode, selecione False se o modo for Live ou True se o modo for Test.
9. Clique em Salvar.
10. Adicione chaves Stripe nas configurações do aplicativo do provedor, como segue:

Para configurar uma condição de pagamento para o StripeV2 na VTEX, siga os passos abaixo:

1. No Admin VTEX, acesse Configurações da loja > Pagamentos > Configurações, ou digite Configurações na barra de busca no topo da página.
2. Na aba Condições de Pagamentos, clique no botão +.
3. Clique sobre o novo do meio de pagamento que deseje utilizar.
4. Na tela de configuração, ative a condição clicando em Status.
5. Em Processar com o provedor, selecione a opção StripeV2Elements.
6. Se desejar utilizar um sistema antifraude, selecione a opção Usar solução antifraude.
7. Caso necessário, você também pode configurar condições especiais de pagamento.
8. Clique em Salvar.

Caso deseje mais informações sobre os procedimentos de instalação do VTEX with Stripe Payment Element Experience, acesse a documentação pública da Stripe na Vinneren.

Para realizar a configuração do webhook na sua conta Stripe, siga os passos abaixo:

1. Acesse o dashboard de sua conta na Stripe.
2. Clique no botão Developers.
3. Clique na aba Webhooks.
4. Clique no botão Add a connection point.
5. No campo Connection point URL, insira o URL do endpoint da sua loja VTEX no seguinte formato: https://{{account}}.myvtex.com/_v/stripe.payment-provider-connector/v0/webhook. Substitua o {{account}} pelo nome da sua conta VTEX.
6. Clique em + Select events.
7. Clique nas categorias e selecione os seguintes eventos:

8. Clique em Add events.
9. Clique em Add Connection Point.

Com o provedor StripeV2 você pode processar pagamentos com a Google Pay em sua loja. Para configurar o Google Pay, siga os passos abaixo:

1. Caso já tenha concluido os passos de instalação do VTEX Elements, prossiga para o Passo 13.
2. Instale o VTEX Elements Checkout (Stripe App) para obter as chaves Stripe necessárias.
3. Assim que a instalação for concluída, as chaves pública (pk) e restrita (rk) serão exibidas. Copie e salve-os, pois serão usados posteriormente.
4. No Admin VTEX, acesse Configurações da Loja > Pagamentos > Provedores, ou digite Provedores na barra de pesquisa no topo da página.
5. Na página do provedor, clique no botão Novo Provedor.
6. Digite StripeV2 na barra de pesquisa e clique no nome do provedor.
7. Em App key, insira a chave publicável que você obteve no VTEX Elements Checkout (Stripe App).
8. Em App token, insira a chave RAK obtida no VTEX Elements Checkout (Stripe App)(chave API restrita).
9. Em Informações básicas, na opção Nome, insira StripeV2Elements para identificar rapidamente a integração.
10. Em Campos do provedor, na opção Mode, selecione Embedded.
11. Em Test Mode, selecione False se o modo for Live ou True se o modo for Test.
12. Clique em Salvar.
13. No Admin VTEX, acesse Configurações da loja > Pagamentos > Configurações, ou digite Configurações na barra de busca no topo da página.
14. Na aba Condições de Pagamentos, clique no botão +.
15. Clique sobre a opção Google Pay.
16. Na tela de configuração, ative a condição clicando em Status.
17. Em Processar com o provedor, selecione a opção StripeV2.
18. Clique em Salvar.

Depois de concluir essas etapas, o Google Pay aparecerá na finalização da compra da loja como um dos métodos de pagamento disponíveis.

Com o provedor StripeV2 você pode processar pagamentos com a Apple Pay em sua loja. Para configurar o Apple Pay, siga os passos abaixo:

1. Caso já tenha concluido os passos de instalação do VTEX Elements, prossiga para o Passo 13.
2. Instale o VTEX Elements Checkout (Stripe App) para obter as chaves Stripe necessárias.
3. Assim que a instalação for concluída, as chaves pública (pk) e restrita (rk) serão exibidas. Copie e salve-os, pois serão usados posteriormente.
4. No Admin VTEX, acesse Configurações da Loja > Pagamentos > Provedores, ou digite Provedores na barra de pesquisa no topo da página.
5. Na página do provedor, clique no botão Novo Provedor.
6. Digite StripeV2 na barra de pesquisa e clique no nome do provedor.
7. Em App key, insira a chave publicável que você obteve no VTEX Elements Checkout (Stripe App).
8. Em App token, insira a chave RAK obtida no VTEX Elements Checkout (Stripe App)(chave API restrita).
9. Em Informações básicas, na opção Nome, insira StripeV2Elements para identificar rapidamente a integração.
10. Em Campos do provedor, na opção Mode, selecione Embedded.
11. Em Test Mode, selecione False se o modo for Live ou True se o modo for Test.
12. Clique em Salvar.
13. Acesse o dashboard de sua conta na Stripe na seção de configurações de pagamento.
14. Em Settings, clique em Payment Methods.
15. Clique em Apple Pay > Set Up.
16. Clique em Add to New Domain.
17. Insira o domínio público do site de sua loja.
18. Clique em Add.
19. Execute as ações descritas na documentação da Stripe e depois clique em Download the domain association file.
20. Após obter o arquivo, salve a informação e acesse a seguinte URL https://{{account}}.myvtex.com/_v/stripe.paid-provider/v0/registerApplePay. Substitua o {{account}} pelo nome da sua conta VTEX.
21. Insira no campo Enter your Apple App Key a informação salva anteriormente.
22. Clique em Salvar.
23. No Admin VTEX, acesse Configurações da loja > Pagamentos > Configurações, ou digite Configurações na barra de busca no topo da página.
24. Na aba Condições de Pagamentos, clique no botão +.
25. Clique em Apple Pay.
26. Na tela de configuração, ative a condição clicando em Status.
27. Em Processar com o provedor, selecione a opção StripeV2.
28. Se desejar utilizar um sistema antifraude, selecione a opção Usar solução antifraude.
29. Indique se deseja processar pagamentos com ou sem parcelamentos.
30. Caso necessário, você também pode configurar condições especiais de pagamento.
31. Clique em Salvar.

Depois de concluir essas etapas, o Apple Pay aparecerá na finalização da compra da loja como um dos métodos de pagamento disponíveis.

A condição de pagamento parcelada sem juros (MSI - Meses Sin Intereses) é disponível na Stripe somente para contas baseadas no México.

O MSI pode ser configurado tanto o modo de operação VTEX Native Checkout experience quanto para o VTEX with Stripe Payment Element Experience. Veja abaixo os passos necessários para configurá-lo de acordo com o tipo de modo de operação adotado em sua loja:

1. Crie uma conta Stripe no México configurada com a moeda MXN.
2. No Admin VTEX, acesse Configurações da loja > Pagamentos > Configurações, ou digite Configurações na barra de busca no topo da página.
3. Clique em um dos meios de pagamento disponíveis que processam pagamentos com MSI (cartões VISA, AMEX e Mastercard).
4. Configure as condições MSI da forma desejada na tela do meio de pagamento.
5. Configure as condições MSI no seu dashboard da Stripe com as mesmas informações utilizadas na configuração da VTEX (Passo 4.).

Caso as informações cadastradas nos Passos 4 e 5 sejam diferentes, a condição de MSI pode não funcionar corretamente.

1. Crie uma conta Stripe no México configurada com a moeda MXN.
2. Configure as condições de MSI no seu dashboard da Stripe.
3. Entre em contato com o seu Stripe executive ou time de Stripe support para solicitar que esta condição de pagamento seja acionada em sua loja.