MobupayMobupayDocumentation
Chargement de vos clés API…

Documentation API Mobupay

Référence complète de l'API REST vv1.

Intégrer en 3 étapes

1. Créer une clé test

Générez une clé sk_test_… dans l'onglet Développeur.

2. Créer un paiement

Appelez POST /payments/sessions pour générer une URL de paiement.

3. Tester avec une CB

Utilisez une carte de test (ex : 4970 1090 0000 0007) pour simuler un paiement complet.

Authentification

Toutes les requêtes doivent inclure le header Authorization: Bearer <votre_clé>. Deux préfixes existent :

  • sk_test_* : environnement test, aucun paiement réel n'est traité.
  • sk_live_* : environnement production, paiements réels.

Vos clés sont gérables depuis l'onglet Développeur → Clés API.

Erreurs

Les erreurs renvoient un code HTTP standard et un corps JSON :

{
  "code": "VALIDATION_ERROR",
  "message": "Le champ amount est obligatoire",
  "details": { "field": "amount" }
}
  • 400 Mauvaise requête (paramètres invalides).
  • 401 Clé manquante ou invalide.
  • 403 Permission insuffisante.
  • 404 Ressource introuvable.
  • 409 Conflit (idempotence, déjà existant).
  • 422 Validation métier échouée.
  • 429 Trop de requêtes (rate limit).
  • 500 Erreur interne.

Webhooks

Mobupay envoie des notifications HTTP à votre serveur pour les événements majeurs (paiement validé, remboursement, virement, etc.).

La configuration des webhooks sera disponible dans une prochaine version du back-office.

Référence API (30 endpoints)

Sélectionnez un endpoint dans la barre latérale gauche pour consulter sa documentation détaillée et essayer une requête depuis le sandbox intégré.