TgPay Crypto
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 está en Más → API para comerciantes.
Conectar un agente de IA
Conecta un agente de programación con IA que admita servidores MCP remotos a https://app.tgpaycrypto.com/mcp. Puede leer la documentación de la API, solicitar una app de comerciante, configurar webhooks y ayudarte a escribir la integración. Tú apruebas la creación de la app en el bot; el agente recibe un token restringido sin que tengas que copiarlo a mano. Revisa y prueba la integración antes de aceptar pagos reales.
Aceptar pagos con facturas
Una factura te permite cobrarle a un usuario de Telegram. La creas por la API y le envías el enlace. Cuando el pago se completa, el monto se abona al saldo de tu app, descontando la comisión para comerciantes.
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. Consulta los detalles de cada método en estas páginas: 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, estructura de respuesta, 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
Estos métodos permiten enviar pagos. Una transferencia envía fondos del saldo de tu app a la billetera de un usuario de Telegram o los retiene hasta que un nuevo destinatario abra el bot. Un cheque es un enlace canjeable que financias por adelantado. Las convenciones (autenticación, formato de las respuestas, 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 envían eventos a tu servidor después de que ocurren. Pon la URL del webhook (opcional) 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.
Condiciones de la API para comerciantes
Estas condiciones rigen la API para comerciantes: las apps, los tokens de API, las facturas, las suscripciones, las transferencias, los cheques, los webhooks y la conexión de agentes de IA. Se aplican además de las condiciones generales de uso de la app y de su política AML. Al crear una app las aceptas; si sigues usando una app creada antes del 7 de septiembre de 2026, también las aceptas.
¿Necesitas más ayuda? Escríbele a soporte.
Puedes enviarle un mensaje a soporte por Telegram en cualquier momento. Nadie de soporte te va a pedir tu PIN ni un código de tu correo.