// documentación

¿Cómo funciona el
checkout cripto?

Todo lo que necesitás saber para empezar a cobrar en USDC/USDT desde tu negocio, sin intermediarios y sin complicaciones técnicas.

01 · ¿Qué es FluidKey?

🔑

FluidKey

fluidkey.com · pagos cripto sin custodia

FluidKey es una billetera de cripto sin custodia que usa stealth addresses (direcciones sigilosas) para proteger la privacidad financiera del comerciante. Tu URL pública tiene el formato https://tu_alias.fkey.id/ — podés compartirla con cualquier cliente.

El mecanismo clave: cada cobro genera una dirección de depósito nueva y distinta. Cuando el cliente abre tu QR, FluidKey genera automáticamente una dirección de recepción única para esa transacción — una que nunca fue usada antes y que nadie puede vincular a tu identidad ni a tus otros cobros. Dos clientes que te paguen el mismo día van a ver dos direcciones completamente diferentes.

Esto significa que ningún comprador puede saber cuánto dinero tenés en tu wallet, cuántas ventas hiciste, ni rastrear tu historial. Un explorador de blockchain como Etherscan ve la transacción, pero no puede saber que esa dirección es tuya. Vos, en cambio, ves todo consolidado en tu dashboard de FluidKey como si fuera una sola wallet.

La clave: vos sos el único que controla tus fondos. FluidKey no puede mover tu plata, no puede congelar tu cuenta y no procesa el pago. Incluso si FluidKey dejara de existir, podés recuperar tus fondos desde recovery.fluidkey.com con tus claves privadas.

🔒
Sin custodia
Nadie más tiene acceso a tus fondos. Ni FluidKey ni esta herramienta.
🎭
Stealth addresses
Cada cobro genera una dirección nueva. Nadie puede rastrear tu balance ni tu historial.
⛓️
Multi-red
Acepta pagos en Base, Arbitrum, Optimism, Polygon y Gnosis.
💸
Fees bajas
Las fees en redes L2 (Base, Arbitrum, Optimism) son centavos de dólar.

02 · Flujo de un cobro

1

El comerciante ingresa el monto en ARS

Ponés el precio total que querés cobrar, incluyendo impuestos si aplica. La herramienta obtiene automáticamente la cotización USDC/ARS desde CriptoYA.

2

Se calcula el equivalente en USDC/USDT

Se divide el monto ARS por la tasa promedio de los 4 exchanges y se agrega un buffer del 0.5% para protegerse de variaciones de precio durante el pago.

3

Se muestra el cartel con el monto + el QR de FluidKey

El cliente ve exactamente cuántos USDC/USDT tiene que enviar y escanea el QR nativo de FluidKey del comerciante.

4

El cliente paga desde su wallet

Desde cualquier billetera compatible (MetaMask, Coinbase Wallet, Rainbow, etc.), el cliente elige la red y manda el monto indicado. El pago llega directo a la wallet del comerciante.

5

El comerciante confirma la transacción

La confirmación se puede ver on-chain en segundos (en redes L2 como Base o Arbitrum). No hay intermediario: si llegó, llegó.

03 · Cotización y cálculo

⚡ Promedio de 4 exchanges

La tasa se obtiene en tiempo real de Buenbit, Ripio, Belo y Fiwind vía la API pública de CriptoYA. Se toma el precio bid (precio de venta del exchange) y se calcula el promedio entre los exchanges que respondan correctamente. Si alguno falla, se excluye del promedio automáticamente.

Tasa = promedio(Buenbit, Ripio, Belo, Fiwind) // precio bid de cada exchange
USD base = ARS ÷ Tasa
Buffer = USD base × 0.5%
Total a cobrar = USD base + Buffer

04 · Redes soportadas

Base
L2 de Coinbase. Muy bajo costo. Recomendada para pagos pequeños.
Arbitrum One
L2 de Ethereum. Alta liquidez y amplia adopción.
Optimism
L2 de Ethereum. Fees muy bajas, rápida confirmación.
Polygon
Sidechain de Ethereum. Muy popular en Argentina.
Gnosis Chain
Especializada en pagos cotidianos. Fees mínimas.

05 · Preguntas frecuentes

