# Conectando a Stripe ao Shoprocket: a configuração em oito passos e as pegadinhas que pegam as pessoas

> A Stripe processa os pagamentos das lojas do Shoprocket. Um passo a passo prático para criar a conta, conectar via OAuth, ativar os meios de pagamento certos, configurar Radar e impostos, testar e entrar no ar. Mais as pegadinhas comuns.

Ryan Badger - 18 de outubro de 2025 - 6 min de leitura

## Por que a Stripe

O Shoprocket processa os pagamentos pela Stripe. Isso significa que, quando um cliente paga no seu checkout, o dinheiro passa pela sua conta Stripe, não pela nossa. A Stripe retém o valor, desconta a taxa deles e repassa a você no cronograma normal de repasses da Stripe.

Dois motivos para termos feito assim:

1. **Você é dono da relação de pagamento.** Se algum dia sair do Shoprocket, a sua conta Stripe continua com você. O seu histórico de transações continua com você. Seus dados de repasse, seus chargebacks, o histórico de pagamentos dos seus clientes: tudo na Stripe, tudo seu.
2. **A Stripe é a melhor plataforma de pagamentos para a maioria das lojas.** Ampla cobertura internacional, mais de 200 meios de pagamento, API moderna, forte detecção de fraude (Radar) e todo o conjunto de compre-agora-pague-depois (Klarna, Afterpay, Affirm) passa por ela. É o padrão razoável.

Você nunca precisa mexer manualmente no painel da Stripe, a menos que queira. O Shoprocket gerencia produtos, preços e webhooks para você. Os dois lados ficam sincronizados automaticamente.

## A configuração, em ordem

### 1. Crie uma conta Stripe (ou use a que você já tem)

