Démarrage rapide

# Exemple avec cURL
curl -X POST "https://www.impactpay.pro/api/v1/session" \
  -H "X-API-Key: votre_api_key" \
  -H "X-API-Secret: votre_api_secret" \
  -H "Content-Type: application/json"

{
  "amount": 5000,
  "currency": "XOF",
  "description": "Commande #1042",
  "payer": {
    "name": "Kouassi Jean",
    "phone": "0700000000"
  },
  "success_url": "https://monsite.com/paiement/succes",
  "failure_url": "https://monsite.com/paiement/echec",
  "notify_url": "https://monsite.com/webhook/paiement",
  "metadata": { "order_id": "1042" },
  "expires_in": 30
}

{
  "success": true,
  "data": {
    "session_id": "aBcDeFgHiJkLmNoPqR12",
    "checkout_url": "https://www.impactpay.pro/pay/aBcDeFgHiJkLmNoPqR12",
    "amount": 5000.0,
    "currency": "XOF",
    "status": "pending",
    "expires_at": "2026-04-16T10:30:00+00:00",
    "created_at": "2026-04-16T10:00:00+00:00"
  }
}

{
  "success": true,
  "data": {
    "session_id": "aBcDeFgHiJkLmNoPqR12",
    "amount": 5000.0,
    "currency": "XOF",
    "description": "Commande #1042",
    "status": "completed",
    "payer_name": "Kouassi Jean",
    "payer_phone": "0700000000",
    "provider": "orange_money",
    "metadata": { "order_id": "1042" },
    "paid_at": "2026-04-16T10:12:00+00:00",
    "created_at": "2026-04-16T10:00:00+00:00"
  }
}

{
  "success": true,
  "data": {
    "transaction_id": "9b1f6c2e-4d3a-4f7e-9a51-2c8e7d0b4f13",
    "session_id": "aBcDeFgHiJkLmNoPqR12",
    "amount": 5000.0,
    "currency": "XOF",
    "status": "completed",
    "provider": "orange_money",
    "provider_ref": "OM-48213377",
    "phone": "0700000000",
    "session_status": "completed",
    "paid_at": "2026-04-16T10:12:00+00:00",
    "created_at": "2026-04-16T10:00:00+00:00",
    "updated_at": "2026-04-16T10:12:00+00:00"
  }
}

{
  "success": false,
  "error": { "code": "TRANSACTION_NOT_FOUND", "message": "Transaction introuvable." }
}

{
  "success": true,
  "data": {
    "balance": 47350.00,
    "currency": "XOF",
    "transactions": {
      "total": 120,
      "completed": 98,
      "pending": 5,
      "failed": 17
    },
    "volume_completed": 490000.00
  }
}

