Contestação de chargeback Stripe: Dashboard e API de Disputes

Como o Stripe opera chargeback

A Stripe é a adquirente preferida de empresas tech e SaaS globais — usada por Shopify, Lyft, Salesforce, Atlassian, várias startups brasileiras com operação internacional. Diferencial: API completa, documentação clara, foco em desenvolvedor.

O fluxo de Disputes está no Dashboard (dashboard.stripe.com/disputes) e via API (/v1/disputes). O Pagar.me brasileiro inclusive copiou o modelo de "categorias estruturadas" de evidência da Stripe.

Prazo Stripe

O Stripe trabalha com prazo interno de 7 dias úteis para a maioria dos reason codes. Em casos de fraude o prazo pode ser de 5 dias. A bandeira por trás (Visa/Mastercard) define o prazo público, mas o Stripe impõe interno mais curto.

Categorias estruturadas de evidência

Diferente de outros adquirentes que aceitam "PDF único com tudo", a Stripe organiza a evidência em 7 categorias estruturadas. Você anexa cada documento na categoria correta:

Adicionalmente, há campos de texto:

• customer_email_address, customer_name, customer_purchase_ip
• product_description
• refund_policy (URL) + refund_policy_disclosure (texto)
• service_date, shipping_date, shipping_address, shipping_carrier, shipping_tracking_number
• uncategorized_text — para a carta de defesa narrativa

Passo a passo no Dashboard

1. Acesse dashboard.stripe.com/disputes.
2. Filtre por status "Needs response".
3. Clique no caso. Vê: dispute ID, charge ID, reason, valor, prazo, evidência sugerida pra esse reason.
4. Clique em "Submit evidence".
5. Preencha cada campo de texto conforme aplicável.
6. Anexe documentos em cada categoria correta (não joga tudo em uncategorized).
7. Use o campo "Uncategorized text" pra carta de defesa (aceita até 20.000 caracteres).
8. Submeta. Status muda para "Under Review". Decisão em 60-75 dias.

API Stripe de Disputes

Endpoints principais:

• GET /v1/disputes — lista disputes paginadas.
• POST /v1/disputes/{id} — atualiza evidência (campo a campo).
• POST /v1/disputes/{id}/close — desiste e aceita a perda.
• Webhook charge.dispute.created, charge.dispute.updated, charge.dispute.closed.

Stripe API é gold standard de DX (developer experience). Para EC com qualquer time de engenharia, automatizar contestação via API leva ~5 dias de dev e elimina ~80% do trabalho manual.

Stripe Radar — prevenção integrada

O Stripe Radar é o motor antifraude nativo. Cobra US$ 0.05 por transação avaliada (Radar) ou US$ 0.07 por transação no Radar for Teams (com regras customizáveis e revisão manual).

Radar reduz tipicamente 40–70% dos chargebacks de fraude — quando combinado com 3DS frictionless, chega a 80%. Ativar antes de pensar em otimizar contestação.

Particularidades Stripe

• Multi-currency nativo — útil pra operações com receita em USD/EUR.
• Linguagem do Dashboard em inglês — reason codes em formato Visa/Mastercard padrão.
• 3DS automatizado com SCA (Strong Customer Authentication) para EU; opcional para BR.
• Suporte por chat 24/7 em inglês; PT-BR em horário comercial.
• Programas de risco — Stripe monitora taxa de chargebacks; acima de 1% ativa "Stripe Risk Team" review.

Outros adquirentes

• Adyen — alternativa enterprise internacional.
• Pagar.me — copiou modelo de categorias estruturadas Stripe.
• Cielo — alternativa nacional.
• Stone — UI moderna.

Perguntas frequentes

Qual o prazo Stripe para contestar chargeback?

Stripe trabalha com prazo interno de 7 dias úteis para a maioria dos reason codes. Em fraude pode ser 5 dias. A bandeira por trás define o prazo público mas o Stripe sempre impõe interno mais curto para consolidar a resposta.

O que são categorias de evidência no Stripe?

Stripe organiza evidência em 7 categorias estruturadas (access_activity_log, customer_communication, customer_signature, receipt, shipping_documentation, service_documentation, uncategorized_file). Cada documento vai na categoria correta — isso facilita o analista do emissor identificar o que importa.

Stripe Radar vale a pena?

Sim, na maioria dos casos. Radar custa US$ 0.05/transação avaliada e reduz tipicamente 40-70% dos chargebacks de fraude. O ROI fica positivo em operações com taxa de fraude acima de 0,3%. Para taxa < 0,2%, vale avaliar o trade-off custo vs benefício.

Posso integrar contestação Stripe via API?

Sim, API gold standard. Endpoints GET/POST de disputes, POST de evidence, webhooks completos para todos os eventos do ciclo. Para EC tech, integração leva ~5 dias de dev e elimina ~80% do trabalho manual.