A Stripe é uma plataforma de pagamentos que oferece um sistema integrado com foco no recebimento de pagamentos online e qualquer tipo de transação financeira comum a ecommerces e outros sites da web.

A integração da sua loja com a Stripe é feita por meio de uma Application Key e Application Token. Para obter esses dados, primeiramente crie sua conta na plataforma e, ao finalizar, acesse esta documentação da Stripe para ter acesso à sua Chave publicável e Chave secreta. Elas são mandatórias para as configurações no ambiente VTEX.

A Stripe suporta pagamentos em mais de 40 países. A lista de países disponíveis pode ser acessada no site da Stripe.

Para processar seus pagamentos com a Stripe, você precisa:

1. Configurar a Stripe
2. Configurar condições de pagamento

Siga os passos abaixo para a configuração no ambiente VTEX.

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 StripeConnector na barra de busca e clique sobre o nome do provedor.
4. Preencha os campos abaixo com as seguintes informações:

• Chave de aplicação: Chave publicável que você obteve no dashboard da sua conta na Stripe.
• Token de aplicação: Chave secreta que você obteve no dashboard da sua conta na Stripe.

5. Clique em Salvar.

Após a configuração no ambiente VTEX, você também precisa configurar o Webhook na sua conta da Stripe.

1. Acesse o dashboard da sua conta na Stripe.
2. Clique no botão Desenvolvedores.
3. Clique na aba Webhooks.
4. Clique no botão Adicione um endpoint.
5. No campo URL do endpoint, adicione a URL de endpoint da sua loja VTEX no formato https://{nome-da-conta}.myvtex.com/_v/notifications substituindo {nome-da-conta} pelo nome da sua conta VTEX.
6. Clique em + Selecionar eventos.
7. Clique nas categorias e selecione os eventos desejados. Caso não tenha certeza sobre quais eventos devem ser adicionados, entre em contato com o suporte da Stripe para que possam ajudá-lo neste tipo de configuração.
8. Clique em Adicionar eventos.
9. Clique em Adicionar endpoint.

Caso você deseje realizar transações com cartão de crédito na Stripe, é necessário abrir um ticket na própria Stripe da seguinte maneira: - Solicitar a liberação da função "raw card data", indicando que a VTEX e a Stripe são parceiros de pagamento. - Encaminhar em anexo o AOC (Attestation of Compliance for Onsite Assessments – Service Providers) da VTEX. Para verificar a versão mais recente do AOC VTEX, acesse a página de certificações da VTEX e baixe o arquivo na seção PCI. As ações acima evitarão que erros relacionados a transmissão de dados sensíveis ocorram na integração entre a Stripe e a VTEX.

Ao concluir as etapas indicadas, a Stripe estará configurada na sua loja. Assim, ao cadastrar uma condição de pagamento, ela vai estar disponível no campo Processar com a afiliação (desde que o meio de pagamento seja compatível com a Stripe).

Para definir condições de pagamento, acesse o artigo Configurar condições de pagamento.

O conector Stripe permite adicionar o Google Pay como método de pagamento no checkout da sua loja.Com o conector Stripe configurado, você pode adicionar o Google Pay com os seguintes passos:

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. Em Condições de pagamento, clique no ícone +
3. Clique sobre a opção Google Pay.
4. Ative a condição no campo Status.
5. Em Processar com a afiliação, selecione a opção StripeConnector.
6. Clique em Salvar.

Após esse procedimento, o Google Pay aparecerá no checkout da loja como um dos métodos de pagamento disponíveis.

O conector Stripe permite adicionar o Apple Pay como método de pagamento no checkout da sua loja.

O Apple Pay funciona atualmente somente nos sistemas operacionais MacOs e IOS, e no navegador Safari. Para maiores informações, acesse Dispositivos compatíveis com o Apple Pay.

Com o conector Stripe configurado, você pode adicionar o Apple Pay com os seguintes passos:

1. Acesse o dashboard da sua conta na Stripe na seção de configuração de pagamentos.
2. Em Settings, clique em Payment Methods.
3. Clique em Apple Pay > Configure e depois em Add to new domain.
4. Insira o domínio público do website da sua loja.
5. Clique em Baixar arquivo de verificação para salvá-lo em seu dispositivo.
6. Crie as credenciais appkey e apptoken.
7. Faça uma chamada ao endpoint para enviar o arquivo de verificação baixado anteriormente, adicionando no header as credenciais criadas e o endereço do seu domínio público (https://{{dominioPublicodoSite}}/well-known/raw/apple-developer-merchantid-domain-association).
8. Clique em Add.
9. Acesse o Admin VTEX.
10. Clique em Pagamentos.
11. Em seguida, clique em Configurações.
12. Na aba Condições de pagamento, clique no botão +.
13. Clique em Apple Pay.
14. Preencha o campo Nome da regra com um nome de sua preferência para identificação.
15. Clique no botão Status para ativar essa condição de pagamento.
16. No campo Processar com a afiliação, selecione a opção Stripe.
17. Se houver um antifraude configurado na sua loja, você pode ativá-lo para essa condição de pagamento marcando a caixa Usar Antifraude.
18. Escolha se os pagamentos serão à vista ou parcelados.
19. Se desejar, você também pode configurar condições especiais de pagamento.
20. Clique em Salvar.

Após esse procedimento, o Apple Pay aparecerá no checkout da loja como um dos métodos de pagamento disponíveis.