PRODUTO E-COMMERCE 3D Secure

Transcrição

1 PRODUTO E-COMMERCE 3D Secure DOCUMENTO DE APOIO À INSTALAÇÃO DO PRODUTO Informação de apoio ao comerciante Pág. 1 de 12

2 Objectivos O presente documento fornece-lhe a informação necessária para facilitar a instalação/integração das lojas virtuais com a solução de pagamentos disponibilizada pela Redunicre E-Commerce 3D Secure. Âmbito do Documento Este documento é destinado aos Comerciantes que pretendam utilizar o produto E Commerce 3D Secure como solução de aceitação de pagamentos com cartão de crédito na sua loja virtual. Esta solução tem por base a o TPAV (Terminal de Pagamento Automático Virtual), compatibilizado com o protocolo de autenticação 3D Secure. Pág. 2 de 12

3 1. Manuais Temos disponíveis os manuais técnicos do produto, cuja informação é necessária a quem pretende desenvolver a interface loja virtual Solução E-Commerce 3D Secure. Assim, caso ainda não tenha os manuais necessários, solicite à Redunicre o seguinte: Produto E-Commerce 3D Secure/Visa; Segredo Partilhado. 2. Ambiente de testes e certificados Para que possa testar eficazmente a integração/interface da loja virtual com a Solução E-Commerce 3D Secure disponibilizamos-lhe um ambiente de certificação/testes, que lhe permite a validação de todas as mensagens associadas ao protocolo 3D Secure. a) Instalação do certificado digital Para aceder a este ambiente deve instalar o certificado correspondente ao TPA 2796, ficheiro que lhe fornecemos em anexo 2796_3DS-K9XH447.p12. A password a inserir na instalação deverá ser K9XH447. b) Envio de mensagens Este certificado deve ser instalado no servidor permitindo assim envio das mensagens de pagamento 3D Secure. Caso envie: Form 3 deve utilizar o url Mensagens Mxxx utilize o url c) Acesso ao interface Ao instalar este certificado no browser, terá acesso à Interface Web da solução E- Commerce 3D Secure possibilitando a consulta e gestão dos movimentos que realizou. O acesso a esta interface é realizado através da url: Pág. 3 de 12

4 d) Conversão de formato.p12 em.pem Em determinadas circunstâncias é necessário converter os formatos dos certificados disponibilizados pela Redunicre. As instruções seguintes permitem realizar essa conversão. Os ficheiros em formato P12, são ficheiros binários (opcionalmente) protegidos com uma palavra-chave, contendo o certificado e a respectiva chave privada. Podem também incluir os certificados da cadeia de certificação (isto é o certificado da Multicert). Os Ficheiros PEM são ficheiros texto (editáveis no notepad) que podem conter o certificado e/ou a respectiva chave privada. Usando a aplicação openssl é possível converter os P12 em ficheiros com extensão PEM. O openssl é uma ferramenta disponível para plataformas Windows e Linux, que permite a conversão entre formatos, nomeadamente de ficheiros P12 para ficheiros com extensão PEM. O seguinte comando permite extrair apenas o certificado do P12 e gravá-lo num ficheiro texto (Resultado1.pem): openssl pkcs12 -clcerts -nokeys -in Certificado.p12 -out resultado1.pem O seguinte comando permite apenas extrair a respectiva chave privada do P12 e grava-lo num ficheiro texto (Resultado2.pem): openssl pkcs12 -nocerts -in Certificado.p12 -out Resultado2.pem Depois de obtidos os 2 ficheiros do certificado e da chave privada (Resultado1.pem, e Resultado2.pem) devem ser editados num editor de texto simples (notepad) e verificar que correspondem ao que se pretende. Eventualmente pode ser necessário retirar algumas linhas de header de cada ficheiro. Pág. 4 de 12

