Você está na página 1de 15

Manual do desenvolvedor

Manual do desenvolvedor Braspag

Telefone: (21) 2111-4700 Email: braspag@braspag.com.br http://www.braspag.com.br

Página 1 de 15

.......................br http://www............................................................................................................................ Itaú...................................5 PASSOS TÉCNICOS – PASSOS 1 e 2................................ 10 Tabela 7 – Dados a serem enviados para Pagador Recorrente.........10 HOMOLOGAÇÃO...................................................................................................................................................................................................................................4 Atenção! (Informações Importantes)..................INSTRUÇÕES PARA O REAL FINANCIAMENTO – FLV.6 PARÂMETROS A SEREM ENVIADOS................................................................15 PARAMETROS A SEREM RECEBIDOS PELA LOJA.............................................................br Página 2 de 15 ....8 Tabela 2 – Parametros a serem enviados em modo PASSTHRU.................................................................................................................................... 15 TESTES.............................................................................8 Tabela 3 – Códigos de meios de Pagamento...............................................11 2.................................................. 15 DADOS A SEREM ENVIADOS PELA LOJA............................com............................................14 APENDICE A .................................................................................Visanet................................................11 1..............................................braspag.......................................MasterCard... 11 TESTES...........................................3 QUAL MODELO DE INTEGRAÇÃO USAR?...................... 10 Tabela 5 – Parametros recebidos pela loja na mudança do Status de Pagamento........ 11 INTERFACES WEBSERVICE....................................... Diners.......................................................................................... Real.......................................................... American Express..................... 10 INTEGRAÇÃO COM O PAGADOR RECORRENTE................... 15 Telefone: (21) 2111-4700 Email: braspag@braspag................................................8 PARAMETROS A SEREM RECEBIDOS PELA LOJA......................7 MODO PASSTHRU.......................................................Pagamento Fácil Bradesco........................ BB.............. 7 Tabela 1 – Parametros a serem enviados....................11 3...................................................................................com..........9 Tabela 4 – Parametros a serem recebidos pela loja...........Manual do desenvolvedor Índice RESUMO DO PROCESSO........................... 9 PASSOS TÉCNICOS – PASSO 3...............12 DESCRIÇÃO DE ARQUIVOS DE EXEMPLO..............9 PARAMETROS A SEREM RECEBIDOS PELA LOJA...............

• Essa funcionalidade tem um manual específico que poderá ser solicitado. a loja não recebeu a confirmação da transação. para tal deve-se desenvolver uma página capaz de receber os dados da tabela 4. c) Interfaces (WebService) para captura dos dados das transações a qualquer momento. Recepção do manual técnico e ID_LOJA para homologação. i. 3. para o PAGADOR no momento do pagamento. GetDadosComprador Este método retorna todos GetDadosEntrega Este método retorna todos GetDadosPedido Este método retorna todos GetDadosCartao Este método retorna todos na compra GetDadosExtras Este método retorna todos os dados relativos ao comprador os dados relativos à entrega os dados relativos ao pedido os dados relativos ao cartão de crédito utilizado os campos extras relativos ao pedido Observação: O uso dos serviços adicionais A e B é altamente recomendado. b) Componente de criptografia para dar maior segurança ao trânsito das informações. por alguma falha de comunicação. Os parâmetros do POST estão especificados na tabela 1. Esse POST é enviado a cada 5 minutos e é muito útil nos casos onde. ii.com. são eles: a) POST de mudança de status de pagamento Usado para avisar quando foi conciliado um boleto e confirmar as transações. v. iii.Manual do desenvolvedor RESUMO DO PROCESSO O processo de integração com o PAGADOR é muito simples. Informe-se com seu gerente comercial. (URL de Retorno) Além das autorizações em tempo real a BrasPag oferece no PAGADOR alguns serviços adicionais. 4. 2. Pode ser resumido nos passos a seguir: 1. Sem este convênio o sistema não identificará o pagamento dos boletos.br Página 3 de 15 . iv. Telefone: (21) 2111-4700 Email: braspag@braspag. Preparar a loja virtual para enviar a transação. O parâmetro ID_LOJA é um identificador único da loja.braspag.com.br http://www. por POST(Post de Envio). Atenção: A conciliação de boletos automática só ocorre através de um convênio com o banco e a Braspag. Nesse momento você já poderá realizar transações com os meios de pagamento cadastrados para sua loja. Após realizar as transações o ideal é que a loja se prepare para receber o retorno em tempo real das transações autorizadas.

