Migração do Gateway Cel payments API V1 para V2
Introdução
Este documento visa orientar sobre o processo de migração da integração da API Cel payments da versão V1 para a versão V2, e é aplicável para a integração de Boleto Híbrido e para a de Cartão de Crédito.
A atualização visa otimizar o fluxo de cobranças e melhorar a experiência do usuário, além de garantir compatibilidade com as novas funcionalidades oferecidas pela V2 da API Cel payments.
Caminho: Menu Sistema > Cadastros > Financeiro > Carteira de cobrança > aba Configurações gateway
O procedimento de migração está estruturado nas seguintes etapas:
- Configuração Inicial – Acesso e configuração básica na Cel payments (GalaxPay) e IXC Provedor.
- Configuração do Webservice – Atualização de campos e tokens.
- Teste e Validação – Emissão de boletos e acompanhamento de recorrências.
- Finalização e Homologação – Garantia de funcionamento adequado e homologação da configuração.
1. Configuração Inicial
Para configurar a nova API V2 na Cel payments (GalaxPay):
- Acesse sua conta na Cel payments (GalaxPay).
- Navegue até Módulos e clique em Configurar na seção de Webservice.
- Selecione o evento
transaction.updateStatusna opção API V2. - Copie e salve o
Token de segurança do webhooknecessário.
No IXC Provedor:
- Acesse Cadastros > Pasta Financeiro > Carteira de cobrança.
- Selecione a carteira correspondente, edite seu cadastro.
- Dependendo da integração que utiliza, vá até a aba:
- Para carteira de boleto híbrido:
Configurações gateway - Para carteira de Cartão de Crédito:
Configurações cartão de crédito - Em seguida, atualize os seguintes campos:
Versão API: selecione a opçãoV2.Webhook ID: Insira oToken de segurança do webhook.
- Para carteira de boleto híbrido:
Após salvar, copie a URL gerada no campo Webhook URL Callback.
2. Configuração do Webservice
- Acesse sua conta na Cel payments novamente.
- No menu lateral, navegue até Módulos e clique em Configurar na seção de Webservice.
- Preencha o campo
URL Webhookcom a URL gerada ao salvar a carteira no IXC Provedor, que foi copiada anteriormente.
3. Teste e Validação
- Emita um boleto no sistema para testar o funcionamento.
- Acompanhe recorrências e verifique a execução correta das transações.
4. Finalização e Homologação
- Verifique a comunicação correta entre o sistema e a API Cel payments V2.
O parceiro Cel payments (GalaxPay) também disponibilizou um tutorial de migração da versão através da seguinte página:
- [Manual de integração - IXC](https://ajuda-celpayments.Cel payments.com.br/post/115)
É obrigatório rodar uma consulta de pagamentos com a carteira de cobrança migrada para garantir que os recebimentos do período da configuração ocorram corretamente.
Considerações Finais
A migração para a API V2 da Cel payments é essencial para assegurar o uso contínuo e eficiente dos serviços de cobranças. Assegure que todas as etapas acima sejam executadas com precisão para garantir um funcionamento estável.
É crucial acompanhar até a homologação para evitar possíveis falhas em recebimentos futuros.