Guia de Integração para Pagamento Eletrônico B2B

Transcrição

1 Guia de Integração para Pagamento Eletrônico B2B

2 Índice Capítulo Introdução... 3 Capítulo Links de Pagamento... 4 Capítulo Configurando o Gerenciador de Compras... 5 Capítulo Fluxo de Mensagens Pagamento Eletrônico B2B... 7 Capítulo Demonstração de Compra Pagamento Eletrônico B2B Capítulo Dúvidas e Homologação de 15

3 Capítulo 1 Introdução As formas de pagamento do Comércio Eletrônico Bradesco, devem ser integradas por um desenvolvedor / lojista com conhecimentos em desenvolvimento de sistemas. Neste guia estão contidas: Informações para configurar o gerenciador; Orientações para o desenvolvimento das páginas necessárias para o funcionamento do sistema; Contatos para o suporte (telefone e ); Orientações para a solicitação de homologação do site (obrigatória para a liberação da forma de pagamento). IMPORTANTE: Informamos que somente são homologadas as formas de pagamentos geradas pelo sistema do Comércio Eletrônico Bradesco. O Sistema Comércio Eletrônico é compatível a qualquer linguagem / plataforma. IMPORTANTE: Para iniciar o processo de integração desta forma de pagamento é necessário ter assinalado no contrato os campos 7 e 8 (Pagamento Eletrônico B2B) junto ao Bradesco. Após a assinatura deste contrato será habilitado no Gerenciador de Compras SPS a URL de notificação p/ SPS Empresas referenciada neste manual. para contato: homologacao@scopus.com.br 3 de 15

4 Capítulo 2 Links de Pagamento O processo de integração da loja com Pagamento Eletrônico B2B é simples, no entanto deve ser feita com muito cuidado para que os parâmetros sejam passados corretamente e erros não sejam criados no processo de pagamento. Os dados para o pagamento com Pagamento Eletrônico B2B são passados para o servidor através da resposta fornecida pela página DadosCompra.asp (loja de exemplo) ou equivalente. Para dar início ao processo de integração, o desenvolvedor da loja deverá inserir o seguinte link na página de seleção de pagamento da loja (metodo_pagto.asp loja de exemplo): Ambiente de testes: Iinformamos que para esta opção os testes somente serão possíveis no ambiente de produção. Ambiente de Produção: rderid=zzzz Onde: xxxx deverá ser substituído pelo número da loja e zzzz deverá ser substituído pelo número do pedido. IMPORTANTE: Caso a loja esteja utilizando variáveis de sessão ou cookies esses dados serão perdidos no momento em que o comprador clicar neste link de pagamento. A loja poderá passar parâmetros extras no link de pagamento, pois os mesmos serão devolvidos em todos os acessos que o servidor SPS realizar nas páginas da loja. 4 de 15

5 Capítulo 3 Configurando o Gerenciador de Compras Para acessar o gerenciador de compras da loja, entre com a seguinte URL: Onde xxxx é o número da sua loja. Para efetuar o login, use o Manager e a Senha enviados por . Após o login, será apresentada a seguinte tela: 5 de 15

