En resumen
- Funciona con
- WooCommerce (pago clásico y por bloques), JetFormBuilder, Contact Form 7, Elementor, Gutenberg
- Requisitos
- WordPress 6.0 o posterior, PHP 7.4 o posterior, una cuenta de Toreador con al menos una wallet de recepción
- Quién puede conectar un sitio
- El propietario o un administrador de la organización
- Moneda
- Su tienda en USD o en EUR. Sus clientes pagan en stablecoins (USDC, USDT, EURC y otras), en la red que elijan
- Versión descrita
- 0.2.2
Instalar el plugin
- 1Descargue el plugin de Toreador (un archivo .zip).
- 2En WordPress, abra Plugins → Añadir nuevo → Subir plugin, elija el archivo y haga clic en Instalar ahora.
- 3Actívelo. Aparece una entrada Toreador en el menú de administración.
Nada que activar: WooCommerce, JetFormBuilder, Contact Form 7, Elementor y Gutenberg se detectan en cuanto están activos.
Conectar su sitio
Usted nunca escribe una contraseña ni pega una clave en WordPress. El sitio se conecta desde una pantalla de autorización en Toreador y recibe una clave limitada a este sitio, que puede revocar en cualquier momento.
- 1Abra Toreador en el menú de WordPress y haga clic en Conectar con Toreador.
- 2Inicie sesión en Toreador si hace falta. La pantalla de autorización nombra su sitio por su dominio: compruebe que es el suyo.
- 3Elija la organización a la que pertenece el sitio y haga clic en Autorizar. Vuelve a WordPress, ya conectado.
Las reglas
- Solo el propietario o un administrador de la organización puede autorizar un sitio.
- Para una clave de producción, Toreador pide el código enviado a su correo electrónico si usted inició sesión hace más de cinco minutos. Una clave de prueba no pide nada más.
- El propietario de la organización recibe un correo cada vez que se crea una clave.
- La clave puede crear solicitudes de pago y leer sus pagos. No puede cambiar sus wallets de recepción.
Una vez conectado, el botón Probar la conexión comprueba en cualquier momento que la clave sigue funcionando.
WooCommerce
El plugin añade un método de pago, Pagar en cripto. Usted piensa en USD o en EUR; su cliente elige la stablecoin y la red en una página de pago de Toreador, y paga desde su propia wallet.
Los ajustes
WooCommerce → Ajustes → Pagos → Toreador.
- Activar: muestra el método de pago al finalizar la compra.
- Título y descripción: lo que lee su cliente al finalizar la compra.
- Wallet de recepción: una de las wallets de su cuenta de Toreador. La dirección nunca se escribe en WordPress; usted añade y retira sus wallets desde su panel de Toreador.
- Configuración avanzada: marque exactamente las stablecoins y las redes que acepta. Por defecto se ofrece todo lo compatible con su wallet.
Lo que ve su cliente
- 1Al finalizar la compra, elige Pagar en cripto y realiza el pedido.
- 2Una página muestra el importe y un botón Abrir la página de pago. La página de pago se abre en una pestaña nueva.
- 3Elige una stablecoin y una red, y paga desde su wallet.
- 4La página del pedido se actualiza sola: el pedido está pagado, con su transacción.
Lo que usted ve en el pedido
- El pedido sigue pendiente, y se puede pagar, hasta que el pago se confirma en la blockchain. Después pasa a «Procesando».
- Una nota registra el importe recibido, la stablecoin, la red y el hash de la transacción. Los correos del pedido llevan los mismos datos.
- Un pago hecho sobre una solicitud de pago anterior del mismo pedido no se aplica solo: el pedido queda en espera para que usted lo revise.
Formularios: JetFormBuilder y Contact Form 7
Un formulario puede terminar con un pago en cripto: una señal, una donación, una reserva. Una vez enviado el formulario, aparece debajo un panel de pago.
Abra Toreador → Formularios. Aparecen todos los formularios de su sitio; haga clic en Configurar.
- Activar Toreador: pone en servicio la solicitud de pago para este formulario.
- Wallet de recepción: la wallet por defecto de su cuenta, u otra. Siempre procede de su cuenta, nunca de un campo del formulario.
- Importe: fijado por usted, o escrito por el visitante en un campo numérico. Un importe escrito se vuelve a comprobar en el servidor, entre el mínimo y el máximo que usted fija.
- Moneda: USD o EUR.
- Página después del pago: opcional. Sin ella, el visitante permanece en la página y lee que el pago está confirmado.
JetFormBuilder pide un paso más en el editor del formulario: en las acciones posteriores al envío, añada la acción Toreador — Solicitud de pago en cripto. Allí no tiene ningún ajuste; todo se configura en Toreador → Formularios.
Contact Form 7 no pide nada más. La solicitud de pago se crea incluso cuando el correo de notificación del formulario no se puede enviar.
Si la wallet de un formulario se retira de su cuenta, la pantalla Formularios lo indica, y sus visitantes leen que el pago en cripto no está disponible.
Zona de pago: Elementor y Gutenberg
Por defecto, el panel de pago aparece justo debajo del formulario. Para colocarlo donde quiera y darle estilo con su constructor, añada la zona de pago.
- Gutenberg: añada el bloque Toreador — Zona de pago.
- Elementor: arrastre el widget Toreador — Zona de pago.
La zona permanece invisible hasta que se envía el formulario; el panel de pago aparece entonces en su interior. Puede cambiar su título y el texto de su botón.
Cómo se confirma un pago
Toreador observa la blockchain. Su sitio conoce el resultado de tres maneras, para que ningún pago se pierda y ninguno se cuente dos veces.
Una notificación en tiempo real
Toreador envía a su sitio un mensaje firmado en cuanto el pago se confirma. Hace falta una dirección HTTPS pública; el plugin la registra al conectar.
La propia página
Mientras su cliente espera, la página pregunta el estado cada pocos segundos.
Una comprobación en segundo plano
Cada cinco minutos, el plugin comprueba los pagos que siguen pendientes, aunque el cliente haya cerrado la página.
En un sitio sin dirección HTTPS pública, una copia local por ejemplo, las notificaciones en tiempo real están inactivas y la pantalla de Toreador lo indica. Las otras dos maneras siguen funcionando.
El modo de prueba
- Debajo del botón Conectar, el enlace «conectar en modo sandbox» da al sitio una clave de prueba.
- Los pagos pasan entonces por redes de prueba, con stablecoins de prueba: no se mueve ningún fondo real.
- La prueba y la producción están separadas: una clave de prueba nunca ve un pago real. Para pasar a producción, desconecte y vuelva a conectar con Conectar con Toreador.
Los mensajes que puede ver
« La clave API ha sido revocada o ya no es válida »
Por qué — El sitio se desconectó desde Aplicaciones conectadas en Toreador, o su clave fue revocada.
Qué hacer — Vuelva a conectar el sitio. Mientras tanto, la cripto se retira de la página de pago.
« Esta wallet ya no está en su cuenta de Toreador »
Por qué — La wallet de recepción configurada en WooCommerce o en un formulario se retiró de su cuenta.
Qué hacer — Elija otra wallet en los ajustes.
« Cuota del plan alcanzada »
Por qué — Se ha alcanzado el número de pagos confirmados incluido en su plan.
Qué hacer — La cripto se pausa una hora; sus otros métodos de pago siguen funcionando. Cambie de plan para reanudar de inmediato.
« Notificaciones en tiempo real: inactivas »
Por qué — El sitio no tiene dirección HTTPS pública, o su plan no incluye las notificaciones en tiempo real.
Qué hacer — No se pierde nada: la página y la comprobación en segundo plano siguen confirmando los pagos.
« El pago en cripto no está disponible en este momento »
Por qué — Es lo que lee su cliente en uno de los casos anteriores.
Qué hacer — Puede elegir otro método de pago. Abra la pantalla de Toreador para ver la causa.
Para desarrolladores
El plugin ofrece tres funciones, un shortcode y dos hooks. Las funciones solo devuelven un pago al cliente del pedido, salvo que su código de servidor pida otra cosa.
toreador_order_payment( $order )— El pago de un pedido de WooCommerce: estado, stablecoin, red, importe, transacción, enlace al explorador.toreador_is_paid( $order )— Verdadero una vez confirmado el pago.toreador_create_payment( $args )— Crea una solicitud de pago desde su propio código y devuelve su página de pago. La dirección de recepción debe ser una wallet de su cuenta.[toreador_order_payment id="123"]— Muestra los detalles del pago de un pedido a su cliente.toreador_payment_completed— Se dispara cuando un pedido queda pagado.toreador_payment_status_changed— Se dispara cuando un pago de formulario queda pagado, caducado o fallido.
PHP
// Se dispara cuando un pedido queda pagado.
add_action( 'toreador_payment_completed', function ( $order_id, $payment ) {
// $payment['token'], $payment['chain'], $payment['amount'], $payment['tx']
}, 10, 2 );
// Crea una solicitud de pago desde su propio código y devuelve su página de pago. La dirección de recepción debe ser una wallet de su cuenta.
$request = toreador_create_payment( array(
'amount' => 50,
'currency' => 'USD',
'recipient' => '0x…', // Wallet de recepción
'reference' => 'booking-1042',
) );
if ( $request['ok'] ) {
wp_redirect( $request['pay_url'] );
}Desconectar y desinstalar
- Desconexión, en la pantalla de Toreador de WordPress, hace que el sitio olvide su clave. Para revocar la clave en sí, abra Aplicaciones conectadas en su panel de Toreador y haga clic en Desconectar.
- Eliminar el plugin retira sus ajustes, su clave y su tarea programada. Sus pedidos y sus notas de pago permanecen.
Lo que el plugin envía a Toreador
Solo lo que necesita un pago: el importe, la moneda, su dirección de recepción, una referencia del pedido y el origen (WooCommerce o el constructor de formularios). Los datos personales de sus clientes nunca se envían.