=== Tchin ===
Contributors: wintg
Tags: mobile money, paiement, woocommerce, crypto, afrique
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
WC requires at least: 7.6
WC tested up to: 11.2
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Encaissez par Mobile Money (Togo, Bénin, Burkina Faso), crypto et compte Tchin : un bouton de paiement dans vos pages, et la caisse de WooCommerce.

== Description ==

Tchin est une seule extension pour WordPress et WooCommerce. Vos clients paient :

* en **Mobile Money** : Yas et Moov au Togo, MTN, Moov et Celtiis Cash au Bénin, Orange Money et Moov au Burkina Faso ;
* en **crypto** : USDT (TRC-20), TRX, BNB, SOL et GRAM, partout dans le monde ;
* avec leur **compte Tchin**, en deux secondes, sans frais.

Le paiement s'ouvre toujours dans la **feuille Tchin**, par-dessus votre site : le client ne part jamais ailleurs. Un paiement n'est compté que lorsque Tchin le confirme (webhook signé, ou état relu chez Tchin) : jamais sur la seule parole du navigateur.

Un paiement validé est **définitif** : Tchin ne fait pas de remboursement. La feuille le dit au client avant qu'il paie.

= Sur un site WordPress =

* Le bloc **Paiement Tchin** dans l'éditeur, ou le code court `[tchin montant="5000" titre="Cotisation 2026"]` : un bouton de paiement dans n'importe quelle page (une cotisation, un billet, un don).
* Un montant fixe, ou libre entre deux bornes : `[tchin libre="oui" min="500" max="100000" titre="Faire un don"]`.
* Le montant et le titre sont signés par votre site : personne ne peut les changer dans la page.
* Les paiements reçus sont dans le menu **Tchin › Paiements**.
* Pour les développeurs : l'action `tchin_paiement_recu` est appelée une fois par paiement reçu.

= Avec WooCommerce =

* Tchin à la caisse classique et à la caisse en blocs ; le nouveau stockage des commandes (HPOS).
* Les retraits des vendeurs avec **Dokan** ou **WCFM Marketplace** : quand vous validez une demande, le vendeur reçoit un lien Tchin et choisit où recevoir (Mobile Money ou crypto).

= Partout =

* Un mode test, sans argent réel, avec les mêmes clés.
* Les frais de votre application Tchin (le réglage de tchin.tech fait foi).
* La feuille à vos couleurs : boutons, accent, panneau, et le logo Tchin orange, noir, à votre couleur ou masqué.
* Une page de réglages au design de Tchin, avec un aperçu en direct de la feuille.
* Une vérification toutes les 5 minutes des paiements en attente, au cas où un webhook n'arriverait pas.
* Les mises à jour comme les autres extensions : un clic, ou automatiques.

= Sécurité =

* La clé secrète est gardée **chiffrée** dans votre base (avec les clés de wp-config.php) et n'est jamais réaffichée.
* Chaque webhook est vérifié : signature HMAC-SHA256 avec votre clé secrète, envoi de moins de 10 minutes.
* Le paiement est relu chez Tchin avant d'être compté : le montant et le mode doivent correspondre.
* Un paiement n'est compté qu'une fois, même si le webhook et le client arrivent en même temps.
* Un retrait de vendeur n'est envoyé qu'une fois, et seulement après les contrôles de la place de marché (solde, minimum).
* Chaque mise à jour est signée par Wintg (Ed25519) : une archive changée en route est refusée.

== Services externes ==

