Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva...

70
Itaú Shopline • Guia de Identidade Visual • Manual Técnico do Desenvolvedor

Transcript of Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva...

Page 1: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

Itaú Shopline• Guia de Identidade Visual

• Manual Técnico do Desenvolvedor

Page 2: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

2

Introdução

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 não clientes Itaú.

Confira os principais benefícios para sua empresa:

•Praticidade,segurançaecontrole:contrataçãoeinstalaçãopelainternet,comgestãocompleta dos pagamentos pelo Itaú Empresas na internet;

•Suaempresaficadisponível24horaspordia,7diasporsemana;

•Aumentasuarelaçãodeclientespotenciais:atendeclientesItaú,nãocorrentistaseatéquemnãopossui conta bancária;

•Maispossibilidadesparaseusclientes–pagamentoatravésdequalquercartãodecrédito:MasterCard®,Visa, HipercardeDiners,débitoemconta,boletobancáriooufinanciamento.

NesteManualTécnicodoDesenvolvedorItaúShoplinevocêencontraasdiretrizesparaaplicareimplementaroproduto.NeletambémconstaumguiadeidentidadevisualcomtodososelementosgráficosdoShopline.

AvançarVoltarHome

Page 3: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

Guia de Identidade Visual

AvançarVoltarÍndiceHome

Page 4: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

Identidade visual Itaú Shopline

ItaúShopline|Débitoemcontaefinanciamento

Itaú Shopline | Boleto bancário

ItaúShopline|Cartãodecrédito

ItaúShopline|Aplicaçãoemdiferentesformas

Itaú Shopline | Usos incorretos - cenários de/para

AvançarVoltarHomeÍndice

4

Page 5: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

Manual Itaú Empresas dezembro2012©201

0Ita

úUniba

ncoHolding

S.A

.

DimaiDesign

OItaúShoplineéumaplataforma de meios de pagamentos que oferece asopçõesdedébitoemconta,financiamento,boletobancárioecartãodecréditoaos compradores do site da sua empresa.

Atenteparaousocorretodos ícones novos para Itaú Shopline. E sempre utilizeosarquivosfornecidospelo Itaú Unibanco.

Identidade visual Itaú Shopline

Nomenclatura Arquivoaserusado Definição

Mídia

débitoemconta

financiamento

boleto bancário

cartõesdecrédito

formas de pagamento Itaú

Odébitoemcontaéumaopçãoparacorrentistas do Itaú e deve ser sempre representado pela marca Itaú sobre o fundo laranja.

Ofinanciamentoéumaopçãoparacorrentistasdo Itaú e deve ser sempre representado pela marca Itaú sobre o fundo laranja.

Oboletobancárioéumaopçãoparaclientese não clientes do banco Itaú e pode ser representadopeloíconeaolado,quetemaimagem de um código de barras.

Aopçãodecartãodecréditovaleparaclientese não clientes Itaú e deve apresentar as marcas dasbandeirasquepoderãoserutilizadasparao pagamento.

ObotãoformasdepagamentoItaúéum GIFanimadoquemostratodasasopções de pagamento possíveis para o consumidor. Ele direciona o usuário para uma página Itaú onde deve ser confirmada a forma de pagamento.

5

AvançarVoltarÍndiceHome

Page 6: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

Manual Itaú Empresas dezembro2012©201

0Ita

úUniba

ncoHolding

S.A

.

DimaiDesign

O ícone da marca Itaú será usado para representar dois meiosdepagamento,débitoem conta e financiamento.

Aregraparaesteíconeéousoda marca Itaú sobre o fundo laranja,preferencialmentenaformaquadrada:130x130px(parausoemoutrasformas,verificarpág.4).

Sempre use o arquivo fornecido pelo Itaú Unibanco.

ItaúShopline|Débitoemcontaefinanciamento

Arelaçãoindicadaacimadefineaárea de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

x

x/2

x/2

R238G114B3

R0G51B153

R255G204B0Não desrespeitar a área mínimadeproteção.

Nãoutilizarnenhumadasversõesda marca Shopline no checkout.

Não usar a marca fora do fundo laranja.

Não usar o nome fora da forma original.

Não cortar a marca.

Não inclinar ou distorcer a marca.

Não aplicar efeitos à marca.

Não trocar a cor de fundo da marca.

Importante:

6

AvançarVoltarÍndiceHome

Page 7: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

Manual Itaú Empresas dezembro2012©201

0Ita

úUniba

ncoHolding

S.A

.

DimaiDesign

Paraidentificaropagamentoporboletobancário,sempreuseoíconeacimarespeitandosuaproporçãoenãofazendousoindevidodesuaaplicação.

R147G149B152

O ícone de boleto será usado para representar o pagamento feitoatravésdoboletobancário.

Sua largura em formato preferencialéde140px. Esuacorécinzaconformeespecificado pelo código ao lado.

Sempre use o arquivo fornecido pelo Itaú Unibanco.

Nãoexagerenotamanhodo ícone.

Não troque a cor do ícone.

Não aplique efeitos no ícone.

Nãodistorçaoícone.

Itaú Shopline | Boleto bancário

Importante:

7

AvançarVoltarÍndiceHome

Page 8: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

Manual Itaú Empresas dezembro2012©201

0Ita

úUniba

ncoHolding

S.A

.

DimaiDesign

Paracartõesdecrédito,apresentarasbandeirasrespeitandoáreasdeproteçãoeconvivência.Semprequepossível,utilizeoformatopreferencialdamarcaHipercard como base de referência.

Paraaidentificaçãodepagamentoatravésdecartõesdecrédito,aregraéidentificarquaiscartõessãoaceitosatravésdesuasrespectivas marcas.

Asmarcasdoscartõesestãodisponíveis no Itaú Empresas na internet.

Comoreferência,amarcado Hipercard deve ser usada em formato preferencial de 220x130px.

ItaúShopline|Cartãodecrédito

Importante:

Não use formatos desproporcionais entre as marcasdestacandooupriorizandoalgumadelas.

Não altere os arquivos de marca recebidos.

Não aplique efeitos nos ícones.

8

AvançarVoltarÍndiceHome

Page 9: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

Manual Itaú Empresas dezembro2012©201

0Ita

úUniba

ncoHolding

S.A

.

DimaiDesign

O formato em que as marcas são aplicadas pode ser adaptado,respeitandoaproteçãomínimadecadaumadelas,dependendodadiagramaçãodosite.

Asmarcasdevemserpadronizadas,semprequepossível,respeitandosuasregras de convivência.

Aolado,exemplosdemodoscorretosdeadaptaçãonosformatos da marca Itaú.

Paramaisdetalhes,consulteoúltimoGuiadaMarca.

Emalgunssites,adiagramaçãoindicaumaaplicaçãoquedifereda preferencial quadrada. Nesses casos,respeiteaáreadeproteçãoda marca Itaú.

Ex.:aplicaçãoemformaquadrada Ex.:aplicaçãoemformaretangular Ex.:aplicaçãoemformaredonda

FORMASDEPAGAMENTO FORMASDEPAGAMENTO FORMASDEPAGAMENTO

Boleto bancário Boleto bancário Boleto bancário

Cartãodecrédito Cartãodecrédito Cartãodecrédito

Débitoemconta

Financiamento

Débitoemconta Débitoemconta

FinanciamentoFinanciamento

ItaúShopline|Aplicaçãoemdiferentesformas

9

AvançarVoltarÍndiceHome

Page 10: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

Manual Itaú Empresas dezembro2012©201

0Ita

úUniba

ncoHolding

S.A

.

DimaiDesign

Não descreva as formas de pagamento fora do padrão de nomenclatura e use os ícones relacionados a cada uma delas. Utilizesomenteosarquivosfornecidospelo Itaú Unibanco.

Nãouseíconesgenéricosnãofornecidospelo Itaú Unibanco.

Itaú Shopline | Usos incorretos - cenários de/para

Não use outro botão de forma de pagamento que não seja o entregue pelo Itaú Unibanco.

Nuncautilize“ItaúShopline”,useanomenclaturacorretaparacadaserviço,conforme descrito neste manual.

De:

Para:

10

AvançarVoltarÍndiceHome

Page 11: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

Manual Itaú Empresas dezembro2012©201

0Ita

úUniba

ncoHolding

S.A

.

DimaiDesign

O GIF animado tem formato preferencialde200x93px. Eleécompostoporelementos que não podem seralterados,mantendoasmesmas características em todos os sites em que for encontrado. O GIF e seus elementos não podem ser redesenhados.

Paraisso,existemalgumasregras que devem ser seguidas.

GIF animado

O formato do GIF foi retirado da curva do shape Itaú. Use o GIF sempre em laranja com fundo animado.

NãodistorçaoGIF.

Não mude a cor do fundo.

Não altere os elementos.

Importante:

11

AvançarVoltarÍndiceHome

Page 12: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

Manual Itaú Empresas dezembro2012©201

0Ita

úUniba

ncoHolding

S.A

.

DimaiDesign

O GIF animado deve mostrartodasasopçõesdepagamento possíveis para o consumidor.

Paraisso,eleédividido em fases que direcionam o cliente para o tipo de pagamento escolhido.

AoclicarnoGIFanimado,ousuárioédirecionadopara uma página onde ele deve confirmar a forma de pagamento. Essa página éorganizadaseguindoasorientaçõesdoGuiadaMarcaItaú,comaaplicaçãodosnovos ícones.

GIF animado

Fase1 Fase4

Fase 2 Fase 5

Fase3 Fase 6

12

AvançarVoltarÍndiceHome

Page 13: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

Manual Técnico do Desenvolvedor

AvançarVoltarÍndiceHome

Page 14: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

14

Índice

1. Informações Gerais 1.1 UtilizaçãodoItaúShopline 1.2 ConfiguraçãodoItaúShopline 1.3 InstalaçãodoItaúShopline 2. Serviços do Itaú Shopline 2.1 MóduloItaúShopline 2.1.1 InformaçõesCadastraisdoSiteLojista 2.1.2 InstruçõesdeImplantaçãodoProduto 2.2 GeraçãodoItaúShopline URLPrincipaldeAcessoaoProduto 2.3 ReemissãodeBoletos 2.4 RetornoOn-linedoTipodePagamento 2.5 ConsultadeOperaçõesRealizadasviaItaúShopline 2.5.1 ConsultadeOperaçõesdoMóduloItaúShopline 2.5.2 ArquivoRetornodeCobrança 2.5.3 ConsultaAutomáticaàSituaçãodoPagamento(sonda) 2.6 ItaúShopline–Multibandeira 3. Layout dos Campos 3.1 ParâmetroseCritériosdeConsistências 4. Informações Técnicas 4.1 UsandoItaucripto.dll-ParaAmbientesMicrosoft 4.1.1 Passo1:Criptografia 4.1.2 Passo2:ChamadaàTeladoItaúShopline 4.2 ParaAmbientesUnixouLinux 4.2.1 Passo1:Criptografia 4.2.2 Passo2:ChamadaàTeladoItaúShopline

5. Exemplo de Códigos 5.1 UsandoItaucripto.dll–ParaAmbientesMicrosoft 5.1.1 EnviodosDados–PáginaInicialHTML 5.1.2 CriptografiadosDados–CódigoASPX 5.1.3 RetornodoTipodePagamento–CódigoASPX 5.1.4 ConsultaàSituaçãodoPagamento–CódigoASPX 5.1.5 ReemissãodoBoleto–CódigoASPX 5.2 ParaAmbientesUnixouLinux 5.2.1 EnviodosDados–PáginaInicialHTML 5.2.2 CriptografiadosDados–CódigoJava 5.2.3 RetornodoTipodePagamento–CódigoJava 5.2.4 ConsultaàSituaçãodoPagamento–CódigoJava 5.2.5 ConsultaàSituaçãodoPagamento–CódigoJava 5.3 EnvioeCriptografiadosDados–CódigoPHP

6. Auxílio à Instalação do Itaú Shopline 6.1 MensagemdeErrodeSistema

Anexos Demonstrativos

AvançarVoltarHome

Page 15: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

15

AvançarVoltarÍndiceHome1. Informações Gerais

O Itaú Shoplineéumaplataformacompletademeioderecebimentoon-line para clientes Itaú Empresas que querem vender pela internet.

Eparaosconsumidoreséumaformarápidaeseguraparacomprarpelainternet.

AovenderprodutosouserviçospelainternetedisponibilizaroItaú Shopline comomeiodepagamento,seusiteiráproporcionaraseusclientesumamaneirasimples,práticaeseguradeefetuarpagamentos,tendoaoportunidadedeescolher, entreasopçõesoferecidaspeloItaú,amaisconveniente.

AsopçõesdepagamentoqueatualmentecompõemaplataformaItaú Shopline são:

• Débitoemconta-carteiradecobrança178; • Financiamento-carteiradecobrança178; • Cartõesdecrédito(MasterCard®,Visa,HipercardeDiners)-Filiadoà

Redecard; • Boletobancário-carteiradecobrança176. AsduasprimeirasopçõessãoexclusivasparaclientesItaúqueacessaremestemeiodepagamentonositedolojista,ocartãodecrédito(MasterCard®,Visa,Hipercard eDiners)eoboletoatenderãoànecessidadedeliquidaçãofinanceiradetodos oscompradoresdosite.Parahabilitaraopçãodecobrançaporcartãodecrédito énecessárioqueositelojistaestejafiliadoàRedecard,cadastradonoKomerciWebServiceetercadastrojuntoaobancoItaúcomseucódigodefiliação.

