Facturino / Documentation / Super PDP

Connecter Super PDP

Super PDP est une Plateforme Agréée française orientée API-first, immatriculée auprès de la DGFiP sous le n°0040. Authentification par OAuth 2.0 client_credentials, hébergement France.

Immatriculation
PA n°0040
Registre DGFiP
Authentification
OAuth 2.0
client_credentials
Hébergement
France
Données résidentes UE

1. Créer votre compte Super PDP

  1. Rendez-vous sur superpdp.tech/app/users/create et créez votre compte.
  2. Validez votre email puis renseignez votre SIRET pour l'onboarding entreprise.
  3. Dans le tableau de bord, ouvrez API > Credentials et générez une paire client_id / client_secret.

2. Enregistrer les identifiants dans Facturino

La connexion d'une PA se gère depuis l'interface Facturino — les identifiants sensibles ne transitent jamais par l'API publique.

  1. Connectez-vous à Facturino, puis ouvrez Paramètres → Facturation électronique.
  2. Sélectionnez Super PDP dans la liste des PA disponibles.
  3. Renseignez client_id et client_secret, puis cliquez sur Connecter.

Les identifiants sont chiffrés au repos avec AES-256-GCM avant écriture. Facturino ne renvoie jamais le client_secret en clair après enregistrement.

3. Tester la connexion

Depuis le même écran Paramètres → Facturation électronique, cliquez sur Tester la connexion. Facturino interroge Super PDP via le flux OAuth 2.0 et affiche le statut connecté ainsi que la date de dernière vérification. En cas d'échec, le message précise la cause (pa_credentials_invalid, pa_unreachable…).

4. Configurer le webhook entrant

Au moment de la connexion, Facturino génère un secret HMAC unique par entreprise et l'affiche une seule fois. Copiez-le sans tarder puis, dans Super PDP, ouvrez API → Webhooks et créez un endpoint :

  • URL : https://facturino.com/api/v1/webhooks/pa-flow/{companyId}
  • Signing secret : le secret affiché par Facturino
  • Algorithme : HMAC-SHA256, encodage hexadécimal

5. Émettre votre première facture

Créez une facture, finalisez-la puis envoyez-la à la PA :

curl -X POST https://facturino.com/api/v1/invoices/inv_xxx/send \
  -H "Authorization: Bearer fac_test_..."

Suivez le cycle de vie via le webhook ou par polling sur GET /v1/invoices/{id}. Les statuts depositedtransmittedavailable sont synchronisés en temps réel par Super PDP.

Clé de test versus clé live. Toutes les requêtes envoyées avec une clé fac_test_ sont isolées et ne déclenchent aucun dépôt fiscal réel chez Super PDP. Utilisez une clé fac_live_ uniquement lorsque vous êtes prêt à émettre vers la DGFiP.

Ressources