Preguntas frecuentes sobre CryptoLike

CryptoLike es una plataforma de procesamiento de pagos cripto. Aquí están las preguntas que más hacen negocios y desarrolladores: cómo pasa un pago de creado a confirmado, qué activos y redes funcionan, cómo se manejan las comisiones y los retiros, qué integraciones hay y qué controles protegen una cuenta. Cada respuesta enlaza a la página con todos los detalles.

#Primeros pasos

#¿Qué es CryptoLike?

CryptoLike es una plataforma de procesamiento de pagos cripto. Los negocios reciben Bitcoin, Litecoin, Ethereum, TRON y las stablecoins USDT y USDC mediante una API REST, plugins para CMS, enlaces de pago y una página de pago alojada; reciben el resultado por webhook firmado y hacen retiros desde un solo saldo. La página sobre cómo CryptoLike recibe pagos cripto muestra el flujo completo.

#¿Pueden usar CryptoLike las personas o solo los negocios?

Ambos. CryptoLike está hecho para negocios, y las personas también pueden abrir una cuenta y usar las mismas herramientas: enlaces de pago, facturas, saldo y retiros. No hay un producto aparte para personas. Recibir pagos no requiere verificación; los retiros se habilitan con la cuenta verificada, y los negocios de sectores regulados o de mayor riesgo se revisan uno por uno. Más en la página sobre CryptoLike.

#¿Cuánto tiempo toma integrar CryptoLike?

Un primer pago en una red de prueba toma unos diez minutos: crea una clave API, llama a POST /v1/invoices desde tu servidor, envía al cliente a checkout_url y procesa un webhook firmado. En producción usas las mismas tres piezas de código; el resto del trabajo es llevar el resultado a los estados de tus pedidos. La guía rápida para desarrolladores de CryptoLike explica cada paso.

#¿Necesito operar un nodo o guardar claves privadas?

No. CryptoLike genera las direcciones, vigila las redes, cuenta las confirmaciones, consolida los fondos y firma los retiros. Tu integración es una sola API REST: crear un pago, leer su estado y recibir webhooks firmados. Los fondos confirmados llegan a tu saldo en la plataforma. Puedes limitar los retiros a una lista de direcciones permitidas y exigir una segunda aprobación para los grandes. Detalles en la guía para desarrolladores de CryptoLike.

#¿Hay un modo de prueba?

Sí. Las claves ck_test_ firman igual que las reales y funcionan con redes de prueba en la URL de la API de prueba; sus monedas no tienen valor. El soporte de CryptoLike te da la URL y las monedas. En la red principal, una clave de prueba recibe 401 auth.test_key. Separa ambas claves en tu configuración. El vector de firma de referencia muestra en una llamada si firmas bien. Consulta claves y redes de prueba.

#¿Qué forma de recibir cripto me conviene?

Depende de dónde vendes. Una tienda online en WooCommerce, OpenCart, PrestaShop o Magento 2 instala el plugin de CryptoLike. Tu propio sitio o app llama a la API o a un SDK y puede integrar la página de pago como widget. Sin sitio web, basta un enlace de pago creado en el panel o en el bot de Telegram. Compara las opciones en la página de integraciones de CryptoLike.

#Pagos y estados

#¿Qué estados puede tener un pago en CryptoLike?

Un pago avanza new → pending → paid. pending significa que se detectó una transferencia que espera confirmaciones; paid, que el monto completo está confirmado y acreditado. underpaid sigue abierto para completar el pago hasta que vence el plazo y luego es definitivo. expired (venció sin nada confirmado) y cancelled (lo cancelaste desde new) son finales. Los mismos valores aparecen en el panel, la API y los webhooks: modelo de estados del pago.

#¿Cómo sé que un pago está confirmado?

Suscribe un endpoint de webhook: cada evento de CryptoLike va firmado con HMAC-SHA256 y se reintenta con el mismo id de evento, así tu código actúa una sola vez e ignora las repeticiones. O consulta GET /v1/invoices/{id} desde tu servidor, como máximo una vez cada pocos segundos: el estado paid significa que los fondos están confirmados y acreditados en tu saldo. El contrato de webhooks lista todos los eventos.

#¿Cómo funciona un pago con precio en moneda fiat?

