{"section":"tutorials","requestedLocale":"pt","requestedSlug":"configurar-pagamento-com-stripev2","locale":"pt","slug":"configurar-pagamento-com-stripev2","path":"docs/pt/tutorials/pagamentos/configurações-de-pagamentos/configurar-pagamento-com-stripev2.md","branch":"main","content":"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.\n\nPara mais informações sobre a integração da VTEX com a Stripe, você também pode acessar a [documentação da Vinneren](https://sites.google.com/vinneren.com.mx/documentacion-publica/documentacion-publica).\n\n## Modos de operação\n\nO provedor StripeV2 pode processar transações de pagamentos em lojas VTEX de duas maneiras diferentes:\n\n- **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)](https://developers.vtex.com/docs/guides/payments-integration-payment-provider-framework). 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.\n\n- **VTEX with Stripe Payment Element Experience**: aplicativo de pagamento baseado no [Stripe’s Optimized Checkout Suite (OCS)](https://support.stripe.com/questions/what-is-stripe-s-optimized-checkout-suite-(ocs)?locale=en-US). 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](https://stripe.com/payments/link), uma solução que oferece acesso rápido a diversos meios de pagamento com apenas um clique.\n\n> ℹ️ O **VTEX with Stripe Payment Element Experience** utiliza o [Stripe Payment Elements Checkout](https://docs.stripe.com/payments/elements), 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](https://dashboard.stripe.com/settings/payment_methods).\n\n> ℹ️ 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](stripe-support@vinneren.com.mx) ou [Stripe](https://support.stripe.com/contact/login).\n\nApós determinar com qual dos modos deseja operar em sua loja, siga as instruções de um dos procedimentos abaixo:\n\n- [Configurando o VTEX Native Checkout Experience](#configurar-o-vtex-native-checkout-experience)\n- [Configurando o VTEX with Stripe Payment Element Experience](#configurar-o-vtex-with-stripe-payment-element-experience)\n\n> ⚠️ 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.\n\n## Configurar o VTEX Native Checkout Experience\n\n> ⚠️ A equipe da Stripe precisa habilitar pagamentos RawPan em sua conta. Entre em contato com seu [Stripe advisor](https://support.stripe.com/?contact=true). Se esta opção não estiver habilitada em sua conta, você não poderá fazer transações com sucesso.\n\nPré-requisitos:\n- Usuário VTEX com permissões de administrador\n- Conta Stripe ativa\n\nPara utilizar o __VTEX Native Checkout Experience__ em sua loja, é necessário:\n\n- [Instalar os aplicativos da Stripe](#instalar-apps-da-stripe)\n- [Configurar StripeV2 na VTEX](#configurar-stripev2-na-vtex)\n- [Configurar condições de pagamento](#configurar-condicao-de-pagamento)\n\n### Instalar apps da Stripe\n\nPara instalar os apps da Stripe em sua loja, siga os passos abaixo:\n\n1. Instale o [VTEX Native Checkout (Stripe App)](https://marketplace.stripe.com/apps/vtex-native-checkout). Durante a configuração, certifique-se de inserir o nome da sua conta VTEX usando apenas letras minúsculas. Por exemplo, se o nome da sua conta for \"MyStore\", insira-o como \"mystore\".\n2. Acesse o [Stripe Dashboard](https://dashboard.stripe.com/login?redirect=%2Fapikeys), copie e salve as chaves públicas e secretas. É importante que você copie e salve as chaves do modo (test or live) em que você instalou o VTEX Native Checkout App na Stripe.\n\n> ⚠️ Antes de iniciar a instalação do app Payment Provider Framework, verifique com a equipe de suporte da [Vinneren](stripe-support@vinneren.com.mx) ou [Stripe](https://support.stripe.com/contact/login) os números das versões mais atuais do aplicativo.\n\n3. No [VTEX IO CLI](https://developers.vtex.com/docs/guides/vtex-io-documentation-vtex-io-cli-install), execute os comandos abaixo para instalar os apps da Stripe:\n\n- **Payment Provider Framework**: `vtex install stripe.stripe-payments-provider`.\n- **Payment App**: `vtex install stripe.stripe-payment-app`.\n\n### Configurar StripeV2 na VTEX\n\nPara configurar a integração da StripeV2 na VTEX, siga os passos abaixo:\n\n1. No Admin VTEX, acesse __Configurações da loja > Pagamentos > Provedores__, ou digite __Provedores__ na barra de busca no topo da página.\n2. Na tela de provedores, clique no botão `Novo provedor`.\n3. Digite o nome __StripeV2__ na barra de busca e clique sobre o nome do provedor.\n4. Em __Chave de aplicação__, insira a chave publicável que você obteve nos passos anteriores.\n5. Em __Token de aplicação__, insira a chave secreta que você obteve nos passos anteriores.\n6. Em __Informações básicas__, na opção __Nome__, insira __StripeV2NativeCheckout__ para identificar o tipo da integração.  \n7. Em __Campos do provedor__, na opção __Mode__, selecione __Float__.\n8. Em __Test Mode__, selecione __False__ se o modo for __Live__ ou __True__ se o modo for __Test__.  \n9. Clique em `Salvar`.\n\n### Configurar script de antifraude\n\nPara configurar o script de antifraude para a StripeV2 na VTEX, siga os passos abaixo:\n\n1. Copie o script disponível na seção \"[Integrate script into your VTEX store](https://sites.google.com/vinneren.com.mx/documentacion-publica/native-checkout/english)\".\n2. No Admin VTEX, acesse __Configurações da loja > Storefront > Checkout > Código__.\n3. Clique no botão __Novo__ e insira um nome descritivo.\n4. Cole o conteúdo do script que você copiou anteriormente.\n5. Substitua as informações \"pk_test\" pela sua chave pública Stripe copiada nas etapas anteriores.\n6. Clique em `Salvar`.\n\n### Configurar condição de pagamento\n\nPara configurar uma condição de pagamento para o StripeV2 na VTEX, siga os passos abaixo:\n\n1. No Admin VTEX, acesse __Configurações da loja > Pagamentos > Configurações__, ou digite __Configurações__ na barra de busca no topo da página.\n2. Na aba __Condições de Pagamentos__, clique no botão +.\n3. Clique sobre o novo do meio de pagamento que deseje utilizar.\n4. Na tela de configuração, ative a condição clicando em __Status__.\n5. Em __Processar com o provedor__, selecione a opção __StripeV2NativeCheckout__.\n6. Se desejar utilizar um sistema antifraude, selecione a opção __Usar solução antifraude__.\n7. Caso necessário, você também pode [configurar condições especiais de pagamento](/pt/docs/tutorials/condicoes-especiais).\n8. Clique em `Salvar`.\n\nCaso 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](https://sites.google.com/vinneren.com.mx/documentacion-publica#h.nmryiar6zrqq).\n\n## Configurar o VTEX with Stripe Payment Element Experience\n\nPré-requisitos:\n- Usuário VTEX com permissões de administrador\n- Conta Stripe ativa\n\nPara utilizar o __VTEX with Stripe Payment Element Experience__ em sua loja, é necessário:\n\n- [Instalar os aplicativos da Stripe](#instalar-apps-da-stripe-element-experience)\n- [Configurar StripeV2 na VTEX](#configurar-stripev2-na-vtex-element-experience)\n- [Configurar condições de pagamento](#configurar-condicao-de-pagamento-element-experience)\n- [Configurar webhook na conta Stripe](#configurar-webhook-na-conta-stripe-element-experience)\n\n### Instalar apps da Stripe (Element Experience)\n\nPara instalar os apps da Stripe em sua loja, siga os passos abaixo:\n\n1. Instale o [VTEX Elements Checkout (Stripe App)](https://marketplace.stripe.com/apps/vtex-with-stripe-payment-element) para obter as chaves Stripe necessárias.\n2. 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.\n\n> ⚠️ Antes de iniciar a instalação do app Payment Provider Framework, verifique com a equipe de suporte da [Vinneren](stripe-support@vinneren.com.mx) ou [Stripe](https://support.stripe.com/contact/login) os números das versões mais atuais do aplicativo.\n\n3. No [VTEX IO CLI](https://developers.vtex.com/docs/guides/vtex-io-documentation-vtex-io-cli-install), execute os comandos abaixo para instalar os apps da Stripe:\n\n- **Payment Provider Framework**: `vtex install stripe.stripe-payments-provider`.\n- **Payment App**: `vtex install stripe.stripe-payment-app`.\n\n### Configurar StripeV2 na VTEX (Element Experience)\n\nPara configurar a integração da StripeV2 na VTEX, siga os passos abaixo:\n\n1. No Admin VTEX, acesse __Configurações da loja > Pagamentos > Provedores__, ou digite __Provedores__ na barra de busca no topo da página.\n2. Na tela de provedores, clique no botão `Novo provedor`.\n3. Digite o nome __StripeV2__ na barra de busca e clique sobre o nome do provedor.\n4. Em __Chave de aplicação__, insira a chave publicável que você obteve no __VTEX Elements Checkout (Stripe App)__.\n5. Em __Token de aplicação__, insira a chave RAK que você obteve no __VTEX Elements Checkout (Stripe App)__ (restricted API key).\n6. Em __Informações básicas__, na opção __Nome__, insira __StripeV2Elements__ para identificar rapidamente a integração.\n7. Em __Campos do provedor__, na opção __Mode__, selecione __Embedded__.\n8. Em __Test Mode__, selecione __False__ se o modo for __Live__ ou __True__ se o modo for __Test__.\n9. Clique em `Salvar`.\n10. Adicione chaves Stripe nas configurações do aplicativo do provedor, como segue:\na. Acesse **Store Settings > Payment > Providers**.\nb. Clique em **Settings**.\nc. Em **Publishable Key**, insira sua chave começando com **pk_**.\nd. Em **Secret Key**, insira sua chave começando com **rk_**.\ne. Clique em **Save**.\n\n### Configurar condição de pagamento (Element Experience)\n\nPara configurar uma condição de pagamento para o StripeV2 na VTEX, siga os passos abaixo:\n\n1. No Admin VTEX, acesse __Configurações da loja > Pagamentos > Configurações__, ou digite __Configurações__ na barra de busca no topo da página.\n2. Na aba __Condições de Pagamentos__, clique no botão `+`.\n3. Clique sobre o novo do meio de pagamento que deseje utilizar.\n4. Na tela de configuração, ative a condição clicando em __Status__.\n5. Em __Processar com o provedor__, selecione a opção __StripeV2Elements__.\n6. Se desejar utilizar um sistema antifraude, selecione a opção __Usar solução antifraude__.\n7. Caso necessário, você também pode [configurar condições especiais de pagamento](/pt/docs/tutorials/condicoes-especiais).\n8. Clique em `Salvar`.\n\nCaso 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](https://sites.google.com/vinneren.com.mx/documentacion-publica#h.nmryiar6zrqq).\n\n### Configurar webhook na conta Stripe (Element Experience)\n\nPara realizar a configuração do webhook na sua conta Stripe, siga os passos abaixo:\n\n1. Acesse o [dashboard de sua conta na Stripe](https://dashboard.stripe.com/).\n2. Clique no botão __Developers__.\n3. Clique na aba __Webhooks__.\n4. Clique no botão __Add a connection point__.\n5. 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.\n6. Clique em __+ Select events__.\n7. Clique nas categorias e selecione os seguintes eventos:\n- **payment_intent.payment_failed**\n- **payment_method.canceled**\n- **payment_intent.succeeded**\n- **payment_method.attached**\n\n8. Clique em __Add events__.\n9. Clique em __Add Connection Point__.\n\n## Configurar pagamento com Google Pay na StriveV2 (opcional)\n\nCom o provedor StripeV2 você pode processar pagamentos com a Google Pay em sua loja. Para configurar o Google Pay, siga os passos abaixo:\n\n1. Caso já tenha concluido os passos de instalação do [VTEX Elements](#configurar-o-vtex-with-stripe-payment-element-experience), prossiga para o Passo 13.\n2. Instale o [VTEX Elements Checkout (Stripe App)](https://marketplace.stripe.com/apps/vtex-with-stripe-payment-element) para obter as chaves Stripe necessárias.\n3. 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.\n4. No Admin VTEX, acesse __Configurações da Loja > Pagamentos > Provedores__, ou digite __Provedores__ na barra de pesquisa no topo da página.\n5. Na página do provedor, clique no botão `Novo Provedor`.\n6. Digite __StripeV2__ na barra de pesquisa e clique no nome do provedor.\n7. Em __App key__, insira a chave publicável que você obteve no __VTEX Elements Checkout (Stripe App)__.\n8. Em __App token__, insira a chave RAK obtida no __VTEX Elements Checkout (Stripe App)__(chave API restrita).\n9. Em __Informações básicas__, na opção __Nome__, insira __StripeV2Elements__ para identificar rapidamente a integração.  \n10. Em __Campos do provedor__, na opção __Mode__, selecione __Embedded__.\n11. Em __Test Mode__, selecione __False__ se o modo for __Live__ ou __True__ se o modo for __Test__.\n12. Clique em `Salvar`.\n13.  No Admin VTEX, acesse __Configurações da loja > Pagamentos > Configurações__, ou digite __Configurações__ na barra de busca no topo da página.\n14. Na aba __Condições de Pagamentos__, clique no botão `+`.\n15. Clique sobre a opção __Google Pay__.\n16. Na tela de configuração, ative a condição clicando em __Status__.\n17. Em Processar com o provedor, selecione a opção __StripeV2__.\n18. Clique em `Salvar`.\n\nDepois de concluir essas etapas, o Google Pay aparecerá na finalização da compra da loja como um dos métodos de pagamento disponíveis.\n\n## Configurar pagamento com Apple Pay na StriveV2 (opcional)\n\nCom o provedor StripeV2 você pode processar pagamentos com a Apple Pay em sua loja. Para configurar o Apple Pay, siga os passos abaixo:\n\n1. Caso já tenha concluido os passos de instalação do [VTEX Elements](#configurar-o-vtex-with-stripe-payment-element-experience), prossiga para o Passo 13.\n2. Instale o [VTEX Elements Checkout (Stripe App)](https://marketplace.stripe.com/apps/vtex-with-stripe-payment-element) para obter as chaves Stripe necessárias.\n3. 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.\n4. No Admin VTEX, acesse __Configurações da Loja > Pagamentos > Provedores__, ou digite __Provedores__ na barra de pesquisa no topo da página.\n5. Na página do provedor, clique no botão `Novo Provedor`.\n6. Digite __StripeV2__ na barra de pesquisa e clique no nome do provedor.\n7. Em __App key__, insira a chave publicável que você obteve no __VTEX Elements Checkout (Stripe App)__.\n8. Em __App token__, insira a chave RAK obtida no __VTEX Elements Checkout (Stripe App)__(chave API restrita).\n9. Em __Informações básicas__, na opção __Nome__, insira __StripeV2Elements__ para identificar rapidamente a integração.  \n10. Em __Campos do provedor__, na opção __Mode__, selecione __Embedded__.\n11. Em __Test Mode__, selecione __False__ se o modo for __Live__ ou __True__ se o modo for __Test__.\n12. Clique em `Salvar`.\n13. Acesse o [dashboard de sua conta na Stripe](https://dashboard.stripe.com/) na seção de configurações de pagamento.\n14. Em __Settings__, clique em __Payment Methods__.\n15. Clique em __Apple Pay > Set Up__.\n16. Clique em __Add to New Domain__.\n17. Insira o domínio público do site de sua loja.\n18. Clique em __Add__.\n19. Execute as ações descritas na [documentação da Stripe](https://docs.stripe.com/payments/payment-methods/pmd-registration?dashboard-or-api=dashboard#verify-domain-with-apple) e depois clique em __Download the domain association file__.\n20. 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.\n21. Insira no campo __Enter your Apple App Key__ a informação salva anteriormente.\n22. Clique em `Salvar`.\n23. No Admin VTEX, acesse __Configurações da loja > Pagamentos > Configurações__, ou digite __Configurações__ na barra de busca no topo da página.\n24. Na aba __Condições de Pagamentos__, clique no botão `+`.\n25. Clique em __Apple Pay__.\n26. Na tela de configuração, ative a condição clicando em __Status__.\n27. Em __Processar com o provedor__, selecione a opção __StripeV2__.\n28. Se desejar utilizar um sistema antifraude, selecione a opção __Usar solução antifraude__.\n29. Indique se deseja processar pagamentos com ou sem parcelamentos.\n30. Caso necessário, você também pode [configurar condições especiais de pagamento](/pt/docs/tutorials/condicoes-especiais).\n31. Clique em `Salvar`.\n\nDepois de concluir essas etapas, o Apple Pay aparecerá na finalização da compra da loja como um dos métodos de pagamento disponíveis.\n\n## Configurar condição de parcelamento sem juros (MSI) (opcional)\n\n> ⚠️ A condição de pagamento parcelada sem juros (**MSI - Meses Sin Intereses**) é disponível na Stripe somente para contas baseadas no México.  \n\nO __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:\n\n### Configurar MSI no modo VTEX Native Checkout experience\n\n1. Crie uma conta [Stripe](https://stripe.com/) no México configurada com a moeda MXN.\n2. No Admin VTEX, acesse __Configurações da loja > Pagamentos > Configurações__, ou digite __Configurações__ na barra de busca no topo da página.\n3. Clique em um dos meios de pagamento disponíveis que processam pagamentos com __MSI__ (cartões VISA, AMEX e Mastercard).\n4. [Configure as condições MSI](/pt/docs/tutorials/condicoes-de-pagamento#parcelado-sem-juros) da forma desejada na tela do meio de pagamento.\n5. [Configure as condições MSI](https://support.stripe.com/questions/c%C3%B3mo-configurar-meses-sin-intereses-%28msi%29-en-tu-cuenta-stripe?locale=es-419) no seu dashboard da Stripe com as mesmas informações utilizadas na configuração da VTEX (Passo 4.).\n\n> ⚠️ Caso as informações cadastradas nos Passos 4 e 5 sejam diferentes, a condição de MSI pode não funcionar corretamente.  \n\n### Configurar MSI no modo VTEX with Stripe Payment Element Experience\n\n1. Crie uma conta [Stripe](https://stripe.com/) no México configurada com a moeda MXN.\n2. [Configure as condições de MSI](https://support.stripe.com/questions/c%C3%B3mo-configurar-meses-sin-intereses-%28msi%29-en-tu-cuenta-stripe?locale=es-419) no seu dashboard da Stripe.\n3. Entre em contato com o seu Stripe executive ou time de [Stripe support](https://stripe.com/mx/contact) para solicitar que esta condição de pagamento seja acionada em sua loja."}