Manual Tecnico ItauShopline PDF

Ita Shopline
Guia de Identidade Visual

Manual Tcnico do Desenvolvedor
Introduo
Home Voltar Avanar
Voc contratou o Ita Shopline e agora sua loja virtual conta com uma plataforma completa de meio
de recebimento on-line que atende clientes e no clientes Ita.
Confira os principais benefcios para sua empresa:
Praticidade, segurana e controle: contratao e instalao pela internet, com gesto completa
dos pagamentos pelo Ita Empresas na internet;
Sua empresa fica disponvel 24 horas por dia, 7 dias por semana;
Aumenta sua relao de clientes potenciais: atende clientes Ita, no correntistas e at quem no possui
conta bancria;
Mais possibilidades para seus clientes pagamento atravs de qualquer carto de crdito: MasterCard, Visa,
Hipercard e Diners, dbito em conta, boleto bancrio ou financiamento.
Neste Manual Tcnico do Desenvolvedor Ita Shopline voc encontra as diretrizes para aplicar e implementar o produto.
Nele tambm consta um guia de identidade visual com todos os elementos grficos do Shopline.
2
Home ndice Voltar Avanar
Guia de Identidade Visual

ndice
Home Voltar Avanar
Identidade visual Ita Shopline
Ita Shopline | Dbito em conta e financiamento
Ita Shopline | Boleto bancrio
Ita Shopline | Carto de crdito
Ita Shopline | Aplicao em diferentes formas
Ita Shopline | Usos incorretos - cenrios de/para
*UB4IPQMJOF](*'BOJNBEP
4
Identidade visual Ita Shopline

O Ita Shopline uma Mdia
plataforma de meios de
Nomenclatura Arquivo a ser usado Definio
pagamentos que oferece
as opes de dbito em
O dbito em conta uma opo para
conta, financiamento, boleto
correntistas do Ita e deve ser sempre
bancrio e carto de crdito dbito em conta
representado pela marca Ita sobre o
aos compradores do site da
fundo laranja.
sua empresa.
Atente para o uso correto

dos cones novos para O financiamento uma opo para correntistas
Ita Shopline. E sempre financiamento do Ita e deve ser sempre representado pela
utilize os arquivos fornecidos marca Ita sobre o fundo laranja.
pelo Ita Unibanco.
O boleto bancrio uma opo para clientes

e no clientes do banco Ita e pode ser
boleto bancrio
representado pelo cone ao lado, que tem a
imagem de um cdigo de barras.
A opo de carto de crdito vale para clientes

e no clientes Ita e deve apresentar as marcas
cartes de crdito
das bandeiras que podero ser utilizadas para
o pagamento.
O boto formas de pagamento Ita um

2010 Ita Unibanco Holding S.A.
GIF animado que mostra todas as opes

formas de pagamento Ita de pagamento possveis para o consumidor.
Ele direciona o usurio para uma pgina Ita
onde deve ser confirmada a forma de pagamento.
Manual Ita Empresas dezembro 2012 DimaiDesign

5
Ita Shopline | Dbito em conta e financiamento

O cone da marca Ita ser Importante:
x/2
usado para representar dois
meios de pagamento, dbito x/2 R 238 G 114 B 3
em conta e financiamento. R 0 G 51 B 153
A regra para este cone o uso x R 255 G 204 B 0

No desrespeitar a rea No usar o nome fora
da marca Ita sobre o fundo
mnima de proteo. da forma original.
laranja, preferencialmente na
forma quadrada: 130x130 px A relao indicada acima define a
(para uso em outras formas, rea de reserva da marca Ita para
verificar pg. 4). seu uso neste cone. Esta reserva
indica o mnimo de distncia que se
Sempre use o arquivo deve ter da marca para preservarmos No usar a marca fora No utilizar nenhuma das verses
sua leitura. do fundo laranja. da marca Shopline no checkout.
fornecido pelo Ita Unibanco.
No inclinar ou No aplicar
distorcer a marca. efeitos marca.
No cortar a marca. No trocar a cor de

fundo da marca.

6
Ita Shopline | Boleto bancrio

O cone de boleto ser usado Importante:
para representar o pagamento
feito atravs do boleto bancrio.
R 147 G 149 B 152
Sua largura em formato
preferencial de 140 px. No exagere no tamanho
E sua cor cinza conforme do cone.
Para identificar o pagamento por boleto
especificado pelo cdigo ao lado. bancrio, sempre use o cone acima
respeitando sua proporo e no fazendo
Sempre use o arquivo
uso indevido de sua aplicao.
fornecido pelo Ita Unibanco.
No troque a
cor do cone.
No aplique efeitos no cone.
No distora o cone.

7
Ita Shopline | Carto de crdito

Para a identificao de Importante:
pagamento atravs de
cartes de crdito, a regra
identificar quais cartes
so aceitos atravs de suas
respectivas marcas. No use formatos desproporcionais entre as
marcas destacando ou priorizando alguma delas.
As marcas dos cartes esto
disponveis no Ita Empresas
na internet.
Como referncia, a marca No altere os arquivos de marca recebidos.

do Hipercard deve ser usada
em formato preferencial de
220x130px. Para cartes de crdito, apresentar as
bandeiras respeitando reas de proteo
e convivncia. Sempre que possvel, No aplique efeitos nos cones.
utilize o formato preferencial da marca
Hipercard como base de referncia.

8
Ita Shopline | Aplicao em diferentes formas

Ex.: aplicao em forma quadrada Ex.: aplicao em forma retangular Ex.: aplicao em forma redonda
O formato em que as marcas
so aplicadas pode ser FORMAS DE PAGAMENTO FORMAS DE PAGAMENTO FORMAS DE PAGAMENTO
adaptado, respeitando a
proteo mnima de cada Boleto bancrio Boleto bancrio Boleto bancrio
uma delas, dependendo da

diagramao do site.
Carto de crdito Carto de crdito Carto de crdito
As marcas devem ser
padronizadas, sempre que
possvel, respeitando suas
regras de convivncia. Dbito em conta Dbito em conta Dbito em conta
Ao lado, exemplos de modos

corretos de adaptao nos
Financiamento
formatos da marca Ita. Financiamento Financiamento
Para mais detalhes, consulte

o ltimo Guia da Marca.
Em alguns sites, a diagramao

indica uma aplicao que difere
da preferencial quadrada. Nesses
casos, respeite a rea de proteo
da marca Ita.

9
Ita Shopline | Usos incorretos - cenrios de/para

De:
No use cones genricos no fornecidos No descreva as formas de pagamento No use outro boto de forma de Nunca utilize Ita Shopline, use a
pelo Ita Unibanco. fora do padro de nomenclatura e use pagamento que no seja o entregue pelo nomenclatura correta para cada servio,
os cones relacionados a cada uma delas. Ita Unibanco. conforme descrito neste manual.
Utilize somente os arquivos fornecidos
pelo Ita Unibanco.
Para:

10
GIF animado
O GIF animado tem formato Importante:
preferencial de 200x93 px.
Ele composto por
elementos que no podem No distora o GIF.
ser alterados, mantendo as
mesmas caractersticas em
todos os sites em que for
encontrado. O GIF e seus No mude a cor
elementos no podem do fundo.
ser redesenhados.
Para isso, existem algumas

regras que devem
ser seguidas. No altere os
elementos.
O formato do GIF foi retirado da curva do

shape Ita. Use o GIF sempre em laranja

com fundo animado.

11
GIF animado
O GIF animado deve
mostrar todas as opes de
pagamento possveis para Fase 1 Fase 4
o consumidor.
Para isso, ele dividido

em fases que direcionam
o cliente para o tipo de
pagamento escolhido. Fase 2 Fase 5
Ao clicar no GIF animado,

o usurio direcionado
para uma pgina onde ele
deve confirmar a forma de
pagamento. Essa pgina
Fase 3 Fase 6
organizada seguindo as
orientaes do Guia da Marca
Ita, com a aplicao dos
novos cones.

12
Manual Tcnico do Desenvolvedor

ndice
Home Voltar Avanar
1. Informaes Gerais 5. Exemplo de Cdigos

1.1 Utilizao do Ita Shopline 5.1 Usando Itaucripto.dll Para Ambientes Microsoft
1.2 Configurao do Ita Shopline 5.1.1 Envio dos Dados Pgina Inicial HTML
1.3 Instalao do Ita Shopline 5.1.2 Criptografia dos Dados Cdigo ASPX
5.1.3 Retorno do Tipo de Pagamento Cdigo ASPX
2. Servios do Ita Shopline 5.1.4 Consulta Situao do Pagamento Cdigo ASPX
2.1 Mdulo Ita Shopline 5.1.5 Reemisso do Boleto Cdigo ASPX
2.1.1 Informaes Cadastrais do Site Lojista 5.2 Para Ambientes Unix ou Linux
2.1.2 Instrues de Implantao do Produto 5.2.1 Envio dos Dados Pgina Inicial HTML
2.2 Gerao do Ita Shopline 5.2.2 Criptografia dos Dados Cdigo Java
URL Principal de Acesso ao Produto 5.2.3 Retorno do Tipo de Pagamento Cdigo Java
2.3 Reemisso de Boletos 5.2.4 Consulta Situao do Pagamento Cdigo Java
2.4 Retorno On-line do Tipo de Pagamento 5.2.5 Consulta Situao do Pagamento Cdigo Java
2.5 Consulta de Operaes Realizadas via Ita Shopline 5.3 Envio e Criptografia dos Dados Cdigo PHP
2.5.1 Consulta de Operaes do Mdulo Ita Shopline
2.5.2 Arquivo Retorno de Cobrana 6. Auxlio Instalao do Ita Shopline
2.5.3 Consulta Automtica Situao do Pagamento (sonda) 6.1 Mensagem de Erro de Sistema
2.6 Ita Shopline Multibandeira
Anexos Demonstrativos
3. Layout dos Campos
3.1 Parmetros e Critrios de Consistncias

4. Informaes Tcnicas
4.1 Usando Itaucripto.dll - Para Ambientes Microsoft
4.1.1 Passo 1: Criptografia
4.1.2 Passo 2: Chamada Tela do Ita Shopline
4.2 Para Ambientes Unix ou Linux
14
1. Informaes Gerais
O Ita Shopline uma plataforma completa de meio de recebimento on-line

para clientes Ita Empresas que querem vender pela internet.
E para os consumidores uma forma rpida e segura para comprar pela internet.
Ao vender produtos ou servios pela internet e disponibilizar o Ita Shopline

como meio de pagamento, seu site ir proporcionar a seus clientes uma maneira
simples, prtica e segura de efetuar pagamentos, tendo a oportunidade de escolher,
entre as opes oferecidas pelo Ita, a mais conveniente.
As opes de pagamento que atualmente compem a plataforma Ita Shopline so:
Dbito em conta - carteira de cobrana 178;

Financiamento - carteira de cobrana 178;
Cartes de crdito (MasterCard, Visa, Hipercard e Diners) - Filiado
Redecard;
Boleto bancrio - carteira de cobrana 176.
As duas primeiras opes so exclusivas para clientes Ita que acessarem este meio
de pagamento no site do lojista, o carto de crdito (MasterCard, Visa, Hipercard
e Diners) e o boleto atendero necessidade de liquidao financeira de todos
os compradores do site. Para habilitar a opo de cobrana por carto de crdito
necessrio que o site lojista esteja filiado Redecard, cadastrado no Komerci Web
Service e ter cadastro junto ao banco Ita com seu cdigo de filiao.
O Ita Shopline a nica forma de cobrana do banco Ita que integra diversas
opes de pagamento numa s plataforma e procura dar nfase para a liquidao
on-line, agilizando o processo de compra pela internet.
15
1. Informaes Gerais
1.1 Utilizao do Ita Shopline
Independentemente do modelo de negcio de cada site, isto , se o processo A consulta de informaes referentes aos pagamentos efetuados via Ita Shopline
de compra ocorre em sequncia at chegar ao resumo da compra ou se o site envia disponibilizada pelo banco Ita de trs maneiras distintas: Consulta de Operaes
a seus clientes uma fatura por e-mail, haver um determinado momento em que do Mdulo Ita Shopline, Arquivo Retorno de Cobrana e Consulta Automtica
o Ita Shopline ser selecionado pelo comprador como forma de pagamento da Situao do Pagamento (Sonda).
e, a partir desse momento, a plataforma de cobrana do Ita ser apresentada
ao usurio final do site, que realizar a liquidao financeira do pagamento A empresa escolhe a consulta que mais lhe convm. Para mais detalhes sobre essas
em ambiente seguro Ita. consultas, veja o item 2.5. deste manual.
O modelo de negcio do site lojista (cedente) no invalida o funcionamento Em cada uma das consultas disponveis, o banco informar a opo de pagamento
da soluo de cobrana oferecida pelo Ita Shopline, pois o nico pr-requisito escolhida para o pedido e confirmar sua situao de pagamento em funo
necessrio haver um momento em que o servidor do site envie ao servidor da ao de pagamento do comprador, do prazo de floating de crdito negociado
do banco os parmetros de cobrana a serem usados para concretizar a liquidao para as carteiras de cobrana e do prazo de compensao da forma de liquidao
financeira solicitada. do pedido, determinando, assim, diferentes status para acompanhamento.
Para identificar corretamente a forma de pagamento Ita Shopline oferecida

em seu site, utilize sempre a nomenclatura Formas de Pagamento Ita e,
caso precise, disponibilizaremos um banner para divulgao da plataforma.
Neste material constam todas as orientaes sobre a correta utilizao da marca
Ita no site da loja virtual.
Ao acessar o Ita Shopline, o cliente navega pelas telas das opes e efetua
seu pagamento, selecionando uma das opes disponveis. O lojista avisado
sobre a finalizao da compra e a opo de pagamento escolhida pelo cliente,
em ambiente Ita, atravs do Retorno On-line do Tipo de Pagamento.
Por segurana, deve vir at o ambiente Ita para confirmar a situao de pagamento
do pedido em questo. Para mais detalhes, vide item 2.5. deste manual.
16
1. Informaes Gerais
1.2 Configurao do Ita Shopline
Para configurar o Ita Shopline, necessrio que o site esteja vinculado a uma A cobrana por carto de crdito (MasterCard, Visa, Hipercard e Diners) via Ita
conta-corrente pessoa jurdica no banco Ita com: cadastro nas carteiras 176 Shopline s estar disponvel aos compradores de seu site se houver a incluso
e 178 da Cobrana Eletrnica Ita, acesso ao Ita Empresas na internet e contrato do cdigo de filiao da Redecard Komerci Web Service na opo Informaes
formalizado para utilizar o Ita Shopline. Cadastrais do Ita Shopline no Ita Empresas na internet, filiado ao banco Ita,
e a Redecard estiver com o IP do Ita Shopline no seu cadastro (favor informar
Para contratar* o Ita Shopline, o cliente deve acessar: Ita Empresas na internet Redecard que cliente Ita Shopline para que eles faam essa incluso de IP).
> Recebimentos > Ita Shopline > Contratar, ou atravs do responsvel pela
conta-corrente do site, formalizando a proposta de contratao do produto Atravs do Mdulo Ita Shopline possvel configurar:
junto ao Ita Empresas na internet. Assim que a proposta aprovada,
encaminhada uma confirmao por e-mail indicando o acesso s instrues O cdigo de filiao Redecard Komerci;
de cadastro e instrues de implantao do produto em seu site. Alguns parmetros adicionais relativos opo boleto bancrio, tais como:
prazo padro de vencimento, nome do cedente (site) no boleto
*Na contratao, o nome do site no pode conter caracteres especiais. e mensagens adicionais;
Ex: @, #, $, &, , etc. Endereo principal do servidor seguro de seu site (SSL) para uso da funo
Retorno On-line/Consulta Automtica.
Todas as Informaes Cadastrais do site e as Instrues de Implantao
para uso do produto so disponibilizadas ao responsvel pela conta-corrente
do site no Mdulo Ita Shopline acessado via Ita Empresas na internet dentro
da opo Instalao Manuais/Banners/Botes e Componentes.
no Mdulo Ita Shopline que o responsvel pelo site cadastra e consulta

seus Cdigos de Habilitao para uso do Ita Shopline (Cdigo do Site e Chave
de Criptografia) e configura os demais campos necessrios gerao do produto.
As opes de pagamento que compem a configurao do Ita Shopline so:

dbito em conta, financiamento, carto de crdito (MasterCard, Visa, Hipercard
e Diners) e boleto bancrio.
17
1. Informaes Gerais
1.3 Instalao do Ita Shopline
Para instalar o Ita Shopline, deve-se inicialmente registrar o componente

Itaucripto.dll no equipamento que executar a aplicao do site.
Aps este procedimento, deve-se desenvolver uma pgina dinmica que execute
a chamada ao mtodo geraDados para efetuar a criptografia dos dados necessrios
gerao do Ita Shopline. Esses dados devem ser armazenados na varivel DC
e enviados para a URL Principal de Acesso ao Ita Shopline.
Desta forma, quando o Ita Shopline selecionado no ambiente do lojista como

meio de pagamento para finalizao da compra, os dados do pedido devem ser
criptografados e enviados pelo site lojista para a URL Principal do Ita Shopline,
conforme os critrios determinados neste manual (itens 2, 3 e 4). Uma nova
instncia de browser aberta, sem fechar a janela do site da loja virtual e o cliente
comprador transferido para o site do Ita Shopline, j em ambiente seguro Ita,
onde navegar conforme suas escolhas.
18
2. Servios do Ita Shopline
O Ita Shopline disponibiliza aos lojistas j cadastrados diversas facilidades para

utilizao e configurao do produto, teste, instalao e consulta de informaes
sobre o pagamento dos pedidos. Veja a seguir.
19
2.1 Mdulo Ita Shopline

2.1.1 Informaes Cadastrais do Site Lojista
Todas as informaes cadastrais do site lojista esto disponveis para consulta

e atualizao no Mdulo Ita Shopline acessado via Ita Empresas na internet
na conta-corrente do site do lojista. Dentro do Ita Empresas na internet, a rota
de acesso a esta funo : Ita Empresas na internet > Recebimentos >
Ita Shopline > Informaes Cadastrais
Nesta funo encontram-se os Cdigos de Habilitao do site para uso do produto

que so: Cdigo do Site e Chave de Criptografia.
A Chave de Criptografia um cdigo alfanumrico criado pelo site
com exatamente 16 posies para dar segurana transmisso dos dados
que iro trafegar entre o servidor do site e o servidor do banco no momento
da gerao do Ita Shopline.
O Cdigo do Site um cdigo criado pelo banco que identifica a conta-
corrente onde sero creditados os pagamentos efetuados em ambiente
seguro Ita Shopline.
Os Cdigos de Habilitao devero ser informados ao responsvel pela instalao

do Ita Shopline no site.
Ateno: qualquer informao alterada neste ambiente estar disponvel

para utilizao on-line aps a alterao. Para acessar o Ita Empresas na internet,
necessrio entrar no site do Ita (http://www.itau.com.br/empresas) e digitar:
Dados de Usurio Operador e Senha Eletrnica na barra de acesso
ao Ita Empresas na internet.
20
2.1 Mdulo Ita Shopline

2.1.2 Instrues de Implantao do Produto
Todas as Instrues de Implantao do Produto esto contidas neste manual

tcnico. Futuras atualizaes da verso estaro sempre disponveis para download
no Mdulo Ita Shopline.
Dentro do Ita Empresas na internet, a rota de acesso a esta funo :

Cobrana ou Recebimentos > Ita Shopline > Instalao.
A implantao do Ita Shopline est detalhada nos itens 2, 3 e 4 deste manual

e para tal ser necessrio obter os Cdigos de Habilitao do site, o Componente
de Criptografia e os Banners de Identificao do Produto e providenciar
a programao dos parmetros necessrios gerao do Ita Shopline.
Para resolver dvidas quanto instalao do meio de pagamento

Ita Shopline em seu site, entre em contato com o atendimento
Ita Empresas no telefone 0300 100 7575.
21
2.2 Gerao do Ita Shopline URL Principal de Acesso ao Produto
Ambiente de produo:
O ambiente da plataforma de cobrana Ita Shopline acessado atravs do envio

dos dados criptografados para a seguinte URL:
https://shopline.itau.com.br/shopline/shopline.aspx
Esta a URL oficial que dever ser acionada pelo comprador no site do lojista
para que haja a gerao do Ita Shopline. Neste ambiente, o comprador
encontrar todas as opes de pagamento do produto que estiverem habilitadas
para o site do lojista e ir navegar conforme seus interesses e disponibilidades.
Clique aqui para visualizar a Tela Inicial do Ita Shopline
22
2.3 Reemisso de Boletos
A reemisso de boleto feita automaticamente pela URL de emisso na aplicao

Ita Shopline. Se o pedido informado j existir em nossas bases com o mesmo
valor e ainda no estiver sido pago, considerado uma reemisso. Sendo assim,
deve-se chamar sempre a URL de emisso, ou seja a mesma URL utilizada para
fazer a chamada do site.
Portanto, se houve gerao de boleto e este ainda no foi liquidado e nem perdeu
sua validade, ser possvel reemiti-lo a qualquer momento, at seu vencimento.
Clique aqui para visualizar o Boleto Bancrio do Ita Shopline.
23
2.4 Retorno On-line do Tipo de Pagamento
O Ita disponibiliza aos lojistas do Ita Shopline o Retorno On-line, isto , a opo Ateno: se o site no passar o campo urlRetorna nos dados criptografados
de receber um retorno, pedido a pedido, indicando o tipo de pagamento do pedido, ficar subentendido que no quer receber o Retorno do Tipo de
escolhido pelo comprador em ambiente Ita Shopline. Para isso, necessrio que Pagamento escolhido.
o lojista informe um endereo seguro (URL) para receber a informao que dever
ser cadastrada em campo especfico da tela de Informaes Cadastrais do Mdulo O Retorno On-line informa apenas o tipo de pagamento da plataforma que foi
Ita Shopline (vide item 2.1.1 deste manual). escolhido pelo cliente comprador do site. A confirmao do pagamento
do pedido garantida exclusivamente pelo banco e dever ser sempre obtida
Ateno: essa chamada ser feita somente em aplicaes com SSL. em ambiente Ita, o que significa que o site que deve consultar o banco e no
esperar esta confirmao num retorno.
Forma de acesso: comunicao criptografada estabelecida entre o servidor
do banco e o servidor do site. Sendo assim, as modalidades de Consulta de Operaes oficiais do banco so:
Consulta de Operaes do Mdulo Ita Shopline, Arquivo Retorno de Cobrana
Formato da consulta: o Retorno On-line ser sempre disponibilizado no formato ou Consulta Automtica Situao do Pagamento (sonda).
XML para que seja decriptografado e interpretado pelo site conforme os cdigos
possveis. Mais detalhes sobre a integrao dessa modalidade de consulta de
operaes sero apresentados nos itens subsequentes.
Tempo de disponibilizao: on-line e real time assim que o pedido registrado

no banco e associado a alguma das opes de pagamento da plataforma,
a informao do Tipo de Pagamento escolhido em ambiente Ita Shopline
retornada ao servidor do site que dever seguir os procedimentos indicados
no item 2.5 deste manual para interpret-la.
Aps a emisso do comprovante de pagamento ou da pgina do boleto na tela

do comprador, o Ita far a chamada aplicao do lojista conforme o endereo
resultante da concatenao da URL de Retorno j cadastrada no Ita Shopline
e a URL informada no campo urlRetorna da criptografia do pedido.
24
2.5 Consulta de Operaes Realizadas via Ita Shopline
Todos os pedidos que acessam a plataforma de cobrana Ita Shopline

so registrados no banco, sendo sempre possvel saber a opo de pagamento
escolhida pelo comprador em ambiente Ita Shopline e se o pedido foi pago
ou no. Para o site lojista, a identificao da opo de pagamento escolhida
se d pela carteira de cobrana (vide item 1 deste manual).
Existem diversas maneiras de consultar as operaes realizadas via Ita Shopline.

Elas diferem entre si pela forma como so acessadas, pelo formato em que so
disponibilizadas e pelo tempo em que disponibilizam a informao referente
aos pedidos consultados.
Veja a seguir mais detalhes sobre as consultas disponveis.
25

2.5.1 Consulta de Operaes do Mdulo Ita Shopline
O Mdulo Ita Shopline oferece uma consulta exclusiva das operaes realizadas Nessa listagem haver um indicador da compensao da cobrana do ttulo
via Ita Shopline, relacionando os pedidos s carteiras que identificam o Ita Shopline que dado pela literal C citada no demonstrativo. Se houver a literal ao lado
(176 e 178), sendo um filtro das informaes oferecidas nas funes da rota dos valores creditados, indica que estes valores esto A COMPENSAR, se no
Carteiras e Ttulos do Ita Empresas na internet. houver literal, significar COMPENSADO. Isto ocorre quando h pagamento
de ttulos com cheque, pois o valor no fica disponvel de imediato, e, sim,
Forma de acesso: Ita Empresas na internet da conta-corrente do site. A rota para somente aps a compensao do cheque.
esta consulta no Mdulo Ita Shopline :
Tempo de disponibilizao: on-line e real time assim que o pedido registrado
I ta Empresas na internet > Recebimentos > Ita Shopline > no banco e associado a alguma das opes de pagamento da plataforma,
Consulta de Operaes essa informao disponibilizada no Mdulo Ita Shopline conforme
o status ocorrido.
Formato da consulta: a partir da navegao no Ita Empresas na internet,
o usurio visualiza a relao de pedidos efetuados em seu site que ser A reutilizao da numerao de um pedido s poder ser feita:
identificada conforme a opo de pagamento escolhida pelo comprador.
Para o lojista, as opes possveis so: dbito em conta (178), financiamento, Para os pedidos pagos, aps 60 dias corridos da data de pagamento;
carto de crdito (MasterCard, Visa, Hipercard e Diners) e boleto bancrio Para os pedidos no pagos, aps 60 dias corridos da data de vencimento;
(176) e estaro separadas nas listagens conforme os seguintes status: Para os pedidos no finalizados, 60 dias corridos da data do pedido.
O peraes em Aberto pedidos que emitiram boletos e que ainda no A informao fica armazenada por 5 anos. Outras formas de acompanhar
foram pagos. o status do pagamento so: Arquivo Retorno de Cobrana ou Consulta
Operaes a Creditar pedidos que j foram pagos pelos compradores Automtica a Situao do Pagamento (sonda).
e que ainda no foram creditados para o lojista devido ao floating da cobrana
negociado com o gerente da conta-corrente do site. Se for a listagem Clique aqui para visualizar um exemplo da Consulta de Operaes do Mdulo
de pagamento vista, o pedido j seguro de crdito para o lojista Ita Shopline.
nesse momento, mas se for boleto bancrio, ser necessrio esperar pela
compensao da cobrana do ttulo para ter a garantia do crdito.
Operaes Creditadas pedidos que j foram pagos pelos compradores
e que j foram creditados para o lojista.
Histrico de operaes realizadas pedidos pagos via carto de crdito.
26

2.5.2 Arquivo Retorno de Cobrana
O Arquivo Retorno de Cobrana oferece a consulta de todos os ttulos liquidados

conforme as carteiras de cobrana contratadas e utilizadas pela conta-corrente No Ita Empresas na internet ficam disponveis os arquivos das ltimas 5
do cliente cedente (site lojista). movimentaes dirias, sendo que a gerao de arquivos feita de tera a sbado,
contemplando sempre a movimentao do dia anterior.
Forma de acesso: conforme a modalidade de intercmbio de arquivos definida
pelo lojista junto a seu Gerente de Relacionamento Ita Empresas. A forma mais A reutilizao da numerao de um pedido s poder ser feita:
simples de obter o arquivo atravs do Ita Empresas na internet na conta-corrente
do site. Para os pedidos pagos, aps 60 dias corridos da data de pagamento;
Para os pedidos no pagos, aps 60 dias corridos da data de vencimento;
P
ara usurios do Ita Empresas na internet, a rota : Para os pedidos no finalizados, 60 dias corridos da data do pedido.
Transmisso de Arquivo > Transmisso (Ambiente Produo) > Retorno >
Recepcionar. A informao fica armazenada por 5 anos. Outras formas de acompanhar o status
do pagamento so: Consulta de Operaes do Mdulo Ita Shopline ou Consulta
Formato da consulta: arquivo de texto (extenso .txt) padro CNAB que informa Automtica Situao do Pagamento (sonda).
todas as operaes liquidadas, conforme a carteira de cobrana associada ao no do
ttulo. Nas carteiras utilizadas pelo Ita Shopline, o no do pedido enviado ao banco Clique aqui para visualizar um exemplo do Arquivo Retorno de Cobrana.
ser transformado em SEU NMERO e ir compor tambm o campo NOSSO NMERO.
Para programar a leitura desse arquivo e integr-lo ao sistema de conciliao bancria

de sua empresa, necessrio obter junto ao gerente de sua conta o Manual
de Intercmbio de Arquivos que especifica todos os campos que sero informados
no Arquivo Retorno de Cobrana. Para conhecer o layout da Cobrana Ita acesse
o Ita Empresas na internet e siga a rota: Outros Servios > Download Center >
Cobrana Manual de Intercmbio de Arquivos.
Tempo de disponibilizao: um dia til aps a liquidao do ttulo (D+1) assim

que o pedido pago, a informao compilada pela cobrana sob a forma de
Arquivo Retorno e apresentada ao lojista um dia til aps a liquidao.
27

2.5.3 Consulta Automtica Situao do Pagamento (sonda)
O Ita oferece aos lojistas do Ita Shopline a possibilidade de realizar uma Consulta As combinaes de consulta possveis so:
Automtica (sonda) ao servidor do banco para obter a situao de pagamento
TIPPAG SITPAG
de um pedido.
On-line e real time
00 para 01 para situao de pagamento no finalizada (tente novamente)
A URL utilizada para executar esta consulta : pagamento ainda 02 para erro no processamento da consulta (tente novamente)
https://shopline.itau.com.br/shopline/consulta.aspx. no escolhido 03 para pagamento no localizado (consulta fora de prazo
ou pedido no registrado no banco)
Os dados devem ser criptografados utilizando o mtodo geraConsulta. On-line e real time
00 para pagamento efetuado
01 para
01 para situao de pagamento no finalizada (tente novamente)
Para a consulta devem ser utilizados, obrigatoriamente, os seguintes dados: pagamento vista
02 para erro no processamento da consulta (tente novamente)
Chave, Cdigo da Empresa, Nmero do Pedido e Formato. Para descriptografar (TEF e CDC)
03 para pagamento no localizado (consulta fora de prazo
o resultado da consulta utilizado: Cdigo da Empresa, Nmero do Pedido, Valor, ou pedido no registrado no banco)
Tipo de Pagamento, Situao do Pagamento e Data de Pagamento. On-line e real time
Segue o exemplo de utilizao dos dados criptografados: 03 para pagamento no localizado (consulta fora de prazo
dados = cripto.geraConsulta(codEmp, pedido, formato, chave). 02 para ou pedido no registrado no banco)
boleto bancrio 04 para boleto emitido com sucesso
Nesta consulta exibida a efetivao do pagamento do pedido em funo do tipo A partir de um dia til da emisso do boleto
de pagamento utilizado pelo comprador em ambiente Ita Shopline, sendo 05 para pagamento efetuado, aguardando compensao
que o tempo de disponibilizao desta informao varia conforme a opo de 06 para pagamento no compensado
pagamento escolhida. On-line e real time
03 para 01 para situao de pagamento no finalizada (tente novamente)
carto de crdito 02 para erro no processamento da consulta (tente novamente)
03 para pagamento no localizado (consulta fora de prazo
ou pedido no registrado no banco)
28

2.5.3 Consulta Automtica Situao do Pagamento (sonda)
De acordo com a tabela anterior, as opes de pagamento 01 e 03 podero ser confirmadas A reutilizao da numerao de um pedido s poder ser feita:
em tempo real, mas a opo de pagamento 02 (boleto bancrio) s ser confirmada
aps a compensao do ttulo na Cobrana Ita. Em tempo real, apenas informado Para os pedidos pagos, aps 60 dias corridos da data de pagamento;
que o comprador gerou um boleto em sua tela, com sucesso, permitindo ao lojista Para os pedidos no pagos, aps 60 dias corridos da data de vencimento;
a integrao da funcionalidade de reemisso de ttulos, por exemplo. Para os pedidos no finalizados, 60 dias corridos da data do pedido.
J que o Ita Shopline uma forma de cobrana via internet que se utiliza A informao fica armazenada por 5 anos. Outras formas de acompanhar
das carteiras 176 e 178 para identificar os pedidos enviados pelo site ao banco, o status do pagamento so: Consulta de Operaes do Mdulo Ita Shopline
vale ressaltar que pagamento efetuado significa ttulo liquidado e que importante ou Arquivo Retorno de Cobrana.
considerar tambm o prazo para crdito da cobrana (floating negociado para
a conta-corrente do site) e a forma de liquidao do ttulo (dinheiro, cheque, Clique aqui para visualizar a Consulta Automtica Situao
compensao bancria) que pode ser compensada ou no ao fim do processo. de Pagamento (sonda).
Forma de acesso: comunicao criptografada estabelecida entre o servidor Alm das trs modalidades de Consulta de Operaes aqui detalhadas, existem
do site e o servidor do banco. outras maneiras de consultar as operaes realizadas via Ita Shopline que trazem
as confirmaes de todas as carteiras de cobrana utilizadas pelo lojista como,
Formato da consulta: a Consulta Automtica (sonda) poder ser obtida por exemplo, o relatrio 2154. Para mais informaes, procure seu Gerente
no formato XML ou HTML. Mais detalhes sobre a integrao dessa modalidade de Relacionamento Ita Empresas.
de consulta de operaes sero apresentados nos itens subsequentes.
O responsvel pelo site escolher a(s) modalidade(s) de consulta mais conveniente(s).
Tempo de disponibilizao: on-line e real time aps receber o Retorno On-line,
o site poder preparar seu servidor para disparar uma Consulta Automtica
ao servidor do banco para obter a Situao do Pagamento do pedido retornado.
29
O prazo para a loja estar OK com sistema e passar a capturar cartes

1 J cliente
Cliente entra
J cliente sim
Komerci com WS
sim via Ita Shopline/Komerci pode variar:
Redecard?
em contato habilitado? Loja virtual que j possui Komerci WS (no criar um novo PV):
cerca de 2 horas aps o cadastro dos IPs.
no no
Loja virtual que no possui Komerci WS: priorizao para atendimento
2 3 4 em 5 dias teis aps a criao da solicitao do credenciamento
Credenciamento Credenciamento Cadastro dos IPs (desde que todos os documentos/infos estejam ok).
Redecard PV Komerci WS Ita Shopline
Duas razes para este fluxo:

1) Loja entra em contato com Redecard Loja virtual pode estar usando o Komerci WS e apontando os IPs para outros
Telefone 4004 3298 (capitais) e 0800 7263298 (demais localidades). servidores e uma alterao automtica pode afetar essa operao.
Lojista se identificar como cliente Ita Shopline confirmando que usar Toda alterao cadastral s pode ser efetuada mediante solicitao
o Ita Shopline como plataforma de captura de cartes de crditos. de acordo com a loja virtual.
2) Credenciamento Redecard Para a verso Web Service para o Ita Shopline:

Processo de credenciamento padro Redecard Komerci Web Service. Ligue na Central de Atendimento e solicite o cadastramento Komerci Web Service:
H a possibilidade do estabelecimento no ser credenciado por no passar 4001 4433 (capitais e regies metropolitanas)
em anlise interna (riscos, fraudes, jurdico...). 0800 784 433 (demais localidades)
3) Credenciamento PV Komerci WS Lembrando!

Processo de credenciamento padro Redecard. Para este processo, voc deve estar credenciado na REDECARD (via Ita)
e domiciliado no Ita, e informar ser cliente Ita Shopline na Redecard.
4) Cadastro dos IPs Ita Shopline
Redecard dever cadastrar IP do Ita.
Operao credencia os IPs fornecidos pelo Ita.
O limite mximo so 10 endereos IP por PV: caso o estabelecimento j tenha
cadastrados, ele dever informar quais sero retirados para a insero dos IPs
Ita (caso necessrio).
30
Sobre o certificado digital no site:
No dia 1o de janeiro de 2012, a verso V2 do Certificado Digital ICP-Brasil

(Infraestrutura de Chaves Pblicas Brasileira) entrou em operao.
Nessa verso, as chaves criptogrficas que compem o algoritmo de criptografia

assimtrica (RSA) utilizado pelas Autoridades Certificadoras passaram a ter o
tamanho de 4096 bits. Para os Certificados Digitais de pessoas fsicas e jurdicas,
as chaves so de 2048 bits, em substituio s de 1024 bits. Houve mudana
tambm no algoritmo de resumo criptogrfico (SHA), que passou de SHA-1
(160 bits) para no mnimo SHA-256 (256 bits).
Essa migrao oficializada pela Resoluo no 65, de 9 de julho de 2009,