6 Os campos que deverão ser preenchidos para a opção de pagamento Pagamento Eletrônico B2B são: 1) Endereço IP da loja: O endereço de IP do servidor que está hospedando a loja. (este campo é apenas cadastral). 2) Página de confirmação de compra: Esta é a URL que será chamada caso o processo de compra seja bem sucedido. Deve ser preenchido com endereço completo e seus diretórios. (Loja de exemplo - Confirma.asp). 3) Página de falha no pagamento: Esta é a URL que será chamada caso o processo de compra não seja bem-sucedido. Deve ser preenchido com endereço completo e seus diretórios. (Loja de exemplo - Falha.asp). 4) URL de notificação p/ SPS Empresas: Esta é a página mais importante do processo de integração da loja com o Sistema de Pagamento Seguro. Neste campo, o desenvolvedor deverá preencher com a URL da página da loja que vai passar os dados da compra para o Servidor SPS. Esta configuração é bastante importante. Deve ser preenchido com endereço completo e seus diretórios. (Loja de exemplo - DadosCompra.asp). 5) Post a ser enviado para a loja na notificação: Estes são os parâmetros enviados para a página de notificação no processo de pagamento que deve ser copiado e colado no campo Post a ser enviado para a loja na notificação dentro do gerenciador de configuração Bradesco no menu Configuração Bradesco. numorder=[%lid_m%]&merchantid=[%merchantid%]&cod=[%errorcod%]&cctype=[%cctype%]&ccna me=[%ccname%]&cc =[%cc %]&numparc=[%numparc%]&valparc=[%valparc%]&valtotal=[ %valtotal%]&prazo=[%prazo%]&tipopagto=[%tipopagto%]&assinatura=[%assinatura%]& 6) Post a ser enviado para a loja na confirmação de compra: Estes são os parâmetros enviados para a página de confirmação de compra no processo de pagamento que deve ser copiado e colado no campo Post a ser enviado para a loja na confirmação de compra dentro do gerenciador de configuração Bradesco no menu Configuração Bradesco. numorder=[%lid_m%]&merchantid=[%merchantid%]&cod=[%errorcod%]&cctype=[%cctype%]&ccna me=[%ccname%]&cc =[%cc %]&numparc=[%numparc%]&valparc=[%valparc%]&valtotal=[ %valtotal%]&prazo=[%prazo%]&tipopagto=[%tipopagto%]&assinatura=[%assinatura%]& IMPORTANTE: Caso haja a necessidade de envio de mais parâmetros, estes devem ser passados na URL (link de pagamento) no momento em que é realizada a chamada para a página prepara_pagto.asp. 7) Post a ser enviado para a loja na falha da autorização: Estes são os parâmetros enviados página de falha no processo de pagamento que deve ser copiado e colado no campo Post a ser enviado para a loja na falha da autorização dentro do gerenciador de configuração Bradesco no menu Configuração Bradesco. numorder=[%lid_m%]&merchantid=[%merchantid%]&cod=[%errorcod%]&errordesc=[%errordesc%] & 8) URL de entrada na loja: Neste campo, o desenvolvedor da loja, deverá cadastrar o endereço de entrada da loja. Para inserir as alterações clique no botão efetivar. 6 de 15

7 Capítulo 4 Fluxo de Mensagens Pagamento Eletrônico B2B A figura a seguir mostra o fluxo de dados do pagamento com Pagamento Eletrônico B2B 1) Navegação na loja: O cliente navega na loja normalmente, incluindo e retirando produtos na cesta de compras. Quando o cliente finalizar o processo de escolha, a loja apresenta as formas de pagamento disponíveis para o cliente. 2) Pagar com Pagamento Eletrônico B2B: Nesse momento, o cliente escolhe pagar com Pagamento Eletrônico B2B e redireciona o browser para o servidor de pagamentos link de pagamento passando como parâmetros o merchantid (número da loja) e o orderid (número do pedido). 3) Pede dados da Compra: Ao receber a requisição de compra, o servidor SPS solicita à loja (URL de Notificação para SPS Empresas) os dados da compra, passando como parâmetros tudo o que a loja enviou na requisição, mais os parâmetros merchantid (número de loja), numorder (número do pedido) e o parâmetro TransId que será enviado com o valor getboleto. 4) Responde dados da Compra: Neste caso, a loja deverá montar um Order Description que deverá começar com <BEGIN_ORDER_DESCRIPTION> e ser seguido dos seguintes campos: 7 de 15

