# Pagamentos Recorrentes - Configuração do Gateway Stripe ##### Sumário - [Cancelando Assinaturas](#cancelling) - [Descritores de Declaração de Assinatura](#descriptor) - [Problemas Comuns](#common-issues) Este documento explica como a extensão [Pagamentos Recorrentes](https://easydigitaldownloads.com/downloads/recurring-payments/) funciona com o Stripe. Configurando o Stripe ------------------ É importante seguir todos os passos descritos na [Documentação de Configuração do Stripe](https://easydigitaldownloads.com/docs/stripe/). **Nota Importante de Configuração:** Se os Webhooks não estiverem configurados corretamente, as assinaturas não funcionarão adequadamente! Cancelando Assinaturas ----------------------- Ao usar o Stripe, um cancelamento pode ser iniciado *tanto* dentro do EDD quanto no Painel do Stripe. #### Cancelando como Cliente Os clientes podem cancelar suas próprias assinaturas em [página de conta da sua loja](https://easydigitaldownloads.com/docs/customer-account-page/). #### Cancelando como Administrador do Site Para cancelar uma assinatura no admin do EDD, vá para ***Downloads → Assinaturas*** e clique em *"Ver"* no item que deseja cancelar. Em seguida, na parte inferior da próxima tela, clique em *"Cancelar Assinatura"*. Quando você define o status de uma assinatura como cancelada, ela é cancelada imediatamente, mas o cliente ainda terá acesso ao material comprado pelo tempo pelo qual pagou. Por exemplo, se eles pagaram R$10/mês e você cancela no meio do mês, eles ainda terão acesso ao material pelo resto do mês, mas não serão cobrados novamente e o acesso será interrompido no final do mês. #### Do Painel do Stripe Para cancelar uma assinatura no Painel do Stripe, faça login no Stripe e encontre a barra de pesquisa na parte superior da página. Você pode encontrar clientes pesquisando por: - o ID da cobrança - o ID do perfil da assinatura - o número do ID do cliente EDD - o e-mail do cliente Depois de encontrar e selecionar seu Cliente no Stripe, você verá uma lista de assinaturas. Se você clicar em Cancelar (ícone X ao lado do nome da assinatura), terá três opções; cancelar Imediatamente, no final do período atual ou em uma data personalizada. Para fins de EDD, não importa qual você escolha imediatamente ou no final do período atual, seu cliente não experimentará nenhuma diferença entre os dois. Se você escolher uma data personalizada, que seja após o final do período atual, eles continuarão a ser cobrados até que a data personalizada passe. #### Resumo do Cancelamento Não importa se você cancela uma assinatura no EDD ou no Stripe, o efeito é exatamente o mesmo e o cliente não notará nenhuma diferença. ### Atualizando Informações de Cartão de Crédito/Débito Os clientes podem atualizar as informações do cartão para suas assinaturas específicas em [página de conta da sua loja](https://easydigitaldownloads.com/docs/recurring-payments-managing-subscriptions/#customer). Descritores de Declaração --------------------- Quando um produto é configurado como assinatura, o comportamento do descritor é ligeiramente diferente das compras não assinadas. Quando uma assinatura é comprada pela primeira vez em seu site, um "Produto" é criado no Stripe que será usado para todas as compras subsequentes dessa assinatura específica. Você pode ver sua lista atual de Produtos fazendo login em sua conta Stripe e navegando para *Produtos*. Quando este Produto é criado, um descritor de declaração é criado com base no nome do seu produto, independentemente da configuração mencionada em seu painel do WordPress. O descritor também será em minúsculas e separará as palavras usando hifens. Compreensivelmente, isso não fica bom em um extrato bancário. Existem duas maneiras de alterar esse comportamento que são melhores usadas juntas se você não gosta do comportamento padrão: #### 1. Editar os detalhes do Plano Ao ir para *Produtos* em sua conta Stripe, você pode clicar em qualquer Produto para ver seus detalhes. Uma vez na página de detalhes, clique no botão *Editar detalhes*. Você verá um modal que permite definir o descritor de declaração para esse Produto específico. O que você definir aqui será usado para todos os pagamentos desse plano de assinatura em seu site. #### 2. Filtrar o descritor de declaração padrão para planos Stripe O método acima permite que você controle o descritor de declaração para uma assinatura específica que já existe. Mas se uma nova assinatura for criada a partir da primeira compra de uma assinatura diferente em seu site, o comportamento padrão será aplicado. Isso significa que a nova assinatura ainda terá um descritor de declaração baseado no nome do produto por padrão. Para criar um novo descritor de declaração padrão para todas as assinaturas criadas no futuro (isso não afetará as assinaturas existentes), use o seguinte filtro: ``` function custom_edd_recurring_stripe_plan_statement_descriptor( $args, $subscription ) { $args['statement_descriptor'] = 'New Statement Desc'; return $args; } add_filter( 'edd_recurring_create_stripe_plan_args', 'custom_edd_recurring_stripe_plan_statement_descriptor', 10, 2 ); ``` Substitua `New Statement Desc` pelo seu descritor de declaração padrão preferido (lembre-se do limite de 22 caracteres). Em resumo, use o primeiro método para editar o descritor de declaração para uma assinatura existente. Use o segundo método para definir um novo descritor de declaração padrão para todas as assinaturas futuras. ### Problemas comuns relacionados a webhooks ##### **Clientes são cobrados várias vezes** Se você não configurar seus webhooks do Stripe corretamente antes de um cliente fazer uma compra e estiver usando a opção "Vezes" no EDD Recurring para cobrar o cliente um número definido de vezes (por exemplo, 5 vezes), eles serão cobrados várias vezes. Isso ocorre porque, sem o webhook, o Stripe não consegue informar ao EDD que os pagamentos foram efetuados com sucesso, portanto, o EDD não sabe. Por causa disso, o EDD acha que o cliente ainda não foi cobrado - mesmo que ele já tenha sido cobrado 5 vezes (ou mais). O EDD envia um "cancelar assinatura" para o Stripe automaticamente quando o número de vezes é atingido. Mas como não há webhook, o EDD não sabe que o cliente foi cobrado e nunca cancela a assinatura. Isso resulta no cliente continuando a ser cobrado mesmo após o número definido de vezes ter sido atingido. É por isso que é importante configurar um webhook imediatamente após a instalação da extensão Stripe.