PLATAFORMA PAGADOR INTEGRAÇÃO POST

Transcrição

1 PLATAFORMA PAGADOR INTEGRAÇÃO POST Versão /02/2013

2 SUMÁRIO 1. INTRODUÇÃO Sobre este Manual Sobre a Plataforma PROCESSO DE INTEGRAÇÃO FUNCIONALIDADES EXTRAS DO PAGADOR Funcionalidades Novas do Pagador QUAIS TIPOS DE INTEGRAÇÃO POSSO USAR? INTEGRAÇÃO POR POST: Diferença entre modelo Index e Passthru Post Index Post Passthru PASSOS TÉCNICOS HOMOLOGAÇÃO DOS MEIOS DE PAGAMENTO E TESTES SUPORTE BRASPAG...28 ANEXO 1 - USO DO COMPONENTE DE CRIPTOGRAFIA ANEXO 2 FLUXOS DE INTEGRAÇÃO VIA POST PARA CARTÕES DE CRÉDITO ANEXO 3 Interfaces Webservice (Consulta) ANEXO 4 - DESCRIÇÃO DE ARQUIVOS DE EXEMPLO ANEXO 5 SUPORTE BRASPAG Telefone: (21) / (11) Página 2 de 41

3 HISTÓRICO DE ALTERAÇÕES Versão Data Descrição /12/ /04/ /09/2011 Parâmetros CPF e CNPJ obrigatórios no envio em "PARÂMETROS A SEREM ENVIADOS NO PASSO 1 (post de Envio)" Atualização da Tabela 3 com novos meios de pagamento, novos Anexos Formatação e revisão ortográfica, alteração Tabela 2 com informações nova plataforma CIELO, atualização dos códigos dos meios de pagamento da tabela 3, atualização dos meios de pagamento com delay de captura /02/2012 Troca do telefone do escritório de São Paulo /04/2012 Inclusão dos novos parâmetros, Multi Moeda; Multi idioma; BraspagOrderID e JustClick / Inclusão dos meio de pagamento: 524 até /06/2012 Inclusão do meio de pagamento: /09/2012 Inclusão dos meios de pagamento referentes a débito; Inserção do parâmetro BraspagOrderId /11/2012 Inclusão do Meio de Pagamento: 190 PAGGO (Mobile) /01/ /02/ /07/ /09/2013 Inclusão, na Tabela 1 do Post Index, dos seguintes parâmetros : TRANSACTIONTYPE, TRANSACTIONCURRENCY e TRANSACTIONCOUNTRY Inclusão do meio de pagamento: 535, 536, 537, 538, 539, 540, 541, 542, 543, 544 e 545; Retirada do meio de pagamento: 105; Alteração do parâmetro ExtraDynamicurl Inclusão do meio de pagamento: 546; Retirada dos meios de pagamento: 46, 54, 55, 56, 90, 91,110, 154, 190; Inclusão dos meios de pagamento: 547, 548 e 549; Alteração do nome do meio de pagamento 546 (De Givex para Cartão Presente Alelo); Inclusão do parâmetro DDD nas tabelas 1 e 2 referente ao meio de pagamento Cielo pagamento com celular; /11/2013 Inclusão do meio de pagamento: 550 e /12/2013 Inclusão do meio de pagamento /02/2014 Ateração do nome do meio de pagamento Cielo Mastercard Maestro para Cielo Mastercard Débito Telefone: (21) / (11) Página 3 de 41

4 1. INTRODUÇÃO 1.1 Sobre este Manual O objetivo deste documento é orientar o desenvolvedor da loja sobre como fazer a integração com o sistema Pagador da Braspag, descrevendo as funcionalidades, os métodos a serem utilizados, listando informações a serem enviadas e recebidas, e provendo exemplos. 1.2 Sobre a Plataforma A plataforma PAGADOR tem a finalidade de auxiliar o estabelecimento de e-commerce no processamento de trasações pontuais através de uma única integração a todos os meios de pagamento, com resposta em real time. Telefone: (21) / (11) Página 4 de 41

5 2. PROCESSO DE INTEGRAÇÃO O processo de integração com o PAGADOR é simples e pode ser resumido nos seguintes passos: 1. Receber de Kickoff com manual técnico (este documento), dados do ambiente de homologação e Id_Loja de teste. (O parâmetro Id_Loja é um identificador único da loja sempre utilizado em qualquer comunicação entre a loja e o sistema Pagador) 2. Preparar a loja virtual para enviar a transação, por POST ou WebService, para o Sistema Pagador no momento em que o comprador (cliente da loja) escolhe opção Pagar. 3. Após o envio e homologação das afiliações testes você já poderá realizar transações de teste com os meios de pagamento cadastrados para sua loja. 4. Repetir o processo integrando a loja ao ambiente de produção da Braspag com afiliações reais do estabelecimento junto aos bancos e operadoras de cartão. 3. FUNCIONALIDADES EXTRAS DO PAGADOR Além das autorizações em tempo real a Braspag oferece no PAGADOR alguns serviços adicionais, são eles: a) Componente de criptografia: desenvolvido para dar maior segurança no trânsito das informações na integração por POST. A forma de utilização do componente de criptografia está descrita no Anexo 1. ATENÇÃO! A utilização do componente de Criptografia para integração por POST ALTAMENTE RECOMENDADA para proporcionar uma maior segurança às transações. b) Conciliação automática dos Boletos: o Pagador pode fazer a conciliação automática dos boletos assim que eles forem pagos e o banco encaminhar um arquivo de retorno para a Braspag. Para a utilização desta funcionalidade é essencial o uso do Retorno de Mudança de Status (descrito abaixo no item 6). Importante: A conciliação automática de boletos só ocorrerá através de um convênio entre o banco, o estabelecimento e a Braspag. Sem este convênio o sistema não identificará o pagamento dos boletos. Informe-se a respeito junto a Área de Relacionamento com o Cliente. c) Retorno de Mudança de Status de Pagamento (USO ALTAMENTE RECOMENDADO PELA Telefone: (21) / (11) Página 5 de 41

6 BRASPAG) Usado para avisar a loja quando o status de um pagamento pendente for alterado para PAGO, como exemplo temos: um boleto que foi pago e conciliado, transação de cartão de crédito que foi capturada alterando o status da transação para PAGO, etc. Este RETORNO é muito útil para automaticamente e em tempo real atualizar o sistema de vendas da loja sobre a mudança de status de uma transação para PAGO sem que o operador da loja tenha que checar o status no Ambiente Administrativo da Braspag. Também pode ser útil nos casos onde, por alguma falha de comunicação, a loja não recebeu a confirmação da transação. d) WebServices para consulta de transações (anexo 4) GetDadosComprador: Este método retorna todos os dados relativos ao comprador. GetDadosEntrega: Este método retorna todos os dados relativos à entrega. GetDadosPedido: Este método retorna todos os dados relativos ao pedido. GetDadosCartao: Este método retorna todos os dados relativos ao cartão utilizado na compra. GetDadosExtras: Este método retorna todos os campos extras relativos ao pedido. e) Delay de Captura para transações de cartão de crédito: o Pagador oferece a possibilidade de capturar transações de cartão de crédito com um delay de até 5 dias corridos. Este delay pode ser útil para diversas situações como, por exemplo, para uma loja fazer uma análise antifraude e posteriormente capturar a transação caso a análise libere. Solicite a equipe de implementação a homologação dessa modalidade. f) Pagador junto com o Pagador Recorrente: Caso o estabelecimento tenha contratado o Pagador e o Pagador Recorrente, ele poderá fazer a 1ª transação do Recorrente em tempo real através de uma integração com o Pagador (veja detalhes no Anexo 5) 4. FUNCIONALIDADES NOVAS DO PAGADOR Multi-Idioma o É possível escolher o idioma exibido nas páginas de fluxo do Post onde possui interação com o cliente final (páginas de pagamentos). o Os idiomas disponíveis são: Português (BR); Inglês (US) e Espanhol (ES). o Essa alteração será realizada através do parâmetro: LANGUAGE (tabela 3) o Caso a loja não envie o parâmetro LANGUAGE, as páginas de pagamentos serão exibidas no idioma preferencial do navegador do cliente final. o Caso o idioma enviado pela loja ou do navegador do cliente final não sejam suportados, as páginas de pagamentos serão exibidas em Inglês (US). JustClick o O JUSTCLICK SHOP é uma solução para fazer cobrança de transações pontuais de cartão de crédito (à vista ou parceladas) com resposta em real time e on-line para e-commerce e call-center, usando o conceito de 1-Click Shop (compra com 1 clique) ou venda sem digitação. A plataforma recebe os dados de uma venda e concecta-se ao PAGADOR para fazer o processamento. o A compra com 1 clique permite que um pagamento online via cartão de crédito seja feito pulando a etapa de preenchimento dos dados para pagamento ou até mesmo de todo o processo do carrinho de compras, pois os dados do cartão já foram previamente informados pelo comprador em compras passadas e serão replicados em futuras compras mediante seu aval. Telefone: (21) / (11) Página 6 de 41

