Como aceitar pagamentos em USDC online
Para aceitar USDC online com a Cosmos Pay, adicione a carteira que vai receber o dinheiro e cobre com um link de pagamento, o checkout hospedado ou a API de pagamentos. Seu cliente paga com a própria carteira na Stellar, Solana ou Monad, e o USDC vai para o seu endereço. Faça tudo numa rede de testes antes de cobrar dinheiro real.

O que você precisa
Uma conta na Cosmos Pay. Criar uma é grátis, e o plano Starter não tem mensalidade: cada pagamento paga 1.5% + 18¢.
Um endereço de carteira que vai receber o USDC, na rede em que você cobra: Stellar, Solana ou Monad. Você o adiciona à sua organização no dashboard e comprova que ele é seu com uma assinatura. Os links de pagamento criados no dashboard só pagam para as carteiras adicionadas ali.
O que seu cliente precisa
Uma carteira na mesma rede, com o USDC, que consiga abrir o pagamento: na Stellar, qualquer carteira que abra links SEP-7; na Solana, qualquer carteira que leia links do Solana Pay; na Monad, qualquer carteira EVM que leia links EIP-681. A carteira dele também paga a taxa de rede.
Não precisa de conta. Ele abre o checkout, escaneia o QR code ou toca no botão da carteira e aprova o pagamento na própria carteira.
Três formas de cobrar
As três usam o mesmo checkout, o mesmo dashboard e os mesmos webhooks, então você pode começar com um link e passar para a API quando precisar.
- Link de pagamento: crie no dashboard e envie por chat ou e-mail, ou mostre o QR code. Sem código.
- Checkout hospedado: envie seu cliente para a página de pagamento do link, abra-a a partir de um botão de pagamento ou mostre-a dentro da sua página com uma única tag script.
- API de pagamentos: crie cada pagamento no seu servidor com uma requisição, ou com o SDK em TypeScript, e desenhe sua própria tela de pagamento.
Enviar um link de pagamento no WhatsAppExperimente todas as opções de integraçãoIncorporar um pagamento
Aceite seu primeiro pagamento em USDC, passo a passo
Crie sua conta e mude para Sandbox
Entre no dashboard e escolha Sandbox no topo. O que você cria ali funciona nas redes de teste (Stellar Testnet, Solana Devnet e Monad Testnet) e não movimenta dinheiro real.
Adicione a carteira que recebe o dinheiro
Nas configurações da sua organização, adicione uma carteira na rede em que vai cobrar e assine o que o dashboard pedir: essa assinatura comprova que a carteira é sua.
Crie uma cobrança de teste
Em Pagamentos, crie um link de pagamento com a rede, o valor, o ativo e a carteira que o recebe. Ou crie uma chave de API de teste (começa com dv_) e chame POST /v1/payment-intents/pay do seu servidor. Na Stellar Testnet você pode cobrar em XLM, que o Friendbot, o faucet da Testnet, envia para uma conta de teste.
Pague com uma carteira de teste
Abra a página de pagamento: ela avisa que funciona numa rede de testes. Pague com uma carteira dessa rede e veja o checkout passar para Pago e o link para Concluído no dashboard.
Confirme os pagamentos no seu servidor
Adicione um endpoint de webhook no dashboard. Quando a rede confirma um pagamento, a Cosmos Pay envia PAYMENT_INTENT_SUCCEEDED, assinado com HMAC-SHA256. Entregue o pedido quando ele chegar, não quando a página do cliente disser que está pago.
Mude para Produção
Escolha Produção no dashboard e crie uma chave de API de produção (começa com prod_). As mesmas requisições passam a cobrar nas redes principais: a chave decide a rede, não o código.
Primeiros passosChaves de APIWebhooksAPI de intenções de pagamento
Em qual rede cobrar
Cobre na rede em que seus clientes já têm USDC. O USDC é predefinido na Stellar e na Solana, tanto na mainnet quanto na rede de testes, e na mainnet da Monad. Nas três, qualquer outro token pode ser cobrado indicando o emissor, o mint ou o contrato.
Stellar vs Solana vs MonadPagamentos na StellarPagamentos na SolanaPagamentos na Monad
Quanto custa
Cada pagamento paga a tarifa do seu plano, a mesma em todas as redes: 1.5% + 18¢ no Starter, sem mensalidade. A carteira de quem paga cobre a taxa de rede; na Monad, a taxa do repasse que leva o pagamento até você é descontada dele.
Preços e calculadora de tarifasComo nossas tarifas se comparam
Perguntas e respostas.
Pagamentos por rede:Pagamentos na StellarPagamentos na SolanaPagamentos na Monad
Posso aceitar USDC sem escrever código?
Sim. Crie um link de pagamento no dashboard e compartilhe por chat ou e-mail, ou mostre o QR code. O status de cada pagamento aparece no dashboard.
Meu cliente paga em USDC e eu recebo USDC?
Sim. Seu cliente paga no ativo definido no link, e esse mesmo ativo chega ao seu endereço.
Posso testar sem dinheiro real?
Sim. No Sandbox e com chaves de teste (dv_), os links funcionam em redes de teste, e o checkout deles avisa que nenhum fundo real é movimentado.
Um cliente pode reverter um pagamento em USDC?
Não. Depois que a rede confirma um pagamento, ele é definitivo. Um reembolso é um novo pagamento que você envia da sua carteira.
