plataforma pagador integração post

Transcrição

PLATAFORMA PAGADOR
INTEGRAÇÃO POST
Versão 1.9.9.1
21/02/2013
PAGADOR - Manual de Integração POST
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 ..................................................................................25
9.
SUPORTE BRASPAG ..........................................................................................................................................28
ANEXO 1 - USO DO COMPONENTE DE CRIPTOGRAFIA ........................................................................................... 28
ANEXO 2 – FLUXOS DE INTEGRAÇÃO VIA POST PARA CARTÕES DE CRÉDITO ......................................................... 31
ANEXO 3 – Interfaces Webservice (Consulta) ......................................................................................................... 32
ANEXO 4 - DESCRIÇÃO DE ARQUIVOS DE EXEMPLO ............................................................................................... 38
ANEXO 5 – SUPORTE BRASPAG ............................................................................................................................... 39
Telefone: (21) 2111-4700 / (11) 3320.9050
http://suporte.braspag.com.br
Página 2 de 41
HISTÓRICO DE ALTERAÇÕES
Versão
Data
Descrição
1.4
29/12/2009
1.5
07/04/2010
1.6
12/09/2011
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
1.9.5
25/02/2013
1.9.6
24/07/2013
1.9.7
24/09/2013
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.10
21/02/2014
Ateração do nome do meio de pagamento Cielo Mastercard Maestro
para Cielo Mastercard Débito
Parâmetros CPF e CNPJ obrigatórios no envio em "PARÂMETROS A
SEREM ENVIADOS NO PASSO 1 (post de Envio)"
Atualização da Tabela 3 com novos meios de pagamento, novos
Anexos
Formatação e revisão ortográfica, alteração Tabela 2 com
informações nova plataforma CIELO, atualização dos códigos dos
meios de pagamento da tabela 3, atualização dos meios de
pagamento com delay de captura.
Inclusão, na Tabela 1 do Post Index, dos seguintes parâmetros :
TRANSACTIONTYPE, TRANSACTIONCURRENCY e
TRANSACTIONCOUNTRY
Inclusão do meio de pagamento: 535, 536, 537, 538, 539, 540,
541, 542, 543, 544 e 545;
Retirada do meio de pagamento: 105;
Alteração do parâmetro ExtraDynamicurl
Inclusão do meio de pagamento: 546;
Retirada dos meios de pagamento: 46, 54, 55, 56, 90, 91,110,
154, 190;
Inclusão dos meios de pagamento: 547, 548 e 549;
Alteração do nome do meio de pagamento 546 (De Givex para
Cartão Presente Alelo);
Inclusão do parâmetro DDD nas tabelas 1 e 2 referente ao meio de
pagamento Cielo pagamento com celular;
Telefone: (21) 2111-4700 / (11) 3320.9050
Página 3 de 41
1. INTRODUÇÃO
1.1 Sobre este Manual
O objetivo deste documento é orientar o desenvolvedor da loja sobre como fazer a integração
com o sistema Pagador da Braspag, descrevendo as funcionalidades, os métodos a serem
utilizados, listando informações a serem enviadas e recebidas, e provendo exemplos.
1.2 Sobre a Plataforma
A plataforma PAGADOR tem a finalidade de auxiliar o estabelecimento de e-commerce no
processamento de trasações pontuais através de uma única integração a todos os meios de
pagamento, com resposta em real time.
Telefone: (21) 2111-4700 / (11) 3320.9050
Página 4 de 41
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.
ATENÇÃO! A utilização do componente de Criptografia para integração por POST
ALTAMENTE RECOMENDADA para proporcionar uma maior segurança às transações.
b) Conciliação automática dos Boletos: o Pagador pode fazer a conciliação automática dos
boletos assim que eles forem pagos e o banco encaminhar um arquivo de retorno para
a Braspag. Para a utilização desta funcionalidade é essencial o uso do Retorno de Mudança
de Status (descrito abaixo no item 6).
Importante: A conciliação automática de boletos só ocorrerá através de um convênio
entre o banco, o estabelecimento e a Braspag. Sem este convênio o sistema não identificará
o pagamento dos boletos. Informe-se a respeito junto a Área de Relacionamento com o
Cliente.
c) Retorno de Mudança de Status de Pagamento (USO ALTAMENTE RECOMENDADO
Telefone: (21) 2111-4700 / (11) 3320.9050
Página 5 de 41
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 antifraude e posteriormente capturar a transação caso a análise libere. Solicite a equipe de
implementação a homologação dessa modalidade.
f) Pagador junto com o Pagador Recorrente: Caso o estabelecimento tenha contratado o
Pagador e o Pagador Recorrente, ele poderá fazer a 1ª transação do Recorrente em tempo
real através de uma integração com o Pagador (veja detalhes no Anexo 5)
4. FUNCIONALIDADES NOVAS DO PAGADOR

