CryptoLike le da a tu sitio web tres formas de recibir pagos con criptomonedas: un plugin para WooCommerce, OpenCart, PrestaShop o Magento 2; la API REST o un SDK con una página de pago alojada o integrada en tu sitio; y un enlace de pago desde el panel o desde Telegram. Todas terminan igual: un pago confirmado y un estado con el que tu equipo puede actuar.
Las tres formas de un vistazo
CryptoLike usa la misma página de pago y los mismos estados de pago en cada forma de aceptar cripto; lo que cambia es quién hace la configuración. Un plugin para CMS no necesita desarrollador, la API le da control total a un equipo de backend y un enlace de pago no necesita sitio web. Los tiempos suponen una cuenta ya registrada y un pago de prueba.
| Forma | Para quién es | Qué necesitas | Tiempo hasta el primer pago | Cómo conoces el resultado |
|---|---|---|---|---|
| Plugin para CMS | Tiendas en WooCommerce, OpenCart 3/4, PrestaShop, Magento 2 | Acceso al administrador de la tienda por https, una clave API, un endpoint de webhook | 30–60 minutos | El estado del pedido cambia solo |
| API o SDK, página alojada o widget | Equipos con backend propio: marketplaces, SaaS, apps | Un servidor que guarde el secreto, una clave API, un endpoint https | Unos 10 minutos hasta un pago de prueba, 1–3 días hasta el lanzamiento | Webhooks invoice.* firmados o GET /v1/invoices/{id} |
| Enlace de pago | Freelancers, facturas B2B, ventas por mensajería | Una cuenta en el panel; si quieres, el bot de Telegram | 5 minutos | El panel y un mensaje de Telegram |
Las descargas y los detalles de cada forma están en la página de integraciones. Los escenarios de tiendas están en pagos cripto para tiendas online, los servicios con backend propio en pagos cripto para bienes digitales y SaaS y las recargas de saldo en depósitos a direcciones estáticas. Código paso a paso para tu propio backend: PHP, Node.js y Python.
Antes de empezar
Para CryptoLike necesitas una cuenta en el panel, la lista de activos que quieres aceptar y, para un plugin o la API, un sitio servido por https. Solo los retiros requieren la verificación de la cuenta (KYB); los pagos, los enlaces de pago y los plugins funcionan sin ella, así que inicia la verificación con tiempo solo si piensas hacer retiros. Prueba primero con claves de prueba (ck_test_) y redes de prueba.
Los activos son Bitcoin, Litecoin, Ethereum con USDT y USDC en ERC20, y TRON con USDT en TRC20. La red y el umbral de confirmaciones de cada uno están en GET /v1/currencies y en la página de activos disponibles. En la sección Monedas del panel, Activada habilita un activo en tu cuenta y Para facturas decide si los pagos lo ofrecen.
1. Elige la forma que se ajusta a cómo vendes
Elige la forma de CryptoLike según dónde te pagan hoy tus clientes. Una tienda en WooCommerce, OpenCart, PrestaShop o Magento 2 instala el plugin; un sitio o una app con backend propio usa la API o un SDK; un negocio sin sitio web envía enlaces de pago. Todas acreditan el mismo saldo.
¿Todavía no lo tienes claro? Crea un enlace de pago: en cinco minutos ves la página de pago y los estados que verán tus clientes.
2. Crea una clave API en modo de prueba
CryptoLike identifica a un plugin o a tu servidor con una clave API: en el panel abre Desarrolladores → Claves API, crea una clave con los permisos create_invoice y read y copia el secreto, que se muestra una sola vez. Una clave ck_test_ funciona con las redes de prueba a través de la URL de la API de prueba que te da el soporte de CryptoLike (en la red principal recibe 401 auth.test_key); los enlaces de pago no necesitan clave.
Guarda el secreto en el servidor, nunca en una página web ni en una app. ¿Lo perdiste? Crea una clave nueva, cambia la integración a ella y revoca la anterior.
3. Conecta el flujo de pago
CryptoLike crea un pago de la misma manera en todos los flujos: un monto, una moneda (USD, EUR, UAH, GBP o CAD, o el ticker de una moneda cripto) y la referencia de tu pedido generan un pago con checkout_url. Si no fijas el activo con coin_id, el pagador lo elige en esa página entre las monedas disponibles para facturas, y cada una muestra un monto aproximado marcado con ≈; allowed_coin_ids o la lista de monedas del plugin limita la elección para un pago. El tipo de cambio queda fijado al elegir, durante toda la vigencia del pago, y la página muestra el monto, la red, la dirección, el código QR y el tiempo restante.
Un plugin para CMS. Sube el archivo de WooCommerce, OpenCart, PrestaShop o Magento 2 en el panel de administración de la tienda, pega el ID de la clave y el secreto y pulsa «Comprobar la conexión». Agrega la URL de webhook del plugin como endpoint en Desarrolladores → Webhooks con todos los eventos invoice.* y pega el secreto del endpoint de vuelta en el plugin: el plugin envía webhook_url con cada pago, así que sin un endpoint activo no se puede crear ningún pago. Un doble clic o una recarga devuelve el pago abierto del pedido en lugar de crear un segundo.
La API o un SDK. Tu servidor llama a POST /v1/invoices y envía al cliente a checkout_url, o lo mantiene en tu página con el widget de pago. Los SDK para TypeScript, Python, Go y PHP firman las solicitudes y agregan un Idempotency-Key; son versiones preliminares y se instalan desde el repositorio.
const invoice = await api.invoices.create(
{ amount: "10.50", currency: "USD", order_id: "A-1001" },
"order-A-1001", // Idempotency-Key: un reintento devuelve el mismo pago
);
// redirige al cliente a invoice.checkout_urlUn enlace de pago. En el panel abre Facturas → Crear factura, ingresa el monto, la moneda y una descripción, y luego copia el enlace o envíalo por mensajería. En el bot de Telegram, el comando /invoice hace lo mismo. Consulta enlaces de pago.
4. Conoce el resultado con un webhook firmado
CryptoLike informa el resultado con un webhook firmado con HMAC-SHA256: invoice.paid significa que los fondos están confirmados y acreditados en tu saldo. Tu endpoint responde 2xx en 10 segundos; una entrega fallida se reintenta después de 1 min, 5 min, 15 min, 1 h, 6 h y 24 h con el mismo event_id, así que procesa cada evento una sola vez.
Los plugins aplican estos eventos por ti. Con la API, verifica la firma del webhook sobre el cuerpo sin procesar (consulta cómo verificar los webhooks de pagos cripto) y entrega el pedido con paid; los demás estados están en el modelo de estados. ¿Tu manejador de webhooks rechaza entregas reales? Lo más probable es que tenga el secreto de endpoint equivocado. El secreto se muestra una sola vez, así que rótalo en Desarrolladores → Webhooks y despliega el valor nuevo.
5. Haz un pago de prueba y sal a producción
Los pagos de prueba de CryptoLike corren en redes de prueba: las monedas de prueba no tienen valor y el soporte de CryptoLike te puede enviar algunas. Envía el monto exacto a la dirección de la página de pago y observa cómo el estado pasa de pending a paid. Después cambia el plugin o tu servidor a una clave de producción y quita las claves de prueba y la URL base de prueba de la configuración de producción. El ensayo completo, estado por estado, está en cómo probar pagos con criptomonedas.
Paga de menos a propósito una vez, por más de 0.5 %, para ver underpaid (Pago insuficiente), y deja vencer un pago para ver expired (Vencido). Una tienda en un CMS puede seguir la lista de verificación completa para lanzar una tienda online.
Errores y qué hacer
CryptoLike responde cada error de la API con el mismo formato: un estado HTTP, un code legible por máquina, un message para personas y details que nombran el problema. Decide según code y corrige lo que indique details.field o details.reason. Estos son los errores que una integración nueva encuentra con más frecuencia; la lista completa está en la referencia de la API.
| HTTP · código | Qué pasó | Qué hacer |
|---|---|---|
400 validation_error, campo currency |
La moneda del pedido no está habilitada en tu cuenta | Pon el precio en un código de GET /v1/fiat-currencies (por defecto USD, EUR, UAH, GBP, CAD) o en cripto |
401 auth.invalid_signature |
La firma de la solicitud no coincide | Compara tu firma con el vector de referencia en autenticación de la API |
403 auth.permission_denied |
A la clave le falta un permiso (details.required) |
Crea una clave con create_invoice y read |
409 conflict, order_invoice_mismatch |
El pedido se modificó después de crear su pago | Cancela el pago abierto (details.invoice_id) mientras esté en new y crea uno nuevo |
409 conflict, order_has_payment |
El pedido ya recibió fondos | No crees otro pago; resuelve el pedido manualmente |
422 no_allowed_coins |
Ninguna moneda de allowed_coin_ids (o de la lista del plugin) está disponible para facturas en esta divisa |
Elige otras monedas o activa Para facturas en una de ellas, en la sección Monedas del panel |
429 rate_limited |
Demasiadas solicitudes con esta clave (600/min por defecto) | Espera los segundos que indica Retry-After |
503 unavailable |
La fuente del tipo de cambio o el activo no está disponible por ahora | Reintenta con espera progresiva o crea el pago en cripto |
Preguntas frecuentes
¿Puedo recibir pagos con criptomonedas sin un sitio web?
Sí. Un enlace de pago de CryptoLike no necesita sitio web ni código: crea un pago en el panel o con /invoice en el bot de Telegram y envía el enlace. El cliente llega a la misma página de pago que usan las tiendas online, y tú ves el estado en el panel o en un mensaje de Telegram.
¿Qué forma se pone en marcha más rápido?
Un enlace de pago toma unos 5 minutos, un plugin para CMS de 30 a 60 minutos y una integración por API de 1 a 3 días, con un pago de prueba primero. Un primer pago de prueba por la API toma unos 10 minutos.
¿Cuánto cuesta?
CryptoLike cobra una comisión de la plataforma por activo solo cuando un pago se confirma y se acredita; crear un pago no tiene costo. Las comisiones vigentes están en la página de precios.