A Xuru agora integra Cielo e Lalamove no orquestrador da plataforma — o mesmo lugar onde você já conecta Pagar.me, Asaas, Melhor Envio, SuperFrete e outros parceiros. Você configura credenciais e webhooks pelo painel, sem precisar de equipe técnica. Esta página explica o que muda e traz o passo a passo de integração.
O que é cada integração
Cielo é um gateway de pagamento via Checkout Cielo: o associado finaliza PIX, cartão de crédito ou boleto na página hospedada da Cielo. Quando o pagamento confirma, a Xuru recebe o aviso por webhook e atualiza o pedido automaticamente.
Lalamove é frete expresso on-demand: no pedido o associado vê cotação por veículo (moto, carro, van ou caminhão). Após a separação do pedido, a Xuru solicita o motorista e sincroniza o rastreio — também via webhook.
O que dá pra fazer
- Receber por PIX, cartão e boleto com a Cielo — o associado escolhe o meio na página de pagamento da Cielo (
CheckoutUrl). - Cotar entrega expressa com a Lalamove no pedido, com preço e prazo estimado por tipo de veículo.
- Manter o pedido sincronizado — status de pagamento (Cielo) e de entrega (Lalamove) atualizam no painel quando os webhooks estão configurados.
- Escolher provedores no orquestrador — um gateway de pagamento e um provedor de frete ativos por vez, no mesmo fluxo dos demais parceiros já disponíveis na Xuru.
- Testar antes de produção — a Lalamove oferece ambiente Sandbox; na Cielo, use as credenciais de homologação conforme o contrato da associação.
Preciso de quê para começar?
- Perfil de Administrador ou Gerente na associação dentro do XURU — só esses perfis acessam Configurações → Meios de Pagamento e Configurações → Frete.
- Conta Cielo com Checkout habilitado: Merchant ID, Client ID e Client Secret (OAuth) gerados no Site Cielo.
- Conta Lalamove no Partner Portal: API Key e API Secret do ambiente desejado, além de saldo na carteira para confirmar entregas.
- Endereço do embarcador preenchido em Configurações → Frete (CEP, endereço completo, CNPJ/CPF do responsável e telefone) — usado na cotação e na coleta Lalamove.
- Peso nos produtos cadastrados — a Lalamove seleciona o veículo adequado conforme o peso total do pedido.
Como integrar, passo a passo
Abaixo estão os passos detalhados para cada parceiro — credenciais no portal deles, conexão no painel Xuru, ativação de métodos ou veículos e cadastro dos webhooks. Siga na ordem indicada em cada seção.
Cielo
Checkout Cielo (PIX, boleto e cartão)
Obtenha as credenciais
No Site Cielo → E-commerce → Checkout → Configurações → Dados Cadastrais: anote o Merchant ID e gere Client ID + Client Secret (OAuth) pelo botão de credenciais de API.
Habilite PIX, boleto e cartão em Integração com meios de pagamento no portal Cielo, conforme o contrato da associação.
Configure no painel da plataforma Xuru
Em Configurações → Meios de Pagamento, clique + Adicionar Gateway, selecione Cielo e preencha Merchant ID, Client ID e Client Secret.
Ative os métodos
Após salvar, ative PIX, Cartão de Crédito e/ou Boleto. O comprador escolhe o meio na página hospedada da Cielo (CheckoutUrl).
Teste a conexão
Use o botão Testar Conexão para verificar se as credenciais estão corretas. O status deve mudar para Conectado.
Configure webhooks no Site Cielo
O que é um webhook? A Cielo avisa a Xuru quando o comprador finaliza o pagamento ou quando o status muda (ex.: PIX pendente → pago). Configure as URLs de Notificação e Mudança de Status nas configurações da loja Checkout.
https://www.xuru.com.br/api/webhooks/cielo
Lalamove
Entrega expressa on-demand
Obtenha as credenciais
Acesse o Partner Portal Lalamove e crie (ou acesse) sua conta de parceiro. Gere a API Key e o API Secret do ambiente desejado (Sandbox para testes ou Produção).
Mantenha saldo na carteira Lalamove — a confirmação do pedido de entrega debita automaticamente desse saldo.
Configure no painel da plataforma Xuru
Em Configurações → Frete, ative o switch Integração e expanda o card Lalamove.
Selecione o ambiente, cole a API Key e o API Secret e confirme em Validar e conectar.
Se a associação ainda não tiver provedor ativo, a Lalamove será definida automaticamente como provedor de frete após a validação.
Configure o endereço de origem
Na mesma aba Frete, preencha Dados do embarcador (CEP, endereço completo, CNPJ/CPF do responsável e telefone). A Lalamove usa esses dados na cotação e na coleta.
Dimensões dos produtos
Nos cadastros de produtos, informe peso — a Lalamove seleciona automaticamente o veículo adequado (moto, carro, van ou caminhão) conforme o peso total do pedido.
Ative os tipos de veículo
No card Lalamove conectado, marque quais veículos aparecem na cotação da loja (moto, carro, van, caminhão). Recomendamos manter moto e carro ativos para a maioria dos pedidos.
Configure o webhook no Partner Portal
O que é um webhook? A Lalamove avisa a Xuru quando o status da entrega muda (motorista a caminho, coletado, entregue). Assim o pedido é atualizado na hora, sem precisar clicar em "Atualizar rastreio".
No Partner Portal, cadastre a URL de callback da Xuru nas configurações de webhook da sua conta.
https://www.xuru.com.br/api/webhooks/lalamoveCotação, pedido e rastreio
No checkout, o associado vê as opções Lalamove com preço e prazo estimado. Após confirmação do pedido, conclua a separação e crie o envio pelo painel — a Xuru solicita o motorista e sincroniza o rastreio automaticamente com o webhook ativo.
Problemas comuns
- Pagamento não confirma na Xuru: verifique se o webhook Cielo aponta para
https://www.xuru.com.br/api/webhooks/cieloe se Client ID / Client Secret estão corretos. - Frete Lalamove não aparece no pedido: confirme que a Lalamove é o provedor ativo, que os produtos têm peso cadastrado e que ao menos um veículo está habilitado no card.
- Erro ao solicitar motorista: verifique saldo na carteira Lalamove e se o endereço do embarcador está completo.
- Cotação expirou: cotações Lalamove têm validade curta (~5 min) — o associado precisa finalizar o pedido em seguida.
Precisa de ajuda?
Se a conexão falhar, envie print do card no painel (sem expor segredos) e da configuração de webhook ao canal de implantação ou suporte acordado com a sua associação. Para o fluxo geral de pedidos e pagamentos, consulte também o guia Pedidos e pagamentos.