Manual do Desenvolvedor. Versão 2.7

Transcrição

1 Manual do Desenvolvedor Plataforma e-banrisul Versão 2.7

2 SUMÁRIO 1. INTRODUÇÃO OBJETIVO PÚBLICO-ALVO ETAPAS SUPORTE PRODUTO MODALIDADES DE PAGAMENTOS FORMAS DE AUTENTICAÇÃO VISÃO GERAL LOJA B@NRISTORE INTEGRAÇÃO PAGAMENTO À VISTA (PGTA) PAGAMENTO PRÉ-DATADO (PGTP) Restrições: PAGAMENTO PARCELADO (PGTX) Restrições: PARA EMISSÃO DO BOLETO BANCÁRIO (PGBC) CONFIRMAÇÃO DAS OPERAÇÕES Fluxo/processo da operação: Consulta pedido Função de consulta pedidos Transferência de dados via Internet Retorno da consulta tipo X (XML) Padrão do XML de comunicação Banrisul Confirmação para pagamento por boleto bancário HOMOLOGAÇÃO MÓDULO DE CADASTRO DA PLATAFORMA BANRISUL Mensagem do boleto bancário Alteração de senha MÓDULO DE PROCEDIMENTOS PARA HOMOLOGAÇÃO DA PLATAFORMA BANRISUL REALIZAÇÃO DE TESTES PELA LOJA VIRTUAL SOLICITAÇÃO DE HOMOLOGAÇÃO DO SITE JUNTO A BANRISUL VERO... 25

3 1. INTRODUÇÃO Seja bem-vindo ao Manual do Desenvolvedor da plataforma e- commerce Banrisul. 1.1 Objetivo Esse manual tem por objetivo descrever as informações necessárias para realizar com sucesso a integração da sua loja virtual com o Banrisul, permitindo o recebimento de transações de débito dos clientes portadores do cartão Banricompras. Serão abordados os conceitos do produto e os temas técnicos que visam facilitar o entendimento e o desenvolvimento da solução de e-commerce. 1.2 Público-alvo As informações deste manual são destinadas aos desenvolvedores de software, analistas e programadores de empresas parceiras da rede de adquirência Banrisul Vero. 1.3 Etapas Ao todo, o processo de desenvolvimento da solução consiste basicamente em quatro etapas: A equipe de suporte técnico, do Banrisul, estará à disposição para auxiliar na integração das soluções após o credenciamento do cliente (loja virtual) estar encaminhado com a área comercial da rede Vero. 1.4 Suporte Durante o desenvolvimento e homologação, o Banrisul disponibiliza o seu suporte técnico, em horário comercial, através dos seguintes contatos:

4 Comercial banrisul_cartoes_estrategia@banrisul.com.br Produtos banrisul_cartoes_produtos@banrisul.com.br Homologação srac@banrisul.com.br 2. PRODUTO 2.1 Modalidades de Pagamentos A Banrisul Vero disponibiliza através da plataforma Banrisul as seguintes modalidades de pagamentos: Banricompras à vista; Banricompras pré-datado (até 60 dias); Banricompras parcelado (até 12x); Boleto Bancário Banrisul. A empresa parceira poderá optar por oferecer aquelas modalidades que melhor atender as suas necessidades de negócio. 2.2 Formas de Autenticação Quando o cliente escolher uma das modalidades de pagamentos acima descritas, o fluxo da navegação é desviado para um ambiente com conexão segura (SSL) no site da plataforma Banrisul. Portanto, todas as informações trafegam em rede criptografada, desta forma protegendo o cliente final para fazer sua transação sem se preocupar com a segurança de seus dados. Existem três formas de autenticação para viabilizar o pagamento do cliente Banrisul portador do cartão Banricompras:

5 FORMAS DE AUTENTICAÇÃO DA PLATAFORMA BANRISUL 1. Autorização via tecnologia push notification com o aplicativo Banrisul Digital habilitado para o portador cliente Banrisul. Aceita todas as modalidades (à vista, pré-datado e parcelado); 2. Digitação de token digitado Banricompras Vero Pay. Utilizado por clientes portadores ou compartilhado com terceiros. Aceita somente pagamentos à vista; 3. Pagamento com cartão físico Banricompras e leitora smart card acoplada a um computador ou notebook. Aceita todas as modalidades (à vista, pré-datado e parcelado).