5 3. Cartões de teste Para a realização de testes devem ser utilizados os seguintes cartões: Nº de cartão Validade CVV Mensagens 1ª mensagem Form3 (mensagem de autenticação) Esta mensagem deverá ser enviada utilizando para o efeito um post de acordo com o exemplo dado no Manual do Produto 3D Secure fornecido. Este post permitirá que o processador faça o redirect dos dados enviados para a Visa e, posteriormente, esta envie o mesmo pedido para o banco emissor e cliente, onde a autenticação será realizada. 2ª mensagem M001 (mensagem de autorização ) enviada só no caso da resposta ao form3 ter sido bem sucedida onde o parâmetro C016 = 01 Autenticação registada. Nota: para cartões não Visa, e nos casos em que a resposta ao form3 apresente o valor 02 no parâmetro C016, a operativa deve ser a referida no ponto 5 deste manual. M002 Enviada exclusivamente se a M001 (pedido de autorização) foi bem sucedida. Após o envio dos bens ou produtos, o comerciante poderá realizar o pagamento da encomenda, enviando a mensagem M002, sendo esta responsável pelo crédito da sua conta D.O, e pelo débito ao utilizador. Caso seja necessário proceder à devolução total ou parcial do montante pago pelo cliente, o comerciante tem a sua disposição a mensagem M004, que processa este tipo de movimentos. Pág. 5 de 12

6 Caso o Comerciante verifique após o envio da M001, que não pode disponibilizar o produto ou serviço, pode cancelar o pedido de autorização, utilizando para o efeito a mensagem M003. A M020, que deverá ser utilizada para verificar o estado do pagamento caso o comerciante não receba resposta ao pedido enviado, qualquer que este seja. A MMOV deverá ser enviada sempre que se pretenda fazer o download do ficheiro com os movimentos do TPA. No entanto, a lista de movimentos do TPA pode ser consultada no próprio TPA Virtual, através do acesso ou em ambiente de produção. 5. Operativa para cartões não VISA: A plataforma TPAV 3DS não está ainda certificada para funcionar em 3D Secure com cartões não Visa. Assim, sempre que seja processado um cartão MasterCard ou outro não Visa, a mesma plataforma degrada a transacção para MO/TO, transformando a mensagem de autenticação form3 num pedido de autorização. O comerciante deve analisar a resposta à mensagem form3 e validar se na mesma o parâmetro C016 tem o valor 02 Autorização aceite. Nos casos em que o campo C016 apresenta o valor 02, o comerciante não necessita de enviar a mensagem M001. As restantes mensagens (pagamento, devolução, cancelamento de autorização, ) são as mesmas referidas neste manual. Pág. 6 de 12

7 Exemplo da situação: Dados do Form3 com cartão MasterCard Form3: A030=H3D0&A001= &C007= &A105=9782&A0 61= &C003= xxxxxxx&C004=200708&C005=785&C013=9F3AC01B 7DE3CEA94455E8C1F8B7B12A36FB143D&C012= t/gwpayweb/unicre3dsecureservlet?transid= Resposta ao Form3 com cartão MasterCard: Resposta: <form target='_top' name=h005 method=post action=' '> <input type='hidden' name="a001" value="299076"> <input type='hidden' name="c007" value="55515"> <input type='hidden' name="a061" value="790.64"> <input type='hidden' name="a105" value="9782"> <input type='hidden' name="c003" value="************1333"> <input type='hidden' name="c004" value="0"> <input type='hidden' name="c005" value="000"> <input type='hidden' name="c013" value="af5aba29ec83b43def78362e83f6cc0e b"> <input type='hidden' name="c016" value="2"> <script> document.h005.submit(); </script> <noscript> Pág. 7 de 12

