En resumen
Una billetera cripto estática asigna a un cliente una dirección de depósito on-chain permanente que se mantiene sin cambios en múltiples pagos. A diferencia de las facturas dinámicas, que tienen una ventana de pago y caducan, los canales de pago permanentes permiten recibir depósitos repetidos que alcancen o superen el mínimo para el token y la red (minimum_deposit) sin abrir un nuevo checkout. Cada depósito entrante pasa un análisis AML; una vez confirmado, se abona en el saldo del comercio y se notifica por webhook.
En el comercio electrónico tradicional, los pagos con criptomonedas se han basado habitualmente en facturas dinámicas: un código QR, un importe fijado y una cuenta atrás. Sin embargo, para plataformas con clientes habituales —como servicios SaaS, aplicaciones de juego en línea o plataformas de trading— este flujo genera una fricción innecesaria.
Las billeteras de depósito estáticas (o canales de pago) resuelven este problema al proporcionar a cada usuario una dirección permanente e intransferible para recargar su saldo en cualquier momento.
¿Qué es una billetera cripto estática?
Una billetera cripto estática es un punto de depósito permanente en la blockchain asignado a la identidad de un cliente en su base de datos. Funciona de manera idéntica a una cuenta bancaria con IBAN personalizado: el usuario puede guardar la dirección en su billetera móvil o exchange y realizar transferencias cuando lo desee, sin necesidad de generar una nueva orden de compra.
Ventajas operativas principales:
- Sin caducidad: La dirección permanece activa de forma indefinida hasta su bloqueo explícito.
- Importes variables: Acepta cualquier depósito que alcance o supere el mínimo para el token y la red (
minimum_deposit). - Acreditación automática: En cuanto la transferencia se ve on-chain, pasa la comprobación AML. Tras las confirmaciones de red necesarias se abona, y un webhook avisa a su servidor para actualizar el saldo del usuario.
Para conocer en detalle la integración técnica, consulte nuestra API REST Host-to-Host.
Canales de pago frente a facturas dinámicas
La diferencia técnica radica en la entidad a la que se vincula la dirección: una factura dinámica asocia una dirección temporal a un pedido específico, mientras que un canal de pago vincula una dirección permanente a la identidad del cliente.
Para los clientes habituales, las billeteras estáticas eliminan el paso de checkout en cada nuevo depósito: el usuario copia la dirección una vez y después transfiere directamente desde su billetera o su cuenta en un exchange. Para conocer los modelos de comisiones, consulte nuestra guía sobre quién asume las tarifas de procesamiento en criptomonedas.
Soporte multired: gestión de USDT en Tron, Ethereum y TON
Las pasarelas profesionales generan direcciones permanentes en varias redes bajo un mismo identificador de cliente. Los clientes tienen USDT y otras stablecoins en redes distintas, como Tron (TRC-20), Ethereum (ERC-20) y TON, así que una plataforma que acepta depósitos suele necesitar direcciones en varias de ellas sin fragmentar la contabilidad de cada usuario.
Al crear un canal, Paymos prepara direcciones de depósito para las redes que admite, también Arbitrum, BSC y Polygon. Tenga en cuenta que la red Base admite exclusivamente USDC en Paymos. La preparación tarda un momento, así que muestre una dirección solo cuando el canal la indique como lista (vea la sección de la API más abajo).
Sea cual sea la red por la que envíe el cliente, el depósito confirmado se abona en el saldo del comercio en ese activo. Su servidor no necesita mantener gas en cada cadena ni operar infraestructura propia de blockchain para recibir depósitos.
Integración para desarrolladores mediante API REST
La implementación consta de dos etapas: la asignación del canal permanente y la recepción de webhooks de depósito.
1. Creación de un canal de pago
Firma la solicitud con una clave Payment siguiendo la autenticación HMAC-SHA256. Los marcadores representan el ID de la clave, la hora Unix actual y la firma en Base64 de timestamp\nMETHOD\npath\nquery\nbodyHash. bodyHash es el SHA-256 del cuerpo exacto de la solicitud, en hexadecimal y minúsculas. Separa los campos con saltos de línea LF.
POST /v1/payment-channels HTTP/1.1
Host: api.paymos.io
Authorization: HMAC-SHA256 {api_key_id}:{base64_signature}
X-Request-Timestamp: {unix_seconds}
Content-Type: application/json
{
"project_id": "prj_xFukZuAJZR06pLVBh3uwzv",
"external_id": "usr_991824"
}
La primera solicitud devuelve HTTP 201 Created; repetir project_id y external_id en el mismo entorno devuelve el canal existente con HTTP 200 OK. En producción, un canal nuevo comienza en provisioning, todavía sin direcciones:
{
"id": "pc_2QhKZv6mRt9WdA3nYpLbXf",
"project_id": "prj_xFukZuAJZR06pLVBh3uwzv",
"external_id": "usr_991824",
"status": "provisioning",
"is_accepting_payments": false,
"is_fully_provisioned": false,
"is_test": false,
"applied_fee_percent": 1,
"customer_fee_percent": 0,
"networks": [
{
"network": "TRC20",
"status": "provisioning",
"tokens": [
{
"symbol": "USDT",
"minimum_deposit": "1.00"
}
]
}
],
"created_at": 1767225600,
"updated_at": 1767225600
}
Consulta GET /v1/payment-channels/{id} mientras avanza la preparación. Muestra la dirección de una red solo cuando is_accepting_payments sea true, esa red esté en active y su array tokens no esté vacío. Muestra junto a la dirección el minimum_deposit actual de cada token y compruébalo antes de enviar; el mínimo del ejemplo es ilustrativo. Si falta o es null, espera a que haya un valor. Una transferencia inferior al mínimo no se abona en el canal ni se devuelve automáticamente. Consulta los datos del canal.
2. Notificación mediante webhook
Cuando el depósito pasa la comprobación y alcanza las confirmaciones de red necesarias, el webhook payment_channel.deposit.confirmed notifica el depósito liquidado:
{
"event_id": "evt_J7EEYeL9pZJukfj2c5OQ44",
"event_type": "payment_channel.deposit.confirmed",
"version": 1,
"occurred_at": 1767225930,
"data": {
"id": "pcd_8ScRvL4jNq2XkB7mTfZdWu",
"payment_channel_id": "pc_2QhKZv6mRt9WdA3nYpLbXf",
"project_id": "prj_xFukZuAJZR06pLVBh3uwzv",
"payment_channel_external_id": "usr_991824",
"status": "confirmed",
"is_final": true,
"is_test": false,
"currency": "USDT",
"network": "TRC20",
"chain_id": 728126428,
"contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"gross": "100",
"fee": "1",
"net": "99",
"applied_fee_percent": 1,
"customer_fee_percent": 0,
"tx_hash": "9f4c1b7e30ad52c8ef6a1d84b0c39f27a5e6d138f4b90c72ae51d63b8407fc25",
"transfer_id": "9f4c1b7e30ad52c8ef6a1d84b0c39f27a5e6d138f4b90c72ae51d63b8407fc25:41a614f803b6fd780986a42c78ec9c7f77e6ded13c:41c9f6a2b7d0138e54ca3b91f6072ed48a5c1e93b7:0",
"source_address": "TQiBwkXtUUNygicvHJVVDCDKyVFr2YNTey",
"destination_address": "TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb3m9",
"block_height": 68421905,
"first_included_block_timestamp": 1767225900,
"explorer_url": "https://tronscan.org/#/transaction/9f4c1b7e30ad52c8ef6a1d84b0c39f27a5e6d138f4b90c72ae51d63b8407fc25",
"created_at": 1767225870,
"updated_at": 1767225930,
"confirmed_at": 1767225930
}
}
Verifica la firma sobre el cuerpo original según la guía de verificación. Abona data.net en una transacción atómica y una sola vez por data.id (pcd_…); usa event_id para detectar intentos de entrega repetidos. Consulta la idempotencia en la recepción de webhooks.
Análisis AML de las transferencias entrantes
Las direcciones estáticas reciben depósitos desde cualquier dirección de terceros, por eso importa analizar automáticamente las transferencias entrantes. En cuanto una transferencia se ve on-chain, Paymos analiza (KYT) la dirección del remitente con estas fuentes: TRM Labs, Binance AML, AMLBot, PureFi y la base de datos del proveedor de análisis. Si el resultado es limpio, el depósito se confirma y se abona con normalidad. Si el análisis falla o no devuelve veredicto, el depósito queda en estado Held for review: no se abona nada al saldo, no se envía webhook de confirmación y el comercio recibe un aviso en el panel.
El análisis no sustituye sus propias obligaciones AML y de sanciones como comercio, y no se garantiza que un depósito retenido se libere.
Comisiones de red y consolidación: quién paga por reunir los depósitos
La billetera del cliente paga la comisión de red por enviar el depósito. Paymos cubre el coste de red de recibir y consolidar los depósitos y no cobra al comercio una comisión aparte por transferencia ni por barrido. Cada cadena fija sus comisiones de red, que varían con la congestión, así que no hay un importe fijo.
Si reúne los fondos por su cuenta, cada dirección tiene que pagar su propia transferencia de consolidación, y un depósito muy pequeño puede costar más de reunir de lo que vale. En Paymos, cada ruta aplica un minimum_deposit actual, y una transferencia inferior no se abona en el canal. Consulte las condiciones completas en nuestra página de tarifas.
| Característica | Billetera estática (Canal) | Factura dinámica |
|---|---|---|
| Duración de la dirección | Permanente (reutilizable) | Ventana de pago con cuenta atrás |
| Importe esperado | A partir del mínimo (minimum_deposit) | Total fijo del pedido; tipo de cambio fijado cuando el pagador confirma el activo y la red |
| Casos de uso ideales | Saldos SaaS, iGaming, exchanges | Carritos de e-commerce, compras únicas |
| Ciclo de webhooks | payment_channel.deposit.confirmed | invoice.paid / invoice.expired |
| Generación de dirección | Una sola vez por usuario | Una vez por factura, cuando el pagador confirma el activo y la red |
| Coste de red de la recepción | Lo cubre Paymos | Lo cubre Paymos |
Preguntas frecuentes
¿En qué se diferencia una billetera estática de una factura cripto dinámica?
Una factura dinámica se crea para un pedido, con un importe fijo y una ventana de pago; caduca cuando la ventana se cierra. Una billetera estática (canal de pago) asigna a la cuenta del usuario una dirección reutilizable, sin ventana de pago, que acepta depósitos a partir del mínimo de cada token y red (minimum_deposit).
¿Puede un cliente enviar USDT por distintas redes a una misma billetera?
Sí, si la pasarela de pagos soporta enrutamiento multired. Un canal de pago permanente genera direcciones de depósito para Tron (TRC-20), Ethereum (ERC-20), BSC y TON vinculadas al mismo external_id de cliente.
¿Cómo identifica la plataforma qué usuario realizó un depósito?
Cada dirección estática se asigna de forma exclusiva al ID externo del cliente (external_id). Cuando la transacción se confirma en la red, el webhook envía dicho identificador al servidor del comercio.
¿Qué ocurre si un depósito es inferior al importe mínimo?
El minimum_deposit se consulta en tiempo real para cada combinación de token y red. Compruébalo antes de enviar: una transferencia inferior al mínimo no se abona en el canal ni se devuelve automáticamente. Si el valor falta o es null, espera a que haya un mínimo disponible.
¿Son custodiales las billeteras estáticas de Paymos?
Sí. Paymos custodia las claves de firma de las direcciones de depósito. Los depósitos confirmados se abonan en el saldo del comercio en el registro contable de Paymos.
Cuándo NO conviene usar billeteras cripto estáticas
- Si vende productos físicos en tiendas online con reserva de stock temporal — utilice facturas cripto dinámicas con cuenta atrás.
- Si necesita conciliación estricta 1 a 1 para compras de usuarios invitados sin registro en la plataforma.
- Si su servidor no cuenta con un receptor de webhooks para eventos asíncronos.
- Si su arquitectura exige cero reutilización de direcciones por motivos de privacidad UTXO.
Fuentes
Última revisión: 7 nov 2026


