📌 FAQ – Como Gerar as Credenciais da API de Contas

✅ O que é IP na API de Contas?
Ao gerar credenciais de acesso à API de Contas, é possível incluir um ou mais endereços IP autorizados. Essa configuração adiciona uma camada extra de segurança, garantindo que apenas chamadas originadas desses IPs sejam aceitas pelo sistema.

✅ O que são as credenciais da API de Contas?
As credenciais permitem habilitar operações de saída via API de Contas. Cada credencial contém:

• Client ID

• Client Secret

Esses dados são gerados automaticamente pelo sistema após clicar em “Gerar”.

Observação: 
Os webhooks da API de Contas da Pagstar são enviados pelos IPs fixos: 52.67.231.226 e 54.207.192.19.

✅ Como gerar as credenciais com IP?

1. Acesse o portal Finance

Acesse: https://finance.pagstar.com/

Digite o CPF ou CNPJ cadastrado e clique em Entrar. 

2. Na tela inicial, localize o menu lateral esquerdo e clique em Configurações.

3. Acesse a aba "API Contas" para entrar na seção de criação de credenciais.

Clique em “+ Nova credencial”, uma janela será exibida para que você selecione as permissões de acesso da credencial.

🚨⚠️ Atenção Importante ⚠️🚨
Ao gerar uma nova credencial, não exclua a anterior imediatamente, pois ela ainda está conectada ao seu sistema.
Exclua a credencial antiga somente após configurar e validar a nova em seu sistema.

4. Preencha os IPs autorizados (pode ser um único IP ou uma lista).

Após selecionar as opções dejadas e incluir os IPs, clique em “Gerar” para obter o Client ID e o Client Secret.

Obs: A descrição é obrigatória, utilize o campo para inserir a descrição induzindo a finalidade do uso, como exemplo: "Meu Site Bet".

🚨⚠️ Atenção Importante ⚠️🚨

É mandatório o fornecimento de um IP válido. O sistema requer essa informação para a geração da credencial, e a ausência do IP impedirá o prosseguimento.

✅ Pronto, credenciais geradas!
O sistema exibirá o Client ID, o Client Secret e os IPs autorizados configurados.

⚠️ Atenção: essas informações não poderão ser consultadas novamente, portanto salve tudo em um local seguro para uso futuro, se necessário.

➡️ Ao retornar à configuração, será possível visualizar a lista de IPs atualmente autorizados a utilizar a credencial.

➡️ Ao clicar, será possível identificar qual IP está em uso pela credencial.

➡️ Ao clicar no ícone circulado (ícone de escudo), será possível editar excluindo ou adicionando mais IP.

🔑Token de acesso🔑

Com as credenciais em mãos, basta seguir a documentação da API de Contas para obter o token de acesso.

Vídeo do tutorial: COMO GERAR AS CREDENCIAIS DA API DE CONTAS