PLATAFORMA PAGADOR INTEGRAÇÃO POST - Braspag · fraude e posteriormente capturar a transação...

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



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



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.



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.



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á



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).



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:



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.



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.



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.



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).



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



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



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>



� 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


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



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


FONE Número do telefone do Comprador (para Oi Paggo, enviar Celular com DDD neste campo).

1 64

Para Mobile e Cielo


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

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



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>



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


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



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)


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.



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).



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



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



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):



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



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.



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.



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)



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");



ANEXO 2 – FLUXOS DE INTEGRAÇÃO VIA POST PARA CARTÕES DE CRÉDITO



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



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).



� 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


� Retorno do Método GetDadosCartao O método GetDadosCartao, retornará os parâmetros abaixo: Tabela 12.1 – Parâmetros retornados pelo método GetDadosCartao


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



� 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


merchantId


38 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


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



� 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


merchantId


38 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


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


merchantId


38 Sim




� Retorno do Método GetDadosBoleto O método GetDadosBoleto, retornará os parâmetros abaixo: Tabela 15.1 – Parâmetros retornados pelo método GetDadosBoleto


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



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.



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.



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.



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.

PLATAFORMA PAGADOR INTEGRAÇÃO POST - Braspag · fraude e posteriormente capturar a transação...

Documents

Transcript of PLATAFORMA PAGADOR INTEGRAÇÃO POST - Braspag · fraude e posteriormente capturar a transação...