6 3. VISÃO GERAL Início do processo Loja virtual credenciada Plataforma Banrisul Compra efetuada NÃO Transação não autorizada SIM Transação autorizada + comprovante de pagamento do cliente Consulta da transação Fim

7 4. LOJA Para auxiliar no processo de integração, disponibilizamos uma loja virtual simplificada para a realização de testes. A loja de demonstração está disponível através do link da B@NRISTORE. Loja virtual de demonstração B@NRISTORE 5. INTEGRAÇÃO Concluídas todas as escolhas do cliente, para compra de seus produtos ou escolha de serviços na loja virtual, o cliente opta por uma das formas de pagamento. Neste momento, o fluxo da navegação é desviado para o endereço: Passando uma sequência de parâmetros, a formatação destes parâmetros é inerente de acordo com o tipo de pagamento selecionado. Estes parâmetros podem ser enviados por Get ou Post. O desvio do fluxo de navegação deve ser feito pelo objeto window, método open, conforme exemplo:

8 <SCRIPT LANGUAGE=JavaScript> function Submeter (Url) { window.open(url, "Demonstrativo", Opcoes, true); } </SCRIPT> <A href= Pagina.htm OnMouseDown = Submeter(" pedido=12345&codrede=123456&codestab=0066&vlrtotal= &formapagto =PGTA")>Á Vista</A> Veja a seguir a sequência de parâmetros para cada tipo de pagamento: 5.1 Pagamento à vista (PGTA) CAMPO DESCRIÇÂO TAMANHO MÁXIMO (em bytes) FORMATO EXEMPLO IdentPedido Identificação do Pedido 40 Alfanumérico 1010abc187 CodRede CodEstab Código da rede (Fornecido pelo BANRISUL) Código do estabelecimento (Fornecido pelo BANRISUL) 11 Numérico Numérico VlrTotal Valor total da compra 15 Numérico Para R$22,50 (vinte dois reais e cinquenta centavos): FormaPagto Forma de Pagamento 04 Alfanumérico PGTA Exemplo de parâmetros para uma compra com pagamento à vista no valor de R$ 39,95 pelo método GET :?identpedido=531123&codrede= &codestab= &VlrTotal= &FormaPagto=PGTA

9 5.2 Pagamento pré-datado (PGTP) CAMPO DESCRIÇÃO TAMANHO MÁXIMO (em bytes) FORMATO EXEMPLO IdentPedido Identificação do Pedido 40 Alfanumérico 1010abc187 CodRede CodEstab Código da rede (Fornecido pelo BANRISUL) Código do estabelecimento (Fornecido pelo BANRISUL) 11 Numérico Numérico VlrTotal Valor total da compra 15 Numérico Para R$22,50 (vinte dois reais e cinquenta centavos): FormaPagto Forma de Pagamento 04 Alfanumérico PGTP NumParcelas Número de parcelas 02 Numérico 01 Data: Opção Data ou prazo para pagamento 01 Alfanumérico D Prazo: P Parcela Número da parcela 02 Numérico 01 DataSugerida Data escolhida pelo cliente 08 Data Se campo Opcao = D, DataSugerida = AAAAMMDD; Se campo Opcao = P, DataSugerida = Se campo Opcao = D, Prazo = 000; Prazo Prazo em dias escolhido pelo cliente 03 Numérico Se campo Opcao = P, Prazo = 015(ex.: 15 dias) VlrParcela Valor da Parcela 15 Numérico Para R$22,50 (vinte dois reais e cinquenta centavos), informar: Exemplo de parâmetros para uma compra com pagamento prédatado no valor de R$ 7,99 com prazo de 20 dias pelo método GET :

