Adresse de base : https://integralpay.tech/api/v1. Sauf mention contraire, chaque requête porte l'en-tête X-Api-Key. La référence interactive complète (champs, exemples, essais) est sur Swagger et Redoc, après connexion à votre espace.
Liens de paiement
| Méthode | Chemin | Description |
|---|
POST | /pay-links/ | Crée un lien (détails) |
GET | /pay-links/ | Liste vos liens |
GET | /pay-links/{id}/ | Détail d'un lien |
Paiement direct
| Méthode | Chemin | Description |
|---|
POST | /direct-payments/ | Déclenche un paiement ; en-tête Idempotency-Key recommandé (détails) |
POST | /direct-payments/sank-otp/ | Envoie le code de confirmation Sank Money au client par SMS |
GET | /direct-payments/{id}/ | Statut d'un paiement direct, mis à jour auprès de l'opérateur |
Paiements
| Méthode | Chemin | Description |
|---|
GET | /payments/ | Liste filtrable : status, reference, created_after, created_before (AAAA-MM-JJ) |
GET | /payments/{id}/ | Détail d'un paiement |
GET | /payment-events/ | Historique des changements de statut |
GET | /payment-events/{id}/ | Détail d'un changement de statut |
Une clé de test ne voit que les paiements de test, une clé de production que les paiements réels. Un paiement fait par un lien porte payment_link_id, link_title et link_metadata (mêmes noms que dans les webhooks) ; ces champs valent null pour un paiement direct.
Webhooks
| Méthode | Chemin | Description |
|---|
POST | /webhooks/ | Déclare une adresse de réception ; le secret est renvoyé une seule fois (détails) |
GET | /webhooks/ | Liste vos adresses (secret masqué) |
GET | /webhooks/{id}/ | Détail d'une adresse |
PATCH | /webhooks/{id}/ | Modifie url, event_types ou is_active |
POST | /webhooks/{id}/test/ | Envoie un webhook de test |
POST | /webhooks/{id}/rotate-secret/ | Renouvelle le secret ; connexion à l'espace obligatoire, refusé avec une clé API |
Points d'accès publics (sans clé API)
| Méthode | Adresse | Description |
|---|
GET | https://integralpay.tech/pay/{token}/ | Page de paiement d'un lien |
GET | https://integralpay.tech/pay/verify/?token=… | Vérification d'un paiement sans serveur (détails) |
GET | https://integralpay.tech/static/js/integralpay-button.js | Script du bouton de paiement |
Moyens de paiement
Code (provider) | Opérateur | Code OTP |
|---|
orange_bf | Orange Money Burkina Faso | Oui, généré par le client |
moov_bf | Moov Money Burkina Faso | Non : confirmation sur le téléphone |
sank_money_bf | Sank Money Burkina Faso | Oui, reçu par SMS (envoi) |
Seuls les moyens de paiement actifs pour votre projet sont acceptés ; ils sont listés dans les paramètres de votre projet.