Como aceitar doações em cripto com valor aberto
Para aceitar uma doação em stablecoins, crie um link de pagamento sem valor na Stellar ou na Solana: quem doa abre o link, escolhe o valor na carteira e paga direto para o seu endereço. Cada link recebe um único pagamento e fica aberto por um tempo limitado, então crie um por doador, por exemplo quando alguém clica em Doar no seu site. A Cosmos Pay marca o link como pago assim que a rede confirma a doação.
Como funciona um link de valor aberto
- Deixe o valor vazio ao criar o link, no dashboard ou com a API. O checkout mostra Valor livre e pede a quem doa que escolha o valor na carteira.
- A carteira de quem doa define o valor: qualquer valor positivo do ativo do link o liquida, na Stellar com o memo do link.
- Uma mensagem de até 300 caracteres, como um agradecimento, aparece na carteira de quem doa.
Limites a considerar
- Só Stellar e Solana: um link na Monad precisa de um valor.
- Um link recebe uma doação. Depois de pago, ele não pode ser pago de novo, então um único link impresso num cartaz só atende o primeiro doador.
- Um link fica aberto por um tempo limitado, que o checkout mostra como contagem regressiva.
- A sua própria taxa num pagamento precisa de um valor fixo, então ela não se aplica a links de valor aberto.
Receba sua primeira doação
Mude para Sandbox
Escolha Sandbox no dashboard: os links funcionam na Stellar Testnet ou na Solana Devnet e não movimentam dinheiro real.
Crie um link de valor aberto
Em Pagamentos, escolha Criar link de pagamento, selecione Stellar ou Solana e o ativo, deixe o valor vazio e, se quiser, adicione uma mensagem de agradecimento.
Compartilhe
Envie a página de pagamento, mostre o QR code ou incorpore-o na sua página.
Doe com uma carteira
Abra o link numa carteira na mesma rede, informe um valor e aprove. O checkout passa para Pago assim que a rede confirma.
Confirme no seu servidor
Quando PAYMENT_INTENT_SUCCEEDED chegar, leia a transação para saber o valor e agradeça ao doador.
Como saber o valor doado
Um link de valor aberto não guarda nenhum valor: quando ele é pago, a Cosmos Pay registra o hash da transação e o endereço de quem doou, e o webhook os traz. Leia o valor doado nessa transação na rede, por exemplo para agradecer ao doador ou emitir um recibo.
Um botão Doar no seu site
Quando um visitante clicar em Doar, faça o seu servidor criar um link de valor aberto e mostre-o com o checkout incorporado, ou envie o visitante para a página de pagamento dele. Assim cada visitante recebe um link novo. No navegador, uma carteira da Stellar também pode pagá-lo pelo WebClient do SDK com o valor que o doador escolheu: webClient.pay(intent, { amount }).
Adicione um botão de pagamento ou checkout ao seu siteAPI de intenções de pagamento
Perguntas e respostas.
Pagamentos por rede:Pagamentos na StellarPagamentos na SolanaPagamentos na Monad
Um link pode receber várias doações?
Não. Um link é pago uma vez. Crie um novo link para cada doador, por exemplo no seu servidor quando alguém clica em Doar.
Posso receber doações de valor aberto na Monad?
Não. Um link na Monad precisa de um valor. Use Stellar ou Solana para valores abertos.
Como sei quanto foi doado?
Leia a transação do pagamento na rede: o próprio link não guarda nenhum valor num pagamento de valor aberto.
Quais ativos podem ser doados?
O ativo definido no link, como USDC ou a moeda da rede (XLM ou SOL). Quem doa escolhe só o valor.
