Aceptar pagos en Telegram
Esta solución es para servicios que venden a través de Telegram: un bot que envía enlaces de pago en un chat, o una mini app, es decir, una aplicación web que se abre dentro de Telegram. Tus clientes pagan sin salir de Telegram, el bot confirma el pedido en el chat y el dinero llega a tu saldo de Volet.com, listo para retirarlo o para pagar a socios.
¿Es para ti?
Esta solución te conviene si:
- Vendes mediante un bot un servicio que se usa fuera de Telegram: una VPN, hosting, un producto SaaS, consultorías, clases o una reserva.
- Vendes productos físicos mediante un bot o una mini app.
- Permites que los usuarios recarguen desde Telegram un saldo en tu propio servicio.
- Pagas a socios o usuarios con el dinero que cobra tu bot.
Una cuenta personal es suficiente. Solo necesitas una cuenta Business si los pagos deben hacerse a nombre de una empresa o tus volúmenes superan los límites de una cuenta personal. Consulta Elegir una cuenta personal o de empresa.
Busca otra opción si:
- Vendes bienes digitales o contenido que se usan dentro de Telegram: publicaciones de pago, artículos de juegos, acceso a un canal privado. Para ellos, Telegram exige su propia moneda, Telegram Stars; consulta Comprueba qué permite Telegram más abajo.
- Manejas el bot por tu cuenta y recién empiezas. Consulta Lanzar un servicio en línea de pago; todo lo que dice esta página sobre Telegram también se aplica.
- También pagas a contratistas, socios o usuarios desde el mismo saldo. Para la parte de los pagos salientes, consulta Permitir recargas y retiros a tus usuarios.
Comprueba qué permite Telegram
Telegram exige Telegram Stars para los bienes y servicios digitales que se venden y se usan dentro de un bot o una mini app. No puedes venderlos por cripto a través de una pasarela de pago. Consulta en Telegram payments for digital goods y Bot Developer Terms.
Una pasarela de pago como Volet.com sirve para todo lo demás: servicios que se usan fuera de Telegram, productos físicos, recargas de un saldo en tu propio servicio, pagos a socios y liquidaciones entre empresas.
Qué puedes hacer
Aceptar pagos
- Permite que los clientes paguen en cripto desde cualquier billetera externa, por ejemplo USDT en Tron o TON, o desde su saldo de Volet.com. Quienes pagan en cripto no necesitan una cuenta de Volet.com. — Pagos cripto custodiales, Pagos desde una cuenta de Volet.com
- Abre la página de Hosted Checkout dentro de la mini app: se carga en el navegador integrado de la app, con tu logo y los colores de tu marca. — Crear una pasarela de pago
- Crea tu propia pantalla de pago en el chat o en la mini app con la API y muestra tú mismo la dirección y el monto. — Integración por API
- Indica en la pasarela la dirección de tu bot, por ejemplo
https://t.me/example_bot: los clientes la ven en la página de pago. — Configurar los ajustes - Preselecciona el método de pago y el idioma de la página de pago para tu audiencia. — Configuración avanzada de Hosted Checkout
Guardar y usar el dinero
- Recibe cada pago en la moneda que elijas, sin importar con qué pagó el cliente; USD, USDT y USDC se convierten 1:1. — Liquidación y conversión automática
- Paga a socios o usuarios desde el mismo saldo, o retira a una cuenta bancaria, una tarjeta o una billetera cripto. — Retirar o enviar fondos
Quién hace qué
| Requisitos | Qué ve y hace | Responsabilidades | |
|---|---|---|---|
| Tú | Una cuenta de Volet.com verificada, personal o Business, una pasarela de pago aprobada, un bot creado en @BotFather, un backend | Creas la solicitud de pago, envías el botón de pago o abres la página de pago, confirmas el pedido en el chat | Cumplir las reglas de Telegram, tu producto y su entrega, los reembolsos, el soporte al cliente en el bot |
| Tus clientes | Telegram y una billetera cripto o una cuenta de Volet.com | Tocan el botón en el chat o pagan dentro de la mini app, ven la página de pago de Volet.com con la dirección de tu bot | Pagar por la red que se muestra en la página |
| Telegram | — | Aloja tu bot y tu mini app | Sus propias reglas para pagos en bots, incluido Telegram Stars para bienes digitales |
| Volet.com | — | Aloja la página de pago, supervisa la blockchain, verifica las cripto entrantes (AML), convierte monedas, notifica a tu backend | El procesamiento de pagos y el soporte para problemas con pagos. No entrega tu producto ni reembolsa a tus clientes |
Cómo se mueve el dinero
- El cliente elige un producto en tu bot o mini app.
- Tu backend crea una solicitud de pago en Volet.com y guarda el ID de usuario de Telegram con el pedido.
- El bot envía un botón de pago o la mini app abre la página de pago.
- El cliente paga en cripto o desde su saldo de Volet.com. En el caso de cripto, Volet.com espera las confirmaciones de la red y verifica el pago.
- El pago se acredita en tu cuenta en tu moneda de liquidación y está disponible de inmediato.
- Volet.com envía una notificación a tu backend; el bot confirma el pedido en el chat y entrega el producto.
Cómo configurarlo
Paso 1: Crea una pasarela de pago
Empieza con Hosted Checkout: Volet.com aloja la página de pago, funciona dentro de una mini app y admite pagos en cripto y con saldo. Elige la API si quieres que la pantalla de pago forme parte de tu chat o mini app. En la configuración de la pasarela, ingresa la dirección de tu bot, activa la firma digital, decide si aceptas pagos insuficientes y pagos en exceso, y configura la Status URL de tu backend. La aprobación suele tardar unas horas. Consulta Crear una pasarela de pago y Elegir un método de integración.
Paso 2: Crea un bot en Telegram
- Abre @BotFather en Telegram y crea un bot con el comando
/newbot. - Guarda el token del bot. Tu backend lo usa para enviar mensajes a través de la Telegram Bot API.
- Para abrir una interfaz web dentro de Telegram, crea una mini app en @BotFather e indica la URL de tu aplicación web. Consulta Telegram Mini Apps.
Para tu primer bot, sigue el tutorial de bots de Telegram.
Paso 3: Muestra la página de pago
- En el chat de un bot: envía un mensaje con un botón inline que abre tu URL de pago. Consulta InlineKeyboardButton.
- En una mini app: abre la página de Hosted Checkout dentro de la mini app o en el navegador del dispositivo con
Telegram.WebApp.openLink. Consulta Telegram Mini Apps.
Tu backend crea la solicitud de pago antes de que se abra la página, para que el bot pueda asociar el pago con el pedido. Consulta Integración de Hosted Checkout.
Paso 4: Confirma el pedido en el chat
Cuando tu backend reciba la notificación de pago y verifique su firma, envía al cliente un mensaje desde el bot y entrega el producto. No dependas de que el cliente vuelva al chat o a la mini app.
Paso 5: Recibe el primer pago a través del bot
Volet.com no tiene sandbox, así que el primer pago es real: paga tú mismo un monto pequeño a través del bot, desde una billetera cripto y desde una cuenta de Volet.com, y comprueba que la confirmación llega al chat. Integrar un bot pequeño lleva alrededor de un día. A partir de ahí, cada venta llega a tu saldo; retírala, guárdala en stablecoins o úsala para pagar a socios. Consulta Retirar o enviar fondos.
Opción de autocustodia
En una mini app, los clientes también pueden pagar directamente desde su propia billetera a la tuya, a través de un contrato inteligente de Volet.com. Esto conviene a bots para audiencias cripto y a proyectos que deben custodiar ellos mismos los fondos.
- La mini app conecta la billetera del cliente. Telegram exige TON Connect para conectar billeteras dentro de una mini app.
- El cliente confirma el pago en su billetera, en USDT, USDC o un token nativo en una red admitida, incluida TON.
- El pago llega a tu billetera; tu backend comprueba la transacción en la blockchain y el bot confirma el pedido en el chat.
- Para retirar a fiat o pagar a socios a través de Volet.com, envía parte de las cripto a tu cuenta de Volet.com. Una recarga a una dirección permanente de tu billetera cripto, en la misma moneda, no tiene comisión de Volet.com. Consulta Agregar fondos.
Qué cambia: los clientes pagan solo desde billeteras y pagan las comisiones de red; no hay conversión automática; la configuración se hace de forma individual con el equipo de ventas, que también puede adaptar el contrato a la lógica de tu bot, por ejemplo suscripciones o acceso con token (token-gated). Consulta Desarrollo de contratos inteligentes a medida. Consulta Aceptar pagos cripto no custodiales y Aceptar cripto en tu propia billetera.
En el día a día
- Suscripciones. Los pagos cripto no se cobran automáticamente cada mes. Permite que los clientes recarguen un saldo en tu servicio y descuenta de él la suscripción según tu calendario, o envía un nuevo botón de pago antes de cada período.
- Pagos que llegan tarde o incompletos. Una solicitud de pago cripto es válida durante 60 minutos sin conversión y 15 minutos con conversión. Un pago tardío se devuelve al cliente o, en algunos casos, se te acredita a ti. Tu configuración de pagos insuficientes y pagos en exceso decide si un pago menor o mayor completa el pedido. Consulta Gestión de pagos.
- "Pagué, pero el bot no responde". Revisa el estado del pedido en tu backend o mediante la API antes de responder; puede que el cliente haya pagado por otra red o después de que venciera la solicitud. Consulta Un cliente dice que el pago está confirmado, pero el pedido no está pagado.
- Reembolsos. Volet.com no cancela pagos completados. Reembolsa a los clientes tú mismo, por ejemplo con una transferencia a su cuenta de Volet.com o con un pago cripto.
- Bots falsos. Indica a los clientes cuál es tu bot y nunca les pidas que conecten una billetera o paguen fuera de tu bot y tu mini app oficiales.
- Contabilidad. Descarga estados de cuenta y guarda el ID de usuario de Telegram y el ID del pedido con cada pago. Consulta Estados de cuenta.
Ten en cuenta
- Las reglas de Telegram van primero. Los bienes digitales que se usan dentro de Telegram se pagan con Telegram Stars. Si aceptas pagos desde la propia billetera del cliente dentro de una mini app (pagos no custodiales), Telegram exige TON Connect para conectar la billetera. Los pagos a través de Hosted Checkout o la API no conectan ninguna billetera.
- Revisión de la pasarela. Volet.com revisa cada pasarela nueva y el bot o sitio web que atiende.
- Verificación AML. Los pagos cripto entrantes se verifican; por lo general, dentro del tiempo normal de procesamiento. Consulta Verificación de transacciones.
- Transacciones definitivas. Los pagos confirmados en la blockchain no se pueden cancelar ni revertir.
- Límites. Tus límites actuales se muestran antes de confirmar cada transacción. Consulta Límites.
Costos
| Comisión | Quién paga | Cuándo |
|---|---|---|
| Comisión de procesamiento | Tú; en los pagos con saldo, puedes sumarla al monto del cliente | En cada pago |
| Comisión de red del pago cripto | Tu cliente | Cuando paga en cripto |
| Conversión | Tú | Cuando el cliente paga en una moneda distinta de tu moneda de liquidación, salvo las conversiones 1:1 entre USD, USDT y USDC |
| Comisiones de retiro o de pago | Tú | Cuando retiras o pagas a socios |
No hay comisiones de alta ni mensuales del lado de Volet.com. Consulta la página de comisiones para empresas. La comisión exacta siempre se muestra antes de confirmar.
Cuando crezcas
- Paga a socios o usuarios desde el saldo del bot. Consulta Permitir recargas y retiros a tus usuarios.
- Agrega un sitio web al mismo saldo con Hosted Checkout o un plugin para CMS. Consulta Lanzar un servicio en línea de pago.
Para conocer las ofertas vigentes, consulta la página del producto pasarela de pagos cripto.
Relacionado
- Integración de Hosted Checkout — solicitudes de pago, notificaciones y firmas
- Integración por API — crea tu propia pantalla de pago
- Falló un pago a un servicio en línea — qué ven tus clientes cuando algo sale mal
- Pagos cripto en mini apps de Telegram — un artículo del blog sobre las reglas y los costos de Telegram
- Calculadora de ahorro en pagos con stablecoins para negocios — una calculadora del blog: cuánto te cuestan hoy los cobros a clientes y los pagos a contratistas, y cuánto con stablecoins