create-chariow-kit

Démarre un projet de paiement Chariow en une seule commande : checkout, webhook (Pulse) signé et idempotent, UI de packs, prêt à déployer.

Intègre l'encaissement dans ton projet et fais payer tes clients partout — Mobile Money en Afrique (MTN, Moov, Orange, Wave…), cartes bancaires et PayPal à l'international. Les moyens de paiement s'adaptent automatiquement au pays de l'acheteur, via Chariow/Moneroo.

Utilisation

npx github:phileas98/create-chariow-kit mon-app

Puis :

cd mon-app
npm install
npm run dev

La commande génère le projet Next.js complet, crée automatiquement un PULSE_TOKEN unique, écrit le .env, et affiche la checklist des étapes.

Ce que ça inclut

• Checkout — création de session de paiement côté serveur (clé API jamais exposée)
• Webhook signé — vérification HMAC-SHA256 de chaque Pulse Chariow
• Idempotence — un Pulse rejoué ne livre pas deux fois
• UI de packs — exemple crédits SaaS, adaptable à tout autre usage

Ce qui reste manuel (côté compte Chariow)

Il n'existe pas d'API pour automatiser ces étapes :

1. Générer la clé API (dashboard Chariow → API) → .env
2. Créer tes produits, les publier, mettre leurs IDs prd_... dans lib/products.js
3. Créer un Pulse (événement « Vente réussie ») avec l'URL https://TON-DOMAINE/api/pulse/LE_TOKEN
4. Copier le Secret de signature du Pulse → PULSE_SIGNING_SECRET

Structure

• bin/create.js — le CLI (zéro dépendance, Node natif)
• template/ — le projet généré (Next.js : checkout, webhook, UI packs)

Limites de l'API Chariow

• Un seul produit par checkout — pas de panier multi-lignes. Pour vendre plusieurs articles en un paiement, utilise un produit de type Bundle.
• Page de paiement hébergée par Chariow/Moneroo : on redirige, on n'embarque pas la saisie du paiement.
• Types Service / Coaching / prix libre non supportés par l'API checkout.

Déploiement

Le webhook a besoin d'une URL publique stable.

• Railway / Render — le store JSON de démo fonctionne tel quel (disque persistant)
• Vercel — filesystem éphémère : remplace lib/store.js par une vraie base

En local, un tunnel suffit : cloudflared tunnel --url http://localhost:3000

Tu as déjà un projet ? La lib chariow-kit s'installe dedans sans rien chambouler : npm install chariow-kit.

Licence

MIT