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

Uma disputa na Stripe vem com um prazo, e é curto. A própria documentação da Stripe diz que tem uma janela limitada para responder, «normalmente 7 a 21 dias, dependendo da rede do cartão», e que se a perder «perde automaticamente a disputa e não consegue recuperar os fundos disputados». De todas as notificações da Stripe que pode ativar, essa é a que custa dinheiro quando fica por ler.

Se preferir que o e-mail de disputa da Stripe fizesse o seu telemóvel tocar, a via do e-mail funciona num iPhone; os alertas push da aplicação Stripe aí precisam de um relé Bluetooth.

A Stripe avisa-o de disputas?

Sim, em quatro sítios. A página de disputas da Stripe lista o seu endereço de e-mail, o Painel, um evento charge.dispute.created se a sua integração escutar eventos, e uma notificação push da aplicação móvel se estiver subscrito. As disputas também estão na lista predefinida de e-mails que cada membro da equipa pode ativar ou desativar, e essa parte por pessoa importa mais do que parece.

Dois detalhes da mesma página mudam a rapidez com que deve agir.

Algumas disputas começam como consultas, uma fase anterior à disputa que normalmente surge quando o titular do cartão não reconhece uma cobrança. A Stripe diz que responder nessa fase pode impedir uma disputa formal e poupa «tempo, taxas, e a sua classificação junto das redes de cartões». Se ainda assim escalar, responde outra vez.

E só tem uma oportunidade. «Só tem uma oportunidade de submeter a sua resposta», escreve a Stripe, e depois de enviada não a pode editar nem acrescentar ficheiros. Por isso o prazo não é realmente 7 a 21 dias para responder. São 7 a 21 dias para desenterrar a fatura, os e-mails do cliente, a sua política de reembolso e o que quer que prove que o trabalho foi entregue. Depois combina-os em ficheiros dentro do limite de 4,5 MB da Stripe e responde. Para um fundador de SaaS essa prova costuma ser registos de utilização. Para um freelancer é o contrato e a mensagem em que o cliente disse que o trabalho parecia ótimo.

Contestar também não é gratuito. A Stripe cobra uma taxa de disputa contestada por cima da taxa de disputa recebida e só devolve a taxa de contestação se ganhar. O banco pode demorar até 3 meses a decidir, e a Stripe envia-lhe um e-mail quando o faz. Se também aceita o PayPal, as disputas dele correm noutro relógio, coberto em notificações do PayPal.

A Stripe envia uma notificação de pagamento falhado?

Ao seu cliente, sim, se o ativar. A si, depende do que a sua conta oferece, e é aqui que as pessoas se confundem.

A definição que a maioria encontra primeiro é Enviar e-mails quando os pagamentos por cartão falham, na página de e-mails de recuperação de receita. A Stripe é clara sobre quem a recebe: «envia automaticamente um e-mail ao seu cliente depois de cada pagamento falhado» para que atualize o cartão. Bom para subscrições. Não faz nada para lhe dizer que uma renovação anual de 2000 $ acabou de falhar.

A lista publicada da Stripe de e-mails que lhe envia cobre pagamentos bem-sucedidos, disputas, pagamentos marcados como arriscados pela Stripe ou por uma regra do Radar, taxas de aplicação de contas ligadas, menções em notas, faturas pagas com o valor errado e entregas de webhook falhadas. Os pagamentos falhados não estão nessa lista. A Stripe também diz que a lista completa vive nas suas próprias Preferências de comunicação, por isso veja lá antes de decidir alguma coisa. Se não for oferecida, há duas vias. O Stripe Workflows começa a partir de um gatilho e pode enviar um e-mail a um membro da equipa (o exemplo da Stripe envia um e-mail a alguém quando um pagamento acima de 1000 $ é bem-sucedido), por isso verifique se um gatilho de falha está disponível na sua conta. Ou um programador pode apanhar a falha com um webhook, coberto na nota para programadores abaixo.

Notificações de pagamento da Stripe

Um pagamento que chega não precisa de alarme. O seu banco diz-lhe. Um pagamento que falha é diferente. Se o seu banco não conseguir processar um pagamento, o FAQ de pagamentos da Stripe diz que pode receber um e-mail com o assunto «Ação necessária para retomar os pagamentos do seu saldo Stripe». Para uma conta bancária encerrada, o dinheiro pode demorar até 5 dias úteis a voltar para a Stripe. Corrija os dados bancários no Painel quando esse e-mail chegar, não quando notar que o aluguer não foi cobrado.