10 ?identpedido=221342&codrede= &codestab= &VlrTotal= &FormaPagto=PGTP&NumParcelas=01&Opc las=01&opc ao=p&parcela=01&datasugerida= &prazo=20&vlrparcela= Exemplo de parâmetros para uma compra com pagamento prédatado no valor de R$ 39,95 com data para pagamento em 30/12/2002 pelo método GET :?identpedido=221343&codrede= &codestab= e= &codestab= &VlrTotal= &FormaPagto=PGTP&NumParcelas=01&Opc ao=d&parcela=01&datasugerida= &prazo=0&vlrparcela= Restrições: o O prazo máximo não pode ultrapassar 60 dias; o O número de parcelas deve ser sempre Pagamento parcelado (PGTX) CAMPO DESCRIÇÃO TAMANHO MÁXIMO (em bytes) FORMATO EXEMPLO IdentPedido Identificação do Pedido 40 Alfanumérico 1010abc187 CodRede Código da rede (Fornecido pelo BANRISUL) 11 Numérico Código do estabelecimento CodEstab (Fornecido pelo BANRISUL) 15 Numérico VlrTotal Valor total da compra 15 Numérico Para R$22,50 (vinte dois reais e cinquenta centavos): FormaPagto Forma de Pagamento 04 Alfanumérico PGTX NumParcelas Número de parcelas Máximo de 25 parcelas 02 Numérico Para 6 (seis) parcelas: 06 Opcao Data ou prazo para pagamento 01 Alfanumérico Data:D Prazo: P

11 Parcela Número da parcela até 25 ocorrências 02 Numérico Para pagamento em duas parcelas: 0102 DataSugerida Data escolhida pelo cliente até 25 ocorrências 08 Data Somente se campo Opcao = D, DataSugerida = AAAAMMDD; Prazo Prazo escolhido pelo cliente até 25 ocorrências 03 Numérico Somente se campo Opcao = P, Prazo = 015 (ex.: 15 dias) VlrParcela Valor da Parcela até 25 ocorrências 15 Numérico Para duas parcelas de R$22,50 (vinte dois reais e cinquenta centavos), informar: Exemplo de parâmetros para uma compra com pagamento parcelado no valor de R$ 31,92 em 02 parcelas, sendo a primeira parcela à vista (20/12/2002) pelo método Post :?identpedido=351346&codrede= &codestab= &VlrTotal= &FormaPagto=PGTX&NumParcelas=02&Opc ao=p&parcela=0102&datasugerida= &prazo=000030&vl rparcela= Exemplo de parâmetros para uma compra com pagamento parcelado no valor de R$ 33,83 em 02 parcelas, sendo a primeira parcela para 30 dias pelo método Post :?identpedido=23147&codrede= &codestab= &VlrTotal= &FormaPagto=PGTX&NumParcelas=02&Opca o=p&parcela=0102&datasugerida= &prazo=030060&vlr Parcela= Restrições: o Primeira parcela pode ser programada para qualquer data, sendo que a última parcela deve respeitar o prazo máximo (366 dias); o Última parcela não pode ultrapassar 366 dias; o O número máximo de parcelas é de 25.

12 5.4 Para emissão do boleto bancário (PGBC) CAMPO DESCRIÇÃO TAMANHO MÁXIMO (em bytes) FORMATO EXEMPLO IdentPedido Identificação do Pedido 40 Alfanumérico 1010abc187 CodRede CodEstab Código da rede (Fornecido pelo BANRISUL) Código do estabelecimento (Fornecido pelo BANRISUL) 11 Numérico Numérico A vista: Vcto Data do Vencimento 08 Numérico Data do Vencimento: (DDMMAAAA) VlrTotal Valor total da compra 10 Numérico Para R$22,50 (vinte dois reais e cinquenta centavos): FormaPagto Forma de Pagamento 04 Alfanumérico PGBC Sacado Nome do Sacado 30 Alfanumérico Jose Roberto Pedro End1 Tipo do Logradouro + Logradouro + Número do Endereço + Complemento 40 Alfanumérico Rua, dos Andradas, AP.15-A Uf Unidade Federativa 02 Alfanumérico RS Cidade Cidade 25 Alfanumérico Porto Alegre Cep Código de endereçamento postal 09 Alfanumérico Exemplo de parâmetros para uma compra com pagamento via boleto bancário, vencimento data atual e valor R$ 63,92:?identPedido=551430&CodRede= &CodEstab= &Vcto= &VlrTotal= &FormaPagto=PGBC&Sacado=Jo se%20roberto%20pedro&end1=rua%20dos%20andradas%20n.%20500%2 20Andradas%20N.%20500%2 0%20AP.%2021-B&Cidade=Porto%20Alegre&Uf=RS&Cep=05500 B&Cidade=Porto%20Alegre&Uf=RS&Cep=