8 6. Migração do MOTO On-line para E-Commerce 3 D Secure As integrações anteriores da plataforma TPAV utilizavam a solução MOTO On-line. A migração da solução MOTO On-Line para a actual solução E-Commerce 3D Secure pressupõe que sejam desenvolvidas e substituídas algumas mensagens, nomeadamente a de autorização M005, que deverá ser substituída pela mensagem de autenticação Form3 e autorização M001. A operativa de pagamento, onde é utilizada a mensagem M002, de anulação de autorização M003, e de devolução M004, irá ser mantida. 7.Segredo-Partilhado O parâmetro C013 (Segredo Partilhado), que consta do form3, é calculado recorrendo a um conjunto de dados. Neste cálculo é necessário utilizar o número do cartão supervisor. Em ambiente de testes deve utilizar o seguinte número de cartão: Por forma a facilitar o cálculo do C013 anexamos a aplicação genc013.bat Este código em Java é um exemplo para ser usado em Certificação e que não deverá ser utilizado em Produção. Procedimentos para a validação do C013, utilizando a aplicação em anexo: genc013.bat 1ºparametro 2º parâmetro 1º parâmetro - emboss do cartão supervisor de que é exemplo ; º parâmetro dados do form 3D; H3D https://re dunicre.pt que é a concatenação dos campos enviados no form3; Pág. 8 de 12

9 Exemplo: <form name="3dsecure" action=" method="post"> A030:<input name="a030" type="text" value="h3d0"><br> A001:<input name="a001" type="text" value="2796"><br> C007:<input name="c007" type="text" value=" "><br> A105:<input name="a105" type="text" value="9782"><br> A061:<input name="a061" type="text" value="52.00"><br> C003:<input name="c003" type="text" value=" "><br> C004:<input name="c004" type="text" value="200912"><br> C005:<input name="c005" type="text" value="219"><br> C012:<input name="c012" type="text" value=" C013:<input name="c013" type="text" value="2ab8c13714e501ebcd2fe0b187d04a0da05ff399"><br> <input type="submit" value="ok"> </form> <html> A utilização da aplicação de validação permite avaliar se o cálculo do C013 está de acordo com o solicitado: Exemplo de utilização da aplicação; C:\C013TOOL>genc013.bat H3D https://re dunicre.pt Como resposta da aplicação conclui-se que para os valores a processar referentes aos dados do Form3, o C013 terá que ter o valor: 2AB8C13714E501EBCD2FE0B187D04A0DA05FF399 Exemplo de resposta da aplicação; C:\C013TOOL>java -classpath. HmacSha H3D https://redunicre.pt Pág. 9 de 12

10 Key: Text:H3D https://redunicre.pt C013:2AB8C13714E501EBCD2FE0B187D04A0DA05FF399 Exemplo: Forma e descrição da concatenação para o calculo: Pág. 10 de 12

11 8.Mensagens de erro Por forma a clarificar a integração da solução E-Commerce 3D Secure descrevem-se as seguintes situações: 1 MBNet MPI(013)Description Inconsistent request data Please try again Solução: Este erro acontece sempre que não são enviados de forma correcta os parâmetros do Form3, ou que o segredo partilhado está mal calculado. Verifique se as regras definidas no cálculo do segredo partilhado estão a ser seguidas de acordo com os exemplos anteriores. 2 M AUT.INCOMPATIVEL Erro resultante do facto de se tentar aprovar uma autorização onde o valor da referência já foi utilizado em pedidos de autorização anterior. Solução: Deve inserir uma nova referência. 3 POSPANP 009 CARTÃO INVÁLIDO Solução: Os dados do cartão são inválidos. Neste sentido, deve validar os dados do cartão. 4 M005 CVV DO CARTÃO Deve inserir o código e segurança do cartão (cvv2/cvc2). 5 Outros Erros Caso se apresentem outro tipo de erros consulte a lista que lhe fornecemos em anexo. Esta não pretende ser uma lista exaustiva, dado que poderão existir outros erros que não fazem parte desta lista. Nessas circunstâncias deve contactar o Comercial da Redunicre. Pág. 11 de 12

12 Esperamos com este documento reduzir o tempo de desenvolvimento das suas aplicações mas no caso de ainda subsistirem dificuldades contacte-nos através da linha de apoio Em alternativa consulte o site e confira o conjunto de serviços que lhe disponibilizamos. Pág. 12 de 12