8 1) orderid: Número do pedido usado pela loja. Pode possuir até 27 caracteres alfanuméricos, dependendo de como a loja fez a implementação. 2) descritivo: Descrição básica do produto comprado. 3) quantidade: Quantidade do mesmo produto comprado. 4) unidade: unidade de medida do produto. Ex.: CX para caixa, PC para pacote, UN para unidade e etc. 5) valor: Valor do produto comprado. Este valor deverá ser preenchido sem nenhum identificador de moeda nem separadores (vírgula e pontos), ou seja, em centavos. Ex.: Compra de R$23,56 o valor deverá estar como IMPORTANTE: A página da loja deverá multiplicar o valor unitário do produto pela quantidade escolhida pelo comprador e o valor total (por produto) deverá ser informado na TAG valor, pois o sistema não multiplica. 6) adicional: Nome da taxa que a loja poderá cobrar além do valor da compra. Ex.: Frete, Envio e etc. 7) valoradicional: Valor cobrado para o adicional. Este valor também deverá ser preenchido sem nenhum identificador de moeda nem separadores (vírgula e pontos), ou seja, em centavos. IMPORTANTE: Nenhuma TAG poderá ter o valor em branco ou nulo. Caso a loja não queira cobrar nenhuma taxa, as TAGs adicional e valoradicional deverão ser retiradas do código. As demais TAGs são obrigatórias. Neste ponto deverá finalizar o Order Description com <END_ORDER_DESCRIPTION> e iniciar o Boleto Description com <BEGIN_BOLETO_DESCRIPTION> e ser seguido dos seguintes campos: 8) CEDENTE: É o nome da loja que está emitindo o boleto. Por exemplo, Scopus Tecnologia LTDA. 9) BANCO: Este campo deve ser preenchido com o número do banco. Neste caso, o valor pode ser constante e igual a 237, que é o número do banco Bradesco. 10) NUMEROAGENCIA: Este campo deve ser preenchido com o número da agência da conta do lojista. Para o ambiente de testes, o desenvolvedor deve utilizar a agência de teste Note que os zeros à esquerda são obrigatórios, pois a mesma deve conter 4 dígitos. 11) NUMEROCONTA: Número da conta do lojista na agência informada no item anterior. Para o ambiente de testes, o desenvolvedor deve utilizar a conta de teste Note que os zeros à esquerda são obrigatórios, pois a mesma deve conter 7 dígitos. 12) ASSINATURA: Este campo deverá ser preenchido com a assinatura digital do Boleto com retorno, que será fornecida para o lojista. Trata-se de um campo de 256 caracteres hexadecimais. Para o ambiente de testes, o desenvolvedor deve utilizar a assinatura digital abaixo gerada com base na agência e conta de teste: AD8CA027BA56B63C2E5A530029F68AACD5E152234BFA CAA53 BD3EA92B296CA94A313E4E438AD64C1E4CF2CBAD6C67DAA00DE7AC2C907A99979 A5AB53BFEF1FD6DD3D3A24B F7F747907F7F922C6C0F3553F8C6E29D68 E1F6E0CA2566C46C63A2DD65AFF7DF4802FBF4811CA58619B33989B8DDF8 IMPORTANTE: Esta assinatura digital (de teste) é específica para esta forma de pagamento, não sendo permitida a utilização da mesma na opção de pagamento Transferência entre Contas Bradesco. Vale informar que, a assinatura digital gerada para cada loja pelo Bradesco (assinatura de Produção) também é diferente da assinatura digital gerado para a opção de pagamento Transferência entre Contas Bradesco. 8 de 15