que trata da necessidade de atualizao dos padres e algoritmos criptogrficos
da ICP-Brasil (DOC-ICP-01.01).
Devem cumprir esse conjunto de diretrizes as Autoridades Certificadoras,

Autoridades de Registro, Prestadores de Servio de Suporte, Empresas
de Auditoria Independente, Laboratrios de Ensaios e Auditoria e outras
entidades credenciadas ou cadastradas na ICP-Brasil, bem como titulares finais
e desenvolvedores de aplicativos que utilizam Certificados Digitais ICP-Brasil.
Clique aqui para visualizar as principais telas do Mdulo Ita Shopline.
31
Parmetros Obrigatrios
Parmetros Descrio Critrios de Consistncia
CodEmp Cdigo da Empresa (Cdigo do Site) Alfanumrico com exatas 26 posies (enviar o cdigo todo em maisculas)
Pedido Nmero do Pedido Numrico com o mximo de 08 posies (99999999) ( * )
Nmeros inteiros de at 8 posies (99999999,99). Os centavos devero ser enviados com 2 casas decimais
Valor Valor Total do Pagamento
(no obrigatrio), utilizando a vrgula como separador
Chave Chave de Criptografia Alfanumrico com exatas 16 posies (enviar a chave toda em maisculas)
NomeSacado Nome do Sacado Alfanumrico com o mximo de 30 posies
Numrico com exatamente 02 posies:

