Cómo funcionan los enlaces de pago cripto

Un enlace de pago cripto es una página de checkout compartible creada para un cobro específico. En vez de mandar por separado la dirección de wallet, el token, la red, el importe y el plazo, el comercio crea una invoice y envía una URL. El comprador abre el enlace, reconoce qué está pagando, elige una ruta USDT o USDC habilitada y hace la transferencia desde una wallet o exchange compatible.

Los fondos siguen moviéndose on-chain hacia la dirección pública configurada por el comercio. El valor del link no consiste en custodiar el dinero, sino en añadir contexto comercial antes de la transferencia: finalidad, importe esperado, token, red, identificador, plazo y estado. Esa información permite evitar la investigación posterior de qué cliente corresponde a cada entrada de la wallet.

Este flujo es apropiado para freelancers, agencias, consultores y pequeños negocios que cierran ventas por Telegram, WhatsApp o email. Si los pedidos nacen automáticamente en un sitio y el fulfilment debe ejecutarse sin operador, conviene usar el flujo de pagos cripto para sitios web.

Respuesta rápida: ¿qué problema resuelve el enlace?

Una dirección solo responde dónde enviar fondos. Un pago comercial también necesita aclarar:

• qué compra el cliente;
• qué token y blockchain debe usar;
• qué importe exacto debe llegar;
• hasta cuándo sigue vigente la solicitud;
• si la transferencia correcta quedó vinculada a la invoice;
• cuándo el comercio puede entregar.

El payment link coloca esas condiciones en una sola página. No hace reversible la blockchain ni corrige una transferencia equivocada, pero presenta la misma versión de las instrucciones a ambas partes.

Pregunta	Dirección enviada por mensaje	Enlace rastreado
Concepto	Se explica aparte	Aparece en checkout
Token y red	Pueden perderse en el chat	Proceden de las rutas habilitadas
Importe	Se escribe y comprueba manualmente	Se muestra como importe exacto
Cliente o pedido	Se investiga después	Se vincula a una invoice propia
Plazo	Suele ser informal	Se ve mediante timer y expiry
Resultado	Depende de mensaje o captura	Estados waiting/paid/expired/cancelled

Cómo funciona paso a paso

1. Se acuerdan las condiciones de la venta

Producto o servicio, precio, entrega y política de cancelación/refund deben existir antes del cobro. El payment link registra la obligación de pago; no sustituye pedido, propuesta, contrato ni documento fiscal.

Crea una invoice por obligación. Dos clientes pueden pagar el mismo importe y un cliente puede tener varios milestones. Reutilizar un link elimina la separación que hace posible una conciliación clara.

2. El vendedor crea la invoice

En el cabinet web o el flujo de Telegram, el vendedor selecciona el app correcto, introduce el importe en USD, escribe la public description y, si hace falta, una private note. El app determina qué wallets y rutas pueden aparecer en checkout.

La descripción pública debe ser reconocible, por ejemplo Anticipo del rediseño web. Evita un simple Pago. La private note puede guardar ACME · ORDER-4821 · SEPTIEMBRE, ya que es un campo interno para búsqueda y coordinación del equipo.

3. Se genera el hosted checkout

La invoice obtiene public ID, plazo, rutas disponibles y URL. Cuando está disponible, Telegram Mini App ofrece otra forma de abrir la misma solicitud. No son cobros distintos: ambos comparten condiciones y estado.

Antes de enviarla, el comercio debe abrir la URL y comprobar finalidad, total en USD, métodos habilitados y tiempo restante. Así evita compartir una invoice de otro cliente o con términos antiguos.

4. El comprador elige token y red

Checkout muestra solo las rutas configuradas. USDT sin red no es una instrucción completa: USDT en TRON y USDT en Ethereum se transfieren por blockchains diferentes. Lo mismo ocurre con USDC y distintas representaciones. En la wallet o pantalla de retiro de la exchange debe seleccionarse exactamente la combinación indicada.

No elijas una red por similitud de nombre ni solo por su comisión. Un token bridged o contrato distinto puede no ser reconocido por la ruta de la invoice.

5. Se envía el importe exacto

Tras elegir la ruta, checkout muestra exact token amount, recipient address y código QR. El QR ayuda a copiar, pero el comprador debe revisar token, red, primeros y últimos caracteres de la dirección e importe antes de aprobar.