9 Esta assinatura pode ser copiada diretamente para o campo de assinatura do Boleto Description. Note que não deverão constar quebras de linha na assinatura, ou seja, todos os 256 caracteres deverão estar em uma única linha. 13) DATAEMISSAO: É a data de emissão do boleto, que pode ser preenchida com a data local da hora da geração do boleto. A data precisa estar formatada da seguinte forma: dd/mm/aaaa, no qual dd é o dia formatado com zero à esquerda, caso o dia seja menor que 10. mm é o mês, formatado com zero à esquerda, caso o mês seja menor do que 10, e aaaa é o ano formatado com 4 algarismos. Exemplos de data 01/01/2011, 23/12/2011, 15/06/2011 etc. 14) DATAPROCESSAMENTO: Esta é data em que o boleto é gerado. Como o boleto é gerado instantaneamente, este campo deve ser preenchido com o mesmo valor do item 12 acima. A data precisa estar formatada da seguinte forma: dd/mm/aaaa, no qual dd é o dia formatado com zero à esquerda, caso o dia seja menor que 10. mm é o mês, formatado com zero à esquerda, caso o mês seja menor do que 10, e aaaa é o ano formatado com 4 algarismos. Exemplos de data 01/01/2011, 23/12/2011, 15/06/2011 etc. 15) DATAVENCIMENTO: É a data de vencimento do boleto. A data precisa estar formatada da seguinte forma: dd/mm/aaaa, onde dd é o dia formatado com zero à esquerda, caso o dia seja menor que 10, mm é o mês, formatado com zero à esquerda, caso o mês seja menor do que 10, e aaaa é o ano formatado com 4 algarismos. Exemplos de data 01/10/2011, 23/02/2011, 15/06/2011 etc. 16) NOMESACADO: Este campo deve ser preenchido com o nome do comprador que está efetuando a transação. Lembrando que o nome não pode conter parênteses. 17) ENDERECOSACADO: Este campo deve ser preenchido com o endereço do cliente que estiver efetuando a compra. Neste campo não pode conter parênteses. 18) CIDADESACADO: Este campo deve ser preenchido com o nome da cidade do cliente comprador. Neste campo não pode conter parênteses. 19) UFSACADO: Este campo deve ser preenchido com a unidade de federação do endereço do cliente comprador. A unidade de federação deve estar formatada com apenas duas letras. Por exemplo, SP, GO, RN etc. 20) CEPSACADO: Este campo deve ser preenchido com o CEP do logradouro do cliente comprador. Não deve conter separadores. Por exemplo, para o CEP , deve-se colocar: ) CPFSACADO: Este campo deve ser preenchido com o CPF ou CNPJ valido do cliente comprador. O campo deve estar formatado para não conter caracteres separadores. Por exemplo, para o CPF , deve formatar para (11 dígitos) e para CNPJ / , deve formatar para (14 dígitos). 22) NUMEROPEDIDO: Este campo deve ser preenchido pelo número do boleto. Recomenda-se o uso do mesmo número do pedido da compra, ou orderid, desde que este esteja limitado a 9 caracteres numéricos, pois este campo deve conter no máximo 9 dígitos. Não há a necessidade de formatação do campo. Assim recomenda-se que a loja faça a emissão dos boletos de forma seqüencial, para facilitar o controle da mesma. Não será permitida a emissão de dois boletos com o mesmo número e valores diferentes de compra. 9 de 15

