API para comerciantes (Desarrolladores)
La API para comerciantes: apps, facturas, transferencias y webhooks.
¿Qué es la API para comerciantes?
La API para comerciantes es la API de pagos de la app para negocios y bots. Creas una app, obtienes un token de API y lo usas para cobrarles a los usuarios de Telegram, enviarles pagos y consultar tu saldo, todo desde tu propio código.
Empezar como desarrollador
Crea una app en la Mini App, copia su token de API una vez y empieza a llamar a la API. Toda la configuración vive en Más → API para comerciantes.
Conectar un agente de IA
Dale a tu agente de IA una sola URL —https://app.tgcryptopay.com/mcp— y él te arma la integración de pagos: lee la documentación de la API, crea tu app de comerciante, configura los webhooks y escribe el código. Tú apruebas la app nueva una vez, con un botón en el bot. Sin terminal y sin token de API que copiar a mano.
Aceptar pagos con facturas
Una factura es la forma de cobrarle a un usuario de Telegram. Creas una por la API, le envías su enlace a quien paga y el saldo de tu app se acredita en el instante en que esa persona confirma.
Comisiones y límites de la API para comerciantes
Las facturas llevan una comisión de la plataforma que sale de lo que recibes; las transferencias y los cheques están acotados por límites de monto. Las cifras de abajo son la configuración vigente, no condiciones contractuales: cuando no coincidan con lo que ves, la app tiene razón, y la fuente confiable son siempre tus propias facturas pagadas.
Referencia de la API para comerciantes
Las convenciones que comparten todos los métodos, más los métodos de catálogo de solo lectura. Las páginas método por método: facturas y reembolsos, transferencias y cheques, suscripciones, webhooks.
Referencia de la API: facturas y reembolsos
Los métodos de facturas: createInvoice, getInvoices, deleteInvoice, refundInvoice. Las convenciones (autenticación, envoltorio, montos, spend_id) están en la página de referencia de la API para comerciantes; el recorrido guiado es Aceptar pagos con facturas.
Referencia de la API: transferencias y cheques
Los métodos de pago. Una transferencia envía fondos del saldo de tu app directo a la billetera de un usuario de Telegram; un cheque es un enlace canjeable que financias por adelantado. Las convenciones (autenticación, envoltorio, montos, spend_id) están en la página de referencia de la API para comerciantes.
Referencia de la API: suscripciones
Cobros recurrentes: una extensión sobre Crypto Bot. Creas un plan (monto + período), les envías a los usuarios su enlace de aprobación y la plataforma les cobra del saldo de su billetera cada período, acreditando el saldo de tu app neto de comisión. Las convenciones están en la página de referencia de la API para comerciantes.
Referencia de la API: webhooks
Los webhooks le envían los eventos a tu servidor en el momento en que ocurren. Pon la URL del webhook en tu app, en Más → API para comerciantes; a partir de ahí la plataforma hace POST de un cuerpo JSON firmado por cada evento al que estés suscrito.