Guia de Integrao para

Transferncia

________________________________________________________________________________

ndice
Captulo 1 ...................................................................................................... 3
Introduo .................................................................................................. 3
Captulo 2 ...................................................................................................... 4
Links de Pagamento ..................................................................................... 4
Captulo 3 ...................................................................................................... 5
Configurando o Gerenciador de Compras ........................................................ 5
Captulo 4 ...................................................................................................... 7
Fluxo de Mensagens Transferncia entre Contas Bradesco .............................. 7
Captulo 5 .................................................................................................... 11
Demonstrao da tela Transferncia entre Contas Bradesco ......................... 11
Captulo 6 .................................................................................................... 12
Dvidas e Homologao.............................................................................. 12

________________________________________________________________________ 2 de 12

Captulo 1
Introduo
As formas de pagamento do Comrcio Eletrnico Bradesco, devem ser integradas por um
desenvolvedor / lojista com conhecimentos em desenvolvimento de sistemas.
Neste guia esto contidas:

Informaes para configurar o gerenciador;

Orientaes para o desenvolvimento das pginas necessrias para o funcionamento do

sistema;

Contatos para o suporte (telefone e email);

Orientaes para a solicitao de homologao do site (obrigatria para a liberao da forma

de pagamento).

IMPORTANTE:

Informamos que somente so homologadas as formas de pagamentos geradas pelo sistema do

Comrcio Eletrnico Bradesco.

O Sistema Comrcio Eletrnico compatvel a qualquer linguagem / plataforma.

________________________________________________________________________ 3 de 12

Captulo 2
Links de Pagamento
O processo de integrao da loja com a Transferncia entre Contas Bradesco simples, no entanto deve
ser feita com muito cuidado para que os parmetros sejam passados corretamente e erros no sejam
criados no processo de pagamento.
Os dados para o pagamento com Transferncia entre Contas Bradesco so passados para o servidor
atravs da resposta fornecida pela pgina DadosCompra.asp (loja de exemplo) ou equivalente.
Para dar incio ao processo de integrao, o desenvolvedor da loja dever inserir o seguinte link na
pgina de seleo de pagamento da loja (metodo_pagto.asp loja de exemplo):
Ambiente de testes:
http://mupteste.comercioeletronico.com.br/sepsTransfer/xxxx/prepara_pagto.asp?merchantid=xxxx&or
derid=zzzz
Ambiente de Produo:
https://mup.comercioeletronico.com.br/sepsTransfer/xxxx/prepara_pagto.asp?merchantid=xxxx&orderi
d=zzzz
Onde: xxxx dever ser substitudo pelo nmero da loja e zzzz dever ser substitudo pelo nmero do
pedido.
IMPORTANTE: Caso a loja esteja utilizando variveis de sesso ou cookies esses dados sero perdidos
no momento em que o comprador clicar neste link de pagamento. A loja poder passar parmetros
extras no link de pagamento, pois os mesmos sero devolvidos em todos os acessos que o servidor SPS
realizar nas pginas da loja.

________________________________________________________________________ 4 de 12

Captulo 3
Configurando o Gerenciador de Compras
Para acessar o gerenciador de compras da loja, entre com a seguinte URL:
http://mupteste.comercioeletronico.com.br/sepsManager/senha.asp?loja=xxxx
Onde xxxx o nmero da sua loja. Para efetuar o login, use o Manager e a Senha enviados por e-mail.
Aps o login, ser apresentada a seguinte tela:

________________________________________________________________________ 5 de 12

