AprovaFcil

IntegraoviaCobreBemX

AprovaFcilIntegraoviaCobreBemXVerso1.2.11.10.13 http://www.cobrebem.com/

PrezadoCliente,

ApresentamosaseguiroManualdeintegraodoAprovaFcilviaCobreBemX.

Nota: PordefaultosistemaAprovaFcilhabilitaosnovosusuriosnoSTAC,comoforma de integrao, quando comrcio eletrnico. Por essa razo, para realizar a integrao via CobreBemX imprescindvel que entre em contato com o nosso suporte e solicite a desabilitaodessaopo. Recomendamos que, antes de comear a implementao atravs do Componente CobreBemX, efetuealeituradoitem1.1destemanualpoiscontmosprrequisitosparautilizaodomesmo. Esperamos atravs desta documentao orientlo da melhor forma possvel e aproveitamos a oportunidadeparacolocarnossuadisposioparamaioresesclarecimentos. Paraentraremcontatoconosco,utilizeoscanaisdecontatodisponibilizadosnaURLabaixo: http://www.cobrebem.com/contato.html Nota:DeacordocomasexignciasdoPCIDSSaCobreBemTecnologianoautorizadaa receber nmeros de carto de crdito. Caso necessite de suporte em relao a alguma transaoefetuada,nosinformeonmerodatransao.

BoascobranaseCobreBem! EquipeCobreBem
AprovaFcilIntegraoviaCobreBemXVerso1.2.11.10.13 http://www.cobrebem.com/

NDICE 1.Introduo..........................................................................................................................................................................4 1.1PrRequisitos...............................................................................................................................................................4 2.Download............................................................................................................................................................................5 3.RegistrodoCobreBemX...................................................................................................................................................6 3.1RegistrodaDLLviainstalador....................................................................................................................................6 3.2RegistrodaDLLviaRegSRV32..................................................................................................................................6 3.3.RegistrocomWindowsServer2003..........................................................................................................................6 4.HierarquiadosObjetos.....................................................................................................................................................7 5.ImplementandooAprovaFcilusandooCobreBemX.................................................................................................9 5.1.CriandoaInstnciadoCobreBemX...........................................................................................................................9 5.2.SetandoPropriedadesdeusoGeral...........................................................................................................................10 5.3.Criandoumdocumentodecobrana.........................................................................................................................10 5.4.PropriedadesdeSolicitaodeAprovao...............................................................................................................10 5.5.ExemplodePedidodeAprovaoCartodeCrdito..............................................................................................14 5.6.AgendamentoDescrio.........................................................................................................................................15 5.7.RecorrnciaDescrio............................................................................................................................................17 5.8.ConsultaAVS(AdressVerificationService)...........................................................................................................18 5.9.ResultadodoProcessamentodeumaTransao......................................................................................................19 5.10.CapturandoumaTransao....................................................................................................................................23 5.11.CancelandoumaTransao(ApenasparaCartodeCrdito)...............................................................................24 6.Exemplos...........................................................................................................................................................................25 7.OrientaesparaConfiguraoServidorDNS...........................................................................................................26 7.1.TesteparaverificaraConfiguraodoServidorDNS.............................................................................................26 8.DiagramadeFuncionamento.........................................................................................................................................27

AprovaFcilIntegraoviaCobreBemXVerso1.2.11.10.13 http://www.cobrebem.com/

1.Introduo
OCobreBemXumaSoluodaCobreBemTecnologiacriadaparaintegraraplicaesdesenvolvidasem diversaslinguagensediversosmeiosdepagamento,taiscomo:BoletoBancrio,DbitoAutomticoemContaCorrente etambmefetuaraintegraocomoAprovaFcilagregandoCartodeCrdito,TransfernciaEletrnica.Vocpoder utilizar o CobreBemX para integrar o Aprova Fcil ao seu aplicativo desenvolvido em qualquer linguagem de programao32bits.

1.1PrRequisitos
PlataformaWindows

Por se tratar de um componente COM+ (dll) necessita que o servidor/computador onde a dll ser instaladasejaWindows. Permissopararegistraradllnosistema

Normalmentequandoutilizadaumahospedagemcompartilhadaainstalaoouregistrodecomponentes ouDLLsnoservidorvetada,casovocutilizeestetipodehospedagemconversecomseuhostparaverificara possibilidadedainstalao,essainstalaonormalmentepermitidaemservidoresdedicadosesemidedicados ondeousuriotemacessoaadministraodoIISedoWindows.

AprovaFcilIntegraoviaCobreBemXVerso1.2.11.10.13 http://www.cobrebem.com/

2.Download
EfetueodownloaddoCobreBemXacessandoaURLabaixo.

http://www.cobrebem.com/downloads/cbx/InstalarCobreBemX.zip

Odownloadcontmaseguinteestrutura: /InstalarCobreBemX/CobreBemX/ ...Desinstalar.exe ...Instalar.exe ...CobreBemX.dll ...CobreBemX.tlb

