O cancelamento é utilizado quando o lojista decide não efetivar um pedido de compra, seja por insuficiência de estoque, por desistência da compra pelo consumidor, ou qualquer outro motivo. Seu uso faz-se necessário principalmente se a transação estiver capturada, pois haverá débito na fatura do portador, caso ela não seja cancelada.
INFORMAÇÃO: Se a transação estiver apenas autorizada e a loja queira cancelá-la, o pedido de cancelamento não é necessário, pois após o prazo de captura expirar, ela será cancelada automaticamente pelo sistema.
3.6.1 Cancelamento Total e Parcial Objetivo
Realizar o cancelamento do valor total ou parcial de uma transação. Regras
O cancelamento total é válido tanto para transações capturadas, como autorizadas; o parcial é válido apenas para as capturadas.
O prazo de cancelamento é de até 120 dias para a modalidade crédito e D+0 para débito.
O cancelamento total, quando realizado com sucesso, altera o status da transação para “9 – Cancelada”, enquanto que o parcial não altera o status da transação, mantendo-a como “6 – Capturada”.
Caso a TAG <valor> não seja fornecida, o sistema assumirá um cancelamento total. Para bandeira AMEX está disponível apenas o cancelamento total.
Para a modalidade débito, não existe a possibilidade de efetuar cancelamento parcial. Transações com Taxa de embarque:
Transações capturadas com o mesmo valor da autorização (ou seja, captura total) possuem o mesmo tratamento para cancelamentos parciais e totais, pois o valor da taxa de embarque é cancelado integralmente.
A
TENÇÃO:Os cancelamentos (parciais ou totais) das transações com taxa de embarque e captura parcial não serão acatadas automaticamente pelo sistema.Mensagem de requisição Exemplo do XML:
<?xml version="1.0" encoding="ISO-8859-1"?>
<requisicao-cancelamento id="13368079-dedc-4cdf-9140-84473faf83d4" versao="1.2.1"> <tid>100699306903613D1001</tid> <dados-ec> <numero>1006993069</numero> <chave>25fbb99741c739dd84d7b06ec78c9bac718838630f30b112d033ce2e621b34f3 </chave> </dados-ec> <valor>200</valor> </requisicao-cancelamento> Descrição dos campos:
Nó raiz: <requisicao-cancelamento/>
TAG Tipo Obrig. Tam. Descrição
dados-ec.numero N R 1..10 Número de credenciamento da loja com a Cielo.
dados-ec.chave AN R 1..100 Chave de acesso da loja atribuída pela Cielo.
Tid AN R 1..40 Identificador da transação.
Retorno
<?xml version="1.0" encoding="ISO-8859-1"?>
<transacao versao="1.2.1" id="2c18f00a-3ff6-4c85-8865-a4fde599b2b2" xmlns="http://ecommerce.cbmp.com.br">
<tid>100699306903613E1001</tid>
<pan>uv9yI5tkhX9jpuCt+dfrtoSVM4U3gIjvrcwMBfZcadE=</pan> <dados-pedido> [OMITIDO] </dados-pedido> <forma-pagamento> [OMITIDO] </forma-pagamento> <status>9</status> <autenticacao> [OMITIDO] </autenticacao> <autorizacao> [OMITIDO] </autorizacao> <captura> [OMITIDO] </captura> <cancelamentos> <cancelamento> <codigo>9</codigo>
<mensagem>Transacao cancelada com sucesso</mensagem> <data-hora>2011-12-08T16:46:35.109-02:00</data-hora> <valor>1000</valor>
</cancelamento> </cancelamentos> </transacao>
4 Testes e Homologação
Os testes de integração deverão ser realizados antes do início da homologação, durante o desenvolvimento (codificação) da solução. Para isso, deve-se considerar o seguinte ambiente como EndPoint do Webservice:
https://qasecommerce.cielo.com.br/servicos/ecommwsec.do
A
TENÇÃO:Toda a conexão aos serviços da Cielo deve ser feita através das URL’s divulgadas neste manual. A Cielo desaconselha fortemente a conexão direta via IP, uma vez que estes podem variar sem aviso prévio.A massa de dados para realizar os testes neste ambiente está disposta na tabela abaixo: Bandeira Autenticação Número Cartão Validade Cód. Segurança
4012001037141112 05/2018 123
5453010000066167 05/2018 123
4012001038443335 05/2018 123
5453010000066167 05/2018 123
376449047333005 05/2018 1234
6362970000457013 05/2018 123
6011020000245045 05/2018 123
3566007770004971 05/2018 123
5078601912345600019 05/2018 123Para facilitar o desenvolvimento disponibilizamos duas chaves para testes, uma para cada modalidade de integração. Com base nas configurações iniciais feitas durante o seu credenciamento, escolha os dados corretos para realizar os testes:
Número de Estabelecimento
Comercial Chave
A
TENÇÃO: O valor do pedido além de seguir o formato sem pontos ou vírgulas decimais, deve terminar em “00”, caso contrário, a autorização será sempre negada. Exemplo: R$ 15,00 deve ser formatado como “1500”. A
TENÇÃO:O ambiente de testes só deve ser utilizado pelos estabelecimentos de testes listados no quadro acima. O uso de dados originais do estabelecimento gerará transações não possíveis de rastreamento, gerando resultados incorretos. No ambiente de testes, use as credenciais para testes, no ambiente de produção, use os dados originais do estabelecimento.Após a conclusão do desenvolvimento, a etapa de Homologação garantirá que a implementação foi adequada e a solução do Cliente está apta para interagir no ambiente produtivo da Cielo. Ela sempre acontece depois que o desenvolvimento foi finalizado e testado. É composta pelas seguintes etapas:
1. Finalização do Cadastro: nesta etapa o Cliente deve enviar um email para [email protected], solicitando a Chave de Produção. A mensagem deve conter as seguintes informações, que irão completar o cadastro:
URL Definitiva do site (ambiente de produção).
Nome da empresa responsável pelo desenvolvimento da integração. Nome e e-mail do técnico (desenvolvedor) responsável pela integração. Número de credenciamento (junto à Cielo) da loja virtual.
Razão social e nome fantasia da loja virtual.
Um usuário e senha na loja virtual para efetuar compras de testes. URL do logotipo da loja no formato GIF e tamanho de 112X25 pixels.
A
TENÇÃO:A imagem do logotipo deve estar hospedada em ambiente seguro (HTTPS), caso contrário o consumidor receberá notificações de segurança que podem culminar no abandono da compra.Em resposta, a Cielo retornará uma chave válida no ambiente de produção. Logo, a loja está habilitada a realizar seus testes nesse ambiente. Inicia-se a segunda etapa. É importante que testes sejam realizados para cobrir os seguintes tópicos:
Interação com o Webservice: testes com a conexão utilizada.
Integração visual: a ida e a volta do fluxo a Cielo (fluxos alternativos devem ser considerados).
Aplicação correta da marca da bandeira.
Neste momento, deve-se considerar o ambiente abaixo: https://ecommerce.cielo.com.br/servicos/ecommwsec.do
A
TENÇÃO: A integração da loja virtual deverá ser feita sempre através da URL acima e não por IP. Os testes em produção devem ser feitos com cartões de propriedade da Loja ou cujo portador tenha autorizado seu uso, uma vez que neste ambiente existe compromisso financeiro sobre as transações realizadas.Ao término, uma nova solicitação deve ser enviada para [email protected], para que a Cielo realize a homologação de fato. Um conjunto de testes será executado aprovar e negar transações. O resultado “HOMOLOGADO” é enviado por e-mail. Caso haja algum ponto que não permite a conclusão da homologação, a informação será igualmente enviada por email solicitando as correções necessárias.