Cielo Recebimento via App com cartão de crédito - devbasetecnologia/devmobility GitHub Wiki

ATENÇÃO: Abaixo segue orientação para clientes que utilizam a Cielo nos Recebimentos via App com cartão de crédito.

Introdução

Essas informações são apenas para clientes que utilizam o Gateway de Pagamento da Cielo.

Obs: a conta deve ser criada a partir de um CNPJ, contas de pessoa física podem não funcionar corretamente no sistema.

Obs: uma conta bancária deve ser vinculada à conta da Cielo, onde você irá receber o saldo das corridas que foram feitas no cartão de crédito. Esta conta deverá estar vinculada ao CNPJ da sua conta Cielo.

  • Atenção: A utilização de pagamento via PIX (tanto para "recarga" como para pagamento direto para a plataforma nas solicitações), depende de liberação das funcionalidades direto com o Gateway (Cielo) para funcionar corretamente. Entre em contato com a Cielo e solicite a liberação em sua conta caso queira utilizar.
  • Caso queira utilizar pagamentos via Pix (direto para a plataforma), é necessário estar ciente de todas as particularidades e exigências dessa funcionalidade.
    Verifique a wiki sobre "Pagamento via Pix para viagens" com as orientações necessárias para utilização da função.

Qual a taxa da Cielo?

R: Essa contratação é feita entre você a Cielo, nesse caso a DevBase não tem interferência no valor da sua taxa, nem com outras questões relacionadas a sua conta. Você pode verificar a taxa diretamente no site da Cielo E até mesmo tentar uma negociação para obter taxas melhores. No link abaixo você pode conferir as taxas padrões e verificar os números para contato telefônico diretamente com a Cielo: https://www.cielo.com.br/e-commerce/api/

Como faço para criar uma conta na Cielo?

R: Através do link: https://www.cielo.com.br/e-commerce/api/

ATENÇÃO:

  • O tipo de conta necessária para a integração é: "API Cielo e-Commerce NEW COMMERCE" (veja imagem mais abaixo).
  • Para que a integração funcione corretamente, é necessário que a conta da Cielo esteja com o "WebHook" ativado nela.
    Para isso é importante orientar a equipe da Cielo a liberação do PIX na API ecommerce, para que o sistema receba um WebHook (notificação) de quando o PIX (Transferência Eletrônica) foi pago.
    Caso eles solicitem uma URL, será necessário informar a eles o link correto correspondente a sua plataforma.
  • Exemplo de URL do webhook: https://webapi-common**.azurewebsites.net/[nome]/api/integracoes/Cielo_Wh
    (O link acima é apenas um exemplo, solicite a nossa equipe de suporte o link completo de sua plataforma quanto for criar a conta)

Após criar a conta o que devo fazer?

R: A Cielo pode levar alguns dias para aprovar sua conta. Quando aprovada você receberá um e-mail de boas vindas, que deverá conter o seu número de estabelecimento, Merchant ID e Merchant Key, parecido com a imagem abaixo:

Ao receber o e-mail, a equipe da DevBase fará a configuração dessas chaves da conta Cielo no sistema, e ele passará a aceitar pagamento em cartão de crédito via App.

Como faço para calcular o saldo do prestador levando em consideração recebimentos em cartão e dinheiro?

R: Você não precisa calcular o saldo, o sistema faz este cálculo. O prestador poderá verificar o seu saldo no menu do aplicativo Menu > Finaceiro > Saldo.

Saldo = Diferença entre os valores para receber da plataforma e os valores para repassar para a plataforma

O relatório financeiro do painel adm apresenta o saldo utilizando o mesmo conceito.

E como administrador você poderá encontrar este mesmo saldo no painel administrativo pela tela Menu > Prestadores > Financeiro Prestadores:

Este relatório calcula o saldo de acordo com o filtro exibido na tela (todos os campos). Ex: se o período DE dia 01/09 ATÉ 25/09 for selecionado, o valor do saldo por prestador será somente deste período.

