Outils pour développeurs et IA - Documentation Tchin

Outil	Pour qui	Ce qu’il fait
`Agent Skills`	Développeurs avec Claude Code, Cursor, Codex, Copilot, Gemini…	l’assistant connaît Tchin et écrit une intégration correcte
`Agent Toolkit`	Vous construisez votre propre agent (WhatsApp, site, support)	les fonctions de l’API Tchin, prêtes pour OpenAI, Vercel AI SDK, LangChain
`CLI tchin`	Développeurs, équipes techniques, scripts	créer et suivre paiements, abonnements, versements, vérifications depuis le terminal
`Serveur MCP`	Clients et marchands dans ChatGPT, Claude…	payer dans la conversation ; gérer son compte (voir Payer avec une IA)

Agent Skills

Des fiches de connaissance installées dans votre projet : une fiche d'entrée dit à l'assistant laquelle lire selon la demande (paiements, abonnements, versements, identité, webhooks, MCP…), et chaque fiche a sa référence complète (champs, code dans chaque langage, réponses). L'assistant lit d'abord la fiche courte, la référence seulement si besoin.

Dans le dossier de votre projet (Node 18+)

curl -fsSL https://tchin.tech/outils/tchin-skills.js -o tchin-skills.js
node tchin-skills.js add                                   # détecte vos assistants
node tchin-skills.js add --frameworks claude-code,cursor   # ou choisissez
node tchin-skills.js remove                                # tout retirer

Assistant	Fiches	Consigne
`claude-code`	`.claude/skills/tchin/`	`CLAUDE.md`
`cursor`	`.cursor/tchin-skills/`	`.cursor/rules/tchin.mdc`
`codex, opencode, antigravity`	`.agents/skills/tchin/` (ou équivalent)	`AGENTS.md`
`vscode-copilot, copilot-cli`	`.github/skills/tchin/`	`.github/copilot-instructions.md`
`gemini-cli`	`.gemini/skills/tchin/`	`GEMINI.md`

Ensuite, redémarrez l'assistant et demandez par exemple : « Intègre le paiement Tchin dans ce projet ». La consigne est ajoutée entre deux marqueurs : vos propres consignes ne sont pas touchées.

Agent Toolkit

Les fonctions de l'API Tchin pour votre agent, par appel de fonctions : créer un paiement, un abonnement, un versement, une vérification d'identité, lire leur état et votre solde. Node 18+, sans dépendance, côté serveur seulement.

const { TchinAgentToolkit } = require('./tchin-agent-toolkit');
const tchin = new TchinAgentToolkit(process.env.TCHIN_PUBLIC_KEY, process.env.TCHIN_PRIVATE_KEY, {
  env: 'test',          // 'live' pour de vrai
  sansVersement: true,  // pas d'argent sortant (conseillé pour un agent public)
});

// OpenAI Chat Completions
const r = await openai.chat.completions.create({ model: 'gpt-5', messages, tools: tchin.getTools() });
for (const appel of r.choices[0].message.tool_calls || []) {
  const resultat = await tchin.executer(appel.function.name, appel.function.arguments);
  messages.push({ role: 'tool', tool_call_id: appel.id, content: JSON.stringify(resultat) });
}

// OpenAI Agents SDK
const { Agent, tool } = require('@openai/agents');
const agent = new Agent({ name: 'Caisse', instructions: 'Tu aides les clients à payer.', tools: tchin.getAgentTools(tool) });

// Vercel AI SDK
const { tool: outil, jsonSchema } = require('ai');
const tools = tchin.getVercelTools(outil, jsonSchema);

// LangChain
const { tool: lcTool } = require('@langchain/core/tools');
const lcTools = tchin.getLangChainTools(lcTool);

Outil	Ce qu’il fait
`tchin_creer_paiement`	un paiement : rend `token` et `payment_url` (le client paie lui-même)
`tchin_etat_paiement`	pending, completed, failed ou cancelled
`tchin_creer_abonnement`	un abonnement (monthly, quarterly, biannual, yearly)
`tchin_abonnement / tchin_resilier_abonnement`	lire / résilier un abonnement
`tchin_creer_versement`	envoyer de l’argent à un client ; il choisit où le recevoir (argent sortant : retiré avec `sansVersement`)
`tchin_versement / tchin_annuler_versement`	l’état d’un versement / l’annuler
`tchin_creer_verification / tchin_verification`	une vérification d’identité (150 F) et son résultat
`tchin_solde`	vos soldes par pays et en crypto

Attention

Options de sécurité : lectureSeule (l’agent ne fait que lire), sansVersement (pas d’argent sortant), outils (une liste précise). Le toolkit refuse de démarrer dans un navigateur. Les erreurs sont rendues au modèle sous forme de message, jamais vos clés.

Télécharger le toolkit · aussi sur https://tchin.tech/outils/tchin-agent-toolkit.zip.

CLI tchin

Installer (Node 18+)

curl -fsSL https://tchin.tech/outils/install.sh | sh        # macOS, Linux
irm https://tchin.tech/outils/install.ps1 | iex             # Windows (PowerShell)

Les commandes

tchin configurer --publique tchin_pk_... --secrete tchin_sk_... --test
tchin solde
tchin paiement creer --montant 5000 --description "Commande 42"
tchin paiement etat y20vcyegjk85bs
tchin abonnement creer --montant 10000 --offre "Pro" --intervalle monthly
tchin abonnement liste --statut active
tchin abonnement resilier sub_xxx --oui
tchin versement creer --montant 2000 --email client@exemple.com --oui
tchin kyc creer --reference client-42
tchin webhook verifier --fichier data.json
tchin mcp

Les clés sont gardées dans ~/.tchin/config.json, lisible par vous seul, ou lues dans TCHIN_PUBLIC_KEY, TCHIN_PRIVATE_KEY et TCHIN_ENV. tchin config les montre masquées.
Mode par défaut : test. Ajoutez --live pour de vrai.
Un versement (argent qui sort) et une résiliation demandent --oui.
--json donne la réponse brute (pour vos scripts).

Les empreintes SHA-256 des fichiers : tchin.tech/outils/SHA256SUMS.txt.