P. 1
Guia de Implementacao - CIELO Ecommerce

Guia de Implementacao - CIELO Ecommerce

|Views: 5.095|Likes:
Publicado porThiago Guerreiro

More info:

Published by: Thiago Guerreiro on Jun 14, 2011
Direitos Autorais:Attribution Non-commercial

Availability:

Read on Scribd mobile: iPhone, iPad and Android.
download as PDF, TXT or read online from Scribd
See more
See less

07/10/2013

pdf

text

original

Guia de Implementação

CIELO Ecommerce

Versão 3.0

Comércio Eletrônico Locaweb

Autores: Equipe Comércio Eletrônico

Guia de Implementação

CIELO Ecommerce

________ __

Versão 3.0

http://www.locaweb.com.br comercio@locaweb.com.br Atendimento: http://atendimento.locaweb.com.br/

2010

CIELO Ecommerce

Página 1 de 21

Guia de Implementação
CIELO Ecommerce
Sumário

Versão 3.0

1. Informações..................................................................................................................... 2. Fluxo básico com autorização e captura automáticas.................................................... 3. Registro da transação..................................................................................................... 3.1. Retorno XML do Registro da transação..................................................................... 4. Autorização direta da transação...................................................................................... 4.1. Retorno XML da Autorização Direta da transação..................................................... 5. Autorização da transação................................................................................................ 5.1. Retorno XML da Autorização da transação............................................................... 6. Consulta da transação.................................................................................................... 6.1. Retorno XML da Consulta da transação.................................................................... 7. Captura da transação...................................................................................................... 7.1. Retorno XML da Captura da transação...................................................................... 8. Cancelamento da transação........................................................................................... 8.1. Retorno XML do Cancelamento da transação........................................................... 9. Dados de teste................................................................................................................ 10. Possíveis status de transação....................................................................................... 11. Níveis de segurança da transação................................................................................ 12. Possíveis retornos de erro............................................................................................

3 4 5 6 8 9 11 11 13 13 16 16 18 18 20 20 20 21

2010

CIELO Ecommerce

Página 2 de 21

comp) deverão ser enviados via POST. Para todas as operações.cielo.com.locaweb. Com os dados do cartão sendo capturados na página da loja e sendo postados ao sistema da Cielo. Os canais de atendimento da CIELO são:  4002-9700 (opção 1/2) (Capitais e regiões metropolitanas)  0800-570-1700 (opção 1/2) (Demais localidades)  suporteweb@cielo. Para a Mastercard o programa de segurança é o SDP (Site Data Protection) PCI.br/comercio.com.com. Para mais informações acesse http://www. acesse o painel de controle do Gateway de Pagamentos (entre em http://painel. os dados da transação para o componente da Locaweb ( https://comercio.br “Serviços > Serviços de Segurança > AIS – Programa de Segurança da Informação” ou entre em contato com a CIELO através de seus canais de atendimento.br 2010 CIELO Ecommerce Página 3 de 21 . A solução CIELO Ecommerce funciona de forma síncrona.mastercard. Para Visa.br > Serviços Contratados > Gateway de Pagamentos > Acessar Painel do Gateway de Pagamentos). o estabelecimento deve atender a um conjunto de regras definidas pelo programa de segurança da bandeira do cartão de crédito. Para uso do fluxo com os dados do cartão sendo capturados no site da loja. ou seja. Para configurá-lo.Guia de Implementação CIELO Ecommerce 1.html. esse programa é o AIS (Account Information Security) da Visa. Informações Versão 3.locaweb. na mesma conexão HTTP em que são postados os dados da transação é também retornado um arquivo XML com o resultado do processo. Uma transação pode ser processada de duas formas:   Com os dados do cartão sendo capturados em uma página da Cielo. Para maiores informações acesse http://www.com/us/sdp/index.0 O ambiente CIELO Ecommerce deve ser configurado inicialmente no nosso servidor de Comércio Eletrônico da Locaweb. ou entre em contato com a CIELO através de seus canais de atendimento.com.

2010 CIELO Ecommerce Página 4 de 21 .Guia de Implementação CIELO Ecommerce 2 .0 O diagrama abaixo mostra a sequência de um fluxo básico com autorização e captura automáticas. com os dados do cartão sendo informados em uma página da Cielo . Fluxo básico com autorização e captura automáticas Versão 3.

