Une seule API, 53+ fournisseurs, 200+ pays

pythondef calculate_provider_score(
    provider: Provider,
    app_config: AppRoutingConfig
) -> float:
    # Taux de succès en temps réel (dernières 24 heures)
    success_weight = 0.35
    success_score = provider.metrics.success_rate_24h

    # Latence moyenne (plus bas = mieux)
    latency_weight = 0.20
    latency_score = 1.0 - min(provider.metrics.avg_latency_ms / 10000, 1.0)

    # Coût de la transaction (plus bas = mieux)
    cost_weight = 0.25
    cost_score = 1.0 - min(provider.fee_percent / 5.0, 1.0)

    # Priorité du marchand (configurée dans le tableau de bord)
    priority_weight = 0.20
    priority_score = app_config.get_priority(provider.id) / 10.0

    return (
        success_weight * success_score +
        latency_weight * latency_score +
        cost_weight * cost_score +
        priority_weight * priority_score
    )

Requête : Payer 5 000 XOF via Orange Money en CI
  |
  +-> Score : Hub2 (0,92) -- PRINCIPAL
  +-> Score : PaiementPro (0,87) -- BASCULEMENT 1
  +-> Score : PawaPay (0,81) -- BASCULEMENT 2
  |
  Hub2 traite avec succès -> terminé
  Hub2 échoue (503) -> réessai PaiementPro -> succès

bash# Node.js / TypeScript
npm install zerofee

# Python
pip install zerofee

# PHP
composer require zerofee/zerofee-php

# Ruby
gem install zerofee

# Go
go get github.com/zerofee/zerofee-go

# Java
// Maven
<dependency>
  <groupId>dev.zerofee</groupId>
  <artifactId>zerofee-java</artifactId>
  <version>1.0.0</version>
</dependency>

# C#
dotnet add package ZeroFee

typescriptimport { ZeroFee } from 'zerofee';

const zf = new ZeroFee({
  apiKey: process.env.ZEROFEE_API_KEY!,
  environment: 'live'  // ou 'test'
});

// 1. Créer un paiement
const payment = await zf.payments.create({
  amount: 25_00,          // 25,00 $ en centimes
  currency: 'USD',
  country: 'US',
  method: 'PAYIN_CARD',
  customer: {
    email: '[email protected]',
    name: 'John Doe'
  },
  metadata: {
    orderId: 'order_12345',
    productName: 'Pro Plan'
  },
  returnUrl: 'https://yourapp.com/payment/success',
  cancelUrl: 'https://yourapp.com/payment/cancel'
});

console.log(payment.checkoutUrl);
// -> https://checkout.0fee.dev/pay_abc123

// 2. Vérifier le statut du paiement
const status = await zf.payments.get(payment.id);
console.log(status.status);
// -> 'pending' | 'completed' | 'failed' | 'expired'

// 3. Émettre un remboursement
const refund = await zf.refunds.create({
  paymentId: payment.id,
  amount: 25_00,  // remboursement intégral
  reason: 'Le client a demandé l\'annulation'
});

pythonfrom zerofee import ZeroFee

zf = ZeroFee(api_key="zf_live_...")

# Créer un paiement Orange Money en Côte d'Ivoire
payment = zf.payments.create(
    amount=10000,           # 10 000 XOF
    currency="XOF",
    country="CI",
    method="PAYIN_ORANGE_CI",
    customer={"phone": "+2250700112233"},
    metadata={"invoice_id": "INV-2026-001"},
    return_url="https://yourapp.com/callback"
)

print(f"Payment ID: {payment.id}")
print(f"Status: {payment.status}")
# Le client reçoit un USSD push sur son téléphone

# Lister les paiements récents avec filtrage
payments = zf.payments.list(
    country="CI",
    status="completed",
    limit=50,
    offset=0
)

for p in payments.data:
    print(f"{p.id}: {p.amount} {p.currency} - {p.status}")

typescriptimport express from 'express';
import { ZeroFee } from 'zerofee';

const app = express();
const zf = new ZeroFee({ apiKey: process.env.ZEROFEE_API_KEY! });

app.post('/webhooks/zerofee', express.raw({ type: 'application/json' }), (req, res) => {
  const signature = req.headers['x-zerofee-signature'] as string;

  try {
    const event = zf.webhooks.verify(req.body, signature);

    switch (event.type) {
      case 'payment.completed':
        // Traiter la commande
        fulfillOrder(event.data.metadata.orderId);
        break;

      case 'payment.failed':
        // Notifier le client
        notifyPaymentFailed(event.data.customer.email);
        break;

      case 'refund.completed':
        // Mettre à jour le statut de la commande
        markOrderRefunded(event.data.paymentId);
        break;
    }

    res.status(200).json({ received: true });
  } catch (err) {
    console.error('Échec de la vérification du webhook :', err);
    res.status(400).json({ error: 'Signature invalide' });
  }
});

bash# 1. Installer le SDK
npm install zerofee

# 2. Obtenir votre clé API sur dashboard.0fee.dev

# 3. Commencer à accepter des paiements

typescriptimport { ZeroFee } from 'zerofee';

const zf = new ZeroFee({ apiKey: 'zf_test_...' });

// Accepter un paiement de n'importe où dans le monde
const payment = await zf.payments.create({
  amount: 1000,
  currency: 'USD',
  country: 'US',
  method: 'PAYIN_CARD',
  customer: { email: '[email protected]' },
  returnUrl: 'https://localhost:3000/success'
});

console.log(`Checkout: ${payment.checkoutUrl}`);