Intégration PayDunya

PayDunya est un agrégateur majeur en Afrique de l'Ouest (Sénégal, Côte d'Ivoire, Bénin, Togo, Mali) supportant le Mobile Money (Wave, Orange Money, Free Money, MTN MoMo) et les Cartes bancaires (Visa, Mastercard).

🔑 1. Configuration des clés API

Pour utiliser PayDunya via Ashgateway, vous devez renseigner vos clés API PayDunya dans votre espace marchand ou via l'API Tenant Config :

Master Key : Clé principale du compte marchands
Private Key : Clé privée de signature
Token : Token d'accès API
Public Key (Optionnel) : Utilisé pour les paiements Checkout / PERMIT
Environment : sandbox pour les tests, live pour la production

Toutes les clés sont chiffrées en base de données avec l'algorithme AES-256 d'Ashgateway.

💳 2. Créer une facture de paiement

Pour initier un encaissement PayDunya Checkout via le proxy Ashgateway, envoyez une requête HTTP POST vers /paydunya/checkout :

http

POST /paydunya/checkout HTTP/1.1
Host: api.ashgateway.com
Content-Type: application/json
Authorization: Bearer <votre_jwt_ashgateway>
x-tenant-id: <votre_tenant_id>

{
  "amount": 5000,
  "description": "Abonnement mensuel Service X",
  "cancelUrl": "https://mon-site.com/cancel",
  "returnUrl": "https://mon-site.com/success",
  "customer": {
    "name": "Kofi Mensah",
    "email": "kofi@example.com",
    "phone": "+221770000000"
  },
  "customData": {
    "order_id": "CMD-2026-9842"
  }
}

Exemple de réponse :

json

{
  "response_code": "00",
  "response_text": "https://app.paydunya.com/sandbox-checkout/invoice/xyz123...",
  "token": "xyz123abc456"
}

🔔 3. Webhooks & Notification IPN

PayDunya envoie les notifications instantanées de paiement à l'URL suivante : https://api.ashgateway.com/paydunya/webhook

Lorsqu'un paiement est validé (completed), Ashgateway enregistre automatiquement la transaction et propage l'événement vers vos Webhooks configurés.

🔄 4. Abonnements (PayDunya PERMIT)

L'API PERMIT permet d'enregistrer une autorisation de prélèvement pour ré-imputer automatiquement le compte Mobile Money ou la carte de vos clients à chaque renouvellement d'abonnement SaaS sans re-saisie.

Intégration PayDunya ​

🔑 1. Configuration des clés API ​

💳 2. Créer une facture de paiement ​

Exemple de réponse : ​