Para probar pagos con criptomonedas en CryptoLike, usa su entorno de prueba: un panel y una API aparte que funcionan con redes de prueba, donde las monedas no tienen valor. Pide a soporte de CryptoLike el acceso y la URL de la API de prueba, crea ahí una clave ck_test_, configura esa URL en tu código o plugin y lleva pagos de prueba por cada estado antes de pasar a una clave real.
No hay un modo de prueba dentro de producción. La API de producción funciona con las redes principales y rechaza de entrada las claves de prueba, así que una configuración de prueba olvidada falla con un error visible en lugar de aceptar pagos falsos sin avisar. Qué es una red de prueba y por qué sus monedas no tienen valor se explica en el glosario.
En qué se diferencian producción y prueba
CryptoLike ejecuta cada entorno con un solo tipo de red: producción, con las redes principales; el entorno de prueba, con redes de prueba. La red que usa un pago la decide el entorno, no la clave.
| Aspecto | Producción | Entorno de prueba |
|---|---|---|
| Redes | Redes principales, fondos reales | Redes de prueba, monedas sin valor |
Clave ck_live_ |
Funciona | Funciona, pero solo mueve monedas de prueba |
Clave ck_test_ |
No se emite; cada solicitud se rechaza con 401 auth.test_key |
Funciona |
| URL de la API | La predeterminada en los SDK y plugins | La entrega el soporte de CryptoLike |
| Panel | Tu cuenta de producción | Una cuenta aparte en el panel de prueba |
| Página de pago, estados, webhooks | Según la documentación | Igual; las confirmaciones siguen las mismas reglas |
| Enlaces al explorador junto a una transacción | Abren la transferencia | Abren un explorador de la red principal, que muestra «not found» para una transferencia de prueba |
Las claves no pasan de un entorno a otro: una clave de un entorno recibe 401 auth.invalid_key en el otro, sea cual sea su prefijo.
1. Consigue acceso al entorno de prueba
Escribe a soporte de CryptoLike y pide el entorno de prueba. Recibes acceso a su panel y la URL de la API de prueba. Las monedas de prueba no tienen valor y no se pueden mover a una red principal.
Haz tus pagos de prueba con activos de Ethereum y TRON: ETH, TRX y los tokens USDT y USDC. Sus redes de prueba son públicas, así que una billetera configurada en la red de prueba puede pagar y las confirmaciones llegan solas. Bitcoin y Litecoin no funcionan en el entorno de prueba con una red de prueba pública, y una billetera normal no puede pagarlos. Los estados, los webhooks y la página de pago funcionan igual para todos los activos, así que los escenarios de abajo cubren tu integración igualmente.
Las direcciones de prueba de Bitcoin y Litecoin empiezan con un prefijo distinto al de la red principal. En Ethereum y TRON, una dirección de prueba se ve exactamente igual que una de la red principal. Por eso, distingue los entornos por el panel y la URL de la API, nunca por la dirección.
2. Crea una clave API de prueba
En el panel de prueba, abre Desarrolladores → Claves API → «Crear clave» y, en «Modo», elige «Prueba». El formulario lo explica así: «Este entorno usa redes de prueba: tanto las claves de prueba como las reales mueven solo monedas de prueba». En ese panel, la primera clave viene en modo de prueba y se llama «Primera clave de prueba».
Dale a la clave los mismos permisos que tendrá tu integración en producción, por ejemplo create_invoice y read, y guarda el secreto solo en tu servidor: se muestra una sola vez. En el panel de producción, la opción «Prueba» aparece desactivada, y si intentas crear una clave así por la API, la respuesta es 400 validation_error en el campo mode.
3. Apunta tu integración a la URL de la API de prueba
Cada cliente de CryptoLike lee la dirección de la API de un solo ajuste. Cambiar de entorno significa cambiar una URL y una clave, no el código.
| Cliente | Dónde va la URL |
|---|---|
| SDK de TypeScript | Opción baseUrl |
| SDK de Python | Opción base_url |
| SDK de Go | Options.BaseURL |
| SDK de PHP | Opción 'base_url' |
| Todos los SDK, o curl | Variable de entorno CRYPTOLIKE_API_URL |
| WooCommerce, OpenCart, PrestaShop, Magento | «Modo de prueba» activado y campo «URL de la API» |
Sin una URL explícita, los SDK usan https://api.cryptolike.net, la API de producción. Con una clave ck_test_, eso significa 401 auth.test_key en la primera solicitud, y ese error te recuerda configurar la URL. La referencia de los SDK lista las demás variables; la firma de solicitudes está en autenticación de la API.
En un plugin de tienda, activa «Modo de prueba» y pega la URL de la API de prueba. El plugin compara el prefijo de la clave con el modo («El modo de prueba requiere una clave ck_test_; el modo real requiere una clave real»), muestra la insignia «Modo de prueba» en sus ajustes y, junto al método de pago, avisa a los compradores: «Modo de prueba: monedas de red de prueba, sin fondos reales». La configuración de cada CMS está en la página de WooCommerce y en las demás páginas de integraciones.
4. Revisa tu endpoint de webhook con un evento de prueba
Registra tu endpoint en el panel de prueba, en Desarrolladores → Webhooks, y haz clic en «Enviar evento de prueba». CryptoLike pone en cola un evento ping, firmado y reintentado como cualquier otro evento; la respuesta de tu servidor aparece en el registro de entregas.
Tu endpoint debe responder con un estado 2xx en 10 segundos. Una entrega fallida se reintenta después de 1 minuto, 5 minutos, 15 minutos, 1 hora, 6 horas y 24 horas. Verifica el encabezado X-Signature antes de confiar en el cuerpo, y rechaza una marca de tiempo que se aleje más de 5 minutos de tu reloj, hacia adelante o hacia atrás. La guía para verificar webhooks trae el código en cuatro lenguajes.
5. Lleva pagos de prueba por cada estado
Un pago que sale bien demuestra poco. Crea un pago por escenario con un activo de Ethereum o TRON, págalo desde una billetera configurada en la red de prueba y comprueba que tu sistema hace lo correcto con cada estado y cada webhook.
| Escenario | Cómo provocarlo | Qué revisar |
|---|---|---|
| Pagado completo | Envía el monto exacto | invoice.pending y luego invoice.paid; el pedido se entrega una sola vez, con paid |
| Pago insuficiente, luego completado | Envía menos y después el resto a la misma dirección | invoice.underpaid, el monto restante y luego paid |
| Vencido | Crea un pago con poco tiempo para pagar y no lo pagues | invoice.expired; el pedido se libera |
| Cancelado | Cancela un pago mientras está en new |
El pedido se cierra de tu lado |
| Pago excedente | Envía más de lo debido | Estado paid con overpaid_amount mayor que cero |
| Pago tardío | Paga un pago que ya venció | late_payment: true e invoice.late_payment; el estado no cambia |
| Solicitud repetida | Repite POST /v1/invoices con el mismo Idempotency-Key y el mismo cuerpo |
Vuelve el mismo pago, sin duplicado |
El tiempo para pagar más corto por la API es de 60 segundos, así que el caso de vencimiento se prueba rápido. La página de pago nombra la red igual que en producción («Ethereum», «TRON») y no indica que es de prueba, así que no envíes enlaces de prueba a clientes reales. Sus enlaces a la transacción, igual que los del panel, abren exploradores de la red principal: ahí una transferencia de prueba aparece como «not found» aunque el pago ya esté paid. Fíate del estado en el panel y de tus webhooks, o busca el txid en un explorador de la red de prueba. Qué significa cada estado para el dinero se explica en pagos insuficientes, excedentes y tardíos.
6. Pasa a producción
Salir a producción repite la misma configuración con valores reales; tu código no cambia.
- En el panel de producción, crea una clave
ck_live_con los mismos permisos. - Quita la URL de prueba: elimina
CRYPTOLIKE_API_URLo la opción del SDK, o desactiva «Modo de prueba» en el plugin y restablece la URL de la API predeterminada. - Registra el endpoint de webhook en el panel de producción. Su secreto de firma es nuevo, así que actualízalo en tu servidor.
- Crea un pago real pequeño y comprueba que llegue a
paid.
La lista de verificación para tiendas online cubre el lado de la tienda: estados, inventario y reembolsos.
Errores y soluciones
Casi todos los errores del entorno de prueba vienen de mezclar los dos entornos. El código de error te dice qué mitad está mal configurada.
| HTTP · código o mensaje | Qué pasó | Qué hacer |
|---|---|---|
401 auth.test_key |
Una clave ck_test_ llegó a la API de producción |
Configura la URL de la API de prueba o usa una clave real en producción. |
400 validation_error, campo mode |
Se pidió una clave de prueba en producción | Créala en el panel de prueba. |
401 auth.invalid_key |
La clave pertenece al otro entorno | Usa la clave emitida en el entorno al que apunta la URL. |
| «El modo de prueba requiere una clave ck_test_; el modo real requiere una clave real.» | El modo del plugin y el prefijo de la clave no coinciden | Elige la clave según el interruptor «Modo de prueba». |
«La URL de la API debe empezar con https://.» |
La URL de la API del plugin no tiene https:// |
Pega la URL completa de la API de prueba. |
| 409 en «Enviar evento de prueba» | El endpoint está desactivado | Actívalo y vuelve a enviar el evento. |
| Tu servidor rechaza los webhooks | Desfase de reloj de más de 5 minutos o secreto equivocado | Sincroniza el reloj del servidor; usa el secreto del endpoint de prueba. |
Preguntas frecuentes
¿CryptoLike tiene un sandbox para pagos cripto?
Sí, como un entorno de prueba aparte y no como un interruptor dentro de producción. Tiene su propio panel y su propia URL de la API, y funciona con redes de prueba, así que los pagos, las confirmaciones y los webhooks se comportan como en producción, sin dinero real. El acceso lo da el soporte de CryptoLike. Los pagos allí se hacen con activos de Ethereum y TRON, cuyas redes de prueba son públicas.
¿Puedo usar una clave ck_test_ con la API de producción?
No. Producción funciona con las redes principales y rechaza las claves de prueba en cada solicitud, incluidas las de lectura, con 401 auth.test_key y un enlace a la documentación. Una clave de prueba solo funciona en el entorno de prueba, junto con la URL de su API.
¿Dónde consigo monedas de prueba?
De los faucets públicos de las redes de prueba, o del soporte de CryptoLike junto con el acceso al entorno de prueba, para los activos de Ethereum y TRON con los que pruebas. Las monedas de prueba no tienen valor y solo existen en redes de prueba, así que no se pueden vender ni mover a una red principal.
¿Las confirmaciones son más rápidas en las redes de prueba?
Las reglas son las mismas en los dos entornos: un pago espera en pending hasta alcanzar el umbral de confirmaciones de su activo y solo entonces cuenta. El umbral es una configuración de cada entorno, así que en el entorno de prueba el número puede ser distinto al de producción; la página de pago lo muestra como «Confirmando n/N». Cuánto tarda depende de con qué frecuencia la red de prueba produce bloques.
¿Puedo probar enlaces de pago sin código?
Sí. Crea un pago en el panel de prueba y abre su enlace, igual que en la guía de enlaces de pago con criptomonedas. Para eso no necesitas una clave API.