{"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-%28ocs%29?locale=pt-BR). 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](mailto: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\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](mailto: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_1/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\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](mailto: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\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."}