AprovaFcilIntegraoviaCobreBemXVerso1.2.11.10.13 http://www.cobrebem.com/

3.RegistrodoCobreBemX
OCobreBemXdeverserregistradonoWindows.Oregistropoderserefetuadodeduasformas: ViainstaladorexistentenodownloaddoCobrebemX; ViaComandoRegSRV32+CobreBemX.dll.

3.1RegistrodaDLLviainstalador
ExecuteoarquivoInstalar.exe.SerabertoumpromptdoDOSinformandoqueadlljfoiregistrada.

3.2RegistrodaDLLviaRegSRV32
1.VemIniciardepoisemExecutar; 2.Informeaseguintelinha:regsvr32<diretorio>+<nomedadll>. Onde: <diretorio>olocalondeselocalizaaddle<nomedadll>adlldoCobrebemX.

3.3.RegistrocomWindowsServer2003
AcesseaURLabaixoparavisualizarospassosparaaatualizaodoWindowsServer2003parao ServicePack2. http://www.cobrebem.com/sp2.html

AprovaFcilIntegraoviaCobreBemXVerso1.2.11.10.13 http://www.cobrebem.com/

4.HierarquiadosObjetos
ContaCorrente ArquivoLicencaCartoesCredito ArquivoLicencaCartoesCreditoTextoString CnpjCpfCedenteString ConfirmaAprovacaoCartao[Index:Integer]String DocumentosCobrancaIDocumentosCobranca . . . . . . . . . . . . . . . . . . . . . . . . . . . AddIDocumentoCobranca . . . . . . . . . . . . . . . . . . . . . . . . . . CartaoCreditoICartaoCredito . . . . . . . . . . . . . . . . . . . . . . . . . AnoValidadeInteger ApenasCartoesEmitidosBrasilBoolean ApenasCpfCnpjRegularesBoolean ApenasCpfCnpjValidosBoolean AVSBoolean BancoEmissorString BandeiraString CartaoMascaradoString CodigoAutorizacaoString CodigoSegurancaString ComprovanteAdministradoraString CupomFiscalString DiaParaAgendarInteger EnderecoIPCompradorString EnviarRespostaAoNavegadorBoolean ExcluiAgendamentoBoolean IdiomaString IncluiAgendamentoBoolean MesValidadeInteger NacionalidadeEmissorString NumeroString NumeroSequencialUnicoString NumeroTentativasNaoAprovadoInteger ParcelamentoAdministradoraBoolean QuantidadeDiasEntreTentativasInteger 7

AprovaFcilIntegraoviaCobreBemXVerso1.2.11.10.13 http://www.cobrebem.com/

. . . . . . . . . . . . . . . . . . Mtodos: . . . . . Mtodos:

. . . . . . . . . . . . . . . CountInteger

. . . . . . .

QuantidadeMesesParaAgendarInteger QuantidadeParcelasInteger ResultadoConsultaAVSString ResultadoSolicitacaoAprovacaoString TipoTecnologiaString TransacaoString TransacaoAprovadaBoolean

CepSacadoString CidadeSacadoString CNPJSacadoString CPFSacadoString EnderecoSacadoString EstadoSacadoString NumeroDocumentoString ValorDocumentoDouble

Item[Index:Integer]IDocumentoCobranca UtilizaCacheDiscoBoolean Clear Delete(Index:Integer) PadroesAprovacaoCartoesIPadroesAprovacaoCartoes UltimaMensagemErroString VersaoString

CancelaAprovacaoCartao[Index:Integer]String CarregaResultadoAprovacaoCartao[Index:Integer]Boolean ConfirmaAprovacaoCartao[Index:Integer]String SolicitaAprovacaoCartao[Index:Integer]Boolean

AprovaFcilIntegraoviaCobreBemXVerso1.2.11.10.13 http://www.cobrebem.com/

5.ImplementandooAprovaFcilusandooCobreBemX
Como j informamos anteriormente, o CobreBemX um Componente COM+ no visual. Ele possui propriedades,objetosemtodosespecficosparaefetuartransaescomcartesdecrditoeTransfernciaEletrnica. AntesdecomearaimplementaocertifiquesedequeaDLLfoidevidamenteinstaladaemseuservidoreque vocpossuialicenadetesteouadeproduo. Licenadeteste:http://www.cobrebem.com/downloads/apf/LicencaAprovaFacilTeste.zip LicenadeProduo: Efetueo downloaddaLicenaemsuareaadministrativa doAprovaFcil (reade extratohttps://www.aprovafacil.com/apf). EmumresumosimplesdecomoutilizaroComponente,dividimosempartesoseucdigo.Vejaabaixo: 1CriarainstnciadoCobreBemXnoseucdigo; 2Passarvaloresparapropriedadesdeusogeral; 3AdicionarumaCobrana(Transao); 4AplicaromtododeSolicitaodeAprovao; 5AnalisaroresultadoeAplicaromtododeconfirmaocasoTransaoAprovada. E,casosejanecessrio: 6CancelarumaTransao.