7 o o o Parâmetro: SAVECREDITCARD (tabela 2) Indica se o cartão será salvo ou não na Plataforma do JustClick Parâmetro CREDITCARDTOKEN (tabela 2) Token do cartão de crédito gerado pela Plataforma JustClick Para a utilização dessa funcionalidade é necessário entrar em contato com a Equipe Comercial da Braspag. Obs: Somente pode ser utilizado na Integração Post via Passthru Multi-Moeda o É possível especificar qual moeda/país o pagamento será processado o Necessário verificar a lista de compatibilidade dos meios de pagamento que suportam multi-moeda. o Essa informação será enviando no parâmetro: TRANSACTIONCURRENCY (ISO 4217) e TRANSACTIONCOUNTRY (ISO Alfa-3) Obs: 1. Somente pode ser utilizado na Integração Post via Passthru 2. A moeda não precisa está vinculada ao pais de origem da transação, e sim ao meio de pagamento. Ex: Uma transação realizada no Brasil, utilizando a moeda dólar URL Dinâmica o É possível ter o retorno de cada transação para uma URL de Retorno específica. o O cliente envia o parâmetro EXTRADYNAMICURL a URL para onde será retornado ao final da transação. Essa informação deve conter em todas as transações. o Para utilizar esse funcionalidade é necessário solicitar a habilitação da mesma, a Equipe de Implantação, através da Ferramenta de Suporte. Aninhamento de Transações o Entende-se por Aninhamento de Transações, a possibilidade do cliente enviar "n" transações, utilizando inclusive meios de pagamentos diversificados (Cartão de Crédito, Boleto e Débito), através de um identificador único retornado pela Braspag a cada transação (BraspagOrderID - BOI); o O BraspagOrderID será retornado pela Braspag a cada transação, seja ela realizada via Post ou WS ; o Aninhar n transações enviadas pelo cliente (desde que o mesmo tenha enviado o mesmo BOI, das demais transações); Validação do BOI pela Braspag a cada requisição; o A utilização de mais de um meio de pagamento. Para habilitar essas funcionalidades é necessário solicitar à Equipe de Implantação através da ferramenta de suporte (). Telefone: (21) / (11) Página 7 de 41

8 5. QUAIS TIPOS DE INTEGRAÇÃO POSSO USAR? A Braspag oferece três tipos de integração para um estabelecimento enviar transações para o Pagador: Integração por POST: modelos Passthru ou Index (descritos neste manual) Integração por WebService (solicitar manual a Área de Relacionamento com Cliente) (é possível utilizar também uma combinação dos tipos acima) A integração por WebService tem como vantagem ser mais rápida e mais resistente a falhas, pois toda a comunicação é feita servidor a servidor, sem possibilidade de interferência do usuário. Entretanto, nem todos os meios de pagamento podem ser utilizados com esta integração, como por exemplo, os débitos online, onde é necessário que o comprador (cliente da loja) seja direcionado ao ambiente do banco para efetuar a transação. A integração por Webservice não necessita de utilização do componente de Criptografia, pois basta realizar uma restrição de acesso aos IPs do seu servidor. A integração por POST (Index ou Passthru) permite uso de praticamente todos os meios de pagamento, com apenas algumas exceções. Dependendo da integração e forma técnica da implementação, esta integração pode envolver o computador do comprador (cliente da loja), o que diminui resistência a falhas além de permitir interferência do comprador (cliente da loja) no processo, como por exemplo, ele pode apertar tecla ESC ou F5 interrompendo a transação sem saber o resultado. Este manual cobre apenas a integração por POST (Index e Passthru). O manual para integração por Webservice poderá ser solicitado separadamente para a Área de Relacionamento com Cliente através da ferramenta de suporte. 6. INTEGRAÇÃO POR POST: DIFERENÇA ENTRE MODELO INDEX E PASSTHRU 6.1 Post Index No modelo de integração por POST Index o comprador escolhe o meio de pagamento no servidor da Braspag (em uma página da Braspag com o look and feel da loja). Veja exemplo abaixo: Telefone: (21) / (11) Página 8 de 41

