Développeurs

Une API faite pour les ingénieurs.

REST conforme JSON:API, idempotency-keys, webhooks signés HMAC-SHA256, OpenAPI 3.1, sandbox illimité. Une intégration. Tous les rails de paiement.

Lire la documentationObtenir une clé API
Démarrage rapide

Votre premier payout en 5 minutes.

Inscrivez-vous, récupérez votre clé API sandbox, et envoyez votre première requête. Aucune carte bancaire requise pour tester. Passez en production après votre KYB.

  • Sandbox illimitée, données isolées par compte
  • Idempotency-Key pour rejouer toute requête sans risque
  • Webhooks signés et retries automatiques (jusqu’à 24h)
  • Bibliothèques officielles : Node, Python, PHP, Go en preview
Node.jsPythoncURL
// Envoyer un payout Mobile Money en moins de 30 s
import KryptaPay from 'kryptapay';

const kp = new KryptaPay({
  apiKey: process.env.KRYPTAPAY_KEY,
});

const payout = await kp.payouts.create({
  amount: 2_500_000,
  currency: 'XOF',
  network: 'mtn_momo_bj',
  recipient: { msisdn: '+22997000000' },
  idempotencyKey: 'po_2026_04_15_001',
});

console.log(payout.status);
// → 'pending' | 'completed' | 'failed'
API REST

Endpoints principaux.

Une API cohérente : un endpoint par ressource, pagination cursor, filtres standard, réponses JSON:API.

POST/v1/payoutsCréer un paiement (Mobile Money, banque ou stablecoin)
POST/v1/payouts/bulkPaiement groupé jusqu’à 10 000 bénéficiaires
GET/v1/payouts/{id}Récupérer le statut d’un paiement
POST/v1/payins/checkoutCréer un encaissement (URL de checkout)
GET/v1/walletsLister tous les portefeuilles multi-devises
POST/v1/wallets/{id}/conversionsConvertir d’une devise à une autre au taux temps réel
GET/v1/transactionsLister toutes les transactions (filtres : status, date, devise)
POST/v1/counterpartiesCréer une contrepartie (KYC light pour Mobile Money)
POST/v1/webhooksConfigurer un endpoint webhook signé HMAC-SHA256
GET/v1/fx/ratesTaux de change en direct sur toutes les paires
Webhook reçu
POST https://votre-api.com/webhooks/kryptapay
X-KryptaPay-Signature: t=1707123456,v1=a3b...
X-KryptaPay-Event: payout.completed

{
  "id": "evt_01HE5K...",
  "type": "payout.completed",
  "created": "2026-04-15T14:32:01Z",
  "data": {
    "id": "po_01HE...",
    "amount": 2500000,
    "currency": "XOF",
    "status": "completed",
    "network": "mtn_momo_bj",
    "settled_at": "2026-04-15T14:32:18Z"
  }
}
Webhooks

Notifications signées, retries automatiques.

Recevez des événements en temps réel pour chaque changement d’état. Signatures HMAC-SHA256 vérifiables, retries jusqu’à 24h en cas d’échec, replay disponible depuis le dashboard.

  • Événements : payout.created · payout.completed · payout.failed · payin.received · kyb.approved
  • Vérification : signature HMAC-SHA256 dans l’en-tête X-KryptaPay-Signature
  • Retries : 6 tentatives sur 24h en cas de réponse non-2xx
  • Idempotence : chaque webhook a un ID unique, replay sûr
Bibliothèques officielles

SDKs maintenus par l’équipe.

Typés, testés, mis à jour à chaque release de l’API. Installation en une commande.

Node.js / TypeScript
npm install kryptapay
Types complets, supports Promises et async/await, compatible Edge Runtime.
v2.4.1 · MIT
Python
pip install kryptapay
Compatible 3.9+, type hints, async client disponible.
v2.3.0 · MIT
PHP
composer require kryptapay/sdk
PHP 8.1+, PSR-7/PSR-18, intégrable Laravel et Symfony.
v1.8.2 · MIT
Go (preview)
go get github.com/kryptapay/go-sdk
API client typé, context.Context support, retries built-in.
v0.6.0 · Apache 2.0
OpenAPI 3.1 spec
Spec complète téléchargeable. Générez votre propre client (C#, Java, Ruby…) avec openapi-generator.
openapi.krypta-pay.com →
Postman collection
Collection Postman officielle, scénarios de test pré-remplis, environnements sandbox et production séparés.
Importer la collection →
Questions fréquentes

Pour développeurs.

Comment obtenir mes clés API ?
Inscrivez-vous sur dashboard.krypta-pay.com. Vous recevez immédiatement une clé sandbox avec laquelle vous pouvez tester toutes les fonctionnalités. La clé production est délivrée à la fin du processus KYB (24–48h).
L’API est-elle versionnée ? Comment gérez-vous les breaking changes ?
Oui. Le préfixe /v1/ identifie la version stable courante. Les breaking changes ne sont jamais introduits dans une version existante : nous publions /v2/ avec un préavis de 12 mois et maintenons /v1/ en parallèle.
Comment éviter les doublons en cas de retry réseau ?
Toutes les requêtes POST acceptent l’en-tête Idempotency-Key. Avec la même clé, le résultat de la première requête est rejoué (sans recréer la transaction). Les clés sont valides 24h.
Quels sont les rate limits ?
100 req/s par clé API en production, 30 req/s en sandbox. Les en-têtes X-RateLimit-* sont retournés sur chaque réponse. En cas de dépassement, vous recevez un 429 avec un en-tête Retry-After.
Comment vérifier la signature des webhooks ?
L’en-tête X-KryptaPay-Signature contient le timestamp et un HMAC-SHA256 du body avec votre webhook_secret. Les SDKs officiels exposent une fonction verifyWebhook(payload, header, secret) qui fait la vérification pour vous.
Y a-t-il une sandbox publique sans inscription ?
Non. La sandbox nécessite un compte (gratuit, sans carte bancaire) pour isoler vos données de test des autres développeurs. L’inscription prend 2 minutes.

Construisez avec KryptaPay.

Une heure d’intégration suffit pour votre premier payout en production. Notre équipe technique est joignable directement sur Slack.

Obtenir une clé APIDocumentation complète