Pagos con criptomonedas en OpenCart 3 y 4

La extensión de CryptoLike agrega cripto como método de pago en OpenCart 3.0 y 4.0 y pasa cada pedido a Processing (en proceso) solo después de que el pago se confirma en la blockchain. Tus clientes pagan en Bitcoin, USDT, Ethereum, Litecoin, TRON o USDC; los estados de pedido, el inventario y los correos de OpenCart siguen funcionando como ya los usa tu tienda online.

#Requisitos

Hay dos paquetes con el mismo código base, porque OpenCart 4 cambió la estructura de las extensiones. Descarga desde esta página el que corresponde a tu versión de OpenCart.

OpenCart 4.1 es una rama aparte y todavía no es compatible. Tu tienda debe responder desde internet por https:// para que le lleguen los webhooks.

#Qué hace la extensión

La extensión confirma un pedido (estado Pending —pendiente—, inventario y correos de OpenCart) solo cuando ya existe la página de pago de CryptoLike. Si no se puede conectar con la API, el cliente ve «El pago con cripto no está disponible por ahora» y puede elegir otro método. A partir de ahí, solo los webhooks verificados cambian el pedido.

• Redirección o página integrada. Envía al cliente a la página de pago de CryptoLike o muéstrala en la página de estado del pedido de la tienda.
• Elección de moneda en la página de pago o en el paso de confirmación. Monedas ofrecidas limita ambas opciones; en la página de pago, sin selección significa todas las monedas disponibles para facturas en tu cuenta.
• Textos para el cliente en el historial del pedido; las notas para el comercio (IDs de transacción, qué hay que decidir) solo en el panel de administración, en la pestaña CryptoLike del pedido.
• Estados de pedido a tu elección, incluido «No cambiar» para pagos insuficientes, en revisión y vencidos.
• Zona geográfica y orden, como en cualquier método de pago de OpenCart.
• Una URL de conciliación para el cron del servidor: vuelve a consultar los pagos abiertos por si un webhook no llegó a la tienda.

#1. Instala la extensión

OpenCart 3.0: panel de administración → Extensiones → Instalador → sube cryptolike-opencart-3.0.ocmod.zip (no hay modificaciones que actualizar) → Extensiones → Extensiones → Pagos → CryptoLike → Instalar → Editar. OpenCart 4.0: panel de administración → Extensiones → Instalador → Subir cryptolike.ocmod.zip → Instalar en la lista de abajo → Extensiones → Extensiones → Pagos → CryptoLike → Instalar → Editar. La instalación crea las tablas de la extensión y, si tu tienda no lo tiene, un estado de pedido On hold (en espera).

#2. Conecta tu cuenta de CryptoLike

En el panel de CryptoLike abre Desarrolladores → Claves API → Crear clave con los permisos create_invoice y read, y pega el ID de la clave y el secreto en la configuración de la extensión; el secreto se muestra una sola vez. Copia la URL del webhook de la página de configuración, agrégala en el panel en Desarrolladores → Webhooks → Agregar endpoint con todos los eventos invoice.* y pega el secreto del endpoint en Secreto del webhook.

#3. Activa el método y haz una prueba

Pulsa Comprobar la conexión: «Conectado: N monedas disponibles». Pon Estado en Activado y guarda. Después agrega la URL de conciliación que aparece al final de la configuración al cron del servidor, cada 15 minutos. Antes de salir a producción, activa el modo de prueba con una clave ck_test_ y la URL de la API de prueba en URL de la API (el valor predeterminado es producción; pide la URL de prueba a soporte de CryptoLike): las claves de prueba funcionan con redes de prueba y monedas sin valor; una clave real se rechaza en modo de prueba.

#Qué pasa con un pedido

El tiempo para pagar es la configuración de tu cuenta (30 minutos por defecto), salvo que definas otro valor. Si el correo de OpenCart falla mientras un webhook cambia el estado, el estado y el texto para el cliente se guardan igual, sin el correo: un buzón con fallas nunca deja sin pagar un pedido pagado.

Las mismas reglas entre pago y pedido se aplican en todas las plataformas; las demás plataformas de tienda en línea se comparan en pagos cripto para tiendas online.

#Capturas de pantalla

#Solución de problemas

El registro está en system/storage/logs/cryptolike.log y nunca guarda secretos, firmas, cuerpos de webhooks ni datos de clientes. Al desinstalar la extensión se eliminan la configuración, los dos secretos y las tablas de la extensión; el historial de los pedidos se queda.

#Para desarrolladores

La extensión sigue el contrato común de los plugins de CryptoLike: el pago se crea desde el servidor con un solo pago abierto por pedido (idempotency_by_order_id), la firma del webhook se verifica sobre el cuerpo sin procesar, los eventos se deduplican por event_id y la extensión responde 200 solo después de guardar el pedido. El archivo incluye los archivos de idioma —entre ellos inglés, español, ucraniano y ruso— junto con un README para desarrolladores.

#Preguntas frecuentes

#¿Qué pasa si el cliente paga menos que el total del pedido?

El pedido pasa a On hold y el historial del pedido muestra al cliente cuánto falta, a qué dirección y hasta cuándo. La nota para el comercio en la pestaña CryptoLike registra qué llegó. Si el resto llega antes del plazo, el pedido pasa a Processing; después del plazo queda en revisión para que decidas: enviar el pedido, pedir el resto o reembolsar.

#¿Qué pasa si el cliente paga después de que venció el pago?

Los fondos se acreditan a tu saldo de CryptoLike y el pedido va a tu estado de revisión (On hold), nunca directo a Processing. La nota te dice qué llegó. Tú decides si completas el pedido o reembolsas al cliente con un retiro desde el panel.

#¿Cómo funcionan los reembolsos?

Los reembolsos no son automáticos, porque una transferencia en la blockchain no se puede recuperar. Pide al cliente una dirección y envía el monto como retiro desde el panel de CryptoLike. La estimación muestra la comisión de la plataforma y la comisión de red antes de que confirmes; las comisiones vigentes están en la página de precios.

#¿Qué moneda de la tienda puedo usar?

La extensión crea cada pago en la moneda del pedido: USD, EUR, UAH, GBP o CAD. CryptoLike lo convierte a la moneda cripto al tipo de cambio actual y deja ese tipo de cambio fijado hasta que el pago vence. La moneda debe estar habilitada para pagos en tu cuenta; si no, el checkout muestra «El pago con cripto no está disponible» para esa moneda.

#¿Puedo probar la extensión sin dinero real?

Sí. Activa el modo de prueba, guarda una clave ck_test_ e ingresa la URL de la API de prueba que te da el soporte de CryptoLike. Las claves de prueba funcionan con redes de prueba, y las monedas de prueba no tienen valor. El formulario rechaza una clave real en modo de prueba y una clave de prueba en modo real, y en ese caso no guarda nada, así que una tienda en producción nunca acepta pagos de prueba.

#¿Funciona con OpenCart 4.1?

Todavía no. OpenCart 4.1 es una rama aparte con su propia API de extensiones, y los paquetes actuales cubren OpenCart 3.0.x y 4.0.x. En 4.0.0–4.0.1 la extensión usa la API de métodos anterior; está implementada, pero solo 4.0.2.3 se probó de principio a fin.