13 Obs.: No pagamento via Boleto Bancário, a empresa credenciada definirá a data de vencimento do documento. 5.5 Confirmação das operaç perações Nas compras com opção de pagamento à vista, pré-datado e parcelado, após o processamento da compra pelo Banrisul, o cliente recebe do sistema a confirmação da operação realizada. Trata-se de comprovante de pagamento gerado no ambiente Banricomprapontocom. o O cliente recebe, pelo seu navegador, um comprovante de pagamento autenticado; o Utilizando os dados da confirmação, o credenciado acessa a função de consulta do Banrisul obtendo informações detalhadas da operação.

14 5.5.1 Fluxo/processo da operação: 1) Acessa Loja Virtual 2) Seleciona Produtos 3) Apresenta Formas de Pagamentos 4) Escolhe Forma de Pagamento 5) Desvia para Banrisul com as informações da compra Cliente 7) Cliente escolhe uma das formas de autenticação Loja 6) Solicita autenticação ao cliente 8) Solicita dados de acordo com a forma escolhida de autenticação Banrisul 9) Cliente informa os dados e autoriza pagamento 10) Host autoriza e apresenta comprovante de pagamento 13) Consulta Operações 14) Resposta Consulta

15 5.5.2 Consulta pedido A loja virtual deverá consultar os pedidos (transações) cujos pagamentos foram efetuados pela plataforma Banrisul, utilizando uma das seguintes transações: o Função de consulta pedidos; o Transferência de dados via Internet Função de consulta pedidos Disponível através do endereço (URL): PÁGINA PARA CONSULTA DE PEDIDOS Transferência ncia de dados via Internet Pelo método Get Get ou Post Post. Para isto, basta acessar o endereço (URL) abaixo e encaminhar os seguintes parâmetros:

16 CAMPO DESCRIÇÃO TAMANHO MÁXIMO (em bytes) FORMATO EXEMPLO ide01 idf01 Rede (Fornecido pelo BANRISUL) Estabelecimento (Fornecido pelo BANRISUL) 11 Numérico Numérico iop01 Tipo 01 Alfanumérico Pedido específico 1 Período 4 Caso pedido especifico: idp01 Id.Pedido 40 Alfanumérico 1a2b3c456 Caso Período: IdataInicial Data Inicial 14 Ou 08 AAAAMMDDhh mmss Ou AAAAMMDD ou IdataFinal Data Final 14 Ou 08 AAAAMMDDhh mmss Ou AAAAMMDD ou idt01 Resposta Consulta 01 Alfanumérico idsenha01 Senha da Consulta 10 Alfanumérico Layout tipo XML X USAR APENAS LETRAS E NÚMEROS CASE SENSITIVE Observações: 1. Na consulta por Período, fica compreendido um período de no máximo 31 dias. 2. No parâmetro IdataInicial, quando omitida a representação de hora (hhmmss), será considerado o valor No parâmetro IdataFinal, quando omitida a representação de hora (hhmmss), será considerado o valor No parâmetro IdSenha, poderá ter até no máximo 10 caracteres alfanumérico. 5. No parâmetro IdSenha, usar apenas letras e números case sensitive.

17 Exemplo de parâmetros encaminhados para uma consulta por pedido específico igual a 1a2b3c456 e idt01=x (XML).?idE01= &idF01= &IoP01=1&idp01=1a2b3c4 56&idt01=X&idSenha01= Exemplo de parâmetros encaminhados para uma consulta por período de 31 dias com Data Inicial igual a 01/03/2006, Data Final 31/03/2006 e idt01=x (XML).?idE01= &idF01= &IoP01=4&IdataInicial= & IdataFinal= &idt01=X&idSenha01= Exemplo de parâmetros encaminhados para uma consulta por um período de 3 horas atrás, a partir da Data Final da consulta: Data Inicial igual a 01/03/2006 às 20:30:00, Data Final 01/03/2006 às 23:30:00 e idt01=x (XML).?idE01= &idF01= &IoP01=4&IdataInicial= & IdataFinal= &idt01=X&idSenha01= Retorno da consulta tipo X (XML) Como retorno desta consulta, a função devolve uma página com o seguinte layout: CAMPO DESCRIÇÃO TAMANHO MÁXIMO (em bytes) FORMATO EXEMPLO dt_movimento Data da Operação 6 Date DD/MM/AAAA nsu_origem Número sequencial único da operação no DB2 6 Numérico cod_rede Código da Rede 11 Numérico cod_estab Código do Estabelecimento 15 Numérico id_pedido Código do Pedido 40 Alfanumérico 1234abcd

