¶ Integração com o PIX do C6 - ZP Cobrança
Objetivo: Permitir que o ZP Cobrança se integre à API do C6 Bank para gerenciar e processar transações PIX, utilizando credenciais específicas e uma chave PIX cadastrada para recebimento.
¶ Parâmetros exigidos
| Parâmetro | Descrição |
|---|---|
| client_id | ID do cliente (aplicação) gerado na plataforma de integração do C6 Bank. |
| client_secret | Segredo do cliente (aplicação) gerado na plataforma de integração do C6 Bank. |
| certificado_crt | Chave pública do certificado digital (CRT) para autenticação segura. |
| chave_pix | Chave PIX (e.g., CNPJ, e-mail, telefone, aleatória) cadastrada no C6 Bank para recebimento de cobranças. |
¶ Como obter os parâmetros?
¶ 1. Acesse o Portal C6 para Empresas
- Entre com seu usuário e senha na plataforma C6 Bank, acessando a área de empresas.
Fonte: Portal C6 Bank para Empresas.
¶ 2. Navegue até o menu “Mais produtos” > “Integrações via API”
- Com seu acesso do portal C6 para empresas.
Fonte: Interface do Portal C6 Bank para Empresas.
¶ 3. Clique em “Criar sua primeira chave”
- Selecione o parceiro ZP COBRANÇA (25.337.354/0001-57) na lista suspensa.
¶ 4. Preencha a descrição da chave (ex: erp sisgp pix).
- Clique em Confirmar/Avançar para gerar a chave.
Fonte: Interface do Portal C6 Bank para Empresas.
¶ 5. Copie os valores de ClientId e ClientSecret
- Esses valores são exibidos logo após a criação da chave. Copie e salve-os imediatamente em um local seguro, pois geralmente não são exibidos novamente por motivos de segurança.
Fonte: Interface do Portal C6 Bank para Empresas durante a geração da chave.
¶ 6. Baixe o Certificado Gerado (certificado_crt)
- Será disponibilizado um arquivo para download (geralmente
.zip). - Este arquivo conterá:
certificado.crt: a chave pública (utilize comocertificado_crt).certificado.key: a chave privada.
- ⚠️ Atenção: Este certificado não poderá ser baixado novamente. Caso perca, será necessário criar uma nova chave.
Fonte: Interface do Portal C6 Bank para Empresas durante a geração da chave.
¶ 7. Navegue até a seção de PIX para obter a chave_pix
- Suas chaves cadastradas estarão visíveis. Escolha aquela que será utilizada para o recebimento das cobranças ou cadastre uma nova.
Fonte: App ou Internet Banking do C6 Bank para Conta PJ.
¶ 8. Envie os parâmetros ao ZP Cobrança para homologação
- O passo a passo detalhado é explicado em Exemplo de configuração no ZP Cobrança.
¶ Considerações Importantes para a Integração
- Finalidade da Chave PIX: Certifique-se de que a
chave_pixinformada seja a chave correta e ativa para a conta que deve receber os pagamentos via PIX. - Permissões da API: A chave de API gerada no portal do C6 (associada ao
client_ideclient_secret) deve ter as permissões necessárias para interagir com o módulo de PIX do banco. Se houver dúvidas, entre em contato com o suporte do C6 Bank. - Segurança: Mantenha todas as credenciais (Client ID, Client Secret, certificado) e a chave PIX em local seguro e confidencial.
- Documentação da API: Embora os passos acima guiem a obtenção dos parâmetros, os detalhes técnicos da integração em si (endpoints, formatos de requisição e resposta para criar e consultar cobranças PIX, webhooks, etc.) são fornecidos na documentação da API do C6 Bank. Se você não tiver acesso direto a essa documentação, será essencial entrar em contato com o suporte técnico do C6 Bank para obtê-la e garantir que a integração seja feita de forma correta e robusta.
¶ Exemplo de configuração no ZP Cobrança
Para configurar os parâmetros obtidos, siga as seguintes etapas:
- 1. Faça login no ZP Cobrança
- 2. Clique em App
- 3. Clique no menu Parâmetros do Banco
- 4. Clique nos 3 pontinhos da linha referente ao C6 PIX
- 5. Clique em Alterar
- 6. Insira as informações coletadas
{
"client_id": "1111aa11-1111-1a1a-1111-11a1a1a1aa1a",
"client_secret": "AAbAbbA11bAAAAbbAAAAbAA1AA1AAAbbA",
"certificado_crt": "<conteúdo do certificado.crt>",
"certificado_key": "<conteúdo do certificado.key>",
"chave-pix": "a1A1A1a1-1a1a-A1a1-1A1A-a1A1a1A1a1A1"
}- 7. Clique em Alterar no final da tela.
- 8. Ao aparecer, “Salvo com sucesso.” indica que os parâmetros foram cadastrados.
*Este procedimento é obrigatório para permitir que o ZP Cobrança se comunique com o sistema bancário do C6 via API.