Cuando una exchange descuenta la withdrawal fee del envío, hay que verificar que recipient receives coincida con el importe indicado. Redondear o dejar que la comisión reduzca el valor puede producir underpayment.

6. La invoice registra el resultado

Una transacción puede aparecer como success en blockchain y no pagar la solicitud: quizá fue a otro recipient, usó otro token o pertenece a otra invoice. Una asociación fiable evalúa network, token contract/mint, recipient, amount, ventana temporal e identidad de la transacción. Cuando todo coincide, la invoice pasa a paid y conserva la referencia on-chain.

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.

Ejemplo completo: ORDER-4821

Northstar Studio solicita un anticipo de 125 USD para rediseñar un sitio. Primero crea ORDER-4821 en su sistema y después una invoice de 125 USD en GramPayBot. La public description es Website redesign deposit; la private note, ORDER-4821 · SEPTEMBER.

El cliente abre checkout, selecciona USDC en Base y envía 125.00 USDC a la dirección mostrada. Al asociarse la transferencia válida, el estado cambia de waiting a paid. El cabinet enseña token/red, recipient, transaction reference y paid time dentro del mismo registro. El comercio empieza el trabajo a partir del estado rastreado, no de una captura enviada por chat.

El sitio del comercio es una ilustración de integración. El checkout y el panel son pantallas reales y actuales de GramPayBot capturadas con datos sintéticos: pedido del sitio → checkout → invoice pagada en el panel.

Public description y private note

La descripción pública aparece al comprador y debe ser breve, clara y sin datos confidenciales. La nota privada pertenece al vendedor y puede almacenar order ID, cliente, propuesta o referencia interna.

Campo	Ejemplo	Quién lo ve
Public description	Website redesign deposit	Comprador y vendedor
Private note	ORDER-4821 · SEPTEMBER	Solo el vendedor
Invoice ID	GP-4821	Checkout y cabinet
Transaction	0xB91E…7C20	Registro posterior al pago

Separar ambos campos protege información y facilita buscar una solicitud entre muchas de importe parecido.

Qué significan los estados

• Waiting: la solicitud está activa y todavía no tiene un pago válido asociado. No entregar.
• Paid: la transferencia esperada fue reconocida y registrada. Continuar según el acuerdo.
• Expired: terminó el plazo sin cerrar la invoice. Si las condiciones siguen vigentes, emitir una nueva.
• Cancelled: el vendedor cerró la solicitud. No reutilizar el enlace.

Un pago tardío, wrong network, underpayment u overpayment necesita una política. El equipo puede revisar la evidencia, aceptar, pedir la diferencia, emitir otra invoice o iniciar un refund desde la wallet que controla. El sistema no debería tomar una decisión comercial irreversible sin suficiente contexto.

Usa las guías específicas para facturas impagadas, tardías o vencidas, pagos insuficientes o excesivos y USDT/USDC enviado por la red equivocada.

Lo que un payment link no resuelve

No guarda private keys, no revierte blockchain, no sustituye documentos fiscales y no decide disputas. En el modelo non-custodial de GramPayBot, los fondos llegan directamente a la wallet configurada; seguridad, backups, treasury y refunds siguen siendo responsabilidad del comercio.

Una captura tampoco prueba el pago. Puede estar editada, mostrar una operación pending o corresponder a otra dirección. El tx hash sirve para buscar evidencia, pero debe compararse con las condiciones de la invoice. Revisa la guía para verificar pagos y evitar capturas falsas.

¿Link manual o integración website/API?

Usa un link manual cuando una persona negocia cada venta, crea la invoice y puede revisar excepciones. Usa invoices por API y webhooks firmados cuando el pedido nace en el sistema, el acceso debe activarse automáticamente o el servicio funciona fuera del horario del equipo.

Payment link manual	Flujo website/API
Una persona cierra la venta	El sistema crea el pedido
Una persona crea la invoice	La API crea la invoice
La URL se envía por chat/email	El sitio abre checkout
Una persona sigue el estado	El backend procesa el resultado
Adecuado para servicios puntuales	Adecuado para volumen repetible

Crea tu primer enlace rastreado

Un buen payment link reúne finalidad, token, red, importe, plazo y estado. El comprador recibe instrucciones coherentes y el vendedor conserva un registro consultable y conciliable.

Continúa con cómo crear un enlace de pago cripto, consulta el caso de uso de links e invoices o revisa los precios actuales.