Se não for direcionado automaticamente, clique aqui.

Tire suas dúvidas sobre o Moip Assinaturas

O Moip Assinaturas é uma solução do Moip que permite você fazer cobranças de forma automática, no valor e intervalo que escolher por meio da criação de planos. Pelo Moip Assinaturas é possível gerenciar mensalidades, assinaturas e cobranças recorrentes, podendo ser utilizado desde para a cobrança de assinaturas de conteúdo até para a cobrança de utilização de softwares.
Sim. você determina o valor e o intervalo da cobrança e o Moip Assinaturas cuida do resto, de forma automática.
As taxas cobradas no Moip Assinaturas, são as mesmas taxas de Cartão de Crédito (a vista) cobradas na Conta Moip do vendedor.
Para saber mais sobre as taxas do Moip clique aqui.
Sim. Sendo um produto do Moip, você pode utilizar o seu login do Moip para utilizar essa solução.
Para saber mais informações e solicitar acesso, envie um email para assinaturas@moip.com.br
Você pode realizar todas as ações e consultas do Moip Assinaturas por meio de nossas APIs ou então acessando assinaturas.moip.com.br.
O Sandbox é o ambiente de testes do Moip Assinaturas, você o utilizará para iniciar sua integração e se certificar de que a mesma funcionará de acordo com suas necessidades (não é necessário utilizar dados reais nesse ambiente).
Já o ambiente de Produção, é o ambiente real, onde você criará suas assinaturas verdadeiras e serão executadas cobranças reais. Para acessar seu ambiente de produção, será necessária a solicitação da homologação de sua integração. Para maiores informações sobre a homologação, clique aqui.
Os planos são o equivalente aos produtos para uma assinatura. Por meio da criação de planos você, vendedor, determina o valor a ser cobrado e o intervalo da cobrança para seus clientes escolherem a melhor opção em seu site, por exemplo.
O ideal é você cadastrar um plano para cada opção para seus clientes. Por exemplo: você possui um plano de hosdagem de 5gb, 10gb e 30gb com cobranças mensais ou trimestrais. Assim, você cadastraria 6 planos: um de 5gb mensal, um de 5b trimestral e por aí vai. Atenção: caso o valor da assinatura altere muito de cliente para cliente (por exemplo, no caso de frete), recomendamos utilizar um valor variável na hora da criação da assinatura.
Não. Um plano que possuir uma assinatura vinculada não pode ter suas informações sensíveis (valor e intervalo) alteradas. Nesse caso recomendamos a criação de um novo plano com o valor atualizado.
O Trial é uma função que permite oferecer um período inicial gratuito para uma nova assinatura, ele é ideal para serviços online, como conteúdo digital ou jogos, que desejam oferecer um período de testes para novos usuários.
O Trial deve ser configurado no plano que o site irá oferecer para os assinantes, o período gratuito é determinado em total de dias, assim, se você oferece um trial de 30 dias, as novas assinaturas criadas no seu plano, só serão cobradas após 30 dias de atividade.
Sim. O Trial pode ser ativado ou desativado a qualquer momento, além disso, é possível também alterar o número de dias que o trial terá. Ambas as alterações são possíveis via interface ou API de Planos. É importante observar que, a alteração das configurações de trial em um plano, não afeta assinaturas já criadas para aquele plano.
É possível configurar uma taxa de adesão a ser cobradas em todas as assinaturas criadas para um plano. Essa taxa sera sempre cobrada no momento da criação das assinaturas. Assim, se um plano tem um valor de R$10,00 e uma taxa de adesão de R$5,00, quando uma assinatura for criada, ela terá a primeira cobrança no valor de R$15,00 e as demais recorrências terão o custo de R$10,00.
IMPORTANTE: Planos com taxa de adesão SEMPRE geram cobranças imediadamente após a criação das assinaturas, inclusive em casos onde a assinatura tem trial habilitado.
Sim. Isso torna mais fácil para você depois gerenciá-los e vender seus planos para eles, já que estarão previamente cadastrados.
Sim. Um cliente pode ter quantas assinaturas forem necessárias.
Sim. Caso o cartão de um cliente esteja sem saldo, ou bloqueado, existe a opção de substituí-lo por outro cartão. Você pode fazer isso diretamente na interface do Moip Assinaturas, ou através de nossa API.
Uma assinatura é o contrato de um plano por um cliente. O Moip Assinaturas sabe o momento de fazer uma cobrança automática baseado nas informações de uma assinatura.
As assinaturas funcionam em um modelo pré-pago. Ou seja, o primeiro pagamento é feito no ato da contratação da assinatura.
Não. Você precisa sempre vincular um cliente a um plano para criar uma assinatura.
Sim. Utilizando a nossa API, você pode criar assinaturas para clientes novos ou pré-existentes com valores diferentes ao da Assinatura. Com isso, você pode por exemplo, incluir o frete da assinaturas de um produto. Importante lembrar que o intervalo sempre vai respeitar o que está configurado no plano vinculado. Obs: Por questões de segurança, não é possível enviar valores variáveis de assinaturas através do .js.
Sim. Você pode alterar o plano vinculado a uma assinatura para oferecer um upgrade ou downgrade aos seus clientes. A alteração será válida a partir da próxima fatura. Importante: não recomendamos alterar o plano vinculado de uma assinatura para outro com intervalo diferente (por exemplo, de um plano anual para um plano mensal). Nesse caso, é recomendado criar uma nova assinatura e suspender a anterior.
Sim. Você pode alterar o valor a ser cobrado na sua assinatura caso você utilize um modelo de negócios baseado em consumo por exemplo, porém, é importante ter em mente que sua aplicação precisará ter a lógica que enviará as alterações ao Moip Assinaturas com os valores corretos. Além disso, lembramos que o Moip Assinaturas utiliza um modelo pré-pago de cobranças, com isso, sempre é feita a primeira cobrança no momento da criação da assinatura.
Sim. É possível adiantar ou postergar a data de cobrança de uma assinatura via interface ou API. Entretanto, a data das cobranças seguintes terão como base a data da criação da assinatura, e não a data da última cobrança. Assim, supondo que você crie um assinatura mensal no dia 15 de Janeiro, e no segundo mês você adiante o pagamento para o dia 10, no terceiro mês o pagamento será processado no dia 15, conforme data de criação da assinatura.
  1. Active (ativa)
    • A assinatura está ativa, ou seja, o cliente assinante será cobrado a cada ciclo.

  2. Suspended (suspensa)
    • As cobranças da assinatura estão suspensas, ou seja, o cliente assinante não será cobrado a cada ciclo.

  3. Expired (expirada)
    • A assinatura está expirada, ou seja, já atingiu o limite de cobranças configuradas no plano contratado e não gerará mais cobranças.

  4. Overdue (atrasada)
    • A assinatura está com o pagamento de sua fatura atrasada e entrou no fluxo de retentativas. Para saber mais sobre retentativas de pagamentos, clique aqui.

  5. Canceled (cancelada)
    • A assinatura foi cancelada e não poderá mais ser reativada ou editada de nenhuma maneira. Em outras palavras, o cancelamento é a inativação definitiva de uma assinatura.