18 dt_hr_origem num_parcelas nsu_movimento valor_movimento mnemonico_servico descricao Datahora da operação Número de parcelas de acordo com a forma de pagamento escolhida Número sequencial único da operação no IBM Valor Total da operação Forma de pagamento Descrição da forma de pagamento 18 TimeStamp DD/MM/AAAAHH:MM: SS 02 Numérico Operação parcelada em 12 vezes 12 parcelas 08 Numérico Numérico 25,00 04 Alfanumérico PGTA 40 Alfanumérico BANRICOMPRAS À VISTA situacao Status da Operação 14 Alfanumérico AUTORIZADO; NÃO AUTORIZADO; EMITIDO; EM PROCESSAMENTO O campo situacao indica o estado da operação. Informa se a transação foi concluída com sucesso (situação AUTORIZADA), ou se a transação foi cancelada ou não concluída (situação NÃO AUTORIZADA). Indica ainda se o boleto foi processado corretamente (situação EMITIDO), ou se o cliente está em processo de compra no ambiente do Banrisul (situação EM PROCESSAMENTO). Com a execução desta consulta, a loja virtual pode trabalhar as informações do seu retorno para dar prosseguimento na entrega dos produtos, execução de serviços, atualização de suas bases de dados, e etc. No exemplo 01 abaixo, segue a execução de uma consulta XML: <?xml version='1.0' encoding='iso '?><xml><status codigoretorno="00" codigomensagem="" mensagem=""/> <metadados> <registros> <registro Nome="registrousuario"> <campos> <campo nome="dt_movimento" tipo="date" tamanhomaximo="6" obrigatorio="1" chaveprimaria="0" /> <campo nome="nsu_origem" tipo="double" tamanhomaximo="19" obrigatorio="1" chaveprimaria="0" /> <campo nome="cod_rede" tipo="double" tamanhomaximo="19" obrigatorio="1" chaveprimaria="0" /> <campo nome="cod_estab" tipo="double" tamanhomaximo="19" obrigatorio="1" chaveprimaria="0" /> <campo nome="id_pedido" tipo="string" tamanhomaximo="40" obrigatorio="1" chaveprimaria="0" /> <campo nome="dt_hr_origem" tipo="datetime" tamanhomaximo="16" obrigatorio="1" chaveprimaria="0" /> <campo nome="num_parcelas" tipo="double" tamanhomaximo="19" obrigatorio="1" chaveprimaria="0" /> <campo nome="nsu_movimento" tipo="double" tamanhomaximo="19" obrigatorio="1" chaveprimaria="0" /> <campo nome="valor_movimento" tipo="double" tamanhomaximo="19" obrigatorio="1" chaveprimaria="0" /> <campo nome="mnemonico_servico" tipo="string" tamanhomaximo="4" obrigatorio="1" chaveprimaria="0" /> <campo nome="descricao" tipo="string" tamanhomaximo="40" obrigatorio="1" chaveprimaria="0" /> <campo nome="situacao" tipo="string" tamanhomaximo="14" obrigatorio="1" chaveprimaria="0" /> </campos> </registro> </registros>

