Qué hace el módulo
- El checkout muestra Tarjeta, Apple Pay, Google Pay, PayPal y Cripto (con selector de moneda). Cualquiera de las dos se puede desactivar.
- El pedido se crea en el estado Awaiting UTOPAY payment y luego el comprador paga en la página de UTOPAY.
- Cuando el pago, releído por la API, coincide en importe y moneda, el pedido pasa a Payment accepted; el id del pago de UTOPAY se guarda como id de transacción.
- La página de confirmación del pedido vuelve a comprobar el pago y muestra Pagar de nuevo mientras el pedido esté impagado.
- Los pagos cripto insuficientes y los importes que no coinciden se registran en Advanced Parameters → Logs para el pedido.
Instalación
- Descarga el ZIP de arriba.
- Modules → Module Manager → Upload a module → elige el ZIP (PrestaShop 1.6: Modules → Add a new module).
- Abre Configure. En el panel de UTOPAY crea una clave de prueba
utopay_sk_test_…(Integration → API keys) y pégala. La clave se comprueba al guardar. - Elige las opciones de pago y las monedas. Para cripto añade tu wallet EVM en el panel (Project settings → Funds & payouts).
- Comprueba que el módulo está permitido para tus monedas y países en Payment → Preferences.
Ajustes
| Campo | Qué hace |
|---|---|
| Secret key | utopay_sk_test_… para el sandbox, utopay_sk_live_… para pagos reales. Déjalo vacío para conservar la clave guardada. |
| Payment options | Tarjeta / PayPal y cripto, solo tarjeta o solo cripto. |
| Crypto coins | Tickers separados por comas, p. ej. bep20/usdt,erc20/usdt,polygon/usdc. |
| Card method | Vacío: elige el comprador; o directamente Stripe, PayPal, Revolut… |
Pago de prueba
- Con la clave de prueba haz un pedido y elige una opción de UTOPAY.
- En el sandbox de UTOPAY pulsa el botón verde ✅.
- Vuelves a la página de confirmación del pedido: «Pago recibido». En el back office el pedido está en Payment accepted.
- Cambia la clave por
utopay_sk_live_….
Cómo se confirman los pedidos
Cada pago lleva su propia URL de notificación (/module/utopay/callback) con el id del pedido, el importe y la moneda, firmada con tu clave secreta. UTOPAY firma cada evento (HMAC-SHA256) y reintenta durante seis horas si la tienda no responde 2xx.
El módulo comprueba ambas firmas, vuelve a leer el pago por la API y pone Payment accepted solo cuando está pagado exactamente con el total y la moneda del pedido.
Solución de problemas
- UTOPAY no aparece en el checkout: la moneda del carrito no es compatible, la clave está vacía o el módulo no está permitido para la moneda / país en Payment → Preferences.
- Los pedidos siguen en «Awaiting UTOPAY payment»: la tienda debe ser accesible desde internet y el modo mantenimiento debe estar desactivado; revisa Advanced Parameters → Logs.
- «amount is below the minimum»: el total está por debajo del mínimo del método o moneda; el comprador puede pulsar Pagar de nuevo y elegir otro.
Historial de versiones
- 1.0.0 — primera versión: PrestaShop 1.6.1 – 9, tarjetas y PayPal, cripto, Pagar de nuevo, traducción al ruso.
SHA-256: 3fbdc9540feaa15a12ca677af2c56d55284f104a119c50bc139fe20e1248ac52
Actualizado · Equipo de integraciones de UTOPAY