Upload
dangliem
View
215
Download
0
Embed Size (px)
Citation preview
PLATAFORMA PAGADOR INTEGRAÇÃO POST
Versão 1.9.11
30/07/2013
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 2 de 43 http://suporte.braspag.com.br
SUMÁRIO
1. INTRODUÇÃO .................................................................................................................................................... 4 1.1 Sobre este Manual .............................................................................................................................................. 4 1.2 Sobre a Plataforma .............................................................................................................................................. 4
2. PROCESSO DE INTEGRAÇÃO ............................................................................................................................... 5
3. FUNCIONALIDADES EXTRAS DO PAGADOR ........................................................................................................ 5
4. Funcionalidades Novas do Pagador ................................................................................................................... 6
5. QUAIS TIPOS DE INTEGRAÇÃO POSSO USAR? .................................................................................................... 8
6. INTEGRAÇÃO POR POST: Diferença entre modelo Index e Passthru ................................................................... 8 6.1 Post Index ............................................................................................................................................................ 8 6.2 Post Passthru ....................................................................................................................................................... 9
7. PASSOS TÉCNICOS .............................................................................................................................................11
8. HOMOLOGAÇÃO DOS MEIOS DE PAGAMENTO E TESTES ..................................................................................26
9. SUPORTE BRASPAG ..........................................................................................................................................29 ANEXO 1 - USO DO COMPONENTE DE CRIPTOGRAFIA ........................................................................................... 29 ANEXO 2 – FLUXOS DE INTEGRAÇÃO VIA POST PARA CARTÕES DE CRÉDITO ......................................................... 32 ANEXO 3 – Interfaces Webservice (Consulta) ......................................................................................................... 33 ANEXO 4 - DESCRIÇÃO DE ARQUIVOS DE EXEMPLO ............................................................................................... 39 ANEXO 5 – SUPORTE BRASPAG ............................................................................................................................... 40
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 3 de 43 http://suporte.braspag.com.br
HISTÓRICO DE ALTERAÇÕES
Versão Data Descrição
1.4 29/12/2009 Parâmetros CPF e CNPJ obrigatórios no envio em "PARÂMETROS A SEREM ENVIADOS NO PASSO 1 (post de Envio)"
1.5 07/04/2010 Atualização da Tabela 3 com novos meios de pagamento, novos Anexos
1.6 12/09/2011
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.
1.7 22/02/2012 Troca do telefone do escritório de São Paulo.
1.8 05/04/2012 Inclusão dos novos parâmetros, Multi Moeda; Multi idioma; BraspagOrderID e JustClick.
1.9 15/052012 Inclusão dos meio de pagamento: 524 até 532
1.9.1 19/06/2012 Inclusão do meio de pagamento: 35
1.9.2 28/09/2012 Inclusão dos meios de pagamento referentes a débito; Inserção do parâmetro BraspagOrderId
1.9.3 13/11/2012 Inclusão do Meio de Pagamento: 190 PAGGO (Mobile)
1.9.4 02/01/2013 Inclusão, na Tabela 1 do Post Index, dos seguintes parâmetros : TRANSACTIONTYPE, TRANSACTIONCURRENCY e TRANSACTIONCOUNTRY
1.9.5 25/02/2013
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
1.9.6 24/07/2013 Inclusão do meio de pagamento: 546; Retirada dos meios de pagamento: 46, 54, 55, 56, 90, 91,110, 154, 190;
1.9.7 24/09/2013
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;
1.9.8 12/11/2013 Inclusão do meio de pagamento: 550 e 551
1.9.9 10/12/2013 Inclusão do meio de pagamento 552
1.9.10 21/02/2014 Ateração do nome do meio de pagamento Cielo Mastercard Maestro para Cielo Mastercard Débito
1.9.11 30/07/2014 Inclusão do meio de pagamento: 565
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 4 de 43 http://suporte.braspag.com.br
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.
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 5 de 43 http://suporte.braspag.com.br
2. PROCESSO DE INTEGRAÇÃO
O processo de integração com o PAGADOR é simples e pode ser resumido nos seguintes passos: 1. Receber e-mail 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. 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.
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.
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 6 de 43 http://suporte.braspag.com.br
c) Retorno de Mudança de Status de Pagamento (USO ALTAMENTE RECOMENDADO PELA 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 anti-fraude 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á
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 7 de 43 http://suporte.braspag.com.br
foram previamente informados pelo comprador em compras passadas e serão replicados em futuras compras mediante seu aval.
o Parâmetro: SAVECREDITCARD (tabela 2) – Indica se o cartão será salvo ou não na Plataforma do JustClick
o Parâmetro CREDITCARDTOKEN (tabela 2) – Token do cartão de crédito gerado pela Plataforma JustClick
o 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 3166-1 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 (http://suporte.braspag.com.br).
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 8 de 43 http://suporte.braspag.com.br
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:
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 9 de 43 http://suporte.braspag.com.br
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.
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 10 de 43 http://suporte.braspag.com.br
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 e-mail de Kickoff.
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 11 de 43 http://suporte.braspag.com.br
7. PASSOS TÉCNICOS
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.
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 12 de 43 http://suporte.braspag.com.br
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 e-mail de Kickoff. Este POST deverá estar criptografado utilizando o Componente de Criptografia descrito no Anexo 1.
2. 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).
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
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).
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 13 de 43 http://suporte.braspag.com.br
na tela para o comprador para que o boleto possa ser impresso e pago pelo cliente da loja.” 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 38 38 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 1 255 Sim
CPF CPF do Comprador (se pessoa física) 11 14 Sim
RAZAO_PJ Nome da empresa (Se pessoa jurídica)
1 255 Sim
CNPJ Número do CNPJ (se pessoa jurídica) 14 18 Sim
LOGRADOURO Logradouro do Comprador (ex: Rua, Av., Trav...) 1 255 Não
ENDERECO Endereço do Comprador (ex: nome da rua) 1 255 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 1 255 Não
CIDADE Cidade do Comprador 1 255 Não
CEP CEP do 8 9 Não
ESTADO Estado (UF) do Comprador 2 2 Não
PAIS País do Comprador 1 255 Não
NASC Data nascimento do Comprador (formato: dd/mm/aaaa
10 10 Não
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 14 de 43 http://suporte.braspag.com.br
ESTCIVIL Estado civil do Comprador (Solteiro = S; Casado = C;
1 1 Não
SEXO Sexo do comprador (M ou F) 1 1 Não
PROF Profissão do Comprador 1 255 Não
DDD
Número do código de Discada direta a distância (para Cielo pagamento com celular utilizar esse campo para o DDD)
2
Apenas para Cielo
pagamento com Celular
FONE Número do telefone do Comprador (para Oi Paggo, enviar Celular com DDD neste campo).
1 64
Para Mobile e Cielo
pagamento com celular
FAX Número do fax do Comprador 1 64 Não
EMAIL E-mail do comprador 1 255 Não
LOGRADOURO_D Logradouro do endereço de entrega (ex: Rua, Avenida, Estada...)
1 255 Não
ENDERECO_D Endereço de entrega 1 255 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 1 255 Não
CIDADE_D Cidade de Entrega 1 255 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 1 255 Não
TRANSACTIONTYPE –
Novo! Indica o tipo de transação (Tabela 4) 1 1 Sim
TRANSACTIONCURRENCY – Novo!
Indica a moeda da transação (ISO 4217) 3 3 Sim
TRANSACTIONCOUNTRY – Novo!
Indica o pais da transação (ISO 3166-1 Alfa-3)
3 3 Sim
BRASPAGORDERID –
Novo!
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
GUID
Não
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 15 de 43 http://suporte.braspag.com.br
ao mesmo pedido
LANGUAGE – Novo! Idioma de exibição das páginas de pagamento. (Tabela 3)
5 5 Não
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.
1 768 Não
IMPORTANTE: A tripa a ser enviada deve conter no mínimo os parâmetros obrigatórios: VENDAID, VALOR, NOME/RAZÃO_PJ e CPF/CNPJ.
Exemplo de POST Index enviado no Passo 1 <form name="form1" method="post" action="https://www.pagador.com.br/pagador/index.asp"> 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> <input type= "submit">
Exemplo de POST Index Criptografado enviado no Passo 1 <form name="form1" method="post" action="https://www.pagador.com.br/pagador/index.asp"> Id_Loja <input type="hidden" name="Id_Loja" value=""><br> Crypt <input type="hidden" name="crypt" value=""><br> <input type= "submit"> </form>
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 16 de 43 http://suporte.braspag.com.br
� 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 38 38 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 1 255 Sim
CPF CPF do Comprador (se pessoa física) 11 14 Sim
CODPAGAMENTO Identificação da forma de pagamento (Tabela 8)
2 3 Sim
PARCELAS número de parcelas em que o valor total será dividido (padrão = 1)
1 2 Sim
TIPOPARCELADO
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
1 1 Sim
RAZAO_PJ Nome da empresa (Se pessoa jurídica) 1 255 Sim
CNPJ Número do CNPJ (se pessoa jurídica) 14 18 Sim
LOGRADOURO Logradouro do Comprador (ex: Rua, Av., Trav...)
1 255 Não
ENDERECO Endereço do Comprador (ex: nome da rua)
1 255 Não
NUMERO Número do endereço do Comprador Não
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 17 de 43 http://suporte.braspag.com.br
COMPLEMENTO Complemento do endereço do Comprador Não
BAIRRO Bairro do Comprador 1 255 Não
CIDADE Cidade do Comprador 1 255 Não
CEP CEP do 8 9 Não
ESTADO Estado (UF) do Comprador 2 2 Não
PAIS País do 1 255 Não
NASC Data nascimento do Comprador (formato: dd/mm/aaaa
10 10 Não
ESTCIVIL Estado civil do Comprador (Solteiro = S; Casado = C; 1 1 Não
SEXO Sexo do comprador (M ou F) 1 1 Não
PROF Profissão do Comprador 1 255 Não
DDD
Número do código de Discada direta a distância (para Cielo pagamento com celular utilizar esse campo para o DDD)
1
Apenas para Cielo
pagamento com Celular
FONE Número do telefone do Comprador (para Oi Paggo, enviar Celular com DDD neste campo).
1 64
Para Mobile e Cielo
pagamento com Celular
FAX Número do fax do Comprador 1 64 Não
EMAIL E-mail do comprador 1 255 Não
LOGRADOURO_D Logradouro do endereço de entrega (ex: Rua, Avenida, Estada...)
1 255 Não
ENDERECO_D Endereço de entrega 1 255 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 1 255 Não
CIDADE_D Cidade de Entrega 1 255 Não
CEP_D CEP de entrega 8 9 Não
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 18 de 43 http://suporte.braspag.com.br
ESTADO_D Estado de entrega (UF) 2 2 Não
PAIS_D Pais de entrega 1 255 Não
BRASPAGORDERID –
Novo!
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
GUID
Não
CREDITCARDTOKEN –
Novo! Token do cartão de crédito armazenado no JustClick
36 36 Não
SAVECREDITCARD –
Novo!
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)
4 5 Não
TRANSACTIONTYPE –
Novo! Indica o tipo de transação (Tabela 4) 1 1 Sim
TRANSACTIONCURRENCY – Novo!
Indica a moeda da transação (ISO 4217) 3 3 Sim
TRANSACTIONCOUNTRY – Novo!
Indica o pais da transação (ISO 3166-1 Alfa-3) 3 3 Sim
LANGUAGE – Novo! Idioma de exibição das páginas de pagamento. (Tabela 3)
5 5 Não
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.
1 768 Não
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 19 de 43 http://suporte.braspag.com.br
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 Idioma de Apresentação
pt-BR Português (Brasil)
en-US Inglês (Americano)
Es-ES Espanhol
Exemplo de POST PASSTHRU enviado no Passo 1 <form name="form1" method="post" action="https://www.pagador.com.br/pagador/Passthru.asp"> 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="https://www.pagador.com.br/pagador/passthru.asp"> Id_Loja <input type="hidden" name="Id_Loja" value=""><br> Crypt <input type="hidden" name="crypt" value=""><br> <input type= "submit"> </form>
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 20 de 43 http://suporte.braspag.com.br
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 4 6.2. 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 1 128
CODPAGAMENTO Código da forma de pagamento (Tabela 8) 2 3
CODRETORNO Código do erro da transação enviado pelas operadoras ou pelos bancos.
1 128
DESRETORNO Descrição do erro da transação – descrição da operadora ou banco (vazio se não houve erros)
0 512
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
1 768
TRANSID Código da transação (do cartão de crédito) 1 256
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 47 54
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 21 de 43 http://suporte.braspag.com.br
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 36 36
CREDITCARDTOKEN
– Novo!
Token do cartão de crédito armazenado no JustClick (somente para clientes que tem o JustClick habilitado).
36 36
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 http://www.loja.com:5555/retorno.asp 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. 6.3. PASSO 6: Parâmetros recebidos pela loja na Resposta de Mudança de Status 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
ATENÇÃO! O passo 6 (Resposta de Mudança de Status) é ALTAMENTE RECOMENDADO pela Braspag.
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 22 de 43 http://suporte.braspag.com.br
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 23 de 43 http://suporte.braspag.com.br
Quando acessada pelo servidor da Braspag, enviando o POST da Tabela 6, 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 e-mail 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:
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 http://www.loja.com:5555/status.asp NÃO É VÁLIDA e não poderá ser utilizada.
Exemplo de POST em sua URL:
FORM/POST PARAMETERS Status: 0 NumPedido: 16135 CODPAGAMENTO: 501 RAW BODY NumPedido=16135&Status=0&CODPAGAMENTO=501
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>
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).
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 24 de 43 http://suporte.braspag.com.br
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
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 25 de 43 http://suporte.braspag.com.br
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
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 26 de 43 http://suporte.braspag.com.br
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
565 CREDZ
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):
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 27 de 43 http://suporte.braspag.com.br
1. Cielo
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 00.
2. Pagamento Fácil Bradesco
a) O código de autorização deve ser exibido da seguinte forma (16 caracteres por grupo): J34JK20K0AL0L10L I88S710ALGNDI875 0987HH658910J56D 94KA84LP84JF8209 09649KSDO01899ID OK99008877GG6FTS 0L9K8J7H6G5F4D3S P01Q9OW23E4R9OI8 Z12X3CV6B78N9M09 019283IDM95JD86DE ODKU876309OISJH3 859OOK0192873JSH7 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
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 28 de 43 http://suporte.braspag.com.br
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.
� Amex Há como efetuar testes. Para tal você poderá usar um cartão de testes: Nome do Portador: TESTE - Nº do cartão: 345678000000007 – 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.
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 29 de 43 http://suporte.braspag.com.br
9. SUPORTE BRASPAG
Ver anexo 7 abaixo.
ANEXO 1 - USO DO COMPONENTE DE CRIPTOGRAFIA
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”
ATENÇÃO! O Uso do Componente de Criptografia é ALTAMENTE RECOMENDADO para integração por POST.
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 30 de 43 http://suporte.braspag.com.br
Tabela 9
Método Função
bool setField(const char* field, const har* value)
Adiciona um par de campo e valor à string criptografada
char* getEncrypted() Criptografa todos os campos já adicionados pelo setField e retorna a string criptografada resultante.
bool setEncrypted(const char* cipher)
Recebe como parâmetro a string criptografada e decriptografa la, deixando os campos e valores contidos nela prontos para erem extraidos pelo getField
char* getField(const char* field)
Retorna o valor do campo passado como parâmetro, se este stava contido na string criptografada e se já foi decriptografada elo setEncrypted.
void clearFields() Limpa os campos
Exemplo de uso: Tabela 10
Criptografar Decriptografar
Set crypt = erver.CreateObject("Braspag.Encryption") crypt.setField("valor", "100");
Set crypt = erver.CreateObject("Braspag.Encryption") crypt.setEncrypted(string_criptografada);
crypt.setField("vendaid", "10001"); string_criptografada = crypt.getEncrypted()
valor = getField("valor"); vendaid = getField("vendaid");
Post: <input type="hidden" name="Id_Loja" value="00000000-0000-0000-0000-000000000000"> <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)
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 31 de 43 http://suporte.braspag.com.br
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="00000000-0000-0000-0000-000000000000"> <input type="hidden" name="crypt" value="dpBNUIyrxdH/JBu6... ...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");
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 32 de 43 http://suporte.braspag.com.br
ANEXO 2 – FLUXOS DE INTEGRAÇÃO VIA POST PARA CARTÕES DE CRÉDITO
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 33 de 43 http://suporte.braspag.com.br
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. {00000000-0000-0000-0000-000000000000}
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 Código de autorização ou vazio caso o pedido não tenha sido autorizado
string
CodigoErro Código do erro ou vazio caso não houve erro
string
MensagemErro Mensagem de erro ou vazio caso não houve erro
string
CodigoPagamento Código do meio de pagamento – Tabela 09 string
FormaPagamento String contendo o nome do meio de pagamento
string
NumeroParcelas Número de parcelas string
Status Status do pedido – ver tabela 8.1 int
Valor Valor do pedido float
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 34 de 43 http://suporte.braspag.com.br
DataCancelamento
Data e hora do cancelamento do pedido, caso tenha sido cancelado – formato mm/dd/aaaa hh:mm:ss tt (tt = AM/PM)
string
DataPagamento
Data e hora do pagamento do pedido, caso tenha sido pago – formato mm/dd/aaaa hh:mm:ss tt (tt = AM/PM)
string
DataPedido Data e hora do pedido - formato mm/dd/aaaa hh:mm:ss tt (tt = AM/PM)
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 O pedido foi enviado para o adquirente, mas ainda não foi finalizado.
Finalizado 2
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! O pedido poderá ser tratado como pago apenas quando for retornado status 3 (Pago).
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 35 de 43 http://suporte.braspag.com.br
� 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. {00000000-0000-0000-0000-000000000000}
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
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 36 de 43 http://suporte.braspag.com.br
� 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. {00000000-0000-0000-0000-000000000000}
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
Email Email 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
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 37 de 43 http://suporte.braspag.com.br
� 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. {00000000-0000-0000-0000-000000000000}
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. {00000000-0000-0000-0000-000000000000}
38 Sim
orderId Número do Pedido 20 Sim
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 38 de 43 http://suporte.braspag.com.br
� 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 Igual ao OrderID emitido pelo cliente.
- String
Instrucoes Informações para pagamento do boleto.
- String
Sacado Nome do Favorecido. - String
NossoNumero Identificador do boleto no banco. - String
LinhaDigitavel É a representação numérica do código de barras.
- String
DataDocumento Data em que o boleto foi gerado ou emitido.
- String
Datavencimento Data de vencimento do boleto. - String
Cedente Contém informações de quem emitiu o boleto. (Dados da Loja) - String
Banco Instituição financeira responsável pela cobrança.
- String
Agencia Agencia bancária para pagamento do boleto.
- String
Conta Conta bancária para pagamento do boleto. - String
Carteira Contem o código da carteira, que está sendo utilizada. - String
ValorDocumento Valor do Boleto. - String
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 39 de 43 http://suporte.braspag.com.br
ANEXO 4 - DESCRIÇÃO DE ARQUIVOS DE EXEMPLO
Junto com este manual há alguns arquivos de exemplo em ASP. Se sua loja usa o modo Index, você deve olhar os arquivos index.asp, formapgto.asp, recebe.asp e confirmacao.asp Se sua loja usa o modo Passthru, os arquivos são index-passthru.asp, forma-passthru.asp, recebe.asp e confirmacao.asp index.asp Contém o catálogo dos produtos da loja. Ao clicar no produto que deseja comprar, o comprador será redirecionado para a tela de cadastro. recebe.asp Esta página informa ao comprador se a compra foi efetuada com sucesso ou se houve algum erro. Ela recebe os dados da compra: forma de pagamento utilizada, código e descrição do erro, se houve algum, número do pedido, valor, código da autorização e da transação. Esta é a página utilizada no Passo 5 no diagrama da Página 6. formapgto.asp O comprador digita seus dados e confirma a compra. Após esta tela, o comprador será redirecionado para a tela da Braspag, onde escolherá qual a forma de pagamento (Passo 1 no diagrama da Página 6) Após a finalização da compra, o comprador é redirecionado novamente para a página da loja (Passo 5 no diagrama da Página 6, esta URL de Retorno é cadastrada em nosso banco de dados). index-passthru.asp Este é o arquivo de exemplo para o modo passthru. Contém o catálogo dos produtos da loja. Ao clicar no produto que deseja comprar, o comprador será redirecionado para a tela de cadastro. A única diferença entre este arquivo e o index.asp é a página que será chamada em seguida. formapgto-passthru.asp O comprador digita seus dados, escolhe a forma de pagamento que utilizará e confirma a compra. Após a finalização da compra, o comprador é redirecionado novamente para a página da loja (página cadastrada em nosso banco de dados). confirmacao.asp Esta página recebe o POST de confirmação de pagamento e informa à Braspag o recebimento do mesmo. Ela recebe o número do pedido e o status de pagamento e retorna um XML dizendo <status>OK</status>. Esta é a página utilizada no Passo 6 no diagrama da Página 6.
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 40 de 43 http://suporte.braspag.com.br
ANEXO 5 – SUPORTE BRASPAG
PADRÃO DE SERVIÇO – PROCEDIMENTO PARA SUPORTES OPERACIONAIS VERSÃO 1.7
1. SERVICO: Este documento tem o propósito de orientar o cliente quanto aos procedimentos
internos de Suportes Operacionais, tempos de respostas em diversos estágios de classificação de problema, bem como informar os níveis de serviço sistêmico.
Este documento poderá sofrer alterações periódicas.
2. TÉCNICO: 2.1. DISPONIBILIDADE: Este item trata da disponibilidade dos serviços prestados ao cliente em ambiente de produção. A Braspag manterá equipe dedicada para não permitir níveis superiores aos descritos no SLA definido no seu contrato. * Os ambientes de teste (homologação) poderão sofrer atualizações periódicas e poderão ter sua disponibilidade comprometida por tempo indeterminado, bem como os ambientes que não são caracterizados como missão crítica e ambientes de consulta. 2.2. RESPONSABILIDADE SOBRE O SERVIÇO: Eventual downtime em qualquer meio de pagamento ou erro de cadastro de afiliação não é de responsabilidade da Braspag. O Suporte está treinado, no entanto, para fornecer informações a respeito da origem desses problemas para que possam ser tratados diretamente pelo cliente. 3. COBERTURA E PROCEDIMENTOS PARA SUPORTE OPERACIONAL: 3.1. HORÁRIO DE ATENDIMENTO: Braspag atenderá os pedidos de Suporte de segunda a sexta-feira das 09:00am às 6:00pm horário de Brasília. 3.2. CANAIS DE ATENDIMENTO E NORMAS DE CONTATO: SISTEMA WEB DE SUPORTE: É o canal principal de suporte para os clientes Braspag, os chamados podem ser abertos e acompanhados através do site http://www.braspag.com.br/suporte/. São necessários login e senha para a utilização, caso ainda não possua senha, por favor solicitar no email [email protected], informando o ID da sua loja, nome da loja, nome completo e telefone de contato. EMAIL: Não haverá suporte via email. Todas as mensagens enviadas para o antigo email de suporte irão receber um reply automático com as instruções para o sistema de suporte via web. TELEFONES: Não deve ser utilizado para chamados de severidade 3 ou severidade 4.
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 41 de 43 http://suporte.braspag.com.br
ATENÇÃO: Ligações para o suporte somente podem ser feita em posse do número do ticket de chamado, obtido no sistema de suporte web da Braspag no site http://www.braspag.com.br/suporte/ Tel: +55 (21) 2111-4713 *Os atendimentos em outros ramais não será permitido. *Não é permitida a abertura de chamado em e-mails ou telefones pessoais de funcionários da Braspag. 3.3. CLASSIFICAÇÃO DE PROBLEMAS E TEMPOS DE RESPOSTA: Os problemas serão classificados pela criticidade/severidade e terão prazos de resposta , compatíveis com a urgência da demanda. O quadro abaixo descreve possíveis demandas, suas classificações e tempo de resposta esperado: Tabela 16 – Parâmetros recebidos pelo método GetDadosExtras
Descrição do problema Severidade Tempo máximo
de resposta Exemplos
Dúvidas de integração, configuração e problemas em ambiente de homologação, dúvidas relativas a alguma transação de pagamento, dúvidas no processo de homologação com bancos ou adquirentes, ou qualquer outro problema que não gere perda de transações em ambiente de produção.
Severidade 4 (mínima)
48 horas úteis
Como está meu processo de
homologação Visa? Poderia configurar
uma URL de retorno para o meu ambiente
de testes?
Configuração em ambiente de produção, implementação de meio de pagamento já homologado, bugs que gerem informações incorretas sem impacto na experiência de compra ou em ambiente de produção que não prejudique o processo de compra(visão comprador).
Severidade 3 (moderada) 24 horas útil
Não recebi o 2º. Post? Poderia habilitar a
chave de criptografia?
Impossibilidade de realizar transações com meios de pagamento já implantado ou qualquer bug/problema em ambiente de produção com impacto no processo de compra do cliente(visão comprador)
Severidade 2 (sério)
2 horas Lentidão transacional
Qualquer problema de disponibilidade em ambiente de produção que impossibilite o sistema de receber e autorizar transações com todos os meios de
Severidade 1 (critico) 30 minutos
Aparentemente o servidor está fora do
ar.
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 42 de 43 http://suporte.braspag.com.br
pagamento.
3.4. ATENDIMENTOS DE EMERGÊNCIA: Suporte Técnico para Emergência será prestado pelas linhas: +55 21 8301-0143 (BR-RJ) +00 55 21 8301-0143 (USA) Somente poderá ser acionado em caso 1 de Severidade de acordo com a tabela acima. Obs.: Caso sua ligação não seja imediatamente atendida devido ao nosso suporte de plantão estar em outra ligação ou já estar tratando do problema, é necessário deixar um recado com as informações: Nome Nome da Empresa Telefone de contato Qual Meio de Pagamento está apresentando indisponibilidade. Retornaremos o ligação o mais breve possível. Os atendimentos poderão ser feitos em Português e Inglês. 4. PROCEDIMENTO PARA SOLUÇÃO DE PROBLEMAS CRÍTICOS: Em caso de downtime, a equipe de TI é imediatamente acionada por SMSs e e-mails para a solução imediata do problema. Em caso de haver conflito sobre caracterização do problema, o gerente de TI da Braspag deverá ser acionado e definirá o nível a ser tratado, na ausência do Gerente de TI, qualquer Gerente de Departamento poderá tomar a decisão. O telefone disponibilizado para este caso é 55 (21) 2111-4700. 5. ATUALIZAÇÕES E INOPERATIVIDADE PROGRAMADA: A Braspag poderá dentro dos padrões descritos no ítem 2.1. deste documento, inoperar o serviço por motivos de atualização ou migração de servidores. Este procedimento, quando ocorrer, deverá ser realizado de madrugada em horário que gere menos impacto possível a operação de todos os clientes. 6. OUVIDORIA: O cliente que se sentir prejudicado pelo processo ou tiver algumas das regras de atendimento violadas deverá direcionar seu pleito para [email protected]; esta mensagem desencadeará um processo interno e o cliente receberá um contato de um Ouvidor em 48h úteis. Obs.: A qualquer tempo o cliente poderá entrar em contato com o gerente de sua conta na Braspag; o contato será fornecido no ato do fechamento da parceria. 7. REPORT SOBRE FALHAS: Em casos de downtime, se solicitado, o gerente de conta do cliente na Braspag enviará um Report com detalhes técnicos sobre a falha, no período de 48h úteis.
PAGADOR - Manual de Integração POST
Telefone: (21) 2111-4700 / (11) 3320.9050 Página 43 de 43 http://suporte.braspag.com.br