Os campos que devero ser preenchidos para a opo de pagamento Transferncia entre Contas
so:
1) Endereo IP da loja: O endereo de IP do servidor que est hospedando a loja (este campo
apenas cadastral).
2) Pgina de confirmao de compra: Esta a URL que ser chamada caso o processo de compra
seja bem sucedido. Deve ser preenchido com endereo completo e seus diretrios. (Loja de exemplo Confirma.asp).
3) Pgina de falha no pagamento: Esta a URL que ser chamada caso o processo de compra no
seja bem sucedido. Deve ser preenchido com endereo completo e seus diretrios. (Loja de exemplo Falha.asp).
4) URL de notificao p/ Transferncia entre Contas: Esta a pgina mais importante do processo
de integrao da loja com o Sistema de Pagamento Seguro. Neste campo, o desenvolvedor dever
preencher com a URL da pgina da loja que vai passar os dados da compra para o Servidor SPS. Esta
configurao bastante importante. Deve ser preenchido com endereo completo e seus diretrios.
(Loja de exemplo - DadosCompra.asp).
5) Post a ser enviado para a loja na notificao: Estes so os parmetros enviados para a pgina
de notificao no processo de pagamento que deve ser copiado e colado no campo Post a ser enviado
para a loja na notificao dentro do gerenciador de configurao Bradesco no menu Configurao
Bradesco.
numOrder=[%lid_m%]&merchantid=[%merchantid%]&cod=[%errorcod%]&cctype=[%cctype%]&ccna
me=[%ccname%]&ccemail=[%ccemail%]&numparc=[%numparc%]&valparc=[%valparc%]&valtotal=[
%valtotal%]&prazo=[%prazo%]&tipopagto=[%tipopagto%]&assinatura=[%assinatura%]&
6) Post a ser enviado para a loja na confirmao de compra: Estes so os parmetros enviados
para a pgina de notificao no processo de pagamento que deve ser copiado e colado no campo Post a
ser enviado para a loja na confirmao de compra dentro do gerenciador de configurao Bradesco no
menu Configurao Bradesco.
numOrder=[%lid_m%]&merchantid=[%merchantid%]&cod=[%errorcod%]&cctype=[%cctype%]&ccna
me=[%ccname%]&ccemail=[%ccemail%]&numparc=[%numparc%]&valparc=[%valparc%]&valtotal=[
%valtotal%]&prazo=[%prazo%]&tipopagto=[%tipopagto%]&assinatura=[%assinatura%]&
IMPORTANTE: Caso haja a necessidade de envio de mais parmetros, estes devem ser passados na
URL (link de pagamento) no momento em que realizada a chamada para a pgina prepara_pagto.asp.
7) Post a ser enviado para a loja na falha da autorizao: Estes so os parmetros enviados
pgina de falha no processo de pagamento que deve ser copiado e colado no campo Post a ser enviado
para a loja na falha da autorizao dentro do gerenciador de configurao Bradesco no menu
Configurao Bradesco.
numOrder=[%lid_m%]&merchantid=[%merchantid%]&cod=[%errorcod%]&errordesc=[%errordesc%]
&
8) URL de entrada na loja: Neste campo, o desenvolvedor da loja, dever cadastrar o endereo de
entrada da loja.
Para inserir as alteraes clique no boto efetivar.

________________________________________________________________________ 6 de 12

Captulo 4
Fluxo de Mensagens Transferncia entre Contas Bradesco
A figura a seguir mostra o fluxo de dados do pagamento com Transferncia entre Contas Bradesco.

1) Navegao na loja: O cliente navega na loja normalmente, incluindo e retirando produtos na cesta
de compras. Quando o cliente finalizar o processo de escolha, a loja apresenta as formas de
pagamento disponveis para o cliente.
2) Pagar com Transferncia entre Contas Bradesco: Nesse momento, o cliente escolhe pagar com
Transferncia entre Contas Bradesco e redireciona o browser para o servidor de pagamentos link de
pagamento passando como parmetros o merchantid (nmero da loja) e o orderid (nmero do
pedido).
3) Pede dados da Compra: Ao receber a requisio de compra, o servidor SPS solicita loja (URL de
Notificao para Transferncia entre Contas) os dados da compra, passando os parmetros extras
caso tenha enviado junto a requisio, mais os parmetros merchantid (nmero de loja), numOrder
(nmero do pedido) e o parmetro TransId que ser enviado com o valor getTransfer.

________________________________________________________________________ 7 de 12

4) Responde dados da Compra: Neste caso, a loja dever montar um Order Description que dever
comear com <BEGIN_ORDER_DESCRIPTION> e ser seguido dos seguintes campos:
1) orderid: Nmero do pedido usado pela loja. Pode possuir at 27 caracteres alfanumricos,
dependendo de como a loja fez a implementao.
2)

descritivo: Descrio bsica do produto comprado.

3)

quantidade: Quantidade do mesmo produto comprado.