Utilizar: TESTE ou PRODUCAO Seis primeiros números do cartão. A (Débito) Número de parcelas. Bandeira: visa ou mastercard (em minúsculo) Forma de pagamento. 2 (Parcelado loja). Utilizar: PT (português).PHP: registra_transacao. Utilizar: CIELO Define a ação que será executada. Utilizar: true ou false Campo livre. Utilizar: Registro Define o ambiente a ser usado. EN (inglês) ou ES (espanhol) Valor total da transação sem pontuação – os últimos dois dígitos representam sempre os centavos.php 2010 CIELO Ecommerce Página 5 de 21 . Breve descrição do pedido. Idioma do pedido.locaweb.asp . Registro da transação Os parâmetros que deverão ser passados via POST são: Parâmetro Formato Tamanho Obrigatório Descrição Versão 3. 3 (autorizar sem passar por autenticação – válido somente para crédito) Captura automática da transação caso seja autorizada.ASP: registra_transacao.0 identificacao AlfaNum - S Código de serviço do Gateway de Pagamentos junto à Locaweb (disponível em seu Painel de Controle da Locaweb – http://painel. 1 (autorizar somente se autenticada). Utilizar: 100 para R$ 1.com.00 Número do pedido para controle interno da sua loja. 2 (autorizar autenticada e nãoautenticada). modulo AlfaNum - S operacao AlfaNum - S ambiente bin_cartao idioma AlfaNum Num AlfaNum 6 2 S N N valor Num 12 S pedido descricao bandeira AlfaNum AlfaNum AlfaNum 20 1024 - S N S forma_pagamento Num 1 S parcelas Num 3 S autorizar Num 1 S capturar campo_livre AlfaNum AlfaNum 128 S N  Exemplo do registro da transação: . 3 (Parcelado administradora). Utilizar: 1 (Crédito à Vista). Utilizar: 0 (não autorizar). Para transação à vista ou débito utilizar: 1 Indicador de autorização automática.Guia de Implementação CIELO Ecommerce 3.br/) Nome do módulo de pagamento utilizado.

Código numérico da moeda. Número de parcelas.cbmp?id=d75b93d1edbc1a84fcf71 6ba727c4c5c</url-autenticacao> </transacao> 2010 CIELO Ecommerce Página 6 de 21 .0.1.br"> <tid>10017348980401201001</tid> <dados-pedido> <numero>1</numero> <valor>100</valor> <moeda>986</moeda> <data-hora>2010-04-27T17:49:50. Forma de Pagamento (forma-pagamento) bandeira produto parcelas AlfaNum Num Num 1 3 Bandeira. Possíveis status de transação. Exemplo do XML retornado: <?xml version="1.cbmp. Forma de pagamento. url-autenticacao AlfaNum 256 Dados do Pedido (dados-pedido) numero valor moeda data-hora descricao idioma Num Num Num AlfaNum AlfaNum AlfaNum 20 12 3 19 1024 2 Número do pedido para controle interno da loja.com.cielo. Os seguintes parâmetros são retornados no XML: Parâmetro tid status Formato AlfaNum Num Tamanho 40 2 Descrição Código de identificação da transação.120-03:00</data-hora> <descricao>Pedido de teste</descricao> <idioma>PT</idioma> </dados-pedido> <forma-pagamento> <bandeira>visa</bandeira> <produto>1</produto> <parcelas>1</parcelas> </forma-pagamento> <status>1</status> <urlautenticacao>https://qasecommerce. URL de redirecionamento a Cielo para processamento da transação. Status da transação. será retornado um XML com o resultado do processo. Ver item 10. Data e hora do pedido. Idioma do pedido. Breve descrição do pedido.Guia de Implementação CIELO Ecommerce 3. Retorno XML do Registro da transação Versão 3.0" id="1" xmlns="http://ecommerce.com.br/web/index.0 Após a postagem dos dados para registro da transação. Valor total da transação.0" encoding="iso-8859-1"?> <transacao versao="1.

que foi recebido no XML de retorno no registro da transação. Informações. deste guia de implementação). Descrição do erro. Como sugestão de implementação de como armanezar essa informação do tid. para efetuar a consulta da transação para obter os dados da mesma. Exemplo do XML retornado: <?xml version="1. No retorno da página da CIELO para a URL de retorno da sua loja.0 Código do erro. ocorrerá o redirecionamento do mesmo da página da CIELO para a URL de retorno da loja.Guia de Implementação CIELO Ecommerce Caso ocorra algum erro no processo. Essa URL de retorno é cadastrada em sua configuração CIELO Ecommerce no seu Painel de Gateway de Pagamentos da Locaweb (conforme explicado no item 1. Essa URL será de uma página da CIELO onde o comprador informará dos dados do seu cartão.00</mensagem> </erro>  IMPORTANTE: Nessa etapa a transação será SOMENTE registrada. Após o processamento da transação pelo comprador. Consulta da transação deste guia de implementação. é necessário que sua loja guarde o tid da transação. mas é necessário que a loja faça o redirecionamento do comprador para a URL retornada no parâmetro url-autenticacao para que seja de fato processada. Formato 1000 para R$ 10. Dessa forma. não será postado nenhum dado referente à transação. Possíveis retornos de erro. você pode usar variáveis de sessão ou cookies.0" encoding="ISO-8859-1"?> <erro> <codigo>999</codigo> <mensagem>Valor nao deve conter ponto nem virgula. por questões de segurança. Ver item 12. serão retornados os parâmetros: Parâmetro codigo mensagem Formato Num AlfaNum Tamanho Descrição Versão 3. Os detalhes de como fazer a consulta da transação são explicados no item 6. 2010 CIELO Ecommerce Página 7 de 21 .