10 23) VALORDOCUMENTOFORMATADO: Este campo deverá ser preenchido pelo valor da compra. Este valor deverá ser formatado com símbolo de moeda (R$) e pontos para separar os milhares e vírgulas para separar os centavos. Por exemplo: uma compra no valor de 1200 reais deverá ser formatada para que seja enviado no seguinte formato: R$1.200,00. Note que a representação dos valores é diferente da representação usada no Order Description, que obriga a emissão dos valores em centavos. Dentro do arquivo I_String_Functions.asp existe uma função de exemplo que formata os valores em centavos para o formato esperado pelo servidor de boletos. 24) SHOPPINGID: Este campo deverá ser preenchido com o número do portal de origem da compra. Se a loja for participante do portal de compras ShopFácil, preencha o campo com o valor 1 (um, sem zeros à esquerda). Caso contrário, preencha este campo com o valor 0 (zero). 25) NUMDOC: Este campo é opcional. Caso o lojista queira que o campo Número do Documento do Boleto seja preenchido com algum valor. Normalmente é preenchido com o mesmo do número do pedido desde que este esteja limitado a 9 caracteres numéricos, pois este campo deve conter no máximo 9 dígitos. Se a TAG for omitida, o campo correspondente no boleto ficará em branco. 26) CARTEIRA: Este campo é opcional. Caso o lojista use um número de carteira de cobrança diferente da default que é igual a 25. Muita atenção no uso deste campo, pois se um número de carteira de cobrança diferente da qual o lojista tem contrato for informado aqui, o recebimento do valor vendido pela loja poderá não ser recebido. Recomenda-se o uso apenas por aqueles que tiverem carteira de cobrança especial. Caso contrário, esta TAG deverá ser eliminada da mensagem. Se a TAG for omitida, o campo será preenchido automaticamente com o valor 25 (default). 27) ANONOSSONUMERO: Este parâmetro é opcional. Caso seja necessária a alteração do ano do campo Nosso Número. Este campo somente deverá ser usado pelo lojista que já tiver negociado com o banco a alteração dessa informação. Caso contrário, a TAG deverá ser eliminada da mensagem. Se a TAG for omitida, o campo será preenchido automaticamente com o valor 97 (default). 28) CIP: Este campo é opcional. Indica a regra a ser usada no pagamento de boletos com cheque. É muito importante ressaltar que o valor default é 865 e somente deverá ser alterado mediante negociação com o banco. A alteração deste dado sem prévia negociação pode provocar o não recebimento de boletos pagos com cheque. Se a regra default for usada, esta TAG deverá ser eliminada da mensagem. Se a TAG for omitida, o campo será preenchido automaticamente com o valor 865 (default). A loja de exemplo disponível para download já contempla o pagamento com Pagamento Eletrônico B2B. Nesta loja de exemplo, a página responsável pelo envio dos dados para o servidor SPS é: DadosCompra.asp. Esta página usa algumas funções de formatação de dados que podem ser usadas como exemplo pelos desenvolvedores. 10 de 15

11 Neste ponto deverá finalizar o Boleto Description com <END_BOLETO_DESCRIPTION>. IMPORTANTE: Vale lembrar que não são permitidos números repetidos de pedidos para diferentes compras. O desenvolvedor deve garantir a unicidade dos números destinados ao Pagamento Eletrônico B2B. Atenção: Vale lembrar que a sintaxe dos campos deve ser respeitada para a correta geração dos dados para o Pagamento Eletrônico B2B. Veja, a seguir, um exemplo da string gerada pela página da loja (exemplo DadosCompra.asp): <BEGIN_ORDER_DESCRIPTION> <orderid>=( ) <descritivo>=(diskette 3 1/4 Sony) <quantidade>=(1) <unidade>=(cx) <valor>=(700) <descritivo>=(lapiseira Pentel 0.5 preta) <quantidade>=(1) <unidade>=(pc) <valor>=(750) <adicional>=(frete) <valoradicional>=(400) <adicional>=(manuseio) <valoradicional>=(1200) <END_ORDER_DESCRIPTION> <BEGIN_BOLETO_DESCRIPTION> <CEDENTE>=(Scopus) <BANCO>=(237) <NUMEROAGENCIA>=(0001) <NUMEROCONTA>=( ) <ASSINATURA>=(233542AD8CA027BA56B63C2E5A530029F68AACD5E152234BFA CAA53BD3EA92B296CA94A313E4E438AD64C1E4CF2CBAD6C67DAA00DE7AC2C9 07A99979A5AB53BFEF1FD6DD3D3A24B F7F747907F7F922C6C0F3553F8C6E2 9D68E1F6E0CA2566C46C63A2DD65AFF7DF4802FBF4811CA58619B33989B8DDF8) <DATAEMISSAO>=(17/01/2011) <DATAPROCESSAMENTO>=(17/01/2011) <DATAVENCIMENTO>=(20/01/2011) <NOMESACADO>=(NOME DO SACADO) <ENDERECOSACADO>=(ENDERECO DO SACADO) <CIDADESACADO>=(CIDADE DO SACADO) <UFSACADO>=(SP) <CEPSACADO>=( ) <CPFSACADO>=( ) <NUMEROPEDIDO>=( ) <VALORDOCUMENTOFORMATADO>=(R$30,50) <SHOPPINGID>=(1) <NUMDOC>=( ) <CARTEIRA>=(25) <ANONOSSONUMERO>=(97) <CIP>=(865) <END_BOLETO_DESCRIPTION> 5) Página de Pagamento Eletrônico B2B: Após o servidor SPS ter recebido o descritivo de compra, o mesmo monta a página de pagamento com Pagamento Eletrônico B2B e envia ao cliente. 11 de 15

12 6) Login: Com a página do Pagamento Eletrônico B2B em seu browser, o cliente efetua o login no Internet Banking do Bradesco. 7) Realiza o Pagamento: Nesse momento o cliente será redirecionado para o Internet Banking do Bradesco. 8) Dados da Autorização: Após a confirmação Pagamento Eletrônico B2B no Internet Banking do Bradesco, o cliente vai receber uma confirmação de compra do próprio Internet Banking e a loja vai receber um post com os dados da autorização. 9) Dados da Autorização: Quando uma transação for efetuada com sucesso, o sistema vai chamar novamente a página de notificação da loja, retornando para a loja os dados da autorização para que sejam gravados na base de dados da loja. Como resposta à essa chamada, a loja deve retornar a TAG <PUT_AUTH_OK> em caso de sucesso na gravação dos dados ou a TAG <ERRO> se o processo de gravação resultar em erro ou falha. No retorno à loja, o servidor SPS envia os seguintes parâmetros: if=bradesco: Constante que identifica a instituição financeira Bradesco. transid=putauth: Variável que identifica a resposta da autorização. Deve ser usada para identificar a segunda chamada da página de notificação, quando os dados devem ser gravados na base de dados da loja. numorder: Número do pedido usado pela loja. Pode possuir até 27 caracteres alfanuméricos, dependendo de como a loja fez a implementação. Exemplo: merchantid: Número do estabelecimento no Comércio Eletrônico Bradesco. Possui 9 posições numéricas. cod: Código de erro retornado pelo Banco. Retorna 0 (zero) para compras autorizadas. cctype=sps-empresas: Constante que identifica o Pagamento Eletrônico B2B. numparc: Número de parcelas. valparc: Valor de cada parcela. valtotal: Valor total da compra. ccname, cc , prazo e tipopagto: São retornados pelo sistema para manter a compatibilidade com outras formas de pagamento, mas não serão usadas no pagamento com Transferência entre Contas Bradesco. Assim estarão sempre com valor nulo. Assinatura: Assinatura digital da transação. Este campo possui 256 posições alfanuméricas (hexadecimal). Somente é retornada se a transação for completada com sucesso. Exemplo: 16363AD0831E0FBFAD2261EB4E7A117E46C C9C855E076C8F20A3E752FB24790FC7 0495ED08D0AA11A5670EE106768A8074BE089BFC17988C54B3477F757B2C911ED2B B0AEE04C14359FA976E66062D5D5B771A C47B1568F1E35DEF1ADC0AB33609B E0107FB8DDD99D559565E3E141C9 DescriStatus= Descrição do Status da Compra. Os possíveis retornos são: "Compra Aprovada", "Compra Pendente", "Falha na transacao" ou "Compra Cancelada". Se, o servidor SPS receber a TAG <PUT_AUTH_OK>, o browser do cliente será redirecionado para a página de confirmação de compra da loja, caso contrário, a página de falha de pagamento será chamada. 12 de 15

13 Capítulo 5 Demonstração de Compra Pagamento Eletrônico B2B 13 de 15

14 14 de 15

15 Capítulo 6 Dúvidas e Homologação Dúvidas Surgindo dúvidas durante o processo de integração, o contato poderá ser realizado: Através do kit@scopus.com.br, contendo as seguintes informações: - Nome da loja; - CNPJ da loja; - Dúvida. Telefones: (11) (11) Homologação A homologação deverá ser solicitada a equipe do Comércio Eletrônico. Através do homologacao@scopus.com.br, contendo as seguintes informações: - Nome da loja; - CNPJ da loja; - URL do site para teste; - Informar qual opção de pagamento que deverá ser homologada. 15 de 15