FluxPay SDK - Node.js

SDK officiel FluxPay pour Node.js. Optimisé pour les applications serveur avec support streaming et event emitters.

Installation

npm install @fluxpay/sdk-node
# ou
yarn add @fluxpay/sdk-node
# ou
pnpm add @fluxpay/sdk-node

Utilisation Basique

import FluxPay from '@fluxpay/sdk-node';

// Initialiser le client
const client = new FluxPay({
  apiKey: process.env.FLUXPAY_API_KEY,
  baseURL: 'https://api.fluxpay.com', // Kong Gateway
  timeout: 30000,
  retries: 3,
});

// Créer un paiement
const payment = await client.payments.create({
  amount: 5000,
  currency: 'XOF',
  payment_method: 'mobile_money',
  payment_method_details: {
    provider: 'mtn',
    phone_number: '+2250712345678',
  },
});

console.log('Payment created:', payment);

Fonctionnalités Node.js Spécifiques

Event Emitters pour Webhooks ✅

// Créer un EventEmitter pour gérer les webhooks en temps réel
const emitter = client.webhooks.createEmitter(webhookSecret);

// Écouter un événement spécifique
emitter.onEvent('payment.completed', (data) => {
  console.log('Payment completed:', data);
});

// Écouter tous les événements
emitter.onWebhook((event) => {
  console.log('Webhook event:', event.type, event.data);
});

// Utiliser avec Express
app.post('/webhooks', (req, res) => {
  const signature = req.headers['x-fluxpay-signature'];
  emitter.processWebhook(req.body, signature);
  res.status(200).json({ received: true });
});

Streaming ✅

import { downloadStream } from '@fluxpay/sdk-node';
import { createWriteStream } from 'fs';
import { pipeline } from 'stream/promises';

// Télécharger un fichier volumineux en streaming
const stream = await downloadStream(httpClient, '/api/v1/payments/export?format=csv');
const writeStream = createWriteStream('payments.csv');
await pipeline(stream, writeStream);

Resources Disponibles

Identiques au SDK JavaScript :

• payments - Gestion des paiements
• merchants - Informations marchands
• webhooks - Gestion des webhooks
• wallet - Portefeuille
• ledger - Comptabilité (admin uniquement)

Documentation

Voir docs/PLAN_IMPLEMENTATION_SDK.md pour plus de détails.

Licence

MIT