Histórico da Página

Informações Gerais

Objetivo

Implementar o novo modelo de integração de pagamento com cartão CHECKOUT CIELO, descrevendo as funcionalidades, os métodos a serem utilizados, listando informações a serem enviadas e recebidasno portal Educacional e Processo Seletivo.

Definição da Regra de Negócio

O CHECKOUT CIELO é uma solução de checkout projetada para aumentar a conversão, simplificar o processo de compra, reduzir fraudes e custos operacionais. Será utilizada a integração com Carrinho de Compras (via POST).

Os campos a serem preenchidos no formulário a ser postado para o Checkout Cielo se referem basicamente a 5 grupos: Dados do Pedido, Carrinho de Compras, Dados do Frete, Dados do Consumidor e Antifraude.

A integração via POST deve enviar os parâmetros, descritos na tabela 1B do manual em anexo, a URL: https://cieloecommerce.cielo.com.br/Transactional/Order/Index.

1 - Parametrização1 - Parametrização (Etapa 02.02.02.03 - Cartão de Crédito/Débito)

1.1 - Configurações Gerais Cartão de Crédito/DébitoDébito 

• Configurações Gerais 1/2: 
  Como a solução BuyPage da Cielo não foi descontinuada, será criado um parâmetro "Modelo E-commerce" para informar qual a modelo de integração com a Cielo será utilizada, com as seguintes opções:

• 1 - BuyPage e

Será criado um parâmetro para informar a URL de Post (Id. 1105 da FPARAM usando o campo TEXTO). Este parâmetro será visível para ambos os modelos.

• 2 - Checkout 
• Configurações Gerais 2/2:
  Se a opção BuyPage marcada serão exibidos os campos "Codigo de Afiliação do Lojista", "Ambiente Ativo", "Chave Acesso do Lojista", "URL Ambiente Teste" e "URL Ambiente Produção".
  Se a opção Checkout marcada serão exibidos os campos: "MerchantId" que é o identificador do cliente junto a Cielo, e "URL de Post" onde será enviado um post para Cielo utilizando a API Rest, para iniciar a transação do pagamento com cartão de crédito/débito.

1.2 - Configurações Cartão de Crédito/Débito

• Bandeira

• 1/3:
  Configurações de crédito/débito para a bandeira Visa, com campos de Conta Caixa e Meio de Pagamento. Se opção BuyPage marcada será exibido o campo "Ativar Bandeira Visa", "Numero de Parcelas" e "Ativar Função Débito".
• Bandeira 2/3:
  Configurações de crédito/débito para a bandeira Master, com campos de Conta Caixa e Meio de Pagamento. Se opção BuyPage marcada será exibido o campo "Ativar Bandeira Master" "Número de Parcelas" e somente a opção crédito.
• Bandeira 3/3:
  Configurações de crédito para outras bandeiras, com campos de Conta Caixa e Meio de Pagamento. Somente visível se opção Checkout marcada.

2 - Envio do Post para Cielo

Será utilizada a integração com Carrinho de Compras utilizando API Rest para envio do post. A URL de Post que deverá ser utilizada é https://cieloecommerce.cielo.com.br/api/public/v1/orders.

Para a integração serão utilizados os parâmetros abaixo:

REQUISIÇÃO

Header Http

Body

RESPOSTA

Em caso de sucesso

Em caso de erro

3 - Portal Educacional e Processo Seletivo

Os parâmetros Ativar Bandeira Visa e Ativar Função Débito serão descontinuados, ou seja, para o modelo BuyPage na página onde o usuário seleciona a bandeira e função crédito ou débito sempre será apresentada. 

O parâmetro Numero máximo de Parcelas será habilitado somente no modelo BuyPage.

1.3 - Configurações Cartão Bandeira MasterCard

O parâmetro Ativar Bandeira Master será descontinuado, ou seja, para o modelo BuyPage na página onde o usuário seleciona a bandeira e função crédito ou débito sempre será apresentada. 

O parâmetro Numero máximo de Parcelas será habilitado somente no modelo BuyPage.

1.4 - Configurações Cartão Outras Bandeiras

Será criada essa nova etapa para configuração da Conta Caixa e Meio de Pagamento quando utilizado outras bandeiras para pagamento com cartão. 

2 - Página de Extrato Financeiro - Portal Educacional