Imagem do header (onde está o logo da BrasPag) 2. Imagem de footer 3. No modelo de integração normal o usuário escolhe o meio de pagamento no servidor da BrasPag.com.br Página 4 de 15 .braspag.br http://www. o passthru e o normal. Telefone: (21) 2111-4700 Email: braspag@braspag. Tamanho e tipo das fontes 5.Manual do desenvolvedor QUAL MODELO DE INTEGRAÇÃO USAR? A Braspag oferece dois modelos de integração. vide imagem abaixo: No modelo normal é possível customizar os seguintes parâmetros: 1. Cor do fundo da tela e da barra de título “Selecione o meio de pagamento desejado” 4.com. Cor das fontes.

mesmo que fornecidos ou citados previamente.br Página 5 de 15 . Sem este convênio o sistema não identificará o pagamento dos boletos. A2 . vide imagem abaixo: Nesse modelo há maior flexibilidade com relação a lay-out uma vez que 100% do design é definido pelo desenvolvedor da loja.com. Esta prática causará interferências no funcionamento das páginas para determinadas configurações/versões de browsers devido à perda da sessão. A3 .Manual do desenvolvedor Já no Modelo de integração pass-thru o usuário escolhe a forma de pagamento no próprio site da loja.braspag. códigos fonte ou qualquer fragmento destes. Telefone: (21) 2111-4700 Email: braspag@braspag.A conciliação de boletos automática só ocorre através de um convênio com o banco e a Braspag. Atenção! A1 .O uso de frames ou iframes na chamada às urls do Pagador é extremamente NÃO recomendado.com. As instruções de como optar pelo modelo passthru ou normal são enviadas junto com o ID_LOJA. Para integrar no modelo passthru o desenvolvedor deverá atentar para os parâmetros extras especificados na tabela 2. internos ao desenvolvimento de sua integração.br http://www. Informe-se com seu gerente comercial.Não será fornecido suporte a linguagens de programação.

valor.br http://www. POST dado na URL da loja cadastrada em nosso banco de dados. nome do comprador e outros campos dependendo do modelo utilizado (ver abaixo) A URL destino do POST(Post de Envio) será enviada junto com ID_LOJA Loja Pagador Passo 2 . Os dados do POST estão na tabela 4. (URL de Retorno) Telefone: (21) 2111-4700 Email: braspag@braspag. o número do pedido.br Página 6 de 15 .com.Manual do desenvolvedor PASSOS TÉCNICOS – PASSOS 1 e 2 Passo 1 .braspag.Braspag envia um RETORNO via POST É a resposta em tempo-real da transação realizada.Loja envia um POST (Post de Envio) para Braspag: Com a chave de identificação da loja (ID_LOJA).com.

