Manual de Integração Redirecionamento Versão 1.3 Janeiro de 2012
Histórico de versões Data Versão Descrição Responsável 28/10/11 1.0 Criação do documento Erivelton Oliveira 19/12/11 1.1 Adição dos campos para integração com Erivelton gateways e adquirentes 26/01/12 1.2 Adição de erro EV031 na seção Codificação de Erros. Adição de novos pârametros (consumervalue, monthlypaymentvalue, consumercardname e consumercardnumber) no método consulttransactionstatus e post de retorno. Atualização do anexo I. 15/02/12 1.3 Adição de erro EV032 na seção Codificação de Erros. Atualização do status Aprovada para Finalizado na Tabela de status da transação Oliveira Erivelton Oliveira Erivelton Oliveira EvoluCard Manual de Integração Redirecionamento Versão 1.1 Outubro.2011 2
Índice 1. Introdução... 4 2. O que é a EvoluCard?... 4 3. Informações importantes... 4 4. Comunicação EvoluCard <-> Gateway de pagamentos... 5 5. Fases e fluxo de dados... 5 6. Detalhamento das etapas... 5 6.1. (Etapa 1) Pedido de uma transação... 6 6.2. (Etapa 2) Retorno da EvoluCard à solicitação na Etapa 1... 7 6.3. (Etapa 3) Redirecionamento do cliente ao ambiente EvoluCard... 8 6.4. (Etapa 4) Retorno do cliente ao ambiente do estabelecimento... 9 6.5. (Etapa EXTRA 1) Consulta do status da transação... 9 6.6. (Etapa EXTRA 2) Retorno dos dados da transação para o estabelecimento... 12 7. Codificação de Erros... 13 8. Tabela de status da transação... 15 9. Campos para integração com gateways e adquirentes... 16 9.1. Integração CIELO... 17 9.2. Integração REDECARD... 17 10. Operações de Teste... 17 11. Processo de Homologação... 18 12. Suporte Técnico... 18 ANEXO I Diagrama da integração... 20 ANEXO II Diagrama dos atores da integração... 21 EvoluCard Manual de Integração Redirecionamento Versão 1.1 Outubro.2011 3
1. Introdução Nesse manual é abordada a integração do estabelecimento com a EvoluCard através do redirecionamento do cliente para o site da EvoluCard, onde a compra será finalizada. O fluxo desta integração pode ser visto no Anexo I Diagrama da integração. Através dessa integração com o redirecionamento do cliente, as principais vantagens obtidas são: facilidade na integração e independência de plataforma. O objetivo desse documento é orientar os estabelecimentos quanto aos módulos necessários e disponíveis para a transmissão de uma transação, através das soluções de integração EvoluCard. Para iniciar o processo de integração, o desenvolvedor do estabelecimento deverá informar à EvoluCard o(s) endereço(s) de IP da aplicação que se comunicará com o servidor da EvoluCard. 2. O que é a EvoluCard? A EvoluCard viabiliza ao estabelecimento e ao cliente meios de pagamentos mais seguros através dos cartões de crédito, voltados principalmente para a realização de compras pela internet ou por telefone, utilizando o celular do cliente e o TOKEN com duas variáveis para validar a compra. 3. Informações importantes Para integração através do redirecionamento, em linhas gerais, o servidor utilizado pelo estabelecimento deve ser capaz de interpretar os dados no formato JSON. Além disso, deve ser capaz de realizar uma requisição HTTPS/POST e HTTPS/GET. O estabelecimento que já possui uma integração com o gateway de pagamento, terá as características de seu fluxo mantido. Como mostrado no Anexo II Diagrama dos atores da integração, a EvoluCard entrará no fluxo da transação apenas intermediando a comunicação entre o estabelecimento e o adquirente/gateway de pagamentos. Essa intermediação acontecerá apenas nas transações que envolvam a EvoluCard, todas as demais transações enviadas no modelo tradicional manterão seu fluxo direto para o gateway/adquirente, sem o envolvimento da EvoluCard. Para isso, a EvoluCard irá configurar o cadastro do estabelecimento de acordo com o gateway de pagamentos utilizado pelo estabelecimento, e então utilizará o mesmo gateway para enviar as transações. Caso a integração em questão ainda não exista, será necessário um período de desenvolvimento e adaptação, por parte da EvoluCard. Toda a comunicação com a EvoluCard utilizará o protocolo HTTPS/POST ou HTTPS/GET, sendo a resposta da EvoluCard sempre no padrão JSON. EvoluCard Manual de Integração Redirecionamento Versão 1.1 Outubro.2011 4
Para utilizar essa forma de integração é necessário que o(s) endereço(s) IP de onde as transações partirão seja(m) fixo(s). Os parâmetros de cada etapa da integração encontram-se detalhados no item 6 deste manual. 4. Comunicação EvoluCard <-> Gateway de pagamentos Como dito anteriormente, a EvoluCard intermediará o fluxo das transações entre estabelecimento e gateway para transações EvoluCard. Para que isso seja possível, a EvoluCard fará uma integração com o gateway desejado (se ainda não existir) e cadastrará em seu sistema todos os parâmetros que o gateway espera receber. Dessa forma, para que a EvoluCard possa passar uma transação pelo estabelecimento é necessário cadastrar os parâmetros de identificação do estabelecimento no sistema. Por exemplo, cadastrar a chave de acesso de um gateway. 5. Fases e fluxo de dados O processo da transação por redirecionamento é composto por três fases: o pedido de uma transação pelo estabelecimento, o redirecionamento do cliente para o site da EvoluCard e o retorno do cliente ao site da estabelecimento com obtenção do resultado da transação. I) Pedido de uma transação Método: gethash Nessa fase inicial, o estabelecimento solicita à EvoluCard a criação de uma transação, enviando os dados básicos. A EvoluCard responde com um hash identificador, que será utilizado para redirecionar o cliente para a página de compra dentro do ambiente da EvoluCard. II) III) Redirecionamento do cliente ao ambiente EvoluCard Método: ecommerce O estabelecimento redirecionará o cliente à página da EvoluCard, passando o hash obtido na 1ª fase, que identificará a transação. Retorno do cliente ao ambiente do estabelecimento A EvoluCard, após processar a transação, redirecionará o cliente de volta para o ambiente do estabelecimento, em uma página de sucesso ou de erro, dependendo do status da transação. Estas páginas são de responsabilidade do estabelecimento e devem ser pré-cadastradas no sistema EvoluCard. 6. Detalhamento das etapas Os campos para qualquer etapa são enviados sempre como String, e a listagem de todos os códigos de erro encontra-se na seção 7 deste manual. Abaixo, segue a legenda para as tabelas de parâmetros utilizadas nos métodos: J JSON Parâmetro está no formato JSON EvoluCard Manual de Integração Redirecionamento Versão 1.1 Outubro.2011 5
N Numérico Apenas números AN Alfanumérico Números e caracteres M Monetário Padrão para valores, segue o padrão americano. Ex: 1234.56 T Texto Campo livre O Obrigatório Campo deve ser enviado obrigatoriamente OP Opcional Campo é opcional C Condicional Campo é obrigatório dependendo de uma condição 6.1. (Etapa 1) Pedido de uma transação Descrição A Etapa 1 corresponde à requisição do estabelecimento à EvoluCard para a criação de uma transação, enviando os dados básicos. A EvoluCard responde com um hash identificador, que será utilizado para redirecionar o cliente para a página de compra dentro do ambiente da EvoluCard. Escopo Protocolo/Método Endereço Formato da resposta HTTPS/POST https://www.evolucard.com.br/redirectservice/gethash JSON Parâmetros Na tabela a seguir estão os parâmetros que o estabelecimento deverá enviar à EvoluCard na etapa 1. Parâmetro Descrição Formato Obrigatoriedade Tamanho Exemplo merchantcode docnumber Código do estabelecimento com a EvoluCard Número do documento que o estabelecimento utiliza para identificar a transação AN O 1..14 est1234567 N O 1..10 123456789 value Valor da transação M O n/a 1234.56 numberpayment Número de parcelas da transação N O 1..2 3 installmentresponsible Campos para integração com gateway/adquirente Responsável pelo parcelamento: Estabelecimento(M) ou Administradora(A) Devem ser enviados todos os campos variáveis referente a sua integração descritos na seção 9 deste manual AN O 1 M n/a n/a n/a n/a EvoluCard Manual de Integração Redirecionamento Versão 1.1 Outubro.2011 6
Considerações Quando a transação for realizada em 1 parcela, o campo installmentresponsible deve ser enviado com o valor M. Caso o estabelecimento esteja passando uma transação com recebimento pela EvoluCard, este campo também deve ser enviado com o valor M independente do número de parcelas. 6.2. (Etapa 2) Retorno da EvoluCard à solicitação na Etapa 1 Descrição Nessa etapa, a EvoluCard responde a solicitação do estabelecimento, disponibilizando o hash que identificará a transação na próxima etapa. Parâmetros O modelo do JSON, em caso de sucesso e de erro, está descrito abaixo e a descrição de cada parâmetro na tabela a seguir. Lembramos que estão descritos apenas os valores não-nulos em cada caso. JSON em caso de sucesso: { "code": "EV000", docnumber : 435535, "hash": "NTE0MjEyMzEzMTcwNjUwOTgwMDA=" } JSON em caso de erro: { "code": "EV101", docnumber : 435535 } EvoluCard Manual de Integração Redirecionamento Versão 1.1 Outubro.2011 7
Parâmetro Descrição Formato Tamanho Exemplo code Código de sucesso ou erro. EV000 em caso de sucesso. Para os demais erros, ver tabela na seção 7 N 1..5 EV004 docnumber Número do documento que o estabelecimento utiliza para identificar a transação N 1..10 435535 hash Identificador da transação para as próximas etapas T n/a NTE0MjEyMzEzMTcwNjU wotgwmda= 6.3. (Etapa 3) Redirecionamento do cliente ao ambiente EvoluCard Descrição O estabelecimento redirecionará o cliente para o ambiente EvoluCard, utilizando o hash enviado pela EvoluCard na etapa anterior. Escopo Protocolo/Método Endereço Formato da resposta HTTPS/GET https://www.evolucard.com.br/ecommerce n/a Parâmetros Na tabela a seguir estão os parâmetros que o estabelecimento enviará à EvoluCard para redirecionamento do cliente. Parâmetro Descrição Formato Obrigatoriedade Tamanho Exemplo hash Identificador da transação obtido na etapa anterior T O n/a NTE0MjEyMzEzMTcwNjUwOTgwMDA= Considerações Recomendamos que o redirecionamento do cliente seja feito através de modo full screen, ou seja, sem a utilização de pop ups. Isto pode ser feito através de HTTP Redirect ou Javascript. EvoluCard Manual de Integração Redirecionamento Versão 1.1 Outubro.2011 8
6.4. (Etapa 4) Retorno do cliente ao ambiente do estabelecimento Descrição Essa etapa corresponde ao retorno do cliente ao ambiente do estabelecimento, após ter realizado a transação dentro do ambiente EvoluCard. Esse retorno será feito através das urls cadastradas no sistema da EvoluCard pelo estabelecimento. Para os casos de sucesso ou erro serão enviados os parâmetros especificados na tabela a seguir, com o método GET. Escopo Protocolo/Método Endereço HTTPS/GET URL de sucesso ou de erro cadastrada pelo estabelecimento Parâmetros Na tabela a seguir estão os parâmetros que a EvoluCard enviará ao estabelecimento para identificar a transação. Parâmetro Descrição Formato Tamanho Exemplo docnumber Número do documento que o estabelecimento utiliza para identificar N 1..10 435535 a transação hash Identificador da transação T n/a NTE0MjEyMzEzMTcwNjUwOTgwMDA= Considerações Dependendo do retorno do ambiente EvoluCard, o cliente será redirecionado para uma das duas urls do cadastro do estabelecimento: a url de sucesso ou a de erro. Além disso, é possível para o estabelecimento consultar o status da transação através do método consulttransactionstatus e cadastrar uma url para que a EvoluCard faça uma requisição POST com os dados da transação, antes de redirecionar o cliente. Ambas as possibilidades serão explicadas nos próximos tópicos. 6.5. (Etapa EXTRA 1) Consulta do status da transação Descrição Para consultar o status de uma transação, a ser feita pelo estabelecimento após a volta do cliente para o seu ambiente a fim de descobrir se a transação foi aprovada. EvoluCard Manual de Integração Redirecionamento Versão 1.1 Outubro.2011 9
Escopo Protocolo/Método Endereço Formato da resposta HTTPS/POST https://www.evolucard.com.br/redirectservice/consulttransactionstatus JSON Parâmetros Na tabela a seguir estão os parâmetros que o estabelecimento enviará a EvoluCard para efetuar a consulta Parâmetro Descrição Formato Obrigatoriedade Tamanho Exemplo hash Identificador da transação T O n/a NTE0MjEyMzEzMTcwNjUwOTgwMDA= Resposta da EvoluCard A EvoluCard retorna um JSON com os detalhes da transação. JSON em caso de sucesso: { "transactionnumberacq": "889351361", "transactionnumberevc": "1109270000100026480", "authorizationnumber": "12708201173735", "merchantsalesnewdto": { "value": "R$ 1.690,00", "monthlypayment": "1 x R$ 1.690,00", "consumercard": "VISA", "consumername": "Joao Lima", "consumermobile": "+55 (19) 8116-0843", consumervalue : R$ 1.844,80, monthlypaymentvalue : R$ 230,60, consumercardname : JOAO LIMA, consumercardnumber : 123456XXXX1234 }, "status": "1", "code": "EV000" } EvoluCard Manual de Integração Redirecionamento Versão 1.1 Outubro.2011 10
JSON em caso de erro da requisição: { "code": "EV101" } Parâmetro Descrição Formato Tamanho Exemplo code Código de sucesso ou erro. EV000 em caso de sucesso. Para os demais erros, ver tabela na seção 7 N 1..5 EV004 status Status da transação. Verificar a seção 8 para tabela completa de status N 1..2 2 transactionnumberevc Número de transação EvoluCard N 19 1108060001200000001 transactionnumberacq Número de transação do adquirente AN n/a 947595569 authorizationnumber merchantsalesnewdto consumercard Número de autorização da transação do adquirente Campo no JSON de resposta que contém as informações da compra, listada a seguir Informa a descrição do cartão do cliente AN n/a 11707201108534 JSON n/a Ver no exemplo acima T n/a Cartão Principal consumermobile Informa o celular do cliente T n/a +55 (19) 9999-8888 consumername Informa o nome do cliente T n/a José da Silva monthlypayment value consumervalue Informa o número de parcelas da transação Informa o valor da transação sem juros Informa o valor da transação com juros N 1..2 3 T n/a R$ 1.690,00 T n/a R$ 1.844,80 monthlypaymentvalue Informa o valor da parcela com juros T n/a R$ 230,60 consumercardname consumercardnumber Informa o nome do consumidor que está em seu cartão Informa os primeiros 6 dígitos e os últimos 4 dígitos do cartão do cliente com 4 caracteres X entre eles T n/a JOAO LIMA T n/a 123456XXXX1234 EvoluCard Manual de Integração Redirecionamento Versão 1.1 Outubro.2011 11
Considerações No JSON mostrado em caso de erro, trata-se de erros na requisição do pedido. Caso a transação não seja aprovada (reprovada, por exemplo), mas não ocorra erro na requisição, será retornado um JSON de sucesso. Caso seja uma transação com recebimento pelo adquirente, os campos consumervalue e monthlypaymentvalue não serão retornados. O estabelecimento que possuir uma integração com captura manual deve consultar o seguinte manual: Manual Integração EvoluCard Captura Manual. 6.6. (Etapa EXTRA 2) Retorno dos dados da transação para o estabelecimento Descrição O estabelecimento, se desejar, pode cadastrar uma url de confirmação, para que a EvoluCard efetue um POST informando o status da compra, antes de redirecionar o cliente de volta para o ambiente do estabelecimento. Como as demais URLs cadastradas, a página é de responsabilidade do estabelecimento. O POST será feito com os parâmetros descritos abaixo. Escopo Protocolo/Método Endereço HTTP/POST Url especificada pelo estabelecimento no cadastro Parâmetros Na tabela a seguir estão os parâmetros que a EvoluCard enviará ao estabelecimento informando o status e os dados da transação. Os exemplos de JSON seguem os mesmos modelos da etapa 6.5. Parâmetro Descrição Formato Tamanho Exemplo code Código de sucesso ou erro. EV000 em caso de sucesso. Para os demais erros, ver tabela na seção 7 N 1..5 EV004 status Status da transação. Verificar seção 8 para tabela completa dos status N 1..2 2 transactionnumberevc Número de transação EvoluCard N 19 1108060001200000001 transactionnumberacq Número de transação do adquirente AN n/a 947595569 EvoluCard Manual de Integração Redirecionamento Versão 1.1 Outubro.2011 12
authorizationnumber Número de autorização da transação do adquirente AN n/a 11707201108534 consumercard consumermobile consumername monthlypayment value consumervalue Campo de merchantsalesnewdto que informa a descrição do cartão do cliente Campo de merchantsalesnewdto que informa o celular do cliente Campo de merchantsalesnewdto que informa o nome do cliente Campo de merchantsalesnewdto que informa o número de parcelas da Campo transação de merchantsalesnewdto que informa o valor da transação Informa o valor da transação com juros T n/a Cartão Principal T n/a +55 (19) 9999-8888 T n/a José da Silva N 1..2 3 T n/a R$ 1.690,00 T n/a R$ 1.844,80 monthlypaymentvalue Informa o valor da parcela com juros T n/a R$ 230,60 consumercardname consumercardnumber Informa o nome do consumidor que está em seu cartão Informa os primeiros 6 dígitos e os últimos 4 dígitos do cartão do cliente com 4 caracteres X entre eles T n/a JOAO LIMA T n/a 123456XXXX1234 Considerações Caso seja uma transação com recebimento pelo adquirente, os campos consumervalue e monthlypaymentvalue não serão retornados. O estabelecimento que possuir uma integração com captura manual deve consultar o seguinte manual: Manual Integração EvoluCard Captura Manual. 7. Codificação de Erros A EvoluCard utiliza como padrão, para todos os códigos de erro gerados pela EvoluCard o formato EVnnn. Assim, se a EvoluCard tem um erro de código 3, o campo code do JSON de resposta será code : EV003. Qualquer código de retorno, diferente da aprovação, que tenha sido gerado por um adquirente ou gateway de pagamentos será devolvido exatamente como recebido pela EvoluCard. Assim facilitará para que o estabelecimento identifique o erro ocorrido, apenas observando o manual de seu adquirente ou gateway de pagamento. Lembramos que code : EV000 significa que nenhum erro ocorreu. EvoluCard Manual de Integração Redirecionamento Versão 1.1 Outubro.2011 13
Código EV000 EV002 EV003 EV004 EV005 EV006 EV007 EV008 EV009 EV010 EV011 EV012 EV013 EV014 EV015 EV016 EV017 EV018 EV019 EV020 EV021 EV022 EV023 EV025 EV027 EV028 EV029 EV030 EV031 EV032 EV050 EV051 EV052 Descrição Nenhum erro ocorreu. Nenhum cliente válido foi encontrado com os parâmetros passados. Não existe cliente com esse número ou ele não possui cartões válidos para compras. Nenhum cliente válido foi encontrado com os parâmetros passados. O status do cliente está inválido para efetuar transações. Nenhum estabelecimento foi encontrado com os parâmetros passados. Nenhum estabelecimento válido foi encontrado com os parâmetros passados. O status do estabelecimento está inválido para efetuar transações. Um erro inesperado aconteceu em nosso servidor. Entre em contato com a EvoluCard com o código do erro. O IP utilizado para efetuar a chamada ao método é inválido. O estabelecimento não cadastrou o IP utilizado na EvoluCard. O cartão do cliente está inválido para efetuar transações. Não foi encontrada uma integração para efetuar a transação. Verifique o cadastro do estabelecimento para certificar que há integrações para a bandeira do cartão escolhido. Transação reprovada por crédito. (APENAS AMBIENTE DE TESTES) Token não enviado. Entre em contato com a EvoluCard. Transação reprovada pelo adquirente. (APENAS AMBIENTE DE TESTES) Um erro inesperado aconteceu em nosso servidor. Entre em contato com a EvoluCard com o código do erro. Número máximo de reenvios de token excedido. Limite de tempo para reenvio de token excedido. Transação não está com status Incompleta. Não foi possível reenviar o token. Transação não encontrada. Token incorreto na primeira tentativa. Erro de comunicação com o integrador (adquirente ou gateway) Informação adicional de nascimento incorreta na primeira tentativa. Tempo limite para finalização da transação excedido. Não foi encontrado integrador para efetuar a transação. Verifique o cadastro do estabelecimento para certificar que há integrações para a bandeira do cartão escolhido. Erro na criação da transação. Entre em contato com a EvoluCard. Consumidor não possui nenhum cartão aprovado. Consumidor não possui nenhum cartão aprovado com bandeira aceita pelo estabelecimento. Token incorreto na segunda tentativa. Transação reprovada. Informação adicional de nascimento incorreta na segunda tentativa. Transação reprovada. Plano do estabelecimento não possui o número de parcelas da transação efetuada. Este cartão possui uma compra não finalizada, espere 30 segundos para iniciar uma nova compra. Hash inválida. Verifique o valor enviado no campo hash. Hash duplicada. Entre em contato com a EvoluCard com o código do erro. Esta hash já foi utilizada. O valor enviado pelo campo hash já foi utilizado anteriormente em outra transação. EvoluCard Manual de Integração Redirecionamento Versão 1.1 Outubro.2011 14
EV053 EV099 EV101 EV103 EV106 EV107 EV108 EV109 EV115 EV116 EV201 EV202 EV203 EV204 EV205 EV206 EV207 EV208 EV209 EV210 EV211 EV212 EV213 EV214 EV215 Dados do estabelecimento cadastrados no serviço de redirecionamento inválidos. Verifique os dados cadastrados no serviço de redirecionamento. Um erro inesperado aconteceu em nosso servidor. Entre em contato com a EvoluCard com o código do erro. Código do estabelecimento inválido. Verifique o formato enviado no campo "merchantcode". DDD do celular do cliente inválido. Verifique o formato enviado no campo "mobileac". Valor da transação inválido. Verifique o formato enviado no campo "value". Número de parcelas da transação inválido. Verifique o formato enviado no campo "numberpayment". Número de documento do estabelecimento inválido. Verifique o formato enviado no campo "docnumber". Responsável pelo parcelamento inválido. Verifique o formato enviado no campo "installmentresponsible". Status da transação inválido. Verifique o formato enviado no campo "status". Hash inválido. Verifique o formato enviado no campo "hash". Campo Filiação da integração REDECARD não enviado. Campo IATA da integração REDECARD não enviado. Campo DISTRIBUIDOR da integração REDECARD não enviado. Campo TAXAEMBARQUE da integração REDECARD não enviado. Campo ENTRADA da integração REDECARD não enviado. Campo NUMDOC1 da integração REDECARD não enviado. Campo NUMDOC2 da integração REDECARD não enviado. Campo NUMDOC3 da integração REDECARD não enviado. Campo NUMDOC4 da integração REDECARD não enviado. Campo PAX1 da integração REDECARD não enviado. Campo PAX2 da integração REDECARD não enviado. Campo PAX3 da integração REDECARD não enviado. Campo PAX4 da integração REDECARD não enviado. Campo ADD_DATA da integração REDECARD não enviado. Campo CONCENTRADOR da integração REDECARD não enviado. 8. Tabela de status da transação Os status para identificar as transações são os encontrados na tabela abaixo Status Descrição 2 Pendente Captura 3 Aguardando aprovação do adquirente 4 Incompleta 5 Erro 6 Reprovada pelo adquirente 7 Captura reprovada pelo adquirente 8 Erro na captura EvoluCard Manual de Integração Redirecionamento Versão 1.1 Outubro.2011 15
9 Reprovada 10 Reprovada por Token 15 Finalizado 9. Campos para integração com gateways e adquirentes Como explicado anteriormente, a EvoluCard mantém o mesmo fluxo utilizado pelo estabelecimento para efetuar as transações. Por isso, temos no cadastro do estabelecimento todos os parâmetros fixos, que ele precisa enviar aos gateways de pagamento ou adquirentes para se identificar. Além disso, para alguns estabelecimentos será necessário enviar parâmetros adicionais a cada transação, como Taxa de Embarque para uma companhia aérea. Esses parâmetros, variáveis, são enviados juntamente com os demais parâmetros do método gethash, identificados por additionalparams.parâmetro. Na integração por HTTPS/POST, por exemplo, caso tenha que ser enviado o parâmetro IATA, o nome do parâmetro na requisição será additionalparams.iata. Os parâmetros variáveis que precisarão ser enviados sempre serão mantidos no cadastro do estabelecimento, para que a EvoluCard consiga validar se eles estão sendo enviados. Abaixo teremos as tabelas referentes a cada integração e seus parâmetros seguindo a seguinte legenda: OF Obrigatório e Fixo O campo deve sempre ser enviado para o gateway, mas ficará cadastrado em nosso sistema pois será fixo (sempre será enviado o mesmo valor) OV Obrigatório e Variável - O campo deve sempre ser enviado para o gateway e deve sempre ser enviado do estabelecimento para EvoluCard pois é variável a cada transação. NF Não obrigatório e Fixo - O campo pode ou não ser enviado ao gateway, então no cadastro do estabelecimento será preenchido como obrigatório ou não de acordo com a opção do estabelecimento. Se escolhido obrigatório, seu valor será preenchido já no cadastro e será sempre enviado pela EvoluCard para o gateway. NV Não obrigatório e Variável - O campo pode ou não ser enviado ao gateway, então no cadastro do estabelecimento será preenchido como obrigatório ou não de acordo com a opção do estabelecimento. Se escolhido obrigatório, seu valor deve sempre ser enviado pelo estabelecimento à EvoluCard a cada transação. Caso contrário, mesmo que enviado pelo estabelecimento, a EvoluCard não repassará esse campo ao gateway. Serão colocadas apenas as descrições dos parâmetros obrigatórios, os demais parâmetros devem ser avaliados utilizando os manuais de cada gateway/adquirente. EvoluCard Manual de Integração Redirecionamento Versão 1.1 Outubro.2011 16
9.1. Integração CIELO Parâmetro Descrição Tipo Exemplo Chave de Acesso Número da Afiliação Chave de acesso fixa usada pela Cielo Número de afiliação do estabelecimento com a Cielo OF n/a OF 1191214323 9.2. Integração REDECARD Parâmetro Descrição Tipo Exemplo Número de Filiação Número de afiliação do estabelecimento com a Redecard OF 17651321 ENTRADA n/a NF n/a IATA n/a NF n/a DISTRIBUIDOR n/a NF n/a CONCENTRADOR n/a NF n/a TAXAEMBARQUE n/a NV n/a NUMDOC1 n/a NV n/a NUMDOC2 n/a NV n/a NUMDOC3 n/a NV n/a NUMDOC4 n/a NV n/a ADD_DATA n/a NV n/a PABX1 n/a NV n/a PABX2 n/a NV n/a PABX3 n/a NV n/a PABX4 n/a NV n/a 10. Operações de Teste Antes que as transações sejam encaminhadas para o ambiente de produção real, é fornecido um ambiente de teste, no qual as transações não são de fato realizadas. Esse serve, portanto, apenas para testar o sistema do estabelecimento sem submeter transações reais. Os métodos de teste são os mesmos do ambiente de produção, apenas trocando a palavra redirectservice por redirectservicetest nas urls, ou seja, seguem o esquema https://www.evolucard.com.br/redirectservicetest/nome_do_metodo. Abaixo, exemplificamos a mudança da url de produção para testes no método gethash : EvoluCard Manual de Integração Redirecionamento Versão 1.1 Outubro.2011 17
Protocolo/Método Endereço de produção Endereço de teste HTTPS/POST https://www.evolucard.com.br/redirectservice/gethash https://www.evolucard.com.br/redirectservicetest/gethash No caso da etapa de redirecionamento (Etapa 3-6.3), adicione a palavra Test no final da url, ou seja, troque de "https://www.evolucard.com.br/ecommerce" para "https://www.evolucard.com.br/ecommercetest". Destacamos que os parâmetros de todas as funcionalidades são mantidos de acordo com o que foi estabelecido para a fase real. Previamente à realização dos testes, é importante que o desenvolvedor do estabelecimento contate o suporte técnico da EvoluCard, com o propósito de verificar se o cadastro do estabelecimento está correto e liberado para utilização. Para a realização dos testes é essencial que os dados do estabelecimento sejam reais. Quanto aos demais dados da transação, inclusive os do cliente, dados fictícios serão aceitos, pois não acontecerá o envio dessas transações para o adquirente ou gateway de pagamentos. 10.1. Aprovação e reprovação A aprovação ou reprovação no ambiente de teste depende do valor da transação. Caso a transação tenha centavos no valor, como R$ 100.01, então a transação será reprovada. Senão, como em R$ 100.00, será aprovada. 10.2. Envio do TOKEN No ambiente de teste o TOKEN não é enviado por SMS/ligação, mas é apresentado em tela durante a confirmação da venda, no ambiente da EvoluCard. Assim, basta o usuário ver o token na tela e digitá-lo. 10.3. Reenvio do TOKEN Como não há envio de token no ambiente de testes, obviamente também não será permitida a ação de reenvio, presente no ambiente de produção. 11. Processo de Homologação Para iniciar as operações em ambiente de produção, o desenvolvedor do estabelecimento deve contatar o suporte técnico da EvoluCard e realizar uma solicitação de homologação. Uma bateria de testes será realizada antes da migração de ambientes. Após o estabelecimento ser aprovado nos testes, a EvoluCard notificará a liberação do ambiente de produção e, a partir daí, o ambiente de testes ficará indisponível automaticamente. Caso seja necessária alguma alteração no cadastro do estabelecimento, o desenvolvedor do estabelecimento deverá notificar a EvoluCard, através do suporte técnico, para que essa modificação seja realizada. 12. Suporte Técnico Em caso de dúvidas ou problemas durante o desenvolvimento do processo de integração, a EvoluCard disponibiliza o e-mail suporteweb@evolucard.com.br EvoluCard Manual de Integração Redirecionamento Versão 1.1 Outubro.2011 18
Para entrar em contato, tenha em mãos o código de identificação do estabelecimento junto à EvoluCard. Os colaboradores do suporte da EvoluCard não estão autorizados a: - Receber ou fornecer dados de cadastro do cliente, ainda que seja para finalidade de testes; - Fornecer informações comerciais sobre o estabelecimento; - Realizar alterações no código fonte do estabelecimento, independentemente da linguagem de programação. EvoluCard Manual de Integração Redirecionamento Versão 1.1 Outubro.2011 19
ANEXO I Diagrama da integração Redirecionamento com Captura Automática Redirecionamento com Captura Manual EvoluCard Manual de Integração Redirecionamento Versão 1.1 Outubro.2011 20
ANEXO II Diagrama dos atores da integração EvoluCard Manual de Integração Redirecionamento Versão 1.1 Outubro.2011 21