Pular para o conteúdo principal

Pagamentos PicPay

  • Atualizado

Índice:

  1. Introdução
  2. Como funciona?
  3. Instalação e configuração
  4. Exemplos de uso
  5. Suporte

Introdução

A/O Pagamentos PicPay  é uma extensão que permite de maneira rápida e simples a disponibilização do meio de pagamento Picpay no contato inteligente.  

 

Por exemplo: É possível disponibilizar ao usuário link de pagamento PicPay e verificar o histórico de transações ocorridas no bot pela própria extensão.

 

Observação: Extensão disponível apenas em português!

 

Como funciona?

A/O Payment Module PicPay apresenta as seguintes funcionalidades:

  • Criação de link de pagamentos
  • Relatório de transações efetuadas no bot

 

Ela é suportada nos seguintes canais: WhatsApp



Instalação e configuração

Ao ativar a extensão pela Blip Store, ela deverá ser instalada no bot ROTEADOR com o canal do WhatsApp habilitado. Após sua ativação, você deverá seguir os passos abaixo para o correto funcionamento.

 

  1.  Criar um bot que deverá ser utilizado para o fluxo de pagamentos.

Esse subbot será utilizado pela extensão para publicar o fluxo de pagamentos que será utilizado pela API de integração. 

  • Nome sugerido para o bot: Bot Pagamentos PicPay. 
  • Nome sugerido para o serviço no roteador: picpay

Será necessário apenas criar o bot, HABILITAR CONTEXTO DO ROTEADOR, publicar o fluxo já existente,  e conectá-lo como serviço no roteador. 

[Figura 1] - Configurar contexto do roteador



[Figura 2] - Publicar fluxo

 

Por último, configure o serviço no seu roteador. 

 

  1. Acessar a extensão de Pagamentos PicPay

Inserir as credenciais do PicPay e escolher o subbot criado anteriormente para publicação do fluxo de pagamentos, após isso é só clicar em conectar. Ao clicar em conectar, o fluxo de pagamentos será adicionado ao subbot selecionado.

[Figura 3] - Tela Inicial da Extensão

As credenciais do PicPay você obterá na sua conta do PicPay Empresas

[Figura 4] - Obter credenciais PicPay

 

  1. Configurar o redirecionamento do fluxo existente para o subbot.

Lembrando que a inclusão de um método de pagamento novo demandará uma adaptação ao fluxo do contato inteligente, como por exemplo um menu de opções para escolha do método de pagamento pelo usuário.

Para enviar o usuário do seu fluxo para o subbot de pagamentos, será necessário criar um redirecionamento que enviará o seguinte objeto como mensagem:

 

{

  "origin": "nomeDoServicoAtual", //fluxo que envia o usuario

  "destination": "picpay", //nome do servico do subbot

  "userInput": "inputDoUsuario", //ultimo input do usuario

  "custom": {

    "picpay": {

      "firstName": "PRIMEIRO NOME", //primeiro nome do usuario

      "lastName": "ULTIMO NOME", //sobrenome do usuario

      "cpf": "01234567890", //cpf do usuario

      "amount": 1.99  //valor da transacao a ser criada

    }

  },

  "callback": {

    "serviceName": "servicoAposPagamento" //nome do servico que o usario devera ser redirecionado na volta do pagamento

  }

}

 

Este objeto deve ser gerado por meio de uma ação de Executar Script que deve ser executada antes da ação de Redirecionar a um serviço.

 

Exemplo de script para construir o objeto:

function run(input,firstName,lastName,cpf,valor) {

    let obj = {

        "origin": "main",

        "destination": "payments",

        "userInput": input,

        "custom": {

            "picpay": {

                "firstName": firstName,

                "lastName": lastName,

                "cpf": cpf,

                "amount": parseFloat(valor)

            }

        },

        "callback": {

            "serviceName": "main"

        }

    };

    return obj;

}

Este script recebe as variáveis de entrada:

  • input.content
  • firstName
  • lastName
  • cpf
  • valor

Com exceção de input.content, as variáveis precisam ser definidas em algum momento do fluxo de conversa com o seu cliente; a variável valor precisa ser enviada como formato float no objeto.

 

Considerando que a variável de retorno do script acima será objService, você pode configurar o redirecionamento para o serviço da seguinte forma:



Quando o usuário for redirecionado de volta, após o pagamento ter obtido sucesso ou não, ele será redirecionado para o serviço adicionado ao callback com a seguinte mensagem:

{

  "origin": "open-finance-blip",

  "destination": "servicoAposPagamento",

  "userinput": "inputDoUsuario",

  "custom": {

    "picpay": {

      "Success": "true",

      "FailReason": ""

    }

  }

}


Essa mensagem permitirá que você trate da melhor maneira cada situação de retorno do fluxo de pagamento.

 

  1. Acompanhar as vendas realizadas pelo bot

À partir do momento que está tudo configurado, seu contato inteligente já está apto a vender utilizando o método de pagamento PicPay por meio da extensão.

Você poderá acompanhar as transações que ocorrerão no bot pela extensão.

[Figura 5] - Tela de relatório da extensão

 

Exemplos de uso

  • Conexão com sua conta PicPay
  • Acesse a Extensão:

 

Insira as credenciais e escolha o bot anteriormente publicado, de acordo com o tópico de instalação.

 

Após conectar, a tela automaticamente mudará para o relatório de transações, onde você poderá acompanhar as transações que são realizadas no contato inteligente. A extensão não mostrará todas as vendas realizadas com sua conta PicPay, apenas aquelas realizadas pelo CI.

 

Suporte

Em caso de dúvidas ou se encontrar algum problema com a extensão, entre em contato conosco pelo número (31)3349-6201.


Para mais informações, acesse a discussão sobre o assunto em nossa comunidade ou os vídeos no nosso canal. 😃

Artigos relacionados