¿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.
Es el lado de desarrollo del mismo producto que ven los usuarios: una factura que creas por la API es la factura que ellos pagan con su saldo con un toque.
Qué puedes hacer con ella
- Facturas — crea una solicitud de pago (un monto fijo en cripto, uno con precio en fiat o un monto abierto que elige quien paga), envíale su enlace a quien paga y recibe una llamada firmada en el momento en que se paga.
- Reembolsos — devuelve el monto de una factura pagada, entero o en parte, a quien la pagó, incluso a quienes pagaron de forma anónima.
- Transferencias — envía cripto desde el saldo de tu app a un usuario de Telegram, de a una o hasta 100 en un lote.
- Cheques — emite enlaces canjeables que cualquiera puede cobrar, desde el saldo de tu app.
- Suscripciones — cobros recurrentes: los usuarios aprueban un plan una vez y se les cobra automáticamente cada período.
- Saldos, monedas, tipos de cambio y estadísticas — endpoints de solo lectura para tu propia contabilidad.
Cómo encaja todo
- Tu app tiene un saldo, separado de tu billetera personal.
- Las facturas que pagan los usuarios acreditan ese saldo de la app.
- Las transferencias y los cheques gastan de él.
- Cada evento que importa se puede enviar a tu servidor como un webhook firmado.
Los pagos se liquidan dentro de la app, no on-chain: sin comisión de red, sin confirmaciones que esperar, y los fondos se pueden usar apenas llegan. Quien paga igual puede financiar una factura desde una billetera externa: su depósito llega a su propia billetera y la factura se liquida desde ahí automáticamente; de tu lado se ve exactamente como cualquier otra factura pagada.
Compatible con Crypto Bot
La API replica a propósito la de Crypto Bot: los mismos nombres de métodos, el
mismo envoltorio {ok, result}, los mismos montos como cadenas decimales, el
mismo esquema de firma de webhooks. Puedes apuntar una integración existente de
Crypto Bot hacia nosotros cambiando la URL base y el token: las formas de las
peticiones y las respuestas no cambian.
La cabecera canónica del token es TgPayCrypto-API-Token, y
Crypto-Pay-API-Token se acepta como alias para que las bibliotecas cliente
existentes sigan funcionando sin cambios.
⚠️ Tu token de API es una llave para gastar
Quien lo tenga puede sacar el saldo de tu app. Guárdalo del lado del servidor, fuera de las apps cliente y los repositorios, y rótalo apenas sospeches que se filtró. Para los servidores que no necesitan acceso completo, emite un token restringido limitado a los ámbitos que realmente usan — mira la referencia de la API.
Siguiente
¿Te sirvió este artículo?
Gracias por tu comentario.