9 Neste modelo é possível customizar alguns parâmetros como a imagem do header e footer, a cor do fundo da tela dos meios de pagamento e do fundo da barra de título Selecione o meio de pagamento desejado, tamanho, tipo e cor das fontes. 6.2 Post Passthru No modelo de integração por POST Passthru o comprador escolhe a forma de pagamento no próprio site da loja, conforme imagem abaixo. Neste modelo há maior flexibilidade com relação ao layout da página de escolha de meios de pagamento uma vez que 100% do design é definido pela loja. **Para integrar no modelo Passthru o desenvolvedor deverá atentar-se para os parâmetros extras especificados na Tabela 2. Telefone: (21) / (11) Página 9 de 41

10 Em ambos os modelos de integração por POST os dados de cartão ou bancários serão sempre digitados em uma página da Braspag, da Operadora de Cartão ou do Banco, nunca no ambiente da própria loja. As instruções de como optar pelo modelo Passthru ou Index foram enviadas junto com o Id_loja no de Kickoff. Telefone: (21) / (11) Página 10 de 41

11 ATENÇÃO! A1 - O uso de recursos frame e iframe na chamada às URLs do sistema Pagador NÃO é suportado, pois esta prática causa interferências no funcionamento das páginas para determinadas configurações/versões de browsers devido à perda da sessão. A2 - Não será fornecido suporte a linguagens de programação, códigos fonte ou qualquer fragmento destes, internos ao desenvolvimento de sua integração, mesmo que fornecidos ou citados previamente. A3 - Conforme já mencionado, a conciliação de boletos automática só ocorre através de um convênio entre o banco, o estabelecimento e a Braspag. Sem este convênio o sistema não identificará o pagamento dos boletos. Informe-se com a Área de Relacionamento com o Cliente. É extremamente importante que o estabelecimento exija do seu gerente do banco que apenas os pagamentos compensados sejam enviados nos arquivos de confirmação de pagamento. A Braspag não se responsabiliza por informações de pagamentos não compensados pelo banco. Tentaremos avisar sempre que possível quando um pagamento confirmado não esteja compensado, para que uma conciliação manual seja feita. Mas a Braspag NÃO GARANTE A COMPENSAÇÃO DOS MESMOS. 7. PASSOS TÉCNICOS Telefone: (21) / (11) Página 11 de 41

12 1. Loja envia um POST para Braspag, iniciando uma transação. Veja dados a serem enviados no POST na Tabela 1, abaixo. A URL destino do POST será fornecida junto com Id_Loja, no de Kickoff. Este POST deverá estar criptografado utilizando o Componente de Criptografia descrito no Anexo Braspag recebe o POST da loja e inicia a transação junto à instituição financeira (operadora de cartão de crédito ou banco) abrindo uma nova página para o comprador digitar dados de cartão ou conta bancária para autorização. 3. A operadora autoriza ou nega a transação. 4. O resultado da transação é devolvido à Braspag e armazenado. 5. Braspag envia um POST de Retorno para a Loja, informando em tempo real o resultado da autorização da transação. Veja na Tabela 4 os dados que serão enviados para a loja pela Braspag neste POST. A loja deverá fornecer à Braspag uma URL para qual este POST será enviado (URL de Retorno). Este passo é altamente recomendado, mas opcional, visto que Braspag também pode exibir o resultado da transação diretamente ao comprador (cliente da loja), mas neste caso a loja não receberá o retorno da transação para que possa eventualmente ser armazenado no banco de dados da loja, e neste caso o administrador da loja precisaria sempre consultar o status das transações no Ambiente Administrativo da Braspag. O POST de retorno é enviado Criptografado e será necessária a utilização do componente de criptografia para recebê-lo corretamente (descrito no Anexo 1). 6. Braspag envia o Retorno de Mudança de Status. Este passo altamente recomendado. Este Retorno, enviado por POST, serve para informar ao servidor da loja o pagamento de uma transação que não teve o retorno imediato, como por exemplo, boleto bancário que somente fica Pago depois que o comprador (cliente da loja) efetua o pagamento e o banco encaminha o arquivo de conciliação para a Braspag. Assim, ao confirmar o pagamento (conciliar o boleto), o servidor da Braspag irá enviar a o POST informando ao servidor da loja sobre o pagamento realizado. Outro exemplo onde este Retorno é muito útil, é quando a loja utiliza o delay de captura em transações de cartão de crédito. Assim que a transação é capturada e seu Status muda para PAGO, automaticamente a Braspag encaminha o Retorno de Mudança de Status para a URL da loja cadastrada no sistema da Braspag. Veja na Tabela 5 os dados contidos neste Retorno via POST. O Retorno de mudança de Status é enviado Criptografado e será necessária a utilização do componente de criptografia para recebê-lo corretamente (descrito abaixo no Anexo 1). ATENÇÃO! É de extrema importância que a URL de Mudança de Status (passo 6) somente aceite o POST proveniente dos IPs informados pela Braspag (solicite a lista de IPs a Área de Relacionamento com Cliente). Desta forma o sistema garantirá o não recebimento de um POST forjado (fraudulento), garantindo a segurança na transação junto com a utilização da Criptografia (Anexo 1). Observação: no caso em que o meio de pagamento escolhido pelo comprador é Boleto Bancário, os passos 2), 3) e 4) são substituídos por: Servidor da Braspag gera boleto e exibe na tela para o comprador para que o boleto possa ser impresso e pago pelo cliente da loja. Telefone: (21) / (11) Página 12 de 41