O Itaú ShoplineéaúnicaformadecobrançadobancoItaúqueintegradiversasopçõesdepagamentonumasóplataformaeprocuradarênfaseparaaliquidaçãoon-line,agilizandooprocessodecomprapelainternet.

Page 16: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

16

AvançarVoltarÍndiceHome

1.1UtilizaçãodoItaúShopline

Independentementedomodelodenegóciodecadasite,istoé,seoprocesso decompraocorreemsequênciaatéchegaraoresumodacompraouseositeenvia aseusclientesumafaturapore-mail,haveráumdeterminadomomentoemque o Itaú Shopline será selecionado pelo comprador como forma de pagamento e,apartirdessemomento,aplataformadecobrançadoItaúseráapresentada aousuáriofinaldosite,querealizaráaliquidaçãofinanceiradopagamento em ambiente seguro Itaú.

Omodelodenegóciodositelojista(cedente)nãoinvalidaofuncionamento dasoluçãodecobrançaoferecidapeloItaú Shopline,poisoúnicopré-requisitonecessárioéhaverummomentoemqueoservidordositeenvieaoservidor dobancoosparâmetrosdecobrançaaseremusadosparaconcretizaraliquidaçãofinanceira solicitada.

ParaidentificarcorretamenteaformadepagamentoItaú Shopline oferecida emseusite,utilizesempreanomenclatura“Formas de Pagamento Itaú”e, casoprecise,disponibilizaremosumbannerparadivulgaçãodaplataforma. NestematerialconstamtodasasorientaçõessobreacorretautilizaçãodamarcaItaú no site da loja virtual.

AoacessaroItaú Shopline,oclientenavegapelastelasdasopçõeseefetua seupagamento,selecionandoumadasopçõesdisponíveis.Olojistaéavisadosobreafinalizaçãodacompraeaopçãodepagamentoescolhidapelocliente, emambienteItaú,atravésdoRetornoOn-linedoTipodePagamento. Porsegurança,deveviratéoambienteItaúparaconfirmarasituaçãodepagamentodopedidoemquestão.Paramaisdetalhes,videitem2.5.destemanual.

1. Informações Gerais

AconsultadeinformaçõesreferentesaospagamentosefetuadosviaItaú Shopline édisponibilizadapelobancoItaúdetrêsmaneirasdistintas:ConsultadeOperações doMóduloItaúShopline,ArquivoRetornodeCobrançaeConsultaAutomática daSituaçãodoPagamento(Sonda).

Aempresaescolheaconsultaquemaislheconvém.Paramaisdetalhessobreessasconsultas,vejaoitem2.5.destemanual.

Emcadaumadasconsultasdisponíveis,obancoinformaráaopçãodepagamentoescolhidaparaopedidoeconfirmarásuasituaçãodepagamentoemfunção daaçãodepagamentodocomprador,doprazodefloatingdecréditonegociadoparaascarteirasdecobrançaedoprazodecompensaçãodaformadeliquidaçãodopedido,determinando,assim,diferentes“status”paraacompanhamento.

Page 17: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

17

AvançarVoltarÍndiceHome

1.2ConfiguraçãodoItaúShopline

Paraconfiguraro Itaú Shopline,énecessárioqueositeestejavinculadoaumaconta-correntepessoajurídicanobancoItaúcom:cadastronascarteiras176 e178daCobrançaEletrônicaItaú,acessoaoItaúEmpresasnainternetecontratoformalizadoparautilizaroItaúShopline.

Paracontratar*oItaú Shopline,oclientedeveacessar:ItaúEmpresasnainternet>Recebimentos>ItaúShopline>Contratar,ouatravésdoresponsávelpela conta-correntedosite,formalizandoapropostadecontrataçãodoproduto juntoaoItaúEmpresasnainternet.Assimqueapropostaéaprovada, éencaminhadaumaconfirmaçãopore-mailindicandooacessoàsinstruções decadastroeinstruçõesdeimplantaçãodoprodutoemseusite.

*Na contratação, o nome do site não pode conter caracteres especiais. Ex: @, #, $, &, Ç, Ã etc.

TodasasInformações Cadastrais do site e as Instruções de Implantação parausodoprodutosãodisponibilizadasaoresponsávelpelaconta-corrente do site no Módulo Itaú Shopline acessado via Itaú Empresas na internet dentro daopção–Instalação–Manuais/Banners/BotõeseComponentes.

É no Módulo Itaú Shopline que o responsável pelo site cadastra e consulta seusCódigosdeHabilitaçãoparausodoItaúShopline(CódigodoSiteeChave deCriptografia)econfiguraosdemaiscamposnecessáriosàgeraçãodoproduto.

AsopçõesdepagamentoquecompõemaconfiguraçãodoItaú Shopline são: débitoemconta,financiamento,cartãodecrédito(MasterCard®,Visa,Hipercard eDiners)eboletobancário.

1. Informações Gerais

Acobrançaporcartãodecrédito(MasterCard®,Visa,HipercardeDiners)viaItaúShopline só estará disponível aos compradores de seu site se houver a inclusão docódigodefiliaçãodaRedecardKomerciWebServicenaopçãoInformaçõesCadastraisdoItaúShoplinenoItaúEmpresasnainternet,filiadoaobancoItaú, eaRedecardestivercomoIPdoItaúShoplinenoseucadastro(favorinformar àRedecardqueéclienteItaúShoplineparaqueelesfaçamessainclusãodeIP).

AtravésdoMódulo Itaú Shoplineépossívelconfigurar:

• OcódigodefiliaçãoRedecardKomerci; • Algunsparâmetrosadicionaisrelativosàopçãoboletobancário,taiscomo: prazopadrãodevencimento,nomedocedente(site)noboleto e mensagens adicionais; • Endereçoprincipaldoservidorsegurodeseusite(SSL)parausodafunção

RetornoOn-line/ConsultaAutomática.

Page 18: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

18

AvançarVoltarÍndiceHome

1.3InstalaçãodoItaúShopline

ParainstalaroItaú Shopline,deve-seinicialmenteregistrarocomponenteItaucripto.dllnoequipamentoqueexecutaráaaplicaçãodosite.

Apósesteprocedimento,deve-sedesenvolverumapáginadinâmicaqueexecuteachamadaaométodogeraDadosparaefetuaracriptografiadosdadosnecessários àgeraçãodoItaúShopline.EssesdadosdevemserarmazenadosnavariávelDC eenviadosparaaURLPrincipaldeAcessoaoItaúShopline.

Destaforma,quandooItaú Shoplineéselecionadonoambientedolojistacomomeiodepagamentoparafinalizaçãodacompra,osdadosdopedidodevemsercriptografadoseenviadospelositelojistaparaaURLPrincipaldoItaú Shopline,conformeoscritériosdeterminadosnestemanual(itens2,3e4).Umanovainstânciadebrowseréaberta,semfecharajaneladositedalojavirtualeoclientecompradorétransferidoparaositedoItaú Shopline,jáemambienteseguroItaú,onde navegará conforme suas escolhas.

1. Informações Gerais

Page 19: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

19

AvançarVoltarÍndiceHome

OItaúShoplinedisponibilizaaoslojistasjácadastradosdiversasfacilidadesparautilizaçãoeconfiguraçãodoproduto,teste,instalaçãoeconsultadeinformaçõessobre o pagamento dos pedidos. Veja a seguir.

2. Serviços do Itaú Shopline

Page 20: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

20

AvançarVoltarÍndiceHome

2.1MóduloItaúShopline2.1.1InformaçõesCadastraisdoSiteLojista

Todasasinformaçõescadastraisdositelojistaestãodisponíveisparaconsulta eatualizaçãonoMóduloItaúShoplineacessadoviaItaúEmpresasnainternet naconta-correntedositedolojista.DentrodoItaúEmpresasnainternet,arota deacessoaestafunçãoé:Itaú Empresas na internet > Recebimentos > ItaúShopline>InformaçõesCadastrais

Nestafunçãoencontram-seosCódigosdeHabilitaçãodositeparausodoprodutoque são: Código do Site e Chave de Criptografia. • AChavedeCriptografiaéumcódigoalfanuméricocriadopelosite

comexatamente16posiçõesparadarsegurançaàtransmissãodosdadosque irão trafegar entre o servidor do site e o servidor do banco no momento dageraçãodoItaúShopline.

• OCódigodoSiteéumcódigocriadopelobancoqueidentificaaconta-corrente onde serão creditados os pagamentos efetuados em ambiente seguro Itaú Shopline.

OsCódigosdeHabilitaçãodeverãoserinformadosaoresponsávelpelainstalaçãodo Itaú Shopline no site.