4) unidade: unidade de medida do produto. Ex.: CX para caixa, PC para pacote, UN para
unidade e etc.
5) valor: Valor do produto comprado. Este valor dever ser preenchido sem nenhum identificador
de moeda nem separadores (vrgula e pontos), ou seja, em centavos. Ex.: Compra de R$23,56 o
valor dever estar como 2356.
IMPORTANTE: A pgina da loja dever multiplicar o valor unitrio do produto pela quantidade
escolhida pelo comprador e o valor total (por produto) dever ser informado na TAG valor, pois o
sistema no multiplica.
6) adicional: Nome da taxa que a loja poder cobrar alm do valor da compra. Ex.: Frete Envio e
etc.
7) valorAdicional: Valor cobrado para o adicional. Este valor tambm dever ser preenchido
sem nenhum identificador de moeda nem separadores (vrgula e pontos), ou seja, em centavos.
IMPORTANTE: Nenhuma TAG poder ter o valor em branco ou nulo. Caso a loja no queira cobrar
nenhuma taxa, as TAG s adicional e valorAdicional devero ser retiradas do cdigo. As demais
TAG s so obrigatrias.
Neste ponto dever finalizar o Order Description com <END_ORDER_DESCRIPTION> e iniciar o
Transfer Description com <BEGIN_TRANSFER_DESCRIPTION> e ser seguido dos seguintes campos:
8)
NUMEROAGENCIA: Este campo deve ser preenchido com o nmero da agncia da conta do
lojista. Para o ambiente de testes, o desenvolvedor deve utilizar a agncia de teste 0001. Note que
os zeros esquerda so obrigatrios, pois a mesma deve conter 4 dgitos.
9)
NUMEROCONTA: Nmero da conta do lojista na agncia informada no item anterior. Para o
ambiente de testes, o desenvolvedor deve utilizar a conta de teste 0000001. Note que os zeros
esquerda so obrigatrios, pois a mesma deve conter 7 dgitos.
10) ASSINATURA: Este campo dever ser preenchido com a assinatura digital da Transferncia,
que ser fornecida para o lojista. Trata-se de um campo de 256 caracteres hexadecimais. Para o
ambiente de testes, o desenvolvedor deve utilizar a assinatura digital abaixo gerada com base na
agncia e conta de teste:
7B94A66D138FFD2AEBFBE3D8E0BDBD02700A5B793F017B0C8B40252C3680F9CD05C7E
EB1A395C84916425DC318F7F07518D416194FB077AA47A8DBD2B35B2E4C376A23385F
DD9B0AA3E7D0712B373B9EFD11028ADFC763B7EAD4A3E70FC8BE4A3CF4DA804E692A
6173F4B81F568D7A9A38F663106149A34409B3C48147FBAA12
Neste ponto dever finalizar o Transfer Description com <END_TRANSFER_DESCRIPTION>.

IMPORTANTE: Esta assinatura digital de teste especfica para esta forma de pagamento
transferncia, no sendo permitida a utilizao desta na opo Boleto Bancrio Bradesco. Vale
informar que a assinatura digital de produo gerada para transferncia tambm diferente da
assinatura digital gerada para a opo de pagamento Boleto Bancrio Bradesco.
Esta assinatura pode ser copiada diretamente para o campo de assinatura do Transfer Description.
Note que no devero constar quebras de linha na assinatura, ou seja, todos os 256 caracteres
devero estar em uma nica linha.

________________________________________________________________________ 8 de 12

Ateno
Vale lembrar que a sintaxe dos campos deve ser respeitada para a correta gerao dos dados para o
pagamento com Transferncia entre Contas Bradesco.
Veja, a seguir, um exemplo da string gerada pela pgina da loja (exemplo DadosCompra.asp):

<BEGIN_ORDER_DESCRIPTION>
<orderid>=(2000081719441874301278)
<descritivo>=(diskette 3 1/4 Sony)
<quantidade>=(1)
<unidade>=(cx)
<valor>=(700)
<descritivo>=(lapiseira Pentel 0.5 preta)
<quantidade>=(1)
<unidade>=(pc)
<valor>=(750)
<adicional>=(frete)
<valorAdicional>=(400)
<adicional>=(manuseio)
<valorAdicional>=(1200)
<END_ORDER_DESCRIPTION>
<BEGIN_TRANSFER_DESCRIPTION>
<NUMEROAGENCIA>=(0001)
<NUMEROCONTA>=(0000001)
<ASSINATURA>=(7B94A66D138FFD2AEBFBE3D8E0BDBD02700A5B793F017B0C8B402
52C3680F9CD05C7EEB1A395C84916425DC318F7F07518D416194FB077AA47A8DBD2B
35B2E4C376A23385FDD9B0AA3E7D0712B373B9EFD11028ADFC763B7EAD4A3E70FC8
BE4A3CF4DA804E692A6173F4B81F568D7A9A38F663106149A34409B3C48147FBAA12)
<END_TRANSFER _DESCRIPTION>

As lojas de exemplo disponveis para download j contemplam o pagamento com Transferncia entre
Contas Bradesco. Nestas lojas de exemplo, as pginas responsveis pelo envio dos dados para o
servidor SPS so: DadosCompra.asp, para lojas no Commerce Server e xt_orderform_purchase.asp
para lojas compatveis com o Commerce Server. Estas pginas usam algumas funes de formatao
de dados que podem ser usadas como exemplo pelos desenvolvedores.
Vale lembrar que no so permitidos nmeros repetidos de pedidos para diferentes compras. O
desenvolvedor deve garantir a unicidade dos nmeros destinados ao pagamento com Transferncia
entre Contas Bradesco.

5) Pgina de Pagamento com Transferncia entre Contas Bradesco: Aps o servidor de