5.1.CriandoaInstnciadoCobreBemX
ParautilizarasfuncionalidadesdoCobreBemXsernecessrioInstncialoemseucdigo,verifiqueo manualdasualinguagemdeprogramoparasabercomofeitaacriaodeumObjeto,ainstnciaserdo objetoraizdoCobreBemXdemoninadoContaCorrenteabaixoestumexemplodecomofazernalinguagem ASP.

AprovaFcilIntegraoviaCobreBemXVerso1.2.11.10.13 http://www.cobrebem.com/

Exemplo: setcbx=Server.CreateObject("CobreBemX.ContaCorrente")

5.2.SetandoPropriedadesdeusoGeral
Algumaspropriedadesdevemsersetadasparausogeral,propriedadesqueantecedemoprocessode realizaodatransaotaiscomocaminhodoarquivodelicenaemododeoperao. Exemplo: cbx.ArquivoLicencaCartoesCredito="C:\CobreBemX\Licencas\cartaoteste.conf" cbx.PadroesAprovacaoCartoes.ModoOperacao=2

5.3.Criandoumdocumentodecobrana

Antesdautilizaodomtodosernecessrioacrescentarumnovodocumentodecobrana,queser encarregado de levar as informaes correspondentes transao como valor, quantidade de parcelas etc, utilizamosapropriedadeAdddoobjetoIdocumentosCobranca. Exemplo: setCartao=cbx.DocumentosCobranca.Add

5.4.PropriedadesdeSolicitaodeAprovao

5.4.1.TransfernciaEletrnica

Nome NumeroDocumento ValorDocumento*

Descrio vendapelaloja. Valordatransao

Formatao

Exemplo 123ABC 123.56

Obrigatrio No Sim

Identificao da At50caracteresalfanumricos. Numrico, sendo as casas decimais separadasporponto(.)

AprovaFcilIntegraoviaCobreBemXVerso1.2.11.10.13 http://www.cobrebem.com/

10

Nome

Descrio ABNREAL BBRASIL BANRISUL BRADESCO HSBC ITAU UNIBANCO

Formatao Valoresvlidosso:

Exemplo

Obrigatrio

Bandeira

Nomedobanco

BRADESCO

Sim

CNPJCPFSacado

ID CPF ou CNPJ 14dgitosnumricos docliente 11dgitosnumricos

12345678123412 12345678912

No

*OAprovaFcilnoefetuanenhumtipodeconversodemoedas.Sendoassim,ovalordatransao informadoaoAprovaFcildeversempreseremReal.

5.4.2.CartodeCrdito

Aspropriedadesaseremutilizadasdependemdatecnologiadeconectividadehabilitadapara seuestabelecimentoemcadaAdministradoradeCartodeCrdito.Sendoassim,seguemabaixotabelas queilustramosparmetrosaseremadotadosemcadatecnologiadeconectividade.

Tecnologias:TEFDedicado/MoSet/WebPOS/KomerciWebService

Propriedade NumeroDocumento ValorDocumento* loja.

Descrio Identificao da venda pela

Formatao At50caracteresalfanumricos. Numrico, sendo as casas decimaisseparadasporponto(.) 02dgitosnumricos 000.000.000.000 000000000000

Exemplo 123ABC 123.56 01 ou 123.123.123.123

Obrigatrio

no sim sim sim no

Valordatransao

QuantidadeParcelas Quantidadedeparcelas EnderecoIPCompra EndereoIPdoComprador dor Idioma

Idioma a ser utilizado na PTB (Portugus), ENG (Ingls), PTB soluo de automao das ESP(Espanhol) Administradorasdecartes
AprovaFcilIntegraoviaCobreBemXVerso1.2.11.10.13 http://www.cobrebem.com/

11

Propriedade Numero

Descrio

Formatao 83

Exemplo

Obrigatrio

Nmerodocartodecrdito At19dgitosnumricos

45518700000001 simsetecnologia deferentede WebPOS

MesValidade

Msemqueocartoexpira

02dgitosnumricos

11

simsetecnologia diferente WebPOS de

PreAutorizacao AnoValidade

**Vejadescrioabaixo Anoemqueocartoexpira

TrueouFalse 02dgitosnumricos

True 08

No simsetecnologia diferente WebPOS de

CodigoSeguranca

CVC2/CVV2docarto

At04dgitosnumricos

123

no. No utilizar casoatecnologia seja Komerci WebService***

Bandeira

Bandeira do Carto de VISA Crdito MASTERCARD DINERS AMEX HIPERCARD JCB SOROCRED AURA

VISA

No

NomeMaePortador Nomedamedoportadordo At50caracteresalfanumricos Cartao carto

MariadosSantos No

