Cómo aceptar pagos con criptomonedas en un bot de Telegram

Para saber cómo aceptar pagos con criptomonedas en un bot de Telegram, primero determina qué está pagando el cliente y qué flujo de pago permite Telegram. Las empresas pueden utilizar transferencias directas entre monederos, Telegram Stars o una pasarela de pagos con criptomonedas externa conectada mediante enlaces de pago o una API. Para automatizar el proceso de pago con criptomonedas, la opción de la pasarela permite crear facturas, confirmar pagos en la cadena de bloques mediante webhooks y activar la entrega o el acceso cuando las normas de Telegram lo permitan.

En resumen

• Telegram no ofrece un proceso de pago nativo con criptomonedas para empresas; los pagos con criptomonedas suelen depender de transferencias entre monederos o de un proveedor externo.

• Telegram Stars es una moneda virtual, no una criptomoneda, y su uso es obligatorio para los bienes y servicios digitales vendidos dentro de los bots y las miniaplicaciones de Telegram.

• Las transferencias entre monederos son sencillas, pero suelen requerir una conciliación manual.

• Una pasarela de pagos con criptomonedas puede automatizar las facturas, las actualizaciones de pago y la entrega de pedidos cuando se permiten métodos de pago de terceros.

3 formas en que las empresas realmente reciben pagos con criptomonedas a través de Telegram

Los pagos con criptomonedas a través de Telegram pueden referirse a tres flujos muy diferentes. Cada método tiene implicaciones distintas en cuanto a automatización, cumplimiento normativo y normas de la plataforma.

Actualmente, Telegram exige el uso de Telegram Stars para los bienes y servicios digitales vendidos dentro de sus bots y miniaplicaciones. Por lo tanto, una API de pagos con criptomonedas de terceros no debe presentarse como una forma de eludir Stars para productos digitales dentro de la aplicación. Para los bienes físicos y los servicios permitidos, puede haber otros métodos de pago disponibles.

Metodología

Esta guía utiliza la documentación oficial de Telegram sobre pagos mediante bots y Stars, así como la documentación actual de la API de pagos de PassimPay. Los ejemplos siguen el flujo de pago desde la creación de una solicitud de pago hasta la recepción de una actualización de estado, la verificación de la llamada de retorno y la activación de la entrega del pedido.

La sección sobre cumplimiento normativo proporciona únicamente información general y no constituye asesoramiento legal, fiscal ni regulatorio.

¿Por qué aceptar pagos con criptomonedas a través de Telegram?

Un bot de Telegram puede combinar la interacción con el cliente y el inicio del pago en un solo flujo. Puede mostrar una factura o un enlace de pago, esperar la confirmación y continuar el recorrido del cliente una vez confirmado el pago.

Para el público internacional, las criptomonedas ofrecen otra vía de pago cuando tanto el comerciante como el cliente pueden utilizarlas legalmente. Los clientes pueden pagar con las criptomonedas admitidas sin depender de un flujo de pago con tarjeta.

La automatización es una de las principales razones para utilizar una API de pagos para bots de Telegram en lugar de limitarse a publicar una dirección de monedero. El bot puede vincular un identificador de pedido con una solicitud de pago, recibir un webhook cuando cambie el estado, actualizar el pedido y activar automáticamente la siguiente acción.

Esto resulta especialmente útil cuando los comerciantes gestionan más que unas pocas transacciones. La conciliación manual de monederos puede servir para pagos ocasionales, pero se vuelve más difícil de gestionar cuando varios clientes envían importes similares al mismo tiempo.

Las transacciones confirmadas en la cadena de bloques tampoco utilizan el mismo mecanismo de contracargos de las redes de tarjetas que los pagos con tarjeta. Los comerciantes siguen necesitando procedimientos de reembolso, atención al cliente, controles antifraude y condiciones de pago claras.

La pasarela de pagos con criptomonedas PassimPay proporciona una infraestructura de pagos que puede conectarse a un bot de Telegram. PassimPay admite 74 criptomonedas y 18+ cadenas de bloques, comisiones desde 0.5%, enlaces de pago y códigos QR, una API de pagos, y webhooks y notificaciones.

Cómo aceptar pagos con criptomonedas en un bot de Telegram paso a paso

La integración adecuada de un bot de pagos de Telegram depende de si necesitas un flujo de pago sencillo o un proceso de pago totalmente automatizado. Los enlaces de pago requieren menos desarrollo, mientras que la integración mediante API proporciona al bot control directo sobre la creación de pagos, el seguimiento del estado y la entrega de pedidos.

