# Enlaces de pago con Solana Pay, paso a paso | Cosmos Pay

URL: https://payments.cosmospay.lat/learn/accept-usdc-with-solana-pay?lang=es

> Cobra en USDC en Solana con un enlace y un código QR de Solana Pay: qué contiene el enlace, cómo probar en Devnet y cómo se confirma cada pago.

## Cómo aceptar USDC con enlaces de Solana Pay

Con Cosmos Pay, un enlace de pago en Solana es una solicitud de transferencia de Solana Pay: tu cliente escanea su código QR o lo abre en una wallet como Phantom o Solflare y aprueba ahí el pago en USDC. Los USDC van directo a tu wallet, y Cosmos Pay marca el enlace como pagado cuando Solana confirma la transacción. Pruébalo en Devnet antes de cobrar dinero real.

Actualizado el 2 de noviembre de 2026 · Por Cosmos 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 Pay](https://solana.com/docs/tools/solana-pay/specification/version1-1)
- [Pagos en Solana](https://payments.cosmospay.lat/solana?lang=es)

### 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 servidor](https://payments.cosmospay.lat/learn/confirm-stablecoin-payments?lang=es)
- [Claves de API](https://dev.cosmospay.lat/docs/api-keys/)

### 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 pago](https://dev.cosmospay.lat/docs/api/payment-intents/)
- [Intentos de pago en el SDK](https://dev.cosmospay.lat/docs/sdk/server/payment-intents/)

### 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 comisiones](https://payments.cosmospay.lat/fees?lang=es)
- [Stellar vs Solana vs Monad](https://payments.cosmospay.lat/learn/stellar-vs-solana-vs-monad?lang=es)

### Preguntas y respuestas.

Pagos por red: [Pagos en Stellar](https://payments.cosmospay.lat/stellar?lang=es), [Pagos en Solana](https://payments.cosmospay.lat/solana?lang=es), [Pagos en Monad](https://payments.cosmospay.lat/monad?lang=es)

#### ¿Qué wallets pueden pagar un enlace de Solana Pay?

Cualquier wallet de Solana que lea enlaces de Solana Pay, como Phantom o Solflare. Tu cliente escanea el código QR o abre el enlace, y aprueba el pago en la wallet.

#### ¿Mi cliente necesita SOL?

Sí, un poco. Su wallet paga la comisión de red de Solana en SOL, además de los USDC que envía.

#### ¿Los USDC pasan por Cosmos Pay?

No. En Solana, la wallet de tu cliente envía los USDC directo a tu dirección. Cosmos Pay encuentra el pago en la red por la clave de referencia del enlace.

#### ¿Puedo probar sin dinero real?

Sí. En Sandbox y con claves de prueba (dv_), los enlaces funcionan en Solana Devnet, donde USDC está predefinido, y el checkout indica que no se mueven fondos reales.

### Más guías

[Ver todas las guías](https://payments.cosmospay.lat/learn?lang=es)

#### [Cómo aceptar pagos en USDC online](https://payments.cosmospay.lat/learn/accept-usdc-payments?lang=es)

Cobra en USDC con un enlace de pago, el checkout alojado o la API, y pruébalo antes en una red de pruebas.

#### [Cómo confirmar un pago en stablecoins en tu servidor](https://payments.cosmospay.lat/learn/confirm-stablecoin-payments?lang=es)

Entrega los pedidos a partir de un webhook firmado, no de la página de tu cliente: verifícalo, responde rápido y omite los duplicados.

#### [Stellar vs Solana vs Monad para aceptar pagos](https://payments.cosmospay.lat/learn/stellar-vs-solana-vs-monad?lang=es)

Las tres redes lado a lado, tal como las admite Cosmos Pay: formato del enlace, activos, redes de prueba y comisiones.

### Empieza a aceptar stablecoins.

Crea una cuenta gratis, genera una clave de prueba y envía hoy tu primer enlace de pago.

[Crear un enlace de pago](https://dev.cosmospay.lat/login?next=%2Fdashboard%3Fview%3Dpayments)

#### Escríbenos

Dudas sobre planes, integración o pagos protegidos: cuéntanos y te respondemos por email.

[organization@cosmospay.lat](mailto:organization@cosmospay.lat)