Codigoinscricao Cdigo de inscrio do sacado 01 para CPF
02 para CNPJ
Numrico com 14 posies
NumeroInscricao Nmero de inscrio do sacado
99999999999999
EnderecoSacado Endereo do sacado Alfanumrico com o mximo de 40 posies
BairroSacado Bairro do sacado Alfanumrico com o mximo de 15 posies
CepSacado CEP do sacado Numrico com exatamente 08 posies (99999999)
CidadeSacado Cidade do sacado Alfanumrico com o mximo de 15 posies
EstadoSacado Estado do sacado Alfanumrico com exatamente 02 posies. Somente sero aceitos Estados brasileiros
32
Parmetros Opcionais
Numrico com exatamente 08 posies
DataVencimento Data de vencimento do ttulo
Utilizar o formato ddmmaaaa
UrlRetorna Parte final da URL de Retorno Completa(2) Alfanumrico com o mximo de 60 posies
Espao disponvel para enviar uma linha de mensagem nica por pedido,
ObsAdicional1 Alfanumrico com o mximo de 60 posies
que s ser exibida se o campo Observao contiver o texto 3
Alfanumrico com o mximo de 40 posies
Enviar:
uma linha de mensagem ou
Espao disponvel para enviar uma linha de mensagem nica por pedido
Observacao 1 para apresentar a Mensagem Adicional 1 ou
ou um parmetro indicando qual Mensagem Adicional (1) se quer apresentar
2 para apresentar a Mensagem Adicional 2 ou
3 para apresentar as 3 linhas de Mensagem Adicional
enviadas nos campos ObsAdicional1, ObsAdicional2 e ObsAdicional3
33
Os parmetros que sero utilizados na criptografia para a gerao do Ita Shopline ou

devem seguir todos os critrios aqui especificados para que o ambiente seja acessado M
ensagem Adicional 3 (parmetro 3) Mensagem nica por pedido
com sucesso. que ser exibida na emisso e na reemisso do boleto (se houver) e dever
Existem dois tipos de parmetros: ser enviada nos campos ObsAdicional1, ObsAdicional2 e ObsAdicional3.
Obrigatrios: permitem a gerao de qualquer opo de pagamento
da plataforma de cobrana Ita Shopline. 2. URL de Retorno Completa: o endereo SSL para o qual ser enviado o
Opcionais: referem-se especificamente opo de pagamento boleto bancrio. Retorno On-line do Tipo de Pagamento escolhido pelo comprador nas telas do Ita
No entanto, todos os parmetros devero ser enviados na criptografia apesar de Shopline.
no estarem preenchidos.
Para mais detalhes sobre como execut-lo, vide item 5.1 deste manual.
Veja a seguir as caractersticas especficas de cada parmetro:
A URL de Retorno Completa dever ter no mximo 100 posies, sendo composta
1. Mensagem Adicional: conforme os critrios do parmetro Observacao pela concatenao dos parmetros URL de Retorno e urlRetorna.
(vide tabela anterior), a mensagem adicional exibida no corpo do boleto ser:
U RL de Retorno: endereo principal do servidor seguro de aplicao do site
M
ensagem de 1 linha de 40 posies Mensagem nica por pedido que (SSL) que dever estar registrado em Informaes Cadastrais do Mdulo Ita
ser exibida emisso, na reemisso do boleto (se houver) e tambm estar Shopline no item URL de Retorno;
disponvel no Arquivo Retorno de Cobrana. urlRetorna: parmetro enviado na gerao do Ita Shopline (vide tabela anterior)
ou que indica que o site deseja receber o Retorno On-line do Tipo do Pagamento;
M ensagem Adicional 1 (parmetro 1) Mensagem padro pr-cadastrada Os campos obs1, obs2, obs3 so campos opcionais para envio de observao
que ser exibida na emisso e na reemisso do boleto (se houver) e dever complementar usado na gerao do boleto.
ser registrado na tela de Informaes Cadastrais do Mdulo Ita Shopline
no item Mensagem Adicional 1. Para mais detalhes sobre o acesso funo Informaes Cadastrais do Mdulo Ita
ou Shopline, vide item 2.1. deste manual.
Mensagem Adicional 2 (parmetro 2) Mensagem padro pr-cadastrada
que ser exibida na emisso e na reemisso do boleto (se houver) e dever Os dados que sero utilizados para interpretar o Retorno On-line do Tipo
ser registrado na tela de Informaes Cadastrais do Mdulo Ita Shopline de Pagamento oferecido pelo banco e realizar a Consulta Automtica Situao
no item Mensagem Adicional 2. do Pagamento (sonda) do pedido efetuado em ambiente Ita Shopline deve
obedecer todos os critrios especificados a seguir:
34
Parmetros para Retorno On-line do Tipo de Pagamento

Numrico com 02 posies:
00 para pagamento ainda no escolhido*
01 para pagamento vista (TEF e CDC)
TipPag Tipo de pagamento escolhido pelo comprador
02 para boleto
03 para carto de crdito
* Este tipo de pagamento somente ser exibido na consulta
35

Parmetros para Consulta Situao de Pagamento
Numrico com 01 posio:
Formato Formato do retorno da consulta 0 para formato de pgina HTML para consulta visual
1 para formato XML
00 para pagamento ainda no escolhido*
01 para pagamento vista (TEF e CDC)
TipPag Tipo de pagamento escolhido pelo comprador
02 para boleto
03 para carto de crdito
*Este tipo de pagamento somente ser exibido na consulta
SitPag Situao de pagamento do pedido 03 para pagamento no localizado (consulta fora de prazo ou pedido
no registrado no banco)
04 para boleto emitido com sucesso
05 para pagamento efetuado, aguardando compensao
06 para pagamento no compensado
DtPag Data do pagamento Numrico com 8 posies no formato ddmmaaaa
Nmero de autorizao preenchido somente quando pagamento efetuado com

CodAut Alfanumrico com 6 posies
carto de crdito
NSU da transao preenchido somente quando pagamento efetuado com carto

NumId Alfanumrico com 40 posies
de crdito
Nmero do comprovante de venda preenchido somente quando pagamento

CompVend Alfanumrico com 9 posies
efetuado com carto de crdito, bandeira MasterCard/Diners
TipCart Tipo de carto de crdito escolhido pelo comprador Em branco
36
Para que seja feita a implantao do Ita Shopline, necessrio que exista
um Servidor Web. Depois de instalado, devem ser executados os passos
descritos a seguir.
37
4.1 Usando Itaucripto.dll Para Ambientes Microsoft (Windows NT 4.0 ou superior)
Neste item usamos ASPX (VBScript) com linguagem, porm nada impede
que utilize outra linguagem web.
38
A rota de acesso a este componente no:
Ita Empresas na internet > Recebimentos > Ita Shopline > Instalao
Aps este procedimento, deve-se registrar o componente no equipamento que for

executar a aplicao e chamar o mtodo geraDados.
Os procedimentos para registrar o componente de criptografia so:
1. Menu Iniciar (Start) do WindowsNT

