Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Migration of unmigrated content due to installation of a new plugin

 Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.                                                             

  

Informações Gerais

Especificação

Produto

RM

Módulo

TOTVS Gestão Financeira

Segmento Executor

Construção e Projetos

Projeto1


IRM/EPIC1


Requisito/Story/Issue1

http://jiraproducao.totvs.com.br/browse/FINANCEIRO01-4595

Subtarefa1


País

(x) Brasil  (  ) Argentina  (  ) Mexico  (  ) Chile  (  ) Paraguai  (  ) Equador

(  ) USA  (  ) Colombia   (  ) Outro _____________.

Outros

Rede : Manual de integração API RESTFul e-Rede

getnet: Manual de integração e-commerce getnet

maxiPago: Manual de integração e-commerce maxiPagohttps://www.userede.com.br/desenvolvedores/images/uploads/manual_integracao_api_rest.pdf

   Legenda: 1 – Inovação 2 – Manutenção (Os demais campos devem ser preenchidos para ambos os processos). 

Objetivo

Integrar as soluções TOTVS com a solução de pagamentos on-line e-Rede. A solução e-rede realiza a captura e processamento de transações financeiras diretamente pela Rede, ou seja, sem necessidade de um intermediador, oferecendo pagamentos com cartões de crédito e débito das principais bandeiras do mercado.online disponíveis no mercado. (e-Rede, getnet, maxiPago)

Para que a integração seja independente do produto, e seja utilizada por qualquer solução da TOTVS, será criada uma nova solução, denominada "TOTVS e-commerce" no qual irá ter a web-page para digitação dos dados sensíveis do cartão e um web-service para fazer a comunicação com os serviços e-Rededa adquirente

A solução TOTVS e-commerce deverá ter um instalador próprio.

Definição da Regra de Negócio