Atenção:qualquerinformaçãoalteradanesteambienteestarádisponívelparautilizaçãoon-lineapósaalteração.ParaacessaroItaúEmpresasnainternet, énecessárioentrarnositedoItaú(http://www.itau.com.br/empresas)edigitar: • DadosdeUsuárioOperadoreSenhaEletrônicanabarradeacesso ao Itaú Empresas na internet.

2. Serviços do Itaú Shopline

Page 21: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

21

AvançarVoltarÍndiceHome

2.1MóduloItaúShopline2.1.2InstruçõesdeImplantaçãodoProduto

TodasasInstruçõesdeImplantaçãodoProdutoestãocontidasnestemanualtécnico.FuturasatualizaçõesdaversãoestarãosempredisponíveisparadownloadnoMóduloItaúShopline.

DentrodoItaúEmpresasnainternet,arotadeacessoaestafunçãoé: CobrançaouRecebimentos>ItaúShopline>Instalação.

AimplantaçãodoItaúShoplineestádetalhadanositens2,3e4destemanual eparatalseránecessárioobterosCódigosdeHabilitaçãodosite,oComponentedeCriptografiaeosBannersdeIdentificaçãodoProdutoeprovidenciar aprogramaçãodosparâmetrosnecessáriosàgeraçãodoItaúShopline.

Para resolver dúvidas quanto à instalação do meio de pagamento Itaú Shopline em seu site, entre em contato com o atendimento Itaú Empresas no telefone 0300 100 7575.

2. Serviços do Itaú Shopline

Page 22: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

22

AvançarVoltarÍndiceHome

2.2GeraçãodoItaúShopline–URLPrincipaldeAcessoaoProduto

Ambientedeprodução:

OambientedaplataformadecobrançaItaúShoplineéacessadoatravésdoenviodosdadoscriptografadosparaaseguinteURL:

https://shopline.itau.com.br/shopline/shopline.aspx

EstaéaURLoficialquedeveráseracionadapelocompradornositedolojista paraquehajaageraçãodoItaúShopline.Nesteambiente,ocompradorencontrarátodasasopçõesdepagamentodoprodutoqueestiveremhabilitadaspara o site do lojista e irá navegar conforme seus interesses e disponibilidades.

Clique aquiparavisualizaraTela Inicial do Itaú Shopline

2. Serviços do Itaú Shopline

Page 23: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

23

AvançarVoltarÍndiceHome

2.3ReemissãodeBoletos

AreemissãodeboletoéfeitaautomaticamentepelaURLdeemissãonaaplicaçãoItaúShopline.Seopedidoinformadojáexistiremnossasbasescomomesmovaloreaindanãoestiversidopago,éconsideradoumareemissão.Sendoassim,deve-sechamarsempreaURLdeemissão,ousejaamesmaURLutilizadaparafazerachamadadosite.

Portanto,sehouvegeraçãodeboletoeesteaindanãofoiliquidadoenemperdeusuavalidade,serápossívelreemiti-loaqualquermomento,atéseuvencimento.

Clique aquiparavisualizaroBoleto Bancário do Itaú Shopline.

2. Serviços do Itaú Shopline

Page 24: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

24

AvançarVoltarÍndiceHome

2.4RetornoOn-linedoTipodePagamento

OItaúdisponibilizaaoslojistasdoItaúShoplineoRetornoOn-line,istoé,aopçãodereceberumretorno,pedidoapedido,indicandootipodepagamentoescolhidopelocompradoremambienteItaúShopline.Paraisso,énecessárioqueolojistainformeumendereçoseguro(URL)parareceberainformaçãoquedeverásercadastradaemcampoespecíficodateladeInformaçõesCadastraisdoMóduloItaúShopline(videitem2.1.1destemanual).

Atenção: essachamadaseráfeitasomenteemaplicaçõescomSSL.

Forma de acesso: comunicaçãocriptografadaestabelecidaentreoservidor do banco e o servidor do site.

Formato da consulta:oRetornoOn-lineserásempredisponibilizadonoformatoXMLparaquesejadecriptografadoeinterpretadopelositeconformeoscódigospossíveis.Maisdetalhessobreaintegraçãodessamodalidadedeconsultadeoperaçõesserãoapresentadosnositenssubsequentes.

Tempo de disponibilização: on-lineerealtime–assimqueopedidoéregistradonobancoeassociadoaalgumadasopçõesdepagamentodaplataforma, ainformaçãodoTipodePagamentoescolhidoemambienteItaúShopline éretornadaaoservidordositequedeveráseguirosprocedimentosindicados no item 2.5 deste manual para interpretá-la.

Apósaemissãodocomprovantedepagamentooudapáginadoboletonatela docomprador,oItaúfaráachamadaàaplicaçãodolojistaconformeoendereçoresultantedaconcatenaçãodaURLdeRetornojácadastradanoItaúShopline eaURLinformadanocampourlRetornadacriptografiadopedido.

2. Serviços do Itaú Shopline

Atenção: se o site não passar o campo urlRetorna nos dados criptografados dopedido,ficarásubentendidoquenãoquerreceberoRetornodoTipodePagamentoescolhido.

O Retorno On-line informa apenas o tipo de pagamento da plataforma que foi escolhidopeloclientecompradordosite.Aconfirmaçãodopagamento dopedidoégarantidaexclusivamentepelobancoedeverásersempreobtidaemambienteItaú,oquesignificaqueositeéquedeveconsultarobancoenãoesperarestaconfirmaçãonumretorno.

Sendoassim,asmodalidadesdeConsultadeOperaçõesoficiaisdobancosão:ConsultadeOperaçõesdoMóduloItaúShopline,ArquivoRetornodeCobrança ouConsultaAutomáticaàSituaçãodoPagamento(sonda).

Page 25: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

25

AvançarVoltarÍndiceHome

2.5ConsultadeOperaçõesRealizadasviaItaúShopline

TodosospedidosqueacessamaplataformadecobrançaItaúShopline sãoregistradosnobanco,sendosemprepossívelsaberaopçãodepagamentoescolhida pelo comprador em ambiente Itaú Shopline e se o pedido foi pago ounão.Paraositelojista,aidentificaçãodaopçãodepagamentoescolhida sedápelacarteiradecobrança(videitem1destemanual).

ExistemdiversasmaneirasdeconsultarasoperaçõesrealizadasviaItaúShopline.Elasdiferementresipelaformacomosãoacessadas,peloformatoemquesãodisponibilizadasepelotempoemquedisponibilizamainformaçãoreferente aos pedidos consultados.

Veja a seguir mais detalhes sobre as consultas disponíveis.

2. Serviços do Itaú Shopline

Page 26: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

26

AvançarVoltarÍndiceHome2. Serviços do Itaú Shopline2.5ConsultadeOperaçõesRealizadasviaItaúShopline2.5.1ConsultadeOperaçõesdoMóduloItaúShopline

OMóduloItaúShoplineofereceumaconsultaexclusivadasoperaçõesrealizadasviaItaúShopline,relacionandoospedidosàscarteirasqueidentificamoItaúShopline(176e178),sendoumfiltrodasinformaçõesoferecidasnasfunçõesdarotaCarteiraseTítulosdoItaúEmpresasnainternet.

Forma de acesso: ItaúEmpresasnainternetdaconta-correntedosite.ArotaparaestaconsultanoMóduloItaúShoplineé:

• ItaúEmpresasnainternet>Recebimentos>ItaúShopline> ConsultadeOperações

Formato da consulta:apartirdanavegaçãonoItaúEmpresasnainternet, ousuáriovisualizaarelaçãodepedidosefetuadosemseusitequeseráidentificadaconformeaopçãodepagamentoescolhidapelocomprador. Paraolojista,asopçõespossíveissão:débitoemconta(178),financiamento,cartãodecrédito(MasterCard®,Visa,HipercardeDiners)eboletobancário (176)eestarãoseparadasnaslistagensconformeosseguintesstatus:

• OperaçõesemAberto–pedidosqueemitiramboletosequeaindanão foram pagos.

• OperaçõesaCreditar–pedidosquejáforampagospeloscompradores equeaindanãoforamcreditadosparaolojistadevidoaofloatingdacobrança negociado com o gerente da conta-corrente do site. Se for a listagem depagamentoàvista,opedidojáésegurodecréditoparaolojista

nessemomento,masseforboletobancário,seránecessárioesperarpela compensaçãodacobrançadotítuloparateragarantiadocrédito. • OperaçõesCreditadas–pedidosquejáforampagospeloscompradores

e que já foram creditados para o lojista. • Históricodeoperaçõesrealizadas–pedidospagosviacartãodecrédito.

Nessalistagemhaveráumindicadordacompensaçãodacobrançadotítulo queédadopelaliteral“C”citadanodemonstrativo.Sehouveraliteralaolado dosvalorescreditados,indicaqueestesvaloresestãoACOMPENSAR,senãohouverliteral,significaráCOMPENSADO.Istoocorrequandohápagamento detítuloscomcheque,poisovalornãoficadisponíveldeimediato,e,sim, somenteapósacompensaçãodocheque.

Tempo de disponibilização: on-lineerealtime–assimqueopedidoéregistradonobancoeassociadoaalgumadasopçõesdepagamentodaplataforma, essainformaçãoédisponibilizadanoMóduloItaúShoplineconforme o status ocorrido.

Areutilizaçãodanumeraçãodeumpedidosópoderáserfeita:

• Paraospedidospagos,após60diascorridosdadatadepagamento; • Paraospedidosnãopagos,após60diascorridosdadatadevencimento; • Paraospedidosnãofinalizados,60diascorridosdadatadopedido.

Ainformaçãoficaarmazenadapor5anos.Outrasformasdeacompanhar ostatusdopagamentosão:ArquivoRetornodeCobrançaouConsulta AutomáticaaSituaçãodoPagamento(sonda).

Clique aquiparavisualizarumexemplodaConsulta de Operações do Módulo Itaú Shopline.

Page 27: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

27

AvançarVoltarÍndiceHome2. Serviços do Itaú Shopline2.5ConsultadeOperaçõesRealizadasviaItaúShopline2.5.2ArquivoRetornodeCobrança

OArquivoRetornodeCobrançaofereceaconsultadetodosostítulosliquidadosconformeascarteirasdecobrançacontratadaseutilizadaspelaconta-corrente doclientecedente(sitelojista).

Forma de acesso: conforme a modalidade de intercâmbio de arquivos definida pelolojistajuntoaseuGerentedeRelacionamentoItaúEmpresas.AformamaissimplesdeobteroarquivoéatravésdoItaúEmpresasnainternetnaconta-correntedo site.

• ParausuáriosdoItaúEmpresasnainternet,arotaé: TransmissãodeArquivo>Transmissão(AmbienteProdução)>Retorno>Recepcionar.

Formato da consulta: arquivodetexto(extensão”.txt”)padrãoCNABqueinformatodasasoperaçõesliquidadas,conformeacarteiradecobrançaassociadaaono do título.NascarteirasutilizadaspeloItaúShopline,ono do pedido enviado ao banco serátransformadoemSEUNÚMEROeirácomportambémocampoNOSSONÚMERO.

Paraprogramaraleituradessearquivoeintegrá-loaosistemadeconciliaçãobancáriadesuaempresa,énecessárioobterjuntoaogerentedesuacontaoManual deIntercâmbiodeArquivosqueespecificatodososcamposqueserãoinformadosnoArquivoRetornodeCobrança.ParaconhecerolayoutdaCobrançaItaúacesseoItaúEmpresasnainternetesigaarota:OutrosServiços>DownloadCenter>Cobrança–ManualdeIntercâmbiodeArquivos.

Tempo de disponibilização: umdiaútilapósaliquidaçãodotítulo(D+1)–assimqueopedidoépago,ainformaçãoécompiladapelacobrançasobaformadeArquivoRetornoeapresentadaaolojistaumdiaútilapósaliquidação.

No Itaú Empresas na internet ficam disponíveis os arquivos das últimas 5 movimentaçõesdiárias,sendoqueageraçãodearquivoséfeitadeterçaasábado,contemplandosempreamovimentaçãododiaanterior.

Areutilizaçãodanumeraçãodeumpedidosópoderáserfeita:

• Paraospedidospagos,após60diascorridosdadatadepagamento; • Paraospedidosnãopagos,após60diascorridosdadatadevencimento; • Paraospedidosnãofinalizados,60diascorridosdadatadopedido.

Ainformaçãoficaarmazenadapor5anos.Outrasformasdeacompanharostatusdopagamentosão:ConsultadeOperaçõesdoMóduloItaúShoplineouConsultaAutomáticaàSituaçãodoPagamento(sonda).

Clique aquiparavisualizarumexemplodoArquivo Retorno de Cobrança.

Page 28: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

28

AvançarVoltarÍndiceHome2. Serviços do Itaú Shopline2.5ConsultadeOperaçõesRealizadasviaItaúShopline2.5.3ConsultaAutomáticaàSituaçãodoPagamento(sonda)

OItaúofereceaoslojistasdoItaúShoplineapossibilidadederealizarumaConsulta Automática(sonda)aoservidordobancoparaobterasituaçãodepagamento de um pedido.

AURLutilizadaparaexecutarestaconsultaé:https://shopline.itau.com.br/shopline/consulta.aspx.

OsdadosdevemsercriptografadosutilizandoométodogeraConsulta.

Paraaconsultadevemserutilizados,obrigatoriamente,osseguintesdados: Chave,CódigodaEmpresa,NúmerodoPedidoeFormato.Paradescriptografar oresultadodaconsultaéutilizado:CódigodaEmpresa,NúmerodoPedido,Valor,TipodePagamento,SituaçãodoPagamentoeDatadePagamento.

Segueoexemplodeutilizaçãodosdadoscriptografados:dados=cripto.geraConsulta(codEmp,pedido,formato,chave).

NestaconsultaéexibidaaefetivaçãodopagamentodopedidoemfunçãodotipodepagamentoutilizadopelocompradoremambienteItaúShopline,sendoqueotempodedisponibilizaçãodestainformaçãovariaconformeaopçãodepagamento escolhida.

As combinações de consulta possíveis são:

TIPPAG SITPAG

00 para pagamento ainda não escolhido

On-line e real time01parasituaçãodepagamentonãofinalizada(tentenovamente)02paraerronoprocessamentodaconsulta(tentenovamente)03parapagamentonãolocalizado(consultaforadeprazooupedidonãoregistradonobanco)

01 para pagamento à vista (TEF e CDC)

On-line e real time00 para pagamento efetuado01parasituaçãodepagamentonãofinalizada(tentenovamente)02paraerronoprocessamentodaconsulta(tentenovamente)03parapagamentonãolocalizado(consultaforadeprazooupedidonãoregistradonobanco)

02 para boleto bancário

On-line e real time01parasituaçãodepagamentonãofinalizada(tentenovamente)02paraerronoprocessamentodaconsulta(tentenovamente)03parapagamentonãolocalizado(consultaforadeprazooupedidonãoregistradonobanco)04 para boleto emitido com sucessoA partir de um dia útil da emissão do boleto00 para pagamento efetuado05parapagamentoefetuado,aguardandocompensação06 para pagamento não compensado

03 para cartão de crédito

On-line e real time00 para pagamento efetuado01parasituaçãodepagamentonãofinalizada(tentenovamente)02paraerronoprocessamentodaconsulta(tentenovamente)03parapagamentonãolocalizado(consultaforadeprazooupedidonãoregistradonobanco)

Page 29: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

29

AvançarVoltarÍndiceHome2. Serviços do Itaú Shopline2.5ConsultadeOperaçõesRealizadasviaItaúShopline2.5.3ConsultaAutomáticaàSituaçãodoPagamento(sonda)

Deacordocomatabelaanterior,asopçõesdepagamento01e03poderãoserconfirmadas emtemporeal,masaopçãodepagamento02(boletobancário)sóseráconfirmadaapósacompensaçãodotítulonaCobrançaItaú.Emtemporeal,apenaséinformadoqueocompradorgerouumboletoemsuatela,comsucesso,permitindoaolojista aintegraçãodafuncionalidadedereemissãodetítulos,porexemplo.

JáqueoItaúShoplineéumaformadecobrançaviainternetqueseutiliza dascarteiras176e178paraidentificarospedidosenviadospelositeaobanco, valeressaltarquepagamentoefetuadosignificatítuloliquidadoequeéimportanteconsiderartambémoprazoparacréditodacobrança(floatingnegociadoparaaconta-correntedosite)eaformadeliquidaçãodotítulo(dinheiro,cheque,compensaçãobancária)quepodesercompensadaounãoaofimdoprocesso.

Forma de acesso: comunicaçãocriptografadaestabelecidaentreoservidor do site e o servidor do banco.

Formato da consulta:aConsultaAutomática(sonda)poderáserobtida noformatoXMLouHTML.Maisdetalhessobreaintegraçãodessamodalidade deconsultadeoperaçõesserãoapresentadosnositenssubsequentes.

Tempo de disponibilização: on-lineerealtime–apósreceberoRetornoOn-line, ositepoderáprepararseuservidorparadispararumaConsultaAutomática aoservidordobancoparaobteraSituaçãodoPagamentodopedidoretornado.

Areutilizaçãodanumeraçãodeumpedidosópoderáserfeita:

• Paraospedidospagos,após60diascorridosdadatadepagamento; • Paraospedidosnãopagos,após60diascorridosdadatadevencimento; • Paraospedidosnãofinalizados,60diascorridosdadatadopedido.

Ainformaçãoficaarmazenadapor5anos.Outrasformasdeacompanhar ostatusdopagamentosão:ConsultadeOperaçõesdoMóduloItaúShopline ouArquivoRetornodeCobrança.

Clique aquiparavisualizaraConsulta Automática à Situação de Pagamento (sonda).

AlémdastrêsmodalidadesdeConsultadeOperaçõesaquidetalhadas,existemoutrasmaneirasdeconsultarasoperaçõesrealizadasviaItaúShoplinequetrazemasconfirmaçõesdetodasascarteirasdecobrançautilizadaspelolojistacomo, porexemplo,orelatório2154.Paramaisinformações,procureseuGerente de Relacionamento Itaú Empresas.

Oresponsávelpelositeescolheráa(s)modalidade(s)deconsultamaisconveniente(s).

Page 30: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

30

AvançarVoltarÍndiceHome2. Serviços do Itaú Shopline2.6ItaúShopline–Multibandeira

1) Loja entra em contato com Redecard Telefone40043298(capitais)e08007263298(demaislocalidades). • LojistaseidentificarácomoclienteItaúShoplineconfirmandoqueusará oItaúShoplinecomoplataformadecapturadecartõesdecréditos.