2. Menu Executar (Run)
3. Digitar na caixa Abrir (Open) o comando: regsvr32 c:\....\Itaucripto.dll
39
A pgina ASP que criptografa os dados para envi-los ao Ita Shopline deve observar <FORM action=https://shopline.itau.com.br/shopline/shopline.aspx method=post
as seguintes regras: name=form1 onsubmit=carregabrw() target=SHOPLINE>
<INPUT type=hidden name=DC value=<%= dados %>>
( 1 ) Para chamar a tela de pagamentos, a criptografia dos dados deve seguir exatamente <BR>
a ordem abaixo: <INPUT type=submit name=Shopline value=Ita Shopline>
dados = cripto.geraDados(codEmp, pedido, valor, observacao, chave, nomeSacado, </form>
codigoInscricao, numeroInscricao, enderecoSacado, bairroSacado, cepSacado, ( 5 ) Para o correto funcionamento do Ita Shopline nos browsers: AOL, Netscape e Internet
cidadeSacado, estadoSacado, dataVencimento, urlRetorna, obsAdicional1, obsAdicional2, Explorer (verses 4.X ou superior) a instncia do browser a ser aberto deve possuir
obsAdicional3). o JavaScript abaixo, com as seguintes caractersticas:
( 2 ) Todos os campos so criptografados e enviados pelo lojista, exceto o campo Chave. TOOLBAR = YES
( 3 ) Todos os contratos preenchidos pelo Ita Empresas na internet devero enviar todos MENUBAR=YES
os campos obrigatoriamente. Os contratos preenchidos pela digital somente sero RESIZABLE = YES
obrigatrios Cdigo da Empresa, Chave, Nmero do pedido e Valor. STATUS = NO
Segue o exemplo de utilizao para o caso onde se deseja enviar apenas os campos SCROLLBARS = YES
obrigatrios: WIDTH = 815 (sugesto)
dados = cripto.geraDados(codEmp, pedido, valor, , chave, , , , , , , , , , , , ,) HEIGHT = 575 (sugesto)
( 4 ) A pgina que contiver a URL do Ita dever apresentar as seguintes caractersticas: EXEMPLO:
Formulrio (FORM) com as propriedades: <script language=JavaScript>
method=post 
Obs.: o nome do Input tem que ser DC pois os dados so recebidos a partir de um request </script>
com este nome.
EXEMPLO: A configurao aqui sugerida permite a ideal visualizao da tela do Ita Shopline a ser
gerada sobre a tela do site lojista no computador do cliente comprador do site.
40
Neste item usamos Java (Servlet) como linguagem web.
41

A rota de acesso a este componente :
Ita Empresas na internet > Recebimentos > Ita Shopline > Instalao
No diretrio onde o Java ser compilado, crie um subdiretrio Ita e copie a classe
Itaucripto para este novo subdiretrio.
42

Servlet que criptografa os dados para envi-los ao Ita Shopline deve observar ( 6 ) A pgina que contiver a URL do Ita dever apresentar as seguintes caractersticas:
as seguintes regras: Formulrio (FORM) com as propriedades:
method=post
( 1 ) Inserir no incio do cdigo a linha import Itau.Itaucripto; para que seja importada action=https://shopline.itau.com.br/shopline/shopline.aspx
a classe Itaucripto. Campo (INPUT) para os dados criptografados, com as propriedades:
name=DC
( 2 ) Inserir o cdigo da empresa e a chave de criptografia, em letra maiscula, nos locais type=hidden
indicados. value=Dados Criptografados
( 3 ) Para chamar a tela de pagamentos, a criptografia dos dados deve seguir exatamente Obs.: o nome do Input tem que ser DC pois os dados so recebidos a partir de um request
a ordem abaixo: com este nome.
dados = cripto.geraDados(codEmp, pedido, valor, observacao, chave, nomeSacado, EXEMPLO:

codigoInscricao, numeroInscricao, enderecoSacado, bairroSacado, cepSacado,
cidadeSacado, estadoSacado, dataVencimento, urlRetorna, obsAdicional1, obsAdicional2, out.println(<FORM METHOD=\POST\ ACTION=\https://shopline.itau.com.br/shopline/
obsAdicional3) shopline.aspx\ name=\form\ onsubmit=carregabrw() target=\SHOPLINE\>);
out.println(<INPUT TYPE=\hidden\ NAME=\DC\ VALUE=\ + dados + \>);
( 4 ) Todos os campos so criptografados e enviados pelo lojista, exceto o campo Chave. out.println(<INPUT TYPE=\submit\ name=\Shopline\ value=\Ita Shopline\>);
out.println(</FORM>);
( 5 ) Os campos Cdigo da Empresa, Chave, Nmero do pedido e Valor so
obrigatrios, os demais so opcionais, entretanto, todos os parmetros devem ser enviados ( 7 ) Para o correto funcionamento do Ita Shopline nos browsers: AOL, Netscape e Internet
na criptografia apesar de no estarem preenchidos. Explorer (verses 4.X ou superior) a instncia do browser a ser aberto deve possuir o
JavaScript abaixo, com as seguintes caractersticas:
Segue o exemplo de utilizao para o caso onde se deseja enviar apenas os campos TOOLBAR = YES
obrigatrios: MENUBAR=YES
RESIZABLE = YES
dados = cripto.geraDados(codEmp, pedido, valor, , chave, , , , , , , , , , , , , ) STATUS = NO
43

SCROLLBARS = YES
WIDTH = 815 (sugesto para melhor visualizao)
HEIGHT = 575 (sugesto para melhor visualizao)
EXEMPLO:
out.println(<script language=\JavaScript\>);
out.println();
out.println(</script>);
A configurao aqui sugerida permite a ideal visualizao da tela do Ita Shopline a ser
gerada sobre a tela do site lojista no computador do cliente comprador do site.
( 8 ) Aps a edio, salvar com extenso Java, compil-lo (javac <nome do arquivo>.java)
e coloc-lo no diretrio definido como repositrio de servlets.
44
5. Exemplo de Cdigos
Neste item, usamos ASPX (VBScript) como linguagem, porm nada impede
que utilize outra linguagem web.
45

5.1.1 Envio dos Dados Pgina inicial HTML
<HTML> <TR>
<HEAD> <TD width=25% align=right><B>CEP (99999999):</B></TD>
<TITLE>Exemplo de cdigo HTML</TITLE> <TD><INPUT type=text maxlength=8 size=8 name=cepSacado value=></TD>
</HEAD> </TR>
<BODY> <TR>
<FORM ACTION=Nome da Pgina de Criptografia METHOD=Post NAME=form1> <TD width=25% align=right><B>Cidade:</B></TD>
<CENTER>Entre com os Dados <TD><INPUT type=text maxlength=15 size=15 name=cidadeSacado value=></TD>
<TABLE width=100% border=1 align=center> </TR>
<TR> <TR>
<TD width=25% align=center><B>Pedido (99999999):</B></TD> <TD width=25% align=right><B>Estado:</B></TD>
<TD><INPUT type=text maxlength=8 size=8 name=pedido value=></TD> <TD><INPUT type=text maxlength=2 size=2 name=estadoSacado value=></TD>
</TR> </TR>
<TR> <TR>
<TD width=25% align=center><B>Valor (99999999,99):</B></TD> <TD width=25% align=right><B>Data de Vencimento (ddmmaaaa):</B></TD>
<TD><INPUT type=text maxlength=10 size=10 name=valor value=></TD> <TD><INPUT type=text maxlength=8 size=8 name=dataVencimento value=></TD>
</TR> </TR>
<TR> <TR>
<TD width=25% align=right><B>Observao:</B></TD> <TD width=25% align=right><B>URL retorna:</B></TD>
<TD><INPUT type=text maxlength=40 size=40 name=observacao value=></TD> <TD><INPUT type=text maxlength=60 size=60 name=urlRetorna value=></TD>
</TR> </TR>
<TR> <TR>
<TD width=25% align=right><B>Nome do Sacado:</B></TD> <TD width=25% align=right><B>ObsAdicional1:</B></TD>
<TD><INPUT type=text maxlength=30 size=30 name=nomeSacado value=></TD> <TD><INPUT type=text maxlength=60 size=60 name=ObsAdicional1 value=></TD>
</TR> </TR>
<TR> <TR>
<TD width=25% align=right><B>Cdigo de Inscrio (01 CPF, 02 CNPJ):</B></TD> <TD width=25% align=right><B>ObsAdicional2:</B></TD>
<TD><INPUT type=text maxlength=2 size=2 name=codigoInscricao value=></TD> <TD><INPUT type=text maxlength=60 size=60 name=ObsAdicional2 value=></TD>
</TR> </TR>
<TR> <TR>
<TD width=25% align=right><B>Nmero de Inscrio (CPF, CNPJ):</B></TD> <TD width=25% align=right><B>ObsAdicional3:</B></TD>
<TD><INPUT type=text maxlength=14 size=14 name=numeroInscricao value=></TD> <TD><INPUT type=text maxlength=60 size=60 name=ObsAdicional3 value=></TD>
</TR> </TR>
<TR> </TABLE>
<TD width=25% align=right><B>Endereo do Sacado:</B></TD> </CENTER>
<TD><INPUT type=text maxlength=40 size=40 name=enderecoSacado value=></TD> <BR><BR>
</TR> <INPUT TYPE=submit value=Pagar name=Pagar>
<TR> </FORM>
<TD width=25% align=right><B>Bairro:</B></TD> </BODY>
<TD><INPUT type=text maxlength=15 size=15 name=bairroSacado value=></TD> </HTML>
</TR>
46

5.1.2 Criptografia dos Dados Cdigo ASPX
<HTML> Set cripto = server.createobject(Itaucripto.cripto)

<BODY> dados = cripto.geraDados(codEmp, pedido, valor, observacao, chave, nomeSacado, codigoInscricao,
<CENTER>Nome da Pgina de Criptografia</CENTER> numeroInscricao, enderecoSacado, bairroSacado, cepSacado, cidadeSacado, estadoSacado,
<% dataVencimento, urlRetorna, obsAdicional1, obsAdicional2, obsAdicional3)
dim codEmp, chave, pedido, valor, observacao, nomeSacado, codigoInscricao, enderecoSacado Set cripto = nothing
dim bairroSacado, cepSacado, cidadeSacado, estadoSacado, dataVencimento, urlRetorna, cripto %>
codEmp = J0123456789012345678901234 Coloque aqui o cdigo da empresa <FORM ACTION=https://shopline.itau.com.br/shopline/shopline.aspx method=post

chave = ABCD123456ABCD12 Coloque aqui a chave de criptografia em maiscula name=form1 onsubmit=carregabrw() target=SHOPLINE>
pedido = Request.Form(pedido) obtm o valor do campo pedido <INPUT type=hidden name=DC value=<%= dados %>>
valor = Request.Form(valor) obtm o valor do campo valor <BR>
observacao = Request.Form(observacao) obtm o valor do campo observacao <INPUT type=submit name=Shopline value=Ita Shopline>
nomeSacado = Request.Form(nomeSacado) obtm o valor do campo nomeSacado </form>
codigoInscricao = Request.Form(codigoInscricao) obtm o valor do campo codigoInscricao
numeroInscricao = Request.Form(numeroInscricao) obtm o valor do campo numeroInscricao <script language=JavaScript>
enderecoSacado = Request.Form(enderecoSacado) obtm o valor do campo enderecoSacado 
obsAdicional1 = Request.Form(obsAdicional1) obtm o valor do campo obsAdicional1 </script>
obsAdicional2 = Request.Form(obsAdicional2) obtm o valor do campo obsAdicional2 </BODY>
obsAdicional3 = Request.Form(obsAdicional3) obtm o valor do campo obsAdicional3 </HTML>
47

