SDK Node.js

import { IziPayClient } from 'izichangepay-sdk';

const izipay = new IziPayClient({
  apiKey: process.env.IZIPAY_API_KEY!,                  // sk_live_… ou sk_test_…
  // baseUrl: 'https://api.pay.izichange.com',          // optionnel — défaut prod
  //                                                    // sandbox: https://api.sandbox-pay.izichange.com
  // timeout: 30_000,                                    // ms, défaut 30s
  // maxRetries: 3,                                      // 5xx/429 retry attempts
  // fetch: customFetch,                                 // override (tests / non-Node)
});

// Création
const intent = await izipay.paymentIntents.create({
  requestedCurrencyType: 'fiat',
  currencyRequested: 'XOF',
  amountRequested: 25000,
  acceptedCoins: ['USDT.TRC20', 'USDT.BEP20'],
  merchantReference: 'order_42',
  returnUrl: 'https://shop.example/thanks',
});

// Lecture
const fetched = await izipay.paymentIntents.retrieve(intent.id);

// Liste filtrée
const page = await izipay.paymentIntents.list({
  status: 'completed', from: '2026-11-01', limit: 50,
});

// Itérateur async (gère le curseur)
for await (const i of izipay.paymentIntents.iterate({ status: 'completed' })) {
  // ...
}

// Standard (vers adresse blockchain externe)
const payout = await izipay.payouts.create({
  assetCode: 'USDT.TRC20',
  amount: '500.00',
  destinationAddress: 'TXxxx…',
  idempotencyKey: 'monthly-payout-2026-12',
});

// Transfert interne (vers autre marchand IzichangePay)
const internal = await izipay.payouts.createInternal({
  assetCode: 'USDT.TRC20',
  amount: '50.00',
  destinationType: 'internal_email',
  destinationEmail: 'partner@example.com',
});

const invoice = await izipay.invoices.create({
  amount: 50000,
  currency: 'XOF',
  dueDate: '2026-12-31',
  clientEmail: 'client@example.com',
  description: 'Consultation décembre',
});

await izipay.invoices.resend(invoice.id, { dueDate: '2027-01-15' });
await izipay.invoices.cancel(invoice.id);

const product = await izipay.products.create({
  name: 'Formation React',
  amount: 15000,
  currency: 'XOF',
  permanentLinkSlug: 'formation-react',
});

await izipay.products.update(product.id, { isActive: false });

import express from 'express';
import { IziPayClient } from 'izichangepay-sdk';

const app = express();

app.post('/webhooks/izipay', express.raw({ type: 'application/json' }), (req, res) => {
  try {
    const event = IziPayClient.validateWebhook(
      req.body,                                 // Buffer brut, PAS parsé en JSON
      req.headers['x-izipay-signature'] as string,
      process.env.IZIPAY_WEBHOOK_SECRET!,
    );

    switch (event.type) {
      case 'payment_intent.completed': /* ... */ break;
      case 'payout.confirmed':         /* ... */ break;
      case 'settlement.completed':     /* ... */ break;
    }
    res.json({ received: true });
  } catch (err) {
    res.status(400).json({ error: (err as Error).message });
  }
});

await izipay.payouts.create({
  assetCode: 'USDT.TRC20',
  amount: '500',
  destinationAddress: 'TXxxx…',
  idempotencyKey: 'payout-202612-monthly-salary',
});

import {
  IziPayError,                  // base
  IziPayApiError,               // 4xx/5xx
  IziPayAuthError,              // 401/403
  IziPayNotFoundError,          // 404
  IziPayValidationError,        // 422
  IziPayRateLimitError,         // 429 → .retryAfter
  IziPayServerError,            // 5xx
  IziPayNetworkError,           // pas de réponse (timeout, DNS)
  IziPayWebhookError,           // signature invalide
} from 'izichangepay-sdk';

import type {
  PaymentIntent, PaymentIntentCreateParams,
  Payout, PayoutCreateParams,
  Invoice, Product,
  WebhookEvent, WebhookEventType,
} from 'izichangepay-sdk';