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

Será criado um serviço para ficar "ouvindo" as notificações e mudança de status da Cielo referente as transações de pagamento com cartão.

4 - Cancelamento 

No modelo de Checkout o cancelamento do pagamento não é automático, ou seja, o mesmo deve ser feito no backoffice da Cielo e no Totvs Gestão Financeira.

OBS:

No modelo Checkout, deve ser configurado no próprio sistema da Cielo:

- URL de retorno, notificação e mudança de status.

- Valor mínimo para parcela, desconto para pagamento com débito, autenticar transações de Cartão de Crédito (marcar essa opção faz com que todas as transações de cartão de crédito sejam direcionadas a tela de verificação do banco emissor do cartão), meios de pagamento ativos, captura automática, valor mínimo anti-fraude, etc.

- Ambiente para teste.

4.1 - Será criada uma página de 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.

4.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

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ção

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 RM.

5 - Backoffice Checkout Cielo

O cliente deve configurar a URL de Retorno, Notificação e Mudança de Status 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