# Recarga saldos de usuarios con depósitos cripto a direcciones estáticas

> Una dirección de depósito permanente por usuario y activo: cada transferencia se acredita tras sus confirmaciones y la informa el webhook firmado deposit.confirmed.

Source: https://cryptolike.net/es/use-cases/deposits
Updated: 2026-09-25

CryptoLike le da a cada uno de tus usuarios una dirección de depósito permanente por activo. Cada vez que envían dinero a esa dirección, la transferencia se acredita a tu saldo después de las confirmaciones de ese activo, y un webhook firmado `deposit.confirmed` le indica a tu servidor a qué usuario recargarle el saldo y por cuánto. No hace falta acordar de antemano una factura ni un monto.

## ¿Por qué una recarga de saldo necesita una dirección estática?

Una recarga no es un pedido. El usuario decide cuándo envía y cuánto, y puede volver a enviar la semana siguiente. Una factura tiene un monto fijo y un plazo: sirve para una compra, pero no para un saldo. Una dirección estática de CryptoLike queda asignada a un solo usuario, acepta cada transferencia y la vincula con ese usuario.

Las direcciones estáticas sirven para saldos en juegos, marketplaces y servicios online, cuentas prepagadas y fondeo regular desde el mismo cliente o socio. Una dirección compartida no distingue entre usuarios, y una dirección por transferencia obliga a generar una nueva cada vez; la dirección estática evita ambos problemas.

## Cómo funcionan las direcciones estáticas de CryptoLike

En CryptoLike, una dirección estática pertenece a un activo y a uno de tus usuarios, identificado con tu propio `customer_id`. La creas con una llamada a la API y la muestras en tu app. CryptoLike vigila la red, cuenta las confirmaciones y acredita cada transferencia, y cada paso se anuncia con un webhook. Para darle varios activos a un usuario, crea una dirección por activo.

```json
{
  "coin_id": "6f1c2a3e-8d4b-4c5a-9e7f-0a1b2c3d4e5f",
  "customer_id": "user-8812",
  "label": "Top-up wallet"
}
```

`POST /v1/addresses` con este cuerpo devuelve la dirección. La clave necesita el permiso `create_address`. Envía un `Idempotency-Key` y un reintento devolverá la misma dirección. Cada par (activo, usuario) tiene una sola dirección activa. Una segunda solicitud responde `409`: archiva la dirección anterior para emitir una nueva. La dirección archivada sigue recibiendo y acreditando transferencias.

Muestra la dirección junto con su red. Una dirección de TRON empieza con «T», y USDT en TRON y USDT en Ethereum son activos distintos, cada uno con su propia dirección. En [monedas compatibles](https://cryptolike.net/es/coins) figura la red de cada activo.

## ¿Qué eventos te avisan de un depósito?

Un depósito en CryptoLike pasa por un conjunto pequeño de eventos, y cada uno lleva la dirección (con tu `customer_id`) y el depósito. Acredita a tu usuario con `deposit.confirmed`, una sola vez por depósito. El mismo evento puede llegar más de una vez con el mismo `event_id`, así que omite los identificadores que ya procesaste.

| Evento | Significado | Qué hacer |
|---|---|---|
| `deposit.pending` | Se detectó una transferencia a la dirección | Muéstrale al usuario que está esperando confirmación |
| `deposit.confirmed` | Confirmado y acreditado; ya se conocen `fee` y `net_amount` | Recarga el saldo del usuario |
| `deposit.reverted` | La red revirtió la transferencia | Revierte la recarga |
| `deposit.on_hold` | La transferencia está retenida para una revisión de cumplimiento | Espera; todavía no recargues el saldo |

El depósito incluye `txid` y `output_index`, `amount`, `fee`, `net_amount`, `confirmations` y `required_confirmations`. El umbral de confirmaciones se define por activo y aparece en `GET /v1/currencies` y en [monedas compatibles](https://cryptolike.net/es/coins). `GET /v1/addresses/{id}` devuelve la dirección con su historial de depósitos. Cada depósito también aparece en `GET /v1/transactions`, que se exporta a CSV o XLSX.

## Cómo conectarte

Una integración de depósitos con CryptoLike necesita un servidor que guarde el secreto de la API, una clave con `create_address` y `read`, y un endpoint de webhook suscrito a `deposit.*`. Los SDK oficiales para TypeScript, Python, Go y PHP firman las solicitudes y verifican los webhooks. Están en versión preliminar y se instalan desde el repositorio.

1. Pide a soporte de CryptoLike acceso al entorno de prueba: en el panel de ese entorno, crea una clave API `ck_test_` con `create_address` y `read`, y usa la URL de la API de ese entorno.
2. Agrega un endpoint de webhook para los eventos `deposit.*` y guarda su secreto en tu servidor.
3. Crea una dirección para un usuario de prueba y envía una transferencia en una red de prueba.
4. Acredita al usuario con `deposit.confirmed`, según la guía para [verificar los webhooks de pagos cripto](https://cryptolike.net/guides/verify-crypto-payment-webhooks).
5. Cambia a una clave de producción.

SDK: [SDK de TypeScript](https://cryptolike.net/integrations/sdk-typescript), [SDK de Python](https://cryptolike.net/integrations/sdk-python), [SDK de Go](https://cryptolike.net/integrations/sdk-go), [SDK de PHP](https://cryptolike.net/integrations/sdk-php). Las rutas están en la [referencia de la API](https://cryptolike.net/docs/api); las firmas, en [webhooks](https://cryptolike.net/docs/webhooks), y la comisión por pagos entrantes de cada activo, en la [página de precios](https://cryptolike.net/es/pricing).

## Preguntas frecuentes

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

Una factura es un pago único por un monto fijo y con plazo, para un pedido o una compra. Una dirección estática es una dirección permanente de un usuario donde se acredita cada transferencia: saldos, depósitos y fondeo recurrente. Ambas informan el resultado con los mismos webhooks firmados.

### ¿El usuario tiene que enviar un monto fijo?

No. No hay un monto que acordar de antemano: cada depósito se acredita después de las confirmaciones del activo. La comisión de la plataforma por pagos entrantes se define por activo y figura en la página de precios. Cada evento `deposit.confirmed` la muestra como `fee`, junto a `net_amount`.

### ¿Cuánto tarda en acreditarse un depósito?

Depende del activo. Cada activo tiene un umbral de confirmaciones, que aparece en `GET /v1/currencies`. Recibes `deposit.pending` cuando se detecta la transferencia y `deposit.confirmed` cuando se alcanza el umbral y el monto se acredita a tu saldo de CryptoLike; si la transferencia queda retenida para revisión, recibes `deposit.on_hold` en su lugar.

### ¿Un usuario puede tener la misma dirección para siempre?

Sí. La dirección sigue activa hasta que la archivas, e incluso una dirección archivada sigue acreditando transferencias. Para darle al usuario una dirección nueva del mismo activo, primero archiva la anterior.

### ¿Puedo ver los depósitos sin escribir código?

Sí. El panel muestra las direcciones estáticas con su historial de depósitos, y el bot de Telegram puede mostrar direcciones y enviar un mensaje por cada depósito confirmado.