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.

10 criptomonedas · 8 redes · un saldo Integra tu agente de IA mediante el servidor MCP →
Pantalla de la API para comerciantes: apps y conexión de un agente de IA
Webhook: factura pagada
Red 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 Crypto 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 tiene un servidor MCP. Conéctalo en un cliente de agente compatible: el agente puede leer la documentación, solicitar la creación de una aplicación, configurar webhooks y ayudar a escribir la integración. Tú apruebas la aplicación en Telegram, revisas y pruebas el resultado.

  1. Paso 1

    Envía la instrucción al agente

  2. Paso 2

    Autoriza la aplicación en Telegram

  3. Paso 3

    Completa y prueba la integración

Proceso, instrucciones por cliente y permisos del token →
Instrucción para tu agente
Connect the MCP server (https://app.tgpaycrypto.com/mcp) and integrate payments via the 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 red de pruebas

Prueba el proceso de pago en el bot independiente de la red de pruebas, @tgpaycrypto_testnet_bot, antes de ofrecerlo a tus usuarios.

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.

10 criptomonedas · 8 redes · 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
Pantalla de confirmación de retiro
Dirección válida
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 Antes de confirmar, revisa la dirección del destinatario, la red y el Memo si es necesario. Un formato válido no demuestra que la dirección pertenezca al destinatario previsto.
  • 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 retiros Las notificaciones te ayudan a detectar operaciones desconocidas. Los avisos críticos de seguridad se envían siempre.
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 Los fondos se acreditan tras las confirmaciones de la red. Los montos inferiores al mínimo de la red no se acreditan. Tu primera dirección en cada red es gratuita; cada dirección adicional cuesta 5 USD. Sin comisión
Transferencias por nombre de usuario en Telegram Son transferencias internas de TgPay Crypto, por lo que no generan comisión de red Sin comisión
Intercambios en la billetera La comisión está incluida en el tipo de cambio. El tipo de cambio y el monto final aparecen en la pantalla de intercambio. Visible antes de confirmar
Retiros a una billetera externa El formato de la dirección se comprueba antes del envío. La dirección, la red y el Memo aparecen en la pantalla de confirmación. Comisión de retiro indicada en la app

Las comisiones y los montos mínimos vigentes se muestran en la app.

USDT GRAM BTC ETH SOL BNB LTC DOGE
10 criptomonedas · 8 redes — 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 la app
Mi retiro por TRC-20 no llegó. Necesito revisar su estado. Estamos revisando la transacción. Te responderemos en este chat.
Abrir billetera
Preguntas frecuentes

Preguntas frecuentes

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

No. La billetera se crea la primera vez que abres @tgpaycryptobot, sin un inicio de sesión adicional ni frase semilla. El acceso está vinculado a tu cuenta de Telegram. Para enviar fondos, primero debes configurar un PIN.

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 @username o ID numérico de Telegram. No necesitas una dirección: la transferencia se realiza dentro de la billetera, sin comisión de red. Si el destinatario aún no ha abierto TgPay Crypto, la transferencia queda pendiente y se acredita cuando abre el bot por primera vez. Si no la recibe en 30 días, los fondos vuelven a ti. También puedes enviar un cheque: un enlace que puede canjear la primera persona que lo abra.

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.

¿No encontraste la respuesta? Escribe al soporte en la app

Abre tu billetera en pocos pasos

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

Perfil: