Notificações do Stripe: o e-mail de disputa é o que você não pode perder

Uma disputa no Stripe vem com um prazo, e ele é curto. A própria documentação do Stripe diz que você tem uma janela limitada para responder, “geralmente de 7 a 21 dias, dependendo da bandeira do cartão”, e que, se você perder o prazo, “você perde a disputa automaticamente e não pode recuperar os valores em disputa”. De todas as notificações do Stripe que você pode ativar, essa é a que custa dinheiro quando fica sem ser lida.

Se você preferisse que o e-mail de disputa do Stripe fizesse o seu celular tocar, o caminho do e-mail funciona num iPhone; os alertas push do aplicativo do Stripe ali precisam de um retransmissor Bluetooth.

O Stripe te notifica sobre disputas?

Sim, em quatro lugares. A página de disputas do Stripe lista o seu endereço de e-mail, o Dashboard, um evento charge.dispute.created se a sua integração escuta eventos, e uma notificação push do aplicativo móvel se você estiver inscrito. Disputas também estão na lista padrão de e-mails que cada integrante da equipe pode ativar ou desativar, e essa parte individual importa mais do que parece.

Dois detalhes da mesma página mudam a velocidade com que você deveria agir.

Algumas disputas começam como consultas, uma fase anterior à disputa que costuma surgir quando o portador do cartão não reconhece uma cobrança. O Stripe diz que responder nessa fase pode evitar uma disputa formal e economiza “tempo, taxas e a sua reputação junto às bandeiras de cartão”. Se ela mesmo assim avançar, você responde de novo.

E você tem só uma chance. “Você tem só uma oportunidade de enviar a sua resposta”, escreve o Stripe, e, depois de enviada, você não consegue editar ou acrescentar arquivos. Então o prazo não é bem de 7 a 21 dias para responder. É de 7 a 21 dias para reunir a nota fiscal, os e-mails do cliente, a sua política de reembolso e qualquer coisa que prove que o trabalho foi entregue. Depois você junta tudo em arquivos dentro do limite de 4,5 MB do Stripe e responde. Para quem funda um SaaS, essa prova costuma ser os registros de uso. Para um freelancer, é o contrato e a mensagem em que o cliente disse que o trabalho ficou ótimo.

Contestar também não é de graça. O Stripe cobra uma taxa de contestação de disputa além da taxa de recebimento da disputa, e só devolve a taxa de contestação se você ganhar. O banco pode levar até 3 meses para decidir, e o Stripe te manda um e-mail quando isso acontece. Se você também recebe pelo PayPal, as disputas dele seguem outro relógio, cobertas em notificações do PayPal.

O Stripe manda uma notificação de pagamento recusado?

Para o seu cliente, sim, se você ativar isso. Para você, depende do que a sua conta oferece, e é aí que as pessoas se confundem.

A configuração que a maioria encontra primeiro é Enviar e-mails quando pagamentos com cartão falham, na página de e-mails de recuperação de receita. O Stripe é claro sobre quem recebe: ele “manda automaticamente um e-mail para o seu cliente depois de cada pagamento recusado” para que ele atualize o cartão. Bom para assinaturas. Isso não faz nada para te avisar que uma renovação anual de 2.000 US$ acabou de ser recusada.

A lista publicada pelo Stripe de e-mails que ele manda para você cobre pagamentos bem-sucedidos, disputas, pagamentos marcados como arriscados pelo Stripe ou por uma regra do Radar, taxas de aplicação de contas conectadas, menções em notas, faturas pagas com o valor errado e falhas na entrega de webhooks. Pagamentos recusados não estão nessa lista. O Stripe também diz que a lista completa fica nas suas próprias Preferências de comunicação, então confira ali antes de decidir qualquer coisa. Se não estiver disponível, existem dois caminhos. O Stripe Workflows parte de um gatilho e pode mandar um e-mail para um integrante da equipe (o exemplo do Stripe manda um e-mail para alguém quando um pagamento acima de 1.000 US$ é bem-sucedido), então confira se um gatilho de falha está disponível na sua conta. Ou um desenvolvedor pode capturar a falha com um webhook, coberto na nota para desenvolvedores abaixo.

Notificações de repasse do Stripe

Um repasse que chega não precisa de alarme. O seu banco vai te avisar. Um repasse que falha é diferente. Se o seu banco não conseguir processar um repasse, o FAQ de repasses do Stripe diz que você pode receber um e-mail com o assunto “Ação necessária para retomar os repasses do seu saldo Stripe”. Para uma conta bancária encerrada, pode levar até 5 dias úteis para o dinheiro voltar para o Stripe. Corrija os dados bancários no Dashboard quando esse e-mail chegar, não quando você notar que o aluguel não caiu.

