Intégration ERP

Votre ERP reste le patron. Pivoa exécute.

Poussez clients, factures et ordres de paiement depuis Odoo, Sage, SAP, Dynamics ou votre API maison. Pivoa les fait payer par PI-SPI, rapproche, et vous renvoie chaque événement. Le tableau de bord reste utilisable à côté, pour ce que l’ERP ne fait pas.

API REST

Clé d’API par système, JSON, erreurs RFC 7807, documentation OpenAPI, sandbox ouverte.

Webhooks sortants

Chaque demande payée, chaque paiement exécuté : signé HMAC, réessayé automatiquement, journalisé.

Fichiers

Import CSV des ordres, puis pain.001 ; retours de rapprochement en CSV.

Connecteur Odoo 17

Module natif : factures clients, paiements fournisseurs, retours de rapprochement.

L’API en une requête

Demander un paiement depuis votre système.

Votre logiciel — gestion locative, ERP, site marchand — reçoit une clé d’API (pk_…) créée en un clic dans votre espace. Avec elle, il crée une demande de paiement PI par référence ; Pivoa parle à la banque, suit le dénouement et vous prévient.

  • Idempotent sur votre référence : un loyer, une facture = une demande, quel que soit le nombre d’appels
  • La clé ne donne jamais accès à vos identifiants bancaires ni à l’administration de l’espace ; révocable à tout moment
  • Même contrat pour les factures poussées par l’ERP (POST /api/factures) : numéro, PDF, QR et lien de paiement en retour

Documentation OpenAPI →

# Un loyer à encaisser, poussé par votre logiciel (sandbox) POST https://pyvoa.com/api/connecteur/demandes Authorization: Bearer pk_test_… Content-Type: application/json { "reference": "LOYER-2026-09-A12", "montant": 250000, "payeurAlias": "b9123840-23fb-…", "motif": "Loyer septembre — appt A12", "dateLimitePaiement": "2026-09-20" } # → 200 { "id": "…", "statut": "EN_ATTENTE", "txId": "…", "end2endId": "…" } # puis GET /api/connecteur/demandes/LOYER-2026-09-A12 → "statut": "PAYEE"
Ce qui revient vers vous

Un webhook par dénouement, signé, rejoué.

Demande payée, rejetée ou expirée, paiement sortant effectué ou rejeté : Pivoa appelle l’URL de votre choix avec un corps JSON signé (HMAC-SHA256, horodaté). Si votre serveur ne répond pas, la livraison est réessayée dix fois, de 30 secondes à 30 minutes.

  • Journal des livraisons (statut, code HTTP, tentatives) dans votre espace, onglet Intégrations
  • Secret propre à chaque webhook, affiché une seule fois à la création
  • Filet de sécurité : GET /api/connecteur/demandes?statut=PAYEE&depuis=… pour votre rapprochement
# Exemple de livraison POST https://votre-logiciel.ci/webhooks/pivoa X-Pivoa-Event: DEMANDE_PAYEE X-Pivoa-Signature: t=1788979036,v1=941eff… { "event": "DEMANDE_PAYEE", "reference": "LOYER-2026-09-A12", "montant": 250000, "payeurAlias": "b9123840-23fb-…", "txId": "…", "end2endId": "ESNB001…", "date": "2026-09-09T18:37:16Z" } # v1 = HMAC-SHA256(secret, t + "." + corps)
Connecteur Odoo 17

Pour Odoo, un module et rien à coder.

Le module Pivoa pour Odoo 17 synchronise les factures clients (avec QR et lien de paiement sur le PDF Odoo), envoie les paiements fournisseurs validés et enregistre les rapprochements dans Odoo. Disponible avec le plan Corporate ; les autres ERP passent par l’API ou les fichiers.

Ce qui part d’Odoo

Clients, factures validées, ordres de paiement fournisseurs et paie (montants nets).

Ce qui revient dans Odoo

Paiements reçus lettrés, statut d’exécution des virements, références PI-SPI.

Ce qui reste dans Pivoa

Le circuit de validation, les seuils et plafonds, la page de paiement, le journal PI-SPI, la file « À traiter ».

Feuille de route : webhooks sortants et import CSV avec le socle ; pain.001 et module Odoo 17 dans les phases suivantes. Nous publions les dates dans votre espace, pas ici.

Pour l’intégrateur

Ce dont vous avez besoin pour commencer demain.

Une sandbox

Demandez un accès en cochant « essayer tout de suite » : faux PI-SPI intégré, aucun identifiant bancaire, jeu de données de démonstration.

La documentation

OpenAPI servie par l’API elle-même (/docs), types TypeScript du contrat, exemples de webhooks.

Un interlocuteur

Proxyma intègre PI-SPI pour des banques et des entreprises depuis le lancement du système : vous parlez à des gens qui ont déjà fait l’homologation.

Une sandbox pour votre équipe technique ?

Ouvrez-le en trois minutes et testez l’API, les webhooks et la page de paiement avec de faux paiements.

Ouvrir une sandbox →
Demander un accès Parler à quelqu’un