Idioma do pedido. 2 (Parcelado loja). 2 (ilegível) e 9 (inexistente). Neste modelo.br/) Nome do módulo de pagamento utilizado.Guia de Implementação CIELO Ecommerce 4. Para Mastercard. 3 (Parcelado administradora). não será exibida uma tela da CIELO durante o processo de compra. Formato: AAAAMM Indicador do código de segurança do cartão. Os parâmetros que deverão ser passados via POST são: Parâmetro Formato Tamanho Obrigatório Descrição Código de serviço do Gateway de Pagamentos junto à Locaweb (disponível em seu Painel de Controle da Locaweb – http://painel.0 A Autorização Direta da transação é uma operação em que os dados do cartão serão obtidos em uma interface do lojista para posterior postagem a CIELO. Bandeira: visa ou mastercard (em minúsculo) Forma de pagamento. Número do cartão. Utilizar: true ou false Campo livre. Utilizar: CIELO Define a ação que será executada. identificacao AlfaNum - S modulo AlfaNum - S operacao AlfaNum - S ambiente nome_portador_cartao numero_cartao validade_cartao AlfaNum AlfaNum Num Num 50 16 6 S S S S indicador_cartao Num 1 S codigo_seguranca_cartao Num 3 N idioma AlfaNum 2 N valor Num 12 S pedido descricao bandeira AlfaNum AlfaNum AlfaNum 20 1024 - S N S forma_pagamento Num 1 S parcelas Num 3 S capturar campo_livre AlfaNum AlfaNum 128 S N 2010 CIELO Ecommerce Página 8 de 21 . A (Débito) Número de parcelas. Obrigatório se indicador do cartão for 1.00 Número do pedido para controle interno da loja. Autorização direta da transação Versão 3. Validade do cartão.com. Utilizar: Autorizacao-Direta Define o tipo de ambiente. EN (inglês) ou ES (espanhol) Valor total da transação. Breve descrição do pedido. Utilizar: 100 para R$ 1. Utilizar: TESTE ou PRODUCAO Nome impresso no cartão. 1 (informado). A utilização dessa operação SOMENTE será possível caso o seu relacionamento junto a CIELO permita esse tipo de transação. Utilizar: 1 (Crédito à Vista). Utilizar: PT (português). Para transação à vista ou débito utilizar: 1 Captura automática da transação caso seja autorizada. deve ser sempre 1. Mais informações entre em contato com seu representante comercial CIELO. Utilizar: 0 (não informado).locaweb. Código de segurança do cartão.

php Versão 3. Valor do processamento sem pontuação. será retornado um XML com o resultado do processo. Detalhe do processamento. Número de parcelas.0 4. Ver item 10. Detalhe do processamento. url-autenticacao AlfaNum 256 Dados do Pedido (dados-pedido) numero valor moeda data-hora descricao idioma Num Num Num AlfaNum AlfaNum AlfaNum 20 12 3 19 1024 2 Número do pedido para controle interno da loja. Breve descrição do pedido. Valor do processamento sem pontuação. Código numérico da moeda. Ver item 11. Autorização (autorizacao) codigo mensagem data-hora valor Num AlfaNum AlfaNum Num 2 100 19 12 Código do processamento. 2010 CIELO Ecommerce Página 9 de 21 . Os seguintes parâmetros são retornados no XML: Parâmetro tid pan status Formato AlfaNum AlfaNum Num Tamanho 40 40 2 Descrição Código de identificação da transação. Níveis de segurança da transação. Data hora do processamento.ASP: autorizacao_direta_transacao. Valor total da transação.1.PHP: autorizacao_direta_transacao. Autenticação (autenticacao) codigo mensagem data-hora valor eci Num AlfaNum AlfaNum Num Num 2 100 19 12 2 Código do processamento. URL de redirecionamento a Cielo para processamento da transação. Data hora do processamento. Possíveis status de transação. Hash do número do cartão do portador. Retorno XML da Autorização Direta da transação Após a postagem dos dados para autorização direta da transação.asp . Idioma do pedido. Nível de segurança da transação. Forma de Pagamento (forma-pagamento) bandeira produto parcelas AlfaNum Num Num 1 3 Bandeira. Data e hora do pedido. Status da transação. Forma de pagamento.Guia de Implementação CIELO Ecommerce  Exemplo do autorização direta da transação: .

00</mensagem> </erro> 2010 CIELO Ecommerce Página 10 de 21 .com.454-03:00</data-hora> <valor>100</valor> <eci>7</eci> </autenticacao> <autorizacao> <codigo>9</codigo> <mensagem>Transação autorizada</mensagem> <data-hora>2010-04-27T18:35:00. Formato 1000 para R$ 10.Guia de Implementação CIELO Ecommerce lr arp Num AlfaNum 2 6 Retorno da autorização. Exemplo do XML retornado: <?xml version="1.cbmp.427-03:00</data-hora> <descricao>Pedido de teste</descricao> <idioma>PT</idioma> </dados-pedido> <forma-pagamento> <bandeira>visa</bandeira> <produto>1</produto> <parcelas>1</parcelas> </forma-pagamento> <status>9</status> <autenticacao> <codigo>9</codigo> <mensagem>Transacao sem autenticacao</mensagem> <data-hora>2010-04-27T18:35:00. Exemplo do XML retornado: <?xml version="1. Descrição do erro.0 Código da autorização caso a transação tenha sido autorizada com sucesso. Ver item 12.0.br"> <tid>10017348980401251001</tid> <pan>34353531383730303030303030313833</pan> <dados-pedido> <numero>5</numero> <valor>100</valor> <moeda>986</moeda> <data-hora>2010-04-27T18:34:10.0" encoding="ISO-8859-1"?> <erro> <codigo>999</codigo> <mensagem>Valor nao deve conter ponto nem virgula. Possíveis retornos de erro.0" id="1" xmlns="http://ecommerce.br/web/index.cielo.cbmp?id=339986bdf7f744911638a 302b4fc4854</url-autenticacao> </transacao> Caso ocorra algum erro no processo serão retornados os parâmetros: Parâmetro codigo mensagem Formato Num AlfaNum Tamanho Descrição Código do erro. Versão 3.502-03:00</data-hora> <valor>100</valor> <lr>00</lr> <arp>183501</arp> </autorizacao> <urlautenticacao>https://qasecommerce.com.0" encoding="ISO-8859-1"?> <transacao versao="1.

Utilizar: Autorizacao Define o tipo de ambiente. Utilizar: TESTE ou PRODUCAO Código de identificação da transação. Valor total da transação. Breve descrição do pedido.br/) Nome do módulo de pagamento utilizado. Hash do número do cartão do portador. Forma de Pagamento (forma-pagamento) bandeira AlfaNum Bandeira. Este processo retornará todos os dados referentes à transação autorizada. URL de redirecionamento a Cielo para processamento da transação. Possíveis status de transação.0 A Autorização da transação é uma operação que poderá ser feita inúmeras vezes.PHP: autorizacao_transacao.locaweb. Autorização da transação Versão 3. Código numérico da moeda. Os parâmetros que deverão ser passados via POST são: Parâmetro Formato Tamanho Obrigatório Descrição Código de serviço do Gateway de Pagamentos junto à Locaweb (disponível em seu Painel de Controle da Locaweb – http://painel.ASP: autorizacao_transacao.com. Idioma do pedido. Retorno XML da Autorização da transação Após a postagem dos dados para autorização da transação será retornado um XML com o resultado do processo.php 5. 2010 CIELO Ecommerce Página 11 de 21 .Guia de Implementação CIELO Ecommerce 5.1.asp . Status da transação. Os seguintes parâmetros são retornados no XML: Parâmetro tid pan status Formato AlfaNum AlfaNum Num Tamanho 40 40 2 Descrição Código de identificação da transação. Data e hora do pedido. Utilizar: CIELO Define a ação que será executada. identificacao AlfaNum - S modulo AlfaNum - S operacao AlfaNum - S ambiente tid AlfaNum AlfaNum 40 S S  Exemplo da autorização da transação: . url-autenticacao AlfaNum 256 Dados do Pedido (dados-pedido) numero valor moeda data-hora descricao idioma Num Num Num AlfaNum AlfaNum AlfaNum 20 12 3 19 1024 2 Número do pedido para controle interno da loja. Ver item 10.

Guia de Implementação CIELO Ecommerce produto parcelas Autorização (autorizacao) codigo mensagem data-hora valor lr arp Num AlfaNum AlfaNum Num Num AlfaNum 2 100 19 12 2 6 Código do processamento.com.br/web/index.0 Código da autorização caso a transação tenha sido autorizada com sucesso.502-03:00</data-hora> <valor>100</valor> <lr>00</lr> <arp>183501</arp> </autorizacao> <urlautenticacao>https://qasecommerce. Possíveis retornos de erro.cbmp?id=339986bdf7f744911638a 302b4fc4854</url-autenticacao> </transacao> Caso ocorra algum erro no processo serão retornados os parâmetros: Parâmetro codigo mensagem Formato Num AlfaNum Tamanho Descrição Código do erro. Detalhe do processamento. Versão 3. Exemplo do XML retornado: <?xml version="1.0" encoding="ISO-8859-1"?> <erro> <codigo>999</codigo> <mensagem>Valor nao deve conter ponto nem virgula. Ver item 12. Retorno da autorização. Data hora do processamento. Formato 1000 para R$ 10.0" encoding="ISO-8859-1"?> <transacao versao="1.00</mensagem> </erro> 2010 CIELO Ecommerce Página 12 de 21 . Número de parcelas.cielo. Num Num 1 3 Forma de pagamento. Valor do processamento sem pontuação.com. Descrição do erro.br"> <tid>10017348980401251001</tid> <pan>34353531383730303030303030313833</pan> <dados-pedido> <numero>5</numero> <valor>100</valor> <moeda>986</moeda> <data-hora>2010-04-27T18:34:10. Exemplo do XML retornado: <?xml version="1.0" id="1" xmlns="http://ecommerce.cbmp.427-03:00</data-hora> <descricao>Pedido de teste</descricao> <idioma>PT</idioma> </dados-pedido> <forma-pagamento> <bandeira>visa</bandeira> <produto>1</produto> <parcelas>1</parcelas> </forma-pagamento> <status>9</status> <autorizacao> <codigo>9</codigo> <mensagem>Transação autorizada</mensagem> <data-hora>2010-04-27T18:35:00.0.

Valor total da transação.locaweb. Utilizar: Consulta Define o tipo de ambiente. Forma de Pagamento (forma-pagamento) bandeira AlfaNum Bandeira. identificacao AlfaNum - S modulo AlfaNum - S operacao AlfaNum - S ambiente tid AlfaNum AlfaNum 40 S S  Exemplo da consulta da transação: . Idioma do pedido.ASP: consulta_transacao. Código numérico da moeda. Os seguintes parâmetros são retornados no XML: Parâmetro tid pan status Formato AlfaNum AlfaNum Num Tamanho 40 40 2 Descrição Código de identificação da transação. Breve descrição do pedido. Consulta da transação Versão 3. Data e hora do pedido. URL de redirecionamento a Cielo para processamento da transação. Possíveis status de transação.1.php 6. Este processo retornará todos os dados referentes à transação consultada. 2010 CIELO Ecommerce Página 13 de 21 . Os parâmetros que deverão ser passados via POST são: Parâmetro Formato Tamanho Obrigatório Descrição Código de serviço do Gateway de Pagamentos junto à Locaweb (disponível em seu Painel de Controle da Locaweb – http://painel.com. url-autenticacao AlfaNum 256 Dados do Pedido (dados-pedido) numero valor moeda data-hora descricao idioma Num Num Num AlfaNum AlfaNum AlfaNum 20 12 3 19 1024 2 Número do pedido para controle interno da loja.asp . Hash do número do cartão do portador. Utilizar: TESTE ou PRODUCAO Código de identificação da transação. Utilizar: CIELO Define a ação que será executada.0 A Consulta é uma operação que poderá ser feita inúmeras vezes.br/) Nome do módulo de pagamento utilizado. Status da transação. Retorno XML da Consulta da transação Após a postagem dos dados para consulta da transação será retornado um XML com o resultado do processo.Guia de Implementação CIELO Ecommerce 6. Ver item 10.PHP: consulta_transacao.

Detalhe do processamento.0" encoding="ISO-8859-1"?> <transacao versao="1. Valor do processamento sem pontuação. Cancelamento (cancelamento) codigo mensagem data-hora valor Num AlfaNum AlfaNum Num 2 100 19 12 Código do processamento. Detalhe do processamento.427-03:00</data-hora> <descricao>Pedido de teste</descricao> <idioma>PT</idioma> </dados-pedido> <forma-pagamento> <bandeira>visa</bandeira> <produto>1</produto> <parcelas>1</parcelas> 2010 CIELO Ecommerce Página 14 de 21 . Data hora do processamento. Retorno da autorização. Data hora do processamento. Valor do processamento sem pontuação.com. Data hora do processamento.0. Valor do processamento sem pontuação. Autorização (autorizacao) codigo mensagem data-hora valor lr arp Num AlfaNum AlfaNum Num Num AlfaNum 2 100 19 12 2 6 Código do processamento. Detalhe do processamento.0" id="1" xmlns="http://ecommerce. Valor do processamento sem pontuação. Exemplo do XML retornado: <?xml version="1. Número de parcelas. Ver item 11. Detalhe do processamento. Níveis de segurança da transação. Data hora do processamento. Código da autorização caso a transação tenha sido autorizada com sucesso.0 Autenticação (autenticacao) codigo mensagem data-hora valor eci Num AlfaNum AlfaNum Num Num 2 100 19 12 2 Código do processamento.br"> <tid>10017348980401251001</tid> <pan>34353531383730303030303030313833</pan> <dados-pedido> <numero>5</numero> <valor>100</valor> <moeda>986</moeda> <data-hora>2010-04-27T18:34:10.Guia de Implementação CIELO Ecommerce produto parcelas Num Num 1 3 Forma de pagamento. Versão 3. Nível de segurança da transação.cbmp. Captura (captura) codigo mensagem data-hora valor Num AlfaNum AlfaNum Num 2 100 19 12 Código do processamento.

0 </forma-pagamento> <status>9</status> <autenticacao> <codigo>9</codigo> <mensagem>Transacao sem autenticacao</mensagem> <data-hora>2010-04-27T18:35:00. Descrição do erro.com.454-03:00</data-hora> <valor>100</valor> <eci>7</eci> </autenticacao> <autorizacao> <codigo>9</codigo> <mensagem>Transação autorizada</mensagem> <data-hora>2010-04-27T18:35:00.Guia de Implementação CIELO Ecommerce Versão 3.cielo.cbmp?id=339986bdf7f744911638a 302b4fc4854</url-autenticacao> </transacao> Caso ocorra algum erro no processo serão retornados os parâmetros: Parâmetro codigo mensagem Formato Num AlfaNum Tamanho Descrição Código do erro.025-03:00</data-hora> <valor>100</valor> </captura> <cancelamento> <codigo>9</codigo> <mensagem>Transacao cancelada com sucesso</mensagem> <data-hora>2010-04-27T18:37:54. Ver item 12. Exemplo do XML retornado: <?xml version="1. Formato 1000 para R$ 10.502-03:00</data-hora> <valor>100</valor> <lr>00</lr> <arp>183501</arp> </autorizacao> <captura> <codigo>9</codigo> <mensagem>Transacao capturada com sucesso</mensagem> <data-hora>2010-04-27T18:36:09. Possíveis retornos de erro.591-03:00</data-hora> <valor>100</valor> </cancelamento> <urlautenticacao>https://qasecommerce.br/web/index.00</mensagem> </erro> 2010 CIELO Ecommerce Página 15 de 21 .0" encoding="ISO-8859-1"?> <erro> <codigo>999</codigo> <mensagem>Valor nao deve conter ponto nem virgula.

Ver item 10.com.ASP: captura_transacao. identificacao AlfaNum - S modulo AlfaNum - S operacao AlfaNum - S ambiente tid valor campo_livre AlfaNum AlfaNum Num AlfaNum 40 12 128 S S N N  Exemplo da captura da transação: .Guia de Implementação CIELO Ecommerce 7. Captura da transação Versão 3. URL de redirecionamento a Cielo para processamento da transação. Valor da transação que será capturado. A captura deve ser feita em até 5 dias (corridos) após a transação. Status da transação.br/) Nome do módulo de pagamento utilizado.php 7. Utilizar: Captura Define o tipo de ambiente. Caso isso não ocorra.1.asp . Este procedimento libera a Visanet de emitir a cobrança para o emissor do cartão. Utilizar: TESTE ou PRODUCAO Código de identificação da transação. 2010 CIELO Ecommerce Página 16 de 21 .00 Campo livre. Utilizar: CIELO Define a ação que será executada. Valor total da transação.0 A Captura é uma operação necessária SOMENTE quando na transação o parâmetro “capturar” foi enviado com o valor “false” e tenha sido aprovada. Possíveis status de transação. Hash do número do cartão do portador. Os parâmetros que deverão ser passados via POST são: Parâmetro Formato Tamanho Obrigatório Descrição Código de serviço do Gateway de Pagamentos junto à Locaweb (disponível em seu Painel de Controle da Locaweb – http://painel.locaweb. Data e hora do pedido. Código numérico da moeda. a transação será cancelada automaticamente pela operadora. url-autenticacao AlfaNum 256 Dados do Pedido (dados-pedido) numero valor moeda data-hora Num Num Num AlfaNum 20 12 3 19 Número do pedido para controle interno da loja. Retorno XML da Captura da transação Após a postagem dos dados para captura da transação será retornado um XML com o resultado do processo. Utilizar: 100 para R$ 1. Após a postagem dos dados para captura da transação será retornado um XML com o resultado do processo. Os seguintes parâmetros são retornados no XML: Parâmetro tid pan status Formato AlfaNum AlfaNum Num Tamanho 40 40 2 Descrição Código de identificação da transação.PHP: captura_transacao.

0" encoding="ISO-8859-1"?> <transacao versao="1.00</mensagem> </erro> 2010 CIELO Ecommerce Página 17 de 21 .Guia de Implementação CIELO Ecommerce descricao idioma AlfaNum AlfaNum 1024 2 Breve descrição do pedido.0.br/web/index. Versão 3. Data hora do processamento.cielo. Ver item 12. Forma de pagamento.0" encoding="ISO-8859-1"?> <erro> <codigo>999</codigo> <mensagem>Valor nao deve conter ponto nem virgula. Exemplo do XML retornado: <?xml version="1.br"> <tid>10017348980401251001</tid> <pan>34353531383730303030303030313833</pan> <dados-pedido> <numero>5</numero> <valor>100</valor> <moeda>986</moeda> <data-hora>2010-04-27T18:34:10.025-03:00</data-hora> <valor>100</valor> </captura> <urlautenticacao>https://qasecommerce.cbmp. Exemplo do XML retornado: <?xml version="1. AlfaNum Num Num 1 3 Bandeira.427-03:00</data-hora> <descricao>Pedido de teste</descricao> <idioma>PT</idioma> </dados-pedido> <forma-pagamento> <bandeira>visa</bandeira> <produto>1</produto> <parcelas>1</parcelas> </forma-pagamento> <status>9</status> <captura> <codigo>9</codigo> <mensagem>Transacao capturada com sucesso</mensagem> <data-hora>2010-04-27T18:36:09.0 Forma de Pagamento (forma-pagamento) bandeira produto parcelas Captura (captura) codigo mensagem data-hora valor Num AlfaNum AlfaNum Num 2 100 19 12 Código do processamento. Formato 1000 para R$ 10. Número de parcelas.com.0" id="1" xmlns="http://ecommerce. Idioma do pedido. Descrição do erro.cbmp?id=339986bdf7f744911638a 302b4fc4854</url-autenticacao> </transacao> Caso ocorra algum erro no processo serão retornados os parâmetros: Parâmetro codigo mensagem Formato Num AlfaNum Tamanho Descrição Código do erro.com. Valor do processamento sem pontuação. Possíveis retornos de erro. Detalhe do processamento.

Retorno XML do Cancelamento da transação Após a postagem dos dados para cancelamento da transação. será retornado um XML com o resultado do processo. Hash do número do cartão do portador. Os seguintes parâmetros são retornados no XML: Parâmetro tid pan status Formato AlfaNum AlfaNum Num Tamanho 40 40 2 Descrição Código de identificação da transação.php 8. Valor total da transação. passado esse prazo somente poderá ser feito junto à operadora. Breve descrição do pedido. Idioma do pedido. 2010 CIELO Ecommerce Página 18 de 21 .br/) Nome do módulo de pagamento utilizado.PHP: cancelamento_transacao. identificacao AlfaNum - S modulo AlfaNum - S operacao AlfaNum - S ambiente tid AlfaNum AlfaNum 40 S S  Exemplo do cancelamento da transação: . Cancelamento da transação Versão 3. Data e hora do pedido. Após a postagem dos dados para cancelamento da transação.asp . Utilizar: TESTE ou PRODUCAO Código de identificação da transação.com. Ver item 10. Código numérico da moeda. Os parâmetros que deverão ser passados via POST são: Parâmetro Formato Tamanho Obrigatório Descrição Código de serviço do Gateway de Pagamentos junto à Locaweb (disponível em seu Painel de Controle da Locaweb – http://painel. será retornado um XML com o resultado do processo.ASP: cancelamento_transacao. Utilizar: Cancelamento Define o tipo de ambiente.Guia de Implementação CIELO Ecommerce 8.1.0 O Cancelamento é uma ação opcional para as transações aprovadas. Utilizar: CIELO Define a ação que será executada. Este procedimento notifica a Visanet para não emitir a cobrança ao emissor do cartão. url-autenticacao AlfaNum 256 Dados do Pedido (dados-pedido) numero valor moeda data-hora descricao idioma Num Num Num AlfaNum AlfaNum AlfaNum 20 12 3 19 1024 2 Número do pedido para controle interno da loja. Possíveis status de transação. O cancelamento deve ser feito em até 24 horas após a transação. URL de redirecionamento a Cielo para processamento da transação. Status da transação.locaweb.

br/web/index.0" encoding="ISO-8859-1"?> <transacao versao="1.com. Valor do processamento sem pontuação. Versão 3. Formato 1000 para R$ 10. Descrição do erro.0" id="1" xmlns="http://ecommerce. Detalhe do processamento. Data hora do processamento.com.0.0" encoding="ISO-8859-1"?> <erro> <codigo>999</codigo> <mensagem>Valor nao deve conter ponto nem virgula. Possíveis retornos de erro.00</mensagem> </erro> 2010 CIELO Ecommerce Página 19 de 21 . Forma de pagamento.427-03:00</data-hora> <descricao>Pedido de teste</descricao> <idioma>PT</idioma> </dados-pedido> <forma-pagamento> <bandeira>visa</bandeira> <produto>1</produto> <parcelas>1</parcelas> </forma-pagamento> <status>9</status> <cancelamento> <codigo>9</codigo> <mensagem>Transacao cancelada com sucesso</mensagem> <data-hora>2010-04-27T18:37:54.cielo.Guia de Implementação CIELO Ecommerce Forma de Pagamento (forma-pagamento) bandeira produto parcelas AlfaNum Num Num 1 3 Bandeira. Número de parcelas.0 Cancelamento (cancelamento) codigo mensagem data-hora valor Num AlfaNum AlfaNum Num 2 100 19 12 Código do processamento.591-03:00</data-hora> <valor>100</valor> </cancelamento> <urlautenticacao>https://qasecommerce.cbmp?id=339986bdf7f744911638a 302b4fc4854</url-autenticacao> </transacao> Caso ocorra algum erro no processo serão retornados os parâmetros: Parâmetro codigo mensagem Formato Num AlfaNum Tamanho Descrição Código do erro. Ver item 12. Exemplo do XML retornado: <?xml version="1. Exemplo do XML retornado: <?xml version="1.br"> <tid>10017348980401251001</tid> <pan>34353531383730303030303030313833</pan> <dados-pedido> <numero>5</numero> <valor>100</valor> <moeda>986</moeda> <data-hora>2010-04-27T18:34:10.cbmp.

 IMPORTANTE: Para simular uma transação autorizada.0 Para realizar seus testes. toda autorização será negada. é necessário que no valor da transação os dois últimos dígitos seja 0. 5453 0100 0006 6167 (mastercard)  Data de validade: qualquer combinação posterior a data atual  Código de segurança: qualquer combinação de 3 dígitos  Valor do pedido: para simular transação autorizada. Níveis de segurança da transação Resultado da autenticação Portador autenticado com sucesso Portador não realizou autenticação. Do contrário. use qualquer valor em que os dois últimos dígitos sejam zeros. pois o Emissor não forneceu mecanismos de autenticação Portador não se autenticou com sucesso ou a loja optou por autorizar sem passar pela autenticação Visa 5 6 Mastercard 2 1 7 0 2010 CIELO Ecommerce Página 20 de 21 . Do contrário. toda autorização será negada. Possíveis status de transação Código 0 1 2 3 4 5 6 8 9 10 Criada Em andamento Autenticada Não autenticada Autorizada ou pendente de captura Não autorizada Capturada Não capturada Cancelada Em autenticação Erro 11. Dados de teste Versão 3. 10. utilize os dados abaixo no ambiente de testes (estes dados funcionarão apenas neste ambiente): Dados para configuração de teste em seu Painel de Controle do Comércio Eletrônico:  Afiliação: 1001734898  Chave: e84827130b9837473681c2787007da5914d6359947015a5cdb2b8843db0fa832  Afiliação para autorização direta: 1006993069  Chave para autorização direta: 25fbb99741c739dd84d7b06ec78c9bac718838630f30b112d033ce2e621b34f3 Dados de cartão de teste:  Cartão com autenticação: 4012 0010 3714 1112 (visa)  Cartão sem autenticação: 4551 8700 0000 0183 (visa).Guia de Implementação CIELO Ecommerce 9.

Possíveis retornos de erro Código 001 002 003 010 Erro Mensagem inválida Credenciais inválidas Transação inexistente Inconsistência no envio do cartão Descrição Versão 3. pois o prazo para captura está vencido O valor solicitado para captura não é válido Não foi possível realizar a captura O cancelamento não pode ser realizado.Guia de Implementação CIELO Ecommerce 12. está divergente com a permissão do envio dessa informação A transação está configurada com uma modalidade de pagamento não habilitada para a loja O número de parcelas solicitado ultrapassa o máximo permitido Não é permitido realizar autorização para o status da transação Não é permitido realizar autorização. pois a transação não está autorizada A captura não pode ser realizada. com ou sem cartão.0 A mensagem XML está fora do formato especificado pelo arquivo ecommerce. pois o prazo está vencido EC não possui permissão para realizar a autorização A captura não pode ser realizada.xsd Impossibilidade de autenticar uma requisição da loja virtual. pois o prazo está vencido O atual status da transação não permite cancelamento Não foi possível realizar o cancelamento Falha no sistema 011 012 020 021 022 030 Modalidade não habilitada Número de parcelas inválido Status não permite autorização Prazo de autorização vencido EC não autorizado Transação não autorizada para captura Prazo de captura vencido Valor de captura inválido Falha ao capturar Prazo de cancelamento vencido Status não permite cancelamento Falha ao cancelar Erro inesperado 031 032 033 040 041 042 099 2010 CIELO Ecommerce Página 21 de 21 . Não existe transação para o identificador informado A transação.

You're Reading a Free Preview

Descarregar
scribd
/*********** DO NOT ALTER ANYTHING BELOW THIS LINE ! ************/ var s_code=s.t();if(s_code)document.write(s_code)//-->