Ce guide propose une architecture d’intégration pour les applications PHP 7.4 et 8.x. L’intégration doit être développée et testée avec votre logiciel et sa version précise.
1. Gardez les identifiants sur le serveur
Demandez l’URL, client_id et client_secret. Obtenez un jeton avec auth_api. La documentation publique ne définit pas l’en-tête du jeton pour les autres opérations : confirmez-le avec l’assistance.
2. Séparez émission et transmission
Utilisez l’événement d’émission de votre application pour enregistrer une tâche liée à la facture. Une file ou un processus cron transmet l’enregistrement sans bloquer l’écran commercial. Utilisez les points d’extension de votre logiciel pour séparer l’intégration de son cœur.
3. Conservez les identifiants
Enregistrez l’id interne, le numéro de facture, queueId et le statut. Une contrainte d’unicité empêche deux tâches pour la même facture. Ne dépendez pas de la mémoire du processus pour éviter les doublons.
4. Vérifiez le résultat
Traitez les consultations et les webhooks authentifiés. Examinez les rejets et les acceptations avec erreurs. Sans réponse à l’envoi, recherchez par référence avant de réessayer.
Exemple d’authentification PHP
L’exemple téléchargeable utilise cURL avec vérification TLS, délais limites et validation JSON. Il lit les variables d’environnement et ne fait de requête qu’une fois exécuté avec votre configuration de test.
PHP · Authentification ↓