Los pagos en Telegram permiten que un comprador pague a un bot o a una Mini App sin salir del chat. El bot envía una factura, Telegram abre su propia ventana de pago y el dinero llega al vendedor a través de un proveedor de pagos (para productos físicos) o en Telegram Stars (para productos digitales). En esta guía te explicamos cómo funcionan los pagos en Telegram, qué opción encaja con lo que vendes, cuánto cuesta cada una y cómo empezar a cobrar paso a paso, con o sin código.
¿Buscas la lista completa de métodos que puede conectar una tienda, incluidos TON y las billeteras del sudeste asiático? Está en métodos de pago en Telegram. Esta página trata de cómo funcionan los pagos en Telegram y cómo activarlos.
Cómo funcionan los pagos en Telegram#
La Bot Payments API de Telegram es una plataforma gratuita y abierta. Tiene dos carriles:
- Los productos físicos y los servicios se pagan a través de proveedores externos. Telegram trabaja con más de 20 y los compradores pueden pagar desde más de 200 países. Telegram no cobra comisión por estos pagos ni guarda los datos de la tarjeta: de la tarjeta se encarga el proveedor. La ventana de pago de Telegram admite Apple Pay y Google Pay.
- Los productos y servicios digitales deben pagarse en Telegram Stars, con el código de moneda
XTR. Telegram advierte que puede dejar de mostrar tu bot o tu Mini App a los usuarios de móvil si vendes productos digitales en otras monedas o mediante proveedores externos.
Un pago siempre sigue el mismo camino:
- Factura. El bot envía una factura con los artículos y el total (
sendInvoice), o una Mini App la abre desde un enlace. - Envío (opcional). Si el costo de envío depende de la dirección, Telegram primero le pide al bot las opciones de envío.
- Verificación previa al cobro. Antes de cobrar, Telegram le pide al bot que confirme el pedido. El bot tiene 10 segundos para responder; si no, el pago se cancela.
- Pago. El comprador confirma en la ventana de pago: tarjeta, Apple Pay, Google Pay o Stars.
- Confirmación. El bot recibe un mensaje
successful_paymenty entrega el pedido.
Qué opción encaja con lo que vendes#
| Opción | El comprador paga con | Para | Lo que se queda Telegram | Configuración |
|---|---|---|---|---|
| Telegram Stars | Saldo de Stars | Productos digitales: archivos, accesos, membresías | El vendedor recibe unos $0.013 por Star | Nada que conectar |
| Proveedor de tarjetas vía @BotFather (Stripe, Freedom Pay y otros) | Tarjeta, Apple Pay, Google Pay en la ventana de Telegram | Productos físicos y servicios presenciales | Nada; el proveedor cobra su propia comisión | Un token del proveedor |
| Stripe Connect (Tiny Shops) | Tarjeta en la página de pago segura de Stripe | Productos físicos en países con Stripe | Nada; se aplica la comisión de Stripe | Alta en Stripe desde el panel |
| TON | Cualquier billetera TON | Compradores que usan cripto, ventas internacionales | Nada | Una dirección de billetera |
| Pedido manual | Lo que acuerden: efectivo, transferencia | Entrega local, pago contra entrega | Nada | Nada |
Las comisiones de los proveedores varían según el país y el contrato. Stripe publica sus tarifas en stripe.com/pricing; proveedores como Freedom Pay las fijan en tu contrato. Consulta a tu proveedor, no una tabla de un blog, para saber la cifra que te aplica.
Telegram Stars en resumen#
Los compradores consiguen Stars mediante compras dentro de la app de Apple o Google o con @PremiumBot, y luego las gastan en bots y Mini Apps. Para el vendedor, los términos para desarrolladores de bots de Telegram fijan su valor:
- Unos $0.013 por Star como recompensa, procesada a través de Fragment.
- $0.02 por Star si en cambio gastas el saldo en Telegram Ads.
- Hasta 21 días antes de que las Stars recibidas estén disponibles para recompensas o anuncios.
Las Stars solo admiten números enteros, no hay propinas y Telegram no comparte el nombre, el teléfono ni la dirección del comprador en un pago con Stars. Los reembolsos se hacen a través de la Bot API (refundStarPayment), y un bot que vende por Stars debe responder al comando /paysupport. La comparación completa con las tarjetas, con una tabla de conversión de Stars a USD, está en Telegram Stars vs Stripe.
Cómo aceptar pagos en Telegram (la forma general)#
Si programas el bot tú mismo, estos son los pasos según la documentación de Telegram:
- Crea un bot con @BotFather. Nuestra guía del bot te lleva paso a paso.
- Consigue un token de proveedor. En @BotFather:
/mybots→ tu bot → Bot Settings → Payments. Elige un proveedor, completa su registro y copia el token. Empieza con el de prueba. Para Stars, sáltate este paso: el token es una cadena vacía. - Envía facturas desde tu código con
sendInvoiceocreateInvoiceLink, en una moneda que tu proveedor admita. - Responde a la consulta previa al cobro (pre-checkout) en menos de 10 segundos, y a la consulta de envío si usas envío flexible.
- Procesa
successful_payment: marca el pedido como pagado y envía el producto. - Completa la lista de verificación de Telegram para operar en real: verificación en dos pasos en la cuenta dueña del bot, un comando
/termsque los compradores aceptan, un comando/supporty estar listo para gestionar tú mismo disputas y contracargos. Después cambia el token de prueba por el real (lleva:LIVE:en medio).
Un creador de tiendas hace por ti los pasos 3 a 5, además del catálogo, el carrito y los avisos de pedidos.
Cómo aceptar pagos de Telegram en Tiny Shops#
Tiny Shops es un creador de tiendas Mini App para Telegram sin código. Tu tienda se abre dentro de tu propio bot y el pago termina en la ventana de pago de Telegram.
Tarjetas a través de un proveedor de Telegram#
- Consigue un token de prueba en @BotFather →
/mybots→ el bot de tu tienda → Bot Settings → Payments. Guías paso a paso para dos proveedores: Stripe y Freedom Pay. - Abre Storefront Settings → Orders & Payments. En Checkout Mode, elige Telegram Payments.
- Haz clic en Add Provider. Rellena Provider Name (cualquier nombre, por ejemplo "Stripe"), pega el token en Provider Token, deja activados Test Mode y Active, y haz clic en Save Provider.
- Revisa la moneda de la tienda en Store Currency. Tiene que ser una que tu proveedor admita. Si un pago falla con
PAYMENT_PROVIDER_INVALID, la causa habitual es la moneda. - Abre Checkout → Payment methods y asegúrate de que Telegram Invoice está en la lista. Si no está, haz clic en Add method y agrégalo. Aparece como Connected en cuanto existe un proveedor activo.
- Elige los campos de la factura. En Invoice Field Configuration, activa Request Name, Request Phone Number, Request Email o Request Shipping Address según lo que necesites. Flexible Shipping Pricing permite que el precio del envío dependa de la dirección. Enable Tips agrega hasta 4 montos de propina sugeridos y un Maximum Tip Amount.
- Haz un pedido de prueba desde tu teléfono. Con un token de prueba de Stripe, usa la tarjeta de prueba de Telegram
4242 4242 4242 4242, cualquier fecha futura y cualquier CVC. - Pasa a modo real. Toma el token real de @BotFather, haz clic en Edit Provider, pégalo, desactiva Test Mode y guarda.
Telegram Stars#
- En Storefront Settings → Orders & Payments, elige Telegram Payments y después configura Store Currency como Telegram Stars (XTR). La página muestra Telegram Stars Enabled: no hace falta token ni ajustes.
- En Checkout → Payment methods, agrega Telegram Stars.
- Pon precio a tus productos en Stars enteras.
Una tienda tiene una sola moneda, así que acepta o Stars o un proveedor de tarjetas. Si vendes tanto paquetes físicos como productos digitales, llévalos como dos tiendas en una misma cuenta.
Otras opciones#
Stripe Connect (tarjetas en la página de pago de Stripe, con pagos a tu propia cuenta de Stripe), TON, Xendit para Indonesia, Filipinas y Malasia, y Pedido manual se configuran todos desde Checkout → Payment methods. Los pasos de cada uno están en métodos de pago en Telegram.
Apple Pay y Google Pay en Telegram#
No tienes que activar las billeteras por separado. La ventana de pago de Telegram admite Apple Pay y Google Pay, y aparecen cuando tu proveedor y el dispositivo del comprador los admiten. Si un comprador no ve Apple Pay, comprueba si tu proveedor lo ofrece en tu país. Los pagos con Stars no usan billeteras: el comprador paga con su saldo de Stars.
Cuánto cuesta#
Telegram no se queda con nada en los pagos con proveedor; tu proveedor cobra su propia comisión. Tiny Shops cuesta $0 en Free, $9.99 en Starter, $29 en Pro y $79 en Scale al mes, y cada pedido paga el porcentaje del plan sobre su total: 5%, 3%, 1.5% o 0.7%. Cada cuenta recibe sus primeros 50 pedidos gratis, una sola vez, no cada mes. Las ventas con Stars pagan el porcentaje desde la primera venta. Pro paga como máximo $149 al mes en porcentaje, Scale como máximo $79. Detalles en precios.
Solución de problemas#
| Síntoma | Causa probable | Solución |
|---|---|---|
El pago falla con PAYMENT_PROVIDER_INVALID | El proveedor no admite la moneda de tu tienda | Cambia Store Currency o pregunta al proveedor qué monedas acepta |
| Telegram Invoice aparece como Not connected | No hay un proveedor activo | Agrega uno en Orders & Payments y deja Active activado |
| Stars no aparece en el pago | La moneda de la tienda no es XTR | Configura Store Currency como Telegram Stars (XTR) |
| Los pagos de prueba funcionan, los reales no | Sigues con el token de prueba | Pega el token real y desactiva Test Mode |
| No llega el aviso de pedido | No hay destino para los avisos | Configúralo en Order Notifications y pulsa Send test order alert |
Preguntas frecuentes#
¿Cómo funcionan los pagos en Telegram? El bot envía una factura, Telegram muestra una ventana de pago nativa, el comprador paga con tarjeta, billetera o Stars, y el bot recibe una confirmación y entrega el pedido. Las tarjetas pasan por un proveedor externo; las Stars se quedan dentro de Telegram.
¿Telegram cobra comisión por los pagos? No en los pagos a través de proveedores externos; el proveedor cobra su propia comisión. Con Stars, el vendedor recibe unos $0.013 por Star como recompensa, según los términos para desarrolladores de Telegram.
¿Puedo aceptar Apple Pay en Telegram? Sí, cuando tu proveedor lo admite. Apple Pay y Google Pay aparecen en la ventana de pago de Telegram sin configuración adicional en la tienda.
¿Puedo vender productos digitales con tarjeta en Telegram? No dentro del bot ni de la Mini App. Telegram exige Stars para los productos y servicios digitales, y puede ocultar a los usuarios de móvil un bot que los venda en otras monedas.
¿Necesito un desarrollador? No, si usas un creador de tiendas. En Tiny Shops la configuración es un token de @BotFather y unos pocos ajustes en el panel.
Abre tu tienda y recibe tu primer pago en Telegram en tiny-shops.com →
