Este guia propõe uma arquitetura de integração para aplicações PHP 7.4 e 8.x. A integração deve ser implementada e testada com o seu software e a respetiva versão.
1. Guarde as credenciais no servidor
Solicite o URL, client_id e client_secret. Obtenha um token com auth_api. A documentação pública não define o cabeçalho do token nas operações seguintes: confirme-o com o suporte.
2. Separe emissão e transmissão
Use o evento de emissão da sua aplicação para guardar uma tarefa associada à fatura. Um processo de fila ou cron envia o registo, evitando bloquear o ecrã comercial. Utilize os pontos de extensão do seu software para manter a integração separada do núcleo.
3. Guarde os identificadores
Guarde o id interno, o número da fatura, queueId e estado. Use uma restrição única para impedir tarefas duplicadas. Não dependa da memória do processo para eliminar duplicações.
4. Verifique o resultado
Processe consultas e webhooks autenticados. Reveja rejeições e aceitações com erros. Se não receber resposta ao envio, consulte pela referência antes de repetir.
Exemplo de autenticação PHP
O exemplo descarregável utiliza cURL com verificação TLS, limites de tempo e validação JSON. Lê variáveis de ambiente e só faz pedidos quando executado com a configuração de testes.
PHP · Autenticação ↓