@tvip2/sdk — Beta Fermee

BREVET EN COURS DE DEPOT — PATENT PENDING

Ce SDK est distribue en beta fermee. L'acces necessite une invitation et une cle API valide fournie par Missylia Systems.

SDK officiel JavaScript/Node.js pour le protocole TVIP (Transaction-to-Verified-Invoice Protocol).

Correle les autorisations de paiement avec les factures marchands detaillees en temps reel.

Acces Beta

Ce SDK n'est pas disponible publiquement. Pour demander l'acces :

• Email : [email protected]
• Sujet : "Demande acces SDK TVIP Beta"

Installation (participants beta uniquement)

npm install @tvip2/sdk

Quick Start

const { TVIP } = require('@tvip2/sdk');

// Cle API fournie par VELA Protocol
const tvip = new TVIP({ apiKey: 'sk_beta_votre_cle' });

// 1. Creer une session de correlation
const session = await tvip.createSession({
  amount: 12450,     // centimes
  currency: 'EUR',
  merchant_order_id: 'ord_1001'
});

// 2. Envoyer la facture depuis le POS
await tvip.sendInvoice({
  correlation_token: session.correlation_token,
  invoice_id: 'inv_1001',
  items: [
    { name: 'Tomates bio', quantity: 4, unit_price: 2500, tax_rate: 0.055 },
    { name: 'Pain complet', quantity: 1, unit_price: 2450, tax_rate: 0.055 },
  ],
  total: 12450,
  currency: 'EUR'
});

// 3. TVIP cree automatiquement un evenement verifie :
//    -> Signe SHA-256
//    -> Ecritures comptables (PCG)
//    -> Rapprochement bancaire
//    -> Categorisation IA

AI Vision Scanner

const fs = require('fs');
const image = fs.readFileSync('./ticket.jpg', 'base64');

const parsed = await tvip.scanImage(image);
// Retourne : {merchant, items, total, tax, ...}

Verification Webhook

const { TVIP } = require('@tvip2/sdk');

app.post('/webhooks/tvip', (req, res) => {
  const isValid = TVIP.verifyWebhook(
    JSON.stringify(req.body),
    req.headers['x-tvip-signature'],
    process.env.TVIP_WEBHOOK_SECRET
  );
  if (!isValid) return res.status(401).send('Signature invalide');
  // Traiter l'evenement...
});

API Reference

| Methode | Description | |---------|-------------| | createSession(params) | Creer une session de correlation | | getSession(token) | Obtenir session par token | | sendInvoice(params) | Envoyer facture marchande | | getEvent(id) | Obtenir evenement TVIP | | listEvents(filters?) | Lister evenements avec filtres | | ingest({ source, data }) | Ingerer Factur-X/JSON/XML | | scanImage(base64) | Scanner ticket IA Vision | | TVIP.verifyWebhook(...) | Verifier signature HMAC-SHA256 |

Licence

Licence proprietaire — Missylia Systems Brevet en cours de depot (Patent Pending) Voir fichier LICENSE pour les conditions d'utilisation.

(c) 2026 Missylia Systems. Tous droits reserves.