Cómo aceptar pagos en criptomonedas en tu sitio web
Elige cómo recibir criptomonedas, prepara las direcciones y conecta la verificación de pagos con tus pedidos.
Actualizado:
Para aceptar pagos en criptomonedas, elige un activo y una red, prepara una dirección de recepción y decide cómo sabrá tu sitio que ha llegado el pago. Con Cryptanio puedes empezar con un enlace de pago, crear facturas individuales para los pedidos o permitir que los usuarios recarguen un saldo interno. Los fondos llegan a tus direcciones, mientras el servicio sigue las transferencias e informa de los cambios de estado.
Veamos qué opción encaja con tu caso y qué debes comprobar antes del primer pago. Trataremos USDT y USDC dentro del mismo proceso: elegir una moneda es importante, pero no determina por sí solo el tipo de integración.
Elige el método de cobro
Un enlace de pago sirve para una venta puntual o el cobro de un servicio. Conecta tus direcciones a un proyecto, crea una página en tu cuenta, indica el motivo del pago y selecciona las opciones disponibles. Después envía el enlace al cliente. Para ello no necesitas una interfaz de pago propia ni una integración de servidor.
Si tienes una tienda en línea o una aplicación con pedidos, resulta más práctico crear una factura para cada compra. La factura establece un importe, un plazo de validez y un estado propio. Tu servidor guarda su relación con el pedido y recibe las notificaciones de pago. Así puede conceder acceso automáticamente o enviar el pedido pagado para su preparación.
El flujo de depósitos se utiliza cuando el usuario primero recarga un saldo dentro de tu servicio y después lo gasta en prestaciones. Cryptanio informa de la entrada de fondos; tu aplicación implementa las reglas para abonar, descontar y mostrar ese saldo interno.
| Tu objetivo | Por dónde empezar |
|---|---|
| Recibir un pago puntual mediante un enlace | Una página de pago creada en la cuenta |
| Registrar automáticamente el pago de cada pedido | Facturas y un webhook |
| Aceptar recargas del saldo de los usuarios | Direcciones de depósito y contabilidad en el servidor |
Si el sitio solo describe tus servicios, basta con añadirle un enlace de pago. Una integración con la API tiene sentido cuando el resultado del pago debe cambiar el estado de tu producto.
Prepara el proyecto y las direcciones
Entra en tu cuenta de Cryptanio y elige un proyecto para el sitio o servicio. Los proyectos mantienen separadas las direcciones, los ajustes y los eventos de distintos productos.
Prepara una dirección de cartera para la red elegida. Para recibir USDT o USDC del modo descrito aquí, necesitas una dirección pública de recepción. No tienes que proporcionar la frase de recuperación ni una clave privada que permita gastar los fondos.
Además de guardar la dirección en la libreta, debes conectarla al proyecto para el servicio correspondiente. Por ejemplo, las facturas utilizan direcciones del servicio «Pagos», mientras que las páginas compartidas mediante enlaces utilizan «Enlaces». Antes de empezar a cobrar, comprueba que la conexión está activa. Que una dirección aparezca en la lista general no significa que el servicio deseado la utilice.
Configura los pagos en USDT
Para USDT, selecciona primero una combinación de token y red compatible. Confírmala con el pagador antes de enviarle el enlace o la factura. Que dos carteras muestren el mismo nombre USDT no demuestra que la transferencia vaya a realizarse en la misma red.
La página de pago debe dejar claros tres datos: qué activo enviar, en qué red y a qué dirección. En una integración automática, muestra el importe y la dirección que devuelva esa factura concreta. El importe puede incluir decimales adicionales necesarios para distinguir los pagos.
Si compruebas manualmente el contrato del token, utiliza la lista de protocolos y direcciones de Tether. Que el emisor admita una red y que el servicio de pagos admita esa misma red son condiciones diferentes; para recibir el pago deben cumplirse ambas.
Configura los pagos en USDC
Para USDC también debes comprobar la red y el token exacto compatible. En una misma red puede haber activos con nombres parecidos, incluidas versiones transferidas mediante puentes. Utiliza el identificador concreto indicado en los ajustes de recepción.
Las direcciones oficiales de USDC se publican en la documentación de Circle. Estos datos permiten verificar el token, pero no sustituyen la comprobación de su disponibilidad en Cryptanio.
Si aceptas tanto USDT como USDC, preséntalos como opciones de pago distintas. No puedes considerar que una transferencia de un token paga una factura del otro solo porque sus valores sean similares.
Decide cómo confirmar los pedidos
Para trabajar de forma manual, puedes seguir los eventos en tu cuenta y recibir mensajes en Telegram o Discord. Comprueba la red, el activo, la dirección, el importe realmente recibido y el estado de la transferencia. Una captura de pantalla del cliente o la aparición de una transacción sin confirmar no bastan para entregar un producto.
Para automatizar el proceso, configura un webhook: una notificación con datos del evento que Cryptanio envía a tu servidor. El servidor verifica la firma del mensaje, localiza el pedido asociado y comprueba el estado de la factura. La entrega repetida de un evento no debe provocar una segunda entrega del producto ni un doble abono.
Una transferencia confirmada y un pedido completamente pagado son hechos distintos. El cliente podría haber enviado menos de lo necesario o haber pagado una factura caducada. Define de antemano cómo tratar estas situaciones. Prevé también la reversión de una confirmación tras una reorganización de la cadena de bloques.
Comprueba todo el recorrido del pago
Antes de colocar el botón de pago, comprueba que el pagador ve los datos correctos y que puedes encontrar el resultado en el proyecto adecuado. Asegúrate de que la notificación llega al destinatario elegido y de que el pedido cambia de estado solo después de las verificaciones necesarias.
Una prueba con una transferencia real requiere fondos y una comisión de red. Si decides hacerla, utiliza tus propias carteras, una red compatible y un importe pequeño que respete los límites del método elegido. Termina la comprobación conciliando el importe recibido y el estado, no solo abriendo la página de pago.
Comprende los costes y la moneda de la factura
El precio de un pedido puede guardarse en dólares como unidad de cuenta, aunque el pago se realice en la criptomoneda elegida. Eso no significa recibir dólares en una cuenta bancaria ni convertir automáticamente las monedas recibidas en dinero fiduciario.
En la API, los campos del precio del pedido y del importe esperado en criptomonedas tienen funciones distintas. Enviarlos no inicia por sí mismo una conversión de fondos. En la página de pago, el cliente necesita ver el importe del activo elegido que debe enviar.
Consulta las condiciones de uso de Cryptanio en la página de precios. Ten en cuenta por separado la comisión de la cadena de bloques: depende de la red y de la cartera del remitente. No reduzcas el importe de la factura en una comisión estimada sin una regla expresa para tratar los pagos insuficientes.
Elige el siguiente paso
Si quieres gestionar los pagos manualmente, empieza por «Cómo crear un enlace de pago en criptomonedas sin sitio web ni programación». Para recibir notificaciones, utiliza las instrucciones de Telegram y Discord de esta colección.
Si el sitio debe entregar el producto automáticamente después de la compra, continúa con «Cómo confirmar automáticamente el pago de un pedido mediante webhook». La API pública compatible se describe en la documentación de Cryptanio.