5.1.3 Retorno do Tipo de Pagamento Cdigo ASPX
O endereo para Retorno do Tipo de Pagamento ser composto da seguinte maneira: EXEMPLO:
HTTPS:// + URL de Retorno Cadastrada + URLRetorna do Pedido + parmetros <%
de retorno criptografados. Inicializa as variveis
dim dados, codEmp, chave, pedido, tipPag, cripto
EXEMPLO:
chave = ABCD123456ABCD12 Coloque aqui a chave de criptografia em maiscula
URL de Retorno cadastrada no Mdulo Ita Shopline = www.minhaloja.com.br
URLretorna passada pelo lojista no pedido em questo = /final/retorno.aspx Recebe valores da pgina anterior
Dados de retorno criptografados=?DC=A345B456F456W456T56J3K678 dados = Request.Form(DC)
Exemplo da chamada URL final: https://www.minhaloja.com.br/final/retorno.aspx?
DC=A345B456F456W456T56J3K678 Set cripto = Server.CreateObject(Itaucripto.cripto)
Decriptografa os dados chamando o mtodo decripto da classe Itaucripto e recebe

A pgina de retorno do pagamento deve receber os dados criptografados e chamar
os dados
o mtodo decripto e, para acessar o contedo de cada campo, necessrio usar
dados = cripto.decripto(dados, chave)
os mtodos que retornam seus contedos: codEmp = cripto.retornaCodEmp()
pedido = cripto.retornaPedido()
retornaCodEmp(), retornaPedido(), retornaTipPag() tipPag = cripto.retornaTipPag()
%>
<html>
<head>
<title> Retorno Online </title>
Cdigo da empresa </head>
CodEmp Alfanumrico de 26 posies
ou cdigo do site
<body>
<h1>Dados recebidos</h1>
Pedido Nmero do pedido Numrico com 8 posies Cdigo da empresa: <%= codEmp %><br>
Pedido: <%= pedido %><br>
Numrico com 02 posies: Tipo de pagamento: <%= tipPag %>
Tipo de pagamento escolhido 01 para pagamento vista (TEF ou CDC) <br>
TipPag
pelo comprador 02 para boleto </body>
03 para carto de crdito </html>
48

5.1.4 Consulta Situao do Pagamento Cdigo ASPX
EXEMPLO: RESULTADO DA CONSULTA EM FORMATO XML

<%
Inicializa as variveis <?xml version=1.0 encoding=ISO-8859-1?>
dim dados <!DOCTYPE consulta [
dim codEmp <!ELEMENT consulta (PARAMETER)>
dim chave <!ELEMENT PARAMETER (PARAM)+>
dim pedido <!ELEMENT PARAM EMPTY>
dim formato <!ATTLIST PARAM ID CDATA #REQUIRED>
dim cripto VALUE CDATA #REQUIRED>
]>
chave = ABCD123456ABCD12 <consulta>
Coloque aqui sua chave de criptografia em maiscula <PARAMETER>
<PARAM ID=CodEmp VALUE=/>
Inicializa valores <PARAM ID=Pedido VALUE=/>
codEmp = J1234567890123456789012345 <PARAM ID=Valor VALUE=/>
Coloque aqui seu cdigo de empresa <PARAM ID=tipPag VALUE=/>
formato = 1 <PARAM ID=sitPag VALUE=/>
Coloque aqui o tipo de retorno desejado: 0 para HTML ou 1 para XML <PARAM ID=dtPag VALUE=/>
<PARAM ID=codAut VALUE=/>
Recebe o pedido <PARAM ID=numId VALUE=/>
pedido = Request.Form(pedido) <PARAM ID=compVend VALUE=/>
<PARAM ID=tipCart VALUE=/>
Set cripto = Server.CreateObject(Itaucripto.cripto) </PARAMETER>
</consulta>
Realiza a criptografia dos dados
dados = cripto.geraConsulta(codEmp, pedido, formato, chave)
set cripto = nothing

%>
<FORM METHOD=POST ACTION=https://shopline.itau.com.br/shopline/consulta.aspx

id=form1 name=form1>
<INPUT TYPE=hidden NAME=DC VALUE=<%= dados %>>
<INPUT TYPE=submit NAME=Shopline BORDER=0 VALUE=Consulta ao
Pagamento>
</FORM>
49

5.1.5 Reemisso do Boleto Cdigo ASPX

valor e ainda no tiver sido pago, considerado uma reemisso.
Sendo assim, deve-se chamar sempre a URL de emisso, ou seja a mesma URL
utilizada para fazer a chamada do site.
50
Neste item usamos Java (Servlet) como linguagem web.
51

5.2.1 Envio dos Dados Pgina Inicial HTML
<HTML> <TR>
<HEAD> <TD width=25% align=right><B>CEP (99999999):</B></TD>
<TITLE>Exemplo de cdigo HTML</TITLE> <TD><INPUT type=text maxlength=8 size=8 name=cepSacado value=></TD>
</HEAD> </TR>
<BODY> <TR>
<FORM ACTION=ServletCriptoShopline METHOD=Post NAME=form1> <TD width=25% align=right><B>Cidade:</B></TD>
<CENTER>Entre com os Dados <TD><INPUT type=text maxlength=15 size=15 name=cidadeSacado value=></TD>
<TR> <TR>
<TD width=25% align=center><B>Pedido (99999999):</B></TD> <TD width=25% align=right><B>Estado:</B></TD>
<TD><INPUT type=text maxlength=8 size=8 name=pedido value=></TD> <TD><INPUT type=text maxlength=2 size=2 name=estadoSacado value=></TD>
</TR> </TR>
<TR> <TR>
<TD width=25% align=center><B>Valor (99999999,99):</B></TD> <TD width=25% align=right><B>Data de Vencimento (ddmmaaaa):</B></TD>
<TD><INPUT type=text maxlength=10 size=10 name=valor value=></TD> <TD><INPUT type=text maxlength=8 size=8 name=dataVencimento value=></TD>
</TR> </TR>
<TR> <TR>
<TD width=25% align=right><B>Observao:</B></TD> <TD width=25% align=right><B>URL retorna:</B></TD>
<TD><INPUT type=text maxlength=40 size=40 name=observacao value=></TD> <TD><INPUT type=text maxlength=60 size=60 name=urlRetorna value=></TD>
</TR> <TR>
<TR> <TD width=25% align=right><B>ObsAdicional1:</B></TD>
<TD width=25% align=right><B>Nome do Sacado:</B></TD> <TD><INPUT type=text maxlength=60 size=60 name=obsAdicional1 value=></TD>
<TD><INPUT type=text maxlength=30 size=30 name=nomeSacado value=></TD> </TR>
</TR> <TR>
<TD width=25% align=right><B>Cdigo de Inscrio (01 CPF, 02 CNPJ):</B></TD> <TD><INPUT type=text maxlength=60 size=60 name=obsAdicional2 value=></TD>
<TD><INPUT type=text maxlength=2 size=2 name=codigoInscricao value=></TD> </TR>
</TR> <TR>
<TD width=25% align=right><B>Nmero de Inscrio (CPF, CNPJ):</B></TD> <TD><INPUT type=text maxlength=60 size=60 name=obsAdicional3 value=></TD>
<TD><INPUT type=text maxlength=14 size=14 name=numeroInscricao value=></TD> </TR>
</TR>
<TR> </TABLE>
<TD width=25% align=right><B>Endereo do Sacado:</B></TD> </CENTER>
<TD><INPUT type=text maxlength=40 size=40 name=enderecoSacado value=></TD> <BR><BR>
</TR> <INPUT TYPE=submit value=Pagar name=Pagar>
<TR> </FORM>
<TD width=25% align=right><B>Bairro:</B></TD> </BODY>
<TD><INPUT type=text maxlength=15 size=15 name=bairroSacado value=></TD> </HTML>
</TR>
52

5.2.2 Criptografia dos Dados Cdigo Java
import java.io.*; public void doPost(HttpServletRequest request, HttpServletResponse response)

import java.text.*; throws ServletException, IOException
import java.util.*; {
import javax.servlet.*; service(request, response);
import javax.servlet.http.*; }
import Itau.Itaucripto; public void init()

{
public class ServletCriptoShopline extends HttpServlet }
{
private String codigoEmpresa; // Cdigo de identificao da empresa public void service(HttpServletRequest request, HttpServletResponse response)
private String chave; // Chave de criptografia da empresa throws ServletException, IOException
{
private String pedido; // Identificao do pedido PrintWriter out = response.getWriter();
private String valor; // Valor do pedido String dados; //Armazena os dados criptografados
private String observacao; // Observaes
private String nomeSacado; // Nome do sacado //Inicializa as variveis
private String codigoInscricao; // Cdigo de Inscrio: 01->CPF, 02->CNPJ codigoEmpresa = J1234567890123456789012345; // <- Coloque aqui seu Cdigo de Empresa (26
private String numeroInscricao; // Nmero de Inscrio: CPF ou CNPJ posies)
private String enderecoSacado; // Endereco do Sacado chave = ABCD123456ABCD12; // <- Coloque aqui sua chave de criptografia (16 posies)
private String bairroSacado; // Bairro do Sacado
private String cepSacado; // Cep do Sacado // Recebe valores da pgina anterior
private String cidadeSacado; // Cidade do sacado pedido = request.getParameter(pedido); // obtm o valor do campo pedido
private String estadoSacado; // Estado do Sacado valor = request.getParameter(valor); // obtm o valor do campo valor
private String dataVencimento; // Vencimento do ttulo observacao = request.getParameter(observacao); // obtm o valor do campo observacao
private String urlRetorna; // URL do retorno nomeSacado = request.getParameter(nomeSacado); // obtm o valor do campo
private String obsAdicional1; // ObsAdicional1 nomeSacado
private String obsAdicional2; // ObsAdicional2 codigoInscricao = request.getParameter(codigoInscricao); // obtm o valor do campo
private String obsAdicional3; // ObsAdicional3 codigoInscricao
numeroInscricao = request.getParameter(numeroInscricao);// obtm o valor do campo
public void destroy() numeroInscricao
{ enderecoSacado = request.getParameter(enderecoSacado); // obtm o valor do campo
} enderecoSacado
bairroSacado = request.getParameter(bairroSacado); // obtm o valor do campo
public void doGet(HttpServletRequest request, HttpServletResponse response) bairroSacado
throws ServletException, IOException cepSacado = request.getParameter(cepSacado); // obtm o valor do campo cepSacado
{ cidadeSacado = request.getParameter(cidadeSacado); // obtm o valor do campo
service(request, response); cidadeSacado
} estadoSacado = request.getParameter(estadoSacado); // obtm o valor do campo
53

5.2.2 Criptografia dos Dados Cdigo Java
estadoSacado out.println(<html>);
dataVencimento = request.getParameter(dataVencimento); // obtm o valor do campo out.println(<body bgcolor=\white\>);
dataVencimento out.println(<head>);
urlRetorna = request.getParameter(urlRetorna); // obtm o valor do campo urlRetorna out.println(<title> Teste Ita Shopline </title>);
obsAdicional1 = request.getParameter(obsAdicional1); // obtm o valor do campo out.println(</head>);
obsAdicional1 out.println(<body>);
obsAdicional2 = request.getParameter(obsAdicional2); // obtm o valor do campo out.println(<h1>Modelo Ita</h1>);
obsAdicional2
obsAdicional3 = request.getParameter(obsAdicional3); // obtm o valor do campo // Constri o formulrio para pagamento com shopline
obsAdicional3 out.println(<FORM METHOD=\POST\ ACTION=\https://shopline.itau.com.br/shopline/
shopline.aspx\ name=\form\ onsubmit=carregabrw() target=\SHOPLINE\>);
//Inicializa a classe de criptografia do Shopline out.println(<INPUT TYPE=\hidden\ NAME=\DC\ VALUE=\ + dados + \>);
Itaucripto cripto = new Itaucripto(); out.println(<INPUT TYPE=\submit\ name=\Shopline\ value=\Ita Shopline\>);
//Criptografa os dados chamando o mtodo geraDados da classe Itaucripto out.println(</FORM>);
dados = cripto.geraDados(codigoEmpresa, out.println(<script language=\JavaScript\>);
pedido, out.println();
numeroInscricao, out.println(</script>);
enderecoSacado, out.println(</body>);
bairroSacado, out.println(</html>);
cepSacado, }
cidadeSacado, }
estadoSacado,
dataVencimento,
urlRetorna,
obsAdicional1,
obsAdicional2,
obsAdicional3
);
//Inicia a construo da pgina de resposta

