Aller au contenu principal
Nouveau L'API d'émission de cartes v3 est disponible — créez des programmes de cartes en quelques minutes. Voir la documentation →
Développeurs
Connexion Commencer
API de collecte

API de collecte

Acceptez les paiements mobile money et bancaires par programmation à travers l'Afrique. Une seule API pour collecter auprès de vos clients dans plus de 30 pays.

Obtenir les clés API Voir la page Business

4.5/5 from 47,942 reviews

Collecter via Mobile Money

Initiez une collecte mobile money. Le client reçoit une invite USSD push pour confirmer le paiement.

POST /v1/collections
bash 
curl -X POST https://api.fyatu.com/v1/collections \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 5000,
    "currency": "CDF",
    "method": "mobile_money",
    "provider": "mpesa",
    "phone": "+243812345678",
    "reference": "order_12345"
  }'

Collecter via virement bancaire

Générez un compte bancaire virtuel pour que le client envoie un virement. Les fonds sont réconciliés automatiquement.

POST /v1/collections
bash 
curl -X POST https://api.fyatu.com/v1/collections \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 25000,
    "currency": "NGN",
    "method": "bank_transfer",
    "reference": "inv_98765"
  }'

Notification webhook

Recevez des notifications en temps réel lorsqu'une collecte réussit, échoue ou expire.

Événement webhook : collection.successful
json 
// Webhook payload for successful collection
{
  "event": "collection.successful",
  "data": {
    "id": "col_abc123",
    "amount": 5000,
    "currency": "CDF",
    "status": "successful",
    "reference": "order_12345"
  }
}

Points de terminaison API

POST /v1/collections
GET /v1/collections
GET /v1/collections/:id
POST /v1/collections/:id/cancel
POST /v1/collections/:id/refund
GET /v1/collections/methods
POST /v1/payment-links

Capacités de l'API

Outils complets pour accepter les paiements à travers l'Afrique.

Intégration Mobile Money

Acceptez les paiements M-Pesa, Airtel Money, Orange Money et MTN MoMo avec une seule API. Support USSD push et QR code inclus.

Collecte par virement bancaire

Générez des comptes bancaires virtuels pour chaque client ou transaction. Recevez des virements avec réconciliation automatique.

Liens de paiement

Générez des liens de paiement partageables et des pages de paiement hébergées. Aucune intégration frontend nécessaire pour commencer à collecter.

Support multi-devises

Collectez des paiements dans plus de 25 devises africaines. Conversion automatique et règlement dans votre devise préférée.

Requêtes idempotentes

Chaque demande de collecte supporte les clés d'idempotence pour éviter les doubles prélèvements. Réessayez en toute sécurité sans risque de double facturation.

Webhooks en temps réel

Soyez notifié instantanément quand les paiements réussissent, échouent ou expirent. Les webhooks incluent les détails complets pour une réconciliation facile.

Des questions ?

Questions fréquentes sur l'API Collection.

Nous supportons tous les principaux fournisseurs de mobile money en Afrique, dont M-Pesa (Kenya, RDC, Tanzanie), Airtel Money, Orange Money, MTN MoMo, Tigo Pesa, et plus encore. Les fournisseurs disponibles dépendent du pays.
Chaque requête webhook inclut une signature dans l'en-tête X-Fyatu-Signature. Vérifiez cette signature avec votre clé secrète webhook pour vous assurer que la requête est authentique et n'a pas été altérée.
Oui. Vous pouvez utiliser notre API de liens de paiement pour générer des URLs partageables qui redirigent les clients vers une page de paiement hébergée. Idéal pour les factures, les dons et les configurations e-commerce simples.
Les paiements mobile money ont un délai d'expiration configurable (5 minutes par défaut). Si le client ne confirme pas l'invite USSD à temps, la collecte est marquée comme expirée et vous recevez une notification webhook. Aucun prélèvement n'est effectué.
L'API de collecte supporte la correspondance de montant exact par défaut. Pour les cas nécessitant des paiements partiels (comme les plans de versements), vous pouvez activer le mode de paiement partiel par collecte.

Commencez à collecter des paiements dès aujourd'hui

Intégrez l'API de collecte et acceptez votre premier paiement en quelques minutes. Accès sandbox gratuit inclus.

Obtenir les clés API Lire la documentation complète