Conectando a Cielo

A IuzyPay orquestra o checkout, mas os pagamentos passam pelo seu gateway. Se você já vende com a Cielo, conecte a sua conta para cobrar por lá — inclusive junto com a Pagar.me, a Stripe e a Iugu, com a ordem de cobrança definida em Configurações → Gateways.

A Cielo é adquirente, não subadquirente: quem tem volume costuma pagar bem menos por transação do que numa intermediária. Em troca, ela tem limites que os outros gateways não têm — estão listados no fim deste artigo, e vale ler antes de colocá-la em primeiro na ordem de cobrança.

O que você vai precisar

São quatro credenciais, e elas vêm de dois lugares diferentes.

No site da Cielo, em E-commerce → Gestão API E-commerce:

• O MerchantId — o identificador da sua loja, no formato 8937bd5b-9796-494d-9fe5-f76b3e4da633.
• A MerchantKey — a chave de segurança da loja. Cada ambiente (produção e teste) tem a sua.

E, pedidas ao atendimento e-commerce da Cielo, as credenciais do Silent Order Post:

• O ClientId
• O ClientSecret

O Silent Order Post é o que permite que o cartão do comprador vá direto do navegador dele para a Cielo, sem passar pelos nossos servidores. Sem essas duas credenciais o Pix funciona, mas nenhuma venda no cartão fecha — por isso pedimos as quatro juntas e conferimos todas com a Cielo na hora de conectar.

Se a sua loja usa “IPs confiáveis”, desligue antes. A Cielo permite restringir a integração a uma lista de endereços IP (em Configurações → Gerenciar IPs confiáveis). A IuzyPay não tem IP de saída fixo, então, com a lista ligada, a Cielo recusa todas as nossas chamadas e a conexão não funciona.

Conectando

1. No painel, vá em Configurações → Gateways.
2. Clique em Conectar e escolha a Cielo.
3. Escolha o ambiente: produção ou teste. Como na Iugu, aqui o ambiente não é detectado — o MerchantId é o mesmo nos dois, então quem informa é você. Credenciais de produção conectadas como “teste” fariam vendas reais entrarem como vendas de teste (fora do faturamento, das métricas e dos avisos).
4. Cole o MerchantId, a MerchantKey, o ClientId e o ClientSecret.
5. Cadastre a URL de notificação (abaixo) e salve.

O ambiente fica preso à conexão: para trocar, desconecte e conecte de novo. Trocar o ambiente de uma conexão em uso re-etiquetaria todas as vendas já feitas por ela.

Configurando a notificação (webhook)

Na Cielo é uma URL só, cadastrada por você no Portal E-commerce:

1. No Portal E-commerce da Cielo, vá em Configurações → URL de notificação.

2. Informe:

   https://api.iuzypay.com/v1/webhooks/cielo

3. Salve.

Diferente dos outros gateways, a notificação da Cielo é enviada em lotes, a cada 30 minutos — a própria Cielo recomenda consultar as transações pendentes em vez de esperar por ela. Por isso, enquanto o comprador está na tela do Pix a IuzyPay pergunta à Cielo se o pagamento entrou, em vez de aguardar o aviso: a confirmação continua aparecendo em segundos para quem pagou. A URL segue valendo a pena para o que acontece depois (um estorno feito no painel da Cielo, por exemplo).

Como funciona o Pix por aqui

O QR é gerado pela Cielo com a mesma janela de 1 hora que o checkout mostra. Se o comprador pagar depois de o pedido expirar na sua tela, o pagamento não se perde: na próxima conferência a venda é reconhecida e o pedido volta a pago, com a entrega liberada normalmente.

O Pix precisa estar habilitado na sua conta Cielo (é uma contratação à parte, feita no site da Cielo). Se não estiver, a cobrança é recusada e a venda cai no próximo gateway da sua ordem de cobrança, se houver.

Limites da Cielo hoje

• Nada recorrente passa pela Cielo. Guardar o cartão do comprador exige o serviço Cartão Protegido, contratado à parte, e não temos como saber pela credencial se a sua conta tem. Então assinaturas, upsell de 1 clique, vendas agendadas e compras com cartão salvo não são roteados para a Cielo — vão para outro gateway conectado. Pela Cielo passam Pix e cartão à vista ou parcelado, na compra.
• Sem split de comissão. Comissões de afiliados e co-produtores em vendas pela Cielo liquidam sempre como “A pagar” — você repassa por fora e registra a baixa.
• Chargebacks não chegam por aqui. A contestação da Cielo é um serviço à parte, com credenciais próprias: um chargeback não aparece na Central de disputas nem muda o status do pedido sozinho. Você acompanha e responde no painel da Cielo, e marca o pedido por lá se quiser refletir na IuzyPay. Veja o que é um chargeback.
• Parcelamento em até 12x, com no mínimo R$ 5,00 por parcela. É cláusula do contrato de credenciamento da Cielo para o parcelamento da loja: uma venda de R$ 40 não fecha em 12x (daria R$ 3,33 a parcela). Você não precisa fazer conta — o checkout oferece só as parcelas que a Cielo aceita para aquele valor. Os juros são os seus: o que você configurou em parcelamento no cartão é o que o comprador paga, e a Cielo não acrescenta nada por cima.
• Reembolso total ou parcial, no Pix e no cartão. Veja reembolsar uma venda.

Segurança

A MerchantKey e o ClientSecret são criptografados antes de serem salvos e nunca aparecem de novo em texto. O número do cartão do comprador é enviado direto para a Cielo pelo navegador dele, pelo Silent Order Post (padrão PCI SAQ-A) — dados sensíveis de cartão nunca passam pelos servidores da IuzyPay.