Como configurar a integração com a Cyclopay na Uappi?

O que é a Integração com a Cyclopay?

A Cyclopay (plataforma de vendas recorrentes da Lyra) é um gateway de pagamento integrado à Uappi, oferecendo suporte para Pix, boleto e cartão. 

A plataforma possibilita transação, captura, estorno, cadastro de webhook e callback, além da funcionalidade de split de pagamento para os três métodos suportados.

Passo a Passo

1. Obtenha suas Credenciais da Cyclopay

Para configurar o gateway na Uappi, é necessário obter as credenciais de API. Siga os passos abaixo:

• Acesse o painel da Cyclopay e faça login na sua conta.
• No menu lateral esquerdo, clique em Acesso.
• Clique na opção Criar chave de API e copie a chave gerada.
• Caso precise de mais informações, acesse a documentação da API da Cyclopay.

⚠️ Importante: a API da Cyclopay exige o cadastro manual da URL de callback. Essa configuração não é ativada automaticamente e deve ser feita antes da ativação do gateway.

2. Configure o Gateway de Pagamento na Uappi

Após obter suas credenciais, siga os passos abaixo para configurar a Cyclopay na Uappi:

1. Acesse Configurações > Pagamento > Gerenciamento.
2. Selecione a opção de edição do gateway Cyclopay.

Na tela de configuração, preencha os seguintes campos:

✅ Homologação: ativa o ambiente de testes para simular transações sem impacto real.
✅ Chave de Autenticação da API: insira a hash adquirida no painel da Cyclopay.
✅ Alterar status do pedido quando a transação for cancelada: define se o status do pedido será atualizado automaticamente em caso de cancelamento.
✅ Descrição na fatura do cartão: define como a compra aparecerá na fatura do cliente.
✅ Observação do pagamento: insira uma mensagem que será exibida no detalhe do pagamento.

Após preencher todos os campos, clique em “Salvar” para concluir a configuração.

Configuração de Callbacks

A configuração de callbacks na Cyclopay deve ser feita manualmente, pois a Uappi ainda não possui esse recurso integrado diretamente.

• Entre em contato com o time da WAPI para que essa configuração seja realizada via WAPI.
• Sem essa configuração, o callback não será ativado automaticamente.

Dicas Úteis

• Teste antes de ativar em produção! Utilize o ambiente de homologação para garantir que as transações ocorrem corretamente.
• Verifique se seu token está atualizado no painel da Cyclopay antes de ativar o gateway.
• Confirme com a WAPI se o callback foi configurado corretamente antes de liberar os pagamentos.
• Consulte a documentação da Cyclopay para mais detalhes sobre funcionalidades como split de pagamento.

Dúvidas Comuns

• Preciso ter uma conta na Cyclopay para configurar o gateway na Uappi? Sim, é necessário criar uma conta e obter as credenciais diretamente no painel da Cyclopay.
• Como funciona a configuração do split de pagamento? A Cyclopay permite dividir os valores entre diferentes recebedores. Consulte a documentação para configurar corretamente.
• O callback é ativado automaticamente? Não. O callback precisa ser configurado manualmente no painel da Cyclopay e ajustado via WAPI.
• Consigo testar pagamentos antes de ativar para os clientes? Sim! O ambiente de Homologação permite simular transações sem impactar pedidos reais.

Precisa de mais ajuda?

Acesse nossa base de conhecimento na Central de Ajuda para mais conteúdos sobre a Uappi.