Assinaturas

As assinaturas são componentes essenciais de um modelo de negócios que permite que sua empresa ofereça seus produtos ou serviços aos clientes de forma recorrente. O serviço de assinatura da Yuno permite que você gerencie facilmente pagamentos recorrentes, automatize o faturamento de assinaturas e forneça experiências de assinatura perfeitas para seus usuários. Seja executando um aplicativo SaaS, uma plataforma de conteúdo ou uma loja de comércio eletrônico, o serviço da Yuno pode ajudá-lo a lidar com tarefas relacionadas a assinaturas de forma eficiente.

📘

Assinaturas versus credenciais armazenadas

• Assinaturas (esta página): O mecanismo de recorrência do Yuno. Você fornece instruções e frequência uma vez e, em seguida, o Yuno envia automaticamente as transações em seu nome.
• Credenciais armazenadas: Você controla a recorrência. Você é responsável por enviar cada transação de acordo com sua própria programação. Consulte Credenciais armazenadas.

Benefícios de usar as assinaturas Yuno

• Receita recorrente: As assinaturas proporcionam um fluxo de renda estável e previsível, o que pode ajudar a estabilizar o fluxo de caixa e reduzir as incertezas financeiras.
• Fidelidade do cliente: Os assinantes tendem a ser mais fiéis, o que resulta em taxas mais altas de retenção de clientes e redução da rotatividade.
• Redução dos custos de aquisição: As assinaturas reduzem a necessidade de esforços constantes de aquisição de clientes, permitindo que as empresas se concentrem mais em reter e atender aos clientes existentes.

Assinaturas da Yuno

Uma assinatura no ambiente da Yuno pode passar por vários estágios, começando com seu status de criação. Quando uma assinatura é criada, ela recebe automaticamente o status CREATED automaticamente. No entanto, é um status transitório que fica ativo enquanto o pagamento não é processado. Depois disso, a assinatura será ACTIVE ou CANCELLEDdependendo da confirmação do pagamento.

Quando o pagamento relacionado à assinatura é confirmado, o status da assinatura muda para ATIVO. Ele permanece com esse status enquanto a assinatura estiver dentro de seu intervalo de dados de disponibilidade e o cliente pagar as contas. Uma assinatura ativa pode mudar para três status diferentes:

• COMPLETED (CONCLUÍDO): A data de término da assinatura foi atingida. Nesse caso, a assinatura atual é encerrada e não é possível reativá-la. Se o cliente quiser continuar usando seu produto/serviço por meio de pagamentos recorrentes, será necessário criar uma nova assinatura.
• PAUSADA: A qualquer momento, você pode pausar a assinatura. Use essa opção caso seu cliente tenha atrasado um pagamento, por exemplo. Você sempre pode ativar uma assinatura pausada.
• CANCELLED: Se o cliente decidir cancelar o pagamento recorrente, você poderá cancelar a assinatura. Após o cancelamento, a assinatura é encerrada e não é possível reativá-la.

Saiba mais sobre o status da assinatura na página Status da assinatura.

Integração de assinaturas

Para começar a usar o recurso de assinaturas, você precisa de uma conta Yuno e de integração com a API Yuno. A API do Yuno fornece as seguintes operações para gerenciar suas assinaturas:

• Criar: Use o endpoint Criar uma assinatura para assinar um cliente.
• Pausar: Pause uma assinatura ativa com o endpoint Pause Subscription (Pausar assinatura).
• Retomar: Retome uma assinatura previamente pausada com o endpoint Resume Subscription (Retomar assinatura).
• Cancelar: Cancele uma assinatura ativa com o endpoint Cancelar assinatura.
• Recuperar: Use o endpoint Retrieve Subscription (Recuperar assinatura ) para obter os detalhes de uma assinatura.

Novos conceitos

• Assinaturas: Uma assinatura envolve cobranças recorrentes diretamente vinculadas a um cliente e a um método de pagamento específico. Ao interromper ou atualizar, o impacto é exclusivamente sobre o mesmo.
• Métodos de pagamento disponíveis
  • Registrada: Os clientes podem pagar com um método de pagamento registrado anteriormente. Somente o token do cofre é necessário ao criar a assinatura para associá-la às cobranças.
