Una API, 53+ proveedores, 200+ países

pythondef calculate_provider_score(
    provider: Provider,
    app_config: AppRoutingConfig
) -> float:
    # Tasa de éxito en tiempo real (últimas 24 horas)
    success_weight = 0.35
    success_score = provider.metrics.success_rate_24h

    # Latencia promedio (menor es mejor)
    latency_weight = 0.20
    latency_score = 1.0 - min(provider.metrics.avg_latency_ms / 10000, 1.0)

    # Costo de transacción (menor es mejor)
    cost_weight = 0.25
    cost_score = 1.0 - min(provider.fee_percent / 5.0, 1.0)

    # Prioridad del comerciante (configurada en el panel)
    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
    )

Solicitud: Pagar 5.000 XOF vía Orange Money en CI
  |
  +-> Puntuación: Hub2 (0,92) -- PRINCIPAL
  +-> Puntuación: PaiementPro (0,87) -- FAILOVER 1
  +-> Puntuación: PawaPay (0,81) -- FAILOVER 2
  |
  Hub2 procesa exitosamente -> listo
  Hub2 falla (503) -> reintentar PaiementPro -> éxito

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'  // o 'test'
});

// 1. Crear un pago
const payment = await zf.payments.create({
  amount: 25_00,          // $25,00 en centavos
  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. Verificar estado del pago
const status = await zf.payments.get(payment.id);
console.log(status.status);
// -> 'pending' | 'completed' | 'failed' | 'expired'

// 3. Emitir un reembolso
const refund = await zf.refunds.create({
  paymentId: payment.id,
  amount: 25_00,  // reembolso total
  reason: 'Customer requested cancellation'
});

pythonfrom zerofee import ZeroFee

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

# Crear un pago Orange Money en Costa de Marfil
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}")
# El cliente recibe USSD push en su teléfono

# Listar pagos recientes con filtros
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':
        // Cumplir el pedido
        fulfillOrder(event.data.metadata.orderId);
        break;

      case 'payment.failed':
        // Notificar al cliente
        notifyPaymentFailed(event.data.customer.email);
        break;

      case 'refund.completed':
        // Actualizar estado del pedido
        markOrderRefunded(event.data.paymentId);
        break;
    }

    res.status(200).json({ received: true });
  } catch (err) {
    console.error('Webhook verification failed:', err);
    res.status(400).json({ error: 'Invalid signature' });
  }
});

bash# 1. Instalar el SDK
npm install zerofee

# 2. Obtener tu clave de API en dashboard.0fee.dev

# 3. Comenzar a aceptar pagos

typescriptimport { ZeroFee } from 'zerofee';

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

// Aceptar un pago desde cualquier lugar del mundo
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}`);