# Cómo probar pagos con criptomonedas en un entorno de prueba

> Prueba pagos con criptomonedas en CryptoLike antes de lanzar: entorno de prueba con redes de prueba, claves ck_test_, monedas de prueba, cada estado y webhooks.

Source: https://cryptolike.net/es/guides/test-crypto-payments
Published: 2026-10-04 · Updated: 2026-10-04 · Author: CryptoLike team

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](https://cryptolike.net/es/glossary/testnet) 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](https://cryptolike.net/docs/sdk) lista las demás variables; la firma de solicitudes está en [autenticación de la API](https://cryptolike.net/docs/auth).

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](https://cryptolike.net/es/integrations/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](https://cryptolike.net/guides/verify-crypto-payment-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](https://cryptolike.net/blog/underpaid-crypto-payments).

## 6. Pasa a producción

Salir a producción repite la misma configuración con valores reales; tu código no cambia.

1. En el panel de producción, crea una clave `ck_live_` con los mismos permisos.
2. Quita la URL de prueba: elimina `CRYPTOLIKE_API_URL` o la opción del SDK, o desactiva «Modo de prueba» en el plugin y restablece la URL de la API predeterminada.
3. Registra el endpoint de webhook en el panel de producción. Su secreto de firma es nuevo, así que actualízalo en tu servidor.
4. Crea un pago real pequeño y comprueba que llegue a `paid`.

La [lista de verificación para tiendas online](https://cryptolike.net/blog/ecommerce-crypto-checklist) 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](https://cryptolike.net/es/guides/crypto-payment-link). Para eso no necesitas una clave API.