Q¿Necesito saber de cripto para cobrar?
▾
No. Solo necesitás tener creada tu cuenta en FluidKey (gratuita) y pegar tu URL en este checkout. El sistema hace el resto: obtiene la cotización, calcula el monto y muestra el QR. El cliente tampoco necesita saber mucho — cualquier app de cripto moderna tiene la opción "escanear QR para pagar".
Q¿Esta herramienta procesa o toca mis fondos?
▾
No. Esta página es 100% estática. Corre en tu navegador, no tiene backend, no guarda datos y no toca ninguna transacción. Solo muestra el QR de FluidKey del comerciante. El pago ocurre directamente entre la wallet del cliente y la del comerciante, on-chain.
Q¿Por qué se usa un promedio de 4 exchanges?
▾
Un solo exchange puede tener spreads temporalmente más altos o quedar fuera de línea. Promediar entre Buenbit, Ripio, Belo y Fiwind da una tasa más representativa del mercado real y reduce el riesgo de usar un precio desfavorable. Si alguno falla, el promedio se calcula con los que respondan.
Q¿Qué es el buffer del 0.5%?
▾
Desde que se calcula el monto hasta que el cliente confirma el pago pueden pasar varios minutos. El precio del USDC en ARS puede moverse ligeramente en ese tiempo. El buffer del 0.5% actúa como margen de seguridad para cubrir esa variación. En términos prácticos: en un cobro de $100 USD, el buffer representa $0.50.
Q¿Qué pasa si el cliente paga en otra red?
▾
El cliente elige la red desde su wallet al momento de pagar. Lo importante es que envíe USDC o USDT, no otro token. FluidKey soporta varias redes:
  • ✅ Base, Arbitrum, Optimism, Polygon, Gnosis — recomendadas. Fees de centavos.
  • ⚠️ Ethereum mainnet — FluidKey la acepta, pero no es recomendable: las fees de red pueden ser $5–$30 o más, lo que encarece innecesariamente el pago para el cliente.
  • ❌ Otras redes (BSC, Solana, Tron, etc.) — no compatibles con FluidKey directo. No enviar sin confirmar antes.
La recomendación siempre es usar Base o Arbitrum: son las más rápidas, baratas y con más adopción actualmente.
Q¿El cliente necesita una app específica?
▾
No. Cualquier wallet self-custodial compatible con las redes soportadas funciona. Algunas opciones populares:
  • MetaMask — la más usada, disponible en móvil y extensión de navegador
  • Rabby — excelente interfaz, muy recomendada para usuarios más avanzados
  • Coinbase Wallet — fácil de usar, buena integración con Base
  • Rainbow — muy amigable para móvil
  • Trust Wallet — amplia compatibilidad de redes
Importante: el cliente debe pagar desde su propia wallet self-custodial, no desde un exchange como Binance o Bybit. Los retiros desde exchanges no son instantáneos y pueden demorar minutos o incluso horas, lo cual genera una mala experiencia en el punto de venta.
Q¿Cómo confirmo que recibí el pago?
▾
La única forma confiable es verificar directamente en tu app de FluidKey. Dado que cada cobro genera una dirección de depósito única y nueva (stealth address), es imposible rastrear un pago buscando tu dirección en exploradores de blockchain como Etherscan o Basescan — simplemente no vas a encontrar nada vinculado a vos. Eso es exactamente el punto: esa privacidad es la que protege tu historial de ventas. FluidKey consolida todos esos cobros en tu dashboard y te muestra el balance total. En redes L2, la confirmación suele aparecer en segundos o pocos minutos.
Q¿El QR del checkout tiene el monto incluido?
▾
Actualmente, el QR nativo de FluidKey no incluye el monto — solo la dirección de la wallet. El monto calculado se muestra como cartel visible ("Enviar: X USDC/USDT") y el cliente lo ingresa manualmente en su app al confirmar el pago. Es una limitación de la integración actual que puede mejorar en versiones futuras.
Q¿El QR no se ve / aparece bloqueado?
▾
Algunos navegadores bloquean iframes de sitios externos (por políticas de seguridad de FluidKey). Si esto pasa, la página ofrece un enlace directo para abrir tu página de FluidKey en una pestaña nueva. El cliente puede escanear el QR desde ahí, o vos podés mostrarle la pantalla directamente.