org/iso/en/prodsservices/popstds/currencycodeslist. AUD..br Página 7 de 15 . EUR) http://www.braspag.html Não* Não Telefone: (21) 2111-4700 Email: braspag@braspag.Manual do desenvolvedor PARÂMETROS A SEREM ENVIADOS(Post de Envio) O POST(Post de Envio) que será enviado à Braspag deve conter os seguintes parâmetros de acordo com o modelo escolhido. Moeda utilizada na venda seguindo o ISO 4217 (USD. Número do pedido valor total do pedido sem decimais (ex. Obs..00 = 100) Nome do comprador número do CPF (se pessoa física) Nome da empresa (Se pessoa jurídica) número do CNPJ (se empresa) logradouro do comprador (ex: Rua. Avenida. Outro = O) sexo do comprador Profissão comprador número do telefone do comprador número do fax do comprador e-mail do comprador logradouro do endereço de entrega (ex: Rua..com. Estada.: No caso de carrinho de compras utilizar a descrição do produto de maior valor. Divorciado = D. CAD. Tabela 1 – Parametros a serem enviados CAMPO ID_LOJA VENDAID VALOR NOME CPF RAZAO_PJ CNPJ LOGRADOURO ENDERECO NUMERO COMPLEMENTO BAIRRO CIDADE CEP ESTADO PAIS NASC ESTCIVIL SEXO PROF FONE FAX EMAIL LOGRADOURO_D ENDERECO_D NUMERO_D COMPLEMENTO_D BAIRRO_D CIDADE_D CEP_D ESTADO_D PAIS_D EXTRAFINANCIAMENTO DESCRIÇÃO Identificação da loja OBRIGATÓRIO Sim Sim Sim Sim Não Não Não Não Não Não Não Não Não Não Não Não Não Não Não Não Não Não Não Não Não Não Não Não Não Não Não Não Não MOEDA (Campo utilizado apenas no meio de pagamento PayPal ) EXTRA[nome que você deseja dar ao campo] Informação adicional que queira associar a ex. Estrada.iso.: ExtraItem transação. GBP. Avenida. Casado = C.) endereço do comprador número do endereço do comprador complemento do endereço do comprador Bairro do comprador Cidade do endereço do comprador CEP Estado País Data de nascimento do comprador estado civil do comprador (Solteiro = S.) número do endereço de entrega Número do endereço de entrega complemento do endereço de entrega Bairro de entrega Cidade de entrega CEP de entrega estado de entrega pais de entrega Descrição do objeto financiado. Viúvo = V..: R$1.com. Aparecerá no admin: Item * Obrigatório para o meio de pagamento PayPal. JPY.br http://www.