response.setContentType(text/html);
54

5.2.3 Retorno do Tipo de Pagamento Cdigo Java
O endereo para Retorno do Tipo de Pagamento ser composto da seguinte maneira: public void service(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
HTTPS:// + URL de Retorno Cadastrada + URLRetorna do Pedido + parmetros //Inicializa as variveis
de retorno criptografados. String dados, chave;
String codEmp;
String pedido;
EXEMPLO: String tipPag;
URL de Retorno cadastrada no Mdulo Ita Shopline = www.minhaloja.com.br chave = ABCD123456ABCD12; // <- Coloque aqui sua chave de criptografia (16
URLretorna passada pelo lojista no pedido em questo = /final/retorno.aspx posies)
Dados de retorno criptografados=?DC=A345B456F456W456T56J3K678 //Recebe valores da pgina anterior

dados = request.getParameter(DC);
Exemplo da chamada URL final:
https://www.minhaloja.com.br/final/retorno.aspx?DC=A345B456F456W456T56J3K678 //Inicializa a classe de criptografia do Shopline
Itaucripto cripto = new Itaucripto();
A pgina de retorno do pagamento deve receber os dados criptografados e chamar o
mtodo decripto e, para acessar o contedo de cada campo, necessrio usar os mtodos //Decriptografa os dados chamando o mtodo decripto da classe Itaucripto e recebe os
dados
que retornam seus contedos: dados = cripto.decripto(dados, chave);
codEmp = cripto.retornaCodEmp();
retornaCodEmp(), retornaPedido(), retornaTipPag() pedido = cripto.retornaPedido();
tipPag = cripto.retornaTipPag();
EXEMPLO:
// inicia a construo da pagina de resposta

response.setContentType(text/html);
out.println(<html>);
Cdigo da empresa out.println(<head>);
CodEmp Alfanumrico de 26 posies
ou cdigo do site out.println(<title>Retorno Online</title>);
out.println(</head>);
out.println(<body bgcolor=\white\>);
Pedido Nmero do pedido Numrico com 8 posies out.println(<h1>Retorno Ita</h1>);
out.println(dados + <br>);
Numrico com 02 posies: out.println(codEmp + <br>);
out.println(pedido + <br>);
Tipo de pagamento escolhido 01 para pagamento vista (TEF ou CDC) out.println(tipPag + <br>);
TipPag
pelo comprador 02 para boleto out.println(</body>);
03 para carto de crdito out.println(</html>);
}
55

5.2.4 Consulta Situao do Pagamento Cdigo Java
EXEMPLO: RESULTADO DA CONSULTA EM FORMATO XML