No Sandbox do Moip Assinaturas, você pode simular a cobrança de uma assinatura e o status dessas cobrança. Basta criar um cliente e no campo Nome colocar:

Autorizar - Para simular pagamentos autorizados.

EmAnalise - Para simular pagamentos que esteja em análise pelo Moip.

Cancelar - Para simular pagamentos cancelados.

Você também pode utilizar o simulador via API, leia o tópico de integração aqui.

Atualmente o Moip Assinaturas permite o pagamento com os Cartões de Crédito nas bandeiras Visa e MasterCard.
Não. Apesar de planejarmos incluir essa opção de pagamento em breve, estimulamos os pagamentos com cartão de crédito uma vez que eles podem ser feitos de maneira automática, sem ação do cliente.
O Moip Assinaturas utiliza um novo sistema feito especialmente para pagamentos recorrentes que, entre as diversas vantagens, permite a realização de pagamentos sem o código de segurança, simplificando o processo de pagamento para você e para seu cliente.
Não. No momento o Moip Assinaturas só processa pagamento de cartões de crédito emitidos para pessoa física. Contudo, se o seu cliente for uma empresa, ela pode realizar o pagamento com o cartão corporativo de um colaborador.
  • Assinante: Sim, a qualquer momento você pode solicitar o reembolso de um pagamento junto ao fornecedor de sua assinatura.
  • Vendedor: Basta acessar sua conta Moip, localizar o pagamento em questão, e clicar na opção para reembolsar o pagador, disponível nos detalhes do pagamento.
