Fundamentos de la pasarela

Qué es una pasarela de pagos cripto

Una pasarela de pagos cripto permite aceptar criptomonedas, seguir cada pago y retirar los fondos. Cómo funciona paso a paso y qué revisar antes de elegir.

Una pasarela de pagos cripto es el servicio que se sitúa entre la billetera de tu cliente y tu sistema de pedidos: crea la solicitud de pago, vigila la blockchain, avisa a tu tienda cuando llega el dinero y conserva los fondos hasta que los retiras. Esta guía explica cómo funciona en la práctica y qué revisar antes de elegir una.

Qué hace una pasarela de pagos cripto

Aceptar cripto sin pasarela significa dar una dirección de billetera a cada cliente, vigilar tú mismo la blockchain, asociar las transferencias entrantes con los pedidos y resolver a mano cada caso especial. Una pasarela asume cuatro tareas:

  • Crea el pago. Tu sistema solicita un pago por un importe; la pasarela devuelve una página de pago o una dirección solo para ese pedido.
  • Vigila la red. Ve llegar la transferencia, cuenta las confirmaciones y decide cuándo el pago es definitivo.
  • Te informa. Avisa a tu tienda, normalmente mediante webhook, de que el pedido 1024 está pagado, para que puedas enviarlo o dar acceso.
  • Custodia y mueve los fondos. El dinero recibido llega a un saldo de comerciante y tú lo retiras a tu propia billetera.

Una pasarela no es una billetera cuyas claves controlas ni un exchange. Es infraestructura de pagos: la parte del pago con tarjeta que un banco y un procesador suelen ocultarte, reconstruida para las blockchains.

Cómo recorre un pago la pasarela

Cada pasarela funciona algo distinto, pero el camino de un pago es este:

  1. Tu servidor crea un pago: un número de pedido y un importe, normalmente en dólares.
  2. El cliente abre la página de pago y elige un activo y una red, por ejemplo USDT en TRON. El comerciante también puede preseleccionar el método.
  3. La pasarela fija el tipo de cambio durante un tiempo limitado, de modo que el importe que debe enviar el cliente no se mueva mientras paga. En Qvard el tipo de cambio se fija durante una hora.
  4. El cliente envía el importe exacto desde su propia billetera a la dirección mostrada para ese pago.
  5. La pasarela vigila la red, espera las confirmaciones y marca el pago como pagado.
  6. Avisa a tu servidor. Tu código marca el pedido como pagado y entrega el producto.
  7. El dinero aparece en tu saldo de comerciante. Lo retiras a tu billetera manualmente o con una regla que tú defines.

Los pagos reales no siempre salen perfectos: los clientes envían de menos, de más o cuando el tipo de cambio ya caducó. Una buena pasarela tiene un estado definido para cada caso en lugar de dejarte la conciliación a mano. En Qvard, los estados de un pago son wait, partial, completed y rejected.

Pasarela, billetera, exchange y procesador: en qué se diferencian

Estos términos se confunden a menudo:

  • Billetera. Guarda las claves y permite enviar y recibir. No asocia pagos con pedidos ni avisa a tu tienda.
  • Exchange. Intercambia un activo por otro. Algunos ofrecen herramientas para comercios, pero su función principal es operar.
  • Pasarela de pagos. Crea y sigue pagos para tus pedidos y comunica su estado. De esto trata esta guía.
  • Procesador o adquirente. En los pagos con tarjeta, la empresa que mueve el dinero entre bancos. En cripto, la palabra «adquirencia» se usa de forma laxa para todo el servicio; mira adquirencia cripto frente a pasarela de pagos cripto para ver en qué se diferencian.

Custodial o no custodial

La decisión de diseño más importante detrás de cualquier pasarela es quién tiene los fondos entre el pago y tu retiro.

En una pasarela custodial, los pagos entrantes van a direcciones que controla el proveedor y se acreditan en tu saldo de comerciante. Después los retiras. Esto simplifica la conciliación y permite funciones como los retiros automáticos, pero dependes del proveedor hasta que retiras, así que sus condiciones de retiro importan.

En un modelo no custodial, los pagos van directamente a tu billetera. Conservas las claves y el proveedor solo sigue el pago. Esto reduce el riesgo de contraparte y traslada la gestión de claves a ti.

Qvard es custodial: los pagos se acreditan en un saldo de comerciante y tú retiras a tu billetera de forma automática por regla o manualmente. El retiro a una billetera solo cuesta la comisión de red y no existe retiro a una cuenta bancaria.

Stablecoins y redes: por qué importa la red

Un mismo activo puede existir en varias blockchains. USDT, por ejemplo, existe en TRON (TRC-20), Ethereum (ERC-20) y BNB Smart Chain (BEP-20). Una transferencia solo es válida en la red que pidió la página de pago, y las comisiones y la velocidad cambian entre redes.

