Cómo funciona la integración de un on-ramp de fiat a cripto

Tres formas de integrar un onramp de fiat a cripto: widget, checkout alojado, API

Hay tres formas comunes de integrar un onramp de fiat a crypto. Lo que los diferencia es cuánto construyes tú mismo y cuánto control recuperas por el esfuerzo. Un widget se envía más rápido. Un checkout alojado es casi tan rápido. Una API completa te da la mayor libertad y exige el mayor trabajo. Cuál es la correcta depende de tu equipo y tu plazo. Sé honesto contigo mismo acerca de cuánto desarrollo puedes permitirte, porque esa respuesta generalmente hace la elección por ti.

Un widget de pagos cripto es un iFrame que colocas en tu página, y toda la compra ocurre dentro, con tus propios colores. Un hosted checkout es aún más ligero en el frontend: envías al usuario a una página lista y lo recibes cuando vuelve. Ambos se apoyan en el proveedor para lo difícil, así que los equipos pequeños suelen empezar por aquí.

La vía de la API, a veces una conexión host-to-host, te deja construir las pantallas tú mismo y controlar cada paso. Eso cuesta horas reales de desarrollo, así que encaja con equipos que quieren un acabado a medida o que ya tienen una infraestructura de pagos.

Modelos de integración de Onramp comparados

Haciendo coincidir el modelo con tu equipo

El widget es para equipos que quieren estar en vivo esta semana y no pueden prescindir de mucho tiempo en el front-end. Pegas un fragmento, ajustas los colores, y ya está. Es por eso que tantas startups y equipos no técnicos lo eligen primero.

Un checkout alojado tiene sentido cuando prefieres no incrustar nada en absoluto, digamos que tu propio sitio opera bajo reglas de seguridad estrictas. Configuras una redirección y una URL de retorno, y eso es más o menos todo. En cuanto a esfuerzo, se sitúa entre el widget y la API.

La API es para equipos con desarrolladores que quieren que el flujo de compra se sienta nativo de principio a fin. Controlas las pantallas, los datos, los casos borde incómodos, y a cambio pasas más tiempo construyendo y probando. Si conseguir estar en vivo rápidamente importa más que ese control, una de las primeras dos opciones lo superará.

El proceso de integración técnica, paso a paso

Cualquiera que sea el modelo en el que aterrices, la construcción se ve en general igual. Para el widget y las rutas alojadas, es en su mayoría configuración, no codificación pesada. El orden de los pasos rara vez cambia, así que una vez que hayas hecho una integración, la siguiente se siente familiar.

Los pasos de integración de entrada

Cuenta, Claves y Sandbox

Primero te registras y pasas la verificación del negocio, y luego obtienes claves de API y un sandbox. El sandbox se comporta como el sistema real pero funciona con dinero de prueba, así que nada real se mueve mientras construyes.

Esa misma cuenta suele hacer más que el on-ramp. Si más adelante decides también aceptar pagos en cripto de clientes, funciona desde el mismo panel y las mismas claves. Protege tus claves de producción y rótalas en cuanto sospeches una filtración, porque pueden mover dinero real.

Activos, Métodos de Pago y la Conversión

Luego viene el menú: qué monedas pueden comprar los usuarios y con qué métodos fiat pueden pagar, tarjetas, transferencias bancarias, etc. El proveedor hace el cambio de fiat a cripto y la entrega on-chain, así que tú nunca cotizas un precio ni mueves una moneda.

Un pequeño consejo: empieza con un puñado de monedas y añade más después. No tendrás que reabrir la integración para hacerlo.

Webhooks, pruebas y lanzamiento

Los webhooks son la forma en que el on-ramp le cuenta a tu sistema qué acaba de pasar, de modo que una compra completada o fallida actualiza tu app por sí sola. Le das al proveedor un endpoint, luego lanzas compras de prueba por el sandbox y compruebas que cada estado llega. ¿Planeas dejar comprar de forma programada? Lee por qué las empresas usan pagos cripto recurrentes antes de diseñar esa parte.

Cuando las pruebas se comportan, cambias las claves de sandbox por las de producción y enciendes el on-ramp. Las integraciones con widget y hosted suelen llegar aquí rápido; una con API tarda más, porque controlas más del flujo. Un hábito ahorra muchos disgustos: confía en el webhook para saber qué pasó de verdad, no en lo que muestre el navegador tras un redirect.

Cosas que los equipos pasan por alto

El error clásico es probar solo la compra limpia. Todo se ve genial hasta que una tarjeta es rechazada en producción y nada lo maneja. Dale la misma atención a los caminos desordenados, un rechazo, un tiempo de espera, un usuario que cierra la pestaña, que al feliz.

El otro es móvil. Si la mayor parte de tu tráfico está en teléfonos, abre el widget o la caja en un navegador móvil real temprano, porque un diseño que se ve bien en un escritorio puede sentirse apretado en una pantalla pequeña.

¿Dudas entre los tres modelos? Cuéntanos cómo está montado tu equipo y te diremos cuál te pone en marcha antes. Ponte en contacto.

Requisitos de cumplimiento durante la integración