13 6.1. PASSO 1: Parâmetros a serem enviados no POST de Envio O POST de Envio que será encaminhado à Braspag deve conter os seguintes parâmetros de acordo com o modelo escolhido. POST MODELO INDEX Tabela 1 Parâmetros Post Envio Parâmetro Descrição Tamanho Min Max Obrigatório? Id_Loja Identificador único da loja Sim VENDAID Número do 1 50 Sim VALOR Valor total do pedido em centavos (ex.: R$1,00 = 100) Sim NOME Nome do Comprador Sim CPF CPF do Comprador (se pessoa física) Sim RAZAO_PJ Nome da empresa (Se pessoa jurídica) Sim CNPJ Número do CNPJ (se pessoa jurídica) Sim LOGRADOURO ENDERECO Logradouro do Comprador (ex: Rua, Av., Trav...) Endereço do Comprador (ex: nome da rua) Não Não NUMERO Número do endereço do Comprador Não COMPLEMENTO Complemento do endereço do Comprador Não BAIRRO Bairro do Comprador Não CIDADE Cidade do Comprador Não CEP CEP do 8 9 Não ESTADO Estado (UF) do Comprador 2 2 Não PAIS País do Comprador Não NASC ESTCIVIL Data nascimento do Comprador (formato: dd/mm/aaaa Estado civil do Comprador (Solteiro = S; Casado = C; Não 1 1 Não Telefone: (21) / (11) Página 13 de 41

14 SEXO Sexo do comprador (M ou F) 1 1 Não PROF Profissão do Comprador Não DDD FONE Número do código de Discada direta a distância (para Cielo pagamento com celular utilizar esse campo para o DDD) Número do telefone do Comprador (para Oi Paggo, enviar Celular com DDD neste campo) Apenas para Cielo pagamento com Celular Para Mobile e Cielo pagamento com celular FAX Número do fax do Comprador 1 64 Não do comprador Não LOGRADOURO_D Logradouro do endereço de entrega (ex: Rua, Avenida, Estada...) Não ENDERECO_D Endereço de entrega Não NUMERO_D Número do endereço de entrega Não COMPLEMENTO_D Complemento do endereço de entrega Não BAIRRO_D Bairro de entrega Não CIDADE_D Cidade de Entrega Não CEP_D CEP de entrega 8 9 Não ESTADO_D Estado de entrega (UF) 2 2 Não PAIS_D Pais de entrega Não TRANSACTIONTYPE Novo! TRANSACTIONCURRE NCY Novo! TRANSACTIONCOUNT RY Novo! BRASPAGORDERID Novo! LANGUAGE Novo! Indica o tipo de transação (Tabela 4) 1 1 Sim Indica a moeda da transação (ISO 4217) Indica o pais da transação (ISO Alfa-3) Identificador do pedido criado internamente. Se este campo já estiver preenchido, significa que a transação já passou pela Braspag e deseja-se agregar mais transações ao mesmo pedido Idioma de exibição das páginas de pagamento. (Tabela 3) 3 3 Sim 3 3 Sim GUID Não 5 5 Não Telefone: (21) / (11) Página 14 de 41

15 EXTRA [nome que você deseja dar ao campo] Informação adicional que a loja deseje associar à transação. Este parâmetro nunca é retornado, ele somente pode ser acessado pelo ambiente Administrativo (backoffice). Se enviado parâmetro com nome ExtraInfo, no backoffice aparecerá Info URL DINAMICA deve ser enviada nesse parâmetro, podendo conter até 500 caracteres e não obrigatória Não Exemplo de POST Index enviado no Passo 1 <form name="form1" method="post" action=" Id_Loja VendaId Valor Nome CPF <input type="hidden" name="id_loja" value=""><br> <input type="text" name="vendaid" value=""><br> <input type="text" name="valor" value=""><br> <input type="text" name="nome" value=""><br> <input type="text" name="cpf" value=""><br> <input type= "submit"> Exemplo de POST Index Criptografado enviado no Passo 1 <form name="form1" method="post" action=" Id_Loja <input type="hidden" name="id_loja" value=""><br> Crypt <input type="hidden" name="crypt" value=""><br> <input type= "submit"> IMPORTANTE: </form> A tripa a ser enviada deve conter no mínimo os parâmetros obrigatórios: VENDAID, VALOR, NOME/RAZÃO_PJ e CPF/CNPJ. Telefone: (21) / (11) Página 15 de 41

16 MODELO PASSTHRU No Modelo Passthru a URL para qual o POST deve ser enviado é diferente da usada no modelo Index. Os parâmetros também devem estar criptografados utilizando o Componente de Criptografia descrito no Anexo 1. As duas URLs são informadas junto com o Id_Loja no Kickoff. Os parâmetros que deverão ser enviados para o Pagador no modelo Passthru são os mesmos da Tabela 1, acrescidos dos parâmetros CODPAGAMENTO, PARCELAS E TIPOPARCELADO. Tabela 2 Parâmetros adicionais a serem enviados no modelo PASSTHRU Parâmetro Descrição Tamanho Min Max Obrigatório Id_Loja Identificador único da loja Sim VENDAID Número do pedido 1 50 Sim VALOR Valor total do pedido em centavos (ex.: R$1,00 = 100) Sim NOME Nome do Comprador Sim CPF CPF do Comprador (se pessoa física) Sim CODPAGAMENTO PARCELAS TIPOPARCELADO RAZAO_PJ Identificação da forma de pagamento (Tabela 8) número de parcelas em que o valor total será dividido (padrão = 1) Cielo Nova Plataforma: Á vista = 0 Parcelado loja, sem juros=1 Parcelado emissor, com juros =2 Demais Adquirentes: Á vista =0 Parcelado loja, sem juros=0 Parcelado emissor, com juros =1 Nome da empresa (Se pessoa jurídica) 2 3 Sim 1 2 Sim 1 1 Sim Sim CNPJ Número do CNPJ (se pessoa jurídica) Sim LOGRADOURO ENDERECO Logradouro do Comprador (ex: Rua, Av., Trav...) Endereço do Comprador (ex: nome da rua) Não Não NUMERO Número do endereço do Comprador Não Telefone: (21) / (11) Página 16 de 41

17 COMPLEMENTO Complemento do endereço do Comprador Não BAIRRO Bairro do Comprador Não CIDADE Cidade do Comprador Não CEP CEP do 8 9 Não ESTADO Estado (UF) do Comprador 2 2 Não PAIS País do Não NASC ESTCIVIL Data nascimento do Comprador (formato: dd/mm/aaaa Estado civil do Comprador (Solteiro = S; Casado = C; Não 1 1 Não SEXO Sexo do comprador (M ou F) 1 1 Não PROF Profissão do Comprador Não DDD FONE Número do código de Discada direta a distância (para Cielo pagamento com celular utilizar esse campo para o DDD) Número do telefone do Comprador (para Oi Paggo, enviar Celular com DDD neste campo) Apenas para Cielo pagamento com Celular Para Mobile e Cielo pagamento com Celular FAX Número do fax do Comprador 1 64 Não do comprador Não LOGRADOURO_D Logradouro do endereço de entrega (ex: Rua, Avenida, Estada...) Não ENDERECO_D Endereço de entrega Não NUMERO_D Número do endereço de entrega Não COMPLEMENTO_D Complemento do endereço de entrega Não BAIRRO_D Bairro de entrega Não CIDADE_D Cidade de Entrega Não CEP_D CEP de entrega 8 9 Não Telefone: (21) / (11) Página 17 de 41

18 ESTADO_D Estado de entrega (UF) 2 2 Não PAIS_D Pais de entrega Não BRASPAGORDERID Novo! CREDITCARDTOKEN Novo! SAVECREDITCARD Novo! TRANSACTIONTYPE Novo! TRANSACTIONCURRENCY Novo! TRANSACTIONCOUNTRY Novo! LANGUAGE Novo! EXTRA [nome que você deseja dar ao campo] Identificador do pedido criado internamente. Se este campo já estiver preenchido, significa que a transação já passou pela Braspag e deseja-se agregar mais transações ao mesmo pedido Token do cartão de crédito armazenado no JustClick Indicação para salvar ou não o cartão de crédito para a utilização do JustClick. (esse parâmetro é boleano: True or False) GUI D Não Não 4 5 Não Indica o tipo de transação (Tabela 4) 1 1 Sim Indica a moeda da transação (ISO 4217) Indica o pais da transação (ISO Alfa-3) Idioma de exibição das páginas de pagamento. (Tabela 3) Informação adicional que a loja deseje associar à transação. Este parâmetro nunca é retornado, ele somente pode ser acessado pelo ambiente Administrativo (backoffice). Se enviado parâmetro com nome ExtraInfo, no backoffice aparecerá Info URL DINAMICA deve ser enviada nesse parâmetro, podendo conter até 500 caracteres e não obrigatória. 3 3 Sim 3 3 Sim 5 5 Não Não Telefone: (21) / (11) Página 18 de 41

19 Exemplo de POST PASSTHRU enviado no Passo 1 <form name="form1" method="post" action=" Id_Loja <input type="hidden" name="id_loja" value=""><br> VendaId <input type="text" name="vendaid" value=""><br> Valor <input type="text" name="valor" value=""><br> Nome <input type="text" name="nome" value=""><br> CPF <input type="text" name="cpf" value=""><br> CodPagamento <input type="hidden" name="codpagamento" value=""><br> Parcelas <input type="hidden" name="parcelas" value= ""><br> Tipoparcelado <input type="hidden" name="tipoparcelado" value= ""><br> <input type= "submit"> </form> Exemplo de POST Passthru Criptografado enviado no Passo 1 <form name="form1" method="post" action=" Id_Loja <input type="hidden" name="id_loja" value=""><br> Crypt <input type="hidden" name="crypt" value=""><br> <input type= "submit"> </form> IMPORTANTE: A tripa a ser enviada deve conter no mínimo os parâmetros obrigatórios: VENDAID, VALOR, NOME/RAZAO_PJ, CPF; CNPJ, CODPAGAMENTO, PARCELAS, TIPOPARCELADO. Tabela 3 Idioma da Transação (LANGUAGE indica o idioma a ser utilizado nas páginas de pagamento). Cód pt-br en-us Es-ES Idioma de Apresentação Português (Brasil) Inglês (Americano) Espanhol Telefone: (21) / (11) Página 19 de 41

20 Tabela 4 Tipo de Transação (TRANSACTIONTYPE indica o tipo de transação que está sendo enviada). Cód Tipo de Transação 1 Pré-Autorização 2 Captura Automática 3 Pré-Autorização com Autenticação* 4 Captura Automática com Autenticação* * Com Autenticação somente para os meios de pagamentos Cielo. * Cielo Pagamento com Celular Pós Pago e Cielo Pagamento com Celular Pré Pago só aceitam o valor Tipo Transação 3 e PASSO 5: Parâmetros a serem recebidos pela loja no POST de Retorno Após a conclusão da autorização da transação (Passo 4), a loja receberá um POST de Retorno na URL cadastrada em nosso banco de dados (URL de Retorno, Passo 5) com os seguintes parâmetros da tabela 4 (abaixo). Tabela 5 Parâmetros a serem recebidos pela loja no POST de Retorno Parâmetro Descrição Tamanho Min Max FORMAPAGTO Meio de pagamento utilizado pelo comprador CODPAGAMENTO Código da forma de pagamento (Tabela 8) 2 3 CODRETORNO DESRETORNO Código do erro da transação enviado pelas operadoras ou pelos bancos. Descrição do erro da transação descrição da operadora ou banco (vazio se não houve erros) VENDAID Número do pedido 1 50 VALOR Valor do pedido em centavos (R$1,00 = 100) CODAUTORIZACAO Código da autorização do cartão de crédito ou o código do boleto bancário TRANSID Código da transação (do cartão de crédito) RespostaAVS Retorno da verificação de endereço feita junto a administradora de cartão (caso AVS esteja ativado) 1 64 PARCELAS Número de parcelas da transação 1 2 LINHADIGITAVEL Linha digitável do boleto Telefone: (21) / (11) Página 20 de 41

21 LANGUAGE Novo! Idioma enviado pela loja (esse campo só retornará se a loja tiver enviado) (Tabela 3) 5 5 BRASPAGORDERID Identificador do pedido criado internamente CREDITCARDTOKEN Novo! Token do cartão de crédito armazenado no JustClick (somente para clientes que tem o JustClick habilitado) Importante: A URL de retorno do Passo 5 somente pode utilizar porta 80 (padrão para http) ou porta 443 (padrão para https). Nenhuma outra porta poderá ser utilizada, por exemplo, URL NÃO É VÁLIDA e não poderá ser utilizada. O POST de retorno é enviado Criptografado e será necessária a utilização do componente de criptografia para recebê-lo corretamente PASSO 6: Parâmetros recebidos pela loja na Resposta de Mudança de Status ATENÇÃO! O passo 6 (Resposta de Mudança de Status) é ALTAMENTE RECOMENDADO pela Braspag. Quando o status de pagamento do pedido mudar para Pago, se previamente configurado para tal, a loja receberá outro POST na URL cadastrada (URL de Mudança de Status) para indicar a confirmação do pagamento. Esta URL é diferente da usada para o primeiro POST do Passo 5! Os parâmetros que a loja receberá estão na tabela 6, abaixo. Tabela 6 - Parâmetros recebidos pela loja no Passo 6 (Resposta de Mudança do Status de Pagamento) Parâmetro Descrição Tamanho Min Max NumPedido Número do pedido 1 50 Status Status do Pagamento (Tabela 7) 1 1 CODPAGAMENTO Código da forma de pagamento (Tabela 8) 2 3 Tabela 7 Status do Pagamento Status Descrição 0 Pago 1 Autorizado, pendente de captura 2 Não autorizado Telefone: (21) / (11) Página 21 de 41

22 Quando acessada pelo servidor da Braspag, enviando o POST da Tabela 5, a URL cadastrada para Retorno de Mudança de Status fornecida pela loja deverá exibir um código informando que recebeu a mudança de status e a processou com sucesso. O Código é apenas o seguinte XML: <status>ok</status> Se a URL de mudança de status da loja for acessada pelo servidor da Braspag não exibir o código de confirmação, o servidor da Braspag irá tentar novamente por mais três vezes, a cada uma hora. Caso o <status>ok</status> ainda não seja exibido, será entendido que o servidor da loja não responde, e será enviado um ao responsável pela loja, informando que o pedido em questão foi pago. Exemplo em pseudo-código de como pode ser a página da loja que recebe o POST de Mudança de Status: Lê Numpedido, Status e Codpagamento do POST. Tenta atualizar o status da transação Numpedido no banco de dados da loja para PAGO. Se conseguiu atualizar normalmente: Imprime <status>ok</status> Ou seja, o código fonte da página indicando Sucesso deverá conter APENAS <status>ok</status> e nada mais. Observação: A URL de mudança de Status de Pagamento do Passo 6 somente pode utilizar porta 80 (padrão para http) ou porta 443 (padrão para https). Nenhuma outra porta poderá ser utilizada, por exemplo, URL NÃO É VÁLIDA e não poderá ser utilizada. ATENÇÃO! É de extrema importância que a URL de Mudança de Status (passo 6) somente aceite o POST proveniente dos números IPs informados pela Braspag. Desta forma o sistema garantirá o não recebimento de um POST forjado (fraudulento), garantindo a segurança na transação. Caso a loja utilize criptografia o post de Retorno e de Mudança de Status serão enviados Criptografados e será necessária a utilização do componente/webservice de criptografia para recebê-los corretamente (Anexo 1). Telefone: (21) / (11) Página 22 de 41

23 Tabela 8 Meios de Pagamento Códigos Meios de Pagamento 06 Boleto Bradesco 07 Boleto Caixa Econômica Federal 08 Boleto HSBC 09 Boleto Banco do Brasil 10 Boleto Real ABN AMRO 11 Débito Bradesco (SPS) 12 Itaú Shopline 13 Boleto Citibank 14 Boleto Itaú 15 BBPag 16 RealPague 28 Real FLV 30 Débito Banrisul 31 Débito Unibanco 32 Financiamento BBPag 34 Financiamento Eletrônico Bradesco 35 Paypal Express Checkout 92 Débito HSBC 111 SafetyPay 123 Cielo Visa Electron 124 Boleto Santander 500 Cielo VISA 501 Cielo MASTERCARD 502 Cielo AMEX 503 Cielo DINERS 504 Cielo ELO 505 Banorte VISA Telefone: (21) / (11) Página 23 de 41

24 506 Banorte MASTERCARD 507 Banorte DINERS 508 Banorte AMEX 509 Redecard Webservice VISA 510 Redecard Webservice MASTERCARD 511 Redecard Webservice DINERS 512 PagosOnLine VISA 513 PagosOnLine MASTERCARD 514 PagosOnLine AMEX 515 PagosOnLine DINERS 516 Payvision VISA 517 Payvision MASTERCARD 518 Payvision DINERS 519 Payvision AMEX 520 Banorte Cargos Automaticos VISA 521 Banorte Cargos Automaticos MASTERCARD 522 Banorte Cargos Automaticos DINERS 523 AMEX 2P 524 SITEF VISA 525 SITEF MASTERCARD 526 SITEF AMEX 527 DITEF DINERS 528 SITEF HIPERCARD 529 SITEF LEADER 530 SITEF AURA 531 SITEF SANTANDER VISA 532 SITEF SANTANDER MASTERCARD 535 SUB1 VISA 536 SUB1 MASTERCARD Telefone: (21) / (11) Página 24 de 41

25 537 SUB1 - AMEX 538 SUB1 DINERS 539 SITEF SONDA 540 SUB1 NARANJA 541 SUB1 NEVADA 542 SUB1 CABAL 543 Cielo DISCOVER 544 Cielo JCB 545 Cielo AURA 546 Cartão Presente Alelo 547 Cielo Pagamento por Celular Modalidade Pós Pago 548 Redecard Hipercard 549 Cielo Pagamento por Celular Modalidade Pré Pago 550 CredSystem 551 Boleto Caixa - SIGCB 552 Cielo Mastercard Débito 995 SIMULADO CAPTURA AUTOMÁTICA USD 996 SIMULADO CAPTURA AUTOMÁTICA EUR 997 Simulado 8. HOMOLOGAÇÃO DOS MEIOS DE PAGAMENTO E TESTES Cada meio de pagamento tem suas respectivas regras para homologação. Para tornar o processo de homologação mais ágil, relacionamos todos os requisitos de cada um dos meios para que o processo de homologação e a loja possa entrar no ar mais rapidamente. Qualquer um dos meios de pagamento pode alterar a qualquer hora as exigências para a homologação, sem aviso prévio, e este manual não necessariamente irá acompanhar estas mudanças em tempo real. Requisitos para homologação: As operadoras 1 - Cielo e 2 - Pagamento Fácil Bradesco (veja abaixo) exigem que as seguintes informações sejam mostradas ao comprador (cliente da loja) após a transação (no Passo 5): 1. Cielo Telefone: (21) / (11) Página 25 de 41

26 a) Exibir todos os campos do POST retornado pelo Pagador (no Passo 5). Nenhum campo pode ser ocultado. b) Apenas para VISA, quando CODRETORNO enviado pelo PAGADOR for (espaço), substituir por Pagamento Fácil Bradesco a) O código de autorização deve ser exibido da seguinte forma (16 caracteres por grupo): J34JK20K0AL0L10L I88S710ALGNDI HH658910J56D 94KA84LP84JF KSDO01899ID OK GG6FTS 0L9K8J7H6G5F4D3S P01Q9OW23E4R9OI8 Z12X3CV6B78N9M IDM95JD86DE ODKU876309OISJH3 859OOK JSH7 JD873JS8J20KSH74JF JD8J398O5KDF8J39D JD739JD7834JDF9H2 JDYJ28DH38YHD832 b) O Bradesco também exige que seja mostrado um telefone da loja para contato. c) Deve constar a data e hora da compra. d) Deve constar o prazo para pagamento, assim: Prazo para pagamento: 1 dia. e) O prazo de entrega deve estar explicito. No caso de serviço, prazo para liberação do serviço. f) No rodapé deve constar a frase "Qualquer dúvida quanto a qualidade e entrega deste(s) produto(s)/serviço, ligar para o telefone acima". TESTES As lojas de homologação podem ser criadas com as seguintes opções de pagamento: Cielo Visa (71), Cielo Mastercard (120), Amex (18), Débito Bradesco (11) e Boleto Bancário ABN AMRO(10). É necessário informar à equipe de implementação, a afiliação teste fornecida pelas Adquirentes. Cada opção de pagamento tem suas características. Para efetuar testes da melhor forma possível, atenção às características abaixo. Observação Importante sobre os Cartões de Teste Os números de cartões de teste abaixo apresentados não são de fato cartões mas apenas sequências de números que passam no teste de validade de cartão de crédito, assim sendo, eles são tratados pelos sistemas dos adquirentes como cartões inválidos, portanto em ambiente de produção nunca poderão ter retorno positivo, normalmente retornando erro de cartão inválido ou transação negada. Em ambiente de homologação é possível um retorno positívo, no entanto não é garantido. Sendo assim, o objetivo de testar com cartões de teste é apenas verificar o fluxo de informação, verificar que o sistema da loja consegue enviar informação corretamente para o sistema Pagador, e se consegue também receber corretamente as informações de retorno. Depois de testar com cartões de teste, podem também ser feitos testes com cartão de crédito real, mas é preciso tomar cuidado, pois o valor do teste será descontado do cartão, então recomenda-se fazer testes com valores baixos. Telefone: (21) / (11) Página 26 de 41

27 Amex Há como efetuar testes. Para tal você poderá usar um cartão de testes: Nome do Portador: TESTE - Nº do cartão: Cód. de segurança 1234 validade 05/13 Pagamento Fácil Bradesco Há como efetuar testes. Para tal você deve preencher todos os campos com o número 1. Boleto ABN AMRO Há como efetuar testes. Basta escolher a forma de pagamento boleto bancário e verificar que o boleto foi gerado corretamente na tela. Cielo Utilizar os cartões testes contidos no KIT e- commerce fornecido pela Adquirente ao contratar sua afiliação. Por que só posso testar estes meios de pagamento, mas não o meio de pagamento X? Estes meios de pagamento para teste são suficientes para testar a integração de uma loja. Se a loja testou com sucesso a emissão de boleto ABN AMRO, então ela conseguirá emitir com sucesso qualquer boleto, basta enviar o Código de meio de pagamento correspondente a outro boleto (veja Tabela 3) que o boleto de outro banco será emitido com igual sucesso. O mesmo ocorre com outros meios de pagamento, se a loja integrou com sucesso, a integração funcionará normalmente para qualquer cartão de crédito, seja Master, VISA, Diners ou Amex. Telefone: (21) / (11) Página 27 de 41

28 9. SUPORTE BRASPAG Ver anexo 7 abaixo. ANEXO 1 - USO DO COMPONENTE DE CRIPTOGRAFIA ATENÇÃO! O Uso do Componente de Criptografia é ALTAMENTE RECOMENDADO para integração por POST. Todos os dados que trafegam entre a Braspag e a Loja devem ser criptografados, para maior segurança. Existem 3 formas de a Loja implementar criptografia: DLL de Criptografia. É uma DLL criada pela Braspag especialmente para a Loja, que deverá ser registrada (instalada) no servidor do site da Loja, e irá realizar todas as operações de criptografia necessárias. Não pode ser utilizada em ambientes não- Windows (tais como Linux, Unix, etc) Componente Java de Criptografia. É um componente de criptografia feito em Java. Tem como vantagem a possibilidade de ser utilizado em qualquer ambiente, Linux, Unix, etc, mas tem uma maior complexidade de instalação e utilização. Webservice de Criptografia. É a opção ideal para uso de criptografia, além de geralmente ser a mais fácil de ser implementada, em qualquer ambiente. A loja utiliza o webservice da Braspag, enviando pra ele os dados a serem criptografados ou decriptografados, e recebe a resposta correspondente. A conexão é feita de forma segura, com SSL (assim como todos os webservices da Braspag), e o webservice somente aceita conexões de IPs explicitamente permitidos pela Loja. Solicite manual do webservice de criptografia ao RC, se necessário. Observação: mais de uma forma de criptografia podem ser utilizadas simultaneamente. Solicite os arquivos de exemplo para a sua linguagem de programação. Componente DLL (ASP e PHP) É uma biblioteca DLL para que sejam utilizados os métodos abaixo a fim de criptografar os campos a serem enviados no post. Para instalar a biblioteca, você deverá salvar o arquivo localmente, clicar em Iniciar, Executar e digitar: regsvr32 C:\[DIRETORIO_DA_BIBLIOTECA]\BraspagCOM.dll Telefone: (21) / (11) Página 28 de 41