Por eso la pasarela muestra el activo y la red juntos, y la elección del cliente debe ser explícita. Para el comerciante, las consecuencias prácticas son:

  • decide qué redes quieres aceptar y comprueba que la pasarela las admite;
  • las comisiones de red dependen de la cadena y de su congestión, no de la pasarela;
  • prefiere stablecoins para fijar precios en dólares, porque un pago en un activo volátil puede valer bastante menos cuando lo retiras.

Qvard acepta hoy USDT y USDC en las redes principales, además de BTC y LTC nativos; TON está en camino. La lista completa está en la página de monedas y redes admitidas.

Qué revisar antes de elegir una pasarela

Una lista corta que separa una pasarela utilizable de una arriesgada:

  • Redes y activos. ¿Admite los que usan realmente tus clientes?
  • Comisiones. ¿Qué cobra la pasarela y cuál es la comisión de red aparte? ¿Quién paga cada una?
  • Fondos y retiros. ¿Quién guarda el dinero, cómo funcionan los retiros y hay límites u opciones en moneda fiat que quizá necesites o no?
  • Calidad de la API. ¿Puedes crear un pago de forma segura más de una vez con el mismo número de pedido? ¿Los errores son claros? ¿El webhook se reintenta si tu servidor estaba caído?
  • Pagos atípicos. ¿Cómo se tratan el pago insuficiente, el pago de más y los pagos caducados?
  • Pruebas. ¿Puedes probar el flujo sin mover dinero real?
  • Soporte y documentación. ¿Quién responde cuando un pago se queda atascado?

Cómo elegir un proveedor de pagos cripto recorre esta lista con más detalle.

Cómo es una integración mínima

Crear un pago es una sola solicitud. Con Qvard envías tu propio número de pedido y el importe en dólares estadounidenses, y recibes un identificador de pago y un enlace a la página de pago alojada. Rediriges al cliente allí; todo lo relativo a elegir el activo y enviar la transferencia ocurre en esa página.

El id que envías es tu número de pedido: enviar de nuevo el mismo id con el mismo método de pago devuelve el pago existente en lugar de crear un duplicado, lo que hace seguros los reintentos. Cuando el cliente paga, Qvard envía un webhook a tu servidor con ese mismo id y el estado del pago. El flujo completo, con código para tu backend, está en cómo aceptar pagos cripto en un sitio web; la referencia está en la página para desarrolladores.

curlPOST /api/v1/payment
curl -X POST https://api.qvard.com/api/v1/payment \
  -H "x-api-key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "id": "order_1024", "price": 149.99 }'

# 201 Created
{ "id": "8f3k2a1c", "redirectUrl": "https://my.qvard.com/pay/8f3k2a1c" }

Errores frecuentes

  • Fiarse de la redirección. Que el cliente vuelva a tu página de «gracias» no demuestra que haya pagado. Marca un pedido como pagado solo cuando la pasarela comunique un estado final.
  • Ignorar los pagos parciales. Si el cliente envió menos del importe, el pedido no está pagado. Decide de antemano si pides la diferencia o devuelves el dinero.
  • No probar el reintento del webhook. Si tu servidor devuelve un error durante un webhook, la notificación debe reintentarse y tu gestor debe tolerar recibir el mismo evento dos veces.
  • Fijar precios en un activo volátil. Cotiza en dólares y deja que el cliente pague con una stablecoin si no puedes asumir el riesgo de precio.
  • No probar el camino de retiro. Retira una cantidad pequeña antes de depender de la pasarela para ingresos reales.

Dónde encaja Qvard

Qvard es una pasarela de pagos cripto custodial para empresas. Hoy creas un pago mediante la API, envías al cliente a la página de pago alojada, recibes el estado final por webhook y retiras desde tu saldo de comerciante a una billetera. Las otras formas de cobrar, como enlaces de pago, una ventana integrada, un SDK y un terminal de punto de venta, están en desarrollo. Puedes ver la página de pago real con una factura de demostración antes de crear una cuenta, y la página de precios explica cómo funcionan las comisiones.

FAQ

¿Una pasarela de pagos cripto es lo mismo que una billetera cripto?

No. Una billetera guarda claves y envía transferencias. Una pasarela crea un pago para un pedido concreto, lo sigue en la blockchain, comunica su estado a tu tienda y conserva el dinero en un saldo de comerciante hasta que lo retiras.

¿Se puede revertir un pago en cripto?

No. Una transferencia confirmada en la blockchain es definitiva. Si debes reembolsar a un cliente, envías tú una nueva transferencia, así que define tu política de reembolsos antes de empezar a aceptar pagos.

¿Cuánto tarda en confirmarse un pago?

Depende de la red y de cuántas confirmaciones espere la pasarela. Algunas redes confirman en segundos, mientras que Bitcoin genera un bloque más o menos cada diez minutos. La página de pago muestra el estado mientras el cliente espera.

¿Tengo que construir algo de mi lado?

Necesitas crear el pago desde tu backend y gestionar el webhook que informa de su estado. Todo lo demás, desde la página de pago hasta la vigilancia de la blockchain, lo hace la pasarela.

Artículos relacionados

Artículos relacionados