Sim. O Moip permite que você reprocesse uma transação que tenha sido cancelada, desde que a fatura e a Assinatura relacionadas com essa transação estejam no status “Atrasada”. Além disso você pode configurar retentativas automáticas que o Moip processará sem que seja necessária uma solicitação sua.
O Moip Assinaturas limita o número de retentativas diárias a um máximo de 3 tentativas por fatura/dia, independente do tipo de retentativa ser automático ou manual.
Você pode fazer solicitar uma retentativa manual de duas maneiras, via interface do Moip Assinaturas (assinaturas.moip.com.br) ou via API. Para enviar uma retentativa manual, basta acessar a interface do Moip Assinaturas, entrar na assinatura e na fatura em atraso e clicar no ícone de retentativa.
O Moip Assinaturas oferece uma feature de retentativas automáticas, que permite ao lojista configurar até 3 cobranças automáticas com um interválo máximo de 28 dias entre a tentativa original de e a última retentativa.
A configuração permite ao vendedor determinar os intervalos de retantativas entre 1, 3, 5 e 7 dias após a tentativa anterior.
Após todas as retentativas serem efetuadas, a assinatura é suspensa.
Para configurar a rententativa automática acesse o menu configurações, na aba retentativas, selecione suas preferências nas caixas de opções e salve suas preferências.
Para efetuar uma retentativa manual, a assinatura e a fatura cobradas devem ter o status atrasada. Lembrando que ambas permanecem com esse status somente enquanto a assinatura estiver no fluxo de retentativas automáticas.
O status “atrasada” na assinatura e na fatura, ficará disponível de acordo com suas configurações de retentativa automática. Caso todas as tentativas de pagamento sejam canceladas, a assinatura será “suspensa” e a fatura terá seu status modificado para “não pago”. Caso uma das tentativas obtenha sucesso, a assinatura voltará para o status “ativo” e a fatura terá o status “pago”.
Sim, O moip-assinaturas.min.js é uma biblioteca JavaScript feita para facilitar a integração do Moip Assinaturas com o seu site, com isso, você poderá desenvolver o fluxo de contratação dos planos da forma ideal para seu negócio. Além de possuir uma estrutura e validações pré-definidas, utilizando essa biblioteca você também reduz o seu escopo para o PCI, uma vez que os dados de cartão de crédito vão direto do navegador do seu cliente para o Moip.
Você pode ver a documentação completa no link abaixo. Documentação JavaScript
No Sandbox do Moip Assinaturas, você pode simular a cobrança de uma assinatura e o status dessas cobrança. Basta enviar para a URI abaixo um POST com o JSON de assinatura (lembre-se que o ID da assinatura não pode ser o mesmo de uma assinatura já existente) e substituir o node customer.fullname por Autorizar, EmAnalise ou Cancelar, de acordo com o necessário. http://sandbox.moip.com.br/assinaturas/v1/subscriptions?new_customer=true
Caso queira utilizar um cliente já existente, retire o ?new_customer=true do final da URI, e use no JSON o id de um cliente já criado.
O authorization que o Moip Assinaturas enviará é o mesmo mostrado no menu configurações na área logada do Moip Assinaturas.
É possível entrar no seu cógido, pegar seu token e enviar requisicões ao Moip, mas esse seria o mesmo resultado de alguém que fizesse uma compra teste por exemplo. Seria uma requisição criada e cancelada, e dependendo do preenchimento ela sequer seria enviada ao Moip. Além disso, o recebimento de requisições seria impossível, uma vez que só o lojista tem acesso à URL de notificação.
Para configurar a URL com para a qual o Moip Assinaturas deve enviar as notificações, acesse a área administrativa do Moip Assinaturas e no Menu “Configurações”, informe a nova URL.
Durante a integração de seu Site com o Sandbox do Moip Assinatuas, certifique-se de que seu processo de compras cumprem os requisitos de necessários contidos no nosso checklist de homologação. Depois, basta clicar no botão Produção na interface do Moip Assinaturas, a página seguinte abrirá o formulário de homologação. Preencha as informações necessárias e clique no botão enviar. Nossa equipe de integração receberá sua solicitação e após executar alguns testes de compra em seu Site, te enviará uma resposta.

Se você tiver alguma dúvida ou sugestão sobre nossas APIs e documentação, ficaremos muito felizes em ajudá-lo. Por favor, escreva um email para integracao@moip.com.br.