Authentification

Toutes les requêtes API doivent être authentifiées à l'aide de votre Clé Secrète dans le header de la requête.

Header Authorization

Authorization: Bearer YOUR_SECRET_KEY

Vous pouvez obtenir vos clés API dans votre Tableau de bord AfriPayHub sous la section Paramètres API.

Initialiser un paiement

Pour démarrer une transaction, envoyez une requête POST à l'endpoint /transactions/initialize.

• cURL
• PHP

curl https://api.AfriPayHub.com/v1/transactions/initialize \
  -H "Authorization: Bearer YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 5000,
    "currency": "XOF",
    "email": "customer@email.com",
    "payment_method": "mobile_money"
  }'

<?php
$url = "https://api.AfriPayHub.com/v1/transactions/initialize";
// ... code PHP
?>

Réponse attendue

{
  "status": true,
  "message": "Transaction initialized",
  "data": {
    "authorization_url": "https://checkout.AfriPayHub.com/pay/...",
    "reference": "AFR-782hs92"
  }
}

Webhooks

Les webhooks vous permettent de recevoir des notifications en temps réel lorsque des événements se produisent sur votre compte (paiement réussi, échec, etc.).

Configuration

Définissez votre URL de webhook dans votre tableau de bord. Nous enverrons une requête POST JSON à cette URL.

{
  "event": "charge.success",
  "data": {
    "id": 12345,
    "domain": "test",
    "status": "success",
    "reference": "AFR-782hs92",
    "amount": 5000,
    "customer": {
      "email": "customer@email.com"
    }
  }
}

Codes d'erreur

SDKs & Librairies

Accélérez votre intégration en utilisant nos bibliothèques clientes officielles maintenues par notre équipe.