e-Rede A Rede cuida das suas vendas on-line. E você cuida só do seu negócio. Veja a seguir as principais atualizações realizadas no Sistema e nos Materiais de Integração da Rede: estamos todos ligados Guia do Desenvolvedor Interfaces Página 35 No final da tabela, dos erros 821 a 829, foram adicionados os descritivos. Página 14 – 1.4.2 – Exemplo da Resposta de Consulta XML realizada com êxito Houve uma substituição do XML: De: <Response version=’2’> <HpsTxn> <card_scheme>MasterCard</card_scheme> <country>BRL</country> <expirydate>1214</expirydate> <issuer>Mybank PL</issuer> <pan>544433******1111</pan> <capture_status>populated</capture_status> <cv2_captured>No</cv2_captured> </HpsTxn> <gateway_reference>4000900012345671</gateway_reference> <information>You have queried an HPS transaction, which has stored data that has not yet been used</information> <merchantreference>mref123401</merchantreference> <mode>TEST</mode> <reason>ACCEPTED</reason> <status>1</status> <time>1256046399</time> </Response> Para: <Response version=’2’> <HpsTxn> <card_scheme>MasterCard</card_scheme> <country>BRL</country> <expirydate>1214</expirydate> <issuer>Mybank PL</issuer> <pan>544433******1111</pan> <capture_status>populated</capture_status> <cv2_captured>No</cv2_captured> <dc_response>1</dc_response> </HpsTxn> <gateway_reference>4000900012345671</gateway_reference> <information>You have queried an HPS transaction, which has stored data that has not yet been used</ information> <merchantreference>mref123401</merchantreference> <mode>TEST</mode> <reason>ACCEPTED</reason> <status>1</status> <time>1256046399</time> </Response> Guia do Desenvolvedor Interfaces Página 16 – 1.4.4 Houve uma substituição do XML: De: <Response version=’2’> <HpsTxn> <card_scheme>MasterCard</card_scheme> <country>BRL</country> <expirydate>1214</expirydate> <issuer>Mybank PL</issuer> <pan>544433******1111</pan> <DynamicCapture> <capf1>A. N. Other</capf1> <capf3>%3Cid%3Ecat%3C%2Fid%3E</capf3> <capf6>cat</capf6> <capf9>87</capf9> </DynamicCapture> </HpsTxn> <gateway_reference>4000900012345671</gateway_reference> <information>You have queried an HPS transaction, which has stored data that has not yet been used</information> <merchantreference>mref123401</merchantreference> <mode>TEST</mode> <reason>ACCEPTED</reason> <status>1</status> <time>1256046399</time> </Response> Para: <Response version=’2’> <HpsTxn> <card_scheme>MasterCard</card_scheme> <country>BRL</country> <expirydate>1214</expirydate> <issuer>Mybank PL</issuer> <pan>544433******1111</pan> <DynamicCapture> <capf1>A. N. Other</capf1> <capf3>%3Cid%3Ecat%3C%2Fid%3E</capf3> <capf6>cat</capf6> <capf9>87</capf9> </DynamicCapture> <dc_response>1</dc_response> </HpsTxn> <gateway_reference>4000900012345671</gateway_reference> <information>You have queried an HPS transaction, which has stored data that has not yet been used</ information> <merchantreference>mref123401</merchantreference> <mode>TEST</mode> <reason>ACCEPTED</reason> <status>1</status> <time>1256046399</time> </Response> Guia do Desenvolvedor Interfaces Página 26 – 2.2.1 Houve uma substituição do XML: De: <Response version=’2’> <HpsTxn> <hps_url>https://dev.example.com/hps/</hps_url> <session_id>1172</session_id> </HpsTxn> <gateway_reference>4000900012345671</gateway_reference> <merchantreference>mref-123456</merchantreference> <mode>TEST</mode> <reason>ACCEPTED</reason> <status>1</status> <time>1258553216</time> </Response> Para: <Response version=’2’> <HpsTxn> <hps_url>https://dev.example.com/hps/</hps_url> <session_id>1172</session_id> <dc_response>1</dc_response> </HpsTxn> <gateway_reference>4000900012345671</gateway_reference> <merchantreference>mref-123456</merchantreference> <mode>TEST</mode> <reason>ACCEPTED</reason> <status>1</status> <time>1258553216</time> </Response> Guia do Desenvolvedor Interfaces Página 30 – 2.4.3 Houve uma substituição do XML: De: <Response version=’2’> <HpsTxn> <session_id>1172</session_id> <gateway_reference>4000900012345674</gateway_reference> <AuthAttempts> <Attempt> <gateway_reference>4000900012345672</gateway_reference> <reason>Declined</reason> <status>7</status> </Attempt> <Attempt> <gateway_reference>4000900012345673</gateway_reference> <reason>Declined</reason> <status>7</status> </Attempt> <Attempt> <gateway_reference>4000900012345674</gateway_reference> <reason>ACCEPTED</reason> <status>1</status> </Attempt> </AuthAttempts> </HpsTxn> <gateway_reference>4000900012345671</gateway_reference> <merchantreference>mref-123456</merchantreference> <mode>TEST</mode> <reason>ACCEPTED</reason> <status>1</status> <time>_UNIX_TIME_</time> </Response> (continua na próxima página) Guia do Desenvolvedor Interfaces Página 30 – 2.4.3 Houve uma substituição do XML: Para: <Response version=’2’> <HpsTxn> <session_id>1172</session_id> <gateway_reference>4000900012345674</gateway_reference> <AuthAttempts> <Attempt> <gateway_reference>4000900012345672</gateway_reference> <reason>Declined</reason> <status>7</status> </Attempt> <Attempt> <gateway_reference>4000900012345673</gateway_reference> <reason>Declined</reason> <status>7</status> </Attempt> <Attempt> <gateway_reference>4000900012345674</gateway_reference> <dc_response>1</dc_response> <reason>ACCEPTED</reason> <status>1</status> </Attempt> </AuthAttempts> </HpsTxn> <gateway_reference>4000900012345671</gateway_reference> <merchantreference>mref-123456</merchantreference> <mode>TEST</mode> <reason>ACCEPTED</reason> <status>1</status> <time>_UNIX_TIME_</time> </Response> Guia Desenvolvedor Análise de Risco Página 6 Foi adicionado o seguinte tópico: Serviço de Validação de CPF: Um dos serviços opcionais do módulo antifraude do e-Rede é a validação de CPF (Cadastro de Pessoas Físicas). Esse serviço faz a verificação dos dígitos finais do CPF do portador do cartão para garantir que o CPF digitado é válido. Caso o CPF digitado seja inválido, a transação será negada. Para utilizar o Serviço de Validação de CPF, é preciso fazer apenas duas inclusões no bloco Risk do XML da transação: 1) Popular o elemento <id_number></id_number> do sub-bloco <Personal Details> com o CPF do comprador; 2) Popular o elemento <id_type></id_type> do sub-bloco <Personal Details> com o valor 21. Atenção: se mesmo o valor do elemento <id_number> for populado corretamente, mas o valor do elemento <id_type> for diferente de 21, a transação será negada. Página 9 Houve a remoção do seguinte item: Shipping Details ** Guia Desenvolvedor Análise de Risco Página 14 Foram adicionadas novas informações: De: “Nome do campo: id_number Definição: passaporte, ID ou outro número de documento de verificação. Esse é geralmente usado com referência a determinados serviços de verificação eletrônica de ID de terceiros.” Para: “Nome do campo: id_number Definição: CPF (Cadastro de Pessoas Físicas), passaporte, ID ou outro número de documento de verificação. Esse é geralmente usado com referência a determinados serviços de verificação eletrônica de ID de terceiros. Esse é um dos campos utilizados no Serviço de Validação de CPF. Para maiores informações sobre o Serviço de Validação de CPF ver seção 999 desse Guia de Integração.” Guia Desenvolvedor Análise de Risco Página 15 Foram adicionadas novas informações: De: nome do campo: definição: Um código que define o tipo de documento de verificação fornecido. valores possíveis: 1 = Passaporte 2 = ID Pessoal 3 = Carteira de Identidade 4 = Carteira de Habilitação 8 = Documento de Viagem 12 = Autorização de Residência 13 = Certidão de Identidade 16 = Cadastro Geral de Contribuintes 17 = Título de Eleitor Este é geralmente usado com referência a determinados serviços de verificação eletrônica de ID de terceiros. Para: nome do campo: id_type definição: Um código que define o tipo de documento de verificação fornecido. valor possível: 21 = CPF (Cadastro de Pessoas Físicas) Este é geralmente usado com referência a determinados serviços de verificação eletrônica de ID de terceiros. Ao utilizar o Serviço de Validação de CPF, certifique-se de preencher esse campo com o valor 21, caso contrário, as transações serão negadas. Guia Desenvolvedor Análise de Risco Página 17 Houve a remoção do seguinte bloco: Shipping Details ** Página 20 Foram adicionadas novas informações: De: nome do campo: unit_price definição: O valor da transação na menor unidade da moeda, p.ex., centavo Para: nome do campo: unit_price definição: O valor da transação na menor unidade da moeda Exemplo: O valor de R$5,32 deve ser representado conforme a seguir: <unit_price>532</unit_price> Página 25 Houve a remoção do seguinte bloco: <ShippingDetails> <address_line1>123 High Street</address_line1> <address_line2>Corner Main Street</address_line2> <city>Mytown</city> <state_province>NSW</state_province> <country>Australia</country> <zip_code>2999</zip_code> </ShippingDetails> Guia Desenvolvedor Análise de Risco Página 26 Houve a remoção do ponto entre os números: De: <unit_price>4.11</unit_price> Para: <unit_price>411</unit_price> Página 27 Houve a remoção do ponto entre os números: De: <unit_price>5.32</unit_price> Para: <unit_price>532</unit_price> Página 33 A informação foi atualizada: De: 0=Release: Transação não liberada pelos Sistemas de Fraude e Risco, pois ela foi considerada como não fraudulenta durante a varredura. Para: 0=Release: Transação liberada pelos Sistemas de Fraude e Risco, pois ela foi considerada como não fraudulenta durante a varredura. Página 25 – Item 2.2.3.2 Houve a alteração do XML. Guia do Desenvolvedor Recorrência Página 17 Foram adicionadas novas informações: De: Este Serviço permite o processamento de pagamentos recorrentes em um Estabelecimento Comercial habilitado para transacionar com Transações Recorrentes com cartões de Crédito das bandeiras Master, Diners, Visa e Hipercard sem necessidade de desenvolvimento de um sistema para envio das solicitações de transação individuais ao e-Commerce Redecard. Para: Este Serviço permite o processamento de pagamentos recorrentes em um Estabelecimento Comercial habilitado para transacionar com Transações Recorrentes com cartões de Crédito das bandeiras Master, Diners, Visa e Hipercard sem necessidade de desenvolvimento de um sistema para envio das solicitações de transação individuais ao e-Commerce Redecard. OBS: Quando um cartão de crédito tem a validade expirada em algum momento da recorrência, o agendamento será interrompido e deve-se criar uma nova transação de recorrência. Guia do Desenvolvedor e-Rede Página 18 – Elementos de TxnDetails Houve uma mudança de número de caracteres: De: “Mínimo de 6 e máximo de 30 caracteres alfanuméricos. Deve ser único...” Para: “Mínimo de 6 e máximo de 17 caracteres alfanuméricos. Deve ser único...” Página 14 Foram adicionadas novas informações: De: As legendas a seguir são utilizadas para cada tipo de transação: • A – auth • P – pre • C – cancel • F – fulfill Para: As legendas a seguir são utilizadas para cada tipo de transação: • A – auth • P – pre • C – cancel • F – fulfill • R – refund • TR – txn_refund • ARR – authorize_referral_request OBS: R, TR e ARR não se aplicam. Não devem ser utilizados.