Documentation

Extension WordPress

Une seule extension pour tout votre site WordPress : un moyen de paiement crypto dans WooCommerce, des demandes de paiement sur vos formulaires, et une zone de paiement pour votre constructeur de pages. Les paiements vont du wallet de votre client directement au vôtre ; Toreador ne détient jamais de fonds.

Sur cette page

En bref

Fonctionne avec
WooCommerce (paiement classique et en blocs), JetFormBuilder, Contact Form 7, Elementor, Gutenberg
Ce qu'il faut
WordPress 6.0 ou plus récent, PHP 7.4 ou plus récent, un compte Toreador avec au moins un wallet de réception
Qui peut connecter un site
Le propriétaire ou un administrateur de l'organisation
Devise
Votre boutique en USD ou en EUR. Vos clients paient en stablecoins (USDC, USDT, EURC et d'autres), sur le réseau de leur choix
Version décrite
0.2.2

Installer l'extension

  1. 1Téléchargez l'extension Toreador (un fichier .zip).
  2. 2Dans WordPress, ouvrez Extensions → Ajouter → Téléverser une extension, choisissez le fichier et cliquez sur Installer.
  3. 3Activez-la. Une entrée Toreador apparaît dans le menu d'administration.

Rien à activer : WooCommerce, JetFormBuilder, Contact Form 7, Elementor et Gutenberg sont détectés dès qu'ils sont actifs.

Connecter votre site

Vous ne saisissez jamais de mot de passe et ne collez jamais de clé dans WordPress. Le site se connecte depuis un écran d'autorisation sur Toreador, et reçoit une clé limitée à ce site, que vous pouvez révoquer à tout moment.

  1. 1Ouvrez Toreador dans le menu de WordPress et cliquez sur Connecter à Toreador.
  2. 2Connectez-vous à Toreador si besoin. L'écran d'autorisation nomme votre site par son domaine : vérifiez que c'est bien le vôtre.
  3. 3Choisissez l'organisation à laquelle le site appartient, puis cliquez sur Autoriser. Vous revenez dans WordPress, connecté.
Admin WordPress, écran Toreador, avant la connexion
L'écran d'autorisation, sur Toreador
Admin WordPress, écran Toreador, une fois connecté

Les règles

  • Seul le propriétaire ou un administrateur de l'organisation peut autoriser un site.
  • Pour une clé de production, Toreador demande le code envoyé à votre adresse email si vous vous êtes connecté il y a plus de cinq minutes. Une clé d'essai ne demande rien de plus.
  • Le propriétaire de l'organisation reçoit un email à chaque création de clé.
  • La clé peut créer des demandes de paiement et lire vos paiements. Elle ne peut pas changer vos wallets de réception.

Une fois connecté, le bouton Tester la connexion vérifie à tout moment que la clé fonctionne toujours.

WooCommerce

L'extension ajoute un moyen de paiement, Payer en crypto. Vous pensez en USD ou en EUR ; votre client choisit le stablecoin et le réseau sur une page de paiement Toreador, et paie depuis son propre wallet.

Les réglages

WooCommerce → Réglages → Paiements → Toreador.

  • Activer : affiche le moyen de paiement à la commande.
  • Titre et description : ce que lit votre client à la commande.
  • Wallet de réception : l'un des wallets de votre compte Toreador. L'adresse n'est jamais saisie dans WordPress ; vous ajoutez et retirez vos wallets depuis votre tableau de bord Toreador.
  • Configuration avancée : cochez précisément les stablecoins et les réseaux que vous acceptez. Par défaut, tout ce qui est compatible avec votre wallet est proposé.

Ce que voit votre client

  1. 1À la commande, il choisit Payer en crypto et valide.
  2. 2Une page affiche le montant et un bouton Ouvrir la page de paiement. La page de paiement s'ouvre dans un nouvel onglet.
  3. 3Il choisit un stablecoin et un réseau, et paie depuis son wallet.
  4. 4La page de la commande se met à jour toute seule : la commande est payée, avec sa transaction.
La commande, puis la page de la commande pendant que le client paie
La page de la commande une fois le paiement confirmé

Ce que vous voyez sur la commande

  • La commande reste en attente, et payable, tant que le paiement n'est pas confirmé sur la blockchain. Elle passe ensuite à « En cours ».
  • Une note enregistre le montant reçu, le stablecoin, le réseau et le hash de la transaction. Les emails de commande portent les mêmes détails.
  • Un paiement fait sur une ancienne demande de paiement de la même commande n'est pas appliqué tout seul : la commande est mise en attente pour que vous la vérifiiez.

Formulaires : JetFormBuilder et Contact Form 7

Un formulaire peut se terminer par un paiement crypto : un acompte, un don, une réservation. Une fois le formulaire envoyé, un panneau de paiement apparaît dessous.

Ouvrez Toreador → Formulaires. Tous les formulaires de votre site y figurent ; cliquez sur Configurer.

  • Activer Toreador : met en service la demande de paiement pour ce formulaire.
  • Wallet de réception : le wallet par défaut de votre compte, ou un autre. Il vient toujours de votre compte, jamais d'un champ du formulaire.
  • Montant : fixé par vous, ou saisi par le visiteur dans un champ numérique. Un montant saisi est revérifié sur le serveur, entre le minimum et le maximum que vous fixez.
  • Devise : USD ou EUR.
  • Page après paiement : facultative. Sans elle, le visiteur reste sur la page et lit que le paiement est confirmé.
Toreador → Formulaires, et les réglages d'un formulaire

JetFormBuilder demande une étape de plus dans l'éditeur du formulaire : dans les actions après envoi, ajoutez l'action Toreador — Demande de paiement crypto. Elle n'a aucun réglage à cet endroit ; tout se règle dans Toreador → Formulaires.

Contact Form 7 ne demande rien de plus. La demande de paiement est créée même quand l'email de notification du formulaire ne part pas.

Si le wallet d'un formulaire est retiré de votre compte, l'écran Formulaires le signale, et vos visiteurs lisent que le paiement crypto n'est pas disponible.

Zone de paiement : Elementor et Gutenberg

Par défaut, le panneau de paiement apparaît juste sous le formulaire. Pour le placer où vous voulez, et le styler avec votre constructeur, ajoutez la zone de paiement.

  • Gutenberg : ajoutez le bloc Toreador — Zone de paiement.
  • Elementor : déposez le widget Toreador — Zone de paiement.

La zone reste invisible tant que le formulaire n'est pas envoyé ; le panneau de paiement apparaît ensuite à l'intérieur. Vous pouvez changer son titre et le libellé de son bouton.

Un formulaire et sa zone de paiement, avant et après le paiement

Comment un paiement est confirmé

Toreador observe la blockchain. Votre site apprend le résultat de trois façons, pour qu'aucun paiement ne soit manqué et qu'aucun ne soit compté deux fois.

1

Une notification en temps réel

Toreador envoie à votre site un message signé dès que le paiement est confirmé. Il faut pour cela une adresse HTTPS publique ; l'extension l'enregistre à la connexion.

2

La page elle-même

Pendant que votre client attend, la page demande l'état du paiement toutes les quelques secondes.

3

Une vérification de fond

Toutes les cinq minutes, l'extension vérifie les paiements encore en attente, même si le client a fermé la page.

Sur un site sans adresse HTTPS publique, une copie locale par exemple, les notifications en temps réel sont inactives et l'écran Toreador le dit. Les deux autres façons fonctionnent toujours.

Le mode essai

  • Sous le bouton Connecter, le lien « connecter en mode sandbox » donne au site une clé d'essai.
  • Les paiements passent alors sur des réseaux d'essai, avec des stablecoins d'essai : aucun fonds réel ne bouge.
  • L'essai et la production sont séparés : une clé d'essai ne voit jamais un vrai paiement. Pour passer en production, déconnectez, puis reconnectez avec Connecter à Toreador.

Les messages que vous pouvez voir

« La clé API a été révoquée ou n'est plus valide »

Pourquoi — Le site a été déconnecté depuis Applications connectées dans Toreador, ou sa clé a été révoquée.

Que faire — Reconnectez le site. En attendant, la crypto est retirée de la page de commande.

« Ce wallet n'est plus sur votre compte Toreador »

Pourquoi — Le wallet de réception réglé dans WooCommerce ou sur un formulaire a été retiré de votre compte.

Que faire — Choisissez un autre wallet dans les réglages.

« Quota de la formule atteint »

Pourquoi — Le nombre de paiements confirmés compris dans votre formule est atteint.

Que faire — La crypto est mise en pause une heure ; vos autres moyens de paiement continuent de fonctionner. Changez de formule pour reprendre tout de suite.

« Notifications temps réel : inactives »

Pourquoi — Le site n'a pas d'adresse HTTPS publique, ou votre formule ne comprend pas les notifications en temps réel.

Que faire — Rien n'est perdu : la page et la vérification de fond confirment toujours les paiements.

« Le paiement crypto n'est pas disponible en ce moment »

Pourquoi — C'est ce que lit votre client dans l'un des cas ci-dessus.

Que faire — Il peut choisir un autre moyen de paiement. Ouvrez l'écran Toreador pour voir la cause.

Pour les développeurs

L'extension offre trois fonctions, un shortcode et deux crochets. Les fonctions ne renvoient un paiement qu'au client de la commande, sauf si votre code serveur demande autre chose.

  • toreador_order_payment( $order ) — Le paiement d'une commande WooCommerce : état, stablecoin, réseau, montant, transaction, lien vers l'explorateur.
  • toreador_is_paid( $order ) — Vrai une fois le paiement confirmé.
  • toreador_create_payment( $args ) — Crée une demande de paiement depuis votre propre code et renvoie sa page de paiement. L'adresse de réception doit être un wallet de votre compte.
  • [toreador_order_payment id="123"] — Affiche les détails du paiement d'une commande à son client.
  • toreador_payment_completed — Se déclenche quand une commande est payée.
  • toreador_payment_status_changed — Se déclenche quand un paiement de formulaire est payé, expiré ou échoué.

PHP

// Se déclenche quand une commande est payée.
add_action( 'toreador_payment_completed', function ( $order_id, $payment ) {
    // $payment['token'], $payment['chain'], $payment['amount'], $payment['tx']
}, 10, 2 );

// Crée une demande de paiement depuis votre propre code et renvoie sa page de paiement. L'adresse de réception doit être un wallet de votre compte.
$request = toreador_create_payment( array(
    'amount'    => 50,
    'currency'  => 'USD',
    'recipient' => '0x…', // Wallet de réception
    'reference' => 'booking-1042',
) );
if ( $request['ok'] ) {
    wp_redirect( $request['pay_url'] );
}

Déconnecter et désinstaller

  • Déconnexion, dans l'écran Toreador de WordPress, fait oublier sa clé au site. Pour révoquer la clé elle-même, ouvrez Applications connectées dans votre tableau de bord Toreador et cliquez sur Déconnecter.
  • Supprimer l'extension retire ses réglages, sa clé et sa tâche planifiée. Vos commandes et leurs notes de paiement restent.
Votre tableau de bord Toreador, Applications connectées

Ce que l'extension envoie à Toreador

Seulement ce qu'il faut à un paiement : le montant, la devise, votre adresse de réception, une référence de commande et l'origine (WooCommerce ou le constructeur de formulaires). Les données personnelles de vos clients ne sont jamais envoyées.

Nous respectons votre vie privée

Nous utilisons des cookies d'analyse pour améliorer notre service. Ces cookies ne sont activés qu'avec votre consentement. Les cookies essentiels (authentification, langue, etc.) sont toujours actifs.