• Recursos:
  • Frequência: Defina a frequência com que as cobranças de assinatura ocorrerão, seja diária, semanal ou mensal, especificando o valor que precisa ser cobrado no próximo ciclo de faturamento.
  • Ciclos de faturamento: O número de ciclos de faturamento (seguindo o critério de frequência) que serão concluídos para cumprir a assinatura. Se não for enviada nem definida uma end_date, continuaremos tentando cobrar até que ela seja interrompida.
  • Data de cobrança: ao especificar o objeto billing_date, o comerciante pode definir a lógica por trás da data exata para a cobrança da assinatura. Esse objeto é mutuamente exclusivo do objeto frequency.
  • Disponibilidade: As datas de início e término da assinatura. Se elas não forem definidas, nem os ciclos de faturamento, as cobranças continuarão até que sejam interrompidas.
    • Os campos billing_cycles e availability.finish_at afetam um ao outro. Se ambos forem concluídos durante a criação da assinatura, ela fará a transição para o estado COMPLETED ao atingir o evento mais próximo definido nesses campos, seja o ciclo de faturamento ou o finish_at correspondente.
  • Períodos de teste: Esse recurso permite que você defina um período em que seus clientes podem se beneficiar de um valor reduzido. Ele pode ser parcial ou total (por exemplo, uma avaliação gratuita). Você precisa determinar o valor a ser reduzido do valor total de cada cobrança de assinatura e os ciclos de faturamento aos quais ele deve ser aplicado.
  • Validação do pagamento inicial: Um sinalizador para identificar se a assinatura deve aguardar o primeiro pagamento para continuar. Falso por padrão. Se o campo for definido como true, a assinatura deverá permanecer no status CREATED enquanto aguarda o primeiro pagamento da assinatura.
    • Se o primeiro pagamento forSUCCEEDED), a assinatura passa a ser ATIVA.
    • Se o primeiro pagamento falharDECLINEDREJECTED), a assinatura passa a ser CANCELADA.

Usando a solução de assinatura Yuno

O Yuno fornece funcionalidades de gerenciamento de assinatura por meio de sua API. Você pode usar essa API para criar, atualizar e gerenciar assinaturas, bem como recuperar detalhes e uso da assinatura.

Para usar a solução de assinatura, normalmente, você seguirá as etapas descritas abaixo:

1. Para começar, crie um cliente. Você precisará fornecer informações pessoais do cliente e o merchant_customer_id, um identificador exclusivo para o cliente usado em seu sistema. Ao concluir o processo de criação do cliente, você receberá um ID que identifica o usuário no sistema Yuno. Esse ID será usado para criar a assinatura.
2. Depois de criar o cliente, você precisará registrar um cartão de crédito para gerar um vaulted_token a ser usado na criação da assinatura.
3. Criar uma assinatura para seu cliente e o cartão registrado. Nesta etapa, você configurará a assinatura e definirá o método de pagamento. Ao criar a assinatura, você pode personalizar:
   • O valor cobrado pela assinatura.
   • A frequência de cobrança (diária, mensal ou anual).
   • O número total de ciclos de faturamento.
   • A disponibilidade da assinatura para definir a data de início e de término.

📘

Métodos de pagamento disponíveis

Atualmente, apenas cartões podem ser usados como métodos de pagamento para assinaturas.

❗️

Pagamentos recusados

Se um pagamento de uma assinatura for recusado (incluindo a primeira tentativa de pagamento), a assinatura continuará sua programação para tentativas de pagamento futuras, dando ao comerciante a possibilidade de cobrar do cliente o valor pendente por meio de um processo diferente e continuar com a assinatura em andamento. Se você quiser cancelar uma assinatura, fique à vontade para usar o endpoint cancelamento de assinatura.

Na resposta ao Criar assinatura você recebe uma mensagem id que é usado para identificar a assinatura criada. Você usará o id se você decidir pausar, retomar ou cancelar a assinatura.