ParticuliersMarchands DéveloppeursSécurité À proposContact Créer un compte
API REST · Sandbox gratuit

Intégrez MainPay
en quelques lignes

Notre API REST vous permet d'intégrer les paiements africains dans votre application. Documentation complète, SDKs, webhooks signés — tout ce dont vous avez besoin.

Accéder au portail → Voir l'API

Un paiement en
moins de 10 lignes

Créez une session de paiement, redirigez votre utilisateur et recevez une notification webhook lorsque le paiement est confirmé.

  • Authentification par clé Bearer simple
  • Checkout hébergé — zéro UI à coder
  • Webhook signé HMAC-SHA256 à la confirmation
  • Résultat en temps réel via GET /v1/transactions
Créer mon compte sandbox →
POST /v1/checkout
Authorization: Bearer mp_test_xxx

{
  "type": "payment",
  "amount": 50000,
  "currency": "GNF",
  "country": "GN",
  "description": "Commande #123",
  "return_url": "https://votreapp.com/ok",
  "webhook_url": "https://votreapp.com/wh",
  "idempotency_key": "order_123"
}

← 200 OK
{
  "session_id": "sess_xyz",
  "checkout_url": "https://pay.mainpayafrica.com/...",
  "expires_at": "2026-04-22T15:30:00Z"
}

API complète en 11 endpoints

💳

POST /v1/checkout

Créez une session de paiement (payment, deposit, withdrawal). Redirigez l'utilisateur vers la page de paiement hébergée.

🔍

GET /v1/transactions/:id

Consultez le statut d'une transaction — pending, confirmed, completed, expired. Utile pour la réconciliation.

💸

POST /v1/payouts

Versez directement de l'argent dans le wallet d'un utilisateur sans passer par le checkout. Idéal pour les gains créateurs.

📦

POST /v1/payouts/batch

Envoyez jusqu'à 100 versements en une seule requête. Idéal pour les paiements de salaires ou les distributions.

↩️

POST /v1/refunds

Remboursez un paiement checkout complété. Le montant est re-crédité sur le wallet de l'utilisateur final.

🏦

POST /v1/settlement

Virez votre solde escrow vers votre numéro Orange Money ou MTN MoMo. Approbation sous 24–48h.

💰

GET /v1/balance

Consultez votre solde escrow disponible par devise en temps réel.

📊

GET /v1/rates

Récupérez les frais, limites min/max et devises disponibles par pays.

Documentation complète →

Votre langage favori est supporté

📱

Flutter

Widget MainPayButton clé en main

🟨

JavaScript

Node.js / Express / Next.js

🐘

PHP

Laravel / Symfony / WordPress

🐍

Python

FastAPI / Django / Flask

🔵

Go

Standard library, zero dep

Gratuit · Aucune carte requise

Commencez à tester gratuitement

Créez votre compte sandbox en 2 minutes. Testez tous les endpoints sans argent réel, puis passez en production après signature du contrat.