Intégrer l'API ElyonPay en 15 minutes avec JavaScript

npm install elyonpay-js

// CommonJS
const ElyonPay = require('elyonpay-js');

// ESM
import ElyonPay from 'elyonpay-js';

const ElyonPay = require('elyonpay-js');

const client = new ElyonPay({
    apiKey: process.env.ELYONPAY_API_KEY,
    environment: 'sandbox', // 'sandbox' ou 'production'
    timeout: 30000,         // timeout en millisecondes
    retries: 2              // nombre de tentatives en cas d'échec réseau
});

const payment = await client.payments.create({
    amount: 5000,
    currency: 'XOF',
    provider: 'orange_money',
    phone: '+2250701234567',
    description: 'Commande #12345',
    callback_url: 'https://yoursite.com/webhook',
    metadata: {
        order_id: '12345',
        customer_email: 'client@example.com'
    }
});

console.log(payment.id);     // 'pay_xxxxxxxxxxxxxxxx'
console.log(payment.status); // 'pending'

const express = require('express');
const app = express();

app.post('/webhook', express.json(), (req, res) => {
    const signature = req.headers['x-elyonpay-signature'];
    const isValid = client.webhooks.verify(req.body, signature);

    if (!isValid) {
        return res.status(401).json({ error: 'Invalid signature' });
    }

    const event = req.body;

    switch (event.type) {
        case 'payment.completed':
            // Marquer la commande comme payée
            updateOrder(event.data.metadata.order_id, 'paid');
            break;
        case 'payment.failed':
            // Notifier le client de l'échec
            notifyCustomer(event.data.metadata.customer_email, 'failed');
            break;
    }

    res.status(200).json({ received: true });
});

try {
    const payment = await client.payments.create({
        amount: 5000,
        currency: 'XOF',
        provider: 'orange_money',
        phone: '+2250701234567'
    });
} catch (error) {
    if (error.type === 'invalid_request') {
        // Paramètre manquant ou invalide
        console.error('Erreur de validation:', error.message);
    } else if (error.type === 'provider_error') {
        // Erreur côté opérateur Mobile Money
        console.error('Erreur opérateur:', error.provider_code);
    } else if (error.type === 'network_error') {
        // Problème de connectivité
        console.error('Erreur réseau, réessayez plus tard');
    } else if (error.type === 'authentication_error') {
        // Clé API invalide ou expirée
        console.error('Vérifiez votre clé API');
    }
}

const client = new ElyonPay({
    apiKey: process.env.ELYONPAY_PRODUCTION_KEY,
    environment: 'production',
    timeout: 30000,
    retries: 3
});

// Vérifier la connexion
const status = await client.health.check();
console.log('API Status:', status.environment); // 'production'