public void service(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException { <?xml version=1.0 encoding=ISO-8859-1?>
<!DOCTYPE consulta [
//Inicializa as variveis <!ELEMENT consulta (PARAMETER)>
String codEmp, pedido, formato, chave; <!ELEMENT PARAMETER (PARAM)+>
String dados; <!ELEMENT PARAM EMPTY>
<!ATTLIST PARAM ID CDATA #REQUIRED>
chave = ABCD123456ABCD12; // <- Coloque aqui sua chave de criptografia (16 VALUE CDATA #REQUIRED>
posies) ]>
<consulta>
//Inicializa valores <PARAMETER>
codEmp = J1234567890123456789012345; // <- Coloque aqui seu cdigo de empresa <PARAM ID=CodEmp VALUE=/>
(26 posies) <PARAM ID=Pedido VALUE=/>
formato = 0 // <- <PARAM ID=Valor VALUE=/>
Coloque aqui o tipo de retorno - 0 ou 1 dependendo do retorno <PARAM ID=tipPag VALUE=/>
<PARAM ID=sitPag VALUE=/>
//Recebe o pedido <PARAM ID=dtPag VALUE=/>
pedido = request.getParameter(pedido); <PARAM ID=codAut VALUE=/>
<PARAM ID=numId VALUE=/>
//Inicializa a classe de criptografia do Shopline <PARAM ID=compVend VALUE=/>
Itaucripto cripto = new Itaucripto(); <PARAM ID=tipCart VALUE=/>
</PARAMETER>
//Realiza a criptografia dos dados </consulta>
dados = cripto.geraConsulta(codigoEmpresa, pedido, formato, chave);
// Monta o form para o envio dos dados a consulta
out.println(<form method=\post\ action=\https://shopline.itau.com.br/shopline/

consulta.aspx\ name=\form\ onsubmit=carregabrw() target=\shopline\>);
out.println(<input type=\hidden\ name=\DC\ value=\ + dados + \>);
out.println(<input type=\submit\ name=\Shopline\ value=\Consulta ao
Pagamento\>);
out.println(</form>);
56

5.2.5 Consulta Situao do Pagamento Cdigo Java

valor e ainda no tiver sido pago, considerado uma reemisso. Sendo assim,
deve-se chamar sempre a URL de emisso, ou seja a mesma URL utilizada para
fazer a chamada do site.
57
5.3 Envio e Criptografia dos Dados Cdigo PHP
A linguagem PHP geralmente utilizada em ambiente UNIX ou LINUX, mas ela </TR>
tambm pode ser utilizada em ambiente Windows. Para que a chamada da classe <TR>
Itaucripto.class ocorra com sucesso no PHP, necessrio que o servidor tenha <TD WIDTH=25% ALIGN=center><B>Cdigo de Inscrio:<B/></TD>
<TD><?php echo $row[codigoInscricao]; ?></TD>
o ambiente Java instalado e que a verso PHP que est instalada no servidor </TR>
tenha suporte a Java. Abaixo segue um exemplo de envio e criptografia dos dados <TR>
utilizando a linguagem PHP para chamada da URL do Ita Shopline utilizando <TD WIDTH=25% ALIGN=center><B>Nmero de Inscrio(CPF/CNPJ):<B/></TD>
a classe ItauCripto.class. <TD><?php echo $row[numeroInscricao]; ?></TD>
</TR>
<HTML> <TR>
<HEAD> <TD WIDTH=25% ALIGN=center><B>Endereo do Sacado:<B/></TD>
<TITLE>Exemplo Ita Shopline</TITLE> <TD><?php echo $row[enderecoSacado]; ?></TD>
</HEAD> </TR>
<TR>
<BODY> <TD WIDTH=25% ALIGN=center><B>Bairro:<B/></TD>
<TD><?php echo $row[bairroSacado]; ?></TD>
<FORM action=https://shopline.itau.com.br/shopline/shopline.aspx method=post </TR>
name=form onsubmit=carregabrw() target=SHOPLINE> <TR>
<CENTER> Dados</CENTER> <TD WIDTH=25% ALIGN=center><B>CEP:<B/></TD>
<TD><?php echo $row[cepSacado]; ?></TD>
<TR> <TR>
<TD WIDTH=25% ALIGN=center><B>Seu Pedido:<B/></TD> <TD WIDTH=25% ALIGN=center><B>Cidade:<B/></TD>
<TD><?php echo $row[pedido]; ?></TD> <TD><?php echo $row[cidadeSacado]; ?></TD>
</TR> </TR>
<TR> <TR>
<TD WIDTH=25% ALIGN=center><B>Total a Pagar:<B/></TD> <TD WIDTH=25% ALIGN=center><B>Estado:<B/></TD>
<TD><?php echo $row[valor]; ?></TD> <TD><?php echo $row[estadoSacado]; ?></TD>
</TR> </TR>
<TR> <TR>
<TD WIDTH=25% ALIGN=center><B>Observao:<B/></TD> <TD WIDTH=25% ALIGN=center><B>Data de Vencimento(ddmmaaaa):<B/></TD>
<TD><?php echo $row[observacao]; ?></TD> <TD><?php echo $row[dataVencimento]; ?></TD>
</TR> </TR>
<TR> <TR>
<TD WIDTH=25% ALIGN=center><B>Nome do Sacado:<B/></TD> <TD WIDTH=25% ALIGN=center><B>URL de Retorno:<B/></TD>
<TD><?php echo $row[nomeSacado]; ?></TD> <TD><?php echo $row[urlRetorna]; ?></TD>
58
5.3 Envio e Criptografia dos Dados Cdigo PHP
</TR> $obsAd2 =;
$obsAd3 =;
<TR>
<TD WIDTH=25% ALIGN=center><B>Observao Adicional1:<B/></TD> function CreateObject()
<TD><?php echo $row[obsAd1]; ?></TD> {
</TR> $COM = new Java(Itau.Itaucripto);
return $COM;
<TR> }
<TD WIDTH=25% ALIGN=center><B>Observao Adicional2:<B/></TD>
<TD><?php echo $row[obsAd2]; ?></TD> $cripto = CreateObject();
</TR> $dados=$cripto->geraDados($codEmp,$pedido,$valor,$observacao,$chave,$n
omeSacado,$codigoInscricao,$numeroInscricao,$enderecoSacado,$bairroSacado,$cepSac
<TR> ado,$cidadeSacado,$estadoSacado,$dataVencimento,$urlRetorna,$obsAd1,$obsAd2,$obs
<TD WIDTH=25% ALIGN=center><B>Observao Adicional3:<B/></TD> Ad3);
<TD><?php echo $row[obsAd3]; ?></TD> // echo <br><br>.$dados;
</TR>
?>
</TABLE>
<CENTER>
<?php <BR><BR>
<INPUT type=hidden name=DC value=<? echo $dados; ?>>
$codEmp =J0012345678901234567890123; <BR>
$pedido =98988812; <INPUT type=submit name=Shopline value=Ita Shopline>
$valor =0,01; </FORM>
$observacao =;
$chave=A3G8E4C19N6W7BPS; <script language=JavaScript>
$nomeSacado =; function carregabrw()
$codigoInscricao =; {
$numeroInscricao =;
$enderecoSacado =; window.open(,SHOPLINE,toolbar=yes,menubar=yes,resizable=yes,status=no,scrollbars=y
$bairroSacado =; es,width=815,height=575);
$cepSacado =; }
$cidadeSacado =; </script>
$estadoSacado =;
$dataVencimento =; <BODY>
$urlRetorna =; </HTML>
$obsAd1 =;
59
6. Auxlio Instalao do Ita Shopline
6.1 Mensagem de Erro de Sistema
Veja a seguir as possveis mensagens de erro de sistema e as providncias a serem tomadas.

Mensagem Providncias
Cep invlido. Verificar o campo de entrada cepSacado na chamada do mdulo Ita Shopline. Este deve ser numrico com 8 posies (99999999).
Cdigo de inscrio invlido. Verificar o campo de entrada CodigoInscricao na chamada do mdulo Ita Shopline. Este deve ser 01 para CPF e 02 para CNPJ.
Cdigo do sacado invlido. Idem ao erro Cdigo de inscrio invlido.
Data de vencimento invlida. Verificar o campo de entrada dataVencimento na chamada do mdulo Ita Shopline. Este deve ser numrico de 8 posies no formato DDMMAAAA.
Erro 9 - contate o Atendimento Cese. Contate o atendimento Cese no tel: 0 XX (11) 3019 4828, informando seu CNPJ, o nome de site e solicite a validao de seu contrato.
Erro na decriptografia dos dados. Erro na decriptografia tente novamente.
Formato invlido. Idem ao erro Nmero do pedido no numrico.
Nmero de inscrio invlido. Verificar o campo de entrada NumeroInscricao na chamada do mdulo Ita Shopline. Este deve ser numrico com 14 posies (99999999999999).
Nmero do pedido invlido. Verificar a consistncia do campo de entrada pedido na chamada do mdulo Ita Shopline. Este deve ser numrico com 8 posies (99999999).
Nmero do pedido no numrico. Verificar a consistncia do campo de entrada pedido na chamada do mdulo Ita Shopline. Este deve ser numrico com 8 posies (99999999).
Tamanho da chave diferente

Verificar o campo de entrada Chave na chamada do mdulo Ita Shopline.
de 16 posies.
Tamanho do cdigo da empresa diferente
Verificar o campo de entrada CodEmp na chamada do mdulo Ita Shopline.
de 26 posies.
Valor da compra deve possuir no mximo 8 Verificar a consistncia do campo de entrada valor na chamada do mdulo Ita Shopline. Este deve ser numrico com 10 posies,
posies antes da vrgula. sendo 8 casas inteiras e 2 casas decimais, separadas obrigatoriamente por vrgula (99999999,99)
Verificar a consistncia do campo de entrada valor na chamada do mdulo Ita Shopline. Este deve ser numrico com 10 posies,
Valor da compra invlido.
sendo 8 casas inteiras e 2 casas decimais, separadas obrigatoriamente por vrgula (99999999,99)
Valor da compra no numrico.
Valor decimal da compra deve possuir Verificar a consistncia do campo de entrada valor na chamada do mdulo Ita Shopline. Este deve ser numrico com 10 posies,
2 posies aps a vrgula. sendo 8 casas inteiras e 2 casas decimais, separadas obrigatoriamente por vrgula (99999999,99)
Valor decimal no numrico.
60
A. Telas referentes ao Mdulo Ita Shopline
Veja a seguir o passo a passo da configurao da conta-corrente de seu site

para uso do Ita Shopline:
Tela do Menu Cobrana Tela de Criao da Chave
61
Tela de Criao da Chave Tela de Informaes Cadastrais
Ao acessar a funo pela primeira vez, ser necessrio configurar um dos cdigos
de habilitao de seu site, criando sua Chave de Criptografia conforme a regra
de formao disponvel na tela.
Na sequncia, consulte e/ou atualize as informaes cadastrais de seu site e copie a Chave
de Criptografia recm-criada e o Cdigo de Site fornecido pelo banco para posteriormente
inform-los ao responsvel pela instalao do Ita Shopline em seu site.
62
Tela de Regra da Chave Tela da Mensagem Ps-Validao das Informaes Cadastrais
Clique aqui para voltar ao item 2.1. deste manual tcnico.
63
B. Tela do Ambiente de Teste do Ita Shopline:
Tela de Emisso do Boleto em Ambiente de Teste:
64
B. Tela do Ambiente de Teste do Ita Shopline:
Tela de Emisso do Boleto em Ambiente de Teste: No campo cedente deve aparecer o nome do site em questo, assim como
os demais dados enviados devero aparecer nos outros campos. Caso haja
algum problema com emisso de parmetros ou algum outro problema,
uma mensagem de inconsistncia vai ser exibida na tela de emisso.
Ateno: o endereo do Ambiente de Teste do produto no dever ser apresentado

aos compradores do site como forma de acesso ao meio de pagamento
Ita Shopline, pois nele no possvel efetuar operao alguma.
Esta URL apenas para verificar se houve sucesso no envio dos dados.
Esta a tela de emisso do boleto aps o acesso URL https://shopline.itau.com.

br/shopline/emissao_teste.asp, acionada pelo prprio desenvolvedor do site no
momento da instalao do Ita Shopline.
Se a tela de emisso do boleto acima foi exibida, os parmetros foram enviados

corretamente pela loja virtual.
65
C. Telas principais da Plataforma Ita Shopline:
Tela Inicial do Ita Shopline: A tela inicial do Ita Shopline apresenta todas as opes de pagamento
habilitadas para o site e dispostas da seguinte maneira: primeiro as opes
que sero acessadas em ambiente seguro Ita 30 horas, portanto, para acess-
las o comprador do site dever possuir seus dados de agncia, conta-corrente,
senha eletrnica e senha de carto junto ao banco. Em segundo lugar, a opo de
pagamento disponvel a todos os clientes do site que so carto de crdito
e boleto bancrio.
Se o comprador do site quiser acessar as opes disponveis para Clientes com

Acesso ao Ita 30 horas dever digitar seus dados de acesso ao Ita 30 horas
aps a escolha de vista ou Parcelado. Se o cliente escolher a opo Parcelado
e o login do comprador no tiver crdito pr-aprovado junto ao banco, esta opo
no aparecer para ele na segunda tela, mesmo que o site aceite esta forma
de pagamento, ser exibida a forma de pagamento vista.
A partir daqui, o comprador navegar por telas especficas de cada uma das opes
de pagamento possveis at chegar ao comprovante de pagamento de sua
transao que apresentado para as opes: pagamento vista por transferncia,
parcelado por Credirio Automtico Ita e carto de crdito. Se escolher a opo
boleto bancrio, ir visualiz-lo em sua tela e poder imprimi-lo ou pag-lo pelo
Ita 30 horas ou como preferir (internet banking, caixa eletrnico ou agncia)
Esta tela gerada aps o correto acesso URL https://shopline.itau.com. respeitando as regras.
br/shopline/shopline.aspx, acionada pelo comprador no ambiente do site.
Neste momento o banco recebeu corretamente os parmetros necessrios Se o comprador do site quiser acessar a opo disponvel para Clientes sem
criptografados pelo site. Acesso ao Ita 30 horas imediatamente visualizar, na tela de seu computador,
o boleto bancrio do Ita Shopline, gerado pelo banco sob o registro na carteira
No campo onde est escrito LOJA VIRTUAL SIMULADA aparecer o NOME DO de cobrana 176. Este boleto j estar totalmente preenchido e apresentar,
SITE cadastrado no sistema do produto poca da contratao. Para conferir seu alm do valor da compra e do no do pedido j citados, todos os campos adicionais
cadastro, basta acessar a funo Informaes Cadastrais do Mdulo Ita Shopline enviados pelo site (conforme instrues do item 4.1 deste manual).
acessado via Ita Empresas na internet. Clique aqui para voltar ao item 2.2. deste manual tcnico.
66
D. Tela do boleto bancrio do Ita Shopline:
A tela do boleto bancrio emitido pela primeira vez na Plataforma de Cobrana Ita
Shopline, seja pelo caminho de Clientes com Acesso ao Ita 30 horas ou pelo caminho
de Clientes sem Conta no Ita, exatamente igual tela do boleto reemitido.
67
E. Telas de exemplo da consulta de operaes do Mdulo Ita Shopline:
Para conhecer o Mdulo Ita Shopline, acesse o Ita Empresas na internet

na conta-corrente do site e siga a rota: Cobrana > Ita Shopline >
Consulta de Operaes:
Ita Empresas na internet: Recebimentos > Ita Shopline:
Clique aqui para voltar ao item 2.5.1. deste manual tcnico.
68
F. Telas de exemplo do Arquivo Retorno de Cobrana:
Lembramos que para programar a leitura do Arquivo Retorno e integr-lo

ao sistema de conciliao bancria de sua empresa, necessrio obter o Manual
de Intercmbio de Arquivos que especifica todos os campos que sero informados
no Arquivo Retorno de Cobrana. Para conhecer o layout da Cobrana Ita, acesse
a conta-corrente pelo Ita Empresas na internet e siga a rota: Produtos e Servios >
Download Center > Cobrana Manual de Intercmbio de Arquivos.
69
Home ndice Voltar
G. Tela de exemplo da Consulta Automtica Situao do Pagamento (sonda):
Retorno da Consulta em em XML:
Retorno da Consulta em HTML:
70

Manual Tecnico ItauShopline PDF

Hochgeladen von

Dokumentinformationen

Originaltitel

Copyright

Verfügbare Formate

Dieses Dokument teilen

Dokument teilen oder einbetten

Freigabeoptionen

Stufen Sie dieses Dokument als nützlich ein?

Sind diese Inhalte unangemessen?

Copyright:

Verfügbare Formate

Manual Tecnico ItauShopline PDF

Hochgeladen von

Copyright:

Verfügbare Formate

Ita Shopline

Guia de Identidade Visual

Confira os principais benefcios para sua empresa:

Guia de Identidade Visual

Identidade visual Ita Shopline

Ita Shopline | Dbito em conta e financiamento

Ita Shopline | Boleto bancrio

Ita Shopline | Carto de crdito

Ita Shopline | Aplicao em diferentes formas

Ita Shopline | Usos incorretos - cenrios de/para

Identidade visual Ita Shopline

Atente para o uso correto

O boleto bancrio uma opo para clientes

A opo de carto de crdito vale para clientes

O boto formas de pagamento Ita um

GIF animado que mostra todas as opes

Manual Ita Empresas dezembro 2012 DimaiDesign

Ita Shopline | Dbito em conta e financiamento

A regra para este cone o uso x R 255 G 204 B 0

No cortar a marca. No trocar a cor de

Manual Ita Empresas dezembro 2012 DimaiDesign

Ita Shopline | Boleto bancrio

No aplique efeitos no cone.

Manual Ita Empresas dezembro 2012 DimaiDesign

Ita Shopline | Carto de crdito

Como referncia, a marca No altere os arquivos de marca recebidos.

Manual Ita Empresas dezembro 2012 DimaiDesign

Ita Shopline | Aplicao em diferentes formas

uma delas, dependendo da

Ao lado, exemplos de modos

Para mais detalhes, consulte

Em alguns sites, a diagramao

Manual Ita Empresas dezembro 2012 DimaiDesign

Ita Shopline | Usos incorretos - cenrios de/para

Manual Ita Empresas dezembro 2012 DimaiDesign

Para isso, existem algumas

O formato do GIF foi retirado da curva do

shape Ita. Use o GIF sempre em laranja

Manual Ita Empresas dezembro 2012 DimaiDesign

Para isso, ele dividido

Ao clicar no GIF animado,

Manual Ita Empresas dezembro 2012 DimaiDesign

Manual Tcnico do Desenvolvedor

1. Informaes Gerais 5. Exemplo de Cdigos

O Ita Shopline uma plataforma completa de meio de recebimento on-line

Ao vender produtos ou servios pela internet e disponibilizar o Ita Shopline

As opes de pagamento que atualmente compem a plataforma Ita Shopline so:

Dbito em conta - carteira de cobrana 178;

1.1 Utilizao do Ita Shopline

Para identificar corretamente a forma de pagamento Ita Shopline oferecida

1.2 Configurao do Ita Shopline

no Mdulo Ita Shopline que o responsvel pelo site cadastra e consulta

As opes de pagamento que compem a configurao do Ita Shopline so:

1.3 Instalao do Ita Shopline

Para instalar o Ita Shopline, deve-se inicialmente registrar o componente

Desta forma, quando o Ita Shopline selecionado no ambiente do lojista como

O Ita Shopline disponibiliza aos lojistas j cadastrados diversas facilidades para

2.1 Mdulo Ita Shopline

Todas as informaes cadastrais do site lojista esto disponveis para consulta

Nesta funo encontram-se os Cdigos de Habilitao do site para uso do produto

Os Cdigos de Habilitao devero ser informados ao responsvel pela instalao

Ateno: qualquer informao alterada neste ambiente estar disponvel

2.1 Mdulo Ita Shopline