# Cómo recibir pagos con criptomonedas en tu sitio web: 3 formas comparadas

> Tres formas de recibir pagos con criptomonedas con CryptoLike: plugin para CMS, API o SDK con widget y enlace de pago. Pasos, comparación y errores.

Source: https://cryptolike.net/es/guides/accept-crypto-payments
Published: 2026-09-25 · Updated: 2026-10-11 · Author: CryptoLike team

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](https://cryptolike.net/integrations). Los escenarios de tiendas están en [pagos cripto para tiendas online](https://cryptolike.net/es/use-cases/online-stores), los servicios con backend propio en [pagos cripto para bienes digitales y SaaS](https://cryptolike.net/use-cases/digital-goods) y las recargas de saldo en [depósitos a direcciones estáticas](https://cryptolike.net/es/use-cases/deposits). Código paso a paso para tu propio backend: [PHP](https://cryptolike.net/es/guides/accept-crypto-payments-php), [Node.js](https://cryptolike.net/es/guides/accept-crypto-payments-nodejs) y [Python](https://cryptolike.net/es/guides/accept-crypto-payments-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](https://cryptolike.net/es/coins). 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](https://cryptolike.net/es/integrations/woocommerce), [OpenCart](https://cryptolike.net/es/integrations/opencart), [PrestaShop](https://cryptolike.net/es/integrations/prestashop) o [Magento 2](https://cryptolike.net/es/integrations/magento) 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](https://cryptolike.net/docs/widget). Los [SDK](https://cryptolike.net/docs/sdk) para TypeScript, Python, Go y PHP firman las solicitudes y agregan un `Idempotency-Key`; son versiones preliminares y se instalan desde el repositorio.

```ts
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_url
```

**Un 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](https://cryptolike.net/es/use-cases/payment-links).

## 4. Conoce el resultado con un webhook firmado

CryptoLike informa el resultado con un [webhook](https://cryptolike.net/es/glossary/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](https://cryptolike.net/es/glossary/webhook-signature) sobre el cuerpo sin procesar (consulta [cómo verificar los webhooks de pagos cripto](https://cryptolike.net/guides/verify-crypto-payment-webhooks)) y entrega el pedido con `paid`; los demás estados están en el [modelo de estados](https://cryptolike.net/docs#status-model). ¿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](https://cryptolike.net/es/guides/test-crypto-payments).

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](https://cryptolike.net/blog/ecommerce-crypto-checklist).

## 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](https://cryptolike.net/docs/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](https://cryptolike.net/docs/auth) |
| `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](https://cryptolike.net/es/pricing).