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

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

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

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: . Utilizar: 0 (não autorizar). 3 (Parcelado administradora). Utilizar: Registro Define o ambiente a ser usado.locaweb. Utilizar: CIELO Define a ação que será executada. Breve descrição do pedido.00 Número do pedido para controle interno da sua loja.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. Utilizar: 1 (Crédito à Vista). Utilizar: TESTE ou PRODUCAO Seis primeiros números do cartão. 2 (autorizar autenticada e nãoautenticada). Utilizar: true ou false Campo livre. Idioma do pedido.br/) Nome do módulo de pagamento utilizado.ASP: registra_transacao.asp . Utilizar: 100 para R$ 1.php 2010 CIELO Ecommerce Página 5 de 21 . A (Débito) Número de parcelas.com. 1 (autorizar somente se autenticada). Bandeira: visa ou mastercard (em minúsculo) Forma de pagamento. 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. EN (inglês) ou ES (espanhol) Valor total da transação sem pontuação – os últimos dois dígitos representam sempre os centavos.Guia de Implementação CIELO Ecommerce 3. Utilizar: PT (português). 3 (autorizar sem passar por autenticação – válido somente para crédito) Captura automática da transação caso seja autorizada. 2 (Parcelado loja).PHP: registra_transacao. Para transação à vista ou débito utilizar: 1 Indicador de autorização automática.

1.0" id="1" xmlns="http://ecommerce. URL de redirecionamento a Cielo para processamento da transação. 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. Status da transação.Guia de Implementação CIELO Ecommerce 3.br"> <tid>10017348980401201001</tid> <dados-pedido> <numero>1</numero> <valor>100</valor> <moeda>986</moeda> <data-hora>2010-04-27T17:49:50. 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.0.br/web/index. Forma de pagamento.com.cbmp?id=d75b93d1edbc1a84fcf71 6ba727c4c5c</url-autenticacao> </transacao> 2010 CIELO Ecommerce Página 6 de 21 .cbmp. Retorno XML do Registro da transação Versão 3. Ver item 10. Idioma do pedido. Exemplo do XML retornado: <?xml version="1.cielo. Código numérico da moeda.com. Valor total 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. Breve descrição do pedido.0 Após a postagem dos dados para registro da transação. Data e hora do pedido. Número de parcelas. será retornado um XML com o resultado do processo. Forma de Pagamento (forma-pagamento) bandeira produto parcelas AlfaNum Num Num 1 3 Bandeira. Possíveis status de transação.0" encoding="iso-8859-1"?> <transacao versao="1.

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

Código de segurança do cartão. Utilizar: 100 para R$ 1. Número do cartão. 1 (informado). Bandeira: visa ou mastercard (em minúsculo) Forma de pagamento. Utilizar: Autorizacao-Direta Define o tipo de ambiente. Formato: AAAAMM Indicador do código de segurança do cartão. 2 (ilegível) e 9 (inexistente). não será exibida uma tela da CIELO durante o processo de compra.Guia de Implementação CIELO Ecommerce 4. Para Mastercard.locaweb. Idioma do pedido. Validade do cartão. 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 . Utilizar: CIELO Define a ação que será executada.00 Número do pedido para controle interno da loja. Breve descrição do pedido. Mais informações entre em contato com seu representante comercial CIELO. 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. Utilizar: TESTE ou PRODUCAO Nome impresso no cartão. Neste modelo. Utilizar: 0 (não informado).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. A (Débito) Número de parcelas. Utilizar: 1 (Crédito à Vista). EN (inglês) ou ES (espanhol) Valor total da transação. A utilização dessa operação SOMENTE será possível caso o seu relacionamento junto a CIELO permita esse tipo de transação. Utilizar: true ou false Campo livre. 3 (Parcelado administradora). Para transação à vista ou débito utilizar: 1 Captura automática da transação caso seja autorizada. 2 (Parcelado loja). Obrigatório se indicador do cartão for 1. deve ser sempre 1.br/) Nome do módulo de pagamento utilizado. Autorização direta da transação Versão 3.com. Utilizar: PT (português).

