Introdução
Integre pagamentos multichain na Stellar, Solana e Monad com o Cosmos Pay, usando o SDK JavaScript/TypeScript e a API REST de Pagamentos.
O Cosmos Pay permite que você aceite pagamentos na Stellar, Solana e Monad (intenções de pagamento com links SEP-7, Solana Pay e EIP-681), faça swaps nessas redes e entre elas, e gerencie webhooks, produtos, clientes e análises. Esta documentação cobre as duas formas de integração:
SDK · Visão geral
O que é o @cosmosapp/pay_sdk, os pontos de entrada de servidor + navegador e o modelo mental.
SDK · Início rápido
O menor fluxo de ponta a ponta: criar uma intenção, concluí-la na carteira e validá-la.
Referência da API
A API REST de Pagamentos (OpenAPI): intenções de pagamento, webhooks, produtos, clientes, análises.
Webhooks
Registre endpoints, receba eventos e verifique assinaturas.
O fluxo de pagamento
Um pagamento tem três etapas (aqui com o SDK, na Stellar):
- O servidor cria uma intenção com sua chave de API secreta (
client.paymentIntents.createPay/createTx). - O navegador a conclui com a carteira Stellar do usuário (
new WebClient().pay(intent)), produzindo umtxHashon-chain. - O servidor valida esse hash (
intent.validate(txHash)), o que atualiza o status e dispara um webhook.
A rede é escolhida pelo tipo de chave de API: chaves dv_ usam a testnet, chaves prod_ usam a mainnet.
Na Solana e na Monad, informe chain, com o SDK (createPay({ chain: 'solana', ... }), a partir da versão 2.2) ou pela API REST:
você recebe um link Solana Pay ou EIP-681, o pagador paga de qualquer carteira dessa rede, e a
API de Pagamentos detecta o pagamento on-chain e dispara os mesmos webhooks.