Cette extension se connecte à **Tchin** (https://tchin.tech), le service de paiement qu'elle ajoute à votre site. Sans lui, elle ne peut rien encaisser.

* **API de Tchin** (https://tchin.tech/api/v1) : à la création d'un paiement, le serveur de votre site envoie le montant, une description (le numéro de la commande ou le titre du bouton, et le nom du site), l'adresse de retour et l'adresse du webhook. Rien sur le client : il saisit lui-même son numéro ou choisit sa crypto dans la feuille de Tchin. Il relit ensuite l'état du paiement. Pour un retrait de vendeur : le montant, l'e-mail du vendeur et la référence de la demande. Vos clés d'API accompagnent chaque appel.
* **Kit de paiement** (https://tchin.tech/js/tchin-pay.js) : chargé dans la page où le client paie ; il ouvre la feuille de paiement de Tchin.
* **Mises à jour** (https://doc.wintg.group/telechargements/tchin/info.json) : votre site lit le numéro de la dernière version et télécharge son archive. Rien n'est envoyé.

Conditions d'utilisation : https://tchin.tech/legal - Confidentialité : https://tchin.tech/legal

== Installation ==

1. Extensions › Ajouter › Téléverser une extension, choisissez `tchin.zip`, puis Activer.
2. Menu **Tchin** : collez votre clé publique et votre clé secrète (tchin.tech, page API › votre application › Voir les clés), laissez le mode **Test**, choisissez vos couleurs, enregistrez, puis « Tester la connexion ».
3. Sur un site WordPress : ajoutez le bloc « Paiement Tchin » à une page. Avec WooCommerce : la devise doit être le **Franc CFA (XOF)**, et « Proposer Tchin à la caisse » coché.
4. Payez une fois en test, puis passez le mode en **Réel**.

Vous aviez « Tchin pour WooCommerce » ? Installez Tchin : l'ancienne extension est désactivée toute seule, vos clés, vos couleurs et vos commandes sont gardées. Vous pouvez ensuite la supprimer.

Le guide complet : https://doc.wintg.group/tchin/woocommerce/

== Frequently Asked Questions ==

= Faut-il WooCommerce ? =

Non. Sans WooCommerce, Tchin ajoute le bloc et le code court de paiement. Avec WooCommerce, il ajoute aussi Tchin à la caisse.

= Où arrive l'argent ? =

Sur votre compte Tchin : le solde du pays où le client a payé en Mobile Money, ou le solde de la crypto payée. Vous le retirez depuis votre tableau de bord Tchin.

= Le webhook doit-il être réglé quelque part ? =

Non. Son adresse part avec chaque paiement. Elle doit être en HTTPS et joignable depuis Internet. Sur un site en local, la page et la vérification toutes les 5 minutes mettent quand même les paiements à jour.

= Ma boutique est en euros ou en dollars =

Tchin encaisse en franc CFA (XOF) : à la caisse, Tchin n'est proposé que si la boutique est en XOF.

= Et les remboursements ? =

Tchin ne rembourse pas : un paiement validé est définitif, et un envoi vers un mauvais numéro ne revient pas. La feuille Tchin le rappelle au client avant qu'il paie, et au vendeur avant qu'il reçoive.

= Les retraits des vendeurs =

Avec Dokan ou WCFM Marketplace, activez « Payer les retraits des vendeurs avec Tchin » dans les réglages. Le vendeur choisit Tchin comme moyen de retrait, rien à remplir. Quand vous validez sa demande, Tchin lui envoie un lien à l'e-mail de son compte, et il le retrouve dans son tableau de bord (« Recevoir mon argent »). L'argent part de votre solde Tchin, frais de Tchin déduits du montant.

== Changelog ==

= 1.1.0 =
* Une seule extension pour WordPress et WooCommerce : le bloc « Paiement Tchin » et le code court [tchin], avec leurs paiements dans le menu Tchin.
* Le menu Tchin : une page à part, avec les onglets Réglages, Paiements et Retraits des vendeurs.
* Les mises à jour en un clic ou automatiques, signées par Wintg.
* Remplace « Tchin pour WooCommerce » 1.0 : ses réglages sont repris, elle est désactivée toute seule.

= 1.0.0 =
* Première version : paiements dans la feuille Tchin, page de commande classique et en blocs, apparence de la feuille, retraits des vendeurs (Dokan, WCFM), webhook signé, vérification de rattrapage, clé secrète chiffrée.