No telemóvel, a Stripe lista «transferências depositadas» entre os tipos de notificação push da aplicação.

Deve receber um e-mail por cada pagamento bem-sucedido?

Não. Desligue-o, pelo menos para si.

Os e-mails de pagamento bem-sucedido são os ruidosos, e o ruído tem um custo que nunca aparece numa fatura. Receba quarenta e-mails de «pagamento recebido» por semana da Stripe e o seu cérebro arquiva a Stripe como boas notícias que podem esperar. Depois o e-mail de disputa chega da Stripe e recebe o mesmo olhar de meio segundo, na mesma terça-feira ocupada, e deslizou para debaixo dos próximos três recibos. Cada e-mail de pagamento bem-sucedido treina-o a ignorar os e-mails da Stripe, incluindo o que tem um prazo. Se quiser saber o que entrou hoje, os gráficos da página inicial do Painel e o resumo diário por push da aplicação fazem esse trabalho sem tocar na sua caixa de entrada.

Como ativo as notificações por e-mail da Stripe?

No Painel, abra as suas definições de Dados pessoais e encontre Preferências de comunicação. A Stripe aplica isto por utilizador, por isso cada colega define as suas próprias, e qualquer pessoa pode ativar ou desativar qualquer notificação predefinida. Ativar as disputas para si não faz nada à caixa de entrada do seu cofundador. Se os dois conseguem responder a uma disputa, os dois devem verificar.

Para a aplicação, toque no seu ícone de comerciante no topo esquerdo de qualquer ecrã para abrir Conta e Definições, vá a Definições globais, depois Definições de notificação, e use o interruptor para cada conta de comerciante. Depois permita as notificações da Stripe nas próprias Definições do seu telemóvel, porque a Stripe diz que o push não funciona sem isso. Os tipos de push da aplicação são resumo diário, novos pagamentos, novos clientes, pagamentos disputados e transferências depositadas.

Uma nota para programadores

Se preferir construir os seus próprios alertas, os webhooks da Stripe são a ferramenta. Regista um endpoint HTTPS público (na aba Webhooks no Workbench, ou através da API), escolhe os tipos de evento, e a Stripe envia-lhe cada evento como JSON em tempo real. Comece com charge.dispute.created e payment_intent.payment_failed. Verifique o cabeçalho Stripe-Signature, devolva um 2xx rapidamente, e espere duplicados e eventos fora de ordem. Em modo real a Stripe repete uma entrega falhada durante até três dias, e uma entrega de webhook falhada é em si uma das coisas sobre que a Stripe pode enviar-lhe um e-mail. Mantenha esse e-mail ativado, porque a semana em que o seu endpoint de alerta se avaria em silêncio é a semana em que de outra forma ficaria a saber de uma disputa pelo seu saldo.

Um e-mail de disputa da Stripe consegue ligar-me?

Os e-mails de notificação da Stripe podem ir para o Gmail, e é aí que a nossa aplicação, o OLL.E, os apanha. Escreve uma vigilância como uma frase. Quando uma disputa abre, ou chega um e-mail sobre um pagamento falhado acima do seu valor, liga-lhe e envia um resumo do e-mail, e pode reencaminhar o e-mail ao seu cofundador, cujas próprias definições da Stripe podem estar desligadas. Essa parte funciona no iPhone sem nada extra. Se depender do push da aplicação Stripe em vez disso, os telemóveis Android podem ser vigiados diretamente e um iPhone precisa do porta-chaves PinG.

Só vê o e-mail que a Stripe lhe envia, nada mais: sem reembolsos, sem envio de provas, sem acesso ao dinheiro. Por isso, uma vigilância de pagamento falhado precisa que exista primeiro um e-mail de pagamento falhado, a partir das suas preferências, de um workflow ou do seu próprio código de webhook.

Mais uma razão para vigiar a caixa de entrada em vez de confiar nas definições: as preferências de e-mail da Stripe pertencem a cada pessoa, não à conta, por isso o seu cofundador pode estar a receber todos os e-mails de disputa enquanto você não recebe nenhum, ou o contrário. O OLL.E fecha essa lacuna a partir do seu próprio Gmail. Liga-lhe quando um e-mail de disputa chega, envia um resumo curto, e reencaminha o e-mail para quem reúne as provas, para que a pessoa com os recibos saiba disso no mesmo dia. No iPhone a vigilância de Gmail funciona por completo; os alertas da aplicação Stripe aí precisam do PinG. Pode começar grátis; o plano pago é 19,99 US$ por mês quando ultrapassar quatro vigilâncias.