Conectar a Stripe
Receba pagamentos com cartão pela sua conta Stripe, com assinaturas, order bump e upsell de 1 clique.
A Stripe processa cartões de crédito e débito em dezenas de moedas. Conectada ao Vipter, ela atende vendas avulsas, assinaturas, order bump e upsell de 1 clique. A Stripe não faz PIX nem parcelamento: para isso, conecte também a Pagar.me, o Mercado Pago ou o Asaas.
Antes de começar
- Uma conta Stripe ativada para receber pagamentos. Para experimentar antes, o modo de teste da Stripe serve.
- Papel Admin ou Dono no projeto do Vipter.
- Espaço no seu plano para mais uma conexão ativa. A tela de provedores mostra quantas você já usa.
Passo 1: copiar a chave secreta na Stripe
- Entre no painel da Stripe e confira no topo da tela em qual ambiente você está: o modo de teste serve para experimentar, e a conta real para vender.
- Abra DesenvolvedoresChaves de API. O endereço direto é
dashboard.stripe.com/apikeys. - Na linha Chave secreta, clique em Revelar e copie o valor. Ele começa com
sk_live_na conta real e comsk_test_no modo de teste.
Guarde a chave com cuidado
A chave secreta dá acesso total à sua conta Stripe. Cole a chave só no Vipter e não a envie por e-mail nem por WhatsApp. Se ela vazar, gere outra na Stripe e troque no Vipter pelo botão Trocar chaves.
Passo 2: criar a conexão no Vipter
- No painel do Vipter, abra PagamentosProvedoresStripe.
- Clique em Nova conexão. Se a loja ainda não tem nenhuma conta Stripe, o formulário já aparece aberto.
- Preencha os campos numerados:
| # | Campo | O que colar |
|---|---|---|
| 1 | Nome da conta | Um nome para reconhecer a conta, como "Stripe EUA". Ele aparece nos fluxos de pagamento. |
| 2 | País da conta | O país onde a conta Stripe foi aberta. Não dá para mudar depois. |
| 3 | Chave secreta (Secret key) | A chave secreta que você copiou no passo 1. |
| 4 | Conexão de teste | Ligado, aceita só as chaves e os cartões de teste (sk_test_). Desligue para cobrar de verdade com a chave sk_live_. |
- Clique em Salvar e obter a URL de webhook. O Vipter confere a chave com a Stripe antes de salvar. Se ela estiver errada, nada é gravado e o erro aparece no formulário.
O modo de teste vem ligado
O botão Conexão de teste começa ligado para que a primeira conexão não cobre ninguém por engano. Para vender, crie a conexão com ele desligado e a chave sk_live_.
Se esta for a primeira conta de cartão da loja, o Vipter cria sozinho os fluxos de pagamento de cartão de crédito e de débito apontando para ela. A loja já pode cobrar depois do passo 4.
Passo 3: cadastrar o webhook na Stripe
Pelo webhook, a Stripe avisa o Vipter do que acontece depois da compra: reembolsos, contestações, capturas e pagamentos que pedem autenticação. Sem ele, esses eventos não chegam à loja.
- Depois de salvar, o card da conexão mostra a URL do webhook. Copie o endereço.
- Na Stripe, abra DesenvolvedoresWebhooks e clique em Adicionar destino. Em painéis mais antigos, o botão se chama Adicionar endpoint.
- Selecione todos os eventos dos grupos Charge, Payment Intent e Refund.
- Escolha Endpoint de webhook, cole a URL copiada no item 1 e salve.
- Abra o destino criado e copie o Segredo de assinatura, que começa com
whsec_.
- Volte ao Vipter, cole o segredo no card da conexão e clique em Salvar segredo.
| # | Campo | O que colar |
|---|---|---|
| 1 | Segredo do webhook (Signing secret) | O segredo whsec_ do destino que você criou na Stripe. |
Passo 4: testar a conexão
- No card da conexão, clique em Testar. O Vipter consulta a Stripe com a chave salva.
- Faça uma compra de teste no checkout de uma oferta. Com o modo de teste ligado, use o cartão
4242 4242 4242 4242, qualquer data futura e qualquer CVV.
Deu certo se
Aparece a mensagem Conexão OK., o card mostra Segredo de verificação configurado. e a compra de teste entra em VendasTransações como paga.
Problemas comuns
-
Seu plano permite N conector(es) ativo(s). Faça upgrade para adicionar mais.
O plano chegou ao limite de conexões ativas. Desative uma conexão que não usa mais ou mude de plano em Plano Vipter.
-
Selecione um país atendido por este provedor.
O país escolhido não é atendido pela Stripe. Use o país em que a conta Stripe foi aberta.
-
A Stripe recusou a chave
A chave está incompleta, é de outra conta ou é de teste com o modo de teste desligado (ou o contrário). Copie de novo a chave secreta, não a publicável (
pk_), e confira o botão Conexão de teste. -
Sem o segredo de verificação a plataforma recusa os eventos deste provedor. Cadastre a URL acima no provedor, copie o segredo e salve aqui.
O webhook não foi cadastrado ou o segredo não foi salvo. Refaça o passo 3.
O que fazer a seguir
- Conecte um provedor com PIX e parcelamento, como a Pagar.me, se você vende no Brasil.
- Revise os fluxos em PagamentosFluxos de pagamento para decidir qual conta cobra cada pagamento e qual serve de reserva.