Multi-Idioma
o É possível escolher o idioma exibido nas páginas de fluxo do Post onde possui
interação com o cliente final (páginas de pagamentos).
o Os idiomas disponíveis são: Português (BR); Inglês (US) e Espanhol (ES).
o Essa alteração será realizada através do parâmetro: LANGUAGE (tabela 3)
o Caso a loja não envie o parâmetro LANGUAGE, as páginas de pagamentos
serão exibidas no idioma preferencial do navegador do cliente final.
o Caso o idioma enviado pela loja ou do navegador do cliente final não sejam
suportados, as páginas de pagamentos serão exibidas em Inglês (US).

JustClick
o O JUSTCLICK SHOP é uma solução para fazer cobrança de transações pontuais
de cartão de crédito (à vista ou parceladas) com resposta em real time e on-line
para e-commerce e call-center, usando o conceito de 1-Click Shop (compra com
1 clique) ou venda sem digitação. A plataforma recebe os dados de uma venda e
concecta-se ao PAGADOR para fazer o processamento.
o A “compra com 1 clique” permite que um pagamento online via cartão de crédito
seja feito pulando a etapa de preenchimento dos dados para pagamento ou até
mesmo de todo o processo do carrinho de compras, pois os dados do cartão já
foram previamente informados pelo comprador em compras passadas e serão
replicados em futuras compras mediante seu aval.
Telefone: (21) 2111-4700 / (11) 3320.9050
Página 6 de 41
o
o
o
Parâmetro: SAVECREDITCARD (tabela 2) – Indica se o cartão será salvo ou
não na Plataforma do JustClick
Parâmetro CREDITCARDTOKEN (tabela 2) – Token do cartão de crédito gerado
pela Plataforma JustClick
Para a utilização dessa funcionalidade é necessário entrar em contato com a
Equipe Comercial da Braspag.
Obs: Somente pode ser utilizado na Integração Post via Passthru

Multi-Moeda
o É possível especificar qual moeda/país o pagamento será processado
o Necessário verificar a lista de compatibilidade dos meios de pagamento que
suportam multi-moeda.
o Essa informação será enviando no parâmetro: TRANSACTIONCURRENCY (ISO
4217) e TRANSACTIONCOUNTRY (ISO 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).
Telefone: (21) 2111-4700 / (11) 3320.9050
Página 7 de 41
5. QUAIS TIPOS DE INTEGRAÇÃO POSSO USAR?
A Braspag oferece três tipos de integração para um estabelecimento enviar transações para o
Pagador:
 Integração por POST: modelos Passthru ou Index (descritos neste manual)
 Integração por WebService (solicitar manual a Área de Relacionamento com Cliente)
