Início / Documentação / Integrações
doc://integracoes/stripe
Se você já integrou gateway antes, espera o ritual de sempre: copiar duas chaves e colar no sistema. Com a Stripe no MMNWEB não é assim — você autoriza a plataforma a cobrar na sua conta, e nós guardamos apenas o identificador dela. Nenhuma chave sua sai do lugar.
| Credencial | Prefixo | Pode ser exposta? | De quem é, no MMNWEB |
|---|---|---|---|
| Chave publicável | pk_ | Sim — a única segura fora do backend | Plataforma (Fragasoft) |
| Chave secreta | sk_ | Não. Equivale a usuário + senha da conta | Plataforma (Fragasoft) |
| Chave restrita | rk_ | Não — mesmo cuidado da secreta | Plataforma (Fragasoft) |
| Segredo de webhook | — | Não. Não é chave de API — valida que o evento veio da Stripe | Plataforma (Fragasoft) |
| Client ID do Connect | ca_ | Identifica a plataforma no OAuth | Plataforma (Fragasoft) |
| ID da conta conectada | acct_ | Identificador da sua conta | Sua — é a única coisa que guardamos |
Há ainda a separação entre sandbox (teste) e produção (live): cada modo tem o próprio conjunto de chaves, e objeto criado num modo não existe no outro — o clássico "o código está bugado" que na verdade é modo misturado.
sk_ ou rk_ sai do servidor. Nunca por e-mail, WhatsApp, ticket, print ou repositório. Se já aconteceu, gire (rotate) a chave imediatamente no dashboard da Stripe.O MMNWEB usa Stripe Connect, tipo Standard: a conta Stripe é sua, completa e independente — dashboard próprio, relatórios próprios, relação direta com a Stripe. Você é o merchant of record: disputa (chargeback), fraude e saldo negativo são responsabilidade sua, não da Fragasoft — escolha deliberada: não queremos carregar risco de terceiro, e você não quer intermediário decidindo sobre a sua venda.
Para cobrar na sua conta, a plataforma usa a chave secreta dela (não a sua) combinada com o acct_… da sua conta. Por isso não existe motivo técnico pra você nos passar chave alguma — o acct_… identifica, não autoriza saque.
acct_…) é gravado automaticamente.Em nenhum passo você digita ou cola uma chave. Antes de conectar, conclua o onboarding da Stripe (dados da empresa, dados bancários, verificação de identidade) — é onde quase todo mundo trava, e o motivo está na seção seguinte.
Ter um acct_… não significa que a conta pode receber. A Stripe controla duas capacidades separadas: cobrança ativa (charges_enabled) e repasses ativos (transfers). Conta com onboarding incompleto tem acct_… válido e mesmo assim fica sem repasse — a venda falharia em silêncio ou o dinheiro ficaria preso.
acct_…. Enquanto isso, o botão não aparece. Se estiver bloqueado: volte ao dashboard da Stripe e complete o que ela pedir; assim que liberar, o MMNWEB atualiza sozinho.A Fragasoft define um percentual de taxa pro seu projeto (contratual — você não o edita). Na cobrança, o percentual vira um valor absoluto em centavos enviado como taxa da aplicação (application_fee_amount) — não se envia percentual pra Stripe. Ela separa automaticamente: o líquido vai pra sua conta, a taxa vai pra plataforma. Nada transita pela conta da Fragasoft — é o que mantém a operação fora das exigências de custódia de recurso de terceiro.
Você pode revogar a autorização a qualquer momento. Em conta Standard, você continua com acesso total à sua conta, dashboard e dados — o que se perde é a capacidade de a plataforma cobrar por você. Revogar interrompe as vendas pelo MMNWEB; não bloqueia a sua conta Stripe.
Preciso mandar minha chave secreta pro suporte? Não. Nunca. Se alguém pedir, desconfie — não precisamos dela e não a armazenamos.
Testei em sandbox e funcionou; em produção deu erro. São universos separados. Confirme que a conta conectada é a de produção e que o onboarding dela está concluído.
Posso usar PIX pela Stripe? Para PIX com split, o caminho de produção do MMNWEB é o Mercado Pago.
Tipos de chave · Boas práticas de chave secreta · Referência OAuth do Connect
Relacionados: Visão geral das integrações · Mercado Pago (PIX) · Cielo
Quer ver o checkout com split rodando?