Quando o cliente estiver usando o modelo Checkout da Cielo e no Totvs Gestão Educacional a opção "Pagamento dos boletos pode ser efetuado com cartão de crédito" estive marcado, na tela 'Confirmar Dados Cadastrais', quando o usuário clicar na imagem do cartão no botão 'Avançar' o mesmo será redirecionado para a pagina de pagamento segura da Cielo.

3 4 - Retorno, Notificação e Mudança de status

34.1 - Será criada uma página de Retorno retorno na qual o usuário será redirecionado assim que pagamento for concluído no ambiente seguro da Cielo. Caso o cliente não configure a página de retorno no BackOffice da Cielo o usuário será redirecionado para uma página própria da Cielo.

34.2 - Será criada uma página, sem autenticação, que deve ser preparadas para receber os dados do POST de Notificação e Mudança de Status enviados pela Cielo no momento que a transação é finalizada ou ter seu status alterado. A página deverá exibir um código informando que recebeu a notificação e a processou com sucesso. Código:<status>OK</status>

Parâmetros do Post de Notificação

3.3 - Será criada uma página que deve ser preparada para receber os dados do POST de Mudança de Status enviados pela Cielo quando um pedido tiver seu status alterado. Este post contém apenas os dados de identificação do pedido. A página deverá exibir um código informando que recebeu a mudança de status e a processou com sucesso. Código:<status>OK</status>

Parâmetros do Post de Mudança de Staus

Tabela 1 - Meio de Pagamento

Tabela 2 - Bandeira

Tabela 3 - Banco Emissor

Tabela 4 - Status AntiFraude

Tabela 5 - Status da transaçãoO parâmetro payment_status poderá vir com um dos seguintes valores:

4 - Cancelamento 

Processos:

Após receber o post notificação e enviar o status "ok" o sistema deve armazenar na tabela de Integração do cartão (FINTEGRACAOCARTAO), com os seguintes valores:

• IDENTIFICADORORIGEM: "Coligada" + '|' + "Identificador do Boleto"
• IDPROCESSO: tid
• IDCHECKOUT: checkout_cielo_order_numbe
• BANDEIRA: payment_method_brand
• DATAHORA: created_date
• IDSTATUS: payment_status
• CODAFILIACAO: merchantid
• MEIOPAGTO: payment_method_type
• NUMPARCELAS; payment_installments
• CODCOLIGADA: código da coligada
• IDBOLETO: identificador do boleto
• IDMODELO: preencher com 2 (Checkout Cielo)

Os pagamentos com cartão de crédito com status Autorizado serão automaticamente marcados como Baixa Pendente no RM e serão baixado somente quando o pagamento for capturado.

Ao mudar o status de pagamento com status "Pago" para "Cancelado" ou "ChargeBack" no BackOffice da Cielo, será automaticamente cancelado a baixa do boleto referente ao pagamento no RM.

Ao mudar o status de pagamento com status "Autorizado" para "Cancelado" no BackOffice da Cielo, será automaticamente liberado a Baixa Pendente do lançamento referente ao pagamento no RM.

Toda mudança de status do pagamento na Cielo será também alterado o status na tabela Integração do cartão (FINTEGRACAOCARTAO) do RMDiferente do modelo BuyPage, no modelo de Checkout o cancelamento do pagamento com cartão deve ser feito no Backoffice Checkout da Cielo e no Totvs Gestão Financeira manualmente.

5 - Backoffice Checkout Cielo

O cliente deve configurar as 3 URLs (a URL de Retorno, Notificação e Mudança de Status ), as bandeiras de cartão ativas, o numero máximo de parcelas e o ambiente de testes em seu Backoffice Checkout Cielo, na aba Configurações:

Image Removed

no BackOffice. A URL de Retorno é opcional.

URL de Retorno: .../Corpore.Net/Source/Fin-Financeiro/RM.Fin.Lan/FinLanCartaoRetornoCheckout.aspx

URL de Notificação : .../Corpore.Net/Source/Fin-Financeiro/RM.Fin.Lan/CheckoutCielo/FinLanCartaoNotificacao.aspx

URL de Mudança de Status: .../Corpore.Net/Source/Fin-Financeiro/RM.Fin.Lan/CheckoutCielo/FinLanCartaoMudancaStatus.aspx

Image Added

Fluxo do Processo

Image Added

Dicionário de Dados

Arquivo ou Código do Script: FS.2016.03_01; FS.2016.03_02; FS.2016.06_02

Fluxo do Processo

Image Removed