Skip to main content
Este guia prepara sua conta Stripe para o Bring Your Own Processor (BYOP): você solicita à Stripe acesso à API de dados brutos de cartão e, em seguida, coleta a chave secreta e o segredo de assinatura do webhook necessários para a Dodo Payments. Se precisar de ajuda, fale conosco.

Habilitar o acesso a dados brutos de cartão

Para direcionar pagamentos pela sua conta Stripe, a Dodo Payments envia os dados do cartão à Stripe em seu nome por meio das raw card data APIs da Stripe. Por padrão, uma conta Stripe não pode enviar números de cartão brutos (PANs) para suas APIs. A Stripe habilita esse acesso somente depois de confirmar que os sistemas que lidam com dados brutos de cartão são compatíveis com PCI DSS. Com o BYOP, o sistema que lida com os dados do cartão é a Dodo Payments, que é compatível com PCI DSS Level 1; portanto, você comprova a conformidade usando a certificação da Dodo Payments, e não a sua própria. Você solicita esse acesso uma vez por conta. Quando você solicita acesso, a Stripe pede uma breve descrição de como os dados do cartão são tratados. Informe que a Dodo Payments, sua provedora de pagamentos em conformidade com o PCI DSS Level 1, processa os dados brutos do cartão e que seus próprios sistemas nunca armazenam nem tocam nos números brutos dos cartões. Como você terceiriza totalmente o tratamento dos cartões para a Dodo Payments, não precisa do seu próprio SAQ D se for elegível para o SAQ A. Envie seu próprio SAQ A, listando a Dodo Payments como a provedora de serviços terceirizada na Parte 2f, e inclua a Dodo Payments Attestation of Compliance (AOC) como comprovante de suporte:

Dodo Payments PCI DSS Attestation of Compliance (AOC)

Baixe o AOC atual da Dodo Payments e envie-o à Stripe ao solicitar o acesso a dados brutos de cartão.
O modo de teste não exige documentação. Se você precisa das APIs de dados brutos do cartão apenas para testes e não pode usar os cartões de teste pré-tokenizados da Stripe, peça ao suporte da Stripe para habilitá-las, para que possa criar e verificar sua configuração de BYOP. O modo live ainda exige seu SAQ A e a AOC da Dodo Payments.
Para solicitar acesso, siga o guia da Stripe e envie a AOC da Dodo Payments quando a Stripe solicitar a documentação de PCI:

Enabling access to raw card data APIs

Guia da Stripe para solicitar acesso à API de dados brutos do cartão na sua conta.

O que você precisará

Depois que a Stripe confirmar o acesso aos dados brutos do cartão, conecte a Stripe em Settings → BYOP. Você precisará de dois valores do Stripe Dashboard:
A Stripe mantém as credenciais do sandbox (teste) e do modo live separadas. Use um sandbox da Stripe para o modo de teste da Dodo Payments e o modo live da Stripe para o modo live da Dodo Payments.

Etapa 1: Obter sua Secret Key

1

Open API Keys

No Stripe Dashboard, abra a página API keys. Alterne entre o modo sandbox e o modo live para corresponder ao modo da Dodo Payments que você está configurando.
2

Copy Your Secret Key

Copie a Secret key. Ela começa com sk_test_ em um sandbox e com sk_live_ no modo live. Use uma secret key padrão: chaves restritas (rk_...) não são compatíveis. No modo live, a Stripe mostra uma secret key que você cria apenas uma vez; portanto, copie-a antes de fechar a caixa de diálogo.Cole a chave no campo Secret Key da Dodo Payments.

Etapa 2: Configurar o Webhook e o Signing Secret

Ao salvar a conexão com a Stripe, a Dodo Payments gera uma URL de Webhook Endpoint. Adicione-a à Stripe como um endpoint de webhook e copie o signing secret do endpoint.
1

Create an Event Destination

No Stripe Dashboard, abra a aba Webhooks no Workbench e selecione Create an event destination. Selecione Your account e, em seguida, selecione todos os eventos. A Dodo Payments precisa que o endpoint receba todos os tipos de eventos.
2

Add the Endpoint URL

Escolha Webhook endpoint como tipo de destino. Em Endpoint URL, cole a URL de Webhook Endpoint gerada pela Dodo Payments. A Stripe aceita apenas URLs HTTPS publicamente acessíveis.
3

Reveal the Signing Secret

Na página de configurações do endpoint, selecione Reveal secret para visualizar o Signing secret. Ele começa com whsec_. Cada endpoint tem seu próprio secret, portanto, os endpoints de sandbox e live têm secrets diferentes.
4

Paste the Signing Secret into Dodo

Em Settings → BYOP, cole o signing secret no campo Webhook Signing Secret e selecione Save & continue para concluir a conexão.

Set up BYOP

Siga o fluxo completo de configuração do Bring Your Own Processor.
Até que você salve o signing secret, a conexão com a Stripe aparece como Incomplete em Edit Configuration, em Settings → BYOP. Depois que você salvá-lo, a conexão aparecerá como Connected.

Perguntas frequentes

Não, se você for elegível para o SAQ A. A Dodo Payments trata os dados brutos do cartão em seu nome e está em conformidade com o PCI DSS Level 1; portanto, você envia seu próprio SAQ A, listando a Dodo Payments na Parte 2f, juntamente com a Dodo Payments Attestation of Compliance (AOC), em vez de preencher o SAQ D ou realizar uma auditoria separada.
Enviar números brutos de cartão para uma API coloca o sistema que realiza o envio no escopo do PCI DSS. A Stripe exige um comprovante de conformidade com o PCI antes de habilitar as APIs de dados brutos do cartão, para que os dados do titular do cartão permaneçam protegidos. A Dodo Payments está em conformidade com o PCI DSS Level 1, portanto, você fornece a AOC da Dodo Payments como esse comprovante.
Sim. Peça à Stripe para habilitar as APIs de dados brutos do cartão no modo de teste, que não exige documentação de PCI, e conecte a Stripe no modo de teste na Dodo Payments. Você precisará da aprovação para o modo live antes de processar pagamentos reais.
Para visualizar o signing secret novamente, abra o endpoint de webhook na Stripe e selecione Reveal secret. Para atualizá-lo na Dodo Payments, abra Settings → BYOP, selecione Edit Configuration, edite a conexão com a Stripe, cole o secret no campo Webhook Signing Secret e selecione Save & continue.Se você perder uma secret key live que criou, a Stripe não poderá exibi-la novamente; portanto, faça a rotação dela ou crie uma nova chave na página API keys. O dashboard da Dodo não permite alterar uma secret key salva. Para substituir a secret key em uma conexão existente, entre em contato com support@dodopayments.com.

Referências

Última modificação em 28 de setembro de 2026