Acesse [stripe.com](https://stripe.com/) e cadastre-se. Você vai precisar de:

- **Dados da empresa** (razão social, endereço, número fiscal se você for registrado)
- **Conta bancária** para repasses (só local: conta nos EUA para repasses em USD, no Reino Unido para GBP, na UE para EUR etc.)
- **Um número de telefone** para verificação por SMS
- **Dados do proprietário / representante** (exigência de KYC para prevenção de fraudes)

Leva de 10 a 15 minutos. A Stripe aprova a maioria das contas na hora; algumas categorias (armas de fogo, CBD, alguns modelos de assinatura) exigem análise adicional.

### 2. Conecte a Stripe ao Shoprocket

No painel do Shoprocket: **Configurações → Pagamentos → Stripe → Conectar**.

Isso inicia um fluxo OAuth da Stripe. Você será redirecionado para a Stripe, vai aprovar o acesso do Shoprocket à sua conta e voltará para cá. Nós nunca vemos a sua senha da Stripe; recebemos um token com escopo limitado, que nos permite criar cobranças, processar reembolsos e escutar eventos de webhook.

Se você já tem a Stripe conectada a outras ferramentas (seu software de contabilidade, outra loja), isso não interfere. Várias ferramentas podem se conectar à mesma conta Stripe.

### 3. Ative os meios de pagamento na Stripe

No painel da Stripe: **Configurações → Meios de pagamento**. Você verá uma lista longa.

**Ative de imediato:**

- Cartões de crédito / débito (ativados por padrão)
- Apple Pay (ativado automaticamente depois que você verifica o domínio; a Stripe faz isso por você pela incorporação do Shoprocket)
- Google Pay (idem)
- Link (o pagamento de um clique da Stripe, aumenta a conversão, grátis para ativar)

**Ative se for relevante para a sua base de clientes:**

- PayPal (exige uma conta PayPal Business separada; a Stripe cuida da integração)
- Klarna, Afterpay, Affirm (compre agora, pague depois; ótimos para categorias de ticket médio alto; veja o nosso [guia de compre agora, pague depois](https://v3.shoprocket.io/pt/blog/compre-agora-pague-depois-bnpl-categorias-custos-e-provedores.md))
- Cripto (a cripto da Stripe está se expandindo; confira a disponibilidade na sua região)
- Meios de pagamento locais (iDEAL na Holanda, Bancontact na Bélgica, BLIK na Polônia, Sofort/débito SEPA na Alemanha)

Todo meio que você ativa aqui aparece automaticamente no checkout do Shoprocket. Sem código, sem precisar salvar os produtos de novo.

### 4. Configure o descritor da fatura

Na Stripe, em **Configurações → Dados públicos**: defina o **descritor da fatura** (o que aparece na fatura do cartão de crédito do cliente, por exemplo "ACME STORE"). É a maior alavanca contra chargebacks de "fraude amigável": compradores que esquecem que compraram algo e contestam a cobrança.

Deixe-o reconhecível. Evite nomes genéricos como "ECOMMERCE" ou o nome da sua plataforma. Use o nome real da sua marca.

### 5. Ative o Stripe Radar

O **Radar** é a detecção de fraudes da Stripe. Vem ativado por padrão em todas as contas, mas vale revisar as configurações.

Em **Radar → Regras**: as regras padrão bloqueiam fraudes óbvias (cartões roubados, ataques de velocidade). Acrescente regras específicas da sua categoria à medida que crescer:

- Bloquear pedidos em que os países de cobrança e de entrega diferem em mais de uma região
- Sinalizar pedidos acima de um valor específico para revisão manual
- Bloquear IPs de regiões conhecidas por alto índice de fraude

O Radar é grátis até US$ 25 mil/mês em volume; depois, US$ 0,05 por transação. Vale cada centavo acima desse limite.

### 6. Deixe o Stripe Tax desligado

O Shoprocket tem o seu próprio cálculo automático de impostos integrado. Configure seus registros fiscais e alíquotas no painel do Shoprocket, não na Stripe.

**Não ative o Stripe Tax junto com o mecanismo de impostos do Shoprocket.** Os dois tentarão calcular o imposto na mesma transação, os valores vão divergir, e as suas faturas / totais de pedido / conciliação de repasses ficarão todos fora de sincronia. Um único lugar cuida dos impostos: o Shoprocket.

### 7. Teste a integração

Antes de entrar no ar, faça pedidos de teste. No painel do Shoprocket: **Configurações → Loja → Modo de teste**. Ative.

No modo de teste, o seu checkout troca a Stripe (e todo outro gateway conectado) pelo gateway de teste integrado do Shoprocket. Nenhum pagamento real passa pela Stripe enquanto o modo de teste estiver ativo. Você não precisa de cartões de teste da Stripe; o gateway de teste simula pedidos bem-sucedidos, pedidos com falha e desafios 3DS para você verificar o fluxo completo do checkout.

Percorra: adicionar ao carrinho, aplicar um código de desconto, concluir o checkout pelo gateway de teste, conferir a página de confirmação, conferir o e-mail do pedido, verificar se o pedido aparece no painel do Shoprocket. Se algo parecer errado, corrija antes de entrar no ar.

### 8. Entre no ar

Desative o modo de teste. Faça você mesmo uma transação real de valor pequeno (e reembolse depois). Confira se o dinheiro chega ao seu saldo na Stripe, se o cronograma de repasses faz sentido e se o e-mail do pedido está correto.

Você está no ar.

## Pegadinhas comuns

### "Falha no repasse" no primeiro repasse

A Stripe exige a verificação da conta bancária antes do primeiro repasse. Se a sua conta não estiver verificada, a Stripe retém o saldo até que isso seja feito. Confira **Configurações → Repasses** e conclua as verificações pendentes.

### Chargebacks não são o fim do mundo

Toda loja recebe chargebacks. O limite da taxa de chargebacks da Stripe (o nível que faz a sua conta ser sinalizada) é de 1% das transações em qualquer janela móvel de 120 dias. A maioria das lojas legítimas fica entre 0,1% e 0,3%. Você pode contestar chargebacks pelo painel da Stripe; enviar comprovante de envio + código de rastreio vence a maioria deles quando a alegação é "item não recebido".

### Stripe Link / cartões salvos

Se o seu cliente já usou o Stripe Link em outro lugar (Amazon, qualquer loja que use a Stripe), ele pode pagar na sua loja com um toque. Não desative o Link a menos que queira muito; ele aumenta a conversão.

### Repasses internacionais

A Stripe retém os fundos na moeda do cliente e converte para a sua moeda de repasse todo dia. Se a sua conta bancária é em USD mas os seus clientes são em EUR, você paga uma pequena taxa de câmbio em cada conversão. Isso é inevitável, a menos que você abra contas de repasse em EUR / GBP etc. com a Stripe (eles têm suporte a liquidação em várias moedas).

### Quando a Stripe não está disponível

A Stripe não está disponível em todos os países. Em 2026: disponível em cerca de 45 países para vendedores. Se você está em um onde não está, o Shoprocket também aceita o PayPal como processador principal. Confira antes a [cobertura da Stripe](https://stripe.com/global).

## O que o Shoprocket cobre para você

A Stripe é a camada de pagamentos; o Shoprocket é tudo ao redor dela:

- Catálogo de produtos com imagens, variantes e preços
- Estado do carrinho e experiência do checkout
- Tratamento de webhooks (a Stripe nos avisa dos eventos de pagamento, nós atualizamos o status do seu pedido)
- E-mails de pedido (confirmações para o cliente, notificações de envio)
- Processamento de reembolsos (iniciado no Shoprocket, repassado à Stripe)
- Revisão de fraude se você sinalizar pedidos manualmente

```
<!-- EXAMPLE ONLY. Grab your real snippet from Sales channels → Embeds in your dashboard -->
<script src="https://cdn.shoprocket.io/loader.js" data-pk="pk_yourkey"></script>
<div data-shoprocket="catalog" data-embed-id="emb_xxx"></div>
```

## Resumo

1. **Cadastre-se na Stripe** (ou use uma conta existente)
2. **Conecte-a ao Shoprocket** via OAuth no seu painel
3. **Ative os meios de pagamento** na Stripe (cartões, Apple Pay, Google Pay e Link por padrão; compre agora, pague depois / PayPal / meios locais, se relevante)
4. **Defina um descritor da fatura claro** (reduz chargebacks)
5. **Ative o Radar** (deixe o Stripe Tax desligado: o Shoprocket cuida dos impostos)
6. **Teste** pelo gateway de teste integrado do Shoprocket no modo de teste
7. **Entre no ar** com uma pequena transação real para verificar

Tempo total de configuração: menos de uma hora para uma loja simples, meio dia se você ativar tudo.

[Comece um teste grátis do Shoprocket](https://app-v3.shoprocket.io/signup), 14 dias, sem precisar de cartão para experimentar.

---

- HTML version: https://v3.shoprocket.io/pt/blog/conectando-a-stripe-ao-shoprocket-configuracao-em-oito-passos-e-armadilhas
- Language: Português (pt)
- Also in: [العربية](https://v3.shoprocket.io/ar/blog/connecting-stripe-to-shoprocket-the-eight-step-setup-and-the-gotchas-that-catch-people-out.md), [Deutsch](https://v3.shoprocket.io/de/blog/stripe-mit-shoprocket-verbinden-einrichtung-acht-schritte.md), [Ελληνικά](https://v3.shoprocket.io/el/blog/connecting-stripe-to-shoprocket-the-eight-step-setup-and-the-gotchas-that-catch-people-out.md), [English](https://v3.shoprocket.io/blog/connecting-stripe-to-shoprocket-the-eight-step-setup-and-the-gotchas-that-catch-people-out.md), [Español](https://v3.shoprocket.io/es/blog/conectar-stripe-a-shoprocket-configuracion-ocho-pasos.md), [Français](https://v3.shoprocket.io/fr/blog/connecter-stripe-a-shoprocket-configuration-en-huit-etapes.md), [עברית](https://v3.shoprocket.io/he/blog/connecting-stripe-to-shoprocket-the-eight-step-setup-and-the-gotchas-that-catch-people-out.md), [हिन्दी](https://v3.shoprocket.io/hi/blog/connecting-stripe-to-shoprocket-the-eight-step-setup-and-the-gotchas-that-catch-people-out.md), [Bahasa Indonesia](https://v3.shoprocket.io/id/blog/menghubungkan-stripe-ke-shoprocket-delapan-langkah-dan-jebakan-umum.md), [Italiano](https://v3.shoprocket.io/it/blog/collegare-stripe-a-shoprocket-configurazione-otto-passaggi-e-trappole-comuni.md), [日本語](https://v3.shoprocket.io/ja/blog/connecting-stripe-to-shoprocket-the-eight-step-setup-and-the-gotchas-that-catch-people-out.md), [Lietuvių](https://v3.shoprocket.io/lt/tinklarastis/stripe-prijungimas-prie-shoprocket-astuoni-zingsniai.md), [Norsk](https://v3.shoprocket.io/nb/blogg/koble-stripe-til-shoprocket-oppsett-i-atte-steg.md), [Nederlands](https://v3.shoprocket.io/nl/blog/stripe-koppelen-aan-shoprocket-acht-stappen.md), [Polski](https://v3.shoprocket.io/pl/blog/podlaczanie-stripe-do-shoprocket-konfiguracja-w-osmiu-krokach.md), [Română](https://v3.shoprocket.io/ro/blog/conectare-stripe-shoprocket-opt-pasi-si-capcane.md), [Русский](https://v3.shoprocket.io/ru/blog/connecting-stripe-to-shoprocket-the-eight-step-setup-and-the-gotchas-that-catch-people-out.md), [ไทย](https://v3.shoprocket.io/th/blog/connecting-stripe-to-shoprocket-the-eight-step-setup-and-the-gotchas-that-catch-people-out.md), [Türkçe](https://v3.shoprocket.io/tr/blog/stripe-shoprocket-baglantisi-sekiz-adimda-kurulum-ve-sik-yapilan-hatalar.md), [中文](https://v3.shoprocket.io/zh/blog/connecting-stripe-to-shoprocket-the-eight-step-setup-and-the-gotchas-that-catch-people-out.md)