Crea el pago en USD, EUR u otra moneda fiat habilitada, o con un ticker cripto. El tipo de cambio se fija en cuanto se conoce la moneda (al crear el pago o cuando el pagador la elige en la página de pago) y se mantiene hasta el vencimiento. No hay margen de conversión: el monto en cripto es el precio al tipo fijado, redondeado hacia arriba a la unidad mínima. Más sobre el tipo de cambio fijado.

#¿En qué monedas fiat puedo fijar el precio?

Puedes fijar el precio en USD, EUR, UAH, GBP o CAD, o en una criptomoneda; las cinco están habilitadas por defecto en todas las cuentas. El pagador paga en cripto al tipo de cambio fijado al elegir el activo. Si dos fuentes difieren en un par más allá de un límite fijado, el pago responde 503 unavailable hasta que coincidan: nunca se usa un tipo adivinado. Otra moneda se agrega solo cuando dos fuentes independientes la cotizan.

#¿Puedo limitar las monedas que puede elegir el pagador?

Sí, en dos lugares. En la sección Monedas del panel, Para facturas decide qué monedas ofrecen tus pagos; las direcciones estáticas y los retiros no dependen de esa opción. Para un pago concreto, envía allowed_coin_ids en la API, deja menos monedas en el formulario de la factura o márcalas en la configuración del plugin. Si ninguna se puede ofrecer en esa divisa, la API responde 422 no_allowed_coins. Más en la guía de pagos cripto.

#¿Qué pasa si el cliente paga menos o más del monto?

Menos: el pago queda en underpaid, la página muestra lo que falta y el cliente puede completarlo en la misma dirección hasta que el pago venza; una diferencia dentro de la tolerancia de tu cuenta igual cuenta como paid. Más: el pago queda en paid, se te acredita toda la suma y el webhook incluye overpaid_amount para que ajustes cuentas con el cliente. Lee cómo CryptoLike maneja los pagos insuficientes.

#¿Qué pasa si el cliente paga después del vencimiento?

Los fondos se acreditan a tu saldo de todos modos. El pago conserva su estado, recibe late_payment: true y CryptoLike envía invoice.late_payment. Decide con el cliente si entregas el pedido o devuelves los fondos; los plugins para CMS pasan ese pedido a revisión y nunca lo marcan como pagado de forma automática. Para el cliente, la salida es simple: el pago venció, crea un pago nuevo. Consulta pagos vencidos.

#¿Factura o dirección estática: cuál necesito?

Una factura es un pago único por un monto fijo y con plazo: un pedido, una recarga, el cobro de una suscripción. Una dirección estática es una dirección de depósito permanente para un cliente, donde cada transferencia entrante se acredita tras las confirmaciones de ese activo: saldos, depósitos, fondeo recurrente. En CryptoLike ambas se crean con una llamada a la API y avisan por los mismos webhooks. Compáralas en direcciones estáticas.

#¿Qué pasa si se revierte una transferencia confirmada?

Si una reorganización de bloques revierte una transferencia confirmada, CryptoLike recalcula el pago y envía invoice.reverted; paid_amount baja y el estado se ajusta. Detén la entrega hasta que llegue un nuevo invoice.paid. Las direcciones estáticas reciben deposit.reverted en el mismo caso. Los plugins para CMS pasan a revisión un pedido pagado que se revirtió, para que no se envíe. La regla es parte del modelo de estados del pago.

#Activos y redes

#¿Qué activos puedo recibir?

Con CryptoLike recibes Bitcoin (BTC), Litecoin (LTC), Ethereum (ETH) con los tokens ERC20 USDT y USDC, y TRON (TRX) con USDT en TRC20. El catálogo activo lo entrega GET /v1/currencies; cada activo muestra su red y su umbral de confirmaciones antes de usarlo, y puedes desactivar activos individuales en el panel, del todo o solo para facturas. La lista con redes está en monedas compatibles.

#¿Cuánto tarda en confirmarse un pago?

Depende del activo: cada uno tiene un umbral de confirmaciones definido en el catálogo de CryptoLike (GET /v1/currencies), y la página de pago lo muestra como «n de N confirmaciones, normalmente unos X min». El pagador ve «Pago detectado» en cuanto la transferencia está en la red y «Pago confirmado» al alcanzar el umbral; en ese momento, los fondos se acreditan en tu saldo. Más en confirmaciones de pagos cripto.

#¿USDT en TRC20 o ERC20: cuál debo recibir?

