Configurando integração URA com Pagar.me

444 Visualizações
4, janeiro de 2021
Henrique Souza

Pré-requisito.

Para utilizar esse recurso é necessário que as aplicações Tactium IP e CRM estejam instaladas e que haja canais de URA disponíveis. Outro pré-requisito importante é que a API do Pagar.me esteja na versão versão 4 – 2019-09-01.

Objetivo

Este documento tem como objetivo o entendimento de como realizar as configurações necessárias para integrar com a Web API do Pagar.me obtendo informações através do Tactium Manager e realizando os pagamentos através da URA do Tactium IP.

Modo privilegiado Tactium CRM

Deverá ser criada uma ficha de atendimento com o nome físico “FCH_COMERCIAL” nesta ficha deverá ser criadas duas abas “DADOS DO PAGAMENTO” para informações relacionadas ao envio e a “DADOS DE COBRANÇA” relacionadas aos dados de Pagamento.

Para habilitar o Campo nome físico é necessário habilitar o modo privilegiado no Manager Desktop. Ao acessar o Menu opções clique em Modo privilegiado, será apresentada uma tela solicitando a senha de acesso ao modo privilegiado: PRV30CB

Modelagem CRM

Deverá ser criada uma ficha de atendimento com o nome físico “FCH_COMERCIAL” nesta ficha deverá ser criadas duas abas “DADOS DO PAGAMENTO” para informações relacionadas ao envio e a “DADOS DE COBRANÇA” relacionadas aos dados de Pagamento.

Dados do pagamento

Detalhamento dos campos da aba dados do pagamento

Forma de Pagamento

    • Nome: Pagamento
      • Nome Físico: PAGAMENTO1
      • Tipo: Opções
      • Lista de opções:
        • Boleto
        • Depósito
        • À Vista
        • Cartão

  • Nome: Parcelas
    • Nome Físico: PARCELAS1
    • Tipo: Lista
    • Cadastro: Parcelas
    • Campo do Cadastro: Quantidade de Parcelas

  • Nome: Valor da Compra
    • Nome Físico: VALOR_COMPRA1
    • Tipo: Numérico
    • Tamanho: 9
    • Decimais: 2

  • Nome: Frete
    • Nome Físico: FRETE
    • Tipo: Numérico
    • Tamanho: 9
    • Decimais: 2

  • Nome: Parcelas
    • Nome Físico: PARCELAS1
    • Tipo: Fórmula
    • Decimais: 2
    • Fórmula: (<<FRETE>>+<<Valor_da_Compra>>)/<<PARCELAS>>

  • Nome: Total da Compra
    • Nome Físico: TOTAL_COMPRA
    • Tipo: Fórmula
    • Decimais: 2
    • Fórmula: <<Valor_da_Compra>>+<<FRETE>>

Forma de Pagamento 2

    • Nome: Pagamento2
      • Nome Físico: PAGAMENTO2
      • Tipo: Opções
      • Lista de opções:
        • Boleto
        • Depósito
        • À Vista
        • Cartão

  • Nome: Parcelas2
    • Nome Físico: PARCELAS2
    • Tipo: Lista
    • Cadastro: Parcelas
    • Campo do Cadastro: Quantidade de Parcelas

  • Nome: Valor da Compra2
    • Nome Físico: VALOR_COMPRA_2
    • Tipo: Numérico
    • Tamanho: 9
    • Decimais: 2

  • Nome: Parcelas2
    • Nome Físico: PARCELAS2
    • Tipo: Fórmula
    • Decimais: 2
    • Fórmula: <<Valor_da_Compra2>>/<<PARCELAS2>>