No celular, o Stripe lista “transferências depositadas” entre os tipos de notificação push do aplicativo.

Você deveria receber um e-mail para todo pagamento bem-sucedido?

Não. Desative, ao menos para você mesmo.

Os e-mails de pagamento bem-sucedido são os barulhentos, e o barulho tem um custo que nunca aparece numa fatura. Receba quarenta e-mails de “pagamento recebido” do Stripe por semana e o seu cérebro passa a arquivar o Stripe como boa notícia que pode esperar. Depois o e-mail de disputa chega do Stripe e recebe a mesma olhada rápida, na mesma terça-feira cheia, e se perde embaixo dos próximos três recibos. Todo e-mail de pagamento bem-sucedido treina você a ignorar os e-mails do Stripe, inclusive o que tem um prazo. Se você quer saber o que entrou hoje, os gráficos da página inicial do Dashboard e o resumo diário por push do aplicativo fazem esse trabalho sem tocar na sua caixa de entrada.

Como ativo as notificações de e-mail do Stripe?

No Dashboard, abra as configurações de Dados pessoais e encontre Preferências de comunicação. O Stripe aplica isso por usuário, então cada colega de equipe define as próprias, e qualquer pessoa pode ativar ou desativar qualquer notificação padrão. Ativar disputas para você mesmo não muda nada na caixa de entrada do seu cofundador. Se dois de vocês conseguem responder a uma disputa, os dois deveriam conferir.

No aplicativo, toque no ícone do comerciante no canto superior esquerdo de qualquer tela para abrir Conta e Configurações, vá em Configurações globais, depois Configurações de notificação, e use o interruptor de cada conta de comerciante. Depois permita as notificações do Stripe nas próprias Configurações do seu celular, porque o Stripe diz que o push não funciona sem isso. Os tipos de push do aplicativo são resumo diário, novos pagamentos, novos clientes, pagamentos disputados e transferências depositadas.

Uma nota para desenvolvedores

Se você prefere montar os próprios alertas, os webhooks do Stripe são a ferramenta. Você registra um endpoint HTTPS público (na aba Webhooks do Workbench, ou pela API), escolhe os tipos de evento, e o Stripe envia cada evento para você em JSON em tempo real. Comece com charge.dispute.created e payment_intent.payment_failed. Verifique o cabeçalho Stripe-Signature, retorne um 2xx rapidamente, e espere duplicatas e eventos fora de ordem. No modo live, o Stripe tenta de novo uma entrega que falhou por até três dias, e uma falha na entrega de webhook é, ela mesma, uma das coisas sobre as quais o Stripe pode te mandar e-mail. Deixe esse e-mail ativado, porque a semana em que o seu endpoint de alerta quebra silenciosamente é a semana em que você, de outro jeito, ia descobrir uma disputa pelo seu saldo.

Um e-mail de disputa do Stripe pode me ligar?

Os e-mails de notificação do Stripe podem ir para o Gmail, e é lá que o nosso aplicativo, o OLL.E, pega eles. Você digita uma vigilância como uma frase. Quando uma disputa abre, ou chega um e-mail sobre um pagamento recusado acima do seu valor, ele liga para você e manda um resumo do e-mail, e pode encaminhar o e-mail para o seu cofundador, cujas próprias configurações do Stripe podem estar desativadas. Essa parte funciona no iPhone sem nada extra. Se você depende do push do aplicativo do Stripe em vez disso, celulares Android podem ser vigiados direto e um iPhone precisa do chaveiro PinG.

Ele vê o e-mail que o Stripe te manda, nada mais: nenhum reembolso, nenhum envio de prova, nenhum acesso ao dinheiro. Por isso, uma vigilância de pagamento recusado precisa que um e-mail de pagamento recusado exista primeiro, vindo das suas preferências, de um workflow ou do seu próprio código de webhook.

Mais um motivo para vigiar a caixa de entrada em vez de confiar nas configurações: as preferências de e-mail do Stripe pertencem a cada pessoa, não à conta, então o seu cofundador pode estar recebendo todo e-mail de disputa enquanto você não recebe nenhum, ou o contrário. O OLL.E fecha essa brecha a partir do seu próprio Gmail. Ele liga para você quando um e-mail de disputa chega, manda um resumo curto, e encaminha o e-mail para quem reúne as provas, para que a pessoa com os recibos saiba no mesmo dia. No iPhone, a vigilância de Gmail funciona por completo; os alertas do aplicativo do Stripe ali precisam do PinG. Você pode começar grátis; o plano pago é 19,99 US$ por mês quando você passar de quatro vigilâncias.