Documentation

WordPress plugin

One plugin for your whole WordPress site: a crypto payment method in WooCommerce, payment requests on your forms, and a payment area for your page builder. Payments go from your customer's wallet straight to yours; Toreador never holds funds.

On this page

At a glance

Works with
WooCommerce (classic and block checkout), JetFormBuilder, Contact Form 7, Elementor, Gutenberg
Requirements
WordPress 6.0 or later, PHP 7.4 or later, a Toreador account with at least one receiving wallet
Who can connect a site
The owner or an administrator of the organization
Currency
Your store in USD or EUR. Your customers pay in stablecoins (USDC, USDT, EURC and others), on the network they choose
Version described
0.2.2

Install the plugin

  1. 1Download the Toreador plugin (a .zip file).
  2. 2In WordPress, open Plugins → Add New → Upload Plugin, choose the file and click Install Now.
  3. 3Activate it. A Toreador entry appears in the admin menu.

Nothing to switch on: WooCommerce, JetFormBuilder, Contact Form 7, Elementor and Gutenberg are detected as soon as they are active.

Connect your site

You never type a password or paste a key in WordPress. The site is connected from an authorization screen on Toreador, and receives a key limited to this site, which you can revoke at any time.

  1. 1Open Toreador in the WordPress menu and click Connect to Toreador.
  2. 2Sign in to Toreador if needed. The authorization screen names your site by its domain: check that it is yours.
  3. 3Choose the organization the site belongs to, then click Authorize. You are returned to WordPress, connected.
WordPress admin, Toreador screen, before connecting
The authorization screen, on Toreador
WordPress admin, Toreador screen, once connected

The rules

  • Only the owner or an administrator of the organization can authorize a site.
  • For a production key, Toreador asks for the code sent to your email address if you signed in more than five minutes ago. A test key asks for nothing more.
  • The owner of the organization receives an email each time a key is created.
  • The key can create payment requests and read your payments. It cannot change your receiving wallets.

Once connected, the Test the connection button checks at any time that the key still works.

WooCommerce

The plugin adds a payment method, Pay with crypto. You think in USD or EUR; your customer chooses the stablecoin and the network on a Toreador payment page, and pays from their own wallet.

Settings

WooCommerce → Settings → Payments → Toreador.

  • Enable: shows the payment method at checkout.
  • Title and description: what your customer reads at checkout.
  • Receiving wallet: one of the wallets of your Toreador account. The address is never typed in WordPress; you add and remove wallets from your Toreador dashboard.
  • Advanced configuration: tick exactly which stablecoins and networks you accept. By default, everything compatible with your wallet is offered.

What your customer sees

  1. 1At checkout, they choose Pay with crypto and place the order.
  2. 2A page shows the amount and an Open the payment page button. The payment page opens in a new tab.
  3. 3They choose a stablecoin and a network, and pay from their wallet.
  4. 4The order page updates by itself: the order is paid, with its transaction.
Checkout, then the order page while the customer pays
The order page once the payment is confirmed

What you see on the order

  • The order stays pending, and payable, until the payment is confirmed on the blockchain. It then moves to Processing.
  • A note records the amount received, the stablecoin, the network and the transaction hash. The order emails carry the same details.
  • A payment made on an older payment request of the same order is not applied by itself: the order is put on hold for you to review.

Forms: JetFormBuilder and Contact Form 7

A form can end with a crypto payment: a deposit, a donation, a booking. Once the form is sent, a payment panel appears under it.

Open Toreador → Forms. Every form of your site is listed; click Configure.

  • Enable Toreador: turns the payment request on for this form.
  • Receiving wallet: the default wallet of your account, or another one. It always comes from your account, never from a field of the form.
  • Amount: fixed by you, or typed by the visitor in a number field. A typed amount is checked again on the server, between the minimum and the maximum you set.
  • Currency: USD or EUR.
  • Page after payment: optional. Without it, the visitor stays on the page and reads that the payment is confirmed.
Toreador → Forms, and the settings of one form

JetFormBuilder needs one more step in the form editor: in Post Submit Actions, add the action Toreador — Crypto payment request. It has no setting there; everything is set in Toreador → Forms.

Contact Form 7 needs nothing more. The payment request is created even when the notification email of the form cannot be sent.

