Assinatura - Link de Pagamento - Cartão de Crédito

Título do Fluxo: Fluxo Assinatura com Link de Pagamento (Cartão de Crédito)

Este diagrama mostra o processo de geração e pagamento de uma assinatura utilizando o método de pagamento Cartão de Crédito na plataforma Vindi. Abaixo está a descrição detalhada de cada passo no fluxo, incluindo métodos de autenticação, endpoints e exemplos de parâmetros para requisições.

1. Cliente Realiza a Compra

Descrição: O cliente inicia o processo de assinatura do serviço.

2. Cadastrar o Cliente

Método: POST
Endpoint: /v1/customers
Descrição: Cadastra o cliente na plataforma Vindi.
Exemplo de Parâmetros:

JSON

{
  "name": "Nome do Cliente",
  "email": "[e-mail]",
  "registry_code": "430.967.348-10",
  "address": {
    "street": "R. do Paraíso",
    "number": "148",
    "zipcode": "04103-000",
    "neighborhood": "Liberdade",
    "city": "São Paulo",
    "state": "SP",
    "country": "BR"
  },
  "phones": [
    {
      "phone_type": "mobile",
      "number": "5511991468778"
    }
  ]
}

3. Criar Assinatura

Método: POST
Endpoint: /v1/subscriptions
Descrição: Cria uma assinatura para o cliente cadastrado e gera a fatura.
Exemplo de Parâmetros:

JSON

{
  "plan_id": 12345,
  "customer_id": 873101,
  "payment_method_code": "credit_card",
  "subscription_items": [
    {
      "product_id": 88171,
      "amount": 150,
      "description": "Teste Vindi assinatura R$5,90"
    }
  ]
}

4. Enviar Link de Pagamento

Descrição: A Vindi retorna os dados da assinatura e o link de pagamento (parâmetro: URL).
Notas: O link para pagamento da fatura é retornado na resposta da requisição de criação da assinatura.

Processamento do Pagamento

Pagamento Rejeitado

Descrição: Se o pagamento for rejeitado, a Vindi envia um webhook "Cobrança Rejeitada" e pode tentar novamente após 3 dias.
Endpoint Webhook: Cobrança Rejeitada
Notas: Uma notificação opcional pode ser enviada ao cliente informando que o pagamento foi rejeitado.

Pagamento Aprovado

Descrição: Se o pagamento for aprovado, a Vindi processa a baixa na fatura e envia um webhook "Fatura Paga".
Endpoint Webhook: Fatura Paga

Resumo das Requisições:

1. Cadastrar Cliente:

   • Método: POST
   • Endpoint: /v1/customers
   • Exemplo de Parâmetros:
     JSON

     {
       "name": "Nome do Cliente",
       "email": "[e-mail]",
       "registry_code": "430.967.348-10",
       "address": {
         "street": "R. do Paraíso",
         "number": "148",
         "zipcode": "04103-000",
         "neighborhood": "Liberdade",
         "city": "São Paulo",
         "state": "SP",
         "country": "BR"
       },
       "phones": [
         {
           "phone_type": "mobile",
           "number": "5511991468778"
         }
       ]
     }
     

2. Criar Assinatura:

   • Método: POST
   • Endpoint: /v1/subscriptions
   • Exemplo de Parâmetros:
     JSON

     {
       "plan_id": 12345,
       "customer_id": 873101,
       "payment_method_code": "credit_card",
       "subscription_items": [
         {
           "product_id": 88171,
           "amount": 150,
           "description": "Teste Vindi assinatura R$5,90"
         }
       ]
     }
     

Notas Adicionais:

• Webhook "Assinatura Criada": Usado para notificar a criação da assinatura.
• Webhook "Cobrança Rejeitada": Usado para notificar que o pagamento foi rejeitado. Opcionalmente, o sistema pode reenviar o link de pagamento ao cliente.
• Webhook "Fatura Paga": Usado para notificar que a fatura foi paga com sucesso.
• Notificação de Pagamento: Se o pagamento não for identificado, o cliente é notificado com opções para tentar novamente com outro método de pagamento.

Estas descrições ajudam a entender como realizar a atividade de emissão e pagamento de assinaturas via Cartão de Crédito, conforme ilustrado no diagrama.