Dúvidas Frequentes: Como funciona o módulo de assinaturas?

Este tópico tem por objetivo fomentar o conhecimento na comunidade, principalmente no que tange ao módulo de assinaturas.

O Sistema de Assinaturas é uma aplicação desenvolvida pela VTEX para facilitar as vendas recorrentes. Funciona como um agendador automático, realizando uma recompra na frequência solicitada pelo cliente da loja.

Por meio desta aplicação, o seu cliente indica a periodicidade que deseja repetir a compra de um determinado item, e o sistema refaz o pedido de compra. Essa compra é feita automaticamente, a cada período agendado, com as mesmas características configuradas no pedido original.

Cabe ressaltar que a instalação do módulo Assinaturas é feita por meio de solicitação ao nosso Suporte.

Sobre o Módulo de Assinaturas:

Após a instalação, as opções contidas dentro desse módulo ficam localizadas dentro do módulo de pedidos:

Nós temos uma documentação detalhada sobre todas as opções contidas nas abas do “Dashboards” que permitem realizar o gerenciamento das assinaturas, com a funcionalidades contidas em cada uma das abas, Assinaturas Únicas, Pedidos de Assinatura, e Assinantes no seguinte local:

Observação importante: Na aba “Assinantes” existe a opção “Personificar” essa opção permite que sejam realizadas edições na Assinatura de cada cliente, como alterar a frequência de assinatura, alterando a data do ciclo de assinatura (data em que os pedidos são criados) e o status dela. Entretanto, somente usuários o perfil de acesso “957 Call center operator” podem utilizar o botão “Personificar”:

Pedidos que geram assinaturas :x: Pedidos de assinaturas:

Existem diferenças entre ambos os pedidos. Os pedidos que geram as assinaturas não são considerados pedidos de assinaturas em si, isso porque aqui na nossa plataforma pedidos de assinatura são aqueles que foram realizados automaticamente pela nossa aplicação, o que não ocorre com o pedido que gera as assinaturas, já que ele é feito por ação do comprador.

Pedido que geram assinaturas:

Nos pedidos que geram as assinaturas é possível verificar se de fato a assinatura foi gerada corretamente ou se ocorreram erros durante esse processo, para isso é necessário buscar pelo pedido que gerou as assinaturas no módulo de Pedidos e clicar em “Ver interações”:

Dentre os logs do pedido existirão logs do SubscriptionCreationConsumerBackgroundService que registrarão a criação dessa assinatura e do Id dela (este Id é necessário para o uso de quase todas as APIs atreladas ao módulo).

Caso ocorra algum erro no processo de criação da assinatura, este será indicado neste mesmo local.

Além disso, outra diferença do pedido que gera a assinatura para os demais realizados automaticamente pela nossa aplicação ocorre ao realizar o comando Get order via API, isso porque nos pedidos que geraram as assinaturas o campo SubscriptionGroupId não possui o Id da assinatura:

Entretanto, ele é apresentado apenas quando o mesmo comando Get order é dado a algum outro pedido realizado automaticamente pela nossa aplicação:

Ciclos com problemas

Sabemos que eventualmente alguns ciclos de assinatura podem apresentar problemas, por esse motivo temos uma documentação no nosso Help Center, que exemplifica diversos erros que podem ocorrer e como solucionar cada um deles:

Caso você tenha dúvidas sobre como fazer o gerenciamento das assinaturas da sua loja, recomendo a leitura deste outro tópico aqui na community: Dúvidas Frequentes: Como gerenciar assinaturas via API?

Caso ainda tenha alguma dúvida sobre o assunto, sinta-se à vontade para perguntar por aqui! :smiling_face:

Karina Mota
Field Software Engineer | VTEX

3 Likes

Olá @KarinaMota, tudo bem?

Como nem todos conectores que funcionam com a VTEX aceitam pagamentos recorrentes utilizado cartões tokenizados (sem o CVV), atualmente, quais seriam os conectores homologados que permitem assinatura usando cartão de crédito na VTEX?

Em meados de 2021 me informaram que os conectores que transacionam pedidos de assinatura na VTEX, seriam:

  • Egetnet
  • Adyen
  • VTEX Payment
  • E-Rede V2
  • MaxiPagoV3
  • MaxiPagoV4
  • BrasPag
  • CieloV3
  • MercadoPagoV1
  • PayU
  • MoipV2
  • Mundi
  • Payzen
  • ERedeRest

Existe alguma listagem mais atualizada?

Obrigado.

Olá @andremiani, desculpe pela demora, mas precisei checar com o time responsável para te passar informações atualizadas.

Nosso time está trabalhando no mapeamento desses conectores, mas por agora consigo trazer alguns que sabemos que podem ser utilizados, são eles: Vindi, Pay2b, Pagbrasil e Braspag.