Introducción
Integra pagos multichain en Stellar, Solana y Monad con Cosmos Pay, usando el SDK de JavaScript/TypeScript y la API REST de pagos.
Cosmos Pay te permite aceptar pagos en Stellar, Solana y Monad (intenciones de pago con enlaces SEP-7, Solana Pay y EIP-681), hacer swaps en esas redes y entre ellas, y administrar webhooks, productos, clientes y analíticas. Esta documentación cubre ambas formas de integrar:
SDK · Resumen
Qué es @cosmosapp/pay_sdk, los puntos de entrada de servidor + navegador, y el modelo mental.
SDK · Inicio rápido
El flujo de extremo a extremo más pequeño: crear una intención, completarla en la billetera, validarla.
Referencia de la API
La API REST de pagos (OpenAPI): intenciones de pago, webhooks, productos, clientes, analíticas.
Webhooks
Registra endpoints, recibe eventos y verifica firmas.
El flujo de pago
Un pago tiene tres pasos (aquí con el SDK, en Stellar):
- El servidor crea una intención con tu clave de API secreta (
client.paymentIntents.createPay/createTx). - El navegador la completa con la billetera de Stellar del usuario (
new WebClient().pay(intent)), produciendo untxHashen cadena. - El servidor valida ese hash (
intent.validate(txHash)), lo que actualiza el estado y dispara un webhook.
La red se elige según el tipo de clave de API: las claves dv_ apuntan a testnet, las claves prod_ apuntan a mainnet.
En Solana y Monad, indica chain, con el SDK (createPay({ chain: 'solana', ... }), desde la versión 2.2) o con la API REST:
recibes un enlace Solana Pay o EIP-681, el pagador lo paga desde cualquier billetera de esa red, y
la API de pagos detecta el pago en cadena y dispara los mismos webhooks.