(é possível utilizar também uma combinação dos tipos acima)
A integração por WebService tem como vantagem ser mais rápida e mais resistente a falhas,
pois toda a comunicação é feita servidor a servidor, sem possibilidade de interferência do
usuário. Entretanto, nem todos os meios de pagamento podem ser utilizados com esta
integração, como por exemplo, os débitos online, onde é necessário que o comprador (cliente
da loja) seja direcionado ao ambiente do banco para efetuar a transação. A integração por
Webservice não necessita de utilização do componente de Criptografia, pois basta realizar uma
restrição de acesso aos IPs do seu servidor.
A integração por POST (Index ou Passthru) permite uso de praticamente todos os meios de
pagamento, com apenas algumas exceções. Dependendo da integração e forma técnica da
implementação, esta integração pode envolver o computador do comprador (cliente da loja), o
que diminui resistência a falhas além de permitir interferência do comprador (cliente da loja)
no processo, como por exemplo, ele pode apertar tecla ESC ou F5 interrompendo a transação
sem saber o resultado.
Este manual cobre apenas a integração por POST (Index e Passthru). O manual para
integração por Webservice poderá ser solicitado separadamente para a Área de
Relacionamento com Cliente através da ferramenta de suporte.
6. INTEGRAÇÃO POR POST: DIFERENÇA ENTRE MODELO INDEX E PASSTHRU
6.1 Post Index
No modelo de integração por POST Index o comprador escolhe o meio de pagamento no
servidor da Braspag (em uma página da Braspag com o look and feel da loja). Veja exemplo
abaixo:
Telefone: (21) 2111-4700 / (11) 3320.9050
Página 8 de 41
Neste modelo é possível customizar alguns parâmetros como a imagem do header e footer, a
cor do fundo da tela dos meios de pagamento e do fundo da barra de título “Selecione o meio
de pagamento desejado”, tamanho, tipo e cor das fontes.
6.2 Post Passthru
No modelo de integração por POST Passthru o comprador escolhe a forma de pagamento no
próprio site da loja, conforme imagem abaixo.
Neste modelo há maior flexibilidade com relação ao layout da página de escolha de meios de
pagamento uma vez que 100% do design é definido pela loja.
**Para integrar no modelo Passthru o desenvolvedor deverá atentar-se para os parâmetros
extras especificados na Tabela 2.
Telefone: (21) 2111-4700 / (11) 3320.9050
Página 9 de 41
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.
Telefone: (21) 2111-4700 / (11) 3320.9050
Página 10 de 41
ATENÇÃO!
A1 - O uso de recursos frame e iframe na chamada às URLs do sistema Pagador NÃO é
suportado, pois esta prática causa interferências no funcionamento das páginas para
determinadas configurações/versões de browsers devido à perda da sessão.
A2 - Não será fornecido suporte a linguagens de programação, códigos fonte ou qualquer
fragmento destes, internos ao desenvolvimento de sua integração, mesmo que fornecidos ou
citados previamente.
A3 - Conforme já mencionado, a conciliação de boletos automática só ocorre através de um
convênio entre o banco, o estabelecimento e a Braspag. Sem este convênio o sistema não
identificará o pagamento dos boletos. Informe-se com a Área de Relacionamento com o
Cliente. É extremamente importante que o estabelecimento exija do seu gerente do banco
que apenas os pagamentos compensados sejam enviados nos arquivos de confirmação de
pagamento. A Braspag não se responsabiliza por informações de pagamentos não
compensados pelo banco. Tentaremos avisar sempre que possível quando um pagamento
confirmado não esteja compensado, para que uma conciliação manual seja feita. Mas a
Braspag NÃO GARANTE A COMPENSAÇÃO DOS MESMOS.
7. PASSOS TÉCNICOS
Telefone: (21) 2111-4700 / (11) 3320.9050
Página 11 de 41
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).
ATENÇÃO! É de extrema importância que a URL de Mudança de Status (passo 6)
somente aceite o POST proveniente dos IPs informados pela Braspag (solicite a lista de IPs a
Área de Relacionamento com Cliente). Desta forma o sistema garantirá o não recebimento
de um POST forjado (fraudulento), garantindo a segurança na transação junto com a
utilização da Criptografia (Anexo 1).
Observação: no caso em que o meio de pagamento escolhido pelo comprador é Boleto
Bancário, os passos 2), 3) e 4) são substituídos por: “Servidor da Braspag gera boleto e exibe
na tela para o comprador para que o boleto possa ser impresso e pago pelo cliente da loja.”
Telefone: (21) 2111-4700 / (11) 3320.9050
Página 12 de 41
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
Id_Loja
VENDAID
Tamanho
Obrigatório
Min
Max
?
Descrição
Identificador único da loja
Número do
VALOR
Valor total do pedido em centavos
(ex.: R$1,00 = 100)
NOME
Nome do Comprador
CPF
RAZAO_PJ
empresa
(Se
38
Sim
1
50
Sim
Sim
CPF do Comprador (se pessoa física)
Nome da
jurídica)
38
pessoa
1
255
Sim
11
14
Sim
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
COMPLEMENTO
Número do endereço do Comprador
Não
Complemento
Comprador
Não
do
endereço
do
BAIRRO
Bairro do Comprador
1
255
Não
CIDADE
Cidade do Comprador
1
255
Não
CEP do
8
9
Não
Estado (UF) do Comprador
2
2
Não
PAIS
País do Comprador
1
255
Não
NASC
Data nascimento do
(formato: dd/mm/aaaa
10
10
Não
1
1
Não
CEP
ESTADO
ESTCIVIL
Comprador
Estado civil do Comprador (Solteiro
= S; Casado = C;
Telefone: (21) 2111-4700 / (11) 3320.9050
Página 13 de 41
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)
FONE
Número do telefone do Comprador
(para Oi Paggo, enviar Celular com
DDD neste campo).
1
64
Número do fax do Comprador
1
64
Não
E-mail do comprador
1
255
Não
Logradouro do endereço de entrega
(ex: Rua, Avenida,
Estada...)
1
255
Não
Endereço de entrega
1
255
Não
FAX
EMAIL
LOGRADOURO_D
ENDERECO_D
NUMERO_D
COMPLEMENTO_D
2
Número do endereço de entrega
Complemento
entrega
do
endereço
Apenas para
Cielo
pagamento
com Celular
Para Mobile e
Cielo
pagamento
com celular
Não
de
Não
BAIRRO_D
Bairro de entrega
1
255
Não
CIDADE_D
Cidade de Entrega
1
255
Não
CEP de entrega
8
9
Não
Estado de entrega (UF)
2
2
Não
Pais de entrega
1
255
Não
TRANSACTIONTYPE –
Novo!
Indica o tipo de transação (Tabela 4)
1
1
Sim
TRANSACTIONCURRE
NCY – Novo!
Indica a moeda da transação
(ISO 4217)
3
3
Sim
TRANSACTIONCOUNT
RY – Novo!
Indica o pais da transação
(ISO 3166-1 Alfa-3)
Identificador
do
pedido
criado
internamente. Se este campo já
estiver preenchido, significa que a
transação já passou pela Braspag e
deseja-se agregar mais transações
ao mesmo pedido
3
3
Sim
CEP_D
ESTADO_D
PAIS_D
BRASPAGORDERID –
Novo!
LANGUAGE – Novo!
Idioma de exibição das páginas de
pagamento. (Tabela 3)
Telefone: (21) 2111-4700 / (11) 3320.9050
Não
GUID
5
5
Página 14 de 41
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
Exemplo de POST Index enviado no Passo 1
<form name="form1" method="post"
action="https://www.pagador.com.br/pagador/index.asp">
Id_Loja
VendaId
Valor
Nome
CPF
<input type="hidden" name="Id_Loja" value=""><br>
<input type="text" name="VendaId" value=""><br>
<input type="text" name="Valor" value=""><br>
<input type="text" name="Nome" value=""><br>
<input type="text" name="Cpf" value=""><br>
<input type= "submit">
Exemplo de POST Index Criptografado enviado no Passo 1
action="https://www.pagador.com.br/pagador/index.asp">
Id_Loja
Crypt
<input type="hidden" name="crypt" value=""><br>
IMPORTANTE:
A tripa a ser enviada deve conter no mínimo os parâmetros obrigatórios:
</form>
VENDAID, VALOR, NOME/RAZÃO_PJ e CPF/CNPJ.
Telefone: (21) 2111-4700 / (11) 3320.9050
Página 15 de 41
 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
Tamanho
Min
Max
Descrição
Id_Loja
Identificador único da loja
VENDAID
Número do pedido
VALOR
Valor total do pedido em centavos
(ex.: R$1,00 = 100)
NOME
Nome do Comprador
CPF
CPF do Comprador (se pessoa física)
CODPAGAMENTO
PARCELAS
TIPOPARCELADO
Identificação
da
forma
de
pagamento (Tabela 8)
número de parcelas em que o valor
total será
dividido (padrão = 1)
Cielo Nova Plataforma:
Á vista = 0
Parcelado loja, sem juros=1
Parcelado emissor, com juros =2
Demais Adquirentes:
Á vista =0
Parcelado loja, sem juros=0
Parcelado emissor, com juros =1
empresa
pessoa
38
38
Sim
1
50
Sim
Sim
1
255
Sim
11
14
Sim
2
3
Sim
1
2
Sim
1
1
Sim
1
255
Sim
RAZAO_PJ
Nome da
jurídica)
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
Telefone: (21) 2111-4700 / (11) 3320.9050
(Se
Obrigatório
Página 16 de 41
Não
COMPLEMENTO
Complemento
Comprador
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
(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
FONE
Número do telefone do Comprador
(para Oi Paggo, enviar Celular com
DDD neste campo).
1
64
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
COMPLEMENTO_D
Complemento
entrega
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
Telefone: (21) 2111-4700 / (11) 3320.9050
do
do
endereço
do
Comprador
endereço
Não
Apenas para
Cielo
pagamento
com Celular
Para Mobile e
Cielo
pagamento
com Celular
Não
de
Não
Página 17 de 41
ESTADO_D
Estado de entrega (UF)
2
2
Não
PAIS_D
Pais de entrega
1
255
Não
BRASPAGORDERID –
Novo!
CREDITCARDTOKEN –
Novo!
SAVECREDITCARD –
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
Token
do
cartão
de
crédito
armazenado no JustClick
Indicação para salvar ou não o
cartão de crédito para a utilização do
JustClick.
(esse
parâmetro
é
boleano: True or False)
Não
GUI
D
36
36
Não
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
5
5
Não
1
768
Não
LANGUAGE – Novo!
EXTRA
[nome que você deseja
dar ao campo]
Idioma de exibição das páginas de
pagamento. (Tabela 3)
Informação adicional que a loja
deseje associar à transação. Este
parâmetro nunca é retornado, ele
somente pode ser acessado pelo
ambiente
Administrativo
(backoffice). Se enviado parâmetro
com nome “ExtraInfo“, no backoffice
aparecerá “Info”
 URL DINAMICA – deve ser
enviada nesse parâmetro,
podendo conter até 500
caracteres
e
não
obrigatória.
Telefone: (21) 2111-4700 / (11) 3320.9050
Página 18 de 41
Exemplo de POST PASSTHRU enviado no Passo 1
action="https://www.pagador.com.br/pagador/Passthru.asp">
Id_Loja
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>
</form>
Exemplo de POST Passthru Criptografado enviado no Passo 1
action="https://www.pagador.com.br/pagador/passthru.asp">
Id_Loja
Crypt
<input type="hidden" name="crypt" value=""><br>
</form>
IMPORTANTE: A tripa a ser enviada deve conter no mínimo os parâmetros obrigatórios:
VENDAID,
VALOR,
NOME/RAZAO_PJ,
CPF;
CNPJ,
CODPAGAMENTO,
PARCELAS,
TIPOPARCELADO.
Tabela 3 – Idioma da Transação (LANGUAGE–indica o idioma a ser utilizado nas páginas de
pagamento).
Cód
Idioma de Apresentação
pt-BR
Português (Brasil)
en-US
Inglês (Americano)
Es-ES
Espanhol
Telefone: (21) 2111-4700 / (11) 3320.9050
Página 19 de 41
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*
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
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
FORMAPAGTO
CODPAGAMENTO
Tamanho
Min
Max
Descrição
Meio de pagamento utilizado pelo comprador
1
128
Código da forma de pagamento (Tabela 8)
2
3
1
128
CODRETORNO
Código do erro da transação
operadoras ou pelos bancos.
DESRETORNO
Descrição do erro da transação – descrição da
operadora ou banco (vazio se não houve erros)
0
512
Número do pedido
1
50
Código da autorização do cartão de crédito ou o
código do boleto bancário
1
768
Código da transação (do cartão de crédito)
1
256
Retorno da verificação de endereço feita junto a
administradora de cartão (caso AVS esteja ativado)
1
64
Número de parcelas da transação
1
2
47
54
VENDAID
VALOR
CODAUTORIZACAO
TRANSID
RespostaAVS
PARCELAS
LINHADIGITAVEL
enviado
pelas
Valor do pedido em centavos (R$1,00 = 100)
Linha digitável do boleto
Telefone: (21) 2111-4700 / (11) 3320.9050
Página 20 de 41
LANGUAGE – Novo!
Idioma enviado pela loja (esse campo só retornará
se a loja tiver enviado) (Tabela 3)
BRASPAGORDERID
CREDITCARDTOKEN
– Novo!
5
5
Identificador do pedido criado internamente
36
36
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
ATENÇÃO! O passo
RECOMENDADO pela Braspag.
6
(Resposta
de
Mudança
de
Status)
é
ALTAMENTE
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
Tamanho
Min
Max
Descrição
NumPedido
Status
CODPAGAMENTO
Número do pedido
1
50
Status do Pagamento (Tabela 7)
1
1
Código da forma de pagamento (Tabela 8)
2
3
Tabela 7 – Status do Pagamento
Status
Descrição
0
Pago
1
Autorizado, pendente de captura
2
Não autorizado
Telefone: (21) 2111-4700 / (11) 3320.9050
Página 21 de 41
Quando acessada pelo servidor da Braspag, enviando o POST da Tabela 5, a URL cadastrada
para Retorno de Mudança de Status fornecida pela loja deverá exibir um código informando
que recebeu a mudança de status e a processou com sucesso.
O Código é apenas o seguinte XML:
<status>OK</status>
Se a URL de mudança de status da loja for acessada pelo servidor da Braspag não exibir o
código de confirmação, o servidor da Braspag irá tentar novamente por mais três vezes, a
cada uma hora. Caso o <status>OK</status> ainda não seja exibido, será entendido que
o servidor da loja não responde, e será enviado um 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:
Lê Numpedido, Status e Codpagamento do POST.
Tenta atualizar o status da transação Numpedido no banco de dados da loja para PAGO.
Se conseguiu atualizar normalmente:
Imprime <status>OK</status>
Ou seja, o código fonte da página
<status>OK</status> e nada mais.
indicando
Sucesso
deverá
conter
APENAS
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.
ATENÇÃO! É de extrema importância que a URL de Mudança de Status (passo 6)
somente aceite o POST proveniente dos números IPs informados pela Braspag.
Desta forma o sistema garantirá o não recebimento de um POST forjado (fraudulento),
garantindo a segurança na transação.
Caso a loja utilize criptografia o post de Retorno e de Mudança de Status serão enviados
Criptografados e será necessária a utilização do componente/webservice de criptografia para
recebê-los corretamente (Anexo 1).
Telefone: (21) 2111-4700 / (11) 3320.9050
Página 22 de 41
Tabela 8 – Meios de Pagamento
Códigos
Meios de Pagamento
06
Boleto Bradesco
07
Boleto Caixa Econômica Federal
08
Boleto HSBC
09
Boleto Banco do Brasil
10
Boleto Real ABN AMRO
11
Débito Bradesco (SPS)
12
Itaú Shopline
13
Boleto Citibank
14
Boleto Itaú
15
BBPag
16
RealPague
28
Real FLV
30
Débito Banrisul
31
Débito Unibanco
32
Financiamento BBPag
34
Financiamento Eletrônico Bradesco
35
Paypal Express Checkout
92
Débito HSBC
111
SafetyPay
123
Cielo Visa Electron
124
Boleto Santander
500
Cielo VISA
501
Cielo MASTERCARD
502
Cielo AMEX
503
Cielo DINERS
504
Cielo ELO
505
Banorte VISA
Telefone: (21) 2111-4700 / (11) 3320.9050
Página 23 de 41
506
Banorte MASTERCARD
507
Banorte DINERS
508
Banorte AMEX
509
Redecard Webservice VISA
510
Redecard Webservice MASTERCARD
511
Redecard Webservice DINERS
512
PagosOnLine VISA
513
PagosOnLine MASTERCARD
514
PagosOnLine AMEX
515
PagosOnLine DINERS
516
Payvision VISA
517
Payvision MASTERCARD
518
Payvision DINERS
519
Payvision AMEX
520
Banorte Cargos Automaticos VISA
521
Banorte Cargos Automaticos MASTERCARD
522
Banorte Cargos Automaticos DINERS
523
AMEX 2P
524
SITEF VISA
525
SITEF MASTERCARD
526
SITEF AMEX
527
DITEF DINERS
528
SITEF HIPERCARD
529
SITEF LEADER
530
SITEF AURA
531
SITEF SANTANDER VISA
532
SITEF SANTANDER MASTERCARD
535
SUB1 – VISA
536
SUB1 – MASTERCARD
Telefone: (21) 2111-4700 / (11) 3320.9050
Página 24 de 41
537
SUB1 - AMEX
538
SUB1 – DINERS
539
SITEF SONDA
540
SUB1 – NARANJA
541
SUB1 – NEVADA
542
SUB1 – CABAL
543
Cielo DISCOVER
544
Cielo JCB
545
Cielo AURA
546
Cartão Presente Alelo
547
Cielo Pagamento por Celular – Modalidade Pós Pago
548
Redecard Hipercard
549
Cielo Pagamento por Celular – Modalidade Pré Pago
550
CredSystem
551
Boleto Caixa - SIGCB
552
Cielo Mastercard Débito
995
SIMULADO CAPTURA AUTOMÁTICA USD
996
SIMULADO CAPTURA AUTOMÁTICA EUR
997
Simulado
8. HOMOLOGAÇÃO DOS MEIOS DE PAGAMENTO E TESTES
Cada meio de pagamento tem suas respectivas regras para homologação. Para tornar o
processo de homologação mais ágil, relacionamos todos os requisitos de cada um dos meios
para que o processo de homologação e a loja possa entrar no ar mais rapidamente. Qualquer
um dos meios de pagamento pode alterar a qualquer hora as exigências para a homologação,
sem aviso prévio, e este manual não necessariamente irá acompanhar estas mudanças em
tempo real.
Requisitos para homologação:
As operadoras 1 - Cielo e 2 - Pagamento Fácil Bradesco (veja abaixo) exigem que as seguintes
informações sejam mostradas ao comprador (cliente da loja) após a transação (no Passo 5):
1. Cielo
Telefone: (21) 2111-4700 / (11) 3320.9050
Página 25 de 41
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
09649KSDO01899ID
I88S710ALGNDI875
OK99008877GG6FTS
0987HH658910J56D
0L9K8J7H6G5F4D3S
94KA84LP84JF8209
P01Q9OW23E4R9OI8
Z12X3CV6B78N9M09
019283IDM95JD86DE
ODKU876309OISJH3
859OOK0192873JSH7
JD873JS8J20KSH74JF
JD8J398O5KDF8J39D
JD739JD7834JDF9H2
JDYJ28DH38YHD832
b)
c)
d)
e)
O Bradesco também exige que seja mostrado um telefone da loja para contato.
Deve constar a data e hora da compra.
Deve constar o prazo para pagamento, assim: “Prazo para pagamento: 1 dia”.
O prazo de entrega deve estar explicito. No caso de serviço, prazo para liberação do
serviço.
f) No rodapé deve constar a frase "Qualquer dúvida quanto a qualidade e entrega deste(s)
produto(s)/serviço, ligar para o telefone acima".
TESTES
As lojas de homologação podem ser criadas com as seguintes opções de pagamento: Cielo
Visa (71), Cielo Mastercard (120), Amex (18), Débito Bradesco (11) e Boleto Bancário ABN
AMRO(10).
É necessário informar à equipe de implementação, a afiliação teste fornecida pelas
Adquirentes.
Cada opção de pagamento tem suas características. Para efetuar testes da melhor forma
possível, atenção às características abaixo.
Observação Importante sobre os Cartões de Teste
Os números de cartões de teste abaixo apresentados não são de fato “cartões” mas apenas
sequências de números que passam no teste de validade de cartão de crédito, assim sendo,
eles são tratados pelos sistemas dos adquirentes como cartões inválidos, portanto em
ambiente de produção nunca poderão ter retorno positivo, normalmente retornando erro de
“cartão inválido” ou “transação negada”.
Em ambiente de homologação é possível um retorno positívo, no entanto não é garantido.
Sendo assim, o objetivo de testar com “cartões de teste” é apenas verificar o fluxo de
informação, verificar que o sistema da loja consegue enviar informação corretamente para o
sistema Pagador, e se consegue também receber corretamente as informações de retorno.
Depois de testar com “cartões de teste”, podem também ser feitos testes com cartão de
crédito real, mas é preciso tomar cuidado, pois o valor do teste será descontado do cartão,
então recomenda-se fazer testes com valores baixos.
Telefone: (21) 2111-4700 / (11) 3320.9050
Página 26 de 41
 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.