Criação da web-page para digitação dos dados do cartão:

  •  Dados de entrada:
    • Adquirente (e-Rede ou GetNet ou maxiPago)
    • Numero de Filiação (PV) -  criptografados no formato base64Token -  criptografados no formato base64   
    • Token/Chave Acesso  
    • URL e-Rede (Homologação ou Produção)
    • URL de retorno a pagina do estabelecimento
    • Código do Pedido do Estabelecimento
    • Valor (Exemplo R$ 10,00 = 1000 | R$ 0,50 = 50)
    • Numero máximo de parcelas
    • Descrição do Serviço
  • Dados para digitação:
    • Numero do Cartão
    • Nome do portador impresso no cartão
    • Mês vencimento do cartão
    • Ano vencimento do cartão
    • Código de Segurança do cartão
  • Validações
    • Deverá ser feita a validação, através de javascript de qual bandeira o cartão pertence
  • Ação
    • Ao finalizar o pagamento será chamado do webservice o serviço de criação de transação
  • Dados de Retorno:
    • Após chamada do serviço de criação de transação, caso parâmetro de entrada "URL de retorno a pagina do estabelecimento" esteja preenchido será feita chamada dessa URL, passando os seguintes parâmetros na linha de comando: (ex: http://totvs.com.br/corporerm/URLRetorno?sucesso=false&codigoretorno=101&mensagemretorno&=Não Autorizado&codigopedidoestabelecimento=0000135&TID=834500036348405380&NSU=66320641&numautorizacao=186376&valor=10289&numparcelas=3)
      • Sucesso - true/false
      • codigoretorno - Preenchido caso tenha ocorrido erro - sucesso = false
      • mensagemretornoPreenchido caso tenha ocorrido erro - sucesso = false
      • codigopedidoestabelecimento - Código do Pedido do Estabelecimento
      • TID - Numero identificar único da transação
      • NSU - Numero sequencial retornado pela Rede
      • numautorizacaoNumero de autorização da transação retornado pelo emissor do cartão
      • valor - Valor total da transação (Exemplo R$ 10,00 = 1000 | R$ 0,50 = 50)
      • numparcelas - Numero de Parcela da Transação
      • bandeira (Vide tópico abaixo "Identificação da  da Bandeira do cartão")
    • Caso parâmetro de entrada "URL de retorno a pagina do estabelecimento" não esteja preenchida, será chamada a web-page padrão de transação concluída ou não concluída conforme especificado mais abaixo
  • Chamada serviço e-Rede
  • Chamada serviço getnet

Criação da web-page padrão de transação concluída ou não concluída:

  • Dados de entrada
    • Código do Retorno (00 = Sucesso)
    • Mensagem de Retorno da Transação
    • Descrição do Serviço
    • TID - Numero identificador único da transação
    • NSU - Numero sequencial retornado pela Rede
    • Numero de autorização da transação retornado pelo emissor do cartão
    • Valor total da transação (Exemplo R$ 10,00 = 1000 | R$ 0,50 = 50)

Criação do webservice para integração com e-redeadquirente:

  • Serviço de Criação da Transação
    • Dados de Entrada
      • URL Adquirente (e-Rede ou GetNet ou maxiPago)
      • Numero de Filiação (PV)
      • Token / Chave Acesso
      • URL (Homologação ou Produção)
      • Tipo de Transação (Crédito/Débito)
      • Código do Pedido do Estabelecimento
      • Valor (Exemplo R$ 10,00 = 1000 | R$ 0,50 = 50)
      • Numero de Parcelas
      • Nome do portador impresso no cartão
      • Numero do Cartão
      • Mês vencimento do cartão
      • Ano vencimento do cartão
      • Código de Segurança do cartão
      • Numero de Filiação (PV) -  criptografados no formato base64
    • Chamada serviço e-Rede
    • Chamada serviço getnet
      • Deverá ser montado o XML de acordo com o Manual de integração e-commerce getnet
      • Se tipo de transação igual a crédito
        • Para crédito chamar o serviço efetuarcredito
      • Se tipo de transação igual a débito
        • Verificar se o emissor do cartão suporta autenticação. Chamar o serviço verificarInscricacaoMPI
        • Se bandeira\emissor do cartão suporta autenticação:
          • Direcionar usuário para url de retorno do banco emissor do cartão
          • Se autenticação ocorrer com sucesso
            • chamar o serviço efetuarDebito (Vide abaixo diagrama de sequencia "Efetuar pagamento cartão débito getnet")
        • Se bandeira\emissor não suporta autenticação
          • Avisar usuário
          • Retornar para pagina de digitação de dados do cartão
    • Chamada serviço maxiPago
    • Dados de Retorno
      • Código do Retorno
      • Mensagem de Retorno da Transação
      • Código do Pedido do Estabelecimento
      • TID - Numero identificar único da transação
      • NSU - Numero sequencial retornado pela Rede
      • Numero de autorização da transação retornado pelo emissor do cartão
      • Data da transação no formato YYYY-MM-DDthh:mm:ss.sTZD
      • Valor total da transação (Exemplo R$ 10,00 = 1000 | R$ 0,50 = 50)
  • Serviço de consulta transação
    • Dados de entrada
      • Adquirente (e-Rede/GetNet)
      • Numero de Filiação (PV)
      • Token / Chave Acesso
      • Código do Pedido do Estabelecimento ou;
      • TID - Numero identificador único da transação

    • Chamada serviço e-Rede
    • Chamada serviço getnet
    • Chamada serviço maxiPago
    • Dados de Saida
      • Código do retorno da transação
      • Mensagem de retorno da transação
      • Numero de filiação (PV)
      • Status (Approved, Denied, Canceled, Pending
      • Numero do Pedido gerado pelo estabelcimento
      • TID - Numero identificador único da transação
      • NSU - numero sequencial retornado pela Rede
      • Código de Autorização  da transação retornado pelo emissor do cartão
      • Método de pagamento utilizado na transação (Credit/Debit)
      • Valor total transação (Exemplo R$ 10,00 = 1000 | R$ 0,50 = 50)
      • Numero de Parcelas
      • Data da transação de cancelamento no formato YYYY-MM-DDthh:mm:ss.sTZD
      • Código de Retorno da solicitação de cancelamento gerado pela Rede
      • Status da solicitação de cancelamento (Done, Denied, Processing)
      • Valor do cancelamento
  • Serviço de solicitação de cancelamento de transação
    • Dados de Entrada
      • TID - Numero identificador único da transação
      • Valor total da transação (Exemplo R$ 10,00 = 1000 | R$ 0,50 = 50)
    • Chamada serviço e-Rede
    • Chamada serviço getnet
    • Chamada serviço maxiPago
    • Dados de Retorno
      • Código de retorno da transação de cancelamento
      • Mensagem de retorno da transação de cancelamento
      • Código de retorno da solicitação de cancelamento gerado pela rede
      • TID - Número identificado único de transação
      • NSU - Numero sequencial retornado pela rede
      • Data da transação de cancelamento no formato YYYY-MM-DDthh:mm:ss.sTZD
      • Código identificador da transação de solicitação de cancelamento

Identificação da Bandeira do cartão

  • ELO
    • Começa com: 636368, 438935, 504175, 451416, 509048, 509067, 509049, 509069, 509050, 509074, 509068, 509040, 509045, 509051, 509046, 509066, 509047, 509042, 509052, 509043, 509064, 509040, 36297, 5067 ,4576 ,4011   
  • Discover
    • Começa com: 6011, 622, 64, 65
  • Diners
    • Começa com: 301, 305, 36, 38
  • AMEX
    • Começa com: 34, 37
  • AURA
    • Começa com: 50
  • JCB
    • Começa com: 35
  • Hypercard
    • Começa com: 38, 60
  • Visa
    • Começa com: 4
  • MasterCard
    • Começa com 5





Protótipo de Tela

*Solicitar ajuda do Design Lucas para criação das telas

Protótipo tela para informar dados de pagamento de cartão de crédito/débito

 

 

 Protótipo tela padrão de pagamento concluído


 Protótipo tela padrão de pagamento não concluído


 

Fluxo do Processo

 Image RemovedImage Added


Image Added

 Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.