Detalhe do processamento. Autorização (autorizacao) codigo mensagem data-hora valor Num AlfaNum AlfaNum Num 2 100 19 12 Código do processamento. Hash do número do cartão do portador. Ver item 11. Forma de Pagamento (forma-pagamento) bandeira produto parcelas AlfaNum Num Num 1 3 Bandeira. Breve descrição do pedido. Número de parcelas. Data hora do processamento. Status da transação. Data e hora do pedido. Valor do processamento sem pontuação.asp . Valor do processamento sem pontuação.php Versão 3.1. será retornado um XML com o resultado do processo. URL de redirecionamento a Cielo para processamento da transação.0 4. Código numérico da moeda.Guia de Implementação CIELO Ecommerce  Exemplo do autorização direta da transação: .PHP: autorizacao_direta_transacao. Valor total da transação. Data hora 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. Níveis de segurança da transação. Ver item 10. Forma de pagamento.ASP: autorizacao_direta_transacao. 2010 CIELO Ecommerce Página 9 de 21 . Possíveis status de transação. Retorno XML da Autorização Direta da transação Após a postagem dos dados para autorização direta da transação. Nível de segurança da transação. Detalhe do processamento. Idioma do pedido. 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. Autenticação (autenticacao) codigo mensagem data-hora valor eci Num AlfaNum AlfaNum Num Num 2 100 19 12 2 Código 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> </forma-pagamento> <status>9</status> <autenticacao> <codigo>9</codigo> <mensagem>Transacao sem autenticacao</mensagem> <data-hora>2010-04-27T18:35:00. Formato 1000 para R$ 10. Exemplo do XML retornado: <?xml version="1. Possíveis retornos de erro.cielo.00</mensagem> </erro> 2010 CIELO Ecommerce Página 10 de 21 .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.0" encoding="ISO-8859-1"?> <erro> <codigo>999</codigo> <mensagem>Valor nao deve conter ponto nem virgula.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.com.com.br/web/index.502-03:00</data-hora> <valor>100</valor> <lr>00</lr> <arp>183501</arp> </autorizacao> <urlautenticacao>https://qasecommerce.0 Código da autorização caso a transação tenha sido autorizada com sucesso.0. Ver item 12.0" encoding="ISO-8859-1"?> <transacao versao="1. Versão 3.cbmp.0" id="1" xmlns="http://ecommerce. Exemplo do XML retornado: <?xml version="1.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. Descrição do erro.Guia de Implementação CIELO Ecommerce lr arp Num AlfaNum 2 6 Retorno da autorização.

asp .locaweb. Utilizar: CIELO Define a ação que será executada. 2010 CIELO Ecommerce Página 11 de 21 . Possíveis status de transação. Status da transação. identificacao AlfaNum - S modulo AlfaNum - S operacao AlfaNum - S ambiente tid AlfaNum AlfaNum 40 S S  Exemplo da autorização da transação: .1.br/) Nome do módulo de pagamento utilizado.PHP: autorizacao_transacao. 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.Guia de Implementação CIELO Ecommerce 5. 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. Código numérico da moeda.0 A Autorização da transação é uma operação que poderá ser feita inúmeras vezes. Forma de Pagamento (forma-pagamento) bandeira AlfaNum Bandeira. Utilizar: TESTE ou PRODUCAO Código de identificação da transação. Autorização da transação Versão 3. Utilizar: Autorizacao Define o tipo de ambiente.ASP: autorizacao_transacao. Idioma do pedido. Valor total da transaçã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. Hash do número do cartão do portador. Breve descrição do pedido. Data e hora do pedido.php 5. URL de redirecionamento a Cielo para processamento da transação. 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.com. Ver item 10. Este processo retornará todos os dados referentes à transação autorizada.

com.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.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.br/web/index. Detalhe do processamento. Formato 1000 para R$ 10.0" encoding="ISO-8859-1"?> <erro> <codigo>999</codigo> <mensagem>Valor nao deve conter ponto nem virgula. Num Num 1 3 Forma de pagamento. Número de parcelas.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. Descrição do erro.502-03:00</data-hora> <valor>100</valor> <lr>00</lr> <arp>183501</arp> </autorizacao> <urlautenticacao>https://qasecommerce.cbmp. Versão 3. Data hora do processamento. Valor do processamento sem pontuação.00</mensagem> </erro> 2010 CIELO Ecommerce Página 12 de 21 .0 Código da autorização caso a transação tenha sido autorizada com sucesso.0. Retorno da autorização.0" id="1" xmlns="http://ecommerce. Possíveis retornos de erro.0" encoding="ISO-8859-1"?> <transacao versao="1.cielo. 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. Exemplo do XML retornado: <?xml version="1.com.

