Documentation API SEWIPAY

Bienvenue dans la documentation de l'API SEWIPAY. Notre API vous permet d'intégrer facilement les services de paiement mobile dans votre application.

Base URL

https://api.sewipay.com/v1

Format des Requêtes

L'API accepte les requêtes au format JSON. Assurez-vous d'inclure l'en-tête Content-Type: application/json dans vos requêtes.

Authentication

SEWIPAY utilise des clés API pour authentifier les requêtes. Vous pouvez obtenir vos clés API depuis votre tableau de bord.

En-têtes d'authentification

Authorization: Bearer YOUR_API_KEY

Important

Ne partagez jamais vos clés API. Gardez-les en sécurité et utilisez des variables d'environnement pour les stocker.

Transfers

L'API de transfert vous permet d'initier des transferts d'argent vers des comptes mobiles.

Initier un transfert

POST /transfers

{
    "amount": 50000,
    "currency": "XOF",
    "recipient": "221xxxxxxxxx",
    "description": "Paiement pour services"
}

Paramètres

Paramètre Type Description
amount integer Montant en centimes
currency string Code de la devise (XOF)
recipient string Numéro de téléphone du destinataire
description string Description du transfert

Webhooks

Les webhooks vous permettent de recevoir des notifications en temps réel sur les événements de votre compte.

Configuration des Webhooks

Configurez l'URL de votre webhook dans votre tableau de bord. Nous enverrons des notifications POST à cette URL pour les événements suivants :

  • transfer.success
  • transfer.failed
  • transfer.pending

Codes d'erreur

L'API utilise des codes d'erreur standard HTTP. Voici les codes les plus courants :

Code Description
400 Requête invalide
401 Non authentifié
403 Non autorisé
404 Ressource non trouvée
429 Trop de requêtes
500 Erreur serveur