2) Credenciamento Redecard • ProcessodecredenciamentopadrãoRedecardKomerciWebService. • Háapossibilidadedoestabelecimentonãosercredenciadopornãopassar emanáliseinterna(riscos,fraudes,jurídico...).

3) Credenciamento PV Komerci WS • ProcessodecredenciamentopadrãoRedecard.

4) Cadastro dos IPs Itaú Shopline • RedecarddeverácadastrarIPdoItaú. • OperaçãocredenciaosIPsfornecidospeloItaú. • Olimitemáximosão10endereçosIPporPV:casooestabelecimentojátenha

cadastrados,eledeveráinformarquaisserãoretiradosparaainserçãodosIPs Itaú(casonecessário).

O prazo para a loja estar OK com sistema e passar a capturar cartões via Itaú Shopline/Komerci pode variar: • LojavirtualquejápossuiKomerciWS(nãocriaráumnovoPV):

cercade2horasapósocadastrodosIPs. • LojavirtualquenãopossuiKomerciWS:priorizaçãoparaatendimento

em5diasúteisapósacriaçãodasolicitaçãodocredenciamento (desdequetodososdocumentos/infosestejamok).

Duas razões para este fluxo: • LojavirtualpodeestarusandooKomerciWSeapontandoosIPsparaoutros servidoreseumaalteraçãoautomáticapodeafetaressaoperação. • Todaalteraçãocadastralsópodeserefetuadamediantesolicitação

de acordo com a loja virtual.

Para a versão Web Service para o Itaú Shopline:LiguenaCentraldeAtendimentoesoliciteocadastramentoKomerciWebService:4001 4433(capitaiseregiõesmetropolitanas)0800 784 433(demaislocalidades)

Lembrando!Paraesteprocesso,vocêdeveestarcredenciadonaREDECARD(viaItaú) e domiciliado no Itaú, e informar ser cliente Itaú Shopline na Redecard.

1Cliente entra em contato

JáéclienteRedecard?

sim sim

não não

2Credenciamento

Redecard

JáéclienteKomercicomWS

habilitado?

3CredenciamentoPVKomerciWS

4CadastrodosIPs

Itaú Shopline

Page 31: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

31

AvançarVoltarÍndiceHome2. Serviços do Itaú Shopline2.6ItaúShopline–Multibandeira

Sobre o certificado digital no site:

No dia 1o de janeiro de 2012, a versão V2 do Certificado Digital ICP-Brasil (Infraestrutura de Chaves Públicas Brasileira) entrou em operação.

Nessa versão, as chaves criptográficas que compõem o algoritmo de criptografia assimétrica (RSA) utilizado pelas Autoridades Certificadoras passaram a ter o tamanho de 4096 bits. Para os Certificados Digitais de pessoas físicas e jurídicas, as chaves são de 2048 bits, em substituição às de 1024 bits. Houve mudança também no algoritmo de resumo criptográfico (SHA), que passou de SHA-1 (160 bits) para no mínimo SHA-256 (256 bits).

Essa migração é oficializada pela Resolução no 65, de 9 de julho de 2009, que trata da necessidade de atualização dos padrões e algoritmos criptográficos da ICP-Brasil (DOC-ICP-01.01).

Devem cumprir esse conjunto de diretrizes as Autoridades Certificadoras, Autoridades de Registro, Prestadores de Serviço de Suporte, Empresas de Auditoria Independente, Laboratórios 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 aquiparavisualizarasprincipaistelasdoMódulo Itaú Shopline.

Page 32: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

32

AvançarVoltarÍndiceHome3. Layout dos Campos

Parâmetros ObrigatóriosParâmetros Descrição Critérios de Consistência

CodEmp CódigodaEmpresa(CódigodoSite) Alfanuméricocomexatas26posições(enviarocódigotodoemmaiúsculas)

Pedido NúmerodoPedido Numéricocomomáximode08posições(99999999)(*)

Valor ValorTotaldoPagamento Númerosinteirosdeaté8posições(99999999,99).Oscentavosdeverãoserenviadoscom2casasdecimais(nãoobrigatório),utilizandoavírgulacomoseparador

Chave Chave de Criptografia Alfanuméricocomexatas16posições(enviarachavetodaemmaiúsculas)

NomeSacado Nome do Sacado Alfanuméricocomomáximode30posições

Codigoinscricao CódigodeinscriçãodosacadoNuméricocomexatamente02posições:•01paraCPF•02paraCNPJ

NumeroInscricao Númerodeinscriçãodosacado Numéricocom14posições•99999999999999

EnderecoSacado Endereçodosacado Alfanuméricocomomáximode40posições

BairroSacado Bairro do sacado Alfanuméricocomomáximode15posições

CepSacado CEPdosacado Numéricocomexatamente08posições(99999999)

CidadeSacado Cidade do sacado Alfanuméricocomomáximode15posições

EstadoSacado Estado do sacado Alfanuméricocomexatamente02posições.SomenteserãoaceitosEstadosbrasileiros

Page 33: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

33

AvançarVoltarÍndiceHome3. Layout dos Campos

Parâmetros OpcionaisParâmetros Descrição Critérios de Consistência

DataVencimento Data de vencimento do título Numéricocomexatamente08posiçõesUtilizaroformato“ddmmaaaa”

UrlRetorna PartefinaldaURLdeRetornoCompleta(2) Alfanuméricocomomáximode60posições

ObsAdicional1 Espaçodisponívelparaenviarumalinhademensagemúnicaporpedido,quesóseráexibidaseocampoObservaçãocontiverotexto“3” Alfanuméricocomomáximode60posições

ObsAdicional2 Espaçodisponívelparaenviarumalinhademensagemúnicaporpedido,quesóseráexibidaseocampoObservaçãocontiverotexto“3” Alfanuméricocomomáximode60posições

ObsAdicional3 Espaçodisponívelparaenviarumalinhademensagemúnicaporpedido,quesóseráexibidaseocampoObservaçãocontiverotexto“3” Alfanuméricocomomáximode60posições

ObservacaoEspaçodisponívelparaenviarumalinhademensagemúnicaporpedidoouumparâmetroindicandoqualMensagemAdicional(1) se quer apresentar

Alfanuméricocomomáximode40posiçõesEnviar:•umalinhademensagemou•1paraapresentaraMensagemAdicional1ou•2paraapresentaraMensagemAdicional2ou•3paraapresentaras3linhasdeMensagemAdicionalenviadasnoscamposObsAdicional1,ObsAdicional2eObsAdicional3

Page 34: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

34

AvançarVoltarÍndiceHome3. Layout dos Campos3.1ParâmetroseCritériosdeConsistências

OsparâmetrosqueserãoutilizadosnacriptografiaparaageraçãodoItaúShoplinedevemseguirtodososcritériosaquiespecificadosparaqueoambientesejaacessadocom sucesso.Existemdoistiposdeparâmetros: • Obrigatórios: permitemageraçãodequalqueropçãodepagamento

daplataformadecobrançaItaúShopline. • Opcionais:referem-seespecificamenteàopçãodepagamentoboletobancário.Noentanto,todososparâmetrosdeverãoserenviadosnacriptografiaapesardenão estarem preenchidos.

Veja a seguir as características específicas de cada parâmetro:

1. Mensagem Adicional:conformeoscritériosdoparâmetroObservacao (videtabelaanterior),amensagemadicionalexibidanocorpodoboletoserá:

• Mensagemde1linhade40posições–Mensagemúnicaporpedidoqueseráexibidaemissão,nareemissãodoboleto(sehouver)etambémestarádisponívelnoArquivoRetornodeCobrança.

ou • MensagemAdicional1(parâmetro1)–Mensagempadrãopré-cadastrada

queseráexibidanaemissãoenareemissãodoboleto(sehouver)edeveráserregistradonateladeInformaçõesCadastraisdoMóduloItaúShopline noitemMensagemAdicional1.

ou • MensagemAdicional2(parâmetro2)–Mensagempadrãopré-cadastrada

queseráexibidanaemissãoenareemissãodoboleto(sehouver)edeveráserregistradonateladeInformaçõesCadastraisdoMóduloItaúShopline noitemMensagemAdicional2.

ou • MensagemAdicional3(parâmetro3) –Mensagemúnicaporpedido

queseráexibidanaemissãoenareemissãodoboleto(sehouver)edeveráserenviadanoscamposObsAdicional1,ObsAdicional2eObsAdicional3.

2. URL de Retorno Completa:éoendereçoSSLparaoqualseráenviadooRetornoOn-linedoTipodePagamentoescolhidopelocompradornastelasdoItaúShopline.

Paramaisdetalhessobrecomoexecutá-lo,videitem5.1destemanual.

AURLdeRetornoCompletadeveráternomáximo100posições,sendocomposta pela concatenação dos parâmetros URL de Retorno e urlRetorna.

• URL de Retorno:endereçoprincipaldoservidorsegurodeaplicaçãodosite(SSL)quedeveráestarregistradoemInformaçõesCadastraisdoMóduloItaúShoplinenoitemURLdeRetorno;

• urlRetorna:parâmetroenviadonageraçãodoItaúShopline(videtabelaanterior)queindicaqueositedesejareceberoRetornoOn-linedoTipodoPagamento;

• Oscamposobs1,obs2,obs3sãocamposopcionaisparaenviodeobservaçãocomplementarusadonageraçãodoboleto.

ParamaisdetalhessobreoacessoàfunçãoInformaçõesCadastraisdoMóduloItaúShopline,videitem2.1.destemanual.

OsdadosqueserãoutilizadosparainterpretaroRetorno On-line do Tipo de Pagamento oferecidopelobancoerealizaraConsulta Automática à Situação do Pagamento (sonda) do pedido efetuado em ambiente Itaú Shopline deve obedecertodososcritériosespecificadosaseguir:

Page 35: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

35

AvançarVoltarÍndiceHome

Parâmetros para Retorno On-line do Tipo de PagamentoParâmetros Descrição Critérios de Consistência

TipPag Tipodepagamentoescolhidopelocomprador

Numéricocom02posições:•00parapagamentoaindanãoescolhido*•01parapagamentoàvista(TEFeCDC)•02paraboleto•03paracartãodecrédito*Estetipodepagamentosomenteseráexibidonaconsulta

3. Layout dos Campos3.1ParâmetroseCritériosdeConsistências

Page 36: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

36

AvançarVoltarÍndiceHome

Parâmetros para Consulta à Situação de PagamentoParâmetros Descrição Critérios de Consistência

Formato Formato do retorno da consultaNuméricocom01posição:•0paraformatodepáginaHTMLparaconsultavisual•1paraformatoXML

TipPag Tipodepagamentoescolhidopelocomprador

Numéricocom02posições:•00parapagamentoaindanãoescolhido*•01parapagamentoàvista(TEFeCDC)•02paraboleto•03paracartãodecrédito*Estetipodepagamentosomenteseráexibidonaconsulta

SitPag Situaçãodepagamentodopedido

Numéricocom02posições:•00parapagamentoefetuado•01parasituaçãodepagamentonãofinalizada(tentenovamente)•02paraerronoprocessamentodaconsulta(tentenovamente)•03parapagamentonãolocalizado(consultaforadeprazooupedido nãoregistradonobanco)

•04paraboletoemitidocomsucesso•05parapagamentoefetuado,aguardandocompensação•06parapagamentonãocompensado

DtPag Data do pagamento Numéricocom8posiçõesnoformato“ddmmaaaa”

CodAut Númerodeautorização–preenchidosomentequandopagamentoefetuadocomcartãodecrédito Alfanuméricocom6posições

NumId NSUdatransação–preenchidosomentequandopagamentoefetuadocomcartãodecrédito Alfanuméricocom40posições

CompVend Númerodocomprovantedevenda–preenchidosomentequandopagamentoefetuadocomcartãodecrédito,bandeiraMasterCard®/Diners Alfanuméricocom9posições

TipCart Tipodecartãodecréditoescolhidopelocomprador Em branco

3. Layout dos Campos3.1ParâmetroseCritériosdeConsistências

Page 37: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

37

AvançarVoltarÍndiceHome4. Informações Técnicas

Paraquesejafeitaaimplantaçãodo Itaú Shopline,énecessárioqueexista umServidorWeb.Depoisdeinstalado,devemserexecutadosospassos descritos a seguir.

Page 38: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

38

AvançarVoltarÍndiceHome

4.1UsandoItaucripto.dll–ParaAmbientesMicrosoft(WindowsNT4.0ousuperior)

4. Informações Técnicas

NesteitemusamosASPX(VBScript)comlinguagem,porémnadaimpede queutilizeoutralinguagemweb.

