IBANforge

Micropaiements x402

IBANforge utilise le protocole x402 pour l'authentification et la facturation. Au lieu de cles API et d'abonnements mensuels, vous payez un montant infime en USDC par requete — automatiquement.

Fonctionnement

Imaginez un peage routier : chaque appel API coute une fraction de centime, et le paiement s'effectue directement dans votre requete HTTP.

  1. Votre client envoie une requete API avec un en-tete X-PAYMENT contenant un paiement USDC signe
  2. IBANforge verifie le paiement aupres du facilitateur x402
  3. Si le paiement est valide, la requete est traitee et la reponse est renvoyee
  4. S'il est manquant ou invalide, vous recevez une reponse 402 Payment Required avec les details de tarification

Pas d'inscription. Pas de cle API. Pas de limites de debit. Vous ne payez que ce que vous utilisez.

Tarification

EndpointCout par requete
POST /v1/iban/validate$0.005 USDC
POST /v1/iban/batch$0.002 USDC par IBAN (1 IBAN = $0.002, 100 = $0.20)
GET /v1/bic/:code$0.003 USDC
POST /v1/iban/compliance$0.02 USDC
GET /v1/ch/clearing/:iid$0.003 USDC

Le prix du lot est par IBAN et facture sur la taille de la liste envoyee : un lot d'un seul IBAN coute $0.002, pas le prix d'un lot complet.

La reponse 402

Lorsque vous appelez un endpoint payant sans en-tete de paiement valide, vous recevez :

HTTP/1.1 402 Payment Required

{
  "x402Version": 2,
  "error": "payment_required",
  "resource": {
    "url": "https://api.ibanforge.com/v1/iban/validate",
    "description": "IBAN validation — $0.005 USDC",
    "mimeType": "application/json"
  },
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "amount": "5000",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0x...",
      "maxTimeoutSeconds": 60,
      "extra": { "name": "USD Coin", "version": "2" }
    }
  ]
}

The same requirements travel in the PAYMENT-REQUIRED response header, base64 encoded. Clients that read the header and clients that read the body get the same terms.

Amounts are atomic units: USDC has 6 decimals, so "5000" is $0.005. The network is CAIP-2 — eip155:8453 is Base mainnet.

Older v1 clients still settle. We announce v2, but the paywall accepts a v1 X-PAYMENT signature as readily as a v2 PAYMENT-SIGNATURE one, so an integration written against the v1 shape keeps working.

Cette reponse indique a votre client exactement quoi payer, ou, et sur quel reseau (Base L2).

Clients compatibles

Tout client HTTP implementant le protocole x402 peut payer automatiquement. Le protocole est un standard ouvert — voici quelques options :

SDK x402 (recommande)

Le SDK TypeScript officiel x402 gere le paiement automatiquement :

import { paymentMiddleware } from "x402/client";
 
const client = paymentMiddleware(fetch, {
  walletPrivateKey: process.env.WALLET_PRIVATE_KEY,
});
 
// Les paiements se font automatiquement — utilisez fetch normalement
const response = await client(
  "https://api.ibanforge.com/v1/iban/validate",
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ iban: "CH1000230000000012345" }),
  }
);

Integration manuelle

Si vous preferez gerer les paiements vous-meme, le flux est le suivant :

  1. Envoyez une requete au endpoint de l'API
  2. Si vous recevez une reponse 402, analysez l'objet accepts de la reponse
  3. Creez et signez un transfert USDC sur Base pour le montant specifie
  4. Renvoyez votre requete avec l'en-tete X-PAYMENT contenant le paiement signe

Test gratuit

Vous n'avez pas besoin d'USDC pour essayer l'API. Utilisez le endpoint de demonstration :

curl https://api.ibanforge.com/v1/demo

Cela renvoie des exemples de validation gratuitement, afin que vous puissiez explorer le format de reponse avant de configurer les paiements.

Reseau

Tous les paiements s'effectuent sur Base (L2 de Coinbase), ce qui signifie :

  • Les frais de transaction sont inferieurs a $0.01
  • Le reglement est quasi instantane (2 secondes)
  • USDC est le stablecoin natif — pas de volatilite des prix

FAQ

Dois-je creer un compte ? Non. Le paiement lui-meme constitue votre authentification.

Que se passe-t-il si je n'ai plus d'USDC ? L'API renvoie 402 Payment Required. Vos donnees et resultats existants ne sont pas affectes.

Y a-t-il un solde minimum ? Aucun minimum. Vous avez besoin de suffisamment d'USDC sur Base pour couvrir une requete (aussi peu que $0.003).

Puis-je utiliser ceci depuis un backend sans exposer mon portefeuille ? Oui. Conservez votre cle privee dans les variables d'environnement de votre serveur. Le SDK x402 gere la signature sans diffuser de transactions on-chain pour chaque requete.

En savoir plus