API prête à l'intégration
REST v1, OpenAPI 3.1, authentification Bearer, webhooks signés HMAC-SHA256, attestations KYC Ed25519 vérifiables offline. Sandbox en libre-service depuis votre dashboard SGI.
https://api.getinopay.com · Sandbox indistinguable avec clés inopay_test_*De zéro à production en quelques heures
Parcours type d'une SGI qui intègre Inopay dans son système d'information.
Créer votre clé
Dans Dashboard SGI → Intégration, générez une clé sandbox. Choisissez le label et les permissions (read / write / admin).
Appeler l'API
Header Authorization: Bearer inopay_test_…. Commencez par GET /v1/sgi/portfolio/connections pour voir les investisseurs consentants.
Recevoir les webhooks
Configurez votre URL HTTPS + vérifiez la signature X-Inopay-Signature avec votre secret HMAC. Testez avec le bouton « Envoyer un ping » du dashboard.
Passer en production
Signez l'accord pilote, nous activons vos clés inopay_live_*. Même API, même latence, mêmes SLA — uniquement l'environnement change.
Trois surfaces, une seule API
Préfixe base : https://api.getinopay.com. Tous les endpoints SGI utilisent Authorization: Bearer inopay_….
KYC unifié
Ordres & portefeuilles
Données publiques
Votre premier appel en 30 secondes
# 1. Lister les investisseurs consentants pour votre SGI curl "https://api.getinopay.com/v1/sgi/portfolio/connections" \ -H "Authorization: Bearer inopay_test_abc123..." # 2. Créer une session KYC hébergée pour un investisseur curl -X POST "https://api.getinopay.com/v1/kyc/sessions" \ -H "Authorization: Bearer inopay_test_abc123..." \ -H "Content-Type: application/json" \ -d '{ "email": "amadou@example.com", "full_name": "Amadou Diallo", "phone": "+33612345678", "requested_level": "KYC2" }' # 3. Confirmer l'exécution d'un ordre routé vers votre SGI curl -X PATCH "https://api.getinopay.com/v1/sgi/portfolio/orders/ORDER_ID/execute" \ -H "Authorization: Bearer inopay_test_abc123..." \ -H "Content-Type: application/json" \ -d '{ "execution_ref": "EXEC-20260423-001", "executed_at": "2026-04-23T10:30:00Z", "gross_amount_fcfa": 1500000 }'
Événements poussés vers votre SGI
Inopay POST vers votre webhook_url. Signature HMAC-SHA256 dans X-Inopay-Signature. Retry backoff 30 s → 2 min → 10 min → 1 h → 6 h, 6 tentatives max.
consent.granted
Il vous autorise à voir son KYC et lui router des ordres. connection_id, user_id, consent_expires_at.
consent.revoked
L'investisseur vous a retiré. Stoppez les sync et rapports. connection_id, user_id, reason.
kyc.validated
Attestation signée Ed25519 disponible. profile_id, level, valid_until.
attestation.revoked
Le KYC n'est plus valide (fraude, expiration, demande user). profile_id, attestation_id, reason.
order.routed
Un de vos clients a passé un ordre via Inopay — à exécuter sur BRVM/BVMAC/GSE. order_id, user_id, instrument_isin, quantity, direction, gross_amount_fcfa.
payment.confirmed
L'argent est arrivé sur votre compte marchand — l'ordre passe en pending_routing. order_id, payment_ref, amount_fcfa.
order.executed
Déclenchée quand vous appelez PATCH /orders/:id/execute. Calcule la commission pilote ou standard. execution_ref, commission_fcfa.
test.ping
Envoi à la demande pour vérifier votre receveur. Payload {test:true, message, requested_at}.
Ce qui ne bouge jamais
OpenAPI 3.1 versionné
La spec /v1/ est gelée. Breaking changes → v2 avec 180 jours de préavis.
Webhooks HMAC-SHA256
Chaque événement signé avec votre secret. Header X-Inopay-Signature: sha256=… vérifiable en 3 lignes.
Ed25519 offline
Attestations KYC signées avec une clé Ed25519 publiée à /.well-known/inopay-kyc-pubkey.pem. Vérif sans appel réseau.
Idempotence
Header Idempotency-Key sur les mutations. Rejouer renvoie la première réponse.
Rate limiting
1 000 req/min par clé. Headers X-RateLimit-Remaining en temps réel.
Sandbox indistinguable
Mêmes endpoints, mêmes latences. Migration prod = changement de clé uniquement.
Tout ce dont vous avez besoin
OpenAPI 3.1
Spec machine-readable complète.
Spec KYC v1
Niveaux, cycle de vie, conformité.
Kit onboarding
Roadmap 45 jours de go-live SGI.
Clé publique Ed25519
Pour vérifier les attestations offline.
Status & uptime
État en temps réel de l'API et des webhooks.
Sandbox investor
Simuler un parcours de bout en bout.
Support dev
developers@getinopay.com · réponse sous 1 j.
Partenariat SGI
partenaires@getinopay.com.
Prêt à intégrer Inopay ?
Clés sandbox self-service depuis votre dashboard SGI. La production s'active après signature de l'accord pilote.