Pagamento Recorrente estamos todos ligados



Documentos relacionados
Manual do Desenvolvedor Pagamento Recorrente. Fevereiro de 2013 Versão 2

Interface Padrão e Interface Personalizada estamos todos ligados

Desenvolvedores do e-rede estamos todos ligados

e-rede A Rede cuida das suas vendas on-line. E você cuida só do seu negócio.

Boleto Bancário estamos todos ligados

Manual do Desenvolvedor

3-D Secure estamos todos ligados

Desenvolvedores do e-rede estamos todos ligados

Manual do Desenvolvedor 3-D Secure. Março de 2013 Versão 1.4

Integração ao e-rede estamos todos ligados

Pagador Transaction. Consulta. Versão 1.3

1. Tela de Acesso pg Cadastro pg Abas de navegação pg Abas dados cadastrais pg Aba grupo de usuários pg.

Sistema TO Captura Offline Cancelamento Eletrônico

Guia Site Empresarial

Manual do Desenvolvedor

American Work Guia de Primeiros Passos

Material de Apoio. SEB - Contas a Pagar. Versão Data Responsável Contato 1 05/12/2011 Paula Fidalgo paulaf@systemsadvisers.com

Sistema TO Captura Offline

Análise de Dados do Financeiro

Manutenção de Domicílio Bancário no Mercado de Cartões

Manual Cobrança Recorrente

Tel. (0xx11) Fax (0xx11)

Gestão de Ativos. Manual do Usuário. Treinamento Fase 1 (TRN 01)

Manual Operacional SIGA

Assessoria Técnica de Tecnologia da Informação - ATTI. Projeto de Informatização da. Secretaria Municipal de Saúde do. Município de São Paulo

Emissão de Nota Fiscal de Serviço Eletrônica

Manual do Desenvolvedor EEVC. Extrato Eletrônico de. Vendas Crédito. estamos todos ligados

Manual de Integração ao e-commerce Redecard. Fevereiro de 2013 Versão de software: Versão 1.2

INT.COM INTERFACE COMERCIAL HONDA 2W

Manual de digitação de contas Portal AFPERGS

Extrato Eletrônico & Captura Off-line

Sistema de Pagamento Seguro

SISCOMEX EXPORTAÇÃO WEB

OI À VONTADE NOS CARTÕES VISA OU MASTERCARD

Módulo e-rede Prestashop v1.0. Manual de. Instalação do Módulo. estamos todos ligados

Manual Sistema de Autorização Online GW

Manutenção de Domicílio Bancário no Mercado de Cartões. Cartilha.

Agendamento para Importação de Notas Fiscais

Treinamento Sistema Folha Union Módulo III

SERVIÇO PÚBLICO FEDERAL MINISTÉRIO DA EDUCAÇÃO UNIVERSIDADE FEDERAL DE RORAIMA DIRETORIA DE TECNOLOGIA DA INFORMAÇÃO SIGRH - FREQUÊNCIA

Treinamento Sistema Folha Union Módulo III

para outro) 23 ÍNDICE ERP 1- Cadastro de Produtos (Implantação no Almoxarifado) 04

Manual da Nota Fiscal Eletrônica

Manual do Visualizador NF e KEY BEST

PRACTICO LIVE! FINANCEIRO CONFIGURAÇÕES BÁSICAS

Este regulamento está em vigor a partir do 11/07/2007 (inclusive) substituindo e cancelando o anterior

Manual. do POS. O novo POS é de fácil uso e aplicação. Conheça suas funções e características

MODULO DE GESTÃO MANUTENÇÃO DE MATRÍCULA. O módulo de Gestão tem por objetivo gerenciar as atividades que ocorrem durante um ano letivo.

REGULAMENTO DO SERVIÇO DE MENSAGEM BRADESCO

MANUAL DE UTILIZAÇÃO. ENVIO DE SMS.

Passo-a-passo para acesso ao novo sistema de reservas de salas no Rochaverá

Manual do Desenvolvedor EEVD. Extrato Eletrônico de. Vendas Débito. estamos todos ligados

Novell. Novell Teaming 1.0. novdocx (pt-br) 6 April 2007 EXPLORAR O PORTLET BEM-VINDO DESCUBRA SEU CAMINHO USANDO O NOVELL TEAMING NAVIGATOR

