Qué hace el paquete
- Crea el namespace utopay y los ajustes del sistema utopay_* (clave, moneda, tipo de cambio, moneda cripto…), con descripciones en inglés y ruso.
- Con miniShop2: registra las clases de pago y crea dos métodos de pago desactivados: «Card, Apple Pay, Google Pay, PayPal» (clase Utopay) y «Crypto: USDT, USDC» (clase UtopayCrypto).
- Con miniShop3 (MODX 3): crea los mismos dos métodos con el proveedor
Utopay\MiniShop3\UtopayPayment, que trabaja con los intentos de pago de miniShop3 y su ruta de webhooks. - Tras hacer el pedido, el comprador va a la página de UTOPAY; el pedido pasa a pagado solo cuando el pago, releído por la API, coincide en importe y moneda.
- Las actualizaciones conservan tus ajustes; al desinstalar se desactivan los métodos y los pedidos quedan intactos.
Instalación
- Descarga el paquete de arriba (no cambies el nombre
utopay-1.1.0-pl.transport.zip). - Manager de MODX → Extras → Installer → flecha junto a «Download Extras» → Upload a package → elige el archivo → Install.
- System → System Settings → namespace utopay: pon utopay_secret_key; crea una clave de prueba
utopay_sk_test_…en el panel de UTOPAY (Integration → API keys). Ajusta la moneda y el tipo de cambio si tus precios no están en USD. - miniShop2 / miniShop3 → Settings → Payments: activa «Card, Apple Pay, Google Pay, PayPal» y/o «Crypto: USDT, USDC» y vincúlalos a tus métodos de envío.
- Para cripto añade tu wallet EVM en el panel (Project settings → Funds & payouts) y pon utopay_coin.
- Haz un pedido de prueba y pulsa el botón verde ✅ en el sandbox de UTOPAY: el pedido pasa a pagado. Cambia la clave por
utopay_sk_live_….
Ajustes
| Ajuste del sistema | Qué hace |
|---|---|
| utopay_secret_key | utopay_sk_test_… / utopay_sk_live_…. |
| utopay_currency, utopay_rate | Moneda en la que cobra UTOPAY y tipo de cambio fijo desde tus precios (1 si ya están en ella). |
| utopay_shop_currency | Solo miniShop3: moneda de los precios; en ella se guardan los intentos de pago. |
| utopay_coin | Moneda del método cripto, p. ej. bep20/usdt. |
| utopay_provider | Opcional: enviar a los compradores directamente a Stripe, PayPal, Revolut… |
| utopay_ms2_paid_status, utopay_success_id | Estado de pagado de miniShop2 (2) y el recurso al que vuelve el comprador. |
Cómo se confirman los pedidos
Cada pago lleva su propia URL de notificación 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.
El pago siempre se vuelve a leer por la API de UTOPAY; solo un importe y una moneda exactos marcan el pedido como pagado. Los pagos cripto insuficientes y las discrepancias se registran en el log de errores de MODX con el prefijo [UTOPAY].
Historial de versiones
- 1.1.0-pl — paquete de instalación para el instalador de MODX: namespace, ajustes del sistema, métodos de pago creados automáticamente.
- 1.0.0 — primera versión en archivos: miniShop2 (MODX 2.8 – 3.x) y miniShop3 1.14 beta.
SHA-256: 4c3b62e6f9d3dab65ad40b9610b463f40b78327eff0ec5aaabed77fac64a3a2a
Actualizado · Equipo de integraciones de UTOPAY