Dados da Entrega

  • Nome: Endereço de Entrega
    • Nome Físico: SHIPPING_STREET
    • Tipo: Texto Curto
    • Tamanho: 255
    • Somente Leitura: Sim
    • Conteúdo automático: Sim
      • Vínculo: Dados Cadastrais
      • Campo: Endereço

  • Nome: Cidade
    • Nome Físico: SHIPPING_CITY
    • Tipo: Texto Curto
    • Tamanho: 200
    • Somente Leitura: Sim
    • Conteúdo automático: Sim
      • Vínculo: Dados Cadastrais
      • Campo: Município

  • Nome: Bairro
    • Nome Físico: BAIRRO_ENTREGA
    • Tipo: Texto Curto
    • Tamanho: 200
    • Somente Leitura: Sim
    • Conteúdo automático: Sim
      • Vínculo: Dados Cadastrais
      • Campo: Bairro

  • Nome: CEP
    • Nome Físico: SHIPPING_ZIPCODE
    • Tipo: Texto Curto
    • Tamanho: 20
    • Somente Leitura: Sim
    • Conteúdo automático: Sim
      • Vínculo: Dados Cadastrais
      • Campo: Cep

  • Nome: Estado
    • Nome Físico: SHIPPING_STATE
    • Tipo: Texto Curto
    • Tamanho: 2
    • Somente Leitura: Sim
    • Conteúdo automático: Sim
      • Vínculo: Dados Cadastrais
      • Campo: UF

  • Nome: Entrega Express
    • Nome Físico: SHIPPING_EXPEDITED
    • Tipo: Lógico

  • Nome: Número
    • Nome Físico: SHIPPING_STREETNUMBER
    • Tipo: Texto Curto
    • Tamanho: 20

  • Nome: País
    • Nome Físico: SHIPPING_COUNTRY
    • Tipo: Texto Curto
    • Tamanho: 20

  • Nome: Referência
    • Nome Físico: SHIPPING_NEIGHBORHOOD
    • Tipo: Texto Curto
    • Tamanho: 200
    • Somente Leitura: Sim
    • Conteúdo automático: Sim
      • Vínculo: Dados Cadastrais
      • Campo: Ponto de Referência

  • Nome: Nome
    • Nome Físico: SHIPPING_NAME
    • Tipo: Texto Curto
    • Tamanho: 200
    • Somente Leitura: Sim
    • Conteúdo automático: Sim
      • Vínculo: Dados Cadastrais
      • Campo: Nome / Denominação Social

  • Nome: Data Envio
    • Nome Físico: SHIPPING_DATE
    • Tipo: Data

  • Nome: Valor Envio
    • Nome Físico: SHIPPING_FREE
    • Tipo: Fórmula
    • Fórmula: <<FRETE>>*100

Ativar Integração de Pagamento URA

    • Nome: Ativar Integração de Pagamento
      • Tipo: Informação externa
      • Salvar Ocorrência: Sim
      • Refresh no retorno: Sim
      • Stored Procedure: Sim
      • Localização: PR_EDTSANT_ATIVAR_PAGARME
      • Parâmetros:
        • Ord: 0
        • Vínculo: Código da Ocorrência
        • Nome: @IdOcorrencia
        • Valor: 

  • Nome: Ocorrência PAGAR.ME
    • Nome Físico: TP_ATIVA_PAGARME
    • Tipo: Lógico
    • Somente Leitura: Sim

Dados de cobrança

Detalhamento dos campos da aba dados do cobrança

Dados para cobrança

  • Nome: Valor do Cartão
    • Nome Físico: CARD_AMOUNT
    • Tipo: Fórmula
    • Formúla: <<Total_da_Compra>>*100

  • Nome: Parcelas
    • Nome Físico: QTD_PARCELAS
    • Tipo: Lista

FALTA TERMINAR

  • Nome: Nome
    • Nome Físico: name
    • Tipo: Texto Curto
    • Tamanho: 200

  • Nome: Nome do Titular
    • Nome Físico: CARD_HOLDER_NAME
    • Tipo: Texto Curto
    • Tamanho: 200

  • Nome: País
    • Nome Físico: COUNTRY
    • Tipo: Texto Curto
    • Tamanho: 200

  • Nome: UF
    • Nome Físico: STATE
    • Tipo: Texto Curto
    • Tamanho: 2

  • Nome: Cidade
    • Nome Físico: CITY
    • Tipo: Texto Curto
    • Tamanho: 200

  • Nome: Bairro
    • Nome Físico: NEIGHBORHOOD
    • Tipo: Texto Curto
    • Tamanho: 200

  • Nome: Rua
    • Nome Físico: STREET
    • Tipo: Texto Curto
    • Tamanho: 200

  • Nome: Número
    • Nome Físico: STREET_NUMBER
    • Tipo: Texto Curto
    • Tamanho: 20

  • Nome: CEP
    • Nome Físico: ZIPCODE
    • Tipo: Numérico
    • Tamanho: 8
    • CEP: Sim

