Documentation API — KryptaPay

Introduction

L'API KryptaPay est une API REST qui permet aux entreprises d'intégrer des fonctionnalités de paiement Africa-ready directement dans leurs systèmes. Tous les échanges sont en JSON, toutes les requêtes doivent être faites en HTTPS.

🔗 URL de base : https://api.kryptapay.com/v1

Authentification par clé API Bearer token
Format JSON pour toutes les requêtes et réponses
Codes de statut HTTP standards
Toutes les devises utilisent ISO 4217 (XOF, XAF, EUR, USD, NGN…)

Authentification

Toutes les requêtes doivent inclure votre clé API dans le header Authorization. Vos clés sont accessibles depuis votre dashboard.

Exemple de requête authentifiée

curl -X GET https://api.kryptapay.com/v1/balances \
  -H "Authorization: Bearer kp_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json"

✅ Utilisez les clés kp_test_ pour les tests et kp_live_ en production.

Payouts B2B

Envoyez des fonds vers un compte Mobile Money, un IBAN ou un wallet stablecoin en moins de 30 secondes.

Créer un payout

POST/v1/payouts

Corps de la requête

{
  "amount": 50000,
  "currency": "XOF",
  "destination_type": "mobile_money",
  "destination": {
    "operator": "orange_money",
    "phone": "+22507XXXXXXXX",
    "country": "CI"
  },
  "reference": "FACTURE-2025-001",
  "description": "Règlement fournisseur Abidjan"
}

Réponse

{
  "id": "pay_01HXG...",
  "status": "processing",
  "amount": 50000,
  "currency": "XOF",
  "created_at": "2025-05-25T14:32:00Z"
}

Mobile Money

Opérateurs supportés : MTN MoMo, Orange Money, Wave, Moov Africa, Free Money, M-Pesa. KryptaPay gère automatiquement le routage selon le pays et le numéro.

GET/v1/mobile-money/operators?country=SN

POST/v1/mobile-money/collect

Soldes

Consultez vos soldes en temps réel pour toutes les devises activées sur votre compte.

GET/v1/balances

Réponse exemple

{
  "balances": [
    { "currency": "XOF", "amount": 2450000 },
    { "currency": "EUR", "amount": 3720.50 },
    { "currency": "USDT", "amount": 1250.00 }
  ]
}

Webhooks

Configurez une URL webhook pour être notifié en temps réel des événements de paiement (succès, échec, remboursement).

Événements disponibles

payout.completed     # Payout réussi
payout.failed        # Payout échoué
collection.received  # Collecte reçue
balance.low          # Solde faible (seuil configurable)
kyb.approved         # Dossier KYB validé

📧 Pour obtenir vos clés API, contactez notre équipe commerciale ou ouvrez un compte sur la plateforme.