Changelog

• Elo: códigos 15, 66, 73, 79, 80;
• Amex: código 102;

• Visa: código 46;
• Elo: código 78;

• Envie o DPAN (token) no campo Card.CardNumber;
• Envie o criptograma no campo Card.SecurityCode.

• Agora é possível editar, ativar ou desativar uma recorrência via site Cielo!

• O Merchant Advice Code (MAC) é um código retornado pela Mastercard em transações negadas ou em outros cenários específicos, como casos envolvendo cartões virtuais, atualização de dados do cartão (ABU) ou requisitos de token.

• O MerchantId informado não existe na base de dados do ambiente selecionado (produção ou sandbox).

Melhoramos a organização das páginas sobre retornos da API E‑commerce;

Conteúdo expandido e aprimorado, com explicações mais detalhadas, exemplos práticos de cenários e orientações claras sobre como interpretar corretamente códigos, status e retornos da API;

Não há nenhuma alteração no comportamento da API.

Saiba mais em Códigos retornados pela API E‑commerce (HTTP, status e códigos de negócio) .

• Visa;
• Mastercard;
• Amex;
• Elo.

Atualizado certificado para uso no domínio api.cieloecommerce.com.br;

Atualizados os contatos do suporte Cielo E-commerce;

Adicionada nova página sobre credenciamento no site Cielo;

Adicionada nova página sobre Visa Intelligent Data Exchange (IDX): solução da Visa para compartilhamento de dados em transações sem cartão presente;

Adicionados os códigos de erro 220 e 233 na documentação;

Adicionada orientação para uso de credenciais do Silent Order Post;

Adicionada orientação sobre uso de autenticação 3DS para cartão de crédito e cartão de débito:

• A validação e o retorno do campo Payment.Eci ocorrem apenas no ambiente de produção neste primeiro momento;

Adicionada orientação sobre erro 389 - Restrição Cadastral do Zero Auth:

• Caso a requisição retorne o erro 389, procure o gestor comercial para validar se o serviço está habilitado corretamente; se estiver, o retorno indica que essa tentativa não pode ser validada por critérios internos da Cielo. Recomendamos tentar outro cartão para concluir a validação;

Adicionada orientação sobre pagamento com cartão multibenefícios:

• Para voucher multibenefícios Alelo, use a integração do tipo voucher;

Adicionadas orientações para cancelamento em voucher Alelo:

• Não é possível realizar cancelamento parcial;
• O cancelamento total pode ser feito apenas no dia da transação (D0);
• Para cancelar após o dia da transação (D+1 em diante), é necessário contatar a Alelo;

Adicionadas orientação para criar pagamento com cartão de crédito:

• Por padrão, a API E-commerce aceita até 12 parcelas para cartão de crédito;

• Para habilitar até 24 parcelas, é necessário entrar em contato com o Atendimento E-commerce. A habilitação estará sujeita à análise interna da Cielo.

• Quando o cartão é tokenizado, o Click to Pay retorna o CAVV e o envio do código de segurança não é obrigatório;
• Quando o cartão não é tokenizado, é obrigatório enviar o código de segurança;

• Adicionado desenho explicativo do processo, incluindo a etapa anterior e a chamada de autorização.

• Ocorre quando a tentativa de cancelamento parcial é feita antes da liquidação.

• 100: Transação não encontrada para cancelamento. Ocorre quando a tentativa de cancelamento parcial é feita antes da liquidação.
• BP900: Falha na operação. Tente novamente em 5 minutos. Recomendamos realizar a consulta do status da transação antes de fazer uma nova tentativa de requisição.
• BP903: Falha no cancelamento. Tente novamente.

• Para confirmar se a autenticação foi acatada na autorização, verifique o valor do ECI em Payment.Eci.
• API replica ECI informado pela loja em Payment.ExternalAuthentication, mas o valor efetivo utilizado pela bandeira é o de Payment.Eci.

• Quando o MerchantOrderId não atende às regras da adquirente, um novo número de pedido é gerado e retornado em SentOrderId;
• Se o formato for válido, SentOrderId retorna o mesmo valor informado em MerchantOrderId.

• O código 14 agora é considerado na categoria 1 e também na categoria 3 (Data Quality).

• Ocorre quando a tentativa de cancelamento parcial é feita antes da liquidação da transação.