If the wallet of a form is removed from your account, the Forms screen says so, and your visitors read that crypto payment is not available.

Payment area: Elementor and Gutenberg

By default the payment panel appears right under the form. To place it where you want, and style it with your builder, add the payment area.

  • Gutenberg: add the block Toreador — Payment area.
  • Elementor: drop the widget Toreador — Payment area.

The area stays invisible until the form is sent; the payment panel then appears inside it. You can change its title and the label of its button.

A form with its payment area, before and after the payment

How a payment is confirmed

Toreador watches the blockchain. Your site learns the result in three ways, so that no payment is missed and none is counted twice.

1

A real-time notification

Toreador sends your site a signed message as soon as the payment is confirmed. It needs a public HTTPS address; the plugin registers it when you connect.

2

The page itself

While your customer waits, the page asks for the status every few seconds.

3

A background check

Every five minutes, the plugin checks the payments still pending, even if the customer has closed the page.

On a site without a public HTTPS address, a local copy for example, real-time notifications are off and the Toreador screen says so. The two other ways still work.

Test mode

  • Under the Connect button, the link connect in sandbox mode gives the site a test key.
  • Payments then run on test networks, with test stablecoins: no real funds move.
  • Test and production are separate: a test key never sees a real payment. To go live, disconnect, then connect again with Connect to Toreador.

Messages you may see

« The API key was revoked or is no longer valid »

Why — The site was disconnected from Connected apps in Toreador, or its key was revoked.

What to do — Connect the site again. Meanwhile, crypto is removed from the checkout.

« This wallet is no longer on your Toreador account »

Why — The receiving wallet set in WooCommerce or on a form was removed from your account.

What to do — Choose another wallet in the settings.

« Plan quota reached »

Why — The number of confirmed payments included in your plan is reached.

What to do — Crypto is paused for one hour; your other payment methods keep working. Change plan to resume at once.

« Real-time notifications: inactive »

Why — The site has no public HTTPS address, or your plan does not include real-time notifications.

What to do — Nothing is lost: the page and the background check still confirm the payments.

« Crypto payment is not available at the moment »

Why — This is what your customer reads in one of the cases above.

What to do — They can choose another payment method. Open the Toreador screen to see the cause.

For developers

The plugin exposes three functions, a shortcode and two hooks. The functions only return a payment to the customer who owns the order, unless your server code asks otherwise.

  • toreador_order_payment( $order ) — The payment of a WooCommerce order: status, stablecoin, network, amount, transaction, explorer link.
  • toreador_is_paid( $order ) — True once the payment is confirmed.
  • toreador_create_payment( $args ) — Creates a payment request from your own code and returns its payment page. The receiving address must be a wallet of your account.
  • [toreador_order_payment id="123"] — Shows the payment details of an order to its customer.
  • toreador_payment_completed — Fires when an order is paid.
  • toreador_payment_status_changed — Fires when a form payment is paid, expired or failed.

PHP

// Fires when an order is paid.
add_action( 'toreador_payment_completed', function ( $order_id, $payment ) {
    // $payment['token'], $payment['chain'], $payment['amount'], $payment['tx']
}, 10, 2 );

// Creates a payment request from your own code and returns its payment page. The receiving address must be a wallet of your account.
$request = toreador_create_payment( array(
    'amount'    => 50,
    'currency'  => 'USD',
    'recipient' => '0x…', // Receiving wallet
    'reference' => 'booking-1042',
) );
if ( $request['ok'] ) {
    wp_redirect( $request['pay_url'] );
}

Disconnect and uninstall

  • Disconnect, in the Toreador screen of WordPress, makes the site forget its key. To revoke the key itself, open Connected apps in your Toreador dashboard and click Disconnect.
  • Deleting the plugin removes its settings, its key and its scheduled task. Your orders and their payment notes stay.
Your Toreador dashboard, Connected apps

What the plugin sends to Toreador

Only what a payment needs: the amount, the currency, your receiving address, an order reference and the origin (WooCommerce or the form builder). Your customers' personal data is never sent.

We respect your privacy

We use analytics cookies to improve our service. These cookies are only activated with your consent. Essential cookies (authentication, language etc.) are always active.