Page 39: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

39

AvançarVoltarÍndiceHome

4.1.1Passo1:Criptografia

4. Informações Técnicas

Arotadeacessoaestecomponenteno:

ItaúEmpresasnainternet>Recebimentos>ItaúShopline>Instalação

Apósesteprocedimento,deve-seregistrarocomponentenoequipamentoqueforexecutaraaplicaçãoechamarométodogeraDados.Os procedimentos para registrar o componente de criptografia são:

1. Menu“Iniciar”(“Start”)doWindowsNT2. Menu“Executar”(“Run”)3. Digitarnacaixa“Abrir”(“Open”)ocomando:regsvr32c:\....\Itaucripto.dll

Page 40: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

40

AvançarVoltarÍndiceHome

4.1.2Passo2:ChamadaàTeladoItaúShopline

4. Informações Técnicas

ApáginaASPquecriptografaosdadosparaenviá-losaoItaúShoplinedeveobservaras seguintes regras:

( 1 )Parachamarateladepagamentos,acriptografiadosdadosdeveseguirexatamenteaordemabaixo:dados=cripto.geraDados(codEmp,pedido,valor,observacao,chave,nomeSacado,codigoInscricao,numeroInscricao,enderecoSacado,bairroSacado,cepSacado,cidadeSacado,estadoSacado,dataVencimento,urlRetorna,obsAdicional1,obsAdicional2,obsAdicional3).

( 2 )Todososcampossãocriptografadoseenviadospelolojista,excetoocampo“Chave”.

( 3 )TodososcontratospreenchidospeloItaúEmpresasnainternetdeverãoenviartodosos campos obrigatoriamente. Os contratos preenchidos pela digital somente serão obrigatórios“CódigodaEmpresa”,“Chave”,“Númerodopedido”e“Valor”.Segueoexemplodeutilizaçãoparaocasoondesedesejaenviarapenasoscamposobrigatórios:dados=cripto.geraDados(codEmp,pedido,valor,“”,chave,“”,“”,“”,“”,“”,“”,“”,“”,“”,“,”,”,”)

( 4 )ApáginaquecontiveraURLdoItaúdeveráapresentarasseguintescaracterísticas:Formulário(FORM)comaspropriedades: • method=”post” • action=”https://shopline.itau.com.br/shopline/shopline.aspx“Campo(INPUT)paraosdadoscriptografados,comaspropriedades: • name=”DC” • type=”hidden” • value=”DadosCriptografados”

Obs.:onomedoInputtemqueser“DC”poisosdadossãorecebidosapartirdeumrequestcom este nome.EXEMPLO:

<FORMaction=”https://shopline.itau.com.br/shopline/shopline.aspx”method=”post”name=”form1”onsubmit=carregabrw()target=”SHOPLINE”> <INPUTtype=”hidden”name=”DC”value=”<%=dados%>”> <BR> <INPUTtype=”submit”name=”Shopline”value=”ItaúShopline”></form>

( 5 )ParaocorretofuncionamentodoItaúShoplinenosbrowsers:AOL,NetscapeeInternetExplorer(versões4.Xousuperior)ainstânciadobrowseraserabertodevepossuir oJavaScriptabaixo,comasseguintescaracterísticas: • TOOLBAR=YES • MENUBAR=YES • RESIZABLE=YES • STATUS=NO • SCROLLBARS=YES • WIDTH=815(sugestão) • HEIGHT=575(sugestão)EXEMPLO:<scriptlanguage=”JavaScript”><!--functioncarregabrw(){ window.open(‘’,‘SHOPLINE’,‘toolbar=yes,menubar=yes,resizable=yes,status=no,scrollbars=yes,width=815,height=575’);}//--></script>

AconfiguraçãoaquisugeridapermiteaidealvisualizaçãodateladoItaúShoplineasergerada sobre a tela do site lojista no computador do cliente comprador do site.

Page 41: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

41

AvançarVoltarÍndiceHome

4.2ParaAmbientesUnixouLinux

4. Informações Técnicas

NesteitemusamosJava(Servlet)comolinguagemweb.

Page 42: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

42

AvançarVoltarÍndiceHome4. Informações Técnicas

Arotadeacessoaestecomponenteé:

ItaúEmpresasnainternet>Recebimentos>ItaúShopline>Instalação

NodiretórioondeoJavaserácompilado,crieumsubdiretórioItaúecopieaclasseItaucripto para este novo subdiretório.

4.2ParaAmbientesUnixouLinux4.2.1Passo1:Criptografia

Page 43: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

43

AvançarVoltarÍndiceHome4. Informações Técnicas

Servlet que criptografa os dados para enviá-los ao Itaú Shopline deve observar as seguintes regras:

( 1 ) Inserirnoiníciodocódigoalinha“importItau.Itaucripto;”paraquesejaimportada

a classe Itaucripto.

( 2 )Inserirocódigodaempresaeachavedecriptografia,emletramaiúscula,noslocais

indicados.

( 3 ) Parachamarateladepagamentos,acriptografiadosdadosdeveseguirexatamente

aordemabaixo:

dados=cripto.geraDados(codEmp,pedido,valor,observacao,chave,nomeSacado,

codigoInscricao,numeroInscricao,enderecoSacado,bairroSacado,cepSacado,

cidadeSacado,estadoSacado,dataVencimento,urlRetorna,obsAdicional1,obsAdicional2,

obsAdicional3)

( 4 ) Todososcampossãocriptografadoseenviadospelolojista,excetoocampo“Chave”.

( 5 )Oscampos“CódigodaEmpresa”,“Chave”,“Númerodopedido”e“Valor”são

obrigatórios,osdemaissãoopcionais,entretanto,todososparâmetrosdevemserenviados

na criptografia apesar de não estarem preenchidos.

Segueoexemplodeutilizaçãoparaocasoondesedesejaenviarapenasoscampos

obrigatórios:

dados=cripto.geraDados(codEmp,pedido,valor,“”,chave,“”,“”,“”,“”,“”,“”,“”,“”,“”,“,”,“,“)

4.2ParaAmbientesUnixouLinux4.2.2Passo2:ChamadaàTeladoItaúShopline

( 6 ) ApáginaquecontiveraURLdoItaúdeveráapresentarasseguintescaracterísticas:

Formulário(FORM)comaspropriedades:

• method=”post”

• action=”https://shopline.itau.com.br/shopline/shopline.aspx“

Campo(INPUT)paraosdadoscriptografados,comaspropriedades:

•name=”DC”

•type=”hidden”

•value=”DadosCriptografados”

Obs.:onomedoInputtemqueser“DC”poisosdadossãorecebidosapartirdeumrequest

com este nome.

EXEMPLO:

out.println(“<FORMMETHOD=\”POST\”ACTION=\”https://shopline.itau.com.br/shopline/

shopline.aspx\”name=\”form\”onsubmit=carregabrw()target=\”SHOPLINE\”>”);

out.println(“<INPUTTYPE=\”hidden\”NAME=\”DC\”VALUE=\””+dados+“\”>”);

out.println(“<INPUTTYPE=\”submit\”name=\”Shopline\”value=\”ItaúShopline\”>”);

out.println(“</FORM>”);

( 7 )ParaocorretofuncionamentodoItaúShoplinenosbrowsers:AOL,NetscapeeInternet

Explorer(versões4.Xousuperior)ainstânciadobrowseraserabertodevepossuiro

JavaScriptabaixo,comasseguintescaracterísticas:

• TOOLBAR=YES

• MENUBAR=YES

• RESIZABLE=YES

• STATUS=NO

Page 44: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

44

AvançarVoltarÍndiceHome

• SCROLLBARS=YES

• WIDTH=815(sugestãoparamelhorvisualização)

• HEIGHT=575(sugestãoparamelhorvisualização)

EXEMPLO:

out.println(“<scriptlanguage=\”JavaScript\”>”);

out.println(“<!--”);

out.println(“functioncarregabrw(){”);

out.println(“window.open(‘\’,‘SHOPLINE’,\”toolbar=yes,menubar=yes,resizable=yes,st

atus=no,scrollbars=yes,width=815,height=575\”);”);

out.println(“}”);