Utilizar: CIELO Define a ação que será executada. Consulta da transação Versão 3.ASP: consulta_transacao. Utilizar: TESTE ou PRODUCAO Código de identificação da transação. identificacao AlfaNum - S modulo AlfaNum - S operacao AlfaNum - S ambiente tid AlfaNum AlfaNum 40 S S  Exemplo da consulta da transação: . Utilizar: Consulta Define o tipo de ambiente. URL de redirecionamento a Cielo para processamento da transaçã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. 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. Código numérico da moeda. Este processo retornará todos os dados referentes à transação consultada. 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. Ver item 10. Status da transação.br/) Nome do módulo de pagamento utilizado. Forma de Pagamento (forma-pagamento) bandeira AlfaNum Bandeira.locaweb.asp . Idioma do pedido. Breve descrição do pedido.PHP: consulta_transacao.com. Data e hora do pedido.1. 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. 2010 CIELO Ecommerce Página 13 de 21 . Possíveis status de transação. Hash do número do cartão do portador.Guia de Implementação CIELO Ecommerce 6. Valor total da transação.0 A Consulta é uma operação que poderá ser feita inúmeras vezes.php 6.

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 . Detalhe do processamento. Detalhe do processamento. Ver item 11. Data hora 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. Detalhe do processamento. Retorno da autorização. Nível de segurança da transação.0" id="1" xmlns="http://ecommerce.com. Versão 3. Captura (captura) codigo mensagem data-hora valor Num AlfaNum AlfaNum Num 2 100 19 12 Código do processamento.0 Autenticação (autenticacao) codigo mensagem data-hora valor eci Num AlfaNum AlfaNum Num Num 2 100 19 12 2 Código do processamento.0" encoding="ISO-8859-1"?> <transacao versao="1. Detalhe do processamento. Data hora do processamento.cbmp. Número de parcelas. Cancelamento (cancelamento) codigo mensagem data-hora valor Num AlfaNum AlfaNum Num 2 100 19 12 Código do processamento. 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. Valor do processamento sem pontuação. Valor do processamento sem pontuação.Guia de Implementação CIELO Ecommerce produto parcelas Num Num 1 3 Forma de pagamento. Exemplo do XML retornado: <?xml version="1. Data hora do processamento. Data hora do processamento. Código da autorização caso a transação tenha sido autorizada com sucesso. Valor do processamento sem pontuação.0. Níveis de segurança da transação.

com.0 </forma-pagamento> <status>9</status> <autenticacao> <codigo>9</codigo> <mensagem>Transacao sem autenticacao</mensagem> <data-hora>2010-04-27T18:35:00.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.0" encoding="ISO-8859-1"?> <erro> <codigo>999</codigo> <mensagem>Valor nao deve conter ponto nem virgula.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.00</mensagem> </erro> 2010 CIELO Ecommerce Página 15 de 21 .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.br/web/index. Descrição do erro.591-03:00</data-hora> <valor>100</valor> </cancelamento> <urlautenticacao>https://qasecommerce.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.Guia de Implementação CIELO Ecommerce Versão 3. Exemplo do XML retornado: <?xml version="1. Ver item 12. Formato 1000 para R$ 10. Possíveis retornos de erro.

PHP: captura_transacao. Valor total da transação.asp . Utilizar: TESTE ou PRODUCAO Código de identificação da transação. Possíveis status de transação. a transação será cancelada automaticamente pela operadora. Após a postagem dos dados para captura da transação será retornado um XML com o resultado do processo.00 Campo livre.com.ASP: captura_transacao. URL de redirecionamento a Cielo para processamento da transação. 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: .br/) Nome do módulo de pagamento utilizado. A captura deve ser feita em até 5 dias (corridos) após a transação. Ver item 10.1. Utilizar: CIELO Define a ação que será executada.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.locaweb.php 7. Valor da transação que será capturado. 2010 CIELO Ecommerce Página 16 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.Guia de Implementação CIELO Ecommerce 7. Utilizar: Captura Define o tipo de ambiente. Código numérico da moeda. Hash do número do cartão do portador. 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. 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. Utilizar: 100 para R$ 1. 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. Este procedimento libera a Visanet de emitir a cobrança para o emissor do cartão. Data e hora do pedido. Captura da transação Versão 3. Status da transação. Caso isso não ocorra.

