Cómo aceptar USDC con enlaces de Solana Pay

Qué contiene un enlace de Solana Pay

Solana Pay es un estándar de solicitudes de pago que leen las wallets de Solana: un enlace solana:, o su código QR, con la dirección a pagar, el monto, el token y un mensaje.

Cosmos Pay agrega una clave de referencia creada para cada enlace. La wallet la incluye en la transacción, y Cosmos Pay busca esa clave en Solana para asociar el pago con su enlace. Solo acepta el pago cuando la transacción se completó con éxito y el monto exacto llegó a tu dirección.

La especificación de Solana PayPagos en Solana

Qué necesitan tú y tu cliente

• Tú: una dirección de Solana que reciba el dinero, agregada a tu organización en el dashboard, donde demuestras con una firma que es tuya.
• Tu cliente: una wallet de Solana que lea enlaces de Solana Pay, como Phantom o Solflare, con los USDC y un poco de SOL para la comisión de red. No necesita una cuenta en Cosmos Pay.
• Para pruebas: Sandbox, donde los enlaces funcionan en Solana Devnet. USDC también está predefinido ahí, así que puedes probar con USDC de Devnet.

Acepta tu primer pago con Solana Pay

1. Cambia a Sandbox

   Inicia sesión en el dashboard y elige Sandbox en la parte superior. Los enlaces que crees ahí funcionan en Solana Devnet y no mueven dinero real.

2. Agrega tu wallet de Solana

   En los ajustes de tu organización, agrega la dirección de Solana que va a recibir el dinero y firma lo que te pide el dashboard: así demuestras que la wallet es tuya.

3. Crea el enlace

   En Pagos, elige Crear enlace de pago, selecciona Solana y cambia el activo a USDC (el selector empieza en SOL). Ingresa el monto, o déjalo vacío para que tu cliente lo elija, y luego elige tu wallet y, si quieres, un mensaje.

4. Págalo desde una wallet

   Abre la página de pago y escanea su código QR con una wallet de Solana, o abre el enlace en el mismo dispositivo. Aprueba el pago en la wallet, y el checkout pasa a Pagado cuando Solana lo confirma.

5. Confírmalo en tu servidor

   Agrega un endpoint de webhook en el dashboard. Cuando el pago se confirma, Cosmos Pay envía PAYMENT_INTENT_SUCCEEDED, firmado con HMAC-SHA256. Entrega el pedido cuando llegue ese evento.

6. Cambia a Producción

   Elige Producción y crea una clave de API de producción (empieza con prod_). Los enlaces ahora funcionan en la red principal de Solana, donde USDC tiene su propia opción predefinida.

Cómo confirmar un pago en tu servidorClaves de API

Crea el enlace desde tu servidor

Con la API de pagos, llama a POST /v1/payment-intents/pay con chain definido como solana, tu dirección como destino y, para USDC, el código de activo USDC con su mint como emisor. Con el SDK de TypeScript (versión 2.2 o posterior), pasa chain: 'solana' a client.paymentIntents.createPay.

La respuesta trae el enlace (su uri empieza con solana:) y su código QR. Muestra el código QR, abre el enlace en la wallet de tu cliente o envíalo al checkout alojado: payments.cosmospay.lat seguido del id del enlace.

API de intentos de pagoIntentos de pago en el SDK

Para tener en cuenta

• Puedes dejar el monto vacío para que tu cliente lo elija, como en las donaciones. Un enlace que agrega tu propia comisión necesita un monto.
• Un mensaje de hasta 300 caracteres, como un número de pedido, se muestra en la wallet de tu cliente.
• Con tu propia comisión en el pago, el enlace pasa a ser una solicitud de transacción de Solana Pay que paga a tu wallet y a tu wallet de comisiones en una sola transacción.
• Un enlace queda abierto por un tiempo limitado, que el checkout muestra como cuenta regresiva. Si aun así llega un pago y se confirma, el enlace queda como pagado.
• La wallet de tu cliente cubre la comisión de red de Solana, en SOL. Cada pago paga la tarifa de tu plan, la misma que en todas las redes.

Precios y calculadora de comisionesStellar vs Solana vs Monad