Connexion Partenaire Bancaire
⚠️ Authentification requise pour accéder à la documentation
Headers requis: X-API-Key & X-Bank-ID
Documentation complète pour l'intégration des services de paiement des impôts
Toutes les requêtes à l'API nécessitent les en-têtes suivants :
X-API-Key: votre_cle_api_secrete X-Bank-ID: votre_bank_id Content-Type: application/json
Nouveaux codes d'erreur d'authentification :
Body :
{
"impot_id": 1,
"nombre_declarations": 5
}
Réponse Succès (201) :
{
"status": "success",
"message": "Paiement initialisé avec succès",
"data": {
"reference_paiement": "IMP20241201143012ABC12",
"impot": {
"id": 1,
"nom": "Taxe Professionnelle",
"description": "Taxe annuelle sur les activités professionnelles",
"prix_unitaire": 5000.00,
"periode": "annuel"
},
"details": {
"nombre_declarations": 5,
"montant_total": 25000.00,
"montant_unitaire": 5000.00
},
"repartition": [
{
"beneficiaire_id": 1,
"nom": "Trésor Public",
"telephone": "+243781234567",
"numero_compte": "SN00123456789",
"type_part": "pourcentage",
"valeur_part_originale": 70.00,
"montant": 17500.00
}
],
"callback_url": "https://api.banque.com/webhook?ref=IMP20241201143012ABC12",
"date_expiration": "2024-12-01 15:30:12"
}
}
Codes d'erreur :
Body :
{
"reference_paiement": "IMP20241201143012ABC12",
"methode_paiement": "mobile_money"
}
Réponse Succès (200) :
{
"status": "success",
"message": "Paiement traité avec succès",
"data": {
"paiement_id": 123,
"paiement_bancaire_id": 456,
"reference": "IMP20241201143012ABC12",
"montant": 25000.00,
"nombre_declarations": 5,
"methode_paiement": "mobile_money",
"date_paiement": "2024-12-01 14:35:22"
}
}
Codes d'erreur :
Body :
{
"reference_paiement": "IMP20241201143012ABC12"
}
Réponse Succès (200) :
{
"status": "success",
"message": "Paiement annulé avec succès",
"data": {
"reference": "IMP20241201143012ABC12",
"type": "temporaire"
}
}
Codes d'erreur :