29 Tabela 9 Método bool setfield(const char* field, const har* value) char* getencrypted() bool setencrypted(const char* cipher) char* getfield(const char* field) void clearfields() Função Adiciona um par de campo e valor à string criptografada Criptografa todos os campos já adicionados pelo setfield e retorna a string criptografada resultante. Recebe como parâmetro a string criptografada e decriptografa la, deixando os campos e valores contidos nela prontos para erem extraidos pelo getfield Retorna o valor do campo passado como parâmetro, se este stava contido na string criptografada e se já foi decriptografada elo setencrypted. Limpa os campos Exemplo de uso: Tabela 10 Criptografar Set crypt = erver.createobject("braspag.encryption") crypt.setfield("valor", "100"); crypt.setfield("vendaid", "10001"); string_criptografada = crypt.getencrypted() Decriptografar Set crypt = erver.createobject("braspag.encryption") crypt.setencrypted(string_criptografada); valor = getfield("valor"); vendaid = getfield("vendaid"); Post: <input type="hidden" name="id_loja" value=" "> <input type="hidden" name="crypt" value="<% Response.write string_criptografada %>"> Componente JAVA É uma biblioteca utilizada para criptografar os campos a serem enviados no post. No envio dos dados deve-se criar o objeto de criptografia e então chamar o método setfield(campo, valor) para todos os campos do form EXCETO o Id_Loja. No final, é necessário chamar o método getencrypted(chave) passando a chave de criptografia (informada pela Braspag). Este método retorna uma string que contém os campos já criptografados. No form devem ser passados apenas dois campos: Id_Loja que deve ser em texto limpo (sem criptografia) e o campo crypt que deve ter o conteúdo retornado pelo método getencrypted(chave) Telefone: (21) / (11) Página 29 de 41