Opción 1: Empieza con un enlace de pago o un código QR

• Crea una cuenta de comerciante y completa la verificación.

Regístrate con el proveedor de pagos y completa la verificación empresarial o de identidad requerida. El proceso exacto de incorporación puede depender del proveedor, la entidad comercial, la jurisdicción y el perfil de riesgo.

• Crea la solicitud de pago.

Utiliza Payment Links & QR Codes para generar un enlace de pago o un código QR por el importe requerido. Con PassimPay, el comerciante puede crear una solicitud de pago sin desarrollar una interfaz de pago personalizada.

• Envía el enlace de pago por Telegram.

El bot o un administrador pueden enviar el enlace de pago directamente en un chat privado o mediante otro flujo adecuado de Telegram. El cliente abre el enlace, selecciona la opción de pago disponible y envía el importe requerido.

Guarda una referencia del pedido en tu propio sistema para poder vincular la transacción con el cliente y la compra correspondientes.

• Confirma el pago antes de entregar el producto o prestar el servicio.

Si el número de transacciones es reducido, el comerciante puede verificar el pago a través del panel del proveedor antes de entregar el producto o prestar el servicio.

Este enfoque es relativamente sencillo de poner en marcha porque no requiere una integración completa de una API de pagos para bots de Telegram. Sin embargo, la verificación manual pierde eficiencia a medida que aumenta el volumen de transacciones.

Opción 2: Desarrollar una integración completa de una API de pagos para bots de Telegram

La integración mediante API es más adecuada cuando el bot necesita generar solicitudes de pago y procesar los estados de pago automáticamente.

• Configura el acceso a la API y conecta el bot con la creación de pagos.

Después de crear la cuenta de comerciante, configura la plataforma necesaria y obtén las credenciales requeridas para las solicitudes a la API, como una clave de API y un identificador de plataforma. PassimPay exige que las solicitudes a la API estén firmadas y que la firma se incluya en las cabeceras de la solicitud.

Guarda las credenciales de la API en el servidor. No deben exponerse en mensajes de Telegram, en el código de la interfaz de una Mini App ni en otros componentes del lado del cliente.

Cuando un cliente selecciona un producto o servicio, el bot de Telegram envía la solicitud a tu backend, que a continuación se comunica con el proveedor de pagos. Según el modelo de integración, el proveedor puede devolver una dirección de pago en criptomonedas o un enlace de factura que el bot envía al cliente.

• Asocia cada pago con un pedido.

Crea un identificador de pedido único para cada solicitud de pago. Debe permitir que tu sistema vincule al usuario de Telegram, el producto o servicio, el importe esperado, la criptomoneda seleccionada y el estado del pago.

Esto es importante porque varios clientes pueden pagar aproximadamente al mismo tiempo. El importe por sí solo no debe utilizarse como el método principal para identificar un pedido.

• Configura y verifica los webhooks.

Establece una URL de notificación que apunte a un endpoint controlado por el comerciante. Cuando cambia el estado del pago, el proveedor envía un webhook a este endpoint, lo que permite al backend actualizar el pedido correspondiente.

Con PassimPay, la URL de notificación se configura en los ajustes de la plataforma. Antes de procesar un webhook, verifica la cabecera x-signature y comprueba que la dirección IP del remitente figure entre las direcciones IP autorizadas de PassimPay. No deben aceptarse solicitudes procedentes de direcciones IP desconocidas o no autorizadas.

• Gestiona las notificaciones duplicadas y devuelve HTTP 200.

El procesamiento de webhooks debe ser idempotente para que una misma transacción no pueda activar la entrega del producto o la prestación del servicio más de una vez.

Esto es especialmente relevante para BTC, LTC, DASH, Dogecoin y Bitcoin Cash. PassimPay puede enviar hasta dos notificaciones webhook para la misma transacción: una después de la primera confirmación y otra después de la segunda. Si la transacción se detecta por primera vez después de dos confirmaciones, es posible que solo se envíe una notificación.

Después de procesar correctamente una notificación de depósito válida, el servidor debe devolver HTTP 200. Si PassimPay no recibe HTTP 200, pueden realizarse dos intentos adicionales de entrega del webhook.

• Activa la entrega del producto o la prestación del servicio y prueba el flujo completo.

Una vez confirmado el estado de pago requerido, actualiza el pedido e indica al bot que continúe el flujo del cliente. Según el caso de uso, esto podría implicar confirmar un pedido, programar una entrega, notificar a un administrador o realizar otra acción de servicio permitida. 