com.Manual do desenvolvedor MODO PASSTHRU Os campos que deverão ser passados para o modelo pass-thru são os campos do modelo de integração escolhido (básico.br Página 8 de 15 .VPOS Visa – TEF MasterCard – TEF Diners – TEF Amex – TEF Boleto Unibanco Real FLV Hipercard – TEF Débito Banrisul Débito Unibanco Financiamento BBPag PayPal Visa MOSET Aura Boleto BRB Crédito Consignado Código 20 21 22 23 24 25 26 28 29 30 31 32 35 36 37 38 39 Telefone: (21) 2111-4700 Email: braspag@braspag.VBV 01 Visa Electron 02 Mastercard . Sem juros enviar “0” OBRIGATÓRIO Sim Não CODPAGAMENTO deverá ser um dos seguintes códigos: Tabela 3 – Códigos de meios de Pagamento Meios de Pagamento Código Visa Crédito .Komerci 03 Diners .Komerci 04 American Express – 3 Party 05 Boleto Bradesco 06 Boleto Caixa 07 Boleto HSBC 08 Boleto Banco do Brasil 09 Boleto Real 10 Débito Bradesco (SPS) 11 Débito Itaú (Shopline) 12 Boleto Citibank 13 Boleto Itaú 14 Comercio Eletrônico – Banco do 15 Brasil RealPague 16 Amex 2 party 18 Meios de Pagamento WebService RedeCard Amex .br http://www. simples ou completo) além de: Tabela 2 – Parametros a serem enviados em modo PASSTHRU CAMPO DESCRIÇÃO CODPAGAMENTO Identificação da forma de pagamento (tabela 3) PARCELAS número de parcelas em que o valor total será dividido (padrão = 1) TIPOPARCELADO Com juros enviar “1”.com.braspag.

br Página 9 de 15 .braspag.com. A loja deverá responder um XML informando que recebeu o POST (ver abaixo) Loja Pagador Telefone: (21) 2111-4700 Email: braspag@braspag. para outros casos.Braspag envia um POST para loja: POST de mudança de status de pagamento O POST será enviado a uma URL cadastrada no nosso banco de dados. Os dados desse POST estão na tabela 5. (URL de Mudança de Status).Manual do desenvolvedor PARAMETROS A SEREM RECEBIDOS PELA LOJA (URL de Retorno) Após a conclusão do pagamento. ver tabela de erros) descrição do erro da transação número do pedido valor do pedido sem decimais (R$1.com. a loja receberá um POST na URL cadastrada em nosso banco de dados(URL de Retorno) com os seguintes parâmetros: Tabela 4 – Parametros a serem recebidos pela loja DESCRIÇÃO CAMPO Meio de pagamento utilizado pelo comprador FORMAPAGTO Código da forma de pagamento (Vide tabela 3) CODPAGAMENTO CODRETORNO DESRETORNO VENDAID VALOR CODAUTORIZACAO TRANSID RespostaAVS PARCELAS LINHADIGITAVEL código do erro da transação (vazio se não ocorreram erros.br http://www.00 = 100) código da autorização do cartão de crédito ou o código do boleto bancário código da transação (do cartão de crédito) Retorno da verificação de endereço feita junto a administradora de cartão Numero de parcelas da transação Linha digitável do boleto PASSOS TÉCNICOS – PASSO 3 Passo 3 .(Opcional) .

Os parâmetros que a loja receberá serão: Tabela 5 – Parametros recebidos pela loja na mudança do Status de Pagamento CAMPO DESCRIÇÃO NumPedido Numero do pedido Status Status do Pagamento CODPAGAMENTO Código da forma de pagamento (Vide tabela 3) Status será um dos seguintes códigos: Tabela 6 Status Descrição 0 pago A loja deverá responder um XML dizendo que recebeu o status. Não recebendo <status>OK</status> como resposta. a loja receberá outro POST na URL cadastrada (URL de Mudança de Status) para confirmação do pagamento. O formato do XML deverá ser: <status>OK</status> Atenção: Havendo uma url cadastrada para POST mudança de status de pagamento e caso a loja não envie como resposta <status>OK</status>.Manual do desenvolvedor PARAMETROS A SEREM RECEBIDOS PELA LOJA (URL de Mudança de Status) Quando o status de pagamento do pedido mudar. caso contrário. De quantos em quanto meses haverá débito Nome do portador do cartão Numero do cartão de crédito Validade do cartão Código de segurança do cartão OBRIGATÓRIO Sim Sim Sim Não Não Não Não * O POST de integração com o PAGADOR RECORRENTE dever ser dado na URL passthruR. INTEGRAÇÃO COM O PAGADOR RECORRENTE Para que uma transação do PAGADOR RECORRENTE tenha a sua primeira resposta em tempo real basta que você envie as transações via POST seguindo os dados das Tabelas 1 e 2. enviando um POST a cada uma hora.br http://www. a Braspag tentará mais 2 vezes. Pode ser data atual.asp Telefone: (21) 2111-4700 Email: braspag@braspag.com. além dos campos: Tabela 7 – Dados a serem enviados para Pagador Recorrente CAMPO DESCRIÇÃO DATAINICIO DATAFIM INTERVALORECORRENCIA NOMEPORTADOR NUMEROCARTAO VALIDADE CODIGOSEGURANCA Data programada para a primeira cobrança.com.br Página 10 de 15 . o servidor da Braspag fará mais 3 tentativas. Data programada para última cobrança.braspag. um e-mail de alerta será enviado ao administrador da loja.

Cada opção de pagamento tem suas características. Diners.com. atenção as características abaixo: Telefone: (21) 2111-4700 Email: braspag@braspag. American Express Seguir os pontos acima é suficiente para homologar os meios de pagamento desse item. BB. Requisitos para homologação: 1. TESTES As lojas de homologação são criadas com as seguintes opções de pagamento: – Visa. Amex. prazo para liberação do serviço.com. b) Apenas para VISA. 2. No caso de serviço. Deve ser um texto assim: “Prazo para pagamento: 1 dia”. quando o CODRETORNO enviado pelo PAGADOR for “ ”. e este manual não necessariamente irá acompanhar estas mudanças em tempo real. substituir por 00. Nenhum campo pode ser ocultado. Real. Bradesco e Boleto Bancário. MasterCard.Pagamento Fácil Bradesco a) O código de autorização deve ser exibido da seguinte forma: J34JK20K0AL0L10L 09649KSDO01899ID Z12X3CV6B78N9M09 JD873JS8J20KSH74JF I88S710ALGNDI875 OK99008877GG6FTS 019283IDM95JD86DE JD8J398O5KDF8J39D 0987HH658910J56D 0L9K8J7H6G5F4D3S ODKU876309OISJH3 JD739JD7834JDF9H2 94KA84LP84JF8209 P01Q9OW23E4R9OI8 859OOK0192873JSH7 JDYJ28DH38YHD832 b) O Bradesco também exige que seja mostrado um telefone para contato.braspag. f) No rodapé deve constar a frase "Qualquer dúvida quanto a qualidade e entrega deste(s) produto(s)/serviço. Para efetuar testes da melhor forma possível. 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 seja breve e a loja possa entrar no ar rapidamente. Diners. Itaú. c) Deve constar a data e hora da compra. d) Deve constar o prazo para pagamento. Qualquer um dos meios de pagamento pode alterar a qualquer hora as exigências para a homologação. sem aviso prévio.Manual do desenvolvedor HOMOLOGAÇÃO Cada meio de pagamento tem suas respectivas regras para homologação. e) O prazo de entrega deve estar explicito.MasterCard.Visanet a) Exibir todos os campos do POST retornado pelo PAGADOR. ligar para o telefone acima" 3. Visa Electron.br Página 11 de 15 .br http://www.