30 braspag.encryption bcrypt = new braspag.encryption(); bcrypt.setfield("vendaid", "1234"); bcrypt.setfield("valor", "1500"); bcrypt.setfield("nome", "JOAO DA SILVA"); encryptedstr = bcrypt.getencrypted("chave"); <input type="hidden" name="id_loja" value=" "> <input type="hidden" name="crypt" value="dpbnuiyrxdh/jbu dfiubnouyv76foif87"> No recebimento dos dados, será enviado para a página apenas o campo crypt no form. Este campo deve ser lido e passado como 1º parâmetro para o método setencrypted O segundo parâmetro do método setencrypted deverá ser a sua chave de criptografia (informada pela Braspag). Logo após você poderá chamar o método getfield() passando o campo que você deseja ler. braspag.encryption bcrypt = new braspag.encryption(); bcrypt.setencrypted(encryptedstr, "CHAVE"); vendaid = bcrypt.getfield("vendaid"); valor = bcrypt.getfield("valor"); nome = bcrypt.getfield("nome"); Telefone: (21) / (11) Página 30 de 41

31 ANEXO 2 FLUXOS DE INTEGRAÇÃO VIA POST PARA CARTÕES DE CRÉDITO Telefone: (21) / (11) Página 31 de 41

32 ANEXO 3 Interfaces Webservice (Consulta) As modalidades de consulta permitem realizar consultas de pedidos. Método GetDadosPedido Este método permite realizar consultas dos status do pedido na Braspag via WebService. Este método recebe os seguintes parâmetros: Tabela 11 Parâmetros recebidos pelo método GetDadosPedido Parâmetro Descrição Máx. Obrigatório? merchantid Identificador único da loja.fornecido pela Braspag. { } 38 Sim orderid Número do Pedido 20 Sim Retorno do Método GetDadosPedido O método GetDadosPedido, retornará os parâmetros abaixo: Tabela 11.1 Parâmetros retornados pelo método GetDadosPedido Parâmetro Descrição Máx. Tipo CodigoAutorizacao CodigoErro MensagemErro CodigoPagamento FormaPagamento Código de autorização ou vazio caso o pedido não tenha sido autorizado Código do erro ou vazio caso não houve erro Mensagem de erro ou vazio caso não houve erro Código do meio de pagamento Tabela 09 String contendo o nome do meio de pagamento string string string string string NumeroParcelas Número de parcelas string Status Status do pedido ver tabela 8.1 int Valor Valor do pedido float Telefone: (21) / (11) Página 32 de 41

