Démarrage rapide

npm install @kadryza/sdk

yarn add @kadryza/sdk

pnpm add @kadryza/sdk

import Kadryza from '@kadryza/sdk'
 
// Initialiser le client avec votre clé API
const kadryza = new Kadryza({
  apiKey: process.env.KADRYZA_API_KEY
})
 
async function premierPaiement() {
  try {
    const transaction = await kadryza.transactions.initiate({
      reference: 'order_abc123',
      amount: 5000,
      currency: 'XAF',
      operator: 'AIRTEL',
      phone_number: '+23566000000',
      description: 'Paiement commande #ABC123'
    })
 
    console.log('Transaction créée !')
    console.log('ID:', transaction.id)
    console.log('Référence interne:', transaction.internal_ref)
    console.log('Statut:', transaction.status)
    console.log('Expire à:', transaction.expires_at)
  } catch (error) {
    if (error.code === 'VALIDATION_ERROR') {
      console.error('Paramètres invalides:', error.fields)
    } else if (error.code === 'UNAUTHORIZED') {
      console.error('Clé API invalide — vérifiez votre configuration')
    } else {
      console.error('Erreur inattendue:', error.message)
    }
  }
}
 
premierPaiement()

curl -X POST https://api.kadryza.app/v1/transactions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $KADRYZA_API_KEY" \
  -d '{
    "reference": "order_abc123",
    "amount": 5000,
    "currency": "XAF",
    "operator": "AIRTEL",
    "phone_number": "+23566000000",
    "description": "Paiement commande #ABC123"
  }'

POST /v1/transactions HTTP/1.1
Host: api.kadryza.app
Content-Type: application/json
Authorization: Bearer kadryza_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
 
{
  "reference": "order_abc123",
  "amount": 5000,
  "currency": "XAF",
  "operator": "AIRTEL",
  "phone_number": "+23566000000",
  "description": "Paiement commande #ABC123"
}

import Kadryza from '@kadryza/sdk'
import express from 'express'
 
const app = express()
const kadryza = new Kadryza({
  apiKey: process.env.KADRYZA_API_KEY
})
 
// IMPORTANT : utiliser express.raw() pour le webhook
// afin de préserver le body brut pour la vérification de signature
app.post('/webhooks/kadryza', express.raw({ type: 'application/json' }), (req, res) => {
  const signature = req.headers['x-kadryza-signature']
  const payload = req.body.toString()
 
  // Vérifier la signature AVANT tout traitement
  const isValid = kadryza.webhooks.verifySignature({
    payload,
    signature,
    secret: process.env.KADRYZA_WEBHOOK_SECRET
  })
 
  if (!isValid) {
    console.error('Signature webhook invalide — requête rejetée')
    return res.status(401).json({ error: 'Signature invalide' })
  }
 
  // Répondre immédiatement avec 200 pour acquitter la réception
  res.status(200).json({ received: true })
 
  // Traiter l'événement de manière asynchrone
  const event = JSON.parse(payload)
 
  switch (event.event) {
    case 'transaction.success':
      console.log('✅ Paiement réussi:', event.data.reference)
      console.log('   Montant:', event.data.amount, 'XAF')
      // Mettre à jour la commande dans votre base de données
      break
 
    case 'transaction.failed':
      console.log('❌ Paiement échoué:', event.data.reference)
      // Notifier le client et proposer un nouveau paiement
      break
 
    case 'transaction.timeout':
      console.log('⏰ Paiement expiré:', event.data.reference)
      // La transaction a expiré après 5 minutes sans confirmation
      break
 
    default:
      console.log('Événement inconnu:', event.event)
  }
})
 
app.listen(3000, () => {
  console.log('Webhook handler actif sur le port 3000')
})

import express from 'express'
import crypto from 'crypto'
 
const app = express()
 
app.post('/webhooks/kadryza', express.raw({ type: 'application/json' }), (req, res) => {
  const signature = req.headers['x-kadryza-signature']
  const payload = req.body.toString()
 
  // Vérification manuelle de la signature HMAC-SHA256
  const expectedSignature = 'sha256=' + crypto
    .createHmac('sha256', process.env.KADRYZA_WEBHOOK_SECRET)
    .update(payload)
    .digest('hex')
 
  // IMPORTANT : utiliser timingSafeEqual pour éviter les timing attacks
  let isValid = false
  try {
    isValid = crypto.timingSafeEqual(
      Buffer.from(signature),
      Buffer.from(expectedSignature)
    )
  } catch {
    // Les buffers ont des longueurs différentes → signature invalide
    isValid = false
  }
 
  if (!isValid) {
    console.error('Signature webhook invalide')
    return res.status(401).json({ error: 'Signature invalide' })
  }
 
  // Acquitter immédiatement
  res.status(200).json({ received: true })
 
  // Traiter l'événement
  const event = JSON.parse(payload)
  console.log('Événement reçu:', event.event, '—', event.data.reference)
})
 
app.listen(3000)