19 </metadados> <dados> <registrousuario dt_movimento="17/03/2006" nsu_origem="485" cod_rede=" " cod_estab=" " id_pedido="localhost_ _28 " dt_hr_origem="17/03/ :10:32" num_parcelas="" nsu_movimento="" valor_movimento="0.01" mnemonico_servico="pgta" descricao="banricompras À VISTA " situacao="não AUTORIZADO"/> </dados> </xml> Padrão do XML de comunicação Banrisul O funcionamento da comunicação entre camadas de interface é realizado via XML. O padrão abaixo é o documento que valida o XML: <?xml version='1.0'?> <xs:schema xmlns:xs=' targetnamespace=' xmlns=' elementformdefault='qualified'> <xs:complextype name='tipostatus'> <xs:attribute name='codigoretorno' type='xs:string' default='00'/> <xs:attribute name='codigomensagem' type='xs:string' use='optional'/> <xs:attribute name='mensagem' type='xs:string' use='optional'/> </xs:complextype> <xs:complextype name='tipoerro'> <xs:attribute name='codigofalha' type='xs:string' use='optional'/> <xs:attribute name='descricao' type='xs:string' use='optional'/> <xs:attribute name='sistema' type='xs:string' use='optional'/> <xs:attribute name='modulo' type='xs:string' use='optional'/> <xs:attribute name='funcao' type='xs:string' use='optional'/> <xs:attribute name='comandosql' type='xs:string' use='optional'/> <xs:attribute name='parametrosentrada' type='xs:string' use='optional'/> <xs:attribute name='pontoprograma' type='xs:string' use='optional'/> <xs:attribute name='retornocomunicacao' type='xs:string' use='optional'/> <xs:attribute name='retornousuario' type='xs:string' use='optional'/> </xs:complextype> <xs:simpletype name='tipotiposdados'> <xs:restriction base="xs:string"> <xs:enumeration value="string"/> <xs:enumeration value="inteiro"/> <xs:enumeration value="binario"/> <xs:enumeration value="decimal"/> <xs:enumeration value="data"/> </xs:restriction> </xs:simpletype> <xs:complextype name='tipocampo'> <xs:attribute name='nome' type='xs:string' use='required'/> <xs:attribute name='tipo' type='tipotiposdados'/> <xs:attribute name='tamanhomaximo' type='xs:integer'/> <xs:attribute name='obrigatorio' type='xs:boolean'/> <xs:attribute name='chaveprimaria' type='xs:boolean'/> <xs:attribute name='chaveestrangeira' type='xs:string'/> </xs:complextype> <xs:complextype name='tiporegistro'> <xs:sequence> <xs:element name='campos'> <xs:complextype> <xs:sequence> <xs:element name='campo' minoccurs='1' maxoccurs='unbounded' type='tipocampo'/> </xs:sequence> </xs:complextype> </xs:element> </xs:sequence> <xs:attribute name='nome' type='xs:string' use='required'/> </xs:complextype>

20 <xs:complextype name='tiporegistros'> <xs:sequence> <xs:element name='registro' minoccurs='1' maxoccurs='unbounded' type='tiporegistro'/> </xs:sequence> </xs:complextype> <xs:complextype name='tipometadados'> <xs:choice> <xs:element name='registros' type='tiporegistros'/> <xs:element name='relatorio' type='xs:string'/> </xs:choice> </xs:complextype> <xs:complextype name='tipodados'> <xs:sequence> <xs:any namespace='#local' processcontents='skip'/> </xs:sequence> </xs:complextype> <xs:element name='xml'> <xs:complextype> <xs:sequence> <xs:element name='status' minoccurs='1' type='tipostatus'/> <xs:element name='erro' minoccurs='0' type='tipoerro'/> <xs:element name='metadados' minoccurs='0' type='tipometadados'/> <xs:element name='dados' type='tipodados'/> </xs:sequence> </xs:complextype> </xs:element> </xs:schema> Exemplo 02: <?xml version="1.0" encoding="iso "?> <xml> <status codigoretorno="00" codigomensagem="" mensagem=""/> <erro codigofalha="00000" descricao="" sistema="" modulo="" funcao="" comandosql="" parametrosentrada="" /> <metadados> <registros> <registro nome="pessoa"> <campos> <campo nome="idpessoa" tipo="inteiro" tamanhomaximo="6" obrigatorio="1" chaveporimaria="1" /> <campo nome="nome" tipo="string" tamanhomaximo="30" obrigatorio="1" /> <campo nome="telefone" tipo="string" tamanhomaximo="20" obrigatorio="0" /> <campo nome="idade" tipo="inteiro" tamanhomaximo="3" obrigatorio="0" /> </campos> </registro> <registro nome="filho"> <campos> <campo nome="idpessoa" tipo="inteiro" tamanhomaximo="6" obrigatorio= "1" chaveestrangeira="pessoas.idpessoa" /> <campo nome="idfilho" tipo= "string" tamanhomaximo="30" obrigatorio="1" /> <campo nome="nome" tipo="string" tamanhomaximo="30" obrigatorio="1" /> </campos> </registro> </registros> </metadados> <dados> <pessoa IDPessoa="1" Nome= "Fulano" Telefone="123456" Idade="15" />

