Exemples de Requêtes & Tests — Ash-Wallet

Ce document rassemble des exemples concrets d'appels cURL et de requêtes pour intégrer et tester les fonctionnalités de paiement direct d'AshGateway.

---

1. Initier un Paiement USSD Direct (Exemples par Opérateurs)

A. Paiement MTN Côte d'Ivoire

curl -X POST https://api.ashgateway.com/fedapay/direct-payment \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer VOTRE_JWT_TOKEN" \
  -d '{
    "description": "Abonnement Premium - Décembre 2025",
    "amount": 5000,
    "payment_method": "mtn_ci",
    "phone_number": {
      "number": "+2250701020304",
      "country": "ci"
    },
    "firstname": "Yao",
    "lastname": "Kouassi",
    "email": "[email protected]"
  }'

B. Paiement Moov Bénin

curl -X POST https://api.ashgateway.com/fedapay/direct-payment \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer VOTRE_JWT_TOKEN" \
  -d '{
    "description": "Recharge crédit - 5000 FCFA",
    "amount": 5000,
    "payment_method": "moov",
    "phone_number": {
      "number": "+22997000001",
      "country": "bj"
    },
    "firstname": "Bienvenu",
    "lastname": "Acclombessi",
    "email": "[email protected]",
    "callback_url": "https://votre-app.com/app/webhook/fedapay"
  }'

---

2. Vérification des Transactions

A. Récupérer le statut détaillé

curl -X GET https://api.ashgateway.com/fedapay/transaction/123456/status \
  -H "Authorization: Bearer VOTRE_JWT_TOKEN"

B. Vérifier rapidement si une transaction est approuvée (booléen)

curl -X GET https://api.ashgateway.com/fedapay/transaction/123456/is-approved \
  -H "Authorization: Bearer VOTRE_JWT_TOKEN"

---

3. Réponses de l'API

Success (200 OK)

{
  "ok": true,
  "transactionId": 123456,
  "status": "pending",
  "description": "Abonnement Premium",
  "amount": 5000
}

Erreur de Validation DTO (400 Bad Request)

{
  "statusCode": 400,
  "message": [
    "payment_method must be one of the following values: mtn_open, moov, sbin, moov_tg, togocel, mtn_open_gn, mtn_ci, airtel_ne, free_sn"
  ],
  "error": "Bad Request"
}

---

4. Données de Test pour la Sandbox (FedaPay)

Numéros de Téléphone de Test (Sandbox) :

• MTN Côte d'Ivoire : +2250701020304
• Moov Bénin : +22997000001
• MTN Bénin : +22961000001

Simulation des comportements de transaction (en fonction du montant) :

• Montant inférieur à 1000 FCFA : Approuvé automatiquement en quelques secondes.
• Montant entre 1000 et 5000 FCFA : Reste en attente (nécessite une confirmation manuelle sur la console Sandbox FedaPay).
• Montant supérieur à 5000 FCFA : Simule un rejet ou échec de paiement.