Retorno cobrança

  • Nome: Status Pagamento
    • Nome Físico: STATUS_PAGAMENTO
    • Tipo: Texto Curto
    • Tamanho: 200
    • Somente Leitura: Sim

  • Nome: Informação do Pagamento
    • Nome Físico: INF_PAGAMENTO
    • Tipo: Texto Longo
    • Somente Leitura: Sim

Configurando as Procedures

Deveram ser criada duas procedures no banco de dados do CRM “PR_EDTSANT_GERA_PRM_PAGARME” para consumir o WebService do pagar.me (será chamada na URA a partir do Web API do Tactium CRM) e a “PR_EDTSANT_ATIVAR_PAGARME” para definir qual a ocorrência será utilizada para realizar o pagamento (será chamada no botão do NewManager antes de realizar a transferência do cliente para a URA).

Estas procedures estão disponibilizadas no link abaixo:

Link procedures Pagar.me

Criando a Árvore de URA

Deverá ser criada uma arvore de URA que chame método “AcionarIntegracaoPagarMe” para receber os dados do cartão de crédito e efetivar o pagamento via cartão de crédito.

Detalhamento das variáveis solicitadas na URA

  • Nome: CPF
    • Tipo de vocalização: Número pausado
    • Quantidade de cifras: 11

  • Nome: numeroCartao
    • Tipo de vocalização: Número pausado
    • Quantidade de cifras: 16

  • Nome: validadeCartao
    • Tipo de vocalização: Número pausado
    • Quantidade de cifras: 4

  • Nome: codCVV
    • Tipo de vocalização: Número pausado
    • Quantidade de cifras: 3

  • Nome: RetornoRequisicao
    • Tipo de vocalização: Texto
    • Retorno possíveis: TrOk, TrError e TrWarning

  • Nome: MensagenRetorno
    • Tipo de vocalização: Texto

Cadastrando a Configuração e Ação Externa do WebService na URA

Deverá ser cadastrada a URL de acesso ao WSDL do WebService. Segue abaixo o nome padrão da URL, porém pode mudar de acordo como endereço da Web API do Tactium CRM que foi instalado.

Geralmente chamamos de ManagerWS ou CentralIntegracao.

Por exemplo: http://IP_SERVIDOR_DO_CLIENTE/ManagerWS/wsTactiumIntegracao.asmx?WSDL (Se o Tactium IP estiver no mesmo servidor da Web API do Tactium CRM, pode-se usar localhost).

Parâmetros de entrada

  • Nome: Command
    • Tipo: Valor Fixo
    • Valor: AcionarIntegracaoPagarMe
  • Nome: Servico
    • Tipo: Valor Fixo
    • Valor: wsTactiumIntegracao
  • Nome: numeroCartao
    • Tipo: Variável
    • Valor: numeroCartao
  • Nome: codCVV
    • Tipo: Variável
    • Valor: codCVV
  • Nome: validaCartao
    • Tipo: Variável
    • Valor: validaCartao
  • Nome: CPF
    • Tipo: Variável
    • Valor: CPF

Parâmetros de saída

  • Nome: RetornoRequisicao
    • Tipo: Variável
    • Valor: RetornoRquisicao
  • Nome: MensagemRetorno
    • Tipo: Variável
    • Valor: MensagemRetorno

Configurando a chamada do WebService na URA

Conforme podemos ver abaixo a chamada do We Service na URA deverá ser cadastrada logo após a solicitação dos dados do cliente, para que o Web service posso efetivar a transação:

Operacionalizando com a Toolbar

Para encaminhar uma ligação para efetivar pagamento na URA o operador deverá clicar no botão “ATIVAR INTEGRAÇÃO DE PAGAMENTO” a página do NewManager será recarregada e o checkbox “OCORRÊNCIA PAGARME” será ativo.

Na sequência o operador deverá realizar uma transferência com espera para o URA assim que a transação for efetivada a URA irá desligar a chamada e a mesma retornará para o mesmo operador.

 



Este conteúdo foi útil para você?
100% LikesVS
0% Dislikes

Index