En CryptoLike son dos activos: USDT en TRON (TRC20) y USDT en Ethereum (ERC20), cada uno con su dirección, umbral de confirmaciones y comisiones. El pagador cubre la comisión de red: energía y ancho de banda en TRX en TRON, gas en ETH en Ethereum. Las direcciones TRON empiezan con «T»; las de Ethereum, con «0x». Puedes activar ambos y que el cliente elija en la página de pago. Lee USDT TRC20 vs ERC20.

#¿Qué pasa si el cliente envía fondos por la red equivocada?

Una transferencia por otra red nunca llega al pago. La página de pago de CryptoLike muestra la red junto al activo y la dirección, marca con una insignia de red los íconos de los tokens y advierte antes del envío. En Bitcoin y Litecoin las direcciones de prueba difieren de las reales; en TRON y Ethereum no, así que revisa la red también en pruebas. La lista de activos y redes indica la red de cada activo.

#Comisiones

#¿Cuánto cobra CryptoLike?

La comisión estándar es 0.8 % de cada pago entrante confirmado, con el mínimo del activo: 0.6 USDT en TRON (unos US$0.6 en BTC, LTC o TRX), 2 USDT o USDC en Ethereum (unos US$2 en ETH). Los retiros no pagan comisión de la plataforma, salvo 1 USDT fijo para USDT en TRON; pagas la comisión de red sin recargo. Un precio en USD o EUR se convierte sin margen. Todos los mínimos están en la página de precios.

#¿Por qué hay una comisión mínima?

Porque reunir un pago cuesta casi lo mismo sea cual sea su monto. Cada pago pasa de su dirección a la billetera de la plataforma en una transacción de red que paga la plataforma, más cara en Ethereum que en TRON o Bitcoin. El mínimo decide por debajo de 75 USDT en TRON y de 250 USDT en Ethereum; por encima, solo el 0.8 %. Un envío menor que el mínimo queda entero como comisión. Mínimos exactos: tabla de comisiones.

#¿Cómo se muestran las comisiones?

Como un monto concreto con su unidad: en la estimación previa al retiro, en la respuesta de la API y en el panel. La página de pago muestra un solo monto; si el pagador asume la comisión, ya va incluida. CryptoLike cobra la comisión de la plataforma, definida por activo, solo al confirmarse un pago; cada transacción muestra monto bruto, comisión y neto. Comisiones vigentes en la página de precios de CryptoLike.

#¿Cuándo se cobra la comisión de la plataforma?

Solo cuando se confirma un pago, con la comisión vigente al crearlo: un cambio de comisiones nunca recalcula un pago existente. Crear un pago no tiene costo, y un pago vencido o cancelado no se cobra. La comisión de la plataforma de CryptoLike se define por activo y por sentido: pagos entrantes y retiros. Cada transacción muestra el amount bruto, la fee y el net_amount. Las comisiones vigentes están en la página de precios.

#¿Quién paga la comisión de la plataforma, el comercio o el cliente?

Por defecto, el comercio: fee_paid_by es merchant y la comisión de la plataforma se descuenta de lo que recibes. Con fee_paid_by: payer en el pago, CryptoLike suma la comisión al monto: payer_amount es lo que el cliente debe enviar y amount_crypto, lo que tú recibes. Los dos montos solo difieren en ese caso. Consulta comisión de la plataforma.

#¿Cómo se calcula la comisión de red de un retiro?

Antes de un retiro, POST /v1/withdrawals/estimate devuelve la comisión de la plataforma, la comisión de red reservada y el débito total; la reserva es la estimación de la red, sin recargo. CryptoLike cobra la estimación reservada (por defecto) o la comisión que realmente se pagó en la red (network_fee_mode: actual); en ese caso, la reserva no usada vuelve a tu saldo disponible. Si no hay estimación disponible, el retiro no se crea. Más sobre la comisión de red.

#Retiros

#¿Cómo hago un retiro?

Pide a POST /v1/withdrawals/estimate las comisiones y el débito total, y crea el retiro con POST /v1/withdrawals o en el panel. CryptoLike retiene todo el débito total, y el retiro avanza pending → processing → broadcast → completed. Una clave API necesita el permiso withdraw; en el panel, cada retiro se confirma con un código de verificación en dos pasos (2FA). Los estados y errores están en la referencia de la API.

#¿Cómo funcionan los pagos masivos?

Sube en el panel de CryptoLike un CSV de hasta 1,000 filas con el formato address,amount[,payout_id[,comment]]. Cada fila se revisa antes de crear nada: una fila con error rechaza todo el archivo con un informe de fila, campo y error, y no se paga nada. Un archivo válido se confirma con un solo código 2FA para todo el lote. Por la API, los retiros van uno por uno con payout_id. Sigue la guía de pagos masivos.