Telefone: (21) 2111-4700 / (11) 3320.9050
Página 27 de 41
9. SUPORTE BRASPAG
Ver anexo 7 abaixo.
ANEXO 1 - USO DO COMPONENTE DE CRIPTOGRAFIA
ATENÇÃO!
O Uso do Componente
RECOMENDADO para integração por POST.
de
Criptografia
é
ALTAMENTE
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ãoWindows (tais como Linux, Unix, etc)
 Componente Java de Criptografia. É um componente de criptografia feito em Java. Tem
como vantagem a possibilidade de ser utilizado em qualquer ambiente, Linux, Unix, etc,
mas tem uma maior complexidade de instalação e utilização.
 Webservice de Criptografia. É a opção ideal para uso de criptografia, além de
geralmente ser a mais fácil de ser implementada, em qualquer ambiente. A loja utiliza o
webservice da Braspag, enviando pra ele os dados a serem criptografados ou
decriptografados, e recebe a resposta correspondente. A conexão é feita de forma
segura, com SSL (assim como todos os webservices da Braspag), e o webservice
somente aceita conexões de IPs explicitamente permitidos pela Loja. Solicite manual do
webservice de criptografia ao RC, se necessário.
Observação: mais de uma forma de criptografia podem ser utilizadas simultaneamente.
Solicite os arquivos de exemplo para a sua linguagem de programação.
Componente DLL (ASP e PHP)
É uma biblioteca DLL para que sejam utilizados os métodos abaixo a fim de criptografar os
campos a serem enviados no post.
Para instalar a biblioteca, você deverá salvar o arquivo localmente, clicar em Iniciar, Executar
e digitar: “regsvr32 C:\[DIRETORIO_DA_BIBLIOTECA]\BraspagCOM.dll”
Telefone: (21) 2111-4700 / (11) 3320.9050
Página 28 de 41
Tabela 9
Método
bool setField(const char* field,
const har* value)
char* getEncrypted()
bool setEncrypted(const char*
cipher)
char* getField(const char* field)
void clearFields()
Função
Adiciona um
criptografada
par
de
campo
e
valor
à
string
Criptografa todos os campos já adicionados pelo
setField e retorna a string criptografada resultante.
Recebe como parâmetro a string criptografada e
decriptografa la, deixando os campos e valores
contidos nela prontos para erem extraidos pelo
getField
Retorna
o
valor
do
campo
passado
como
parâmetro,
se
este stava
contido na string
criptografada e se já foi decriptografada elo
setEncrypted.
Limpa os campos
Exemplo de uso:
Tabela 10
Criptografar
Set
crypt =
erver.CreateObject("Braspag.Encryption")
crypt.setField("valor", "100");
crypt.setField("vendaid", "10001");
string_criptografada = crypt.getEncrypted()
Decriptografar
Set
crypt =
erver.CreateObject("Braspag.Encryption")
crypt.setEncrypted(string_criptografada);
valor = getField("valor");
vendaid = getField("vendaid");
Post:
<input type="hidden" name="Id_Loja" value="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)
Telefone: (21) 2111-4700 / (11) 3320.9050
Página 29 de 41
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="000000000000-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");
Telefone: (21) 2111-4700 / (11) 3320.9050
Página 30 de 41
ANEXO 2 – FLUXOS DE INTEGRAÇÃO VIA POST PARA CARTÕES DE CRÉDITO
Telefone: (21) 2111-4700 / (11) 3320.9050
Página 31 de 41
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-0000000000000000}
38
Sim
orderId
Número do Pedido
20
Sim
Máx.
Tipo
 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
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
Valor
Valor do pedido
Telefone: (21) 2111-4700 / (11) 3320.9050
int
float
Página 32 de 41
DataCancelamento
DataPagamento
DataPedido
Data e hora do cancelamento do
pedido, caso tenha sido cancelado –
formato mm/dd/aaaa hh:mm:ss tt
(tt = AM/PM)
Data e hora do pagamento do
pedido, caso tenha sido pago –
formato mm/dd/aaaa hh:mm:ss tt
(tt = AM/PM)
Data e hora do pedido - formato
mm/dd/aaaa hh:mm:ss tt (tt =
AM/PM)
string
string
string
TransId
Número da transação no adquirente
string
BraspagTid
Identificador único da transação na
Braspag
string
Tabela 11.2 – Possíveis status de retorno do método GetDadosPedido
Status
Cód.
Descrição
O pedido foi enviado para o adquirente, mas ainda não
foi finalizado.
O pedido foi finalizado – caso o mesmo tenha sido
autorizado, o campo CodigoErro será vazio. Se foi
recusado, o campo CodigoErro virá preenchido com o
código retornado pelo adquirente
Iniciado
1
Finalizado
2
Pago
3
O pedido foi autorizado e confirmado
Cancelado
4
O pedido foi cancelado
ATENÇÃO!
status 3 (Pago).
O pedido poderá ser tratado como pago apenas quando for retornado
Telefone: (21) 2111-4700 / (11) 3320.9050
Página 33 de 41
 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-0000000000000000}
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
a
Obrigatório?
-
Bool
Autenticada
Se o cartão foi
autenticação ou não.
NumeroComprovante
Número do comprovante do pedido.
-
String
Emissor
Nome do portador do cartão.
-
String
NumeroAutenticacao
Identificação de autenticação do
número do cartão no banco emissor.
-
String
NumeroAutorizacao
Código de Autorização.
-
String
NumeroCartao
Número do Cartão mascarado.
-
String
NumeroTransacao
Número da Transação.
-
String
Telefone: (21) 2111-4700 / (11) 3320.9050
submetido
Máx.
Página 34 de 41
 Método GetDadosComprador