*OAprovaFcilnoefetuanenhumtipodeconversodemoedas.Sendoassim,ovalordatransao informadoaoAprovaFcildeversempreseremReal. ** APrautorizaoobloqueiotemporriodeumaquantianocartodecrdito,comobjetivode garantirasuareserva;umrecursoquepodeserutilizadonatecnologiadeconectividadeKomerci WebService(Redecard).Otipodevendaquecontmesserecursosomenteutilizadoemprojetos especiaisquetenhamessanecessidade. ***PordeterminaodaRedecardoCVV2nodevesersolicitadodocompradorquandoatecnologia

AprovaFcilIntegraoviaCobreBemXVerso1.2.11.10.13 http://www.cobrebem.com/

12

utilizadaforKomerciWebService.

Tecnologia:VerifiedByVisa

Propriedade NumeroDocumento ValorDocumento* QuantidadeParcelas or Numero Idioma VisaElectron Bandeira artao

Descrio

Formatao numrico,sendoascasasdecimais separadasporponto(.) 2dgitosnumricos

Exemplo 123ABC 123.56 01 3

Obrigatrio no sim sim

Identificaodavendapelaloja. At50caracteresalfanumricos. Valordatransao Quantidadedeparcelas

EnderecoIPComprad EndereoIPdoComprador Bindocartodecrdito Cielo Informaseocartoaser debitadoVisaElectron BandeiradoCartodeCrdito carto

000.000.000.000ou000000000000 123.123.123.12 sim 6dgitosnumricos ESP=Espanhol TrueouFalse VISA False VISA Maria Santos no No dos No 455187 ESP sim no

Define o idioma da janela da PTB=PortugusENG=Ingls

NomeMaePortadorC Nome da me do portador do At50caracteresalfanumricos

*OAprovaFcilnoefetuanenhumtipodeconversodemoedas.Sendoassim,ovalordatransao informadoaoAprovaFcildeversempreseremReal. Tecnologia:Komerci

Propriedade NumeroDocumento ValorDocumento* QuantidadeParcelas or loja.

Descrio Identificao da venda pela

Formatao

Exemplo

Obrigatrio no sim sim sim

At50caracteresalfanumricos. 123ABC numrico, sendo as casas decimaisseparadasporponto(.) 2dgitosnumricos 000.000.000.000 000000000000 123.56 01 ou 123.123.123.123

Valordatransao Quantidadedeparcelas

EnderecoIPComprad EndereoIPdoComprador

AprovaFcilIntegraoviaCobreBemXVerso1.2.11.10.13 http://www.cobrebem.com/

13

Propriedade Bandeira

Descrio Bandeiradocarto.

Formatao Caracteresemmaisculo Preechimento: DINERS ou MASTERCARD

Exemplo MASTERCARD

Obrigatrio sim

Idioma AVS

Define oidioma da janela da PTB=PortugusENG=Ingls Redecard Valores:FalseNorealizar TruePararealizarconsulta ESP=Espanhol TrueouFalse

ESP True

no sim

URLImagemSuperio Defineaimagemaserexibida URL rKomerci artao naRedecard. carto

http://www.seusite.c no om.br/imagem.jpg No

NomeMaePortadorC Nomedamedoportadordo At50caracteresalfanumricos MariadosSantos

*OAprovaFcilnoefetuanenhumtipodeconversodemoedas.Sendoassim,ovalordatransao informadoaoAprovaFcildeversempreseremReal.

5.5.ExemplodePedidodeAprovaoCartodeCrdito

TEFDedicado,KomerciWebService,MoSet,WEBPos

##CriaainstnciadoObjeto## cbx.ArquivoLicencaCartoesCredito="C:\CobreBemX\Licencas\cartaoteste.conf" cbx.PadroesAprovacaoCartoes.ModoOperacao=2 ##AdicionaNovoDocumentodeCobrana## setCartao=cbx.DocumentosCobranca.Add ##Propriedadesreferentestransao## Cartao.ValorDocumento=123.45 Cartao.CartaoCredito.QuantidadeParcelas=1 Cartao.CartaoCredito.Numero="4444333322221111" Cartao.CartaoCredito.MesValidade=12 Cartao.CartaoCredito.AnoValidade=10 Cartao.CartaoCredito.CodigoSeguranca="9999" ##Mtodoparasolictaraaprovao## Aprovada=cbx.SolicitaAprovacaoCartao(0)
AprovaFcilIntegraoviaCobreBemXVerso1.2.11.10.13 http://www.cobrebem.com/

14