#¿Una solicitud de retiro repetida puede pagar dos veces?

No, si envías tu propio payout_id. Repetir la solicitud con la misma moneda, monto y dirección devuelve el retiro existente de CryptoLike en lugar de crear uno nuevo; el mismo payout_id con otros parámetros se rechaza con 409. Para recibir exactamente la primera respuesta, agrega un Idempotency-Key. Las reglas están en la referencia de la API.

#¿Por qué mi retiro está en revisión?

Un retiro pasa a review cuando necesita una revisión manual: se superó un límite, el patrón es inusual (una dirección nueva, una ráfaga de retiros), tu cuenta está en modo manual o el destino requiere una verificación de cumplimiento. La revisión suele terminar en menos de 24 horas y, mientras tanto, los fondos quedan retenidos. Luego CryptoLike continúa el retiro o lo rechaza y devuelve el monto completo a tu saldo disponible. Consulta pagos masivos.

#¿Qué pasa si un retiro falla o se cancela?

Retiro fallido: la red rechazó o descartó la transacción, y todo el débito total vuelve a tu saldo disponible; failure_reason indica el motivo. Crea un retiro nuevo. Un retiro rechazado en revisión se devuelve igual. Puedes cancelar tú mismo un retiro de CryptoLike mientras está en pending, review o awaiting_approval; desde processing ya no se puede cancelar. Los estados están en la referencia de la API.

#¿Necesito una cuenta verificada para hacer retiros?

Sí. CryptoLike envía retiros solo desde una cuenta verificada: hasta completar la verificación de la cuenta (KYB), una solicitud de retiro responde 403 kyb_required. Sube los documentos en el panel y espera la revisión; los pasos están en verificación KYB para comercios. Recibir pagos, incluidos los enlaces de pago, no espera a la verificación. El caso de uso de pagos masivos lista todo lo que necesita un retiro.

#Integraciones

#¿Qué plataformas tienen plugin de CryptoLike?

CryptoLike tiene un plugin para WooCommerce (checkout en bloques y clásico), una extensión para OpenCart 3 y 4, un módulo para PrestaShop 1.7.8 y 8 y un módulo para Magento 2. Cada plugin necesita una clave API solo con create_invoice y read; una tienda nunca necesita withdraw. Todas las opciones están en la página de integraciones.

#¿Cómo actualiza el plugin de CryptoLike el estado del pedido?

El pedido se crea como pendiente de pago. Un pago confirmado lo pasa a procesando (o al estado que elijas); uno insuficiente queda en espera mientras el cliente puede completarlo; un pago vencido cancela el pedido o lo deja pendiente, según configures. El dinero que necesita una decisión humana, como un pago tardío o una reversión, va a revisión y nunca se marca como pagado automáticamente. Consulta el plugin para WooCommerce.

#¿Puedo recibir cripto sin sitio web?

Sí. Crea un pago en el panel de CryptoLike o en el bot de Telegram con el comando /invoice y comparte el enlace: cópialo o envíalo directo por mensajería. El cliente abre la misma página de pago que usan las tiendas online, con el monto, la red, la dirección y el tiempo restante. Sigue el estado en el panel o recibe un mensaje de Telegram cuando se confirme. Lee sobre los enlaces de pago.

#¿Puedo mantener la página de pago dentro de mi propio checkout?

Sí. El widget de checkout de CryptoLike integra la misma página de pago en un iframe con un cargador de unos 5 KB y avisa los cambios de estado a tu página mediante postMessage. Agrega tu origen a la lista de orígenes permitidos en el panel; el navegador recibe el id de la factura y nada más. Entrega el pedido con el webhook, no con mensajes del navegador. Detalles en la guía del widget de checkout.

#Para desarrolladores

#¿Cómo proceso un webhook exactamente una vez?

Verifica la firma HMAC-SHA256 sobre el cuerpo sin procesar y luego busca event_id en tu almacenamiento: si ya lo viste, responde 2xx y detente. CryptoLike entrega al menos una vez y reintenta seis veces durante unas 31 horas, así que los duplicados son esperables, no un error. Responde en menos de 10 segundos y procesa después. Paso a paso: verificar webhooks de pagos cripto.

#¿Cómo verifico la firma de un webhook de CryptoLike?