El cumplimiento suena aterrador, pero la parte que te corresponde en la integración es mayormente un acopio de documentos único. El proveedor mantiene las licencias y realiza las verificaciones reales. Tu trabajo es tener tu propia documentación en orden y saber qué se le pedirá a tus usuarios. Resuelve esto temprano, porque esto, no el código, tiende a decidir la fecha de lanzamiento.

Antes de salir espera una revisión Know Your Business (KYB). Entregas documentos de la empresa, información sobre quién la posee o controla, y el sitio o la app donde funcionará el on-ramp.

Tus usuarios, por su parte, pasan por Know Your Customer (KYC), y normalmente llega por niveles. Una compra pequeña puede no necesitar más que un email y un número de teléfono; los importes mayores piden un documento, a veces también una prueba de domicilio. El proveedor lo gestiona todo, así que ninguno de esos documentos sensibles queda en tus servidores.

Qué preparar para el cumplimiento del onramp

Cuánto tiempo tarda la verificación

Su revisión KYB suele tardar un día a unos pocos días. Depende de qué tan rápido envíe los documentos y cuán ordenados estén. Tenga sus documentos de empresa y detalles de los propietarios listos antes de aplicar, porque ese es el paso más probable que retrase un lanzamiento.

La KYC de los usuarios finales es más rápida y se ejecuta principalmente sola. El nivel básico puede despejarse en segundos, los niveles con muchos documentos tardan unos minutos, y solo una pequeña parte de los usuarios llega a un revisor humano.

Niveles típicos de verificación de usuarios finales

Costos de integración de onramp de fiat a crypto

Esto es lo que la gente entiende mal: el modelo de integración no influye en el precio. Por venta, un widget cuesta exactamente lo mismo que una integración con API completa, así que elige el modelo que encaje con tu equipo, no el que supones más barato. El precio casi siempre es por transacción, sin cuota mensual y sin pagar por las pruebas. Pagas cuando un cliente compra, y ni un momento antes.

Nos saltamos aquí el desglose completo de comisiones. La versión corta: la tarifa que ves ya junta el método de pago, el coste de red y la parte del proveedor.

Cuando los volúmenes se hacen grandes, el precio estándar de un on-ramp deja de ser la opción más barata. Pasar tamaño por una mesa OTC suele salir mejor, y muchas empresas llevan el flujo minorista por el on-ramp y el grande por la mesa. Pregunta a tu proveedor qué reparto encaja con tus cifras.

¿Cambia la tarifación de entrada según el tipo de integración?

El coste real es el tiempo de desarrollo, no las comisiones

Con la comisión plana en todos los modelos, el número que de verdad varía es tu tiempo de desarrollo. Un widget puede ser el trabajo de un día. Una integración con API completa puede comerse semanas de tiempo de desarrollo si cuentas las pruebas.

Así que pon precio a ese tiempo interno cuando sopeses las opciones. Con una comisión de procesamiento idéntica, un equipo que lanza un widget en una tarde gasta mucho menos en salir en marcha que uno que construye un flujo a medida desde cero.

Cómo funciona la integración de Inqud on-ramp

El on-ramp de Inqud es una pieza de una pasarela de pagos cripto más amplia, así que una sola cuenta gestiona comprar cripto, aceptarla y liquidar. El servicio de on-ramp de Inqud te da los tres modelos de integración, un widget iFrame, una página de checkout y una API host-to-host, y la mayoría de los equipos están en marcha en menos de dos días.

Los usuarios pueden comprar Bitcoin, Ethereum, Solana, USDC y tokens en redes como Polygon, Tron, Optimism y Arbitrum, pagando con Visa, Mastercard o una transferencia bancaria. La verificación, los controles de fraude y la detección de AML ocurren silenciosamente en segundo plano, y si una ruta de pago falla, una configuración de múltiples proveedores intenta de nuevo a través de otra para rescatar la venta. ¿Tienes suscripciones en el roadmap? Inqud ejecuta recurring crypto payments en el mismo sistema.

Los usuarios pueden comprar Bitcoin, Ethereum, Solana, USDC y tokens en redes como Polygon, Tron, Optimism y Arbitrum, pagando con Visa, Mastercard o transferencia bancaria. La verificación, los controles de fraude y el screening AML ocurren en silencio en segundo plano, y si una ruta de pago falla, una configuración con varios proveedores reintenta por otra para salvar la venta. ¿Tienes suscripciones en la hoja de ruta? Inqud ejecuta pagos cripto recurrentes en el mismo sistema.

Tu negocio nunca tiene ni custodia la cripto durante una compra; las monedas llegan a la cartera del usuario en cuanto se aprueba el pago. Eso te ahorra el riesgo de custodia y recorta la carga de cumplimiento de tu lado. Y lo mejor, puedes ver el on-ramp funcionando en una cuenta real y compararlo con tu propio flujo antes de comprometerte, que es la forma más rápida de saber si encaja.

Inqud on-ramp

¿Listo para poner un on-ramp de fiat a cripto delante de tus usuarios? Te ayudamos a dimensionar el trabajo y ponerlo en marcha rápido. Contacta con el equipo de Inqud.