No marques un pedido como pagado únicamente porque el cliente envíe una captura de pantalla o un hash de transacción. Antes del lanzamiento, prueba los pagos exitosos, las confirmaciones demoradas, las notificaciones duplicadas, las firmas no válidas, los errores temporales del servidor y los casos en los que un cliente crea una solicitud de pago pero nunca la completa.

Payment API y Payment Links & QR Codes de PassimPay cubren ambos modelos de integración: enlaces de pago para una implementación más sencilla y procesamiento basado en API para flujos de trabajo automatizados.

Telegram Stars frente a los pagos en criptomonedas

Telegram Stars y los pagos en criptomonedas tienen finalidades diferentes.

Telegram Stars son artículos virtuales que se utilizan dentro de Telegram. Los usuarios adquieren Stars a través de los flujos de compra compatibles de Telegram y pueden utilizarlas para pagar bienes y servicios digitales ofrecidos mediante bots y Mini Apps.

Stars no son una criptomoneda. Telegram controla su flujo de pago y exige su uso para los bienes y servicios digitales que se venden dentro de sus aplicaciones.

Los pagos en criptomonedas utilizan activos de blockchain como BTC, USDT, ETH u otras criptomonedas compatibles. Normalmente requieren una billetera externa o un proveedor de pagos.

Una pasarela de pagos en criptomonedas para Telegram puede conectar el bot con este flujo de pagos en blockchain, pero la posibilidad de que el comerciante utilice un método de pago externo depende de lo que venda.

La misma distinción se aplica a los pagos en Mini Apps de Telegram. Crear una Mini App no supone una excepción para los productos digitales que Telegram exige que se paguen con Stars.

Para bienes físicos y servicios que cumplan los requisitos, pueden utilizarse proveedores de pagos externos cuando las normas de Telegram y las leyes aplicables lo permitan.

Cumplimiento normativo, seguridad y escalabilidad

Aceptar pagos con criptomonedas a través de Telegram significa que el negocio combina una interfaz de mensajería con una infraestructura de pagos externa. Ambas partes del flujo deben tenerse en cuenta al planificar el cumplimiento normativo, la contabilidad y la seguridad.

Comprueba la jurisdicción del negocio

Los requisitos pueden depender del lugar donde esté registrado el comercio, dónde se encuentren los clientes, qué venda el negocio y cómo se gestionen las criptomonedas después del pago.

La simple aceptación de criptomonedas como medio de pago y la prestación de servicios regulados de criptomonedas no siempre reciben el mismo tratamiento. Las empresas deben determinar qué normas se aplican a su modelo específico.

Planifica los procedimientos KYC y AML

Un proveedor de pagos puede exigir la verificación del comercio antes de procesar pagos.

Los proveedores también pueden utilizar la supervisión AML para revisar las transacciones entrantes. PassimPay afirma que está registrado en FINTRAC con el número de registro C100000852 y que aplica controles AML a las transacciones antes de abonar los fondos.

La necesidad de una verificación adicional del cliente puede depender del proveedor, la jurisdicción, el tipo de transacción y los requisitos de cumplimiento normativo aplicables.

Conserva los registros de pagos

Los pagos con criptomonedas también deben registrarse a efectos contables y de presentación de informes.

Las empresas deben conservar información relevante, como:

• ID del pedido;

• criptomoneda y cadena de bloques;

• importe en criptomonedas;

• valor aplicable en moneda fiduciaria;

• hash de la transacción;

• hora del pago;

• comisiones del proveedor;

• detalles de la liquidación;

• reembolsos, cuando corresponda.

El tratamiento contable y fiscal exigido depende de la jurisdicción.

Gestiona la volatilidad de las criptomonedas

Si un bot recibe pagos en activos volátiles como BTC, el valor de esos fondos puede cambiar después de la transacción.

Los comercios deben decidir si quieren conservar la criptomoneda original o convertir los pagos entrantes en otro activo.

PassimPay ofrece conversión automática a monedas estables, que permite convertir los pagos entrantes en USDT o USDC. Las empresas que prefieran recibir pagos directamente en monedas estables también pueden utilizar una pasarela de pago con USDT.

Protege las credenciales de la API y los puntos de conexión de webhooks

Las claves de la API deben permanecer en el servidor y nunca deben enviarse a los clientes ni almacenarse en código del bot accesible públicamente.

Las firmas de los webhooks deben verificarse antes de cambiar el estado de un pedido. Los comandos administrativos del bot también deben protegerse frente a usuarios no autorizados.