Komerci,VerifiedByVisa ##CriaainstnciadoObjeto## cbx.ArquivoLicencaCartoesCredito="C:\CobreBemX\Licencas\cartaoteste.conf" cbx.PadroesAprovacaoCartoes.ModoOperacao=2 ##AdicionaNovoDocumentodeCobrana## setCartao=cbx.DocumentosCobranca.Add ##Propriedadesreferentestransao## Cartao.ValorDocumento=123.45 Cartao.CartaoCredito.QuantidadeParcelas=1 Cartao.CartaoCredito.Numero="444433" ##Mtodoparasolictaraaprovao,nocasodeKomercieVBV,apenaspreparaosparmetrosde acordocomatecnologia## Aprovada=cbx.SolicitaAprovacaoCartao(0) ##Chamaoambientesegurodaadministradora## ifBoleto.CartaoCredito.EnviarRespostaAoNavegadorthen Response.Write(Boleto.CartaoCredito.ResultadoSolicitacaoAprovacao)

5.6.AgendamentoDescrio

Oagendamentodetransaesutilizado,quandohanecessidadedeefetuarmensalmenteodbitono cartodecrditodoclientemantendosempreasmesmascondies: Mesmovalor; Dbitomensalrealizadosemprenomesmodia.

OagendamentorealizadodeformaautomticapeloAprovaFcil. Importante:Paraqueoagendamentosejaaceitonecessrioqueaprimeiratransaotenhasido aprovadapelaAdministradoradeCartodeCrditoeconfirmadapeloLojita.Casocontrrio,no serrealizadooagendamento.

AprovaFcilIntegraoviaCobreBemXVerso1.2.11.10.13 http://www.cobrebem.com/

15

5.6.1.AgendamentoTecnologiadeConectividade Oagendamentosuportadonasseguintestecnologiasdeconectividade:TEFDedicado,MoSet (Cielo),KomerciWebService(Redecard)eWebPos(Amex). 5.6.2.AgendamentoPropriedadesUtilizadasparaAgendarumaTransao

As propriedades de requisio, pertencentes ao objeto ICartaoCredito, exibidos na tabela abaixo,devemserenviadosnaprimeirasolicitaodedbitodocartodecrditojuntamentecomos demaisdadosdopedido. NestecasoapropriedadeNumeroDocumentopassaaserobrigatria,no podersernulaedeversernica.

Nome IncluiAgendamento DiaParaAgendar

Descrio agendamento Dia que ser feito o dd dbito

Formatao

Exemplo True 09

Obrigatrio Sim Se IncluiAgendamento =True

Utilizado Incluir um TrueIncluir

QuantidadeMesesParaAgendar

Quantidadedemesesa 2dgitosnumricos debitar

08

Se IncluiAgendamento =True

NumeroTentativasNaoAprovado

Tentativaspara aprovao

2dgitosnumricos

04

Se IncluiAgendamento =True

QuantidadeDiasEntreTentativas

Dias entre cada 2dgitosnumricos tentativa

03

Se IncluiAgendamento =True

Nota:Noagendamento,quemrealizaacapturadatransaooAprovaFcil.

AprovaFcilIntegraoviaCobreBemXVerso1.2.11.10.13 http://www.cobrebem.com/

16

5.6.3.AgendamentoPropriedadesUtilizadasparaExcluirumAgendamento

Nome ExcluiAgendamento Transacao

Descrio agendamento Nmerodatransaoquecriou 14 oagendamento

Formatao

Exemplo True Sim

Obrigatrio

Utilizado para Excluir um TrueExcluir

caracteres 78712879 Se 871121 ExcluiAgendamento=True

numricos

5.7.RecorrnciaDescrio
Arecorrnciadetransaesutilizada,quandohanecessidadedeefetuarnovosdbitosemumcarto decrdito,sendoestadequalquerperiodicidade;havendonecessidade, possvelalterarovalordodbitoa cadacobrana.Oprocessoderecobranaemumarecorrncia,diferentedoagendamento,poiscomandado pelaaplicaodolojista,nestecasonecessrioinformarapenasonmeroqueidentificaaltimatransao aprovadaeconfirmada,sendoeste,representadopeloparmetroTransacao. Nota: ONmero daTransao criadoautomaticamentepeloAprovaFcil com objetivode identificarcadatransao.Estenmeronicoejamaisserrepetido. 5.7.1.RecorrnciaTecnologiasdeConectividade Arecorrnciadetransaessuportadapelastecnologiasdeconectividade:TEFDedicado, MoSet(Cielo),KomerciWebService(Redecard)eWebPos(Amex). AAdministradoradeCartodeCrditoCielooferecetrsopesdeCVV2(digitada,chipe trilha).ParatrabalharcomrecorrnciautilizandoatecnologiadeconectividadeTEF4.1,necessrio desabilitaraopodigitadadeCVV2.

5.7.2.RecorrnciaParmetrosdeRequisio

Nome Transacao

Descrio NmerodaTransao

Formatao 14caracteresnumricos

Exemplo

Obrigatrio

78712879871121 Sim

AprovaFcilIntegraoviaCobreBemXVerso1.2.11.10.13 http://www.cobrebem.com/

17

Nome ValorDocumento* QuantidadeParcelas

