Cómo aceptar donaciones en cripto con monto abierto
Para aceptar una donación en stablecoins, crea un enlace de pago sin monto en Stellar o Solana: quien dona lo abre, elige el monto en su wallet y paga directo a tu dirección. Cada enlace recibe un solo pago y queda abierto por un tiempo limitado, así que crea uno por donante, por ejemplo cuando alguien presiona Donar en tu sitio. Cosmos Pay marca el enlace como pagado cuando la red confirma la donación.
Cómo funciona un enlace de monto abierto
- Deja el monto vacío al crear el enlace, en el dashboard o con la API. El checkout muestra Importe libre y le indica a quien dona que lo elija en su wallet.
- La wallet de quien dona fija el monto: cualquier monto positivo del activo del enlace lo liquida, en Stellar con el memo del enlace.
- Un mensaje de hasta 300 caracteres, como un agradecimiento, se muestra en la wallet de quien dona.
Límites que debes prever
- Solo Stellar y Solana: un enlace de Monad necesita un monto.
- Un enlace recibe una sola donación. Una vez pagado no se puede volver a pagar, así que un único enlace impreso en un cartel solo le sirve al primer donante.
- Un enlace queda abierto por un tiempo limitado, que el checkout muestra como cuenta regresiva.
- Tu propia comisión en un pago necesita un monto fijo, así que no se aplica a los enlaces de monto abierto.
Recibe tu primera donación
Cambia a Sandbox
Elige Sandbox en el dashboard: los enlaces funcionan en Stellar Testnet o Solana Devnet y no mueven dinero real.
Crea un enlace de monto abierto
En Pagos, elige Crear enlace de pago, selecciona Stellar o Solana y el activo, deja el monto vacío y, si quieres, agrega un mensaje de agradecimiento.
Compártelo
Envía la página de pago, muestra su código QR o insértalo en tu página.
Dona desde una wallet
Abre el enlace en una wallet en la misma red, ingresa un monto y aprueba. El checkout pasa a Pagado cuando la red lo confirma.
Confírmalo en tu servidor
Cuando llegue PAYMENT_INTENT_SUCCEEDED, lee la transacción para saber el monto y agradécele a quien donó.
Cómo saber cuánto se donó
Un enlace de monto abierto no guarda ningún monto: cuando se paga, Cosmos Pay registra el hash de la transacción y la dirección de quien dona, y el webhook los incluye. Lee el monto donado en esa transacción en la red, por ejemplo para agradecerle a quien donó o emitir un recibo.
Un botón Donar en tu sitio
Cuando un visitante presiona Donar, haz que tu servidor cree un enlace de monto abierto y muéstralo con el checkout embebido, o envía al visitante a su página de pago. Así cada visitante recibe un enlace nuevo. En el navegador, una wallet de Stellar también puede pagarlo a través del WebClient del SDK con el monto que eligió quien dona: webClient.pay(intent, { amount }).
Agrega un botón de pago o un checkout a tu sitioAPI de intentos de pago
¿Un enlace puede recibir muchas donaciones?
No. Un enlace se paga una sola vez. Crea un enlace nuevo para cada donante, por ejemplo desde tu servidor cuando alguien presiona Donar.
¿Puedo recibir donaciones de monto abierto en Monad?
No. Un enlace de Monad necesita un monto. Usa Stellar o Solana para montos abiertos.
¿Cómo sé cuánto se donó?
Lee la transacción del pago en la red: el enlace en sí no guarda ningún monto en un pago de monto abierto.
¿Qué activos se pueden donar?
El activo definido en el enlace, como USDC o la moneda de la red (XLM o SOL). Quien dona solo elige el monto.