33 DataCancelamento DataPagamento DataPedido Data e hora do cancelamento do pedido, caso tenha sido cancelado formato mm/dd/aaaa hh:mm:ss tt (tt = AM/PM) Data e hora do pagamento do pedido, caso tenha sido pago formato mm/dd/aaaa hh:mm:ss tt (tt = AM/PM) Data e hora do pedido - formato mm/dd/aaaa hh:mm:ss tt (tt = AM/PM) string string string TransId Número da transação no adquirente string BraspagTid Identificador único da transação na Braspag string Tabela 11.2 Possíveis status de retorno do método GetDadosPedido Status Cód. Descrição Iniciado 1 Finalizado 2 O pedido foi enviado para o adquirente, mas ainda não foi finalizado. O pedido foi finalizado caso o mesmo tenha sido autorizado, o campo CodigoErro será vazio. Se foi recusado, o campo CodigoErro virá preenchido com o código retornado pelo adquirente Pago 3 O pedido foi autorizado e confirmado Cancelado 4 O pedido foi cancelado ATENÇÃO! status 3 (Pago). O pedido poderá ser tratado como pago apenas quando for retornado Telefone: (21) / (11) Página 33 de 41

34 Método GetDadosCartao Este método retorna todos os dados relativos ao cartão de crédito utilizado na compra e recebe os seguintes parâmetros: Tabela 12 Parâmetros recebidos pelo método GetDadosCartao Parâmetro Descrição Máx. Obrigatório merchantid Identificador único da loja. Fornecido pela Braspag. { } 38 Sim orderid Número do Pedido 20 Sim Retorno do Método GetDadosCartao O método GetDadosCartao, retornará os parâmetros abaixo: Tabela 12.1 Parâmetros retornados pelo método GetDadosCartao Parâmetro Descrição Máx. Obrigatório? Autenticada Se o cartão foi submetido a autenticação ou não. - Bool NumeroComprovante Número do comprovante do pedido. - String Emissor Nome do portador do cartão. - String NumeroAutenticacao Identificação de autenticação do número do cartão no banco emissor. - String NumeroAutorizacao Código de Autorização. - String NumeroCartao Número do Cartão mascarado. - String NumeroTransacao Número da Transação. - String Telefone: (21) / (11) Página 34 de 41

35 Método GetDadosComprador Este método retorna todos os dados relativos ao comprador. Este método recebe os seguintes parâmetros: Tabela 13 Parâmetros recebidos pelo método GetDadosComprador Parâmetro Descrição Máx. Obrigatório? merchantid Identificador único da loja. Fornecido pela Braspag. { } 38 Sim orderid Número do Pedido 20 Sim Retorno do Método GetDadosComprador O método GetDadosComprador, retornará os parâmetros abaixo: Tabela 13.1 Parâmetros retornados pelo método GetDadosComprador Parâmetro Descrição Máx. Tipo DataNascimento Data de nascimento do comprador. - String do Comprador. - String EstadoCivil Estado Civil do comprador. - String Fax Fax do Comprador. - String Identificacao Identificação (CPF e CNPJ) do Comprador. - String Nome Nome do Comprador. - String Profissao Profissão do comprador. - String RazaoSocial Se o comprador for um lojista, este campo retornará sua razão social. - String Sexo Sexo do comprador. - String Telefone Telefone do comprador. - String Telefone: (21) / (11) Página 35 de 41

36 Método GetDadosExtras Este método retorna todos os campos extras relativos ao pedido. Este método recebe os seguintes parâmetros: Tabela 14 Parâmetros recebidos pelo método GetDadosExtras Parâmetro Descrição Máx. Obrigatório merchantid Identificador único da loja. Fornecido pela Braspag. { } 38 Sim orderid Número do Pedido 20 Sim Retorno do Método GetDadosExtras O método GetDadosExtras, retornará os parâmetros abaixo: Tabela 14.1 Parâmetros retornados pelo método GetDadosExtras Parâmetro Descrição Máx. Tipo Campo Parâmetro passado pelo cliente. - Lista Valor Valor do parâmetro fornecido. - Lista Método GetDadosBoleto Este método retorna todos os dados relativos ao boleto utilizado na compra. Este método recebe os seguintes parâmetros: Tabela 15 Parâmetros recebidos pelo método GetDadosBoleto Parâmetro Descrição Máx. Obrigatório merchantid Identificador único da loja. Fornecido pela Braspag. { } 38 Sim orderid Número do Pedido 20 Sim Telefone: (21) / (11) Página 36 de 41

37 Retorno do Método GetDadosBoleto O método GetDadosBoleto, retornará os parâmetros abaixo: Tabela 15.1 Parâmetros retornados pelo método GetDadosBoleto Parâmetro Descrição Máx. Tipo NumeroDocumento Instrucoes Igual ao OrderID emitido pelo cliente. Informações para pagamento do boleto. - String - String Sacado Nome do Favorecido. - String NossoNumero Identificador do boleto no banco. - String LinhaDigitavel DataDocumento É a representação numérica do código de barras. Data em que o boleto foi gerado ou emitido. - String - String Datavencimento Data de vencimento do boleto. - String Cedente Banco Agencia Conta Carteira Contém informações de quem emitiu o boleto. (Dados da Loja) Instituição financeira responsável pela cobrança. Agencia bancária para pagamento do boleto. Conta bancária para pagamento do boleto. Contem o código da carteira, que está sendo utilizada. - String - String - String - String - String ValorDocumento Valor do Boleto. - String Telefone: (21) / (11) Página 37 de 41