Calcula "sha256=" + hex(HMAC-SHA256(secret, X-Timestamp + "." + raw_body)) con el secreto de tu endpoint y compáralo con X-Signature en tiempo constante. Usa los bytes tal como llegaron, nunca JSON serializado de nuevo, y rechaza marcas de tiempo que se alejen de tu reloj más de unos minutos, hacia adelante o hacia atrás; los SDK aceptan 300 segundos. Un vector de prueba de referencia revisa tu código en una ejecución. Consulta el contrato de webhooks.

#¿Qué SDK ofrece CryptoLike?

Cuatro SDK de servidor: TypeScript para Node.js 18+, Python 3.10+, Go 1.23+ y PHP 7.4 a 8.x. Cada uno firma las solicitudes, agrega un Idempotency-Key a cada POST, reintenta sin duplicar operaciones y verifica webhooks. Son versiones preliminares: instálalos desde el repositorio de CryptoLike, todavía no desde npm, PyPI ni Packagist. El secreto se queda en tu servidor. Consulta la documentación de los SDK.

#¿Cómo evitan los reintentos crear un segundo pago?

Envía un Idempotency-Key con cada POST: una solicitud repetida devuelve la respuesta original de CryptoLike durante 24 horas, y un cuerpo distinto con la misma clave se rechaza con 422. Las tiendas también pueden enviar idempotency_by_order_id: true con order_id: una repetición para el mismo pedido devuelve su pago abierto en lugar de crear otro. Más sobre la clave de idempotencia.

#Cuenta y seguridad

#¿Qué puede hacer una clave API de CryptoLike?

Cada clave tiene permisos (read, create_invoice, create_address y withdraw), un límite de solicitudes (600 por minuto por defecto, ajustable por clave) y, si quieres, una lista de IP permitidas. Sin el permiso o desde otra IP, la solicitud responde 403; por encima del límite, 429. Da a cada clave solo lo que necesita: un plugin de tienda usa create_invoice y read. El secreto se muestra una vez. Consulta autenticación de la API.

#¿Cómo roto o revoco una clave API?

En el panel de CryptoLike, Rotar emite un secreto nuevo y lo muestra una vez; el anterior sigue funcionando 10 minutos para que despliegues sin interrupciones. Desactivar detiene una clave hasta que la vuelvas a activar. Revocar es definitivo: la clave deja de funcionar de inmediato y hay que crear otra. Cada cambio queda en el registro de seguridad del equipo con la persona que lo hizo. Consulta autenticación de la API.

#¿Cómo funciona la lista de direcciones permitidas para retiros?

Agregas una dirección de retiro en el panel de CryptoLike con un código 2FA nuevo, y se activa solo después de un plazo: una sesión robada no puede desviar retiros de inmediato. Quitar una dirección surte efecto enseguida. Cuando la lista es obligatoria, los retiros desde el panel y con claves API van solo a direcciones permitidas activas; lo demás responde 403. Lee sobre la lista de direcciones permitidas.

#¿Cómo funciona la segunda aprobación de retiros grandes?

Cuando un retiro creado en el panel supera el umbral de tu cuenta, espera en awaiting_approval. Otro propietario o administrador de la cuenta, no quien lo creó, lo confirma en el panel de CryptoLike con un código 2FA; hasta entonces, los fondos quedan retenidos. Los retiros con una clave API con withdraw no esperan esta aprobación, así que otorga ese permiso con cuidado. Consulta segunda aprobación.

#¿Cuándo pide CryptoLike un código 2FA?

Cuando se mueve dinero o se abre un destino nuevo. El panel pide un código nuevo al crear un retiro, confirmar un lote CSV (un código por archivo), dar una segunda aprobación, agregar una dirección permitida, cambiar la configuración de retiros o dar withdraw a una clave API; el bot de Telegram, en los retiros. Quitar una dirección no pide código; los retiros por API usan el permiso de la clave. Detalles en la guía de pagos masivos.

#¿Cómo protege CryptoLike los fondos de mi saldo?

Las claves privadas viven en un servicio de firma aparte, inaccesible para la API, que solo firma retiros en proceso con su retención en el libro contable. El excedente va al almacenamiento en frío solo con aprobación 2FA de un operador. Los retiros del panel piden un código 2FA nuevo; los de la API, una clave con withdraw. La lista de direcciones permitidas y la segunda aprobación son opcionales. Todos los controles están en la página de seguridad.