Qué hace el plugin
- UTOPAY — tarjetas y PayPal: tarjetas, Apple Pay, Google Pay, PayPal, Revolut, transferencias bancarias. El comprador paga en la página de UTOPAY y vuelve a la página de «Gracias».
- UTOPAY — cripto: el comprador elige una moneda (USDT y USDC en BNB Chain, Ethereum, Polygon, Arbitrum, Base…; ETH, BNB) en el propio checkout y recibe una dirección con el importe exacto.
- El pedido se marca como pagado solo después de que el plugin vuelve a leer el pago por la API y coinciden el importe y la moneda.
- Un pedido cripto con pago insuficiente pasa a On hold con una nota: el dinero ya está en tu wallet y tú decides qué hacer.
- Los pagos no realizados caducan a las 24 horas; WooCommerce cancela el pedido con su propio temporizador de reserva de stock.
Instalación
- Descarga el ZIP de arriba. No lo descomprimas.
- Admin de WordPress → Plugins → Add New → Upload Plugin → elige el archivo → Install Now → Activate.
- En el panel de UTOPAY abre Integration → API keys y crea una clave secreta de prueba
utopay_sk_test_…. - WooCommerce → Settings → Payments → UTOPAY — cards & PayPal → pega la clave → marca Enable → Save. La clave se comprueba al guardar.
- Para cripto: en el panel añade tus wallets en Project settings → Funds & payouts, sección Crypto wallets (una dirección EVM sirve para todas las redes EVM); luego activa UTOPAY — crypto y elige las monedas.
Ajustes
| Campo | Qué hace |
|---|---|
| Secret key | utopay_sk_test_… para el sandbox, utopay_sk_live_… para pagos reales. Compartida por ambos métodos. |
| Title / Description | Lo que ve el comprador en el checkout. |
| Payment method on the UTOPAY side | Vacío: elige el comprador. O envía a todos directamente a un método (Stripe, PayPal, Revolut…); si no está disponible, se muestra el selector de métodos. |
| Coins | Solo método cripto: monedas que se ofrecen en el checkout. Activa solo las redes para las que tienes wallet en el panel. |
| Debug log | Escribe peticiones y notificaciones en WooCommerce → Status → Logs, fuente utopay. |
Pago de prueba
- Con la clave de prueba, haz un pedido y elige un método de UTOPAY.
- Se abre el sandbox de UTOPAY. Pulsa el botón verde ✅ para simular un pago.
- En segundo y medio vuelves a la página de «Gracias»; el pedido pasa a Processing con la nota «UTOPAY payment ord_test_… received (test)».
- Repite con el botón rojo ❌: el pedido pasa a Failed.
- Cambia la clave por
utopay_sk_live_…. Listo.
Cómo se confirman los pedidos
Cada pago se crea con su propia URL de notificación: https://tu-sitio/?wc-api=utopay&order_id=…&key=…. UTOPAY envía allí cada cambio de estado, firmado con HMAC-SHA256 (la clave se deriva de tu clave secreta). Si tu sitio no responde 2xx, UTOPAY reintenta a los 30 s, 2 min, 15 min, 1 h y 6 h.
El plugin no confía en el cuerpo de la notificación: pide el pago a la API y completa el pedido solo si el pago pertenece a ese pedido y coinciden el importe y la moneda. Cuando el comprador vuelve a la página de «Gracias», se repite la misma comprobación, así que incluso un sitio local o protegido confirma sus pedidos.
Solución de problemas
- Los métodos no aparecen en el checkout: la moneda de la tienda no es compatible o la clave está vacía. Compatibles: USD EUR GBP CAD AUD NZD CHF SEK NOK DKK PLN CZK HUF TRY UAH INR JPY SGD HKD AED MYR THB PHP IDR BRL MXN COP ZAR NGN.
- «Payment could not be started: amount is below the minimum»: el total del pedido está por debajo del mínimo del método o moneda elegidos; el comprador puede elegir otro.
- El pedido sigue en «Pending payment»: el sitio debe ser accesible desde internet sin autenticación HTTP, y los plugins de seguridad no deben bloquear las peticiones POST a
/?wc-api=utopay. Activa Debug log y busca líneascallback. - «no evm wallet…»: la moneda está activada en el plugin, pero en el panel no hay wallet para su red.
Historial de versiones
- 1.0.2 — núcleo común de UTOPAY actualizado, sin cambios de comportamiento.
- 1.0.1 — soporte de dominio de API white-label (constante UTOPAY_API_BASE); monedas por defecto en redes EVM.
- 1.0.0 — primera versión: tarjetas y PayPal, cripto, checkout de bloques, HPOS, traducción al ruso.
SHA-256: 8a3900be6f724ca8c467fa538aeaedb9c81a6789dd59840313767688e1ffcf1b
Actualizado · Equipo de integraciones de UTOPAY