{
  "success": true,
  "data": [
    {
      "session_id": "aBcDeFgHiJkLmNoPqR12",
      "description": "Commande #1042",
      "amount": 5000.0,
      "currency": "XOF",
      "status": "completed",
      "payer_name": "Kouassi Jean",
      "payer_phone": "0700000000",
      "fee_total": 125.0,
      "net_amount": 4875.0,
      "created_at": "2026-04-16T10:00:00+00:00"
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 25,
    "total": 98,
    "last_page": 4
  }
}

{
  "method": "orange_money",
  "phone": "0700000000",
  "amount": 5000,
  "note": "Reversement mensuel"
}

{
  "success": true,
  "data": {
    "withdrawal_id": "uuid-de-la-demande",
    "amount": 5000.00,
    "currency": "XOF",
    "method": "orange_money",
    "phone": "0700000000",
    "status": "pending",
    "note": "Reversement mensuel",
    "created_at": "2026-04-28T10:00:00+00:00"
  }
}

{
  "session_id": "aBcDeFgHiJkLmNoPqR12",
  "method": "orange_money",
  "phone": "0700000000",
  "name": "Kouassi Jean",
  "otp": "123456"
}

{
  "session_id": "aBcDeFgHiJkLmNoPqR12",
  "method": "mtn",
  "phone": "0500000000",
  "name": "Kouassi Jean"
}

{
  "session_id": "aBcDeFgHiJkLmNoPqR12",
  "method": "wave",
  "phone": "0700000000",
  "name": "Kouassi Jean"
}

{
  "success": true,
  "session_id": "aBcDeFgHiJkLmNoPqR12",
  "transaction_id": "9b1f6c2e-4d3a-4f7e-9a51-2c8e7d0b4f13",
  "status": "pending",
  "message": "Confirmez le paiement sur votre téléphone."
}

{
  "success": true,
  "session_id": "aBcDeFgHiJkLmNoPqR12",
  "transaction_id": "9b1f6c2e-4d3a-4f7e-9a51-2c8e7d0b4f13",
  "status": "redirect",
  "redirect_url": "https://pay.wave.com/c/cos-xxx"
}

• OTP : requis uniquement quand le parcours du moyen de paiement est « OTP » dans le pays (aujourd'hui Orange Money en Côte d'Ivoire : le client compose #144*82# pour recevoir son code). Sinon, une erreur OTP_REQUIRED est renvoyée.
• Moyens disponibles : ils sont définis par pays par ImpactPay ; un nouvel opérateur activé est accepté sans changement de votre intégration.
• Wave : redirigez votre client vers redirect_url pour qu'il confirme le paiement.
• Confirmation : le statut final (complété ou échoué) est toujours transmis via le webhook vers votre notify_url.
• Une session ne peut être payée qu'une seule fois. Créez une nouvelle session pour chaque tentative.

{
  "event": "payment.completed",
  "session_id": "aBcDeFgHiJkLmNoPqR12",
  "status": "completed",
  "amount": 5000.0,
  "currency": "XOF",
  "provider": "orange_money",
  "payer_name": "Kouassi Jean",
  "payer_phone": "0700000000",
  "metadata": { "order_id": "1042" },
  "transaction_id": "uuid-de-la-transaction",
  "provider_ref": "ref-provider-001",
  "paid_at": "2026-04-16T10:12:00+00:00"
}

// PHP
$payload   = file_get_contents('php://input');
$signature = hash_hmac('sha256', $payload, $apiSecret);

if (!hash_equals($signature, $_SERVER['HTTP_X_SIGNATURE'] ?? '')) {
    http_response_code(401);
    exit;
}

Votre serveur      Guichet            Client            Provider
      │                  │                  │                  │
      │ POST /session     │                  │                  │
      │─────────────────>│                  │                  │
      │ checkout_url ◄───│                  │                  │
      │                  │                  │                  │
      │  Redirige le client vers checkout_url                  │
      │─────────────────────────────────────>│                  │
      │                  │ Choix méthode    │                  │
      │                  │◄─────────────────│                  │
      │                  │ Lance paiement ──────────────────── >│
      │                  │                  │   Confirmation    │
      │                  │◄─ Webhook interne ──────────────────│
      │                  │                  │                  │
      │◄─ POST notify_url│                  │                  │
      │                  │ Redirige ──────────────────────────>│
      │                  │  success/failure_url                │

Votre serveur      Guichet            Client            Provider
      │                  │                  │                  │
      │ POST /session     │                  │                  │
      │ (+ notify_url)   │                  │                  │
      │─────────────────>│                  │                  │
      │ session_id ◄─────│                  │                  │
      │                  │                  │                  │
      │  Affiche votre propre interface de paiement            │
      │─────────────────────────────────────>│                  │
      │                  │   Saisie téléphone + OTP (si Orange)│
      │◄─────────────────────────────────────│                  │
      │                  │                  │                  │
      │ POST /pay         │                  │                  │
      │ (session_id,      │                  │                  │
      │  method, phone,   │                  │                  │
      │  otp?)           │                  │                  │
      │─────────────────>│                  │                  │
      │                  │ Lance paiement ──────────────────── >│
      │ { status:        │                  │                  │
      │   "pending" } ◄──│                  │   Confirmation    │
      │                  │◄─ Webhook interne ──────────────────│
      │                  │                  │                  │
      │◄─ POST notify_url│                  │                  │
      │                  │                  │                  │
      │  Cas Wave : redirect_url retourné par POST /pay           │
      │─────────────────────────────────────>│                  │
      │                  │                  │ Confirme sur Wave │
      │                  │                  │─────────────────>│
      │                  │◄─ Webhook interne ──────────────────│
      │◄─ POST notify_url│                  │                  │