Renova Fácil. Guia Renova Fácil. O serviço Renova Fácil traz garantia e tranqüilidade à estabelecimentos que efetuam vendas recorrentes.

Manual do usuário SIACC CAIXA Programado 1

PASSO A PASSO LOJA VIRTUAL. 1º Passo Acessar o site do Bom Jesus (

Assim que o usuário entrar nesta ferramenta do sistema a seguinte tela será exibida:

Nome do Boletim (Pagamento de Extrato Eletrônico via Cartão)

SISTEMAS OPERACIONAIS LIVRES. Professor Carlos Muniz

1 Cadastre-se Mozilla Firefox. AQUI Esqueci a senha Login Senha. Esqueci a senha Login Enviar Solicitação OBS: Nome: Login:

1 Essa é a tela de login do Sistema de Atendimento Online, siga o passo a passo abaixo.

Módulo e-rede OpenCart v1.0. Manual de. Instalação do Módulo. estamos todos ligados

PLATAFORMA PAGADOR AUTORIZAÇÃO, CANCELAMENTO E CAPTURA.

Manual de Integração Retorno dos dados do cliente

Manual Passo a Passo

Fluxo de trabalho do Capture Pro Software: Indexação de OCR e separação de documentos de código de correção

MODULO DE GESTÃO MANUTENÇÃO DE MATRÍCULA. O módulo de Gestão tem por objetivo gerenciar as atividades que ocorrem durante um ano letivo.

Tutorial para localizar centros de testes e/ou agendar o exames EXIN na PROMETRIC

ÍNDICE 1. CADASTRO DE BOLSAS... 2

Manual de Matrícula Web

Manual de Orientação nº 3

Manual do Programa de Caixa1

CADASTRO DE CLIENTES

gsd - Service Desk Manual do Usuário versão 1

Desenvolvedor Plug in Magento estamos todos ligados

Módulo e-rede OSCommerce v1.0. Manual de. Instalação do Módulo. estamos todos ligados

Manual Passo a Passo

Módulo e-rede Magento v1.0. Manual de. Instalação do Módulo. estamos todos ligados

Departamento de Gestão da Rede Prestadora

Projeto de Modernização do Sistema Câmbio Orientação Técnica. Versão 1.0.1

BOLETIM INFORMATIVO TÉCNICO LIBERAÇÃO DE ATUALIZAÇÃO - CORDILHEIRA VERSÃO 2

Passo a passo de Alteração de Responsáveis Técnico e Legal na AFE e AE.

Módulo e-rede OpenCart v1.0. Manual de. Instalação do Módulo. estamos todos ligados

Guia de Integração para Transferência

Manual de utilização do sistema OTRS (Atendimento) Cliente Externo

Este regulamento está em vigor a partir do 11/07/2007 (inclusive) substituindo e cancelando o anterior

Treinamento de. Linx Pos

Tutorial para localizar centros de testes e/ou agendar o exames EXIN na PROMETRIC

Mensagens De Erro. Versão: 1.0

Gerência de Relacionamento e Negócios. Geren GRI

Realizando Vendas no site do Cartão BNDES

Módulo GerenciaNet para WHMCS

Guia de Operação do Terminal Bin

MANUAL TISS Versão

Tutorial contas a pagar

Software. Gerenciamento de Manutenção

PLATIN INFORMÁTICA. SIAD SNGPC Sistema Integrado de Automação de Drogarias Módulo Gestão de Medicamentos Controlado e Antimicrobianos

TUTORIAL MRV CORRETOR

Módulo e-rede VirtueMart v1.0. Manual de. Instalação do Módulo. estamos todos ligados

Transcrição:

Manual do Desenvolvedor Pagamento Recorrente estamos todos ligados

01 02 03 Pagamento Recorrente 4 Método de captura de transações recorrentes 4 2.1 2.1.1 2.2 2.2.1 2.2.2 Elementos esquemáticos da solicitação 5 TxnDetails 5 Exemplo de Solicitação XML 6 Transações Ecomm 6 Transações cont_auth 7 Pagamento recorrente histórico 7 3.1 Elementos esquemáticos da solicitação 7 3.1.1 ContAuthTxn 9 3.1.2 HistoricTxn 10 3.2 Exemplo de Solicitações XML 11 3.3 Elementos da resposta 13 3.3.1 ContAuthTxn 13 3.4 Exemplo de Respostas XML 14 3.4.1 Respostas bem-sucedidas 14 3.4.2 Respostas rejeitadas ou com falha 15 Clique nos hiperlinks para navegar no material do Manual do Desenvolvedor Pagamento Recorrente.

04 Pagamento Recorrente Agendado_ 17 4.1 Elementos da solicitação 17 4.1.1 ContAuthTxn 18 4.1.2 LastPayment 20 4.2 Exemplo de Solicitações XML 21 4.3 Elementos da resposta 24 4.3.1 ContAuthTxn 24 4.4 Exemplo de Respostas XML 25 05 Códigos de resposta para pagamentos com cartão recorrentes 26 Clique nos hiperlinks para navegar no material do Manual do Desenvolvedor Pagamento Recorrente.

4 01 Pagamento Recorrente O Pagamento Recorrente é uma modalidade de captura muito utilizada por estabelecimentos comerciais que trabalham com transações mensais, ou seja, mensalmente o estabelecimento necessita efetuar uma transação no cartão do seu cliente. É muito utilizado por academias e empresas de assinaturas de jornais e revistas. Para essa captura, a Rede conta com dois modelos que se adaptam ao seu negócio: Pagamento Recorrente Agendado, no qual o controle dos pagamentos fica por conta do e-rede, mediante sua programação, e o Pagamento Recorrente Histórico, no qual o controle dos pagamentos fica no estabelecimento. 02 Método de captura de transações recorrentes O método de captura de transações recorrentes permite o processamento de pagamentos repetidos em um estabelecimento comercial habilitado para transacionar com transações recorrentes com cartões de crédito das bandeiras MasterCard, Diners, Visa e Hipercard. Ao enviar uma transação ao e-rede, um indicador adicional especifica se o estabelecimento comercial deseja que a transação seja processada como uma transação normal ou recorrente.

5 2.1 Elementos esquemáticos da solicitação Nesta seção, são apresentados os campos obrigatórios para cada tipo de método de captura, bem como exemplos de XML desses campos. Se um tipo de método de captura for especificado no XML, isto é, destacado para indicar que outros tipos de métodos de captura podem ser utilizados em seu lugar. Os dados do método de captura do serviço de transações recorrentes são transmitidos em três lugares diferentes do esquema: Request º Authentication - Consulte a seção 2.1.1.1.1 da referência dos desenvolvedores do e-rede º Transaction CardTxn - O tipo de transação e código de autorização - Consulte a seção 2.2.1.2 do Guia de Referência dos Desenvolvedores do e-rede Card - Contém todas as informações sobre o cartão - Consulte a seção 2.2.1.1 do Guia de Referência dos Desenvolvedores do e-rede TxnDetails - Contém detalhes sobre a transação - Consulte a seção 2.1.1 deste documento Ao utilizar este serviço, um único elemento extra é fornecido no elemento principal TxnDetails das transações. 2.1.1 TxnDetails Nome do elemento Posição TxnDetails Request.Transaction

6 Elementos de TxnDetails Nome do elemento Descrição Valores / Limitações merchantreference amount Consulte o Guia de Referência dos Desenvolvedores do e-rede, seção 2.2.1.3 capturemethod Especifica o ambiente da transação ecomm 2.2 2.2.1 Exemplo de Solicitação XML Transações Ecomm Exemplo de Solicitação XML para uma transação inicial ecomm <Request version= 2 > <Authentication> <password>******</password> <AcquirerCode> <rdcd_pv>123456789</rdcd_pv> </AcquirerCode> </Authentication> <Transaction> <TxnDetails> <merchantreference>123404</merchantreference> <amount currency= BRL >100.00</amount> <capturemethod>ecomm</capturemethod> </TxnDetails> <CardTxn> <method>pre</method> <Card> <expirydate>02/14</expirydate> <pan>544433*********1</pan> </Card> </CardTxn> </Transaction> </Request>

7 2.2.2 Transações cont_auth Para enviar uma transação cont_auth, os estabelecimentos comerciais utilizam a mesma Solicitação XML exibida na seção 2.2.1, apenas alterando o valor do método de captura. 03 Pagamento Recorrente Histórico 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 MasterCard, Diners, Visa e Hipercard. Quando o primeiro pagamento for efetuado a partir do cartão, uma conta também é configurada no e-rede. Se desejar efetuar um pagamento recorrente, os detalhes desta conta são transmitidos ao e-rede, e não os detalhes do cartão. Isso permite que um estabelecimento comercial controle os cronogramas e o valor de cada transação. 3.1 Elementos esquemáticos da solicitação Nesta seção, são apresentados os campos obrigatórios para cada tipo de transação, bem como exemplos de XML desses campos. Para configurações de conta recorrente Para autorizar o primeiro pagamento e configurar a conta de um cartão, as informações precisam ser coletadas e configuradas nos lugares a seguir do esquema:

8 Request º Authentication - Consulte a seção 2.1.1.1.1 da referência dos desenvolvedores do e-rede º Transaction TxnDetails - Contém detalhes sobre a transação - Consulte a seção 2.1.1 CardTxn º Card - Este elemento contém os detalhes sobre o cartão, somente para fins de configuração. Esses detalhes são iguais aos dos pagamentos únicos, que são abordados na seção 2.2.1.1 do Guia de Referência dos Desenvolvedores do e-rede ContAuthTxn - Seção 3.1.1 Para pagamentos repetidos Assim que a conta for configurada, é possível efetuar pagamentos repetidos. Request º Authentication - Consulte a seção 2.1.1.1.1 do Guia de Referência dos Desenvolvedores do e-rede º Transaction TxnDetails - Contém detalhes da transação - Seção 2.2.13 do Guia de Referência dos Desenvolvedores do e-rede º HistoricTxn - Consulte a seção 3.1.2 Para estornos/cancelamentos de transações/ contas Os estornos/cancelamentos de transações/contas são realizados com os mesmos dados utilizados para estornos de transações realizadas com cartões de crédito:

9 Request º Authentication - Consulte a seção 2.1.1.1.1 do Guia de Referência dos Desenvolvedores do e-rede º Transaction HistoricTxn - Seção 3.1.2 3.1.1 ContAuthTxn Este elemento deve ser inserido com as solicitações de configuração e pagamento recorrente. Ele possui um atributo e nenhum elemento secundário. Nome do Elemento Posição ContAuthTxn Request.Transaction Atributos de ContAuthTxn Atributos Atributo do elemento Descrição Valores / Limitações type ContAuthTxn Indica se a transação é uma configuração ou um pagamento repetido setup historic Exemplo XML de elementos ContAuthTxn <ContAuthTxn type= setup ></ContAuthTxn> <ContAuthTxn type= setup /> <ContAuthTxn type= historic />

10 3.1.2 HistoricTxn Este elemento é necessário para pagamentos recorrentes, estornos de transações e cancelamentos de contas. Ele não deve ser inserido com a transação de configuração. Nome do elemento Posição HistoricTxn Request.Transaction Elementos de HistoricTxn Nome do elemento Descrição Valores / Limitações method reference Indica o tipo de transação Para pagamentos: o elemento ca_reference da conta a partir da qual o pagamento é efetuado Para estorno/cancelamento: o elemento ca_reference da conta ou pagamento a ser cancelado pre auth cancel Deve ser uma conta válida Deve ser uma transação/ conta válida Exemplo XML de elementos HistoricTxn <HistoricTxn> <method>auth</method> <reference>4700200040912890</reference> </HistoricTxn> <HistoricTxn> <method>cancel</method> <reference>4700200040919424</reference> </HistoricTxn>

11 3.2 Exemplo de Solicitações XML Exemplo de Solicitação XML de configuração de conta A transação inicial será processada como transação ecomm <Request version= 2 > <Authentication> <AcquirerCode> <rdcd_pv>123456789</rdcd_pv> </AcquirerCode> <password>********</password> </Authentication> <Transaction> <ContAuthTxn type= setup /> <TxnDetails> <merchantreference>385036349305556</merchantreference> <amount currency= BRL >1001.00</amount> <capturemethod>ecomm</capturemethod> </TxnDetails> <CardTxn> <Card> <expirydate>01/14</expirydate> <pan>544433*********1</pan> <Cv2Avs> <cv2>321</cv2> </Cv2Avs> </Card> <method>auth</method> </CardTxn> </Transaction> </Request> Exemplo de Solicitação XML para pagamento repetido

12 <Request version= 2 > <Authentication> <AcquirerCode> <rdcd_pv>123456789</rdcd_pv> </AcquirerCode> <password>********</password> </Authentication> <Transaction> <ContAuthTxn type= historic /> <TxnDetails> <merchantreference>3851231</merchantreference> <capturemethod>cont_auth</capturemethod> <amount currency= BRL >18.50</amount> </TxnDetails> <HistoricTxn> <reference>5300200040925092</reference> <method>auth</method> </HistoricTxn> </Transaction> </Request> Exemplo de Solicitação XML para estorno/cancelamento de uma transação/conta <Request version= 2 > <Authentication> <password>********</password> <AcquirerCode> <rdcd_pv>123456789</rdcd_pv> </AcquirerCode> </Authentication> <Transaction> <HistoricTxn> <method>cancel</method> <reference>4800200040644359</reference> </HistoricTxn> </Transaction> </Request>

13 3.3 Elementos da resposta Além dos elementos abordados nesta seção, as respostas desse serviço contêm os elementos de resposta gerais destacados na seção 2.1.1.2 do Guia de Referência dos Desenvolvedores do e-rede. O elemento CardTxn também será inserido, conforme descrito na seção 2.2.3.1 do Guia de Referência dos Desenvolvedores do e-rede. 3.3.1 ContAuthTxn Nome do elemento Posição ContAuthTxn Resposta Elementos de ContAuthTxn Nome do elemento ca_reference account_status Descrição O número de referência da conta de autorização contínua. Incluso na resposta do e-rede após uma configuração de conta realizada com êxito Fornece informações adicionais sobre o status da conta Exemplo do elemento ContAuthTxn <ContAuthTxn> <account_status>account setup. ECOMM transaction sent successfully</account_status> <ca_reference>4500200040151462</ca_reference> </ContAuthTxn>

14 3.4 Exemplo de Respostas XML 3.4.1 Respostas bem-sucedidas Exemplo de Resposta XML para uma configuração realizada com êxito <Response version= 2 > <CardTxn> <authcode>100001</authcode> <card_scheme>mastercard</card_scheme> <country>australia</country> </CardTxn> <ContAuthTxn> <account_status>account setup. ECOMM transaction sent successfully</account_status> <ca_reference>4700200040641889</ca_reference> </ContAuthTxn> <gateway_reference>4700200040641890</gateway_reference> <merchantreference>setupreference12345680</merchantreference> <mode> </mode> <reason>accepted</reason> <status>1</status> <time> </time> </Response> Exemplo de Resposta XML de um pagamento recorrente realizado com êxito <Response version= 2 > <CardTxn> <authcode>779099</authcode> <card_scheme>mastercard</card_scheme> <country>australia</country> </CardTxn> <ContAuthTxn> <account_status>using account ref 4500200040925092. CONT_AUTH transaction complete</account_status> </ContAuthTxn>

15 <gateway_reference>5000200040925117</gateway_reference> <merchantreference>385036359953704</merchantreference> <mode> </mode> <reason>accepted</reason> <status>1</status> <time> </time> </Response> Exemplo de Resposta XML de uma conta cancelada com êxito <Response version= 2 > <gateway_reference>4400200040943162</gateway_reference> <information>continuous authority account cancelled</information> <merchantreference>4500200040925092</merchantreference> <mode> </mode> <reason>cancelled</reason> <status>1</status> </Response> 3.4.2 Respostas rejeitadas ou com falha Exemplo de Resposta XML de uma configuração rejeitada. O pagamento inicial foi rejeitado e, portanto, a conta não pode ser configurada. <Response version= 2 > <CardTxn> <authcode>declined</authcode> <card_scheme>mastercard</card_scheme> <country>australia</country> </CardTxn> <ContAuthTxn> <account_status>account not setup. ECOMM transaction was not successfully authed</account_status> </ContAuthTxn> <gateway_reference>5300200040641890</gateway_reference>

16 <merchantreference> </merchantreference> <mode> </mode> <reason>declined</reason> <status>7</status> <time> </time> </Response> Exemplo de Resposta XML de uma Solicitação de pagamento recorrente rejeitada <Response version= 2 > <CardTxn> <authcode>not AUTHORISED</authcode> <card_scheme>american Express</card_scheme> </CardTxn> <ContAuthTxn> <account_status>using account ref 3900200040457927. CONT_AUTH transaction complete</account_status> </ContAuthTxn> <gateway_reference>3800200040465541</gateway_reference> <merchantreference> </merchantreference> <mode>live</mode> <reason>declined</reason> <status>7</status> <time> </time> </Response> Exemplo de Resposta XML na qual a conta não pode ser encontrada ou já foi cancelada <Response version= 2 > <gateway_reference>4500200040373397</gateway_reference> <information>failed to find live CA account with reference=47002000405791371</information> <merchantreference>historicreference12345690</merchantreference> <reason>failed to find corresponding CA account</reason> <status>192</status> <time> </time> </Response>

17 04 Pagamento Recorrente Agendado 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 MasterCard, Diners, Visa e Hipercard sem necessidade de desenvolvimento de um sistema para envio das solicitações de transação individuais ao e-rede. 4.1 Elementos da solicitação Nesta seção, são apresentados os campos obrigatórios para cada tipo de transação, bem como exemplos de XML desses campos. Como nem todos os campos são obrigatórios, será utilizada a legenda a seguir: R Obrigatório O Opcional Para configurações de conta recorrente As informações necessárias para configurar uma conta são transmitidas em vários lugares da transação: Request º Authentication - Consulte a seção 2.1.1.1.1 do Guia de Referência dos Desenvolvedores do e-rede º Transaction CardTxn - O tipo de transação e código de autorização - Consulte a seção 2.2.1.2 do Guia de Referência dos Desenvolvedores do e-rede º Card - Contém todas as informações sobre o cartão. Esses detalhes são iguais aos dos pagamentos únicos

18 - Consulte a seção 2.2.1.1 do Guia de Referência dos Desenvolvedores do e-rede ContAuthTxn - Contém todas as informações sobre os pagamentos que devem ser efetuados a partir da conta - Consulte a seção 4.1.1 º LastPayment - Permite a especificação de um pagamento final - Consulte a seção 4.1.3 Para estornos/cancelamentos de transações/contas Os estornos/cancelamentos de transações/contas são realizados com os mesmos dados utilizados para estornos de transações realizadas com cartões de crédito: Request º Authentication - Consulte a seção 2.1.1.1.1 do Guia de Referência dos Desenvolvedores do e-rede º Transaction HistoricTxn - Detalha o método Cancel e o número de referência do pagamento/conta a ser cancelado - Consulte a seção 2.2.1.4 do Guia de Referência dos Desenvolvedores do e-rede 4.1.1 ContAuthTxn Este elemento deve ser inserido ao configurar uma conta Nome do elemento Posição ContAuthTxn Request.Transaction

19 Elementos de ContAuthTxn Nome do elemento Descrição Valores / Limitações method Indica o tipo de transação pre auth R start_date A data na qual o primeiro pagamento regular será efetuado. Os pagamentos subsequentes se basearão nesta data. Deve ocorrer, no mínimo, no dia seguinte ao envio da transação ISO 8601 Ext (YYYY-MM- DD). Deve ocorrer, no mínimo, no dia seguinte à data atual ou à data do FirstPayment R period A frequência dos pagamentos weekly (semanal) monthly (mensal) quarterly (trimestral) annual (anual) R amount O valor de cada pagamento regular R number_of_payments LastPayment Utilizado para restringir o número de pagamentos regulares a serem coletados. Não equivale ao número total de pagamentos se o primeiro e/ou último pagamento for configurado Deve ser um número inteiro. Não poderá conter mais do que 99 pagamentos (incluindo o primeiro e o último pagamento) Detalhes do pagamento final a ser efetuado. Ocorre além dos pagamentos regulares. Consulte a seção 4.1.3 O O Atributos de ContAuthTxn Atributos Atributo do Elemento Descrição Valores/Limitações currency amount Moeda no formato alfabético ISO 4217, por exemplo, BRL O valor padrão é BRL

20 Exemplo do elemento ContAuthTxn. Os pagamentos mensais serão efetuados até o cancelamento da conta <ContAuthTxn> <method>auth</method> <start_date>2013-10-01</start_date> <period>monthly</period> <amount currency= BRL >25.00</amount> </ContAuthTxn> Exemplo do elemento ContAuthTxn com o primeiro e o último pagamento <ContAuthTxn> <method>auth</method> <start_date>2013-10-01</start_date> <period>weekly</period> <number_of_payments>5</number_of_payments> <amount currency= BRL >10.00</amount> <LastPayment> </LastPayment> </ContAuthTxn> 4.1.2 LastPayment Este elemento opcional permite que um pagamento final seja efetuado com variação de valor e cronograma em relação às transações regulares. O elemento somente pode ser inserido se o elemento number_of_payments for especificado (seção 4.1.1). Se este elemento for inserido em uma transação, seus elementos secundários também devem ser inseridos.

21 Nome do elemento Posição LastPayment Request.Transaction.ContAuthTxn Elementos de LastPayment Nome do elemento Descrição Valores / Limitações date amount A data em que o último pagamento é efetuado O valor do último pagamento pode variar em relação aos pagamentos regulares. O atributo da moeda pode ser especificado, se necessário DDMMAAAA deve ocorrer, no mínimo, uma dia após o último pagamento regular Exemplo do elemento LastPayment <LastPayment> <amount currency= BRL >20.00</amount> <date>2013-10-01</date> </LastPayment> 4.2 Exemplo de Solicitações XML Exemplo de Solicitação de um encargo inicial de R$ 7,50, seguido por pagamentos semanais regulares de R$ 5,00 até o recebimento de uma Solicitação de cancelamento da conta <Request version= 2 > <Authentication> <AcquirerCode> <rdcd_pv>123456789</rdcd_pv> </AcquirerCode> <password>********</password> </Authentication> <Transaction>

22 <CardTxn> <Card> <expirydate>11/16</expirydate> <pan>544433*********1</pan> <Cv2Avs> <cv2>132</cv2> </Cv2Avs> </Card> </CardTxn> <ContAuthTxn> <method>auth</method> <start_date>2013-10-01</start_date> <period>weekly</period> <amount currency= BRL >5.00</amount> </ContAuthTxn> <TxnDetails> <merchantreference>383914410763889</ merchantreference> <capturemethod>ecomm</capturemethod> <amount currency= BRL >5.00</amount> </TxnDetails> </Transaction> </Request> Exemplo de Solicitação de nove pagamentos trimestrais de R$ 69,99 <Request version= 2 > <Authentication> <AcquirerCode> <rdcd_pv>123456789</rdcd_pv> </AcquirerCode> <password>********</password> </Authentication> <Transaction> <CardTxn> <Card> <expirydate>06/15</expirydate> <pan>3434*********3</pan> <Cv2Avs> <cv2>321</cv2>

23 </Cv2Avs> </Card> </CardTxn> <ContAuthTxn> <method>auth</method> <start_date>2013-10-01</start_date> <period>quarterly</period> <amount currency= BRL >69.99</amount> <number_of_payments>9</number_of_payments> </ContAuthTxn> <TxnDetails> <merchantreference>annual0000432432a</ merchantreference> <capturemethod>ecomm</capturemethod> <amount currency= BRL >69.99</amount> </TxnDetails> </Transaction> </Request> Exemplo de Solicitação de um encargo inicial de R$ 30,00, doze pagamentos regulares de R$ 10,00 no primeiro dia de cada mês e um pagamento final de R$ 20,00 <Request version= 2 > <Authentication> <AcquirerCode> <rdcd_pv>123456789</rdcd_pv> </AcquirerCode> <password>********</password> </Authentication> <Transaction> <CardTxn> <Card> <expirydate>01/16</expirydate> <pan>544433*********1</pan> <Cv2Avs> <cv2>321</cv2> </Cv2Avs> </Card>

24 </CardTxn> <ContAuthTxn> <method>auth</method> <start_date>2013-10-01</start_date> <period>monthly</period> <amount currency= BRL >10.00</amount> <number_of_payments>12</number_of_payments> <LastPayment> <amount currency= BRL >20.00</amount> <date>2013-04-20</date> </LastPayment> </ContAuthTxn> <TxnDetails> <merchantreference>382684637615741</merchantreference> <capturemethod>ecomm</capturemethod> <amount currency= BRL >10.00</amount> </TxnDetails> </Transaction> </Request> 4.3 Elementos da resposta Além dos elementos abordados nesta seção, as respostas desse serviço conterão os elementos de resposta gerais destacados na seção 2.1.1.2 do Guia de Referência dos Desenvolvedores do e-rede. 4.3.1 ContAuthTxn Nome do elemento Posição ContAuthTxn Resposta Elementos de ContAuthTxn Nome do elemento account_status Descrição Exibe informações sobre o status da conta

25 Exemplo XML do Elemento ContAuthTxn 4.4 <ContAuthTxn> <account_status>account setup. First transaction due to be batched on 30/06/2012</account_status> </ContAuthTxn> Exemplo de Respostas XML Exemplo de Resposta XML de uma conta configurada com êxito <Response version= 2 > <ContAuthTxn> <account_status>account setup. First transaction due to be batched on 09/10/2012</account_status> </ContAuthTxn> <gateway_reference>4200200040373186</gateway_reference> <information>continuous Authority account set up</information> <merchantreference>382684637615741</merchantreference> <mode> </mode> <reason>accepted</reason> <status>1</status> <time> </time> </Response> Exemplo de Resposta XML de um tipo de cartão que não é suportado pelo serviço <Response version= 2 > <gateway_reference>4200200040609090</gateway_reference> <information>continuous authority is not supported on this card</information> <merchantreference>383914408564815</merchantreference> <mode> </mode> <reason>ca Not Supported</reason> <status>92</status> <time> </time>

26 </Response> Exemplo de Resposta XML de uma data inicial inválida <Response version= 2 > <gateway_reference>4600200040609088</gateway_reference> <information>the date of the first payment must be from tomorrow onwards</information> <merchantreference>12345612</merchantreference> <mode> </mode> <reason>invalid Date</reason> <status>94</status> <time> </time> </Response> 05 Códigos de resposta para pagamentos com cartão recorrentes Segue a tabela com os códigos de resposta específicos às transações de Pagamentos Recorrentes. Código Código de Retorno Geral Descrição 90 Invalid Value 91 Field Missing 92 CA Not Supported 93 Invalid Card Valor inválido. O valor inserido não corresponde ao formato necessário O campo exibido no elemento <information> é obrigatório e não foi preenchido Transações Recorrentes Agendadas e Históricas não são suportadas para esse tipo de cartão Cartão inválido. O cartão fornecido vencerá antes que o primeiro pagamento seja efetuado

27 94 Invalid date 95 Invalid cancellation 96 Invalid last payment 97 No CA support 191 Field not applicable to CA setup 192 194 Failed to find corresponding CA account Invalid use of CA environment attribute Houve um problema com as datas fornecidas. O elemento <information> detalha qual é o problema: A data do último pagamento deve ser, no mínimo, um dia após o último pagamento regular A data inicial é inválida A data inicial é inválida se a primeira/última transação for inválida. Houve um problema com a transação de cancelamento. As causas podem ser: A referência fornecida não corresponde a uma conta de transações recorrentes A conta já foi cancelada Um último pagamento só pode ser especificado quando houver um número configurado de pagamentos recorrentes Sua conta não foi habilitada para processar transações de autorização contínua. Entre em contato com suporte do e-rede para obter essa configuração Os campos utilizados nas transações recorrentes agendadas não são aplicáveis nas transações recorrentes históricas. Verifique o elemento <information> para ver qual campo foi preenchido incorretamente A referência fornecida não corresponde a uma conta de Pagamento Recorrente ativa O atributo do ambiente somente é válido para transações de cartão de crédito que utilizam o método de captura cont_auth