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 |