Basta escolher a forma de pagamento boleto bancário. Para tal você deve preencher todos os campos com o numero 1. Você deverá testar VISA.Boleto Há como efetuar testes. Para tal você poderá usar um cartão de testes: Nº do cartão: 345678901234564 – Cód de segurança 1234 – validade 08/11 5. GetDadosComprador Dados retornados <DataNascimento>string</DataNascimento> <Email>string</Email> <EstadoCivil>string</EstadoCivil> <Fax>string</Fax> <Identificacao>string</Identificacao> <Nome>string</Nome> <Profissao>string</Profissao> <RazaoSocial>string</RazaoSocial> <Sexo>string</Sexo> <Telefone>string</Telefone> 2.com.br http://www.com.Amex Há como efetuar testes. GetDadosEntrega Dados retornados <DadosEntrega> <Bairro>string</Bairro> <Cep>string</Cep> <Cidade>string</Cidade> <Complemento>string</Complemento> <Endereco>string</Endereco> Telefone: (21) 2111-4700 Email: braspag@braspag. Para tal sugerimos gerar transações de R$ 0.braspag. 3.Manual do desenvolvedor 1. Se VISA CRÉDITO funcionar é sinal de que VISA ELETRON está ok.br Página 12 de 15 . Você poderá testar em ambiente de produção.01.Visa Eletron Não há ambiente de testes.MasterCard e Diners Não há ambiente de testes. 6. 4. Para tal você poderá usar um cartão de testes: Nº do cartão: 4073 0200 0000 0002 – Cód de segurança 123 – validade 08/11 2.Visa Há como efetuar testes. INTERFACES WEBSERVICE Todas são acionadas com apenas dois parâmetros: LOJA (ID_Loja) e numeropedido(numero do pedido enviado no primeiro POST) 1.Pagamento Fácil Bradesco Há como efetuar testes.

Manual do desenvolvedor <Estado>string</Estado> <Logradouro>string<Logradouro/> <Numero>string<Numero/> <Pais>BR</Pais> </DadosEntrega> 3.com.br Página 13 de 15 .com. GetDadosPedido Dados retornados <GetDadosPedidoResult> <DadosPedido>string</DadosPedido> <CodigoAutorizacao>string</CodigoAutorizacao> <CodigoErro>string</CodigoErro> <CodigoPagamento>string</CodigoPagamento> <FormaPagamento>string</FormaPagamento> <MensagemErro>string</MensagemErro> <NumeroParcelas>string</NumeroParcelas> <Status>string</Status> <Valor>string</Valor> <DataPedido>string</DataPedido> <DataCancelamento>string</DataCancelamento> <DataPagamento>string</DataPagamento> <TransId>string</TransId> <DadosPedido>string</DadosPedido> </GetDadosPedidoResult> 4) GetDadosCartão Dados retornados <DadosCartao> <Autenticada>string</Autenticada> <NumeroAutorizacao>string</NumeroAutorizacao> <NumeroCartao>string</NumeroCartao> <NumeroTransacao>string</NumeroTransacao> <RetornoAVS>string</RetornoAVS> <NumeroComprovante>string</NumeroComprovante> <Emissor>string</Emissor> <NumeroAutenticacao>string</NumeroAutenticacao> </DadosCartao> 5) GetDadosExtras Dados retornados <ArrayOfExtra> <Extra> <Campo>string</Campo> <Valor>string</Valor> </Extra> <Extra> <Campo>string</Campo> <Valor>string</Valor> </Extra> <Extra> <Campo>string</Campo> <Valor>string</Valor> </Extra> </ArrayOfExtra> Telefone: (21) 2111-4700 Email: braspag@braspag.br http://www.braspag.

confirmacao.asp O comprador digita seus dados.asp Contém o catálogo dos produtos da loja. recebe.asp index.asp. o comprador será redirecionado para a tela de cadastro. onde escolherá qual a forma de pagamento. formapgto-passthru.asp Este é o arquivo de exemplo para o modo pass-thru. formapgto. número do pedido.asp. o comprador será redirecionado para a tela de cadastro. o comprador será redirecionado para a tela da Braspag. Ao clicar no produto que deseja comprar.asp Esta página informa ao comprador se a compra foi efetuada com sucesso ou se houve algum erro. index-passthru. Ao clicar no produto que deseja comprar.asp O comprador digita seus dados e confirma a compra. recebe.asp. código da autorização e da transação. Ela recebe os dados da compra: forma de pagamento utilizada.br http://www.com. o comprador é redirecionado novamente para a página da loja (página cadastrada em nosso banco de dados).com.asp. o comprador é redirecionado novamente para a página da loja (página cadastrada em nosso banco de dados). você deve olhar os arquivos index.br Página 14 de 15 . Ela recebe o número do pedido e o status de pagamento e retorna um XML dizendo <status>OK</status> Telefone: (21) 2111-4700 Email: braspag@braspag.asp e confirmacao.Manual do desenvolvedor DESCRIÇÃO DE ARQUIVOS DE EXEMPLO Junto com este manual há alguns arquivos na linguagem ASP de exemplo.asp Esta página recebe o POST de confirmação de pagamento e informa à Braspag o recebimento do mesmo. Se sua loja não usa o modo pass-thru. valor. A única diferença entre este arquivo e o index. Após a finalização da compra. se houve algum.asp é a página que será chamada em seguida. Após a finalização da compra. forma-passthru. recebe. Contém o catálogo dos produtos da loja.asp Caso contrário. Após esta tela.braspag.asp e confirmacao. código e descrição do erro. index-passthru. escolhe a forma de pagamento que utilizará e confirma a compra. formapgto.

TESTES 1.Manual do desenvolvedor APENDICE A . Basta entrar com o código de afiliação 4 no área administrativa de homologação .: No caso de carrinho de compras utilizar a descrição do produto de maior valor.TABELA 4 CAMPO CODRETORNO DESCRIÇÃO código do erro da transação (vazio se não ocorreram erros. 1 : CDC Carnê 2 : CDC Depósito 5 : CSC Carnê 6 : CSC Depósito 7 : Leasing 8 : CDC Débito em conta corrente OBRIGATÓRIO Sim Sim PARAMETROS A SEREM RECEBIDOS PELA LOJA Complemento . para outros casos.braspag.ERROS CÓDIGO DESCRIÇÃO BP_997 Proposta em análise (para atualização do status na loja. Obs. necessita da implementação do segundo POST). Telefone: (21) 2111-4700 Email: braspag@braspag.1 . Produto do financiamento / Forma de pagamento.br Página 15 de 15 .INSTRUÇÕES PARA O REAL FINANCIAMENTO – FLV DADOS A SEREM ENVIADOS PELA LOJA Complemento – Tabela 1 CAMPO EXTRAFINANCIAMENTO TIPOFINANCIAMENTO DESCRIÇÃO Descrição do objeto financiado.Real FLV Há como efetuar testes.br http://www. ver tabela de erros) Tabela 4.com.com.