21 <pessoa IDPessoa= "2" Nome= "Beltrano" Idade="32" /> <filho IDPessoa="1" IDFilho= "1" Nome= "Filho do Fulano"/> </dados> </xml> Confirmação para pagamento por boleto bancário Nas compras com opção de pagamento por boleto bancário, o Banrisul desvia o fluxo de navegação para a página que confirma a efetivação da operação na loja virtual, e em uma nova janela, exibe a página de emissão do boleto bancário. Início Loja Virtual Banricompras. com Boleto Bancário Página Confirmação de compra da Loja Virtual Fim

22 CONFIRMAÇÃO DE COMPRA FEITA POR BOLETO BANCÁRIO 6. HOMOLOGAÇÃO 6.1 Módulo de cadastro da plataforma Banrisul Na página inicial do módulo de cadastro é solicitado o código da rede, o código do estabelecimento e a senha de acesso. O cadastramento desta senha de acesso será solicitado no primeiro acesso do desenvolvedor a este módulo. MÓDULO DE CADASTRO DA PLATAFORMA BANRISUL Neste módulo, o usuário poderá alterar os seguintes dados: o Mensagem do boleto bancário; o Alteração de senha.

23 6.1.1 Mensagem do boleto bancário Para os credenciados que tiverem interesse na implantação de boleto bancário Banrisul, será possível utilizar este módulo para o registro das mensagens que serão impressas no campo instrução instrução do referido boleto. CONFIGURAÇÃO DAS D MENSAGENS DO BOLETO BANCÁRIO BANRISUL A mensagem do boleto bancário é de inteira responsabilidade do credenciado (loja virtual) Alteração de senha O último item deste módulo permite a loja virtual alterar a senha de acesso, como forma de segurança, sempre que a loja virtual ou o desenvolvedor entenderem ser oportuno este procedimento. 6.2 Módulo de procedimentos para homologação da plataforma Banrisul Neste módulo o desenvolvedor irá encontrar informações detalhadas para a realização de testes em sua loja e dos procedimentos para a homologação do site junto a Equipe Técnica do Banrisul. É importante frisar que a liberação da loja para o ambiente de produção, em caráter definitivo, somente ocorrerá após os procedimentos de validação do Banrisul e a sinalização do produto no site.

24 Para obter as informações da homologação, o desenvolvedor deve acessar o link: ww4.banrisul.com.br/banricompras/link na guia Fluxo de procedimentos para a homologação, na opção Informações para homologação. 6.3 Realização de testes pela loja virtual Para que o desenvolvedor possa verificar se o projeto está funcional, são disponibilizados um conjunto de códigos fictícios de Agência, conta corrente e senhas, que servirão para a realização dos testes simulados. Nestes testes o desenvolvedor poderá ver se o fluxo das vendas está ocorrendo perfeitamente entre o site da loja e a página do Banrisul, e se as transações estão sendo levadas a termo, desde a montagem do pedido na loja virtual, até a efetivação do pagamento e sua confirmação, na página do Banrisul. Abaixo a tela com os códigos e senhas de testes.

25 6.4 Solicitação de homologação do site junto a Banrisul Vero Concluído o desenvolvimento da estrutura técnica do projeto, em consonância com os parâmetros definidos neste manual, e após a realização dos testes pela loja virtual através da simulação de vendas, o responsável pelo desenvolvimento deverá solicitar a homologação da loja virtual por ao suporte técnico do Banrisul. O desenvolvedor deverá informar o link de acesso à página de teste, usuário e senha para login, modalidades de pagamento a serem homologadas e anexar ao os comprovantes que evidenciem que as formas de pagamento disponibilizadas foram testadas. Homologação srac@banrisul.com.br Uma vez homologado o site pela Equipe de Homologação, a área Comercial da Banrisul Vero entrará em contato com o desenvolvedor da loja e lhe informará o endereço de produção da plataforma Banrisul e os parâmetros comerciais necessários à liberação da loja para a realização de vendas em caráter definitivo. Salientamos que para a homologação em produção é primordial que o site esteja bem sinalizado, através da utilização do logo do Banrisul desde a tela inicial até a tela de meios de pagamentos, e que o produto Banricompras tenha condição de igualdade competitiva com os demais meios de pagamentos existentes no site, no que diz respeito a condições e prazos de parcelamento. As imagens podem ser solicitadas junto à área Comercial da rede de adquirência Banrisul Vero. Comercial banrisul_cartoes_estrategia@banrisul.com.br Produtos banrisul_cartoes_produtos@banrisul.com.br