cbmp.com.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. Descrição do erro. Data hora do processamento.025-03:00</data-hora> <valor>100</valor> </captura> <urlautenticacao>https://qasecommerce. Formato 1000 para R$ 10. Número de parcelas.0" id="1" xmlns="http://ecommerce. Versão 3.0" encoding="ISO-8859-1"?> <erro> <codigo>999</codigo> <mensagem>Valor nao deve conter ponto nem virgula. Forma de pagamento. Exemplo do XML retornado: <?xml version="1.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. Ver item 12. Possíveis retornos de erro.cielo.br/web/index. Valor do processamento sem pontuação. AlfaNum Num Num 1 3 Bandeira.com. Detalhe do processamento.0" encoding="ISO-8859-1"?> <transacao versao="1.Guia de Implementação CIELO Ecommerce descricao idioma AlfaNum AlfaNum 1024 2 Breve descrição do pedido.0. Idioma do pedido.00</mensagem> </erro> 2010 CIELO Ecommerce Página 17 de 21 .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 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. Exemplo do XML retornado: <?xml version="1.

0 O Cancelamento é uma ação opcional para as transações aprovadas.br/) Nome do módulo de pagamento utilizado. 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. Idioma do pedido.ASP: cancelamento_transacao. 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. 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.asp . será retornado um XML com o resultado do processo. URL de redirecionamento a Cielo para processamento da transação. Data e hora do pedido.Guia de Implementação CIELO Ecommerce 8. 2010 CIELO Ecommerce Página 18 de 21 . Código numérico da moeda. Status da transação. Cancelamento da transação Versão 3. 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. Utilizar: TESTE ou PRODUCAO Código de identificação da transação.1. Ver item 10. será retornado um XML com o resultado do processo.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: . O cancelamento deve ser feito em até 24 horas após a transação.php 8. Breve descrição do pedido. Utilizar: Cancelamento Define o tipo de ambiente. Possíveis status de transação.locaweb. Após a postagem dos dados para cancelamento da transação. passado esse prazo somente poderá ser feito junto à operadora. Valor total da transação.com. Retorno XML do Cancelamento da transação Após a postagem dos dados para cancelamento da transação.

Exemplo do XML retornado: <?xml version="1.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. Formato 1000 para R$ 10.00</mensagem> </erro> 2010 CIELO Ecommerce Página 19 de 21 . Ver item 12. Número de parcelas.0" encoding="ISO-8859-1"?> <transacao versao="1. Detalhe do processamento. Forma de pagamento.0. Possíveis retornos de erro.com. Valor do processamento sem pontuação.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?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.0" encoding="ISO-8859-1"?> <erro> <codigo>999</codigo> <mensagem>Valor nao deve conter ponto nem virgula. Data hora do processamento.com. Versão 3.0" id="1" xmlns="http://ecommerce. Descrição do erro.br/web/index.591-03:00</data-hora> <valor>100</valor> </cancelamento> <urlautenticacao>https://qasecommerce.cbmp. Exemplo do XML retornado: <?xml version="1.Guia de Implementação CIELO Ecommerce Forma de Pagamento (forma-pagamento) bandeira produto parcelas AlfaNum Num Num 1 3 Bandeira.0 Cancelamento (cancelamento) codigo mensagem data-hora valor Num AlfaNum AlfaNum Num 2 100 19 12 Código do processamento.

é necessário que no valor da transação os dois últimos dígitos seja 0. toda autorização será negada. Do contrário. Dados de teste Versão 3. Níveis de segurança da transação Resultado da autenticação Portador autenticado com sucesso Portador não realizou autenticação.0 Para realizar seus testes. 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 . toda autorização será negada. use qualquer valor em que os dois últimos dígitos sejam zeros. 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.Guia de Implementação CIELO Ecommerce 9. 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). 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. Do contrário.  IMPORTANTE: Para simular uma transação autorizada. 10.

xsd Impossibilidade de autenticar uma requisição da loja virtual. 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. pois a transação não está autorizada A captura não pode ser realizada. 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 . com ou sem cartão. 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 o prazo está vencido EC não possui permissão para realizar a autorização A captura não pode ser realizada.0 A mensagem XML está fora do formato especificado pelo arquivo ecommerce. Não existe transação para o identificador informado A transação. 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.

Sign up to vote on this title
UsefulNot useful