Descrio Valordatransao Quantidadedeparcelas

Formatao Numrico,sendoascasasdecimais separadasporponto(.) 02dgitosnumricos

Exemplo 123.56 01

Obrigatrio Sim Sim

* OAprovaFcilnoefetuanenhumtipodeconversodemoedas.Sendoassim,ovalorda transaoinformadoaoAprovaFcildeversempreseremReal.

5.8.ConsultaAVS(AdressVerificationService)

OAVSumserviooferecidopelasAdministradorasdeCartodeCrdito,paraqueolojistapossa realizarumaconsultaparaconfirmaodosdadosdeCPF(CadastroPessoaFsica)edoendereodeentregada faturadotitulardocartonoatodacompra. Para disponibilizar essa consulta, o estabelecimento dever habilitar esse servio junto s AdministradorasdeCartodeCrdito,e,aps,informarCobreBemTecnologiaqueamesmaserutilizada. AconsultaAVSsuportadaparaasbandeirasAmexeMastercard,nastecnologiasdeconectividade WebPos,KomercieKomerciWebService,respectivamente. SeoestabelecimentodolojistapossuirhabilitaopararealizarvendascomAVS,nomomentoda solicitaodosdados,deveroserinformadostambmosparmetrosderequisioaseguir:

Tecnologia:Komerci

Nome AVS

Descrio Valores:FalseNorealizar TruePararealizarconsulta

Formatao TrueouFalse

Exemplo True

Obrigatrio Sim, caso deseja que a transao contempleconsultaAVS

AprovaFcilIntegraoviaCobreBemXVerso1.2.11.10.13 http://www.cobrebem.com/

18

Tecnologia:KomerciWebService

Nome AVS CPFSacado/CNPJSacado EnderecoSacado CepSacado

Descrio Valores:FalseNorealizar TruePararealizarconsulta cartodecrdito EndereodoPortadordocarto decrdito CEPdoPortadordocarto de crdito

Formatao TrueouFalse

Exemplo True 12345678123412 12345678912 Av.dasflores123 20555000

Obrigatrio Sim SeAVS=S SeAVS=S SeAVS=S

CPF/CNPJ do Portador do 14dgitosnumricos 11dgitosnumricos At50caracteres 08dgitosnumricos

5.9.ResultadodoProcessamentodeumaTransao

5.9.1ResultadoTEFDedicado,MoSet,WePos,KomerciWebService

Oretornodoprocessamentodetransaesnocasodastecnologiaslistadasacimafeitade maneiranaturalpeloCobreBemX,nestastecnologiasaosersolicitadoaAprovaooCobreBemXse encarregadepopularaspropriedadesquesopertinentesaoretornologoapsoresultadodasolicitao serrecebido,tudoissoocorreemtempodeexecuo.

Podemosverificarovalordasseguintespropriedades:

Nome TransacaoAprovada ResultadoSolicitacaoAprovacao CodigoAutorizacao Transacao

Descrio ResultadodopedidodeAprovao

Formatao True=Aprovado False=Negado

Exemplo True veja tabela abaixo N12345 732638688 27369

Obrigatrio Sim sim Sim Sim se

Descriodaaprovaodoresultado Textovarchar dopedido Cdigodeautorizaoretornadopela Textode6dgitos administradoradocartodecrdito IDdatrasaoAprovaFcil Textode14dgitos

aprovado

AprovaFcilIntegraoviaCobreBemXVerso1.2.11.10.13 http://www.cobrebem.com/

19

Nome CartaoMascarado NumeroDocumento ComprovanteAdministradora NacionalidadeEmissor ResultadoAVS EnderecoAVS Endereco Numero Complemento Cep NumeroSequencialUnico(NSU) crdito

Descrio

Formatao numricos At50caracteres Textovarchar Textonulo

Exemplo ***1111 123ABC N/A N/A N/A N/A

Obrigatrio Sim Sim No No No No No

Nmero mascarado do carto de At 19 dgitos 444433*** IDdopedidodacompanhia Textocomprovanteda administradora Pasemissor Resultadodaverificaodeendereo Textonulo Tag de grupo para endereo N/A verificado Endereoderuaverificado Nmerodeendereoverificado CEPdoendereoverificado NmerodeAprovaaoda administradora Textonulo Textonulo Textonulo 6dgitosnumricos N/A N/A N/A 123456

No No No No

Complementodoendereoverificado Textonulo

Exemplo:
Aprovada=cbx.SolicitaAprovacaoCartao(0) ifAprovadathen Resultado=Boleto.CartaoCredito.ResultadoSolicitacaoAprovacao Transacao=Boleto.CartaoCredito.Transacao Autorizacao=Boleto.CartaoCredito.CodigoAutorizacao response.write(Resultado&Transacao&Autorizacao) else Resultado=Boleto.CartaoCredito.ResultadoSolicitacaoAprovacao response.write(Resultado) endif

