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

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.

{
  "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 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.

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. 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.
5. Cambia a una clave de producción.

SDK: SDK de TypeScript, SDK de Python, SDK de Go, SDK de PHP. Las rutas están en la referencia de la API; las firmas, en webhooks, y la comisión por pagos entrantes de cada activo, en la página de precios.

#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.