pagamentos ter recebido o descritivo de compra, o SPS monta a pgina de pagamento com
Transferncia entre Contas Bradesco e envia ao cliente.
6) Login: na pgina de pagamento com Transferncia entre Contas Bradesco em seu browser, o
cliente digita Agncia e Conta.
7) Realiza a Transferncia: Nesse momento o cliente ser redirecionado para o Internet Banking do
Bradesco , onde dever se autenticar para entrar no sistema. Aps o login, ser apresentada a tela
da Transferncia entre Contas Bradesco, onde o cliente realizar a transferncia.
8) Confirmao da transferncia: Aps a concluso da transferncia com sucesso, o cliente dever
receber o recibo do pagamento do Internet Banking. Esse recibo vai enviar um post assinado para o
SPS informando o servidor de pagamentos sobre o status da transao.

________________________________________________________________________ 9 de 12

9) Dados da Autorizao: Aps o servidor receber a mensagem do browser do cliente, ela (a

mensagem) autenticada e verificada. Quando uma transao for efetuada com sucesso, o sistema
vai chamar novamente a pgina de notificao da loja, retornando para a loja os dados da
autorizao para que sejam gravados na base de dados da loja. Como resposta essa chamada, a
loja deve retornar a TAG <PUT_AUTH_OK> em caso de sucesso na gravao dos dados ou a TAG
<ERRO> se o processo de gravao resultar em erro ou falha.
No retorno loja, o servidor SPS envia os seguintes parmetros:

if=Bradesco: Constante que identifica a instituio financeira Bradesco.

Protocolo: Nmero do protocolo de agendamento no Internet Banking. Possui 7 posies

numricas. Exemplo: 0023876

transId=putAuth: Varivel que identifica a resposta da autorizao. Deve ser usada para
identificar a segunda chamada da pgina de notificao, quando os dados devem ser gravados
na base de dados da loja.

numOrder: Nmero do pedido usado pela loja. Pode possuir at 27 caracteres alfanumricos,
dependendo de como a loja fez a implementao. Exemplo: 2002090612245568381020

merchantid: Nmero do estabelecimento no Comrcio eletrnico Bradesco. Possui 9 posies

numricas em (produo).

cod: Cdigo de erro retornado pelo Banco. Retorna 0 (zero) para compras autorizadas.

cctype=Transferencia Identificada: Constante que identifica o pagamento com Transferncia

entre Contas Bradesco

numparc: Nmero de parcelas. Para a opo de pagamento Transferncia entre Contas

Bradesco este valor ser sempre 1 (pagamento vista).

valparc: Valor de cada parcela. Para a opo de pagamento Transferncia entre Contas Bradesco
este valor ser sempre o valor total da compra.

valtotal: Valor total da compra.

ccname, ccemail, prazo e tipopagto: So retornados pelo sistema para manter a compatibilidade
com outras formas de pagamento, mas no sero usadas no pagamento com Transferncia
entre Contas Bradesco. Assim estaro sempre com valor nulo.

Assinatura: Assinatura digital da transao. Este campo possui 256 posies alfanumricas
(hexadecimal). Somente retornada se a transao for completada com sucesso. Exemplo:
16363AD0831E0FBFAD2261EB4E7A117E46C801482352C9C855E076C8F20A3E752FB24790FC7
0495ED08D0AA11A5670EE106768A8074BE089BFC17988C54B3477F757B2C911ED2B6803178
4B0AEE04C14359FA976E66062D5D5B771A029198523C47B1568F1E35DEF1ADC0AB33609B49
54712E0107FB8DDD99D559565E3E141C9

10) Dados OK: Se, o servidor SPS receber a TAG <PUT_AUTH_OK>, a pgina de confirmao de
compra da loja ser enviada ao browser do cliente, caso contrrio, a pgina de falha de pagamento
ser enviada.
11) Pagina de Confirmao: Dependendo da tag de resposta da loja, a mesma pode, ento, apresentar
a sua pgina de confirmao ou erro.

________________________________________________________________________ 10 de 12

Captulo 5
Demonstrao da tela Transferncia entre Contas Bradesco

Aps a digitao dos dados o cliente se loga no Internet Banking e em seguida ser apresentada a tela com as
informaes da Transferncia que ser realizada.

________________________________________________________________________ 11 de 12

Captulo 6
Dvidas e Homologao
Dvidas
Surgindo dvidas durante o processo de integrao, o contato poder ser realizado:
Atravs do e-mail: kit@scopus.com.br, contendo as seguintes informaes:
-

Nome da loja;

CNPJ da loja;

Dvida.

Telefones:
(11) 3909-3482
(11) 3909-3637

Homologao
A homologao dever ser solicitada a equipe do Comrcio Eletrnico.
Atravs do e-mail: homologacao@scopus.com.br, contendo as seguintes informaes:
-

Nome da loja;

CNPJ da loja;

URL do site para teste;

Informar qual opo de pagamento que dever ser homologada.

________________________________________________________________________ 12 de 12