5.9.2ResultadoTecnologiasKomerci,VerifiedByVisaeTransfernciaEletrnica

UmaTransaoutilizandoastecnologiasKomercieVBVtemseufluxodiferentedasdemais tecnologias de conectividade, nestas transaes o cliente direcionado para o ambiente seguro da AdministradoraondeirdigitarosdadosdocartoouorestantedodadosnocasodoVBV.
AprovaFcilIntegraoviaCobreBemXVerso1.2.11.10.13 http://www.cobrebem.com/

20

Comonestastransaesoclientesaidapginaqueiniciouatransao(iniciadapeloCobre BemX)sernecessrioenviararespostaparaumapaginaderetorno,estapginapodeserumapgina independentequestrataoretornoouatmesmoaprpriapginaqueiniciouatransao,desdeque esta consiga identificar se a Transao est indo para processamento ou est retornando com o resultado.

EmNossoSitetemosumexemplodepginaquesolicitaaAprovaoerecebeoresultado, acesse:http://www.cobrebem.com/downloads/apf/ASPAprovacaoCartaoCredito.zip

Lembramosqueoquemudanestasduastecnologiasnosoosparmetrosderetornoesima formacomoosmesmossocarregadosumavezquearespostaestasendopassadaporPOST/GETpelo AprovaFcilparaapginaderetorno.

Como os Dados so Passados por POST/GET ser necessrio utilizar o metodo CarregaResultadoAprovacaoCartaojuntamentecomapropriedadeTransacao,quedevereceberovalor retornadonoparmetroTID,nocasodeVBVe"NUMPEDIDO",nocasodeKomerci,oquefazcom queaspropriedadessejampreechidascomosdadospassadosnoretorno,vejaumexemplo:

ExemploemVBV

setcbx=Server.CreateObject("CobreBemX.ContaCorrente") cbx.ArquivoLicencaCartoesCredito="C:\CobreBemX\Licencas\cartaoteste.conf" cbx.PadroesAprovacaoCartoes.ModoOperacao=2 setCartao=cbx.DocumentosCobranca.Add Cartao.CartaoCredito.Transacao=Request.Form("TID") Aprovada=cbx.CarregaResultadoAprovacaoCartao(0) Resultado=Boleto.CartaoCredito.ResultadoSolicitacaoAprovacao Response.Write(Resultado) setcbx=nothing

AprovaFcilIntegraoviaCobreBemXVerso1.2.11.10.13 http://www.cobrebem.com/

21

ExemploemKomerci

setcbx=Server.CreateObject("CobreBemX.ContaCorrente") cbx.ArquivoLicencaCartoesCredito="C:\CobreBemX\Licencas\cartaoteste.conf" cbx.PadroesAprovacaoCartoes.ModoOperacao=2 setCartao=cbx.DocumentosCobranca.Add Cartao.CartaoCredito.Transacao=Request.Form("NUMPEDIDO") ##ParticularidadeKomerci## fori=1toRequest.QueryString.Count setDadoKomerci=Boleto.MeusDados.Add DadoKomerci.Nome=Request.QueryString.Key(i) DadoKomerci.Valor=Request.QueryString.Item(i) next ##/ParticularidadeKomerci## Aprovada=cbx.CarregaResultadoAprovacaoCartao(0) Resultado=Boleto.CartaoCredito.ResultadoSolicitacaoAprovacao Response.Write(Resultado) setcbx=nothing

ExemploretornoTransferncia

setcbx=Server.CreateObject("CobreBemX.ContaCorrente") cbx.ArquivoLicencaCartoesCredito="C:\CobreBemX\Licencas\cartaoteste.conf" cbx.PadroesAprovacaoCartoes.ModoOperacao=2 setCartao=cbx.DocumentosCobranca.Add Cartao.CartaoCredito.Transacao=Request.Form("NUMPEDIDO") Cartao.CartaoCredito.Bandeira=Request.Form("Bandeira") Aprovada=cbx.CarregaResultadoAprovacaoCartao(0) Resultado=Boleto.CartaoCredito.ResultadoSolicitacaoAprovacaoResponse.Write(Resultado) setcbx=nothing

AprovaFcilIntegraoviaCobreBemXVerso1.2.11.10.13 http://www.cobrebem.com/

22

5.10.CapturandoumaTransao

DeacordocomospadresISO8583todasastransaesaprovadaspelasAdministradorasdeCartesde Crditodevemsercapturadas(confirmadas)pelaaplicaodoLojista. Casoatransaonosejacapturada(confirmada)pelaaplicaodoLojista,noprazoestipuladopelas AdministradorasdeCartes Crdito, a mesma serautomaticamentedesfeita, nohavendoassimodbito efetivonocartodecrditodocliente,sendoestainformaoexibidanocampoDataHoraCancelamentodo ExtratodoAprovaFcil.

Paracapturarumatransao,informeparaapropriedadeTransacaodoobjetoICartaoCreditoonmero da transao a ser capturada e utilize a propriedade ConfirmaAprovacaoCartao pertencente ao objeto IcontaCorrente.

NocasodetransaescomTEFDedicado,MoSet,KomerciWebService,WEBPosapropriedade Transao j estar com o nmero da Transao aps a chamada da aprovao e por essa razo no ser necessrio carregla com este valor, no entanto se estiver utilizando Komerci ou Verified By Visa ser necessrio primeiramente pelo processo do item 4.9.2 para que sejam carregados os valores para as propriedades.

Exemplo:
ifAprovadathen Resultado=Boleto.CartaoCredito.ResultadoSolicitacaoAprovacao Transacao=Boleto.CartaoCredito.Transacao Autorizacao=Boleto.CartaoCredito.CodigoAutorizacao cbx.ConfirmaAprovacaoCartao(0) else Resultado=Boleto.CartaoCredito.ResultadoSolicitacaoAprovacao endif

AprovaFcilIntegraoviaCobreBemXVerso1.2.11.10.13 http://www.cobrebem.com/

23

5.10.1ParmetrosdeRetornodaConfirmao Nome
NumeroDocumento ResultadoSolicitacaoAprovacao NumeroSequencialUnico ComprovanteAdministradora

Descrio
IDdopedidodacompanhia Descriodoresultadodo pedidodecancelamento Nmerodeconfirmaoda administradora Textocomprovanteda administradora

Formatao
At50caracteres textovarchar 6dgitosnumricos Textovarchar

Amostra
123ABC vejatabelaabaixo 123456 N/A

Obrigatrio
sim sim sim No

5.11.CancelandoumaTransao(ApenasparaCartodeCrdito)

Paracancelarumatransao,informeparaapropriedadeTransacaodoobjetoICartaoCreditoonmero da transao a ser cancelada e utilize a propriedade CancelaAprovacaoCartao pertencente ao objeto IContaCorrente.

Exemplo:
Boleto.CartaoCredito.Transacao=123456789 cbx.CancelaAprovacaoCartao(0)

5.11.1.ParmetrosdeRetornodoCancelamento Nome
NumeroDocumento o NumeroSequencialUnico ComprovanteAdministradora

Descrio
IDdopedidodacompanhia cancelamento Nmerodecancelamentoda administradora Textocomprovantedaadministradora

Formatao
At50caracteres textovarchar

Amostra
123ABC vejatabela abaixo

Obrigatrio
sim sim sim no

ResultadoSolicitacaoAprovaca Descriodoresultadodopedidode

6dgitosnumricos 123456 Textovarchar N/A

AprovaFcilIntegraoviaCobreBemXVerso1.2.11.10.13 http://www.cobrebem.com/

24

6.Exemplos

Disponibilizamosexemplosdeutilizaoemdiversaslinguagens,queilustramcomopassaraspropriedadesque chamamoAprovaFcil,napginadeDownloads.SegueabaixoaURL. http://www.cobrebem.com/downloads/cbx.html Dentreessesexemplos,humexemploprticoemASP,quetrataosvalorespassadosconformeoquecada tecnologiadeconectividadedetermina.SegueabaixoaURL.

http://www.cobrebem.com/downloads/cbx/ASPAprovacaoCartaoCredito.zip

Oexemplodessescriptcontmumalistadaspropriedadesobrigatriasparaquesejarealizadaumatransao.

AprovaFcilIntegraoviaCobreBemXVerso1.2.11.10.13 http://www.cobrebem.com/

25

7.OrientaesparaConfiguraoServidorDNS
7.1.TesteparaverificaraConfiguraodoServidorDNS
7.1.1.AbraumnavegadornoservidoreacesseaURL:http://www.aprovafacil.com; 7.1.2.OresultadoesperadoquesejaexibidoositedaCobreBemTecnologia; oDNS; 7.1.3.Seoresultadoexibidofordiferentedoresultadoesperado(item5.1.2)sernecessrioconfigurar

7.1.4. Se a estrutura utiliza Firewall, em alguns casos podeser que ela noesteja "enxergando" a estruturadoAprovaFcil,sendoassim,concedaaaberturadaPorta80(portadesada); 7.1.5. Caso o servidor esteja utilizando um servidor Proxy, e haja uma instalao do CobreBemX (plataforma Windows), ser necessrio alterar as seguintes propriedades no CobreBemX do objeto PadroesProxy: ServidorProxy InformeonomedoservidorouendereoIP; PortaProxy InformeaportaqueestsendoutilizadapeloProxy.Normalmenteaportautilizada8080;

AprovaFcilIntegraoviaCobreBemXVerso1.2.11.10.13 http://www.cobrebem.com/

26

8.DiagramadeFuncionamento

AprovaFcilIntegraoviaCobreBemXVerso1.2.11.10.13 http://www.cobrebem.com/

27