Obs: o saldo negativo significa que o prestador deve repasses à plataforma (por corridas feitas em dinheiro ou outro meio de pagamento que ficou sob os cuidados do prestador). O saldo positivo significa que a plataforma deve repasses ao prestador (por corridas feitas em cartão de crédito via APP ou Faturado).

Para efetuar uma baixa do saldo, selecione o período que deseja acertar, o motorista ou qualquer outro filtro que desejar e pressione o botão Efetuar Baixa/Acerto localizado abaixo da Grid nesta mesma tela (canto inferior esquerdo):

Mensagem "Credenciais Inválidas" ao usar pagamento Cartão de Crédito

Caso o app do passageiro, apresente a seguinte mensagem "Credenciais Inválidas" (veja imagem abaixo), ao tentar usar a forma de pagamento Cartão de Crédito, trata-se de algum bloqueio na sua conta da Cielo. É necessário entrar em contato com eles (cielo) e verificar o que houve para solicitar a normalização.

Tenha em mãos os dados do seu estabelecimento no momento do contato. Canais para contato Cielo:

  • 4002-5472 (Capitais e regiões metropolitanas)

  • 0800 570 8472 (Demais regiões)

Mensagem "Autorização Negada" ao usar pagamento Cartão de Crédito

Caso o app do passageiro, apresente a seguinte mensagem "Autorização Negada", isso pode ser por vários motivos. Os principais são: "Cielo não autorizou a transação", Cliente com "saldo insuficiente", ou até a própria operadora do cartão do cliente que não autorizou a transação.
Nesse caso, o ideal é entrar em contato com a Cielo, ou até com a operadora do cliente se precisar.

Tenha em mãos os dados do seu estabelecimento no momento do contato.
Canais para contato Cielo:

  • 4002-5472 (Capitais e regiões metropolitanas)

  • 0800 570 8472 (Demais regiões)

Caso a Cielo solicite algum "Comprovante de Transação" e/ou "Autorização de Pagamento"

Após algum tempo que a conta Cielo esteja cadastrada e sendo utilizada no sistema, a cielo pode solicitar um "comprovante de transação" ou uma "autorização de pagamento" do sistema, para verificação. Caso isso aconteça, sugerimos montar um documento word, com o print do "detalhe da solicitação", um print do conteúdo do "análisar rota realizada" dessa solicitação, e o print do "orderID" da mesma solicitação (dentro dos detalhes da solicitação, parte "Pagamento", veja mais abaixo o exemplo)

Além disso, um print da "consulta desse OrderID" direto do painel da Cielo, também pode ser necessário e ajudar.

Como pegar a "Order ID" de uma solicitação Dentro do detalhe da solicitação, no campo "Pagamento", tem uma coluna "Order ID" que registra essa informação para chamadas em cartão de crédito. Com essa "Order ID" é possível ver/consultar essa transação dentro de sua conta Cielo.

Orientação para a Cielo sobre o funcionamento do sistema.

Caso a Cielo solicite alguma explicação, sobre como o sistema funciona, segue algumas orientações abaixo com um exemplo:

  • Trata-se de um sistema de Mobilidade Urbana, portanto realiza muitas transações de autorização sem e com captura, e a maiorias das nossas transações são de valores monetários baixos e muitas vezes repetidos, por conta da tarifagem mínima, e quando o cliente solicita o cancelamento de um serviço, será realizado a devolução do valor para ele.

Segue uma explanação básica de como funciona o sistema de cobrança do aplicativo:

  • O usuário pede a corrida, informa o pagamento, o sistema faz a transação de autorização, aí se ocorre o cancelamento pelo lado do motorista ou do cliente, temos que cancelar a autorização, para sumir da fatura da pessoa. Essa pré-autorização é só para ver se o cartão tem fundos e liberar a corrida.

  • Se a corrida for finalizada, faz a captura (cobrança efetiva). Pode ocorrer também o cancelamento da autorização e a criação de outra, quando no final da corrida o valor for maior que o estimado. Por exemplo: fazemos uma autorização de R$ 10,00, mas no final da corrida o valor é de R$ 15,00. O sistema cancela a autorização de R$ 10,00 e faz uma nova de R$ 15,00.