out.println(“//-->”);

out.println(“</script>”);

AconfiguraçãoaquisugeridapermiteaidealvisualizaçãodateladoItaúShoplineaser

gerada sobre a tela do site lojista no computador do cliente comprador do site.

( 8 )Apósaedição,salvarcomextensãoJava,compilá-lo(javac<nomedoarquivo>.java)

e colocá-lo no diretório definido como repositório de servlets.

4. Informações Técnicas4.2ParaAmbientesUnixouLinux4.2.2Passo2:ChamadaàTeladoItaúShopline

Page 45: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

45

AvançarVoltarÍndiceHome

Nesteitem,usamosASPX(VBScript)comolinguagem,porémnadaimpede queutilizeoutralinguagemweb.

5. Exemplo de Códigos5.1UsandoItaucripto.dll–ParaAmbientesMicrosoft(WindowsNT4.0ousuperior)

Page 46: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

46

AvançarVoltarÍndiceHome

<HTML><HEAD><TITLE>ExemplodecódigoHTML</TITLE></HEAD><BODY><FORMACTION=”Nome da Página de Criptografia”METHOD=”Post”NAME=”form1”><CENTER>EntrecomosDados<TABLEwidth=100%border=1align=center><TR><TDwidth=25%align=center><B>Pedido(99999999):</B></TD> <TD><INPUTtype=”text”maxlength=8size=8name=”pedido”value=””></TD></TR><TR><TDwidth=25%align=center><B>Valor(99999999,99):</B></TD> <TD><INPUTtype=”text”maxlength=10size=10name=”valor”value=””></TD></TR><TR> <TDwidth=25%align=right><B>Observação:</B></TD> <TD><INPUTtype=”text”maxlength=40size=40name=”observacao”value=””></TD></TR><TR> <TDwidth=25%align=right><B>NomedoSacado:</B></TD> <TD><INPUTtype=”text”maxlength=30size=30name=”nomeSacado”value=””></TD></TR><TR> <TDwidth=25%align=right><B>CódigodeInscrição(01CPF,02CNPJ):</B></TD> <TD><INPUTtype=”text”maxlength=2size=2name=”codigoInscricao”value=””></TD></TR><TR> <TDwidth=25%align=right><B>NúmerodeInscrição(CPF,CNPJ):</B></TD> <TD><INPUTtype=”text”maxlength=14size=14name=”numeroInscricao”value=””></TD></TR><TR> <TDwidth=25%align=right><B>EndereçodoSacado:</B></TD> <TD><INPUTtype=”text”maxlength=40size=40name=”enderecoSacado”value=””></TD></TR><TR> <TDwidth=25%align=right><B>Bairro:</B></TD> <TD><INPUTtype=”text”maxlength=15size=15name=”bairroSacado”value=””></TD></TR>

5. Exemplo de Códigos5.1UsandoItaucripto.dll–ParaAmbientesMicrosoft(WindowsNT4.0ousuperior)5.1.1EnviodosDados–PáginainicialHTML

<TR> <TDwidth=25%align=right><B>CEP(99999999):</B></TD> <TD><INPUTtype=”text”maxlength=8size=8name=”cepSacado”value=””></TD></TR><TR> <TDwidth=25%align=right><B>Cidade:</B></TD> <TD><INPUTtype=”text”maxlength=15size=15name=”cidadeSacado”value=””></TD></TR><TR> <TDwidth=25%align=right><B>Estado:</B></TD> <TD><INPUTtype=”text”maxlength=2size=2name=”estadoSacado”value=””></TD></TR><TR> <TDwidth=25%align=right><B>DatadeVencimento(ddmmaaaa):</B></TD> <TD><INPUTtype=”text”maxlength=8size=8name=”dataVencimento”value=””></TD></TR><TR> <TDwidth=25%align=right><B>URLretorna:</B></TD> <TD><INPUTtype=”text”maxlength=60size=60name=”urlRetorna”value=””></TD></TR><TR> <TDwidth=25%align=right><B>ObsAdicional1:</B></TD> <TD><INPUTtype=”text”maxlength=60size=60name=”ObsAdicional1”value=””></TD></TR><TR> <TDwidth=25%align=right><B>ObsAdicional2:</B></TD> <TD><INPUTtype=”text”maxlength=60size=60name=”ObsAdicional2”value=””></TD></TR><TR> <TDwidth=25%align=right><B>ObsAdicional3:</B></TD> <TD><INPUTtype=”text”maxlength=60size=60name=”ObsAdicional3”value=””></TD></TR></TABLE></CENTER><BR><BR><INPUTTYPE=”submit”value=”Pagar”name=”Pagar”></FORM></BODY></HTML>

Page 47: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

47

AvançarVoltarÍndiceHome

<HTML>

<BODY>

<CENTER>NomedaPáginadeCriptografia</CENTER>

<%

dimcodEmp,chave,pedido,valor,observacao,nomeSacado,codigoInscricao,enderecoSacado

dimbairroSacado,cepSacado,cidadeSacado,estadoSacado,dataVencimento,urlRetorna,cripto

codEmp=“J0123456789012345678901234” ‘Coloqueaquiocódigodaempresa

chave=“ABCD123456ABCD12” ‘Coloqueaquiachavedecriptografiaemmaiúscula

pedido=Request.Form(“pedido”) ‘obtémovalordocampo“pedido”

valor=Request.Form(“valor”) ‘obtémovalordocampo“valor”

observacao=Request.Form(“observacao”) ‘obtémovalordocampo“observacao”

nomeSacado=Request.Form(“nomeSacado”) ‘obtémovalordocampo“nomeSacado”

codigoInscricao=Request.Form(“codigoInscricao”) ‘obtémovalordocampo“codigoInscricao”

numeroInscricao=Request.Form(“numeroInscricao”) ‘obtémovalordocampo“numeroInscricao”

enderecoSacado=Request.Form(“enderecoSacado”) ‘obtémovalordocampo“enderecoSacado”

bairroSacado=Request.Form(“bairroSacado”) ‘obtémovalordocampo“bairroSacado”

cepSacado=Request.Form(“cepSacado”) ‘obtémovalordocampo“cepSacado”

cidadeSacado=Request.Form(“cidadeSacado”) ‘obtémovalordocampo“cidadeSacado”

estadoSacado=Request.Form(“estadoSacado”) ‘obtémovalordocampo“estadoSacado”

dataVencimento=Request.Form(“dataVencimento”) ‘obtémovalordocampo“dataVencimento”

urlRetorna=Request.Form(“urlRetorna”) ‘obtémovalordocampo“urlRetorna”

obsAdicional1=Request.Form(“obsAdicional1”) ‘obtémovalordocampo“obsAdicional1”

obsAdicional2=Request.Form(“obsAdicional2”) ‘obtémovalordocampo“obsAdicional2”

obsAdicional3=Request.Form(“obsAdicional3”) ‘obtémovalordocampo“obsAdicional3”

5. Exemplo de Códigos5.1UsandoItaucripto.dll–ParaAmbientesMicrosoft(WindowsNT4.0ousuperior)5.1.2CriptografiadosDados–CódigoASPX

Setcripto=server.createobject(“Itaucripto.cripto”)

dados=cripto.geraDados(codEmp,pedido,valor,observacao,chave,nomeSacado,codigoInscricao,

numeroInscricao,enderecoSacado,bairroSacado,cepSacado,cidadeSacado,estadoSacado,

dataVencimento,urlRetorna,obsAdicional1,obsAdicional2,obsAdicional3)

Set cripto = nothing

%>

<FORMACTION=”https://shopline.itau.com.br/shopline/shopline.aspx”method=”post”

name=”form1”onsubmit=carregabrw()target=”SHOPLINE”>

<INPUTtype=”hidden”name=”DC”value=”<%=dados%>”>

<BR>

<INPUTtype=”submit”name=”Shopline”value=”ItaúShopline”>

</form>

<scriptlanguage=”JavaScript”>

<!--

functioncarregabrw()

{

window.open(‘’,‘SHOPLINE’,‘toolbar=yes,menubar=yes,resizable=yes,status=no,scrollbars=yes,width

=815,height=575’);

}

//-->

</script>

</BODY>

</HTML>

Page 48: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

48

AvançarVoltarÍndiceHome5. Exemplo de Códigos5.1UsandoItaucripto.dll–ParaAmbientesMicrosoft(WindowsNT4.0ousuperior)5.1.3RetornodoTipodePagamento–CódigoASPX

OendereçoparaRetornodoTipodePagamentoserácompostodaseguintemaneira:HTTPS://+URLdeRetornoCadastrada+URLRetornadoPedido+parâmetros de retorno criptografados.

EXEMPLO:

URLdeRetornocadastradanoMóduloItaúShopline=www.minhaloja.com.br

URLretornapassadapelolojistanopedidoemquestão=/final/retorno.aspx

Dadosderetornocriptografados=?DC=A345B456F456W456T56J3K678

ExemplodachamadaàURLfinal:https://www.minhaloja.com.br/final/retorno.aspx?

DC=A345B456F456W456T56J3K678

Apáginaderetornodopagamentodevereceberosdadoscriptografadosechamar

ométododecriptoe,paraacessaroconteúdodecadacampo,énecessáriousar

osmétodosqueretornamseusconteúdos:

• retornaCodEmp(),retornaPedido(),retornaTipPag()

CodEmp Código da empresa ou código do site Alfanuméricode26posições

Pedido Número do pedido Numéricocom8posições

TipPag Tipodepagamentoescolhidopelo comprador

Numéricocom02posições:•01parapagamentoàvista(TEFouCDC)•02paraboleto•03paracartãodecrédito

EXEMPLO:<%‘Inicializaasvariáveisdimdados,codEmp,chave,pedido,tipPag,cripto

chave=“ABCD123456ABCD12”‘Coloqueaquiachavedecriptografiaemmaiúscula ‘Recebe valores da página anterior dados=Request.Form(“DC”)

Setcripto=Server.CreateObject(“Itaucripto.cripto”)

‘DecriptografaosdadoschamandoométododecriptodaclasseItaucriptoerecebeos dadosdados=cripto.decripto(dados,chave)codEmp=cripto.retornaCodEmp()pedido=cripto.retornaPedido()tipPag=cripto.retornaTipPag()%><html> <head> <title> Retorno Online </title> </head><body><h1>Dadosrecebidos</h1>Códigodaempresa:<%=codEmp%><br>Pedido:<%=pedido%><br>Tipodepagamento:<%=tipPag%> <br></body></html>

Page 49: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

49

AvançarVoltarÍndiceHome5. Exemplo de Códigos5.1UsandoItaucripto.dll–ParaAmbientesMicrosoft(WindowsNT4.0ousuperior)5.1.4ConsultaàSituaçãodoPagamento–CódigoASPX

EXEMPLO:<%‘Inicializaasvariáveisdim dadosdim codEmpdim chavedim pedidodim formatodim cripto

chave=“ABCD123456ABCD12”‘Coloque aqui sua chave de criptografia em maiúscula ‘InicializavalorescodEmp=“J1234567890123456789012345”‘Coloque aqui seu código de empresaformato=“1”‘Coloqueaquiotipoderetornodesejado:0paraHTMLou1paraXML

‘Recebe o pedidopedido=Request.Form(“pedido”)

Setcripto=Server.CreateObject(“Itaucripto.cripto”)

‘Realizaacriptografiadosdadosdados=cripto.geraConsulta(codEmp,pedido,formato,chave)

set cripto = nothing%>

<FORMMETHOD=”POST”ACTION=”https://shopline.itau.com.br/shopline/consulta.aspx”id=form1name=form1><INPUTTYPE=”hidden”NAME=”DC”VALUE=”<%=dados%>”><INPUTTYPE=”submit”NAME=”Shopline”BORDER=”0”VALUE=”ConsultaaoPagamento”></FORM>

RESULTADO DA CONSULTA EM FORMATO XML

<?xmlversion=”1.0”encoding=”ISO-8859-1”?><!DOCTYPEconsulta[ <!ELEMENTconsulta(PARAMETER)> <!ELEMENTPARAMETER(PARAM)+> <!ELEMENTPARAMEMPTY> <!ATTLISTPARAMIDCDATA#REQUIRED>VALUECDATA#REQUIRED>]><consulta><PARAMETER> <PARAMID=”CodEmp”VALUE=””/> <PARAMID=”Pedido”VALUE=””/> <PARAMID=”Valor”VALUE=””/> <PARAMID=”tipPag”VALUE=””/> <PARAMID=”sitPag”VALUE=””/> <PARAMID=”dtPag”VALUE=””/> <PARAMID=”codAut”VALUE=””/> <PARAMID=”numId”VALUE=””/> <PARAMID=”compVend”VALUE=””/><PARAMID=”tipCart”VALUE=””/></PARAMETER></consulta>

Page 50: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

50

AvançarVoltarÍndiceHome5. Exemplo de Códigos5.1UsandoItaucripto.dll–ParaAmbientesMicrosoft(WindowsNT4.0ousuperior)5.1.5ReemissãodoBoleto–CódigoASPX

AreemissãodeboletoéfeitaautomaticamentepelaURLdeemissãonaaplicaçãoItaúShopline.Seopedidoinformadojáexistiremnossasbasescomomesmovaloreaindanãotiversidopago,éconsideradoumareemissão.

Sendoassim,deve-sechamarsempreaURLdeemissão,ousejaamesmaURLutilizadaparafazerachamadadosite.

Page 51: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

51

AvançarVoltarÍndiceHome5. Exemplo de Códigos5.2ParaAmbientesUnixouLinux

NesteitemusamosJava(Servlet)comolinguagemweb.

Page 52: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

52

AvançarVoltarÍndiceHome5. Exemplo de Códigos5.2ParaAmbientesUnixouLinux5.2.1EnviodosDados–PáginaInicialHTML

<HTML><HEAD><TITLE>ExemplodecódigoHTML</TITLE></HEAD><BODY><FORMACTION=”ServletCriptoShopline”METHOD=”Post”NAME=”form1”><CENTER>EntrecomosDados<TABLEwidth=100%border=1align=center><TR><TDwidth=25%align=center><B>Pedido(99999999):</B></TD> <TD><INPUTtype=”text”maxlength=8size=8name=”pedido”value=””></TD></TR><TR><TDwidth=25%align=center><B>Valor(99999999,99):</B></TD> <TD><INPUTtype=”text”maxlength=10size=10name=”valor”value=””></TD></TR><TR> <TDwidth=25%align=right><B>Observação:</B></TD> <TD><INPUTtype=”text”maxlength=40size=40name=”observacao”value=””></TD></TR><TR> <TDwidth=25%align=right><B>NomedoSacado:</B></TD> <TD><INPUTtype=”text”maxlength=30size=30name=”nomeSacado”value=””></TD></TR><TR> <TDwidth=25%align=right><B>CódigodeInscrição(01CPF,02CNPJ):</B></TD> <TD><INPUTtype=”text”maxlength=2size=2name=”codigoInscricao”value=””></TD></TR><TR> <TDwidth=25%align=right><B>NúmerodeInscrição(CPF,CNPJ):</B></TD> <TD><INPUTtype=”text”maxlength=14size=14name=”numeroInscricao”value=””></TD></TR><TR> <TDwidth=25%align=right><B>EndereçodoSacado:</B></TD> <TD><INPUTtype=”text”maxlength=40size=40name=”enderecoSacado”value=””></TD></TR><TR> <TDwidth=25%align=right><B>Bairro:</B></TD> <TD><INPUTtype=”text”maxlength=15size=15name=”bairroSacado”value=””></TD></TR>

<TR> <TDwidth=25%align=right><B>CEP(99999999):</B></TD> <TD><INPUTtype=”text”maxlength=8size=8name=”cepSacado”value=””></TD></TR><TR> <TDwidth=25%align=right><B>Cidade:</B></TD> <TD><INPUTtype=”text”maxlength=15size=15name=”cidadeSacado”value=””></TD></TR><TR> <TDwidth=25%align=right><B>Estado:</B></TD> <TD><INPUTtype=”text”maxlength=2size=2name=”estadoSacado”value=””></TD></TR><TR> <TDwidth=25%align=right><B>DatadeVencimento(ddmmaaaa):</B></TD> <TD><INPUTtype=”text”maxlength=8size=8name=”dataVencimento”value=””></TD></TR><TR> <TDwidth=25%align=right><B>URLretorna:</B></TD> <TD><INPUTtype=”text”maxlength=60size=60name=”urlRetorna”value=””></TD><TR> <TDwidth=25%align=right><B>ObsAdicional1:</B></TD> <TD><INPUTtype=”text”maxlength=60size=60name=”obsAdicional1”value=””></TD></TR><TR> <TDwidth=25%align=right><B>ObsAdicional2:</B></TD> <TD><INPUTtype=”text”maxlength=60size=60name=”obsAdicional2”value=””></TD></TR><TR> <TDwidth=25%align=right><B>ObsAdicional3:</B></TD> <TD><INPUTtype=”text”maxlength=60size=60name=”obsAdicional3”value=””></TD></TR>

</TABLE></CENTER><BR><BR><INPUTTYPE=”submit”value=”Pagar”name=”Pagar”></FORM></BODY></HTML>

Page 53: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

53

AvançarVoltarÍndiceHome5. Exemplo de Códigos5.2ParaAmbientesUnixouLinux5.2.2CriptografiadosDados–CódigoJava

importjava.io.*;importjava.text.*;importjava.util.*;importjavax.servlet.*;importjavax.servlet.http.*;

import Itau.Itaucripto;

publicclassServletCriptoShoplineextendsHttpServlet{privateStringcodigoEmpresa;//Códigodeidentificaçãodaempresa private String chave; // Chave de criptografia da empresa

privateStringpedido;//Identificaçãodopedido private String valor; // Valor do pedidoprivateStringobservacao;//Observações private String nomeSacado; // Nome do sacado privateStringcodigoInscricao;//CódigodeInscrição:01->CPF,02->CNPJprivateStringnumeroInscricao;//NúmerodeInscrição:CPFouCNPJ private String enderecoSacado; // Endereco do Sacado private String bairroSacado; // Bairro do Sacado private String cepSacado; // Cep do Sacado private String cidadeSacado; // Cidade do sacado private String estadoSacado; // Estado do Sacado private String dataVencimento; // Vencimento do títuloprivateStringurlRetorna;//URLdoretornoprivateStringobsAdicional1;//ObsAdicional1privateStringobsAdicional2;//ObsAdicional2privateStringobsAdicional3;//ObsAdicional3

publicvoiddestroy() { }

publicvoiddoGet(HttpServletRequestrequest,HttpServletResponseresponse)throwsServletException,IOException {service(request,response); }

publicvoiddoPost(HttpServletRequestrequest,HttpServletResponseresponse)throwsServletException,IOException {service(request,response); } publicvoidinit() { }

publicvoidservice(HttpServletRequestrequest,HttpServletResponseresponse)throwsServletException,IOException {PrintWriterout=response.getWriter();Stringdados;//Armazenaosdadoscriptografados //InicializaasvariáveiscodigoEmpresa=“J1234567890123456789012345”;//<-ColoqueaquiseuCódigodeEmpresa(26posições)chave=“ABCD123456ABCD12”;//<-Coloqueaquisuachavedecriptografia(16posições) // Recebe valores da página anterior pedido=request.getParameter(“pedido”);//obtémovalordocampo“pedido”valor=request.getParameter(“valor”);//obtémovalordocampo“valor”observacao=request.getParameter(“observacao”);//obtémovalordocampo“observacao”nomeSacado=request.getParameter(“nomeSacado”);//obtémovalordocampo“nomeSacado”codigoInscricao=request.getParameter(“codigoInscricao”);//obtémovalordocampo“codigoInscricao”numeroInscricao=request.getParameter(“numeroInscricao”);//obtémovalordocampo“numeroInscricao”enderecoSacado=request.getParameter(“enderecoSacado”);//obtémovalordocampo“enderecoSacado”bairroSacado=request.getParameter(“bairroSacado”);//obtémovalordocampo“bairroSacado”cepSacado=request.getParameter(“cepSacado”);//obtémovalordocampo“cepSacado”cidadeSacado=request.getParameter(“cidadeSacado”);//obtémovalordocampo“cidadeSacado”estadoSacado=request.getParameter(“estadoSacado”);//obtémovalordocampo

Page 54: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

54

AvançarVoltarÍndiceHome

“estadoSacado”dataVencimento=request.getParameter(“dataVencimento”);//obtémovalordocampo“dataVencimento”urlRetorna=request.getParameter(“urlRetorna”);//obtémovalordocampo“urlRetorna”obsAdicional1=request.getParameter(“obsAdicional1”);//obtémovalordocampo“obsAdicional1”obsAdicional2=request.getParameter(“obsAdicional2”);//obtémovalordocampo“obsAdicional2”obsAdicional3=request.getParameter(“obsAdicional3”);//obtémovalordocampo“obsAdicional3”

//InicializaaclassedecriptografiadoShoplineItaucriptocripto=newItaucripto();//CriptografaosdadoschamandoométodogeraDadosdaclasseItaucriptodados=cripto.geraDados(codigoEmpresa,pedido,valor,observacao,chave,nomeSacado,codigoInscricao,numeroInscricao,enderecoSacado,bairroSacado,cepSacado,cidadeSacado,estadoSacado,dataVencimento,urlRetorna,obsAdicional1,obsAdicional2,obsAdicional3); //Iniciaaconstruçãodapáginaderespostaresponse.setContentType(“text/html”);

out.println(“<html>”);out.println(“<bodybgcolor=\”white\”>”);out.println(“<head>”);out.println(“<title>TesteItaúShopline</title>”);out.println(“</head>”);out.println(“<body>”);out.println(“<h1>ModeloItaú</h1>”); // Constrói o formulário para pagamento com shoplineout.println(“<FORMMETHOD=\”POST\”ACTION=\”https://shopline.itau.com.br/shopline/shopline.aspx\”name=\”form\”onsubmit=carregabrw()target=\”SHOPLINE\”>”);out.println(“<INPUTTYPE=\”hidden\”NAME=\”DC\”VALUE=\””+dados+“\”>”);out.println(“<INPUTTYPE=\”submit\”name=\”Shopline\”value=\”ItaúShopline\”>”);out.println(“</FORM>”);out.println(“<scriptlanguage=\”JavaScript\”>”);out.println(“<!--”);out.println(“functioncarregabrw(){”);out.println(“window.open(‘\’,‘SHOPLINE’,\”toolbar=yes,menubar=yes,resizable=yes,status=no,scrollbars=yes,width=815,height=575\”);”);out.println(“}”);out.println(“//-->”);out.println(“</script>”);out.println(“</body>”);out.println(“</html>”); } }

5. Exemplo de Códigos5.2ParaAmbientesUnixouLinux5.2.2CriptografiadosDados–CódigoJava

Page 55: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

55

AvançarVoltarÍndiceHome5. Exemplo de Códigos5.2ParaAmbientesUnixouLinux5.2.3RetornodoTipodePagamento–CódigoJava

OendereçoparaRetornodoTipodePagamentoserácompostodaseguintemaneira:HTTPS://+URLdeRetornoCadastrada+URLRetornadoPedido+parâmetros de retorno criptografados.

EXEMPLO:

URLdeRetornocadastradanoMóduloItaúShopline=www.minhaloja.com.br

URLretornapassadapelolojistanopedidoemquestão=/final/retorno.aspx

Dadosderetornocriptografados=?DC=A345B456F456W456T56J3K678

ExemplodachamadaàURLfinal:

https://www.minhaloja.com.br/final/retorno.aspx?DC=A345B456F456W456T56J3K678

Apáginaderetornodopagamentodevereceberosdadoscriptografadosechamaro

métododecriptoe,paraacessaroconteúdodecadacampo,énecessáriousarosmétodos

que retornam seus conteúdos:

• retornaCodEmp(),retornaPedido(),retornaTipPag()

EXEMPLO:

CodEmp Código da empresa ou código do site Alfanuméricode26posições

Pedido Número do pedido Numéricocom8posições

TipPag Tipodepagamentoescolhidopelo comprador

Numéricocom02posições:•01parapagamentoàvista(TEFouCDC)•02paraboleto•03paracartãodecrédito

publicvoidservice(HttpServletRequestrequest,HttpServletResponseresponse)throwsServletException,IOException{//Inicializaasvariáveis Stringdados,chave; String codEmp;String pedido;StringtipPag;

chave=“ABCD123456ABCD12”;//<-Coloqueaquisuachavedecriptografia(16posições)

//Recebe valores da página anterior dados=request.getParameter(“DC”);

//InicializaaclassedecriptografiadoShoplineItaucriptocripto=newItaucripto();

//DecriptografaosdadoschamandoométododecriptodaclasseItaucriptoerecebeosdadosdados=cripto.decripto(dados,chave);codEmp=cripto.retornaCodEmp();pedido=cripto.retornaPedido();tipPag=cripto.retornaTipPag();

//iniciaaconstruçãodapaginaderesposta response.setContentType(“text/html”);

out.println(“<html>”); out.println(“<head>”); out.println(“<title>RetornoOnline</title>”); out.println(“</head>”); out.println(“<bodybgcolor=\”white\”>”); out.println(“<h1>RetornoItaú</h1>”);

out.println(dados+“<br>”); out.println(codEmp+“<br>”); out.println(pedido+“<br>”); out.println(tipPag+“<br>”); out.println(“</body>”); out.println(“</html>”);

}

Page 56: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

56

AvançarVoltarÍndiceHome5. Exemplo de Códigos5.2ParaAmbientesUnixouLinux5.2.4ConsultaàSituaçãodoPagamento–CódigoJava

EXEMPLO:publicvoidservice(HttpServletRequestrequest,HttpServletResponseresponse)throwsServletException,IOException{

//Inicializaasvariáveis StringcodEmp,pedido,formato,chave; String dados;

chave=“ABCD123456ABCD12”;//<-Coloqueaquisuachavedecriptografia(16posições) //InicializavalorescodEmp=“J1234567890123456789012345”;//<-Coloqueaquiseucódigodeempresa(26posições)formato=“0” //<-Coloqueaquiotipoderetorno-0ou1dependendodoretorno

//Recebe o pedidopedido=request.getParameter(“pedido”);

//InicializaaclassedecriptografiadoShoplineItaucriptocripto=newItaucripto();

//Realizaacriptografiadosdadosdados=cripto.geraConsulta(codigoEmpresa,pedido,formato,chave);

//Montaoformparaoenviodosdadosaconsulta

out.println(“<formmethod=\”post\”action=\”https://shopline.itau.com.br/shopline/consulta.aspx\”name=\”form\”onsubmit=carregabrw()target=\”shopline\”>”);out.println(“<inputtype=\”hidden\”name=\”DC\”value=\””+dados+“\”>”);out.println(“<inputtype=\”submit\”name=\”Shopline\”value=\”ConsultaaoPagamento\”>”);out.println(“</form>”);

RESULTADO DA CONSULTA EM FORMATO XML

<?xmlversion=”1.0”encoding=”ISO-8859-1”?><!DOCTYPEconsulta[ <!ELEMENTconsulta(PARAMETER)> <!ELEMENTPARAMETER(PARAM)+> <!ELEMENTPARAMEMPTY> <!ATTLISTPARAMIDCDATA#REQUIRED>VALUECDATA#REQUIRED>]><consulta> <PARAMETER> <PARAMID=”CodEmp”VALUE=””/> <PARAMID=”Pedido”VALUE=””/> <PARAMID=”Valor”VALUE=””/> <PARAMID=”tipPag”VALUE=””/> <PARAMID=”sitPag”VALUE=””/> <PARAMID=”dtPag”VALUE=””/> <PARAMID=”codAut”VALUE=””/> <PARAMID=”numId”VALUE=””/> <PARAMID=”compVend”VALUE=””/><PARAMID=”tipCart”VALUE=””/></PARAMETER></consulta>

Page 57: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

57

AvançarVoltarÍndiceHome5. Exemplo de Códigos5.2ParaAmbientesUnixouLinux5.2.5ConsultaàSituaçãodoPagamento–CódigoJava

AreemissãodeboletoéfeitaautomaticamentepelaURLdeemissãonaaplicaçãoItaú Shopline.Seopedidoinformadojáexistiremnossasbasescomomesmovaloreaindanãotiversidopago,éconsideradoumareemissão.Sendoassim,deve-sechamarsempreaURLdeemissão,ousejaamesmaURLutilizadaparafazerachamadadosite.

Page 58: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

58

AvançarVoltarÍndiceHome5. Exemplo de Códigos5.3EnvioeCriptografiadosDados–CódigoPHP

AlinguagemPHPgeralmenteéutilizadaemambienteUNIXouLINUX,maselatambémpodeserutilizadaemambienteWindows.ParaqueachamadadaclasseItaucripto.classocorracomsucessonoPHP,énecessárioqueoservidortenha oambienteJavainstaladoequeaversãoPHPqueestáinstaladanoservidortenhasuporteaJava.AbaixosegueumexemplodeenvioecriptografiadosdadosutilizandoalinguagemPHPparachamadadaURLdoItaúShoplineutilizando a classe ItauCripto.class.

<HTML><HEAD><TITLE>ExemploItaúShopline</TITLE></HEAD>

<BODY>

<FORMaction=”https://shopline.itau.com.br/shopline/shopline.aspx”method=”post”name=”form”onsubmit=carregabrw()target=”SHOPLINE”><CENTER>Dados</CENTER>

<TABLEwidth=”100%”border=1align=center><TR><TDWIDTH=25%ALIGN=center><B>SeuPedido:<B/></TD><TD><?phpecho$row[“pedido”];?></TD></TR><TR><TDWIDTH=25%ALIGN=center><B>TotalaPagar:<B/></TD><TD><?phpecho$row[“valor”];?></TD></TR><TR><TDWIDTH=25%ALIGN=center><B>Observação:<B/></TD><TD><?phpecho$row[“observacao”];?></TD></TR><TR><TDWIDTH=25%ALIGN=center><B>NomedoSacado:<B/></TD><TD><?phpecho$row[“nomeSacado”];?></TD>

</TR><TR><TDWIDTH=25%ALIGN=center><B>CódigodeInscrição:<B/></TD><TD><?phpecho$row[“codigoInscricao”];?></TD></TR><TR><TDWIDTH=25%ALIGN=center><B>NúmerodeInscrição(CPF/CNPJ):<B/></TD><TD><?phpecho$row[“numeroInscricao”];?></TD></TR><TR><TDWIDTH=25%ALIGN=center><B>EndereçodoSacado:<B/></TD><TD><?phpecho$row[“enderecoSacado”];?></TD></TR><TR><TDWIDTH=25%ALIGN=center><B>Bairro:<B/></TD><TD><?phpecho$row[“bairroSacado”];?></TD></TR><TR><TDWIDTH=25%ALIGN=center><B>CEP:<B/></TD><TD><?phpecho$row[“cepSacado”];?></TD></TR><TR><TDWIDTH=25%ALIGN=center><B>Cidade:<B/></TD><TD><?phpecho$row[“cidadeSacado”];?></TD></TR><TR><TDWIDTH=25%ALIGN=center><B>Estado:<B/></TD><TD><?phpecho$row[“estadoSacado”];?></TD></TR><TR><TDWIDTH=25%ALIGN=center><B>DatadeVencimento(ddmmaaaa):<B/></TD><TD><?phpecho$row[“dataVencimento”];?></TD></TR><TR><TDWIDTH=25%ALIGN=center><B>URLdeRetorno:<B/></TD><TD><?phpecho$row[“urlRetorna”];?></TD>

Page 59: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

59

AvançarVoltarÍndiceHome5. Exemplo de Códigos5.3EnvioeCriptografiadosDados–CódigoPHP

</TR>

<TR><TDWIDTH=25%ALIGN=center><B>ObservaçãoAdicional1:<B/></TD><TD><?phpecho$row[“obsAd1”];?></TD></TR>

<TR><TDWIDTH=25%ALIGN=center><B>ObservaçãoAdicional2:<B/></TD><TD><?phpecho$row[“obsAd2”];?></TD></TR>

<TR><TDWIDTH=25%ALIGN=center><B>ObservaçãoAdicional3:<B/></TD><TD><?phpecho$row[“obsAd3”];?></TD></TR>

</TABLE>

<?php

$codEmp=”J0012345678901234567890123”; $pedido=”98988812”; $valor=”0,01”; $observacao=””; $chave=”A3G8E4C19N6W7BPS”; $nomeSacado=””; $codigoInscricao=””; $numeroInscricao=””; $enderecoSacado=””; $bairroSacado=””; $cepSacado=””; $cidadeSacado=””; $estadoSacado=””; $dataVencimento=””; $urlRetorna=””; $obsAd1=””;

$obsAd2=””; $obsAd3=””;

functionCreateObject() { $COM=newJava(‘Itau.Itaucripto’); return$COM; }

$cripto=CreateObject();$dados=$cripto->geraDados($codEmp,$pedido,$valor,$observacao,$chave,$nomeSacado,$codigoInscricao,$numeroInscricao,$enderecoSacado,$bairroSacado,$cepSacado,$cidadeSacado,$estadoSacado,$dataVencimento,$urlRetorna,$obsAd1,$obsAd2,$obsAd3); //echo“<br><br>”.$dados;

? >

<CENTER> <BR><BR><INPUTtype=”hidden”name=”DC”value=”<?echo$dados;?>”> <BR><INPUTtype=”submit”name=”Shopline”value=”ItaúShopline”></FORM>

<scriptlanguage=”JavaScript”> functioncarregabrw() { window.open(‘’,’SHOPLINE’,”toolbar=yes,menubar=yes,resizable=yes,status=no,scrollbars=yes,width=815,height=575”); } </script>

<BODY></HTML>

Page 60: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

60

AvançarVoltarÍndiceHome6. Auxílio à Instalação do Itaú Shopline6.1MensagemdeErrodeSistema

Veja a seguir as possíveis mensagens de erro de sistema e as providências a serem tomadas.

Mensagem Providências

Cep inválido. Verificarocampodeentrada“cepSacado”nachamadadomóduloItaúShopline.Estedevesernuméricocom8posições(99999999).

Código de inscrição inválido. Verificarocampodeentrada“CodigoInscricao”nachamadadomóduloItaúShopline.Estedeveser“01”paraCPFe“02”paraCNPJ.

Código do sacado inválido. Idemaoerro“Códigodeinscriçãoinválido.”

Data de vencimento inválida. Verificarocampodeentrada“dataVencimento”nachamadadomóduloItaúShopline.Estedevesernuméricode8posiçõesnoformato“DDMMAAAA”.

Erro 9 - contate o Atendimento Cese. ContateoatendimentoCesenotel:0XX(11)30194828,informandoseuCNPJ,onomedesiteesoliciteavalidaçãodeseucontrato.

Erro na decriptografia dos dados. Erronadecriptografia–tentenovamente.

Formato inválido. Idemaoerro“Númerodopedidonãoénumérico.”

Número de inscrição inválido. Verificarocampodeentrada“NumeroInscricao”nachamadadomóduloItaúShopline.Estedevesernuméricocom14posições(99999999999999).

Número do pedido inválido. Verificaraconsistênciadocampodeentrada“pedido”nachamadadomóduloItaúShopline.Estedevesernuméricocom8posições(99999999).

Número do pedido não é numérico. Verificaraconsistênciadocampodeentrada“pedido”nachamadadomóduloItaúShopline.Estedevesernuméricocom8posições(99999999).

Tamanho da chave diferente de 16 posições. Verificarocampodeentrada“Chave”nachamadadomóduloItaúShopline.

Tamanho do código da empresa diferente de 26 posições. Verificarocampodeentrada“CodEmp”nachamadadomóduloItaúShopline.

Valor da compra deve possuir no máximo 8 posições antes da vírgula.

Verificaraconsistênciadocampodeentrada“valor”nachamadadomóduloItaúShopline.Estedevesernuméricocom10posições,sendo8casasinteirase2casasdecimais,separadasobrigatoriamenteporvírgula(99999999,99)

Valor da compra inválido. Verificaraconsistênciadocampodeentrada“valor”nachamadadomóduloItaúShopline.Estedevesernuméricocom10posições,sendo8casasinteirase2casasdecimais,separadasobrigatoriamenteporvírgula(99999999,99)

Valor da compra não é numérico. Verificaraconsistênciadocampodeentrada“valor”nachamadadomóduloItaúShopline.Estedevesernuméricocom10posições,sendo8casasinteirase2casasdecimais,separadasobrigatoriamenteporvírgula(99999999,99)

Valor decimal da compra deve possuir 2 posições após a vírgula.

Verificaraconsistênciadocampodeentrada“valor”nachamadadomóduloItaúShopline.Estedevesernuméricocom10posições,sendo8casasinteirase2casasdecimais,separadasobrigatoriamenteporvírgula(99999999,99)

Valor decimal não é numérico. Verificaraconsistênciadocampodeentrada“valor”nachamadadomóduloItaúShopline.Estedevesernuméricocom10posições,sendo8casasinteirase2casasdecimais,separadasobrigatoriamenteporvírgula(99999999,99)

Page 61: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

61

AvançarVoltarÍndiceHomeAnexos DemonstrativosA.TelasreferentesaoMóduloItaúShopline

Vejaaseguiropassoapassodaconfiguraçãodaconta-correntedeseusite para uso do Itaú Shopline:

Tela do Menu Cobrança Tela de Criação da Chave

Page 62: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

62

AvançarVoltarÍndiceHomeAnexos DemonstrativosA.TelasreferentesaoMóduloItaúShopline

Tela de Criação da Chave

Aoacessarafunçãopelaprimeiravez,seránecessárioconfigurarumdoscódigos

dehabilitaçãodeseusite,criandosuaChavedeCriptografiaconformearegra

deformaçãodisponívelnatela.

Nasequência,consultee/ouatualizeasinformaçõescadastraisdeseusiteecopieaChave

deCriptografiarecém-criadaeoCódigodeSitefornecidopelobancoparaposteriormente

informá-losaoresponsávelpelainstalaçãodoItaúShoplineemseusite.

Tela de Informações Cadastrais

Page 63: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

63

AvançarVoltarÍndiceHomeAnexos DemonstrativosA.TelasreferentesaoMóduloItaúShopline

Tela de Regra da Chave Tela da Mensagem Pós-Validação das Informações Cadastrais

Clique aqui para voltar ao item 2.1.destemanualtécnico.

Page 64: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

64

AvançarVoltarÍndiceHomeAnexos DemonstrativosB.TeladoAmbientedeTestedoItaúShopline:

Tela de Emissão do Boleto em Ambiente de Teste:

Page 65: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

65

AvançarVoltarÍndiceHomeAnexos DemonstrativosB.TeladoAmbientedeTestedoItaúShopline:

Tela de Emissão do Boleto em Ambiente de Teste:

EstaéateladeemissãodoboletoapósoacessoàURLhttps://shopline.itau.com.br/shopline/emissao_teste.asp, acionada pelo próprio desenvolvedor do site no momentodainstalaçãodoItaúShopline.

Seateladeemissãodoboletoacimafoiexibida,osparâmetrosforamenviadoscorretamente pela loja virtual.

Nocampocedentedeveapareceronomedositeemquestão,assimcomo os demais dados enviados deverão aparecer nos outros campos. Caso haja algumproblemacomemissãodeparâmetrosoualgumoutroproblema, umamensagemdeinconsistênciavaiserexibidanateladeemissão.

Atenção:oendereçodoAmbientedeTestedoprodutonãodeveráserapresentadoaos compradores do site como forma de acesso ao meio de pagamento ItaúShopline,poisnelenãoépossívelefetuaroperaçãoalguma.EstaURLéapenasparaverificarsehouvesucessonoenviodosdados.

Clique aqui para voltar ao item 2.2.destemanualtécnico.

Page 66: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

66

AvançarVoltarÍndiceHomeAnexos DemonstrativosC.TelasprincipaisdaPlataformaItaúShopline:

Tela Inicial do Itaú Shopline:

EstatelaégeradaapósocorretoacessoàURLhttps://shopline.itau.com.br/shopline/shopline.aspx, acionada pelo comprador no ambiente do site. Neste momento o banco recebeu corretamente os parâmetros necessários criptografados pelo site.

No campo onde está escrito LOJA VIRTUAL SIMULADA aparecerá o NOME DO SITE cadastradonosistemadoprodutoàépocadacontratação.Paraconferirseucadastro,bastaacessarafunçãoInformaçõesCadastraisdoMóduloItaúShoplineacessado via Itaú Empresas na internet.

AtelainicialdoItaúShoplineapresentatodasasopçõesdepagamentohabilitadasparaositeedispostasdaseguintemaneira:primeiroasopções queserãoacessadasemambienteseguroItaú30horas,portanto,paraacessá-lasocompradordositedeverápossuirseusdadosdeagência,conta-corrente,senhaeletrônicaesenhadecartãojuntoaobanco.Emsegundolugar,aopçãodepagamentodisponívelatodososclientesdositequesãocartãodecrédito e boleto bancário.

SeocompradordositequiseracessarasopçõesdisponíveisparaClientes com Acesso ao Itaú 30 horas deverádigitarseusdadosdeacessoaoItaú30horasapósaescolhadeÀvistaouParcelado.SeoclienteescolheraopçãoParcelado eologindocompradornãotivercréditopré-aprovadojuntoaobanco,estaopçãonãoapareceráparaelenasegundatela,mesmoqueositeaceiteestaforma depagamento,seráexibidaaformadepagamentoÀvista. Apartirdaqui,ocompradornavegaráportelasespecíficasdecadaumadasopções depagamentopossíveisatéchegaraocomprovantedepagamentodesuatransaçãoqueéapresentadoparaasopções:pagamentoàvistaportransferência,parceladoporCrediárioAutomáticoItaúecartãodecrédito.Seescolheraopçãoboletobancário,irávisualizá-loemsuatelaepoderáimprimi-looupagá-lopeloItaú30horasoucomopreferir(internetbanking,caixaeletrônicoouagência)respeitando as regras.

SeocompradordositequiseracessaraopçãodisponívelparaClientes sem Acesso ao Itaú 30 horasimediatamentevisualizará,nateladeseucomputador, oboletobancáriodoItaúShopline,geradopelobancosoboregistronacarteiradecobrança176.Esteboletojáestarátotalmentepreenchidoeapresentará,alémdovalordacompraedonodopedidojácitados,todososcamposadicionaisenviadospelosite(conformeinstruçõesdoitem4.1destemanual).Clique aqui para voltar ao item 2.2.destemanualtécnico.

Page 67: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

67

AvançarVoltarÍndiceHomeAnexos DemonstrativosD.TeladoboletobancáriodoItaúShopline:

AteladoboletobancárioemitidopelaprimeiraveznaPlataformadeCobrançaItaúShopline,sejapelocaminhodeClientes com Acesso ao Itaú 30 horas ou pelo caminho de Clientes sem Conta no Itaú,éexatamenteigualàteladoboletoreemitido.

Clique aqui para voltar ao item 2.3.destemanualtécnico.

Page 68: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

68

AvançarVoltarÍndiceHomeAnexos DemonstrativosE.TelasdeexemplodaconsultadeoperaçõesdoMóduloItaúShopline:

ParaconheceroMódulo Itaú Shopline,acesseoItaúEmpresasnainternet naconta-correntedositeesigaarota:Cobrança>ItaúShopline> ConsultadeOperações:

Itaú Empresas na internet: Recebimentos > Itaú Shopline:

Clique aqui para voltar ao item 2.5.1.destemanualtécnico.

Page 69: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

69

AvançarVoltarÍndiceHomeAnexos Demonstrativos

LembramosqueparaprogramaraleituradoArquivoRetornoeintegrá-lo aosistemadeconciliaçãobancáriadesuaempresa,énecessárioobteroManualdeIntercâmbiodeArquivosqueespecificatodososcamposqueserãoinformadosnoArquivoRetornodeCobrança.ParaconhecerolayoutdaCobrançaItaú,acesseaconta-correntepeloItaúEmpresasnainternetesigaarota:ProdutoseServiços>DownloadCenter>Cobrança–ManualdeIntercâmbiodeArquivos.

Clique aqui para voltar ao item 2.5.2.destemanualtécnico.

F.TelasdeexemplodoArquivoRetornodeCobrança:

Page 70: Itaú Shopline - Expert · área de reserva da marca Itaú para seu uso neste ícone. Esta reserva indica o mínimo de distância que se deve ter da marca para preservarmos sua leitura.

70

VoltarÍndiceHome

G.TeladeexemplodaConsultaAutomáticaàSituaçãodoPagamento(sonda):

Anexos Demonstrativos

Clique aqui para voltar ao item 2.5.3.destemanualtécnico.

Retorno da Consulta em em XML:

Retorno da Consulta em HTML: