Puedes crear un enlace de pago cripto sin desarrollar checkout ni integrar una API. En GramPayBot, el link manual empieza como una invoice: seleccionas el app correcto, introduces el importe en USD y el concepto, añades una referencia interna, creas la solicitud y envías al comprador la URL del hosted checkout.
Esta guía sirve para freelancers, agencias, consultores y pequeños comercios que ya acordaron una venta por chat o email. Para conocer primero la categoría, lee cómo funcionan los enlaces de pago cripto. Si dudas entre link y dirección directa, consulta payment link vs wallet address.
Qué necesitas antes de crear el enlace
No necesitas sitio web, API key ni generador propio de QR. Sí necesitas:
- Cuenta de GramPayBot.
- Un app que represente el flujo de ventas.
- Al menos una receiving wallet verificada y una payment route activa.
Una ruta combina token, network y dirección del merchant. Un app puede aceptar USDT en TRON y otro USDC en Base. Activa solo las combinaciones que tu empresa puede operar. Aceptamos USDT sin red es una instrucción incompleta.
GramPayBot no solicita private keys. El comprador envía a la public wallet configurada; el servicio proporciona invoice, checkout y seguimiento, sin recibir los ingresos en un saldo custodial.
Ejemplo que seguiremos
Northstar Studio cobra 480 USD por soporte mensual del sitio. El registro interno es ORDER-5932, la public description es Monthly website support y la private note es ORDER-5932 · SEPTEMBER. El cliente pagará USDT en TRON.
Mantener iguales estos datos durante todo el proceso es importante. Si el sitio muestra un precio, el chat otro y la invoice una descripción genérica, el cliente carece de una fuente fiable.
1. Selecciona el app correcto
En el cabinet, abre Invoices → Create invoice. En Telegram, entra en el menú de invoices del app receptor. El app define wallets, tokens y networks disponibles en checkout.
Para consultoría sencilla puede bastar Client payments. Separa apps cuando marcas, equipos u operaciones necesiten wallets y registros distintos. Elegir el app incorrecto puede mostrar una dirección o route que no corresponde a la venta.
Comprueba antes de continuar:
- nombre del app;
- token set habilitado;
- network requerida;
- receiving address;
- acceso operativo del equipo a la wallet;
- capacidad de tramitar un refund si fuera necesario.
2. Introduce el importe final en USD
Escribe el valor comercial ya calculado: 480.00 USD en nuestro ejemplo. Checkout mostrará el exact token amount según la ruta seleccionada.
No calcules otro importe de token por chat y no lo redondees. El comprador debe usar el valor actual del checkout. Si la exchange descuenta withdrawal fee, debe verificar que recipient receives siga coincidiendo.
Impuestos, descuentos y milestones deben resolverse antes en el sistema de ventas. La invoice representa la obligación final, no calcula la propuesta.
3. Escribe una public description reconocible
El texto aparece a quien abre checkout y debe permitir identificar la solicitud.
Buenos ejemplos:
Monthly website support — SeptemberBrand identity — final milestoneProduct photography — order 184Website redesign — 50% deposit
Evita Payment, Invoice o USDT. Tampoco coloques información personal, condiciones confidenciales o notas internas en un campo público.
4. Añade una private note
La nota privada sirve para búsqueda y coordinación del vendedor. Puede contener order ID, nombre comercial, proposal number o referencia de conversación. Ejemplo: ORDER-5932 · SEPTEMBER.
| Campo | Ejemplo | Visibilidad |
|---|---|---|
| Amount | 480.00 USD | Comprador y vendedor |
| Public description | Monthly website support | Comprador y vendedor |
| Private note | ORDER-5932 · SEPTEMBER | Solo vendedor |
| App | Northstar Studio | Checkout y cabinet |
La nota no sustituye el ID único de invoice, pero facilita recuperar su contexto.
5. Crea la invoice y revisa checkout
Al pulsar Create invoice, el sistema genera public ID, checkout URL, rutas, status y expiry. En el flujo manual actual, la invoice permanece activa 30 minutos y el formulario no permite plazo personalizado. Si el cliente no paga a tiempo, emite una nueva en lugar de reutilizar el link viejo.
Abre la URL antes de enviarla y comprueba:
- merchant/app correcto;
- descripción y total en USD;
- solo tokens y redes operables;
- timer activo y status
waiting; - exact token amount y recipient al elegir una route.
La interfaz actual de GramPayBot se capturó en el producto con datos sintéticos. El sitio del comercio es solo un ejemplo de integración.
El sitio del comercio es ilustrativo; el checkout y el panel son pantallas reales y actuales de GramPayBot capturadas con datos sintéticos. Las tres mantienen ORDER-5932, 480 USD y USDT/TRON para representar un solo flujo.
6. Envía una instrucción canónica
Comparte la URL donde se cerró la venta. El mensaje añade contexto; no debería repetir otra dirección o red que pueda contradecir checkout.
Plantilla para Telegram o WhatsApp:
Enlace para el pago del soporte mensual: [payment link] Antes de enviar, comprueba en checkout red USDT, importe exacto y dirección. Si vence, pídeme una nueva invoice.
Plantilla de email:
Asunto: Payment link — soporte de septiembre Hola, [nombre]. Este es el checkout de la solicitud de 480 USD: [payment link] Selecciona en tu wallet/exchange exactamente el token y la red mostrados. El estado se actualizará cuando se confirme el pago correcto.
No pegues otra wallet address junto al link. Dos fuentes de instrucciones aumentan el riesgo de usar datos antiguos.
7. Explica qué verá el comprador
El cliente revisa finalidad y total, selecciona token/network y recibe exact amount, recipient y QR. Antes de aprobar, compara esos datos con su wallet o exchange.
El QR reduce errores de copia, pero no garantiza que la exchange haya seleccionado la blockchain correcta. Varias redes pueden compartir formatos de dirección parecidos.
8. Sigue el estado antes de entregar
- Waiting: todavía no existe qualifying payment. No entregar.
- Paid: la transferencia esperada fue asociada. Continuar según el acuerdo.
- Expired: terminó el plazo. Revisar cualquier pago tardío y emitir nueva invoice si corresponde.
- Cancelled: la solicitud se cerró. No reutilizar.
El mensaje ya pagué, una captura o un tx hash no sustituyen paid status. El hash puede corresponder a otra invoice. Usa el checklist de verificación contra capturas falsas cuando exista una excepción.
Errores frecuentes
Reutilizar una invoice
Crea una solicitud por obligación. Los links únicos diferencian amount, purpose, status y transaction record.
Descripción demasiado vaga
El cliente debe reconocer el pago sin volver al chat. Nombra producto, servicio o milestone.
Confundir token con red
USDT y USDC existen en varias blockchains. Repite exactamente la combinación de checkout.
Enviar un link expirado
El valor o las condiciones pueden haber cambiado. Emite otra invoice y retira la antigua.
Entregar por una captura
Espera paid o aplica un proceso autorizado de revisión. Una imagen no demuestra recipient, contract y confirmations.
Cuándo pasar a API
El link manual funciona cuando una persona negocia y crea cada solicitud. API y signed webhook son preferibles cuando los pedidos nacen automáticamente, una cuenta debe activarse sin operador o el volumen impide el seguimiento manual.
Puedes comenzar manualmente y automatizar más tarde. El comprador puede continuar usando hosted checkout; cambia quién crea la invoice y cómo llega el resultado al sistema.
Crea tu primer payment link
Selecciona app, introduce el importe final, escribe una descripción pública reconocible y una nota interna consultable. Revisa checkout, envía una sola URL y sigue la invoice en vez de buscar pruebas en conversaciones.
Abre GramPayBot en Telegram, consulta el flujo completo de links e invoices o revisa los precios actuales.
Siguiente paso
Crea un enlace de pago cripto rastreable
Emite una invoice en USDT o USDC, envía un hosted checkout y sigue el estado sin una API.
Ver enlaces de pago →