Los eventos de pago deben registrarse para que el comercio pueda investigar posteriormente las transacciones fallidas o en disputa.

Prepárate para escalar

Una configuración que funciona para diez pagos puede no funcionar para miles.

Supervisa las llamadas de retorno fallidas, las confirmaciones retrasadas de la cadena de bloques, las redes no disponibles, las interrupciones del servicio del proveedor y la actividad de pago inusual.

Las empresas también deben contar con un proceso alternativo para los casos en que falle la entrega automática aunque el pago en sí ya se haya confirmado.

Esta es información general, no asesoramiento jurídico. Consulta a un profesional autorizado en materia jurídica, fiscal o de cumplimiento normativo sobre los requisitos aplicables a tu jurisdicción y modelo de negocio.

Preguntas frecuentes

¿Puedo aceptar pagos con criptomonedas directamente en Telegram sin un sitio web independiente?

No siempre se necesita un sitio web independiente. Un bot puede enviar un enlace externo de pago con criptomonedas o conectarse a una API de pagos. Sin embargo, los bienes y servicios digitales vendidos dentro de los bots y las Mini Apps de Telegram deben utilizar actualmente Telegram Stars según las normas de la plataforma Telegram.

¿Cuál es la diferencia entre Telegram Stars y los pagos con criptomonedas?

Telegram Stars son elementos virtuales que se utilizan dentro de Telegram y no son criptomonedas. Los pagos con criptomonedas utilizan activos de cadenas de bloques como BTC o USDT. Telegram exige el uso de Stars para los bienes y servicios digitales dentro de la aplicación, mientras que pueden aplicarse otros métodos de pago a los bienes físicos o servicios que cumplan los requisitos.

¿Es legal aceptar pagos con criptomonedas a través de un bot de Telegram?

La legalidad depende de la jurisdicción del comercio, la ubicación de los clientes, el producto y el flujo de pago. Aceptar criptomonedas puede conllevar obligaciones fiscales, contables, de protección al consumidor, de prevención del blanqueo de capitales (AML) o de obtención de licencias. Las empresas deben revisar las normas locales y las condiciones del proveedor antes de poner en marcha un flujo de pagos con criptomonedas en Telegram.

¿Cómo integro una API de pagos con criptomonedas en mi bot de Telegram?

Conecta el backend del bot a la API de un proveedor de pagos, crea una factura o una dirección de pago para cada pedido, almacena una referencia única del pedido, recibe un webhook firmado después del pago, verifícalo en el servidor, actualiza el pedido y, a continuación, activa la entrega.

¿Con qué rapidez se confirman los pagos con criptomonedas al utilizar un bot de Telegram?

La velocidad de confirmación depende principalmente de la cadena de bloques, el número de confirmaciones requerido, las condiciones de la red y el procesamiento del proveedor. El bot de Telegram en sí no determina el tiempo de liquidación de la cadena de bloques. Algunos pagos pueden actualizarse en cuestión de segundos, mientras que otros pueden requerir varios minutos o más.

¿Necesito una verificación KYC para aceptar pagos con criptomonedas en Telegram?

Por lo general, un proveedor de pagos exigirá la verificación del comercio antes de habilitar los servicios de pago. Que los clientes también necesiten una verificación KYC depende del proveedor, la jurisdicción, el tipo de transacción y los controles de riesgo. La verificación de la cuenta de Telegram no sustituye los controles de cumplimiento normativo del proveedor de pagos.

Lecturas relacionadas

• Cómo aceptar pagos con criptomonedas en tu sitio web de WordPress

• Productos de PassimPay

Reflexiones finales

La respuesta práctica a cómo aceptar pagos con criptomonedas en un bot de Telegram es separar la capa de mensajería de la infraestructura de pagos. Telegram gestiona la interacción con el cliente, mientras que una pasarela de pagos con criptomonedas para Telegram puede gestionar las solicitudes de pago, la confirmación en la cadena de bloques, los webhooks y los registros de transacciones para los flujos de pago admitidos.

Para volúmenes de pago bajos, los enlaces de pago y los códigos QR pueden ofrecer un punto de partida más sencillo. Para el procesamiento automatizado, los comercios pueden conectar una API de pagos para bots de Telegram a su backend y utilizar el estado de pago verificado como desencadenante de la siguiente acción.

Antes del lanzamiento, confirma las reglas de Telegram aplicables a lo que vendes, verifica el proveedor de pagos y el flujo de integración, y asegúrate de tener cubiertos el cumplimiento normativo, la contabilidad, la seguridad y la gestión de los pagos fallidos.