Este método retorna todos os dados relativos ao comprador.
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-0000000000000000}
38
Sim
Número do Pedido
20
Sim
orderId
 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
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
(CPF
Telefone: (21) 2111-4700 / (11) 3320.9050
e
CNPJ)
do
Página 35 de 41
 Método GetDadosExtras
Este método retorna todos os campos extras relativos ao pedido.
Tabela 14 – Parâmetros recebidos pelo método GetDadosExtras
Parâmetro
Descrição
Máx.
Obrigatório
merchantId
pela Braspag.
{00000000-0000-0000-0000000000000000}
38
Sim
orderId
Número do Pedido
20
Sim
Máx.
Tipo
 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
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.
Tabela 15 – Parâmetros recebidos pelo método GetDadosBoleto
Parâmetro
Descrição
Máx.
Obrigatório
merchantId
pela Braspag.
{00000000-0000-0000-0000000000000000}
38
Sim
orderId
Número do Pedido
20
Sim
Telefone: (21) 2111-4700 / (11) 3320.9050
Página 36 de 41
 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
OrderID
emitido
para
pagamento
Tipo
-
String
-
String
NumeroDocumento
Igual ao
cliente.
Instrucoes
Informações
boleto.
Sacado
Nome do Favorecido.
-
String
NossoNumero
Identificador do boleto no banco.
-
String
LinhaDigitavel
É a representação
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
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
Telefone: (21) 2111-4700 / (11) 3320.9050
numérica
pelo
Máx.
do
do
responsável
Página 37 de 41
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, formapassthru.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.
Telefone: (21) 2111-4700 / (11) 3320.9050
Página 38 de 41
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.
Telefone: (21) 2111-4700 / (11) 3320.9050
Página 39 de 41
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
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.
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).
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)
Qualquer problema de
disponibilidade em
ambiente de produção que
impossibilite o sistema de
receber e autorizar transações
com todos os meios de
pagamento.
Tempo máximo
de resposta
Exemplos
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?
Severidade 3
(moderada)
24 horas útil
Não recebi o 2º. Post?
Poderia habilitar a
chave de criptografia?
Severidade 2
(sério)
2 horas
Lentidão transacional
Severidade 1
(critico)
30 minutos
Aparentemente o
servidor está fora do
ar.
Severidade
Telefone: (21) 2111-4700 / (11) 3320.9050
Página 40 de 41
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.
Telefone: (21) 2111-4700 / (11) 3320.9050
Página 41 de 41

plataforma pagador integração post

Transcrição

Documentos relacionados

LAVRAS NOVAS - Mapa dos bens inventariados

tabloide dia das mães final.cdr

RE/MAX Portugal

Regras para se retirar produtos em loja

Aperfeiçoamento em Máquinas e Equipamentos de Proteção das

GrandVision by Fototica

1ª série - Colégio Mazzarello

amarilis_nov a marco

Sem baseado - Louco por Viagens

shopping