Ir al contenido

Casos de uso

Acepta pagos con criptomonedas en tu tienda online

Acepta Bitcoin, USDT y otras criptomonedas en WooCommerce, OpenCart, PrestaShop o Magento: el pedido avanza solo cuando el pago se confirma.

CryptoLike convierte un pago cripto en un estado de pedido. El cliente elige pagar con criptomonedas, paga en la página de pago y, cuando el pago se confirma, el pedido pasa al estado que elegiste: en WooCommerce, OpenCart, PrestaShop, Magento 2 o en tu propio sitio. Si todavía estás eligiendo proveedor, empieza por las 10 preguntas para elegir una pasarela de pagos cripto.

¿Por qué cuesta conectar las cripto a los pedidos de una tienda?

Para una tienda en línea, lo difícil de las cripto no es la billetera, sino mantener correcto el estado de cada pedido. Una transferencia necesita confirmaciones antes de contar, y el cliente puede enviar de menos, pagar después del plazo o pulsar «Pagar» dos veces. CryptoLike cubre cada uno de estos casos, así que nadie de tu equipo tiene que revisar un explorador de bloques antes de enviar un pedido.

Casos típicos: un pago insuficiente porque la billetera descontó su comisión del monto, un pago tardío, un pago excedente, una transferencia revertida por una reorganización de la red y un doble clic que intenta crear un segundo pago.

Cómo CryptoLike conecta los pagos con los pedidos

CryptoLike crea un pago por cada pedido, lleva al cliente a una página de pago e informa cada cambio con un webhook firmado. El plugin aplica ese webhook al pedido: una transferencia detectada mantiene el pedido en espera, un pago confirmado lo pasa a tu estado de pagado y el dinero que requiere una decisión va a revisión.

  1. Se hace el pedido en estado «pendiente de pago», y el plugin crea un pago por el total del pedido en la moneda del pedido (USD, EUR, UAH, GBP o CAD, todas habilitadas por defecto).
  2. El cliente paga en la página de pago: activo y red, monto, dirección con código QR, tiempo restante y estado en vivo. Si el plugin deja la moneda abierta, el cliente primero elige una de las monedas disponibles para facturas, cada una con un monto aproximado marcado con ≈; la lista de monedas del plugin puede limitar esa elección, y los íconos de USDT y USDC llevan una insignia de su red. El widget de pago puede mostrar la misma página dentro del proceso de compra de tu tienda.
  3. Llega el webhook. El plugin verifica su firma, lo aplica una sola vez por event_id y responde 200 solo después de guardar el estado del pedido.

¿Qué estado de pedido corresponde a cada estado de pago?

Todos los plugins de CryptoLike siguen un mismo contrato, así que un estado de pago se convierte en el mismo estado de pedido en todos los CMS. Un estado inferior nunca reemplaza a uno superior: un evento «pago detectado» reenviado que llega después de «pagado» no cambia nada. El dinero que necesita la decisión de una persona va a revisión, nunca a pagado. Los estados exactos del CMS los eliges en la configuración del plugin.

Pago Pedido
pending Sigue esperando; el cliente ve «Pago detectado. Esperando confirmación.»
paid Tu estado de pagado (por defecto, Procesando en WooCommerce y OpenCart)
underpaid, antes del plazo En espera; el cliente completa el pago en la misma dirección
underpaid, después del plazo Revisión: enviar, pedir el resto o reembolsar
expired Cancelado, o pendiente si así lo prefieres
Pago tardío Revisión; los fondos ya están en tu saldo
Revertido después de paid Revisión: no enviar

¿Qué plataformas admite CryptoLike?

CryptoLike tiene plugins para cuatro plataformas CMS, y las tiendas con código propio usan la API REST o un SDK. Todas las opciones usan la misma página de pago, los mismos estados y los mismos webhooks. Las versiones son las que indica la documentación de cada plugin.

Plataforma Versiones Cómo se conecta
Plugin para WooCommerce WooCommerce 7.0+, WordPress 6.1+, PHP 7.4–8.4; checkout por bloques y clásico Plugin
Extensión para OpenCart 3.0.x y 4.0.x Extensión
Módulo para PrestaShop 8.x; mínimo declarado: 1.7.8 Módulo
Módulo para Magento 2 2.4.6+, PHP 8.1–8.4, checkout Luma Módulo
Sitio propio API REST y SDK Tu código

Cómo conectar tu tienda

Conectar una tienda con CMS a CryptoLike lleva cinco pasos y no requiere desarrollador. El modo de prueba necesita una clave ck_test_ y la URL de la API de prueba en la configuración del plugin (la predeterminada es la de producción; pide la URL de prueba a soporte de CryptoLike); las claves de prueba funcionan con redes de prueba. El plugin rechaza una clave cuyo prefijo no coincide con el modo, así que una tienda real no puede recibir pagos de prueba por error.

  1. Descarga el archivo desde la página de la integración y súbelo en el panel de administración de tu tienda.
  2. Pide a soporte de CryptoLike acceso al entorno de prueba y, en el panel de ese entorno, crea una clave API ck_test_ con dos permisos: create_invoice y read.
  3. Pega el ID y el secreto de la clave (en modo de prueba, también la URL de la API de prueba) en la configuración del plugin y pulsa «Comprobar la conexión».
  4. Agrega la URL del webhook del plugin como endpoint en ese mismo panel, con todos los eventos invoice.*, y pega su secreto en el plugin.
  5. Haz un pedido de prueba y págalo en una red de prueba. Después repite los pasos 2–4 en tu propio panel con una clave real y la URL de la API predeterminada.

Más detalles: la guía para aceptar pagos con criptomonedas, las monedas compatibles y la comisión de la plataforma en la página de precios.

Preguntas frecuentes

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

El pago pasa a underpaid y el pedido queda en espera. El cliente ve el monto que falta y puede completarlo en la misma dirección hasta el plazo. Si el resto llega a tiempo, el pedido pasa a pagado. Si no, va a revisión para que tú decidas.

¿Y si el cliente paga después de que el pago venció?

CryptoLike acredita los fondos en tu saldo y envía invoice.late_payment. El plugin pasa el pedido a revisión en lugar de a pagado: tú decides si lo entregas o si reembolsas el dinero.

¿Un doble clic puede crear dos pagos para un mismo pedido?

No. Los plugins crean los pagos con idempotency_by_order_id, así que una solicitud repetida para el mismo pedido devuelve su pago abierto en lugar de crear otro. Recargar la página, hacer doble clic o pulsar «Pagar por el pedido» más tarde abre la misma página de pago, y un pedido que ya recibió dinero nunca obtiene un pago nuevo.

Formas de conectar

En la documentación →

Guías y artículos

Términos usados aquí

Empieza con un pago de prueba

Crea una cuenta, pide a soporte el entorno de prueba y mira cómo un pago pasa de pending a paid en una red de prueba.