API para comerciantes

Acepta pagos en tu propio bot

Obtén un token, crea facturas desde tu código y procesa los webhooks de pago. Prueba el recorrido completo en la red de pruebas antes de usar fondos reales.

8 monedas · 16 combinaciones de activo y red · un saldo Integra tu agente de IA mediante el servidor MCP →
Pantalla de tokens de API y webhooks
Webhook entregado
Entorno de pruebas
Primeros pasos

Integrar la API para comerciantes

Del token al primer webhook en cuatro pasos. Más sobre la API para comerciantes →

Paso 1

Obtén un token

Crea una aplicación en TgPay y obtén el token de la API para comerciantes.

Paso 2

Crea una factura

Envía una solicitud con monto, moneda y descripción. Configura la URL del webhook en las opciones de la aplicación.

Paso 3

Muestra el enlace de pago

Ofrece un enlace o botón al usuario. El pago se realiza en Telegram.

Paso 4

Procesa el webhook

Recibe la confirmación del pago y entrega el producto o concede el acceso en tu servicio.

Agente de IA

Tu agente de IA puede ayudarte con la integración

La API para comerciantes ofrece un servidor MCP. Comparte su URL: el agente puede leer la documentación, crear la aplicación con tu aprobación, configurar el webhook y escribir el código sin que copies el token manualmente.

  1. Paso 1

    Envía la instrucción al agente

  2. Paso 2

    Autoriza la aplicación en Telegram

  3. Paso 3

    El agente completa la configuración

Proceso, instrucciones por cliente y permisos del token →
Instrucción para tu agente
Connect the tgpay MCP server (https://app.tgpaycrypto.com/mcp) and integrate payments via the TgPay Merchant API.
Funciones

Pagos integrados en tu producto

Crea facturas mediante solicitudes y recibe los estados por webhook. Tú defines el resto del proceso.

Token y entorno de pruebas

Usa un token separado en la red de pruebas para comprobar los cobros antes de operar con fondos reales.

Facturas desde tu código

Crea, cancela y consulta facturas con solicitudes HTTP, sin necesidad de un SDK.

Cobros recurrentes

Ofrece suscripciones: tras la autorización del usuario, los cobros se ejecutan según el calendario mediante la API para comerciantes.

Webhooks de pago

Se envía un evento después del pago. Si falla la entrega, se reintenta. Procesa los eventos repetidos sin ejecutar el pedido dos veces.

Documentación y ejemplos

Métodos, códigos de error y ejemplos de solicitudes en la documentación para desarrolladores.

Más información en el centro de ayuda

8 monedas · 16 combinaciones de activo y red · un saldo

GRAM BTC ETH SOL BNB LTC DOGE TRX
USDTTRC-20 · ERC-20 · BEP-20 · TON · SOL USDCERC-20 · BEP-20 · SOL

Para canales y ventas en Telegram

Elige tu perfil para ver las funciones que necesitas.

Para creadores Para vendedores Para desarrolladores
Earn

Rendimientos automáticos sobre tu saldo

Agrega parte de tu saldo a Earn. Los rendimientos se calculan automáticamente y se acreditan en tu billetera. Puedes agregar o retirar fondos cuando quieras.

Tasa anual Cálculo cada hora
USDT 4% sobre los primeros 500 USDT 1% sobre el monto superior a 500
GRAM 6% sobre los primeros 300 GRAM 3% sobre el monto superior a 300
Acreditación diaria en la billetera a las 00:30 UTC Sin comisión por agregar o retirar de Earn
Agregar fondos a Earn
Pantalla de Earn
Pantalla de confirmación de retiro
La dirección coincide
Seguridad

Comprobaciones antes del envío

Un retiro envía criptomonedas a una dirección externa. Estas medidas de seguridad acompañan la confirmación.

  • Antes de confirmar
  • Dirección, red y Memo completos La dirección se muestra completa, sin abreviarla como "4f3a…9c2b". Puedes comprobar el destino y la red.
  • Direcciones guardadas Puedes limitar los retiros a direcciones guardadas que ya estén habilitadas.
  • PIN o Face ID Cada retiro requiere confirmación. El PIN es el factor principal; la biometría configurada puede sustituirlo en el dispositivo vinculado.
  • Confirma la operación
  • Protección adicional
  • Demora de seguridad para montos elevados Si activas esta función, los retiros que cumplan sus condiciones se envían más tarde. Puedes cancelarlos antes del envío.
  • Análisis AML de la transacción La transacción se analiza antes del envío para detectar riesgos de lavado de dinero.
  • Notificaciones de tus operaciones Las notificaciones te ayudan a detectar operaciones desconocidas. Los avisos críticos de seguridad se envían siempre.

Información sobre seguridad

Condiciones

Condiciones visibles antes de confirmar

El monto que se descontará, incluidas las comisiones, aparece antes de la confirmación.

Depósitos en la billetera Acreditación tras las confirmaciones de la red
Sin comisión
Transferencias por nombre de usuario en Telegram Son transferencias internas de TgPay, por lo que no generan comisión de red
Sin comisión
Intercambios en la billetera Tipo de cambio, comisión y monto final en la pantalla de intercambio
Visible antes de confirmar
Retiros a una billetera externa Revisa la dirección, la red y el Memo cuando corresponda
Comisión de retiro indicada en la app
Agregar fondos a Earn y retirarlos Sin un plazo fijo de inmovilización
Sin comisión

Consulta las comisiones y los mínimos vigentes en la app. La lista completa está en el centro de ayuda.

USDT GRAM BTC ETH SOL BNB LTC DOGE
8 monedas · 16 combinaciones de activo y red — un saldo

No necesitas una billetera distinta para cada red. Elige una red compatible al depositar o retirar.

TRC-20 · ERC-20 · BEP-20 · TON · SOL · BTC · LTC · DOGE

en línea Soporte en Telegram
Mi retiro por TRC-20 no llegó. Necesito revisar su estado. Estamos revisando la transacción. Te responderemos en este chat.
@tgpayhelpbot
Preguntas frecuentes

Preguntas frecuentes

Información sobre la billetera, transferencias, Earn y recepción de pagos.

Tu billetera se crea al abrir @tgpaycryptobot por primera vez. No necesitas otro usuario, contraseña ni frase semilla. El acceso está vinculado a tu cuenta de Telegram.

La billetera admite GRAM, BTC, ETH, SOL, BNB, LTC, DOGE y TRX, además de USDT en cinco redes y USDC en tres. Son 16 combinaciones de activo y red. Elige la red al depositar o retirar y usa la dirección correspondiente.

Ingresa su nombre de usuario. No necesitas una dirección: la transferencia es interna y no genera comisión de red. También puedes enviar un cheque para que el destinatario lo canjee.

Agrega parte de tu saldo a Earn. La tasa anual es del 4 % sobre los primeros 500 USDT y del 1 % sobre el resto; para GRAM, del 6 % sobre los primeros 300 GRAM y del 3 % sobre el resto. Los rendimientos se calculan cada hora y se acreditan a las 00:30 UTC. Puedes agregar o retirar fondos en cualquier momento, sin comisión.

Un cheque contiene criptomonedas en un enlace o código QR. Puede tener uno o varios canjes, contraseña, fecha de expiración y restricciones para suscriptores de tus canales o usuarios de Telegram Premium. Puedes pausarlo, cambiar el monto y los canjes o eliminarlo. Los fondos no canjeados vuelven a tu saldo.

Las transferencias por nombre de usuario no generan comisión de red. Los retiros tienen la comisión indicada en la app. La comisión de intercambio y el monto final aparecen antes de confirmar. Consulta los valores y mínimos vigentes en la app y el centro de ayuda.

Crea facturas en la app. Para automatizar los cobros, integra la API para comerciantes: una solicitud crea la factura y un webhook informa del pago. Los métodos se describen en la documentación para desarrolladores.

Más respuestas en el centro de ayuda Para otras consultas, contacta a @tgpayhelpbot

Abre tu billetera en pocos pasos

Abre @tgpaycryptobot en Telegram. Tu billetera se crea y queda lista para recibir criptomonedas.

Abrir en Telegram
Perfil:
Personal Para creadores Para vendedores Para desarrolladores